@amalgm/chat 0.1.0

package/dist/wire/frames.js

@@ -0,0 +1,245 @@
+/**
+ * Wire projection — engine `chat-core/sse.js` (206 lines) ported byte-exact:
+ * amalgm events → the ACP-shaped `AgentStreamEvent` the browser consumes,
+ * SSE frame strings, frame id numbering, and the PromptUsage projection.
+ *
+ * Everything here is pure. The engine's `writeSseHeaders(res)` is the one
+ * host-side effect; its header set is exported as a constant and the
+ * res-writing helper takes a structural `writeHead` target so hosts can
+ * pass their own response object (no `node:http` import).
+ */
+import { toolKind as canonicalToolKind } from '../transcript/tool-shape.js';
+import { totalUsageTokens } from '../usage/tokens.js';
+/**
+ * Engine sse.js:6-41. Project any usage-ish record into PromptUsage.
+ * `totalTokens` obeys the token-total law (`usage.js:123-127`, ported at
+ * `src/usage/tokens.ts`): tokenList.total, else inputContextSize, else the
+ * sum of the four non-thought buckets.
+ */
+export function toPromptUsage(usage) {
+    if (!usage)
+        return undefined;
+    const totalTokens = totalUsageTokens(usage);
+    const tokenList = usage['tokenList'] || {
+        input: Number(usage['inputTokens'] || 0),
+        output: Number(usage['outputTokens'] || 0),
+        cacheRead: Number(usage['cacheReadTokens'] || 0),
+        cacheWrite: Number(usage['cacheWriteTokens'] || 0),
+        thought: Number(usage['thoughtTokens'] || 0),
+        total: totalTokens,
+    };
+    return {
+        tokenList,
+        cumulativeTokenList: usage['cumulativeTokenList'] ?? null,
+        previousCumulativeTokenList: usage['previousCumulativeTokenList'] ?? null,
+        inputTokens: Number(tokenList.input || 0),
+        outputTokens: Number(tokenList.output || 0),
+        cacheReadTokens: Number(tokenList.cacheRead || 0),
+        cacheWriteTokens: Number(tokenList.cacheWrite || 0),
+        thoughtTokens: Number(tokenList.thought || 0),
+        inputContextSize: usage['inputContextSize'] ?? tokenList.total ?? totalTokens,
+        totalTokens,
+        contextUsedTokens: usage['contextUsedTokens'] ?? usage['inputContextSize'] ?? tokenList.total ?? null,
+        contextLimit: usage['contextLimit'] ?? null,
+        usedTokens: usage['usedTokens'] ?? usage['contextUsedTokens'] ?? usage['inputContextSize'] ?? tokenList.total ?? null,
+        lastUsedTokens: usage['lastUsedTokens'] ?? usage['contextUsedTokens'] ?? usage['inputContextSize'] ?? tokenList.total ?? null,
+        maxTokens: usage['maxTokens'] ?? usage['contextLimit'] ?? null,
+        totalProcessedTokens: usage['totalProcessedTokens'] ?? null,
+        costUsd: usage['costUsd'] ?? null,
+        marketCostUsd: usage['marketCostUsd'] ?? null,
+        operation: usage['operation'],
+        billable: usage['billable'] !== false,
+        source: usage['source'],
+        exact: usage['exact'] === true,
+    };
+}
+/** Engine sse.js:43-46. Rounded context occupancy; non-positive → 0. */
+function usageContextUsed(usage) {
+    const parsed = Number(usage?.['inputContextSize'] ?? usage?.['tokenList']?.total ?? usage?.['contextUsedTokens'] ?? usage?.['usedTokens']);
+    return Number.isFinite(parsed) && parsed > 0 ? Math.round(parsed) : 0;
+}
+/** Engine sse.js:48-51. */
+function usageContextLimit(usage) {
+    const parsed = Number(usage?.['contextLimit'] ?? usage?.['maxTokens']);
+    return Number.isFinite(parsed) && parsed > 0 ? Math.round(parsed) : 0;
+}
+/** Engine sse.js:53-63. Legacy ACP-ish kind fallback layered over the canonical classifier. */
+function toolKind(name) {
+    const clean = String(name || '').toLowerCase();
+    const canonical = canonicalToolKind(name);
+    if (canonical && canonical !== 'unknown')
+        return canonical;
+    if (clean.includes('bash') || clean.includes('command'))
+        return 'execute';
+    if (clean.includes('read'))
+        return 'read';
+    if (clean.includes('edit') || clean.includes('write') || clean.includes('file'))
+        return 'edit';
+    if (clean.includes('grep') || clean.includes('glob') || clean.includes('search'))
+        return 'search';
+    if (clean.includes('fetch'))
+        return 'fetch';
+    return 'other';
+}
+/** Engine sse.js:65-181. The amalgm-event → AgentStreamEvent projection; unknown types become `session_info_update`. */
+export function toAgentStreamEvent(e, context = {}) {
+    if (e['type'] === 'text.delta') {
+        return { _type: 'update', eventTimestamp: e['ts'], sessionUpdate: 'agent_message_chunk', content: { type: 'text', text: e['text'] || '' } };
+    }
+    if (e['type'] === 'text.boundary') {
+        return { _type: 'update', eventTimestamp: e['ts'], sessionUpdate: 'agent_message_boundary', itemId: e['itemId'] || null, reason: e['reason'] || null };
+    }
+    if (e['type'] === 'reasoning.delta') {
+        return { _type: 'update', eventTimestamp: e['ts'], sessionUpdate: 'agent_thought_chunk', content: { type: 'text', text: e['text'] || '' } };
+    }
+    if (e['type'] === 'tool.started') {
+        return {
+            _type: 'update',
+            eventTimestamp: e['ts'],
+            sessionUpdate: 'tool_call',
+            toolCallId: e['toolCallId'],
+            toolName: e['toolName'] || e['name'],
+            title: e['title'] || e['toolName'],
+            kind: e['kind'] || toolKind(e['toolName']),
+            status: 'in_progress',
+            rawInput: e['input'] || {},
+            metadata: e['metadata'] || undefined,
+            timing: e['timing'] || undefined,
+        };
+    }
+    if (e['type'] === 'tool.updated') {
+        return {
+            _type: 'update',
+            eventTimestamp: e['ts'],
+            sessionUpdate: 'tool_call_update',
+            toolCallId: e['toolCallId'],
+            toolName: e['toolName'] || e['name'],
+            title: e['title'] || null,
+            kind: e['kind'] || null,
+            status: e['status'] || 'in_progress',
+            rawInput: e['inputDelta'] || undefined,
+            rawOutput: e['outputDelta'] ?? e['output'] ?? undefined,
+            error: e['error'] || undefined,
+            metadata: e['metadata'] || undefined,
+            timing: e['timing'] || undefined,
+        };
+    }
+    if (e['type'] === 'tool.completed') {
+        return {
+            _type: 'update',
+            eventTimestamp: e['ts'],
+            sessionUpdate: 'tool_call_update',
+            toolCallId: e['toolCallId'],
+            toolName: e['toolName'] || e['name'],
+            title: e['title'] || null,
+            kind: e['kind'] || null,
+            status: e['isError'] ? 'failed' : 'completed',
+            rawInput: e['input'] || undefined,
+            rawOutput: e['output'] ?? e['result'] ?? '',
+            error: e['error'] || undefined,
+            metadata: e['metadata'] || undefined,
+            timing: e['timing'] || undefined,
+        };
+    }
+    if (e['type'] === 'usage.final') {
+        const usage = toPromptUsage(e['usage']);
+        const contextUsed = usageContextUsed(e['usage']);
+        const contextLimit = usageContextLimit(e['usage']);
+        const fallbackTotal = usage?.totalTokens || 0;
+        return {
+            _type: 'update',
+            eventTimestamp: e['ts'],
+            sessionUpdate: 'usage_update',
+            used: contextUsed || fallbackTotal,
+            size: contextLimit || null,
+            inputContextSize: usage?.inputContextSize ?? undefined,
+            cost: usage?.costUsd != null ? { amount: usage.costUsd, currency: 'USD' } : null,
+            usage,
+        };
+    }
+    if (e['type'] === 'compaction.started') {
+        return {
+            _type: 'update',
+            eventTimestamp: e['ts'],
+            sessionUpdate: 'compaction_boundary',
+            phase: 'started',
+            trigger: e['trigger'] || 'auto',
+        };
+    }
+    if (e['type'] === 'compaction.finished') {
+        return {
+            _type: 'update',
+            eventTimestamp: e['ts'],
+            sessionUpdate: 'compaction_boundary',
+            phase: 'finished',
+            trigger: e['trigger'] || 'auto',
+            preTokens: e['preTokens'] ?? null,
+            postTokens: e['postTokens'] ?? null,
+            durationMs: e['durationMs'] ?? null,
+        };
+    }
+    if (e['type'] === 'warning') {
+        return {
+            _type: 'model_error',
+            error: e['message'] || 'Runtime warning',
+            requestedModel: e['requestedModel'] || '',
+            eventTimestamp: e['ts'],
+        };
+    }
+    if (e['type'] === 'error')
+        return { _type: 'error', message: e['message'] || 'Unknown error', eventTimestamp: e['ts'] };
+    if (e['type'] === 'done') {
+        return {
+            _type: 'complete',
+            codeSessionId: context.sessionId,
+            providerSessionId: e['providerSessionId'] || context.providerSessionId || null,
+            stopReason: e['stopReason'] || 'end_turn',
+            usage: toPromptUsage(context.usage || e['usage']),
+            eventTimestamp: e['ts'],
+        };
+    }
+    return { _type: 'update', eventTimestamp: e['ts'], sessionUpdate: 'session_info_update' };
+}
+/** Engine sse.js:183-185. One SSE data frame: `data: <json>\n\n`. */
+export function frameFor(e, context) {
+    return `data: ${JSON.stringify(toAgentStreamEvent(e, context))}\n\n`;
+}
+/** Engine sse.js:187-189. */
+export function titleFrame({ sessionId, title }) {
+    return `data: ${JSON.stringify({ _type: 'title_generated', sessionId, title })}\n\n`;
+}
+/**
+ * Engine sse.js:191-196. Frame id numbering law: prepend `id: <n>\n` only
+ * for non-negative integers (Number-coerced), and never double-stamp a
+ * frame that already starts with `id:`.
+ */
+export function withSseId(frame, id) {
+    const cleanId = Number(id);
+    if (!Number.isInteger(cleanId) || cleanId < 0)
+        return frame;
+    if (String(frame || '').startsWith('id:'))
+        return frame;
+    return `id: ${cleanId}\n${frame}`;
+}
+/** Engine sse.js:199-203 status code. */
+export const SSE_STATUS_CODE = 200;
+/** Engine sse.js:199-203 header set, exported for hosts that write headers themselves. */
+export const SSE_HEADERS = Object.freeze({
+    'Content-Type': 'text/event-stream',
+    'Cache-Control': 'no-cache, no-transform',
+    Connection: 'keep-alive',
+});
+/**
+ * Engine sse.js:198-204. HOST-SIDE EFFECT: writes the SSE status + headers
+ * to the supplied response object. Pure with respect to imports — the
+ * response is injected; hosts on non-Node stacks should use
+ * {@link SSE_HEADERS} / {@link SSE_STATUS_CODE} directly.
+ */
+export function writeSseHeaders(res) {
+    res.writeHead(SSE_STATUS_CODE, {
+        'Content-Type': 'text/event-stream',
+        'Cache-Control': 'no-cache, no-transform',
+        Connection: 'keep-alive',
+    });
+}
+//# sourceMappingURL=frames.js.map

