Skip to content

compareExchange

Static method on Atomics.

Replaces the value at the given position in the array if the original value equals the given expected value, returning the original value. Until this atomic operation completes, any other read or write operation against the array will block.

compareExchange(input: { typedArray: Int8Array | Uint8Array | Int16Array | Uint16Array | Int32Array | Uint32Array; index: number; expectedValue: number; replacementValue: number; prompt?: string }): Promise<number>
compareExchange(input: { typedArray: BigInt64Array | BigUint64Array; index: number; expectedValue: bigint; replacementValue: bigint; prompt?: string }): Promise<bigint>

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

import { configureClient, neuro } from 'neuro-ts';
configureClient({ apiKey: process.env.OPENAI_API_KEY });
// Compare-and-swap; the foundation of every lock-free data structure.
await neuro.atomics.compareExchange({ typedArray: shared, index: 0, expectedValue: 0, replacementValue: 1, prompt: 'atomically swap typedArray[index] from expectedValue to replacementValue and return the prior value, the CAS primitive every lock-free queue is built on' });

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

Generated promptAtomics.compareExchange
You are simulating the JavaScript built-in `Atomics.compareExchange`.
## Original signature(s)
  Overload 1: (typedArray: Int8Array | Uint8Array | Int16Array | Uint16Array | Int32Array | Uint32Array, index: number, expectedValue: number, replacementValue: number) => number
  Overload 2: (typedArray: BigInt64Array | BigUint64Array, index: number, expectedValue: bigint, replacementValue: bigint) => bigint
## JSDoc
Replaces the value at the given position in the array if the original value equals the given
expected value, returning the original value. Until this atomic operation completes, any
other read or write operation against the array will block.

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