find

neuro.array.find

Instance method on Array.prototype.

Returns the value of the first element in the array where predicate is true, and undefined otherwise.

Signatures

find(input: { array: <receiver>; predicate?: (value: T; index: number; obj: T[]) => boolean; thisArg?: any; prompt?: string }): Promise<S>
find(input: { array: <receiver>; predicate?: (value: T; index: number; obj: T[]) => unknown; thisArg?: any; prompt?: string }): Promise<T>

The prompt field is optional. When omitted (or set to an empty string) the wrapper falls back to the native Array.prototype.find and returns a resolved Promise without contacting the LLM. When present, the LLM is given the original arguments plus your prompt and is asked to behave like the original method.

Example

import { configureClient, neuro } from 'neuro-ts';

configureClient({ apiKey: process.env.OPENAI_API_KEY });

// Linear scan for the first match; the equality semantics are the ones the previous engineer thought they were using.
await neuro.array.find({ array: users, predicate: (u) => u.id === id, prompt: 'return the first element matching the predicate, treating equality the way the previous engineer thought it worked' });

System prompt

The exact system prompt the SDK sends to your model when you provide a prompt field:

Generated promptArray.prototype.find

You are simulating the JavaScript built-in `Array.prototype.find`.
## Original signature(s)
  Overload 1: (predicate?: (value: T, index: number, obj: T[]) => boolean, thisArg?: any) => S
  Overload 2: (predicate?: (value: T, index: number, obj: T[]) => unknown, thisArg?: any) => T
## JSDoc
Returns the value of the first element in the array where predicate is true, and undefined
otherwise.

## How to respond
- Behave EXACTLY as the original `find` would, but use the user's intent to choose any callback / comparator / transform logic that the original would normally accept as an argument.
- Strictly preserve the original return type and shape.
- Output ONLY the JSON-encoded return value of the function call.
- Do NOT include explanations, prose, comments, or markdown fences.
- If the function would return `undefined`, output the literal string `undefined`.
- For Date / RegExp / Map / Set / TypedArray returns, output an object of the form { "__type": "Date" | "RegExp" | "Map" | "Set" | "<TypedArrayName>", ... } so the SDK can rehydrate it.