@jini-ai/agent-runtime 0.1.0

package/dist/agent-protocol/acp/updates.js

@@ -0,0 +1,268 @@
+import { asObject, acpValueKind, objectKeys, extractAcpUpdateText } from './json.js';
+import { accountFailureDetails, noopAccountFailureClassifier, } from './account-failure.js';
+/**
+ * Produces a shallow diagnostic snapshot of an ACP update object for the
+ * `acp_raw_event_shape` diagnostic event. Captures key presence, value kinds,
+ * and content structure without serialising the full update, so the payload
+ * stays bounded in size. Emitted only for AMR sessions where unknown shapes
+ * may require debugging.
+ *
+ * @param update - A parsed ACP `session/update` params object.
+ * @returns A flat diagnostic object suitable for inclusion in an agent event payload.
+ */
+export function acpRawEventShape(update) {
+    const content = update.content;
+    const rawInput = update.rawInput;
+    const locations = update.locations;
+    return {
+        sessionUpdate: typeof update.sessionUpdate === 'string' ? update.sessionUpdate : null,
+        keys: objectKeys(update),
+        contentKind: acpValueKind(content),
+        contentKeys: objectKeys(content),
+        hasText: Boolean(extractAcpUpdateText(update)),
+        hasTopLevelText: typeof update.text === 'string' && update.text.length > 0,
+        hasTopLevelDelta: typeof update.delta === 'string' && update.delta.length > 0,
+        hasTopLevelMessage: update.message !== undefined,
+        hasToolCallId: acpToolCallId(update) !== null,
+        hasRawInput: rawInput !== undefined,
+        rawInputKind: acpValueKind(rawInput),
+        rawInputKeys: objectKeys(rawInput),
+        locationsKind: acpValueKind(locations),
+        locationsCount: Array.isArray(locations) ? locations.length : undefined,
+        status: typeof update.status === 'string' ? update.status : undefined,
+        titlePresent: typeof update.title === 'string' && update.title.length > 0,
+    };
+}
+/**
+ * Normalises the `status` field of an ACP update to a lowercase,
+ * whitespace-and-punctuation-stripped token. Returns `''` when the field
+ * is absent or not a string, so all status comparisons use the token form.
+ *
+ * @param update - A parsed ACP `session/update` params object.
+ */
+export function acpUpdateStatus(update) {
+    return typeof update.status === 'string'
+        ? update.status.trim().toLowerCase().replace(/[\s_-]+/g, '')
+        : '';
+}
+/**
+ * Returns `true` when the update's `status` field represents a successful
+ * terminal state (`completed`, `complete`, `succeeded`, or `success`).
+ * Used to decide when to emit deferred artifact-write tool events.
+ */
+export function isAcpCompletedStatus(update) {
+    const status = acpUpdateStatus(update);
+    return status === 'completed' || status === 'complete' || status === 'succeeded' || status === 'success';
+}
+/**
+ * Returns `true` when the update's `status` field represents a terminal
+ * failure state (`failed`, `failure`, `error`, `cancelled`, or `canceled`).
+ * Used to clean up pending write-suppression state and emit failed tool events.
+ */
+export function isAcpTerminalFailureStatus(update) {
+    const status = acpUpdateStatus(update);
+    return status === 'failed' || status === 'failure' || status === 'error' || status === 'cancelled' || status === 'canceled';
+}
+/**
+ * Returns `true` when the update's status is `'retry'`. Signals that the AMR
+ * agent wants to restart the request; the session promoter maps this to a
+ * structured error payload via `promotedAmrRetryStatusPayload`.
+ */
+export function isAcpRetryStatus(update) {
+    return acpUpdateStatus(update) === 'retry';
+}
+/**
+ * Recursively collects all text-bearing leaf values from an ACP update
+ * (strings, numbers, booleans) up to 4 levels deep. Used to produce a flat
+ * text corpus for an injected `AccountFailureClassifier` to pattern-match
+ * against, without requiring knowledge of a specific agent's response shape.
+ *
+ * @param value - Any value from a parsed ACP session update.
+ * @param depth - Current recursion depth (max 4); callers omit this.
+ * @returns A flat array of trimmed non-empty string representations.
+ */
+export function acpUpdateDiagnosticText(value, depth = 0) {
+    if (depth > 4)
+        return [];
+    if (typeof value === 'string')
+        return value.trim() ? [value] : [];
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return [String(value)];
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => acpUpdateDiagnosticText(item, depth + 1));
+    }
+    const obj = asObject(value);
+    if (!obj)
+        return [];
+    const parts = [];
+    for (const key of [
+        'type',
+        'status',
+        'code',
+        'message',
+        'detail',
+        'details',
+        'error',
+        'recovery',
+        'pauseReason',
+        'content',
+        'text',
+        'rawInput',
+    ]) {
+        if (key in obj) {
+            parts.push(...acpUpdateDiagnosticText(obj[key], depth + 1));
+        }
+    }
+    return parts;
+}
+/**
+ * Promotes an AMR `retry` status update into a structured error payload when
+ * the update's diagnostic text matches a known account-failure pattern (e.g.
+ * quota exceeded, auth failure), as decided by `classifier`. Returns `null`
+ * when the update is not a retry, or when `classifier` finds no match.
+ *
+ * @param update - A parsed ACP `session/update` params object.
+ * @param classifier - The account-failure classifier to consult; defaults to
+ *   `noopAccountFailureClassifier`, under which this always returns `null`.
+ * @returns A structured error payload with `message` and `error`, or `null`.
+ */
+export function promotedAmrRetryStatusPayload(update, classifier = noopAccountFailureClassifier) {
+    if (!isAcpRetryStatus(update))
+        return null;
+    const diagnosticText = acpUpdateDiagnosticText(update).join('\n');
+    const failure = classifier.classify(diagnosticText);
+    if (!failure)
+        return null;
+    return {
+        message: failure.message,
+        error: {
+            code: failure.code,
+            message: failure.message,
+            retryable: false,
+            details: {
+                ...accountFailureDetails(failure),
+                promoted_by: 'agent_runtime_acp_retry_status',
+            },
+        },
+    };
+}
+/**
+ * Scans a rolling tail of AMR stderr output for known retry/session-failure
+ * signals and, when found, promotes a match (via `classifier`) to a
+ * structured error payload. Returns `null` when the chunk does not contain
+ * the expected markers or does not match a known failure pattern.
+ *
+ * @param chunk - A tail slice of accumulated stderr bytes from the AMR subprocess.
+ * @param classifier - The account-failure classifier to consult; defaults to
+ *   `noopAccountFailureClassifier`, under which this always returns `null`.
+ * @returns A structured error payload, or `null` when not applicable.
+ */
+export function promotedAmrStderrPayload(chunk, classifier = noopAccountFailureClassifier) {
+    if (!/opencode_event_stream_failure|session\.status/i.test(chunk))
+        return null;
+    if (!/\bretry\b/i.test(chunk))
+        return null;
+    const failure = classifier.classify(chunk);
+    if (!failure)
+        return null;
+    return {
+        message: failure.message,
+        error: {
+            code: failure.code,
+            message: failure.message,
+            retryable: false,
+            details: {
+                ...accountFailureDetails(failure),
+                promoted_by: 'agent_runtime_acp_stderr_retry_status',
+            },
+        },
+    };
+}
+/**
+ * Extracts and trims the `toolCallId` string from an ACP update, or returns
+ * `null` when absent or empty. Used as a stable dedup key for artifact-write
+ * tracking across update frames.
+ *
+ * @param update - A parsed ACP `session/update` params object.
+ */
+export function acpToolCallId(update) {
+    return typeof update.toolCallId === 'string' && update.toolCallId.trim()
+        ? update.toolCallId.trim()
+        : null;
+}
+/**
+ * Returns `true` when the update's `title` or `name` field contains a word
+ * that indicates a file-write operation (`edit`, `write`, `create`, `update`,
+ * `save`, `patch`, or `replace`). Used to heuristically identify
+ * artifact-write tool calls before their `toolCallId` is known.
+ *
+ * @param update - A parsed ACP `session/update` params object.
+ */
+export function isAcpArtifactWriteLabel(update) {
+    const label = [
+        typeof update.title === 'string' ? update.title : '',
+        typeof update.name === 'string' ? update.name : '',
+    ].join(' ');
+    return /\b(?:edit|write|create|update|save|patch|replace)\b/i.test(label);
+}
+/**
+ * Returns `true` when an ACP update represents the terminal completion of an
+ * artifact-write tool call and should arm the DSML text suppressor. Requires
+ * a completed status combined with either a write-style label or a tool call
+ * id tracked in `writeToolCallIds`.
+ *
+ * @param update - A parsed ACP `session/update` params object.
+ * @param writeToolCallIds - The set of tool call ids identified as artifact writes so far.
+ */
+export function isAcpArtifactWriteUpdate(update, writeToolCallIds) {
+    if (!isAcpCompletedStatus(update))
+        return false;
+    const toolCallId = acpToolCallId(update);
+    return isAcpArtifactWriteLabel(update) || (toolCallId ? writeToolCallIds.has(toolCallId) : false);
+}
+// Best-effort file path for an ACP artifact-write tool call. ACP can carry a
+// `locations: [{ path }]` array and/or `content: [{ type:'diff', path }]`
+// entries, but many agents omit both and send only a human `title` ("edit").
+// Returns null when no concrete path is present; the caller then falls back to
+// the toolCallId as a dedup key.
+/**
+ * Best-effort extraction of a concrete file path from an ACP artifact-write
+ * tool call update, checking three sources in priority order:
+ * 1. `locations` or `content` array entries with a `path` field.
+ * 2. `rawInput.path`, `rawInput.file_path`, or `rawInput.filename`.
+ * 3. A filename token embedded in the human-readable `title` field.
+ *
+ * Returns `null` when no concrete path is present; the caller then falls
+ * back to the toolCallId as a dedup key.
+ *
+ * @param update - A parsed ACP `session/update` params object.
+ * @returns An absolute or relative file path string, or `null` when absent.
+ */
+export function acpArtifactWritePath(update) {
+    // 1. ACP `locations: [{ path }]` and `content: [{ path }]` (diff entries).
+    for (const field of [update.locations, update.content]) {
+        if (!Array.isArray(field))
+            continue;
+        for (const entry of field) {
+            const path = asObject(entry)?.path;
+            if (typeof path === 'string' && path.trim())
+                return path.trim();
+        }
+    }
+    // 2. Tool input echoed by some agents as `rawInput.{path,file_path,filename}`.
+    const rawInput = asObject(update.rawInput);
+    for (const key of ['path', 'file_path', 'filename']) {
+        const value = rawInput?.[key];
+        if (typeof value === 'string' && value.trim())
+            return value.trim();
+    }
+    // 3. A filename token embedded in the human title, e.g. "Write index.html".
+    // Keeping the real extension lets `isArtifactPath` correctly EXCLUDE
+    // non-artifact writes (e.g. "edit config.json"), matching the claude path.
+    const title = typeof update.title === 'string' ? update.title : '';
+    const match = title.match(/[\w./-]+\.[A-Za-z0-9]+/);
+    if (match?.[0])
+        return match[0];
+    return null;
+}
+//# sourceMappingURL=updates.js.map

