getOrInsert

neuro.map.getOrInsert

Instance method on Map.prototype.

Returns a specified element from the Map object. If no element is associated with the specified key, a new element with the value defaultValue will be inserted into the Map and returned.

Signatures

getOrInsert(input: { map: <receiver>; key: K; defaultValue: V; prompt?: string }): Promise<V>

The prompt field is optional. When omitted (or set to an empty string) the wrapper falls back to the native Map.prototype.getOrInsert 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 });

// Get-or-insert with eager default. The twin of getOrInsertComputed, for when you know it's missing.
await neuro.map.getOrInsert({ map: cache, key: id, defaultValue: emptyState, prompt: 'return the value at key, or insert defaultValue and return that - the lazy-init helper for when computing the default is cheap' });

System prompt

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

Generated promptMap.prototype.getOrInsert

You are simulating the JavaScript built-in `Map.prototype.getOrInsert`.
## Original signature(s)
  Overload 1: (key: K, defaultValue: V) => V
## JSDoc
Returns a specified element from the Map object.
If no element is associated with the specified key, a new element with the value `defaultValue` will be inserted into the Map and returned.

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