@jini-ai/chat 0.1.0

package/dist/core/transport.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @module transport
+ *
+ * The `ChatTransport` port — the single seam a host uses to reach a real
+ * agent runtime (SSE/fetch, WebSocket, a local daemon, an in-memory fake for
+ * tests).
+ *
+ * Moved here from `@jini-ai/chat-react` on 2026-07-29. The port is pure types over
+ * `AbortSignal` — no React, no DOM, no transport implementation — so keeping it in the React
+ * adapter meant a non-React host had to depend on the React package just to name the seam it
+ * implements. `@jini-ai/chat-react` re-exports every name below, so nothing that already imported
+ * them from there needs to change; no hook or component there constructs an
+ * `EventSource`/`fetch`/`WebSocket` directly — each receives a `ChatTransport` (via
+ * `<JiniChatProvider transport={...}>` or as a direct hook argument) and calls through it.
+ *
+ * Generalizes OD's `providers/daemon.ts` `streamViaDaemon` +
+ * `DaemonStreamHandlers` (`daemon.ts:261`, `daemon.ts:594`) — verified
+ * against the real source at
+ * `apps/web/src/providers/daemon.ts` (branch `refactor/web-chat-pane-slice`,
+ * commit `58fe4358747bd08b82c36947f1ff05aa5fa6a02a`). See
+ * `ADS-memory/reports/jini-port/recon/r4b-webui-design.md` §2 for the target shape this
+ * module implements verbatim.
+ */
+import type { AgentEvent } from './events.js';
+import type { ChatAttachment, ChatMessage, ChatRunStatus } from './messages.js';
+/**
+ * Per-run event handlers a `ChatTransport` invokes as a run streams.
+ * Mirrors `DaemonStreamHandlers` (`onAgentEvent`/`onToolInputDelta`) plus the
+ * generic `StreamHandlers` `onError`/`onDone` pair the OD original composed
+ * via `extends`.
+ */
+export interface RunHandlers {
+    /** Fired once per renderable unit of agent output. */
+    onEvent: (ev: AgentEvent) => void;
+    /**
+     * Live-only incremental tool-input fragment (e.g. Claude's
+     * `input_json_delta`). Ephemeral — never persisted; a consumer accumulates
+     * by tool-use `id` for a live preview and discards it once the full
+     * `tool_use` event arrives.
+     */
+    onToolInputDelta?: (id: string, name: string, delta: string) => void;
+    onError: (err: Error) => void;
+    /** Fired once the run reaches a terminal state, with the full event log. */
+    onDone: (finalEvents: AgentEvent[]) => void;
+}
+/**
+ * Opaque per-host payload threaded through to the transport unmodified (OD:
+ * `projectId`/`skillIds`/`designSystemId`; another host: whatever its own
+ * run-scoping concept is). This package never reads its fields.
+ */
+export type RunContext = Record<string, unknown>;
+export interface StartRunInput {
+    history: ChatMessage[];
+    agentId?: string;
+    conversationId?: string | null;
+    attachments?: ChatAttachment[];
+    context?: RunContext;
+    /** Stops the browser-side subscription; the run continues host-side. */
+    signal: AbortSignal;
+    /** Explicit user cancellation — distinct from `signal` (see OD's `cancelSignal`). */
+    cancelSignal?: AbortSignal;
+}
+/**
+ * Per-reattachment options. Separate from the positional `runId`/`handlers` pair, and optional, so
+ * an existing implementation stays type-compatible without edits.
+ */
+export interface ReattachRunOptions {
+    /**
+     * Stops the browser-side subscription; the run continues host-side. Exactly what
+     * `StartRunInput.signal` is to `startRun`.
+     *
+     * `reattachRun` had no cancellation seam at all until 2026-07-29, and that was a resource leak
+     * rather than a missing convenience: a reattached SSE/WebSocket stream can outlive the component
+     * that opened it by as long as the run itself runs, and the shipped `useRunStream` hook was
+     * already creating (and aborting on unmount/reset/replacement) a controller it had no way to hand
+     * to the transport. The connection and its read loop simply kept going.
+     */
+    readonly signal?: AbortSignal;
+}
+/**
+ * The transport port. A host binds exactly one implementation (a real
+ * SSE/fetch adapter, a WebSocket adapter, or a fake for tests/demos) and
+ * passes it to `<JiniChatProvider>`. Every headless hook in this package
+ * that performs I/O receives this port — none constructs its own transport.
+ */
+export interface ChatTransport {
+    startRun(input: StartRunInput, handlers: RunHandlers): Promise<{
+        runId: string;
+    }>;
+    /**
+     * Resume listening to an already-started run (reconnect/replay).
+     *
+     * An implementation that opens a long-lived stream **must** honor `options.signal` — it is the
+     * only way a caller can detach. See {@link ReattachRunOptions.signal}.
+     */
+    reattachRun(runId: string, handlers: RunHandlers, options?: ReattachRunOptions): Promise<void>;
+    fetchRunStatus(runId: string): Promise<ChatRunStatus | null>;
+    stopRun(runId: string): Promise<void>;
+    reportFeedback?(change: FeedbackChange): Promise<void>;
+}
+export interface FeedbackChange {
+    messageId: string;
+    runId?: string;
+    rating: 'positive' | 'negative';
+    reasonCode?: string;
+    note?: string;
+}
+export type OnFeedback = (change: FeedbackChange) => void;
+//# sourceMappingURL=transport.d.ts.map

