@amalgm/chat 0.2.7 → 0.2.9-main.34175712248

package/PURPOSE.md

@@ -33,6 +33,8 @@ automations, and third-party apps must all use the same public SDK.
   capability, never a second session, turn, or transcript owner.
 - An **agent run** is one idempotently named new conversation whose exact
   installed-agent execution is resolved by the host before its first turn.
+- An **external message** is one idempotently named turn in a provider thread
+  whose stable thread mapping supplies the durable conversation id.
 
 ## Workstream 1 axioms
 
@@ -139,6 +141,10 @@ automations, and third-party apps must all use the same public SDK.
 37. Agent-run occurrence context is a separate official ACP JSON resource,
     never system instructions or ambient host state. The host resolves the
     installation to one exact execution contract before Chat starts it.
+38. An external channel thread names one durable conversation. Its first
+    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.
 
 ## North-star proof
 
@@ -196,3 +202,18 @@ instructions. Amp, Gemini CLI, and Kiro were not installed for individual
 acceptance tests.
 
 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

@@ -103,7 +103,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/index.d.ts

@@ -11,5 +11,7 @@ export * as conversations from './conversations/index.js';
 export * as mcp from './mcp/index.js';
 export { Chat, ChatTurnStream, ChatSession, InterruptUnsupportedError, SessionAgentMismatchError, SessionAlreadyExistsError, SessionBusyError, SessionNotFoundError, SubscriberBackpressureError, TurnStreamError, } from './sessions/index.js';
 export type { ChatRuntimePort, InterruptResult, RuntimeInterruptRequest, } from './sessions/index.js';
+export { createExternalMessageRunner } from './sessions/index.js';
+export type { ExternalMessageAdmission, ExternalMessageExecution, ExternalMessageInput, ExternalMessageRunner, } from './sessions/index.js';
 export type { ClockMsPort, ClockIsoPort, Sha256HexPort, RandomUuidPort } from './ports.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,EACL,IAAI,EACJ,cAAc,EACd,WAAW,EACX,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,eAAe,EACf,eAAe,EACf,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,EACL,IAAI,EACJ,cAAc,EACd,WAAW,EACX,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,eAAe,EACf,eAAe,EACf,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,YAAY,EACV,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -10,4 +10,5 @@ export * as sessions from './sessions/index.js';
 export * as conversations from './conversations/index.js';
 export * as mcp from './mcp/index.js';
 export { Chat, ChatTurnStream, ChatSession, InterruptUnsupportedError, SessionAgentMismatchError, SessionAlreadyExistsError, SessionBusyError, SessionNotFoundError, SubscriberBackpressureError, TurnStreamError, } from './sessions/index.js';
+export { createExternalMessageRunner } from './sessions/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,EACL,IAAI,EACJ,cAAc,EACd,WAAW,EACX,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,UAAU,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAC;AAC1C,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,aAAa,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,GAAG,MAAM,gBAAgB,CAAC;AACtC,OAAO,EACL,IAAI,EACJ,cAAc,EACd,WAAW,EACX,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/normalizers/claude.d.ts

@@ -235,6 +235,29 @@ export declare function createClaudeNormalizer(events: EventConstructors): {
             method?: string | undefined;
             payload?: unknown;
         } | undefined;