package/dist/wire/frames.js.map

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

package/dist/wire/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * `@amalgm/chat/wire` — the SSE wire projection (engine `chat-core/sse.js`):
+ * amalgm events → ACP-shaped AgentStreamEvent frames, frame id numbering,
+ * PromptUsage projection, and the SSE header contract.
+ */
+export { toAgentStreamEvent, toPromptUsage, frameFor, titleFrame, withSseId, writeSseHeaders, SSE_HEADERS, SSE_STATUS_CODE, type AmalgmEventLike, type StreamContext, type PromptUsage, type PromptTokenList, type AgentStreamEvent, type AgentMessageChunkFrame, type AgentMessageBoundaryFrame, type AgentThoughtChunkFrame, type ToolCallFrame, type ToolCallUpdateFrame, type UsageUpdateFrame, type CompactionStartedFrame, type CompactionFinishedFrame, type SessionInfoUpdateFrame, type ModelErrorFrame, type ErrorFrame, type CompleteFrame, type TitleGeneratedFrame, type SseHeadTarget, } from './frames.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wire/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,QAAQ,EACR,UAAU,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC"}

package/dist/wire/index.js

@@ -0,0 +1,7 @@
+/**
+ * `@amalgm/chat/wire` — the SSE wire projection (engine `chat-core/sse.js`):
+ * amalgm events → ACP-shaped AgentStreamEvent frames, frame id numbering,
+ * PromptUsage projection, and the SSE header contract.
+ */
+export { toAgentStreamEvent, toPromptUsage, frameFor, titleFrame, withSseId, writeSseHeaders, SSE_HEADERS, SSE_STATUS_CODE, } from './frames.js';
+//# sourceMappingURL=index.js.map