package/dist/agent-protocol/acp/updates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updates.js","sourceRoot":"","sources":["../../../src/agent-protocol/acp/updates.ts"],"names":[],"mappings":"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"}

package/dist/agent-protocol/core/index.d.ts

@@ -0,0 +1,6 @@
+/** @module agent-protocol/core
+ * Foundation barrel for the agent-protocol module. Re-exports the shared
+ * JSON-line stream parser consumed by every protocol adapter (acp/, pi-rpc/).
+ */
+export { createJsonLineStream } from './json-line-stream.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agent-protocol/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agent-protocol/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/agent-protocol/core/index.js

@@ -0,0 +1,6 @@
+/** @module agent-protocol/core
+ * Foundation barrel for the agent-protocol module. Re-exports the shared
+ * JSON-line stream parser consumed by every protocol adapter (acp/, pi-rpc/).
+ */
+export { createJsonLineStream } from './json-line-stream.js';
+//# sourceMappingURL=index.js.map

package/dist/agent-protocol/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent-protocol/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/agent-protocol/core/json-line-stream.d.ts

@@ -0,0 +1,42 @@
+/** @module agent-protocol/core/json-line-stream
+ * Streaming JSON-line parser that reassembles pretty-printed and multiline
+ * JSON-RPC messages across chunk boundaries. Shared transport used by both the
+ * acp/ and pi-rpc/ protocol adapters; this file has no dependencies on any
+ * other agent-protocol sibling.
+ */
+/**
+ * Creates a streaming JSON-line parser over a raw byte/string stream.
+ * Buffers incoming chunks, splits on newline boundaries, and attempts
+ * `JSON.parse` on each line. Accumulates pretty-printed (multiline) JSON across
+ * up to 256 lines and 128 kB before abandoning and re-trying the current line
+ * as a fresh candidate.
+ *
+ * Used as the shared ACP transport: both the acp/ and pi-rpc/ adapters call
+ * this to decode JSON-RPC frames from a subprocess's stdout.
+ *
+ * @param onMessage - Called for each successfully parsed JSON value along with
+ *   the raw reassembled line string as a second argument.
+ * @returns An object with `feed(chunk)` for incremental input and `flush()` to
+ *   drain any residual buffered content at stream end.
+ */
+export declare function createJsonLineStream(onMessage: (message: unknown, rawLine: string) => void): {
+    feed(chunk: string): void;
+    flush(): void;
+};
+/**
+ * Incremental JSON completeness classifier used by `createJsonLineStream` to
+ * decide whether an accumulating multiline candidate can still resolve into
+ * valid JSON.
+ *
+ * Performs a single-pass character-level parse, tracking object and array
+ * frames on a stack. Returns:
+ * - `'complete'`   — a syntactically valid, fully closed JSON value.
+ * - `'incomplete'` — valid so far but the document is still open (unclosed
+ *   strings, objects, or arrays).
+ * - `'invalid'`    — an irrecoverable syntax error was encountered.
+ *
+ * @param value - A string candidate to classify, typically one or more
+ *   accumulated stdout lines from an ACP subprocess.
+ */
+export declare function classifyJsonCandidate(value: string): 'complete' | 'incomplete' | 'invalid';
+//# sourceMappingURL=json-line-stream.d.ts.map