package/dist/core/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/core/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,OAAO,EAAE,CAAC,EAAE,EAAE,UAAU,KAAK,IAAI,CAAC;IAClC;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrE,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC9B,4EAA4E;IAC5E,MAAM,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,IAAI,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,CAAC,EAAE,cAAc,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,wEAAwE;IACxE,MAAM,EAAE,WAAW,CAAC;IACpB,qFAAqF;IACrF,YAAY,CAAC,EAAE,WAAW,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;OASG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClF;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/F,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC7D,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,cAAc,CAAC,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC"}

package/dist/core/transport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/core/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/core/transport.ts"],"names":[],"mappings":""}

package/dist/core/util/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @module artifacts
+ * Barrel for the artifact parsing/validation/recovery surface. Deliberately
+ * omits `./markdown-context.js` and `./markup-attributes.js`, which are
+ * internal implementation details shared by `./parser.js` and `./strip.js`
+ * (and, for `markup-attributes.js`, `../question-form/scan.js`), not part
+ * of this package's public API.
+ */
+export * from './types.js';
+export * from './parser.js';
+export * from './strip.js';
+export * from './validate.js';
+export * from './manifest.js';
+export * from './recover.js';
+export * from './pointer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/util/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/util/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/core/util/index.js

@@ -0,0 +1,16 @@
+/**
+ * @module artifacts
+ * Barrel for the artifact parsing/validation/recovery surface. Deliberately
+ * omits `./markdown-context.js` and `./markup-attributes.js`, which are
+ * internal implementation details shared by `./parser.js` and `./strip.js`
+ * (and, for `markup-attributes.js`, `../question-form/scan.js`), not part
+ * of this package's public API.
+ */
+export * from './types.js';
+export * from './parser.js';
+export * from './strip.js';
+export * from './validate.js';
+export * from './manifest.js';
+export * from './recover.js';
+export * from './pointer.js';
+//# sourceMappingURL=index.js.map

package/dist/core/util/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/util/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC"}