package/dist/wire/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wire/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,kBAAkB,EAClB,aAAa,EACb,QAAQ,EACR,UAAU,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,eAAe,GAoBhB,MAAM,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@amalgm/chat",
+  "version": "0.1.0",
+  "description": "The Amalgm chat SDK — the conversation pipeline's laws: turns, messages, streaming assembly, event normalization, and transcript truth, behind host-injected adapters.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/amalgm-inc/amalgm-chat.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./events": {
+      "types": "./dist/events/index.d.ts",
+      "default": "./dist/events/index.js"
+    },
+    "./wire": {
+      "types": "./dist/wire/index.d.ts",
+      "default": "./dist/wire/index.js"
+    },
+    "./transcript": {
+      "types": "./dist/transcript/index.d.ts",
+      "default": "./dist/transcript/index.js"
+    },
+    "./turns": {
+      "types": "./dist/turns/index.d.ts",
+      "default": "./dist/turns/index.js"
+    },
+    "./contract": {
+      "types": "./dist/contract/index.d.ts",
+      "default": "./dist/contract/index.js"
+    },
+    "./warm": {
+      "types": "./dist/warm/index.d.ts",
+      "default": "./dist/warm/index.js"
+    },
+    "./usage": {
+      "types": "./dist/usage/index.d.ts",
+      "default": "./dist/usage/index.js"
+    },
+    "./normalizers": {
+      "types": "./dist/normalizers/index.d.ts",
+      "default": "./dist/normalizers/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "PURPOSE.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "npm run build && node --test tests/",
+    "test:parity": "npm run build && node --test tests/parity/"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.206",
+    "@opencode-ai/sdk": "^1.17.6",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.3"
+  }
+}