@amalgm/chat 0.2.8 → 0.2.9-main.34746990150

package/PURPOSE.md

@@ -21,7 +21,8 @@ automations, and third-party apps must all use the same public SDK.
 - A **session update** is the official ACP output shape.
 - A **step usage record** is Amalgm's immutable usage extension for one model
   step.
-- A **turn usage record** is derived from its finalized step usage records.
+- A **turn usage record** is a provider-reported turn aggregate or a derivation
+  from proven steps or cumulative meter baselines.
 - A **raw record** is the native provider evidence retained beside a normalized
   projection.
 - A **prompt** is an ordered list of official ACP content blocks.
@@ -50,16 +51,22 @@ automations, and third-party apps must all use the same public SDK.
    and `tool_call_update` with `pending`, `in_progress`, `completed`, or
    `failed` state.
 5. MCP describes remote tools and their transport. In-process tools may skip
-   MCP transport, but they expose the same content and result semantics.
+    MCP transport, but they expose the same content and result semantics.
+    Every structured tool result is an object; list results have a named array
+    field and pass the official MCP result schema.
 6. A model step has one stable id and at most one finalized usage record.
    Replay, reconnect, and additional subscribers cannot add usage.
 7. Unknown token counts are `null`, never zero. Zero means the provider
    explicitly measured zero.
-8. Turn usage is the bucket-wise sum of its steps only when every contributing
-   step reports that bucket. Otherwise that turn bucket is `null`.
+   A provider SDK's initialized counters on a rejected invocation are not a
+   measurement; their raw values remain evidence, not billable zero usage.
+8. A provider turn aggregate is authoritative for that turn; otherwise usage
+   is the sum of proven steps only where every step reports the bucket.
 9. A cumulative provider counter becomes a step delta only against a proven
    prior baseline. A missing baseline or counter reset remains unknown.
 10. Raw provider usage and its provenance survive normalization.
+    Usage observations commit to the turn before provider iteration advances;
+    context telemetry remains independent of billable token totals.
 11. Every surface consumes official ACP session updates; Chat has no second
     event grammar.
 12. Provider-specific behavior stays in adapters. Surfaces do not branch on
@@ -105,6 +112,8 @@ automations, and third-party apps must all use the same public SDK.
 28. The official ACP `McpServer` union is the one prepared tool-injection
     shape. Toolbox selections resolve to `McpServer[]`; native adapters only
     project that exact list into provider configuration.
+    Native connected apps, plugins, and ambient MCP configuration cannot add
+    unselected servers to a prepared execution.
 29. Amalgm products exposed to agents are ordinary selected MCP servers. Tools,
     Agents, Chat, and future platform capabilities receive no ambient or
     provider-specific injection path.
@@ -112,10 +121,14 @@ automations, and third-party apps must all use the same public SDK.
     instruction bundle. Adapters consume that prepared bundle through a native
     system/developer-instruction channel; they never reread instruction sources
     or prepend instructions to ACP user prompt content.
-31. Stable ACP has no client-supplied system-instruction field. An ACP agent
+    Machine instructions come from the host-selected Amalgm root; unreadable
+    instruction sources fail preparation rather than silently removing guidance.
+31. Stable ACP has no client-supplied system-instruction field. A generic ACP agent
     receives prepared instructions only through a namespaced `_meta` extension
     it advertised during initialization; otherwise non-empty instructions are
     rejected as unsupported.
+    The native Cursor adapter uses an immutable managed rules directory for
+    instructions and ACP's session cwd for the execution workspace.
 32. A tool selection revision is the exact immutable deployment-head digest
     supplied by Tools, not a machine-local database counter. Preparation must
     resolve that digest or fail; once prepared, the resulting official ACP
@@ -145,6 +158,30 @@ automations, and third-party apps must all use the same public SDK.
     admitted message creates that exact conversation; every later message
     resumes it, and the provider message id is the stable turn id. Chat never
     infers a thread from a subject or chooses a recipient.