package/dist/core/util/manifest.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @module manifest
+ *
+ * Create, serialize, parse, and infer the sidecar `ArtifactManifest` a
+ * generated file carries. See `./types.js` for the manifest shape itself.
+ */
+import type { ArtifactManifest } from './types.js';
+/** The manifest sidecar file name convention for a given artifact entry file name. */
+export declare function artifactManifestNameFor(entry: string): string;
+/** Build a fresh, complete manifest for a newly-persisted HTML artifact. */
+export declare function createHtmlArtifactManifest(input: {
+    entry: string;
+    title: string;
+    metadata?: Record<string, unknown>;
+    sourceSkillId?: string;
+    designSystemId?: string | null;
+}): ArtifactManifest;
+export declare function serializeArtifactManifest(manifest: ArtifactManifest): string;
+/**
+ * Parse and validate a manifest JSON string, rejecting anything that isn't a
+ * well-formed, currently-supported manifest (wrong version, missing
+ * required fields, or a `kind`/`renderer`/`status`/`exports` value outside
+ * the known sets).
+ *
+ * @returns The validated manifest, or `null` on any parse/shape failure.
+ * @complexity O(k) in the manifest's own field/array count — no I/O.
+ */
+export declare function parseArtifactManifest(raw: string): ArtifactManifest | null;
+/**
+ * Infer a manifest for a legacy artifact file that predates manifest
+ * sidecars, from its entry file name alone (extension → kind → renderer).
+ * @returns `null` when the extension isn't a recognized artifact kind.
+ */
+export declare function inferLegacyManifest(input: {
+    entry: string;
+    title?: string;
+    metadata?: Record<string, unknown>;
+}): ArtifactManifest | null;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/core/util/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/core/util/manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAoC,gBAAgB,EAAsC,MAAM,YAAY,CAAC;AA2DzH,sFAAsF;AACtF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,4EAA4E;AAC5E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,GAAG,gBAAgB,CAiBnB;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAE5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAoC1E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,gBAAgB,GAAG,IAAI,CA4BzI"}

package/dist/core/util/manifest.js