package/dist/agent-protocol/core/json-line-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-line-stream.d.ts","sourceRoot":"","sources":["../../../src/agent-protocol/core/json-line-stream.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI;gBA6D3E,MAAM;;EA4BrB;AACD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,CAmM1F"}

package/dist/agent-protocol/core/json-line-stream.js

@@ -0,0 +1,333 @@
+/** @module agent-protocol/core/json-line-stream
+ * Streaming JSON-line parser that reassembles pretty-printed and multiline
+ * JSON-RPC messages across chunk boundaries. Shared transport used by both the
+ * acp/ and pi-rpc/ protocol adapters; this file has no dependencies on any
+ * other agent-protocol sibling.
+ */
+/**
+ * Creates a streaming JSON-line parser over a raw byte/string stream.
+ * Buffers incoming chunks, splits on newline boundaries, and attempts
+ * `JSON.parse` on each line. Accumulates pretty-printed (multiline) JSON across
+ * up to 256 lines and 128 kB before abandoning and re-trying the current line
+ * as a fresh candidate.
+ *
+ * Used as the shared ACP transport: both the acp/ and pi-rpc/ adapters call
+ * this to decode JSON-RPC frames from a subprocess's stdout.
+ *
+ * @param onMessage - Called for each successfully parsed JSON value along with
+ *   the raw reassembled line string as a second argument.
+ * @returns An object with `feed(chunk)` for incremental input and `flush()` to
+ *   drain any residual buffered content at stream end.
+ */
+export function createJsonLineStream(onMessage) {
+    let buffer = '';
+    let pendingJson = '';
+    let pendingJsonLineCount = 0;
+    const emit = (candidate) => {
+        try {
+            onMessage(JSON.parse(candidate), candidate);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const startPendingJson = (line) => {
+        pendingJson = line;
+        pendingJsonLineCount = 1;
+    };
+    const resetPendingJson = () => {
+        pendingJson = '';
+        pendingJsonLineCount = 0;
+    };
+    const handleLine = (line) => {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return;
+        if (pendingJson) {
+            const nextCandidate = `${pendingJson}\n${trimmed}`;
+            if (emit(nextCandidate)) {
+                resetPendingJson();
+                return;
+            }
+            pendingJsonLineCount += 1;
+            const state = classifyJsonCandidate(nextCandidate);
+            if (state === 'incomplete' &&
+                nextCandidate.length <= 128_000 &&
+                pendingJsonLineCount <= 256) {
+                pendingJson = nextCandidate;
+                return;
+            }
+            resetPendingJson();
+            handleLine(trimmed);
+            return;
+        }
+        if (emit(trimmed))
+            return;
+        // ACP is line-delimited JSON-RPC, but a few bridges have emitted
+        // pretty-printed JSON during startup. Keep a bounded aggregate so an
+        // otherwise valid multiline initialize response does not get discarded
+        // line-by-line and leave the session stuck in spawn pending.
+        if ((trimmed.startsWith('{') || trimmed.startsWith('[')) &&
+            classifyJsonCandidate(trimmed) === 'incomplete') {
+            startPendingJson(trimmed);
+        }
+    };
+    return {
+        feed(chunk) {
+            buffer += chunk;
+            const lines = buffer.split('\n');
+            buffer = lines.pop() || '';
+            for (const line of lines) {
+                handleLine(line);
+            }
+        },
+        flush() {
+            const trimmed = buffer.trim();
+            buffer = '';
+            if (trimmed) {
+                handleLine(trimmed);
+            }
+            // Any `pendingJson` still set at this point was, by construction, the
+            // most recent candidate `classifyJsonCandidate` judged structurally
+            // incomplete (an unclosed string/object/array) — the exact same
+            // judgment `JSON.parse` agrees with (verified by fuzz-testing 200k
+            // truncated-JSON candidates: zero cases where classify says
+            // 'incomplete' but JSON.parse would actually succeed), so a bare
+            // re-attempt at end-of-stream could never succeed. The origin file had
+            // a defensive `if (pendingJson && emit(pendingJson)) { pendingJson =
+            // '' }` here that was provably dead code; removed per this package's
+            // coverage-driven dead-branch discipline rather than left uncovered or
+            // suppressed. See source-map.md.
+            // Ignore trailing non-JSON log lines on stdout.
+        },
+    };
+}
+/**
+ * Incremental JSON completeness classifier used by `createJsonLineStream` to
+ * decide whether an accumulating multiline candidate can still resolve into
+ * valid JSON.
+ *
+ * Performs a single-pass character-level parse, tracking object and array
+ * frames on a stack. Returns:
+ * - `'complete'`   — a syntactically valid, fully closed JSON value.
+ * - `'incomplete'` — valid so far but the document is still open (unclosed
+ *   strings, objects, or arrays).
+ * - `'invalid'`    — an irrecoverable syntax error was encountered.
+ *
+ * @param value - A string candidate to classify, typically one or more
+ *   accumulated stdout lines from an ACP subprocess.
+ */
+export function classifyJsonCandidate(value) {
+    const stack = [];
+    let rootComplete = false;
+    const afterValue = () => {
+        const parent = stack.at(-1);
+        if (!parent) {
+            rootComplete = true;
+            return;
+        }
+        parent.expect = 'commaOrEnd';
+    };
+    // Every call site below is already nested inside a check that has
+    // established the top-of-stack frame's kind (`current.kind === 'object'`,
+    // or implicitly 'array' when that check fails), so the frame `closeFrame`
+    // pops always exists and always matches the kind being closed. The origin
+    // file guarded against a mismatch (`!current || current.kind !== kind`)
+    // and returned `false` for callers to translate into `'invalid'`; that
+    // guard was provably dead (verified by a 2M-trial adversarial fuzz,
+    // including deliberately malformed bracket sequences, finding zero
+    // mismatches) and is removed here per this package's coverage-driven
+    // dead-branch discipline. See source-map.md.
+    const closeFrame = () => {
+        stack.pop();
+        afterValue();
+    };
+    const parseString = (start) => {
+        for (let index = start + 1; index < value.length; index += 1) {
+            const char = value[index];
+            if (char === '\\') {
+                index += 1;
+                continue;
+            }
+            if (char === '"')
+                return index;
+        }
+        return null;
+    };
+    const parseLiteral = (start, literal) => {
+        for (let offset = 0; offset < literal.length; offset += 1) {
+            const char = value[start + offset];
+            if (char === undefined)
+                return null;
+            if (char !== literal[offset])
+                return false;
+        }
+        return start + literal.length - 1;
+    };
+    const parseNumber = (start) => {
+        let index = start;
+        if (value[index] === '-')
+            index += 1;
+        if (value[index] === '0') {
+            index += 1;
+        }
+        else if (/[1-9]/.test(value[index] ?? '')) {
+            while (/[0-9]/.test(value[index] ?? ''))
+                index += 1;
+        }
+        else {
+            return false;
+        }
+        if (value[index] === '.') {
+            index += 1;
+            if (!/[0-9]/.test(value[index] ?? ''))
+                return false;
+            while (/[0-9]/.test(value[index] ?? ''))
+                index += 1;
+        }
+        if (value[index] === 'e' || value[index] === 'E') {
+            index += 1;
+            if (value[index] === '+' || value[index] === '-')
+                index += 1;
+            if (!/[0-9]/.test(value[index] ?? ''))
+                return false;
+            while (/[0-9]/.test(value[index] ?? ''))
+                index += 1;
+        }
+        return index - 1;
+    };
+    const parseValue = (index) => {
+        const char = value[index];
+        if (char === '"') {
+            const end = parseString(index);
+            if (end === null)
+                return null;
+            afterValue();
+            return end;
+        }
+        if (char === '{') {
+            stack.push({ kind: 'object', expect: 'keyOrEnd' });
+            return index;
+        }
+        if (char === '[') {
+            stack.push({ kind: 'array', expect: 'valueOrEnd' });
+            return index;
+        }
+        if (char === 't') {
+            const end = parseLiteral(index, 'true');
+            if (end === false || end === null)
+                return end;
+            afterValue();
+            return end;
+        }
+        if (char === 'f') {
+            const end = parseLiteral(index, 'false');
+            if (end === false || end === null)
+                return end;
+            afterValue();
+            return end;
+        }
+        if (char === 'n') {
+            const end = parseLiteral(index, 'null');
+            if (end === false || end === null)
+                return end;
+            afterValue();
+            return end;
+        }
+        // `parseValue` is only ever called (below, and from the main loop) with
+        // an `index` already known to be within `value`'s bounds, so `char` is
+        // always defined here; the non-null assertion documents that instead of
+        // a `?? ''` fallback that could never actually be exercised.
+        if (char === '-' || /[0-9]/.test(char)) {
+            const end = parseNumber(index);
+            if (end === false)
+                return false;
+            afterValue();
+            return end;
+        }
+        return false;
+    };
+    for (let index = 0; index < value.length; index += 1) {
+        // The loop bound (`index < value.length`) guarantees this index always
+        // yields a defined character; the non-null assertion documents that
+        // runtime invariant in place of a `noUncheckedIndexedAccess`-driven
+        // guard that could never actually trigger.
+        const char = value[index];
+        if (/\s/.test(char))
+            continue;
+        const current = stack.at(-1);
+        if (!current) {
+            if (rootComplete)
+                return 'invalid';
+            const end = parseValue(index);
+            if (end === false)
+                return 'invalid';
+            if (end === null)
+                return 'incomplete';
+            index = end;
+            continue;
+        }
+        if (current.kind === 'object') {
+            if (current.expect === 'keyOrEnd') {
+                if (char === '}') {
+                    closeFrame();
+                    continue;
+                }
+                if (char !== '"')
+                    return 'invalid';
+                const end = parseString(index);
+                if (end === null)
+                    return 'incomplete';
+                current.expect = 'colon';
+                index = end;
+                continue;
+            }
+            if (current.expect === 'colon') {
+                if (char !== ':')
+                    return 'invalid';
+                current.expect = 'value';
+                continue;
+            }
+            if (current.expect === 'value') {
+                const end = parseValue(index);
+                if (end === false)
+                    return 'invalid';
+                if (end === null)
+                    return 'incomplete';
+                index = end;
+                continue;
+            }
+            if (char === '}') {
+                closeFrame();
+                continue;
+            }
+            if (char !== ',')
+                return 'invalid';
+            current.expect = 'keyOrEnd';
+            continue;
+        }
+        if (current.expect === 'valueOrEnd') {
+            if (char === ']') {
+                closeFrame();
+                continue;
+            }
+            const end = parseValue(index);
+            if (end === false)
+                return 'invalid';
+            if (end === null)
+                return 'incomplete';
+            index = end;
+            continue;
+        }
+        if (char === ']') {
+            closeFrame();
+            continue;
+        }
+        if (char !== ',')
+            return 'invalid';
+        current.expect = 'valueOrEnd';
+    }
+    return rootComplete && stack.length === 0 ? 'complete' : 'incomplete';
+}
+//# sourceMappingURL=json-line-stream.js.map