+39. Provider failure is a turn outcome, never an ACP transcript part and never
+    successful end-of-stream. Committed output survives a later provider failure.
+40. One conversation admits one provider session and one turn at a time, including
+    while asynchronous creation or input persistence is pending.
+41. An execution change cannot erase conversation context. Without a proven native
+    checkpoint, the host supplies committed history as an explicit ACP resource.
+42. Transcript activity has one text, reasoning, or tool shape and one state
+    vocabulary: pending, active, complete, error. A tool id identifies one part
+    throughout a turn; later detail cannot erase its identity, result, or terminal
+    state. Titles and optional timing are presentation facts, not tool identity.
+    Usage and compaction are session telemetry, not transcript content.
+43. Attachment bytes belong to the accepted ACP prompt. A native adapter that
+    needs a filesystem path receives a host materialization of those bytes;
+    that derived file is never the durable source of truth.
+44. A managed provider home belongs to one installation and one auth authority.
+    Child environments contain standard process and network settings plus
+    explicitly prepared credentials; they never inherit host service secrets.
+    Native adapters project the configured provider base onto their SDK's API
+    path; an SDK's appended path cannot change the selected authority.
+    Subscription, platform, and distinct BYOK credentials cannot share persisted
+    provider configuration or login material.
+45. A caller-supplied conversation id is an idempotency key within its owner
+    and installation. Retrying start rejoins that conversation, including after
+    a provider launch failed; it never replaces accepted history.
 
 ## North-star proof
 
@@ -164,41 +201,57 @@ require a new event grammar, transcript reducer, or UI data model.
 
 ## Current truth
 
-The public SDK now has a high-level `Chat` capability, official ACP prompt
-content, a normalized prepared-execution contract, exact revision handles, and
-an official ACP output projection. Five native adapters and one generic ACP
-adapter receive the canonical prompt directly. Every native adapter has been
-exercised through the real public session path with text and an image. Claude
-Code and Pi also passed combined image, selected-MCP-tool, `ask` permission,
-tool-result, and streamed-output turns. Cursor and OpenCode have equivalent
-real tool acceptance, and the generic adapter passed text and a selected MCP
-tool against the live Cursor ACP server. Cursor accepts its native login or a
-Cursor API key; OpenCode accepts an exact catalog variant. Step-usage identity
-and aggregation are first-class laws. The public path now persists private
-conversation headers, prompts, transcript projections, terminal turns, and
-official ACP updates through an injected store. The reference SQLite adapter
-uses WAL and commits input before provider invocation and output before fanout.
-One background pump continues without subscribers; cursor replay survives a
-host restart, and uncertain running turns recover as interrupted. The shipped
-skill teaches this path.
-
-The composable Node host uses the same owner-scoped SQLite journal and exposes
-one HTTP protocol for execution preparation, conversation start/resume, turns,
-official ACP updates, cursor reconnect, and interrupt. One user database holds
-many private conversations across agent installations, while provider-native
-homes remain isolated per installation beneath a host-supplied machine-local
-runtime-state root.
-
-It is not yet the complete north star. The remote gateway/Live authority does
-not yet expose the conversation catalog and change stream; Live/R2
-synchronization is not connected; provider adapters do not yet feed the full
-step-usage ledger; every attachment form has not been exercised against every
-provider; and permission requests are not yet a first-class application
-stream. Generic ACP admission works from an immutable agent launch descriptor,
-but the machine/project instruction-source revision is not yet represented in
-the control-plane execution selection, and ACP agents must advertise the
-Amalgm session-instructions extension before receiving non-empty system
-instructions. Amp, Gemini CLI, and Kiro were not installed for individual
-acceptance tests.
+The public SDK has one high-level `Chat` capability, official ACP prompt
+content, immutable prepared executions, and durable official ACP updates. The
+Node host composes one owner-scoped SQLite journal and one HTTP/SSE protocol.
+Input commits before provider invocation, output and usage commit before fanout,
+and reconnect reads the same journal. Disconnect leaves the runtime pump alive;
+uncertain work after restart becomes interrupted. Structured provider failures
+retain partial output and remain failed in the stream and saved history.
+
+Claude Code, Codex, Cursor, OpenCode, Pi, and a generic OpenCode ACP process have
+passed real text, image, file, and selected MCP-tool turns through the local
+Shell. The paired UI uses the same public client and transcript reducer. Saved
+execution choices survive reload, and continuation survives auth changes through
+explicit committed-history delivery when a native checkpoint cannot be reused.
+The dated evidence and account-specific limits are recorded in
+`docs/chat-roadmap.md`.
+
+All five native harnesses receive the same selected seven-product MCP loadout
+and recover prepared machine instructions in real turns. Cursor's current ACP
+implementation omits MCP names, inputs and result bodies from tool updates and
+sometimes reports an upstream error as ordinary agent text plus `end_turn`.
+Those omissions remain explicit upstream parity gaps; Chat neither invents
+tool identity nor classifies arbitrary agent prose as a structured failure.
+
+Native usage observations and optional ACP prompt usage persist with their raw
+source. Turn totals, cache and reasoning buckets, reported cost, and current
+context remain separate facts; unknown values remain null. Providers that do
+not expose model-step identity cannot populate an exact per-step ledger.
+
+The remote gateway/Live authority does not yet expose the conversation catalog
+and change stream; Live/R2 synchronization is not connected. Durable queued
+turns, identity-targeted abort, and application-stream permission interaction
+remain separate work described in the acceptance plan. Every attachment form
+has not been exercised against every provider. Generic ACP admission uses an
+immutable launch descriptor, and non-empty system instructions require the
+agent to advertise the Amalgm session-instructions extension. The machine/project
+instruction-source revision is not yet represented in control-plane execution
+selection. Amp, Gemini CLI, and Kiro were not installed for individual acceptance.
 
 The public contracts live in `docs/contracts/` and the shipped Chat skill.