+    } | {
+        ts: number;
+        type: "compaction.started";
+        trigger: "auto" | "manual" | "model_triggered";
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+    } | {
+        ts: number;
+        type: "compaction.finished";
+        trigger: "auto" | "manual" | "model_triggered";
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+        preTokens?: number | null | undefined;
+        postTokens?: number | null | undefined;
+        durationMs?: number | null | undefined;
     } | {
         ts: number;
         type: "warning";
@@ -310,29 +333,6 @@ export declare function createClaudeNormalizer(events: EventConstructors): {
             source: string;
             exact: boolean;
         } | undefined;
-    } | {
-        ts: number;
-        type: "compaction.started";
-        trigger: "auto" | "manual" | "model_triggered";
-        providerSessionId?: string | null | undefined;
-        raw?: {
-            source: string;
-            method?: string | undefined;
-            payload?: unknown;
-        } | undefined;
-    } | {
-        ts: number;
-        type: "compaction.finished";
-        trigger: "auto" | "manual" | "model_triggered";
-        providerSessionId?: string | null | undefined;
-        raw?: {
-            source: string;
-            method?: string | undefined;
-            payload?: unknown;
-        } | undefined;
-        preTokens?: number | null | undefined;
-        postTokens?: number | null | undefined;
-        durationMs?: number | null | undefined;
     })[];
     normalizeClaudeMessage: (message: AnyRecord | null | undefined, state?: ClaudeNormalizerState | null) => ({
         ts: number;
@@ -514,6 +514,29 @@ export declare function createClaudeNormalizer(events: EventConstructors): {
             method?: string | undefined;
             payload?: unknown;
         } | undefined;
+    } | {
+        ts: number;
+        type: "compaction.started";
+        trigger: "auto" | "manual" | "model_triggered";
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+    } | {
+        ts: number;
+        type: "compaction.finished";
+        trigger: "auto" | "manual" | "model_triggered";
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+        preTokens?: number | null | undefined;
+        postTokens?: number | null | undefined;
+        durationMs?: number | null | undefined;
     } | {
         ts: number;
         type: "warning";
@@ -589,29 +612,6 @@ export declare function createClaudeNormalizer(events: EventConstructors): {
             source: string;
             exact: boolean;
         } | undefined;
-    } | {
-        ts: number;
-        type: "compaction.started";
-        trigger: "auto" | "manual" | "model_triggered";
-        providerSessionId?: string | null | undefined;
-        raw?: {
-            source: string;
-            method?: string | undefined;
-            payload?: unknown;
-        } | undefined;
-    } | {
-        ts: number;
-        type: "compaction.finished";
-        trigger: "auto" | "manual" | "model_triggered";
-        providerSessionId?: string | null | undefined;
-        raw?: {
-            source: string;
-            method?: string | undefined;
-            payload?: unknown;
-        } | undefined;
-        preTokens?: number | null | undefined;
-        postTokens?: number | null | undefined;
-        durationMs?: number | null | undefined;
     })[];
     stableStringify: typeof stableStringify;
     stringifyClaudeContent: typeof stringifyClaudeContent;

package/dist/normalizers/codex.d.ts

@@ -243,6 +243,29 @@ export declare function createCodexNormalizer(events: EventConstructors): {
             method?: string | undefined;
             payload?: unknown;
         } | undefined;
+    } | {
+        ts: number;
+        type: "compaction.started";
+        trigger: "auto" | "manual" | "model_triggered";
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+    } | {
+        ts: number;
+        type: "compaction.finished";
+        trigger: "auto" | "manual" | "model_triggered";
+        providerSessionId?: string | null | undefined;
+        raw?: {
+            source: string;
+            method?: string | undefined;
+            payload?: unknown;
+        } | undefined;
+        preTokens?: number | null | undefined;
+        postTokens?: number | null | undefined;
+        durationMs?: number | null | undefined;
     } | {
         ts: number;
         type: "warning";
@@ -318,29 +341,6 @@ export declare function createCodexNormalizer(events: EventConstructors): {
             source: string;
             exact: boolean;
         } | undefined;
-    } | {
-        ts: number;
-        type: "compaction.started";
-        trigger: "auto" | "manual" | "model_triggered";
-        providerSessionId?: string | null | undefined;
-        raw?: {
-            source: string;
-            method?: string | undefined;
-            payload?: unknown;
-        } | undefined;
-    } | {
-        ts: number;
-        type: "compaction.finished";
-        trigger: "auto" | "manual" | "model_triggered";
-        providerSessionId?: string | null | undefined;
-        raw?: {
-            source: string;
-            method?: string | undefined;
-            payload?: unknown;
-        } | undefined;
-        preTokens?: number | null | undefined;
-        postTokens?: number | null | undefined;
-        durationMs?: number | null | undefined;
     })[];
 };
 /** The Codex normalizer set, closed over injected constructors. */

package/dist/sessions/external-message.d.ts

