@amalgm/chat 0.2.6 → 0.2.8

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
 

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/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/host/adapters/prompt.js

@@ -81,6 +81,9 @@ export function codexPromptInput(prompt) {
     }
     if (part.type === 'resource') {
       const mime = mimeOf(part);
+      if (typeof part.resource.text === 'string') {
+        return [{ type: 'text', text: embeddedText(part) }];
+      }
       if (mime.startsWith('image/')) {
         return [{ type: 'image', url: dataUrl(mime, part.resource.blob) }];
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amalgm/chat",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "A provider-agnostic agent chat SDK with ACP content, prepared execution, normalized streams, and usage.",
   "type": "module",
   "license": "UNLICENSED",