+
+## Managed package delivery
+
+Managed package delivery starts from a clean, exact main or preview source
+commit. The workflow occurrence supplies only its generated version and source
+record; tests run against those candidate inputs before packing. Every native
+gate and publication use that same tarball and integrity. A candidate tag makes
+bytes available to release assembly; it never promotes an installed runtime.
+Release tooling remains available inside each owner repository so a developer
+or CI job never needs access to another private product repository.
+Registry credentials are available only to the final protected publication job,
+after every native examination proves the exact candidate bytes.
+Native consumers install the archive as a dependency, so SDK development
+dependencies never become an end-user installation requirement.
+Each admitted owner gate proves its actual checkout equals the managed source.

package/README.md

@@ -14,6 +14,9 @@ for ACP-native tool injection and prepared instructions, and
 [docs/contracts/conversation-persistence.md](docs/contracts/conversation-persistence.md)
 for local conversations and durable turns.
 
+This chat's completed work, acceptance evidence and remaining priorities are
+tracked in [docs/chat-roadmap.md](docs/chat-roadmap.md).
+
 ```ts
 import { Chat } from "@amalgm/chat";
 import {
@@ -103,7 +106,17 @@ npm test
 npm pack --dry-run
 ```
 
-Package releases use `.github/workflows/publish-package.yml`. A reviewed main
-commit is tagged exactly `v<package version>`; trusted npm publishing stages
-that package, and a maintainer approves the staged artifact with 2FA. Manual
-dirty-worktree publishing is not a release path.
+Managed npm delivery uses `.github/workflows/publish-package.yml` after the
+exact main/preview owner checks pass. The occurrence generates a unique
+prerelease version and records its source SHA; it reruns the owner suite, packs
+once, and installs that tarball on Linux, macOS and Windows before publication.
+The `candidate-main`/`candidate-preview` tags are release-assembly inputs and
+never select installed runtimes. `package.json` declares this owner's gates,
+CLI probes, peer-only exports and lifecycle permissions. The standalone runner
+under `scripts/release/` is intentionally copied across owners to preserve
+private repository access boundaries. The final publish step uses the `NPM_TOKEN`
+secret in the `npm-release` environment. Where npm trusted publishing is
+configured for this repository's `publish-package.yml` and that environment,
+the token can be omitted. Authentication does not replace native certification,
+exact source records or artifact integrity; private source repositories do not
+receive npm's public-source provenance.

package/dist/acp/projection.d.ts

@@ -11,6 +11,14 @@ export interface AmalgmAcpMeta {
     conversationId?: string;
     turnId?: string;
     sequence?: number;
+    tool?: {
+        name?: string;
+        kind?: string;
+        timing?: unknown;
+        metadata?: unknown;
+        detail?: string;
+        error?: unknown;
+    };
     native: {
         type: string;
         timestampMs: number;

package/dist/acp/projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/acp/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EAEb,QAAQ,EACT,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,GAAG,CAAC,EAAE,OAAO,CAAC;KACf,CAAC;CACH;AAoBD,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CA6BrD;AAgBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,oBAAyB,GACjC,aAAa,GAAG,IAAI,CA4EtB;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,GAAG,IAAI,CAI5B"}
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/acp/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EAEb,QAAQ,EACT,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAE5C,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAChH,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,GAAG,CAAC,EAAE,OAAO,CAAC;KACf,CAAC;CACH;AA8BD,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CA6BrD;AAgBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,oBAAyB,GACjC,aAAa,GAAG,IAAI,CAyEtB;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,oBAAyB,GACjC,mBAAmB,GAAG,IAAI,CAI5B"}

package/dist/acp/projection.js

@@ -9,6 +9,16 @@ function projectionMeta(event, context) {
         ...(context.turnId === undefined ? {} : { turnId: context.turnId }),
         ...(context.sequence === undefined ? {} : { sequence: context.sequence }),
     };
+    if (event.type === 'tool.started' || event.type === 'tool.updated' || event.type === 'tool.completed') {
+        amalgm.tool = {
+            ...(event.toolName === undefined ? {} : { name: event.toolName }),
+            ...(event.kind === undefined ? {} : { kind: event.kind }),
+            ...(event.timing === undefined ? {} : { timing: event.timing }),
+            ...(event.metadata === undefined ? {} : { metadata: event.metadata }),
+            ...(event.detail === undefined ? {} : { detail: event.detail }),
+            ...('error' in event && event.error !== undefined ? { error: event.error } : {}),
+        };
+    }
     return { [AMALGM_ACP_META_KEY]: amalgm };
 }
 /** Map the richer native tool vocabulary into ACP's stable categories. */
@@ -122,9 +132,6 @@ export function toAcpSessionUpdate(event, context = {}) {
                 sessionUpdate: 'usage_update',
                 used,
                 size,
-                ...(event.usage.costUsd === null
-                    ? {}
-                    : { cost: { amount: event.usage.costUsd, currency: 'USD' } }),
                 _meta,
             };
         }