@@ -0,0 +1,30 @@
+import type { ConversationRecord } from '../conversations/types.js';
+import type { ExecutionContract } from '../execution/contract.js';
+import type { Chat } from './chat.js';
+export interface ExternalMessageInput {
+    readonly origin: string;
+    readonly threadId: string;
+    readonly sessionId: string;
+    readonly messageId: string;
+    readonly startsSession: boolean;
+    readonly title: string;
+    readonly message: string;
+}
+export interface ExternalMessageExecution {
+    readonly execution: ExecutionContract;
+    readonly title?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface ExternalMessageAdmission {
+    readonly sessionId: string;
+    readonly turnId: string;
+    readonly completion: Promise<unknown>;
+}
+export interface ExternalMessageRunner {
+    admit(input: ExternalMessageInput): Promise<ExternalMessageAdmission>;
+}
+export declare function createExternalMessageRunner<Binding, RuntimeSession>(chat: Chat<Binding, RuntimeSession>, options: Readonly<{
+    resolveNew(input: ExternalMessageInput): Promise<ExternalMessageExecution> | ExternalMessageExecution;
+    resolveExisting(record: ConversationRecord): Promise<ExternalMessageExecution> | ExternalMessageExecution;
+}>): ExternalMessageRunner;
+//# sourceMappingURL=external-message.d.ts.map

package/dist/sessions/external-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-message.d.ts","sourceRoot":"","sources":["../../src/sessions/external-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACvE;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,cAAc,EACjE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,EACnC,OAAO,EAAE,QAAQ,CAAC;IAChB,UAAU,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAAC;IACtG,eAAe,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAAC;CAC3G,CAAC,GACD,qBAAqB,CAwDvB"}

package/dist/sessions/external-message.js

@@ -0,0 +1,104 @@
+export function createExternalMessageRunner(chat, options) {
+    return Object.freeze({
+        async admit(input) {
+            validate(input);
+            const prior = await existingAdmission(chat, input.sessionId, input.messageId);
+            if (prior)
+                return prior;
+            let session;
+            let execution;
+            if (input.startsSession) {
+                const resolved = await options.resolveNew(input);
+                execution = await chat.prepareExecution(`external:${input.origin}:${input.sessionId}`, resolved.execution);
+                try {
+                    session = await chat.startSession({
+                        sessionId: input.sessionId,
+                        execution,
+                        title: resolved.title ?? input.title,
+                        origin: input.origin,
+                        originId: input.threadId,
+                        metadata: {
+                            ...(resolved.metadata ?? {}),
+                            externalThreadId: input.threadId,
+                            externalOrigin: input.origin,
+                        },
+                    });
+                }
+                catch (error) {
+                    if (!hasCode(error, 'SESSION_ALREADY_EXISTS'))
+                        throw error;
+                    session = await chat.resumeSession({ sessionId: input.sessionId, execution });
+                }
+            }
+            else {
+                try {
+                    const resumed = await chat.resumeStoredSession(input.sessionId);
+                    session = resumed.session;
+                    execution = resumed.execution;
+                }
+                catch (error) {
+                    if (!hasCode(error, 'SESSION_NOT_FOUND'))
+                        throw error;
+                    const record = await chat.inspectSession(input.sessionId);
+                    const resolved = await options.resolveExisting(record);
+                    execution = await chat.prepareExecution(`external:${input.origin}:${input.sessionId}`, resolved.execution);
+                    session = await chat.resumeSession({ sessionId: input.sessionId, execution });
+                }
+            }
+            const stream = await session.send({
+                execution,
+                clientTurnId: input.messageId,
+                userMessageId: input.messageId,
+                prompt: externalPrompt(input),
+            });
+            return Object.freeze({
+                sessionId: input.sessionId,
+                turnId: input.messageId,
+                completion: stream.completion,
+            });
+        },
+    });
+}
+async function existingAdmission(chat, sessionId, turnId) {
+    try {
+        const replay = await chat.replayTurn(sessionId, turnId);
+        const completion = replay.turn.status !== 'running' ? Promise.resolve() : (async () => {
+            for await (const _update of chat.reconnectTurn(sessionId, turnId)) { /* wait for seal */ }
+        })();
+        return Object.freeze({ sessionId, turnId, completion });
+    }
+    catch (error) {
+        if (hasCode(error, 'SESSION_NOT_FOUND'))
+            return null;
+        throw error;
+    }
+}
+function externalPrompt(input) {
+    return {
+        parts: [{
+                type: 'text',
+                text: [
+                    `The account owner sent this ${input.origin} message:`,
+                    '',
+                    input.message,
+                    '',
+                    `Your ordinary assistant response is not sent to the user. Work on the request, then call the Channels send tool with channel ${JSON.stringify(input.origin)} for each message you deliberately want to send back. Do not stream partial progress through Channels.`,
+                ].join('\n'),
+            }],
+    };
+}
+function validate(input) {
+    if (typeof input.startsSession !== 'boolean') {
+        throw new TypeError('startsSession must be a boolean');
+    }
+    for (const [name, value] of Object.entries(input)) {
+        if (name === 'startsSession')
+            continue;
+        if (typeof value !== 'string' || !value.trim())
+            throw new TypeError(`${name} must be a non-empty string`);
+    }
+}
+function hasCode(error, code) {
+    return Boolean(error && typeof error === 'object' && error.code === code);
+}
+//# sourceMappingURL=external-message.js.map

package/dist/sessions/external-message.js.map

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

package/dist/sessions/index.d.ts

@@ -1,3 +1,5 @@
 export type { ChatOptions, ChatRuntimePort, InterruptResult, ReconnectOptions, ResumeSessionOptions, ResumeStoredSessionResult, RuntimePromptRequest, RuntimeInterruptRequest, RuntimeResumeRequest, RuntimeStartRequest, SendOptions, StartSessionOptions, TurnReplay, } from './chat.js';
+export { createExternalMessageRunner } from './external-message.js';
+export type { ExternalMessageAdmission, ExternalMessageExecution, ExternalMessageInput, ExternalMessageRunner, } from './external-message.js';
 export { Chat, ChatTurnStream, ChatSession, InterruptUnsupportedError, SessionAgentMismatchError, SessionAlreadyExistsError, SessionBusyError, SessionNotFoundError, SubscriberBackpressureError, TurnStreamError, } from './chat.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,IAAI,EACJ,cAAc,EACd,WAAW,EACX,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AACpE,YAAY,EACV,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,IAAI,EACJ,cAAc,EACd,WAAW,EACX,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,WAAW,CAAC"}

package/dist/sessions/index.js

@@ -1,2 +1,3 @@
+export { createExternalMessageRunner } from './external-message.js';
 export { Chat, ChatTurnStream, ChatSession, InterruptUnsupportedError, SessionAgentMismatchError, SessionAlreadyExistsError, SessionBusyError, SessionNotFoundError, SubscriberBackpressureError, TurnStreamError, } from './chat.js';
 //# sourceMappingURL=index.js.map

package/dist/sessions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,IAAI,EACJ,cAAc,EACd,WAAW,EACX,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAOpE,OAAO,EACL,IAAI,EACJ,cAAc,EACd,WAAW,EACX,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,eAAe,GAChB,MAAM,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amalgm/chat",
-  "version": "0.2.7",
+  "version": "0.2.9-main.34175712248",
   "description": "A provider-agnostic agent chat SDK with ACP content, prepared execution, normalized streams, and usage.",
   "type": "module",
   "license": "UNLICENSED",
@@ -86,7 +86,12 @@
   },
   "scripts": {
     "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.json",
-    "test": "npm run build && node --test"
+    "test": "npm run build && node --test",
+    "release:admit": "node scripts/release/package.mjs admit",
+    "release:prepare": "node scripts/release/package.mjs prepare",
+    "release:examine": "node scripts/release/package.mjs examine",
+    "release:publish": "node scripts/release/package.mjs publish",
+    "test:release": "node --test scripts/release/*.test.mjs"
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "^1.4.0",
@@ -100,5 +105,24 @@
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "typescript": "^5.7.3"
+  },
+  "amalgmRelease": {
+    "schema": 1,
+    "workflow": "verify.yml",
+    "jobs": [
+      "verify"
+    ],
+    "verify": "test",
+    "cli": []
+  },
+  "allowScripts": {
+    "better-sqlite3@12.11.1": true
+  },
+  "gitHead": "42411e61e753e13bffdd3b0ca7628577691dd910",
+  "amalgmSource": {
+    "repository": "amalgm-inc/amalgm-chat",
+    "branch": "main",
+    "commit": "42411e61e753e13bffdd3b0ca7628577691dd910",
+    "occurrence": "34175712248"
   }
 }