@@ -0,0 +1,173 @@
+const MANIFEST_VERSION = 1;
+const ALLOWED_KINDS = new Set([
+    'html',
+    'deck',
+    'react-component',
+    'markdown-document',
+    'svg',
+    'diagram',
+    'code-snippet',
+    'mini-app',
+    'design-system',
+]);
+const ALLOWED_RENDERERS = new Set([
+    'html',
+    'deck-html',
+    'react-component',
+    'markdown',
+    'svg',
+    'diagram',
+    'code',
+    'mini-app',
+    'design-system',
+]);
+const ALLOWED_EXPORTS = new Set(['html', 'pdf', 'zip', 'jsx', 'md', 'svg', 'txt']);
+const ALLOWED_STATUS = new Set(['streaming', 'complete', 'error']);
+function normalizeExt(name) {
+    const i = name.lastIndexOf('.');
+    return i >= 0 ? name.slice(i).toLowerCase() : '';
+}
+function inferKindFromEntry(entry) {
+    const ext = normalizeExt(entry);
+    if (['.html', '.htm'].includes(ext))
+        return 'html';
+    if (ext === '.svg')
+        return 'svg';
+    if (ext === '.md')
+        return 'markdown-document';
+    if (['.jsx', '.tsx'].includes(ext))
+        return 'react-component';
+    if (['.js', '.ts', '.json', '.css'].includes(ext))
+        return 'code-snippet';
+    return null;
+}
+function exportsForKind(kind) {
+    if (kind === 'deck')
+        return ['html', 'pdf', 'zip'];
+    if (kind === 'react-component')
+        return ['jsx', 'html', 'zip'];
+    if (kind === 'markdown-document')
+        return ['md', 'html', 'pdf', 'zip'];
+    if (kind === 'svg' || kind === 'diagram')
+        return ['svg', 'zip'];
+    if (kind === 'code-snippet')
+        return ['txt', 'zip'];
+    return ['html', 'pdf', 'zip'];
+}
+/** The manifest sidecar file name convention for a given artifact entry file name. */
+export function artifactManifestNameFor(entry) {
+    return `${entry}.artifact.json`;
+}
+/** Build a fresh, complete manifest for a newly-persisted HTML artifact. */
+export function createHtmlArtifactManifest(input) {
+    const now = new Date().toISOString();
+    return {
+        version: MANIFEST_VERSION,
+        kind: 'html',
+        title: input.title,
+        entry: input.entry,
+        renderer: 'html',
+        status: 'complete',
+        exports: ['html', 'pdf', 'zip'],
+        primary: true,
+        createdAt: now,
+        updatedAt: now,
+        sourceSkillId: input.sourceSkillId,
+        designSystemId: input.designSystemId,
+        metadata: input.metadata,
+    };
+}
+export function serializeArtifactManifest(manifest) {
+    return JSON.stringify(manifest, null, 2);
+}
+/**
+ * Parse and validate a manifest JSON string, rejecting anything that isn't a
+ * well-formed, currently-supported manifest (wrong version, missing
+ * required fields, or a `kind`/`renderer`/`status`/`exports` value outside
+ * the known sets).
+ *
+ * @returns The validated manifest, or `null` on any parse/shape failure.
+ * @complexity O(k) in the manifest's own field/array count — no I/O.
+ */
+export function parseArtifactManifest(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed?.version !== MANIFEST_VERSION)
+            return null;
+        if (typeof parsed.entry !== 'string' || !parsed.entry)
+            return null;
+        if (typeof parsed.title !== 'string' || !parsed.title)
+            return null;
+        if (!Array.isArray(parsed.exports))
+            return null;
+        if (typeof parsed.kind !== 'string' || typeof parsed.renderer !== 'string') {
+            return null;
+        }
+        if (!ALLOWED_KINDS.has(parsed.kind))
+            return null;
+        if (!ALLOWED_RENDERERS.has(parsed.renderer))
+            return null;
+        if (parsed.status !== undefined && !ALLOWED_STATUS.has(parsed.status)) {
+            return null;
+        }
+        if (parsed.exports.length === 0)
+            return null;
+        if (parsed.exports.some((value) => !ALLOWED_EXPORTS.has(value)))
+            return null;
+        return {
+            version: MANIFEST_VERSION,
+            kind: parsed.kind,
+            title: parsed.title,
+            entry: parsed.entry,
+            renderer: parsed.renderer,
+            status: ALLOWED_STATUS.has(parsed.status) ? parsed.status : 'complete',
+            exports: parsed.exports,
+            primary: parsed.primary === true || typeof parsed.primary === 'string' ? parsed.primary : undefined,
+            supportingFiles: Array.isArray(parsed.supportingFiles) ? parsed.supportingFiles.filter((x) => typeof x === 'string') : undefined,
+            createdAt: typeof parsed.createdAt === 'string' ? parsed.createdAt : undefined,
+            updatedAt: typeof parsed.updatedAt === 'string' ? parsed.updatedAt : undefined,
+            sourceSkillId: typeof parsed.sourceSkillId === 'string' ? parsed.sourceSkillId : undefined,
+            designSystemId: typeof parsed.designSystemId === 'string' || parsed.designSystemId === null ? parsed.designSystemId : undefined,
+            metadata: parsed.metadata && typeof parsed.metadata === 'object' && !Array.isArray(parsed.metadata) ? parsed.metadata : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Infer a manifest for a legacy artifact file that predates manifest
+ * sidecars, from its entry file name alone (extension → kind → renderer).
+ * @returns `null` when the extension isn't a recognized artifact kind.
+ */
+export function inferLegacyManifest(input) {
+    const kind = inferKindFromEntry(input.entry);
+    if (!kind)
+        return null;
+    const lowerEntry = input.entry.toLowerCase();
+    const isDeck = kind === 'html' && (lowerEntry.includes('deck') || lowerEntry.includes('slides') || lowerEntry.includes('pitch'));
+    const renderer = isDeck
+        ? 'deck-html'
+        : kind === 'html'
+            ? 'html'
+            : kind === 'markdown-document'
+                ? 'markdown'
+                : kind === 'react-component'
+                    ? 'react-component'
+                    : kind === 'code-snippet'
+                        ? 'code'
+                        : kind; // only 'svg' remains — a valid ArtifactRendererId as-is
+    const resolvedKind = isDeck ? 'deck' : kind;
+    return {
+        version: MANIFEST_VERSION,
+        kind: resolvedKind,
+        title: input.title || input.entry,
+        entry: input.entry,
+        renderer,
+        status: 'complete',
+        exports: exportsForKind(resolvedKind),
+        primary: resolvedKind === 'html' || resolvedKind === 'deck' ? true : undefined,
+        metadata: input.metadata,
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/core/util/manifest.js.map

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

package/dist/core/util/markdown-context.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @module markdown-context
+ * @internal
+ *
+ * Shared Markdown-context helpers used by both the streaming artifact parser
+ * ({@link ./parser.js}) and the post-stream `<artifact>` stripper
+ * ({@link ./strip.js}). The single source of truth for what counts as a
+ * fenced code block or an inline code span, so the parser/stripper's view of
+ * a buffer matches what a Markdown-rendering chat surface will actually
+ * render — anything that "looks like" an artifact tag inside one of these
+ * regions is literal Markdown and must not be treated as a real protocol tag.
+ *
+ * Not part of the package's public surface (no `index.ts` re-export): it is
+ * an implementation detail shared by two sibling modules, not a name a
+ * consumer should depend on directly.
+ */
+export declare const FENCE_OPEN_RE: RegExp;
+export declare const FENCE_CLOSE_RE: RegExp;
+export declare const INLINE_CODE_RE: RegExp;
+/**
+ * `<artifact` followed by whitespace is a real protocol open tag; any other
+ * continuation (e.g. `<artifactual`) is a prefix-shared literal that must
+ * not be treated as a tag.
+ */
+export declare function isRealArtifactOpenAt(content: string, idx: number): boolean;
+export type Range = readonly [number, number];
+/**
+ * Compute the half-open `[start, end)` ranges of `buffer` that a Markdown
+ * renderer would treat as fenced code blocks or inline code spans. The
+ * `unclosedFenceStart` is the index of an opening fence with no matching
+ * close in the buffer (or `null` if every fence is closed) — the streaming
+ * parser uses it to hold back rendering; the stripper ignores it.
+ *
+ * Lines without a terminating `\n` (a trailing partial line during
+ * streaming) are not classified as fence delimiters here; callers that care
+ * about partial-tail behavior inspect the tail themselves.
+ *
+ * @complexity O(n) in `buffer.length` — one line-by-line scan plus one
+ *   backtick scan per accumulated paragraph block.
+ */
+export declare function computeSkipRanges(buffer: string): {
+    ranges: Range[];
+    unclosedFenceStart: number | null;
+};
+/** `true` when position `p` falls inside one of `ranges` (half-open intervals). */
+export declare function rangeContains(ranges: ReadonlyArray<Range>, p: number): boolean;
+//# sourceMappingURL=markdown-context.d.ts.map

package/dist/core/util/markdown-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-context.d.ts","sourceRoot":"","sources":["../../../src/core/util/markdown-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,eAAO,MAAM,aAAa,QAAyB,CAAC;AACpD,eAAO,MAAM,cAAc,QAAa,CAAC;AAGzC,eAAO,MAAM,cAAc,QAAa,CAAC;AAUzC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAG1E;AAED,MAAM,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE9C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG;IACjD,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAwDA;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAK9E"}

package/dist/core/util/markdown-context.js

@@ -0,0 +1,125 @@
+/**
+ * @module markdown-context
+ * @internal
+ *
+ * Shared Markdown-context helpers used by both the streaming artifact parser
+ * ({@link ./parser.js}) and the post-stream `<artifact>` stripper
+ * ({@link ./strip.js}). The single source of truth for what counts as a
+ * fenced code block or an inline code span, so the parser/stripper's view of
+ * a buffer matches what a Markdown-rendering chat surface will actually
+ * render — anything that "looks like" an artifact tag inside one of these
+ * regions is literal Markdown and must not be treated as a real protocol tag.
+ *
+ * Not part of the package's public surface (no `index.ts` re-export): it is
+ * an implementation detail shared by two sibling modules, not a name a
+ * consumer should depend on directly.
+ */
+// Line-anchored fence delimiters. Deliberately asymmetric: an opening fence
+// may carry an info string (e.g. ```html), a closing fence must be a bare
+// triple-backtick line. Neither permits leading indentation — an indented
+// "   ```" line renders as a paragraph, not a fence.
+export const FENCE_OPEN_RE = /^```(\w[\w+-]*)?\s*$/;
+export const FENCE_CLOSE_RE = /^```\s*$/;
+// Inline code span (single-backtick pair).
+export const INLINE_CODE_RE = /`[^`]+`/g;
+// Paragraph-break recognizers — mirror a typical Markdown paragraph-block
+// walker's block-starter set (heading / list item / blank line). A block
+// boundary caps how far inline-code backtick pairing can reach: backticks
+// never pair across it in the rendered output.
+const HEADING_RE = /^#{1,4}\s+/;
+const UL_ITEM_RE = /^\s*[-*+]\s+/;
+const OL_ITEM_RE = /^\s*\d+\.\s+/;
+/**
+ * `<artifact` followed by whitespace is a real protocol open tag; any other
+ * continuation (e.g. `<artifactual`) is a prefix-shared literal that must
+ * not be treated as a tag.
+ */
+export function isRealArtifactOpenAt(content, idx) {
+    const next = content.charAt(idx + '<artifact'.length);
+    return next !== '' && /\s/.test(next);
+}
+/**
+ * Compute the half-open `[start, end)` ranges of `buffer` that a Markdown
+ * renderer would treat as fenced code blocks or inline code spans. The
+ * `unclosedFenceStart` is the index of an opening fence with no matching
+ * close in the buffer (or `null` if every fence is closed) — the streaming
+ * parser uses it to hold back rendering; the stripper ignores it.
+ *
+ * Lines without a terminating `\n` (a trailing partial line during
+ * streaming) are not classified as fence delimiters here; callers that care
+ * about partial-tail behavior inspect the tail themselves.
+ *
+ * @complexity O(n) in `buffer.length` — one line-by-line scan plus one
+ *   backtick scan per accumulated paragraph block.
+ */
+export function computeSkipRanges(buffer) {
+    const ranges = [];
+    // Paragraph-block regions are contiguous spans of paragraph lines outside
+    // any fenced code block; inline-code scanning is restricted to one block at
+    // a time so backticks never pair across a block boundary.
+    const blockRegions = [];
+    let pos = 0;
+    let inFence = false;
+    let fenceStart = -1;
+    let blockStart = -1;
+    const closeBlockBefore = (idx) => {
+        if (blockStart !== -1 && idx > blockStart)
+            blockRegions.push([blockStart, idx]);
+        blockStart = -1;
+    };
+    while (pos < buffer.length) {
+        const eol = buffer.indexOf('\n', pos);
+        const lineEnd = eol === -1 ? buffer.length : eol;
+        const line = buffer.slice(pos, lineEnd);
+        const lineHasNewline = eol !== -1;
+        if (!inFence) {
+            if (lineHasNewline && FENCE_OPEN_RE.test(line)) {
+                closeBlockBefore(pos);
+                inFence = true;
+                fenceStart = pos;
+            }
+            else if (line.trim() === '') {
+                closeBlockBefore(pos);
+            }
+            else if (HEADING_RE.test(line) || UL_ITEM_RE.test(line) || OL_ITEM_RE.test(line)) {
+                // Each heading/list-item line is its own inline-scan region rather
+                // than joining adjacent paragraphs.
+                closeBlockBefore(pos);
+                blockRegions.push([pos, lineEnd]);
+            }
+            else {
+                if (blockStart === -1)
+                    blockStart = pos;
+            }
+        }
+        else if (lineHasNewline && FENCE_CLOSE_RE.test(line)) {
+            inFence = false;
+            ranges.push([fenceStart, eol + 1]);
+            fenceStart = -1;
+        }
+        if (!lineHasNewline)
+            break; // trailing partial line — already accounted for above
+        pos = eol + 1;
+    }
+    if (!inFence)
+        closeBlockBefore(buffer.length); // flush an open paragraph region at end-of-buffer
+    for (const [s, e] of blockRegions) {
+        INLINE_CODE_RE.lastIndex = 0;
+        const segment = buffer.slice(s, e);
+        let m = INLINE_CODE_RE.exec(segment);
+        while (m !== null) {
+            ranges.push([s + m.index, s + m.index + m[0].length]);
+            m = INLINE_CODE_RE.exec(segment);
+        }
+    }
+    return { ranges, unclosedFenceStart: inFence ? fenceStart : null };
+}
+/** `true` when position `p` falls inside one of `ranges` (half-open intervals). */
+export function rangeContains(ranges, p) {
+    for (const [s, e] of ranges) {
+        if (p >= s && p < e)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=markdown-context.js.map

package/dist/core/util/markdown-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-context.js","sourceRoot":"","sources":["../../../src/core/util/markdown-context.ts"],"names":[],"mappings":"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"}

package/dist/core/util/markup-attributes.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module markup-attributes
+ *
+ * Shared quoted-attribute parser for this package's inline protocol tags —
+ * `<artifact …>` (`./parser.ts`, `./strip.ts`) and `<question-form …>` /
+ * `<ask-question …>` (`../question-form/scan.ts`). All three interpret
+ * model-produced markup with the exact same tolerant grammar; centralizing
+ * it means a future correction to escaping, accepted attribute names, or
+ * malformed-quote handling can't drift between streaming, post-stream, and
+ * question-form parsing.
+ *
+ * Internal only — deliberately not part of this package's public surface;
+ * see `./index.ts`'s barrel comment.
+ */
+/**
+ * Parse `name="value"` / `name='value'` pairs out of a tag's raw attribute
+ * string (the content between the tag name and the closing `>`).
+ */
+export declare function parseQuotedAttrs(raw: string): Record<string, string>;
+//# sourceMappingURL=markup-attributes.d.ts.map

package/dist/core/util/markup-attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markup-attributes.d.ts","sourceRoot":"","sources":["../../../src/core/util/markup-attributes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAapE"}

package/dist/core/util/markup-attributes.js

@@ -0,0 +1,33 @@
+/**
+ * @module markup-attributes
+ *
+ * Shared quoted-attribute parser for this package's inline protocol tags —
+ * `<artifact …>` (`./parser.ts`, `./strip.ts`) and `<question-form …>` /
+ * `<ask-question …>` (`../question-form/scan.ts`). All three interpret
+ * model-produced markup with the exact same tolerant grammar; centralizing
+ * it means a future correction to escaping, accepted attribute names, or
+ * malformed-quote handling can't drift between streaming, post-stream, and
+ * question-form parsing.
+ *
+ * Internal only — deliberately not part of this package's public surface;
+ * see `./index.ts`'s barrel comment.
+ */
+/**
+ * Parse `name="value"` / `name='value'` pairs out of a tag's raw attribute
+ * string (the content between the tag name and the closing `>`).
+ */
+export function parseQuotedAttrs(raw) {
+    const re = /(\w+)\s*=\s*(?:"([^"]*)"|'([^']*)')/g;
+    const out = {};
+    let m = re.exec(raw);
+    while (m !== null) {
+        // The pattern's quote alternation means exactly one of group 2 (double-
+        // quoted) / group 3 (single-quoted) participates in any successful match
+        // — never both, never neither — so `m[2] ?? m[3]` is always defined; the
+        // cast just satisfies `noUncheckedIndexedAccess`.
+        out[m[1]] = (m[2] ?? m[3]);
+        m = re.exec(raw);
+    }
+    return out;
+}
+//# sourceMappingURL=markup-attributes.js.map

package/dist/core/util/markup-attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markup-attributes.js","sourceRoot":"","sources":["../../../src/core/util/markup-attributes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,EAAE,GAAG,sCAAsC,CAAC;IAClD,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,IAAI,CAAC,GAA2B,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QAClB,wEAAwE;QACxE,yEAAyE;QACzE,yEAAyE;QACzE,kDAAkD;QAClD,GAAG,CAAC,CAAC,CAAC,CAAC,CAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAW,CAAC;QAC/C,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}