package/dist/acp/projection.js.map

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

package/dist/conversations/index.d.ts

@@ -1,3 +1,4 @@
 export * from './types.js';
 export * from './transcript.js';
+export * from './transcript-parts.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/conversations/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversations/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversations/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}

package/dist/conversations/index.js

@@ -1,3 +1,4 @@
 export * from './types.js';
 export * from './transcript.js';
+export * from './transcript-parts.js';
 //# sourceMappingURL=index.js.map

package/dist/conversations/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/conversations/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/conversations/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}

package/dist/conversations/transcript-parts.d.ts

@@ -0,0 +1,38 @@
+import type { ContentBlock, ToolCallContent, ToolCallLocation, ToolCallStatus, ToolKind } from '@agentclientprotocol/sdk';
+export type TranscriptPartState = 'pending' | 'active' | 'complete' | 'error';
+export interface TranscriptTiming {
+    startedAt?: string | number;
+    completedAt?: string | number;
+    elapsedMs?: number;
+}
+export interface TranscriptTextPart {
+    type: 'text' | 'reasoning';
+    text: string;
+    state: TranscriptPartState;
+    messageId?: string;
+    timing?: TranscriptTiming;
+}
+export interface TranscriptToolPart {
+    type: 'tool';
+    toolCallId: string;
+    /** ACP titles may change; a native tool name is separate and may be unknown. */
+    toolName: string | null;
+    title: string;
+    kind?: ToolKind;
+    status: ToolCallStatus;
+    state: TranscriptPartState;
+    input?: unknown;
+    output?: unknown;
+    content?: ToolCallContent[];
+    locations?: ToolCallLocation[];
+    timing?: TranscriptTiming;
+    _meta?: Record<string, unknown>;
+    /** The turn ended before the provider reported a terminal tool result. */
+    incomplete?: boolean;
+}
+export type TranscriptPart = TranscriptTextPart | TranscriptToolPart | (Exclude<ContentBlock, {
+    type: 'text';
+}> & {
+    state: TranscriptPartState;
+});
+//# sourceMappingURL=transcript-parts.d.ts.map

package/dist/conversations/transcript-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-parts.d.ts","sourceRoot":"","sources":["../../src/conversations/transcript-parts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAE1H,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,mBAAmB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AACD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,0EAA0E;IAC1E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AACD,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG;IAAE,KAAK,EAAE,mBAAmB,CAAA;CAAE,CAAC,CAAC"}

package/dist/conversations/transcript-parts.js

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

package/dist/conversations/transcript-parts.js.map

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

package/dist/conversations/transcript-tools.d.ts

@@ -0,0 +1,11 @@
+import type { ToolCall, ToolCallUpdate } from '@agentclientprotocol/sdk';
+import type { TranscriptTiming, TranscriptToolPart } from './transcript-parts.js';
+type AnyRecord = Record<string, unknown>;
+export declare function record(value: unknown): AnyRecord;
+export declare function updateTiming(update: {
+    _meta?: unknown;
+}): TranscriptTiming | undefined;
+/** ACP tool updates are patches, including updates received before a start. */
+export declare function reduceTranscriptTool(current: TranscriptToolPart | undefined, update: ToolCall | ToolCallUpdate): TranscriptToolPart;
+export {};
+//# sourceMappingURL=transcript-tools.d.ts.map

package/dist/conversations/transcript-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-tools.d.ts","sourceRoot":"","sources":["../../src/conversations/transcript-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAElF,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACzC,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAEhD;AACD,wBAAgB,YAAY,CAAC,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,gBAAgB,GAAG,SAAS,CAStF;AAKD,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,EAAE,MAAM,EAAE,QAAQ,GAAG,cAAc,GAAG,kBAAkB,CAwBnI"}

