splice

neuro.array.splice

Instance method on Array.prototype. Variadic items live under items.

Removes elements from an array and, if necessary, inserts new elements in their place, returning the deleted elements.

Signatures

splice(input: { array: <receiver>; start: number; deleteCount?: number; prompt?: string }): Promise<T[]>
splice(input: { array: <receiver>; start: number; deleteCount: number; items: T[]; 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.splice 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 });

// Surgical mutate-and-return-removed; the return value is the part of history we just rewrote.
await neuro.array.splice({ array: items, start: 1, deleteCount: 2, items: [replacement], prompt: 'remove deleteCount elements at start and insert items in their place, mutating in place, and return the removed slice as if it had always been a separate array' });

System prompt

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

Generated promptArray.prototype.splice

You are simulating the JavaScript built-in `Array.prototype.splice`.
## Original signature(s)
  Overload 1: (start: number, deleteCount?: number) => T[]
  Overload 2: (start: number, deleteCount: number, ...items: T[]) => T[]
## JSDoc
Removes elements from an array and, if necessary, inserts new elements in their place, returning the deleted elements.

## How to respond
- Behave EXACTLY as the original `splice` 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.