package/dist/conversations/transcript-tools.js

@@ -0,0 +1,47 @@
+export function record(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+export function updateTiming(update) {
+    const amalgm = record(record(update._meta)['amalgm']);
+    const tool = record(amalgm['tool']);
+    const native = record(amalgm['native']);
+    if (Object.keys(record(tool['timing'])).length)
+        return tool['timing'];
+    const ts = native['timestampMs'];
+    if (typeof ts !== 'number' || !Number.isFinite(ts))
+        return undefined;
+    const terminal = native['type'] === 'tool.completed';
+    return terminal ? { completedAt: new Date(ts).toISOString() } : { startedAt: new Date(ts).toISOString() };
+}
+function terminal(status) {
+    return status === 'completed' || status === 'failed';
+}
+/** ACP tool updates are patches, including updates received before a start. */
+export function reduceTranscriptTool(current, update) {
+    const meta = { ...current?._meta, ...record(update._meta) };
+    const priorAmalgm = record(current?._meta?.['amalgm']);
+    const amalgm = record(record(update._meta)['amalgm']);
+    const tool = { ...record(priorAmalgm['tool']), ...record(amalgm['tool']) };
+    if (Object.keys(priorAmalgm).length || Object.keys(amalgm).length)
+        meta['amalgm'] = { ...priorAmalgm, ...amalgm, tool };
+    const toolName = typeof tool['name'] === 'string' && tool['name'] ? tool['name'] : current?.toolName ?? null;
+    const status = current && terminal(current.status) ? current.status : update.status ?? current?.status ?? 'pending';
+    const timing = { ...current?.timing, ...updateTiming(update) };
+    if (current?.timing?.startedAt !== undefined)
+        timing.startedAt = current.timing.startedAt;
+    return {
+        ...current,
+        type: 'tool', toolCallId: update.toolCallId, toolName,
+        title: update.title || current?.title || toolName || 'Tool',
+        ...(update.kind == null ? {} : { kind: update.kind }),
+        status,
+        state: status === 'completed' ? 'complete' : status === 'failed' ? 'error' : status === 'pending' ? 'pending' : 'active',
+        ...(update.rawInput === undefined ? {} : { input: update.rawInput }),
+        ...(update.rawOutput === undefined ? {} : { output: update.rawOutput }),
+        ...(update.content == null ? {} : { content: update.content }),
+        ...(update.locations == null ? {} : { locations: update.locations }),
+        ...(Object.keys(timing).length ? { timing } : {}),
+        ...(Object.keys(meta).length ? { _meta: meta } : {}),
+    };
+}
+//# sourceMappingURL=transcript-tools.js.map

package/dist/conversations/transcript-tools.js.map

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

package/dist/conversations/transcript.d.ts

@@ -1,13 +1,14 @@
 import type { SessionUpdate } from '@agentclientprotocol/sdk';
+import type { TranscriptPart } from './transcript-parts.js';
 export interface AcpTranscriptState {
-    parts: unknown[];
+    parts: TranscriptPart[];
     textPartIndex: number | null;
     reasoningPartIndex: number | null;
     toolPartIndexById: Map<string, number>;
 }
 export declare function createAcpTranscriptState(): AcpTranscriptState;
-/** Fold one official ACP update into the UI transcript projection. */
-export declare function applyAcpTranscriptUpdate(state: AcpTranscriptState, input: SessionUpdate): void;
-export declare function finalizeAcpTranscript(state: AcpTranscriptState, failed?: boolean): readonly unknown[];
+/** The same provider-independent ACP projection serves live, replay, and storage. */
+export declare function applyAcpTranscriptUpdate(state: AcpTranscriptState, update: SessionUpdate): void;
+export declare function finalizeAcpTranscript(state: AcpTranscriptState, failed?: boolean): readonly TranscriptPart[];
 export declare function promptContentPlain(parts: readonly unknown[]): string | null;
 //# sourceMappingURL=transcript.d.ts.map

package/dist/conversations/transcript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../src/conversations/transcript.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAK9D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAO7D;AA8GD,sEAAsE;AACtE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,kBAAkB,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CA4B9F;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAQ,GAAG,SAAS,OAAO,EAAE,CAanG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,GAAG,IAAI,CAO3E"}
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../src/conversations/transcript.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAA0C,MAAM,uBAAuB,CAAC;AAGpG,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AA2BD,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAwB/F;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAQ,GAAG,SAAS,cAAc,EAAE,CAK1G;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,GAAG,IAAI,CAI3E"}