@amalgm/chat 0.1.1 → 0.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@amalgm/chat",
-  "version": "0.1.1",
-  "description": "The Amalgm chat SDK — the conversation pipeline's laws: turns, messages, streaming assembly, event normalization, and transcript truth, behind host-injected adapters.",
+  "version": "0.2.0",
+  "description": "A provider-agnostic agent chat SDK with ACP content, prepared execution, normalized streams, and usage.",
   "type": "module",
   "license": "UNLICENSED",
   "repository": {
@@ -20,26 +20,10 @@
       "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"
@@ -51,26 +35,66 @@
     "./api": {
       "types": "./dist/api/index.d.ts",
       "default": "./dist/api/index.js"
+    },
+    "./acp": {
+      "types": "./dist/acp/index.d.ts",
+      "default": "./dist/acp/index.js"
+    },
+    "./input": {
+      "types": "./dist/input/index.d.ts",
+      "default": "./dist/input/index.js"
+    },
+    "./execution": {
+      "types": "./dist/execution/index.d.ts",
+      "default": "./dist/execution/index.js"
+    },
+    "./sessions": {
+      "types": "./dist/sessions/index.d.ts",
+      "default": "./dist/sessions/index.js"
+    },
+    "./conversations": {
+      "types": "./dist/conversations/index.d.ts",
+      "default": "./dist/conversations/index.js"
+    },
+    "./sqlite": {
+      "types": "./host/sqlite/index.d.ts",
+      "default": "./host/sqlite/index.js"
+    },
+    "./host": {
+      "types": "./host/index.d.ts",
+      "default": "./host/index.js"
     }
   },
   "files": [
     "dist",
-    "PURPOSE.md"
+    "AGENTS.md",
+    "PURPOSE.md",
+    "docs/contracts/acp-and-step-usage.md",
+    "docs/contracts/input-and-execution.md",
+    "docs/contracts/conversation-persistence.md",
+    "docs/contracts/platform-authorization.md",
+    "host",
+    "skills"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "node scripts/clean-dist.mjs && tsc -p tsconfig.json",
     "test": "npm run build && node --test tests/",
     "test:parity": "npm run build && node --test tests/parity/"
   },
   "dependencies": {
+    "@agentclientprotocol/sdk": "^1.4.0",
     "@anthropic-ai/claude-agent-sdk": "^0.3.206",
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "@openai/codex": "0.150.0",
     "@opencode-ai/sdk": "^1.17.6",
+    "better-sqlite3": "^12.11.1",
     "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "typescript": "^5.7.3"
   }
 }

package/skills/chat/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: chat
+description: Build and verify provider-agnostic agent chat with the Amalgm Chat SDK. Use for chat interfaces, ACP prompt and update shapes, prepared execution, SQLite conversations, durable streams, Claude Code, Codex, Cursor, OpenCode, Pi, MCP tools, permissions, model-step usage, reconnect, or adapter conformance.
+---
+
+# Build with Amalgm Chat
+
+Keep application code on the public SDK. Keep native behavior in host adapters.
+
+## Establish the contract
+
+Read [references/contracts.md](references/contracts.md) before changing input,
+execution preparation, sessions, adapters, or usage. In a source checkout, also
+read the repository `AGENTS.md`; it contains current architecture and known gaps.
+
+Use these package doors:
+
+- `@amalgm/chat` or `/sessions` for `Chat`, start, resume, and send;
+- `/input` for ordered ACP prompt content;
+- `/execution` for prepared execution contracts and handles;
+- `/acp` for official ACP types and session updates;
+- `/usage` for model-step usage and turn aggregation.
+- `/conversations` for owner-scoped records and UI projections;
+- `/sqlite` for the WAL-backed reference conversation store.
+
+Do not copy ACP types into application code.
+
+## Follow the user path
+
+1. Prepare while the user composes. Resolve the exact agent revision, provider-
+   scoped model, model settings, auth binding, tool revision, cwd, permission
+   mode, and computer.
+2. Start or resume with the returned `{ id, revision }` handle.
+3. Send an ordered ACP prompt with that handle.
+4. Render official ACP updates without provider branches.
+5. Treat `send()` as one background runtime pump and its returned iterable as
+   a subscriber. Reconnect by turn id and committed sequence.
+
+Never fetch models, credentials, tools, preferences, agent configuration, or a
+workspace because the user pressed Enter. A missing or stale prepared revision
+must fail explicitly.
+
+## Preserve semantics
+
+- Pass text and attachments as ACP content blocks. Never flatten or discard an
+  attachment. Translate it natively or return a typed unsupported-capability
+  result.
+- Treat model identity as `(agent revision, provider, model)`.
+- Treat auth and computer as per-turn selections. Never silently fall back to a
+  different auth mode.
+- Expose ordinary tools and MCP tools through one MCP-shaped capability model.
+  The resolved selection is complete; never add an ambient MCP server.
+- Use the five native adapters for Claude Code, Codex, Cursor, OpenCode, and Pi.
+  Register every other compliant agent through the generic `acp` adapter and
+  an immutable launch descriptor; do not add product-name branches for Amp,
+  Gemini CLI, Kiro, or later ACP agents.
+- Require every adapter to apply an input exactly or throw a typed unsupported
+  error before prompting. Capability negotiation is validation, not fallback.
+- Render `agent_message_chunk`, `agent_thought_chunk`, `tool_call`, and
+  `tool_call_update`. Use ACP tool states.
+- Use `@amalgm/stream` for rendering only; it is not the durable journal.
+- Persist accepted input before provider invocation. Commit every update before
+  fanout, seal terminal state once, and recover uncertain running turns as
+  interrupted after restart.
+- Use bounded SQLite batches for content deltas. Tool, terminal, permission,
+  warning, and other control updates flush immediately.
+- Never sync a live SQLite file. Live synchronizes logical conversation rows,
+  sealed turns, update batches, messages, and provider checkpoints.
+
+## Normalize usage honestly
+
+Create one finalized usage record per provider model invocation. Keep input,
+output, cache-read, and cache-write tokens nullable. Derive turn usage from its
+steps. Preserve the raw provider record. Never use ACP context fullness as a
+billing ledger or turn missing values into zero.
+
+## Verify through real sessions
+
+Test laws with fixtures, then start a real session through `Chat`; do not stop at
+calling an adapter helper. For every claimed adapter, verify start/resume, text
+and supported attachments, tools, permissions, normalized updates, terminal
+state, and usage. Record unsupported capabilities literally.
+
+Use the adapter capability matrix and generic ACP launch shape in
+[references/contracts.md](references/contracts.md). A generic ACP conformance
+run does not prove that every named ACP product is installed or authenticated;
+record each product acceptance separately.
+
+Run:
+
+```bash
+npm test
+npm pack --dry-run
+```
+
+Do not claim parity from one successful provider. Record current limitations in
+`PURPOSE.md` or the owning contract document.

package/skills/chat/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Amalgm Chat"
+  short_description: "Build one chat UI for every coding agent"
+  default_prompt: "Use $chat to build and verify a provider-agnostic chat flow with prepared execution and ACP shapes."

package/skills/chat/references/contracts.md

@@ -0,0 +1,131 @@
+# Chat SDK contract
+
+Load this reference when building a chat surface or changing a provider adapter.
+
+## Prompt
+
+```ts
+type PromptInput = {
+  parts: ContentBlock[]; // official ACP ContentBlock
+};
+```
+
+The list is non-empty and ordered. Attachments are ACP `image`, `audio`,
+`resource`, or `resource_link` blocks. The host must prepare bytes or references
+before send.
+
+## Prepared execution
+
+```ts
+type ExecutionContract = {
+  agent: { adapterId: string; installationId: string; revisionId: string };
+  model: {
+    providerId: string;
+    modelId: string;
+    settings: SetSessionConfigOptionRequest[];
+  };
+  auth: { mode: "platform" | "subscription" | "byok"; bindingId: string };
+  tools: { revisionId: string | null; toolIds: string[] };
+  cwd: {
+    path: string;
+    workspaceId: string | null;
+    materializationRevision: string | null;
+  };
+  permissionMode: "ask" | "full_access";
+  computerId: string;
+};
+```
+
+Preparation resolves this to an opaque host binding and returns an
+`ExecutionHandle` containing only `id` and `revision`. Any changed field creates
+a new revision. Start and send consume a prepared handle; they never prepare.
+
+## Session path
+
+```ts
+const execution = await chat.prepareExecution("composer", contract);
+const session = await chat.startSession({ execution });
+
+for await (const update of await session.send({
+  execution,
+  prompt: { parts: [{ type: "text", text: "Hello" }] },
+})) {
+  render(update);
+}
+```
+
+Construct `Chat` with the authenticated `ownerUserId`, a
+`ConversationStorePort`, and a host clock. Production hosts should use
+`SqliteConversationStore` from `@amalgm/chat/sqlite` plus
+`createSqliteJournalBatchPolicy()`.
+
+`send()` begins one background provider pump after the input transaction
+commits. Iterating its result subscribes to the durable turn; it does not own
+provider execution. Reconnect with `session.reconnect(turnId, {
+afterSequence })`. Every yielded update carries
+`_meta.amalgm.{conversationId,turnId,sequence}`.
+
+On startup call `chat.recoverInterruptedTurns()` before admitting new work.
+Committed updates remain replayable. Running turns become `interrupted` unless
+an adapter later supplies a proven reattachment path.
+
+Use `chat.resumeSession({ sessionId, execution })` for an existing conversation.
+The conversation identity survives an explicit auth or computer change between
+turns. The adapter may need a different native provider session.
+
+## Adapter admission and exact inputs
+
+The adapter ids are `claude_code`, `codex`, `cursor`, `opencode`, `pi`, and
+`acp`. The first five are native adapters. The final path admits any
+compliant ACP agent from its resolved immutable revision:
+
+```ts
+acpLaunch: {
+  command: string;
+  args: string[];
+  supportedAuthModes: AuthMode[];
+  env?: Record<string, string>;
+  auth?: {
+    platform?: { tokenEnv: string; baseUrlEnv?: string };
+    byok?: { tokenEnv: string; baseUrlEnv?: string };
+  };
+  authMethodIds?: Partial<Record<AuthMode, string>>;
+  modelConfiguredAtLaunch?: boolean;
+}
+```
+
+| Adapter | Auth | Settings |
+| --- | --- | --- |
+| Claude Code | platform, subscription, BYOK | reasoning, speed |
+| Codex | platform, subscription, BYOK | reasoning, speed |
+| Cursor | subscription, BYOK Cursor API key | advertised model's exact reasoning/speed parameters |
+| OpenCode | platform, subscription, BYOK | exact model-catalog `variant` |
+| Pi | platform, subscription, BYOK | reasoning only |
+| ACP | revision-declared modes | negotiated ACP config options |
+
+Every path takes the complete selected tool set (no ambient MCP server), an
+absolute prepared cwd, `ask` or `full_access`,
+an immutable agent revision, a provider-scoped model, and an execution
+computer. Optional prompt/MCP/config capabilities are negotiated for ACP.
+Anything that cannot be applied throws `UNSUPPORTED_EXECUTION_INPUT` or
+`UNSUPPORTED_PROMPT_PART`; no selected input disappears.
+
+## Output
+
+ACP is the public update grammar:
+
+- `agent_message_chunk`: text;
+- `agent_thought_chunk`: reasoning;
+- `tool_call`: tool identity, input, and initial state;
+- `tool_call_update`: input/result deltas and state;
+- ACP permission requests and stop reasons.
+
+Amalgm extensions retain durable ids/cursors, raw events, ownership, and richer
+usage without changing the ACP meaning.
+
+## Usage
+
+One turn can contain many model steps. Each step reports nullable
+`inputTokens`, `outputTokens`, `cacheReadTokens`, and `cacheWriteTokens`, plus
+source, exactness, model identity, and raw evidence. Aggregate the turn from
+steps only. A bucket remains `null` when any contributing step is unknown.

package/dist/api/chat-payloads.d.ts

@@ -1,10 +0,0 @@
-/**
- * Fetch API adapter for engine
- * `runtime/scripts/amalgm-mcp/server/routes/chat-payloads.js`.
- * Route matching and response shapes are byte-for-byte laws; persistence and
- * clocks are already behind `ChatPayloadStore` ports.
- */
-import type { ChatPayloadStore } from '../warm/store.js';
-export type ChatPayloadApi = (request: Request) => Promise<Response>;
-export declare function createChatPayloadApi(store: ChatPayloadStore): ChatPayloadApi;
-//# sourceMappingURL=chat-payloads.d.ts.map

package/dist/api/chat-payloads.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chat-payloads.d.ts","sourceRoot":"","sources":["../../src/api/chat-payloads.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAErE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,GAAG,cAAc,CAoC5E"}

package/dist/api/chat-payloads.js

@@ -1,57 +0,0 @@
-/**
- * Fetch API adapter for engine
- * `runtime/scripts/amalgm-mcp/server/routes/chat-payloads.js`.
- * Route matching and response shapes are byte-for-byte laws; persistence and
- * clocks are already behind `ChatPayloadStore` ports.
- */
-export function createChatPayloadApi(store) {
-    return async (request) => {
-        try {
-            const url = new URL(request.url);
-            const method = request.method.toUpperCase();
-            if (url.pathname === '/chat-payloads' && method === 'GET') {
-                const id = url.searchParams.get('id');
-                const payload = id ? store.get(id) : null;
-                return json(payload ? 200 : (id ? 404 : 200), {
-                    ...(id && payload ? { payload } : {}),
-                    payloads: store.list(),
-                    ...(id && !payload ? { error: 'Chat payload not found' } : {}),
-                });
-            }
-            if (url.pathname === '/chat-payloads/get' && method === 'POST') {
-                const body = await jsonBody(request);
-                const payload = store.get(value(body, 'id') || value(body, 'payloadId'));
-                if (!payload)
-                    return json(404, { error: 'Chat payload not found' });
-                return json(200, { payload });
-            }
-            if (url.pathname === '/chat-payloads' && (method === 'PUT' || method === 'POST')) {
-                const payload = store.write(await jsonBody(request));
-                return json(200, { success: true, payload });
-            }
-            return new Response('Not found', {
-                status: 404,
-                headers: { 'content-type': 'text/plain' },
-            });
-        }
-        catch {
-            return json(500, { error: 'Internal server error' });
-        }
-    };
-}
-async function jsonBody(request) {
-    const raw = await request.text();
-    return raw ? JSON.parse(raw) : {};
-}
-function value(input, key) {
-    return input && typeof input === 'object' && !Array.isArray(input)
-        ? input[key]
-        : undefined;
-}
-function json(status, body) {
-    return new Response(JSON.stringify(body), {
-        status,
-        headers: { 'content-type': 'application/json' },
-    });
-}
-//# sourceMappingURL=chat-payloads.js.map

package/dist/api/chat-payloads.js.map

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

package/dist/contract/chat-input.d.ts

@@ -1,144 +0,0 @@
-/**
- * Structured chat input — engine `runtime/lib/chatInput.js` (311 lines),
- * ported byte-exact. Both sides run zod ^4.4.3, so the schemas carry over
- * verbatim (`.passthrough()`, `.default()` semantics identical).
- */
-import { z } from 'zod';
-export declare const ChatInputPartSchema: z.ZodUnion<readonly [z.ZodObject<{
-    type: z.ZodLiteral<"text">;
-    text: z.ZodDefault<z.ZodString>;
-}, z.core.$loose>, z.ZodObject<{
-    type: z.ZodLiteral<"file">;
-    filename: z.ZodOptional<z.ZodString>;
-    mediaType: z.ZodOptional<z.ZodString>;
-    url: z.ZodOptional<z.ZodString>;
-    storagePath: z.ZodOptional<z.ZodString>;
-    storage_path: z.ZodOptional<z.ZodString>;
-    computerPath: z.ZodOptional<z.ZodString>;
-    sandboxPath: z.ZodOptional<z.ZodString>;
-    assetId: z.ZodOptional<z.ZodString>;
-}, z.core.$loose>, z.ZodObject<{
-    type: z.ZodString;
-}, z.core.$loose>]>;
-export declare const WorkspaceTargetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    kind: z.ZodLiteral<"cwd">;
-    cwd: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"existing-worktree">;
-    path: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"managed-worktree">;
-    repoPath: z.ZodString;
-    branch: z.ZodString;
-    baseBranch: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>], "kind">;
-export declare const ChatInputSchema: z.ZodObject<{
-    parts: z.ZodDefault<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-        type: z.ZodLiteral<"text">;
-        text: z.ZodDefault<z.ZodString>;
-    }, z.core.$loose>, z.ZodObject<{
-        type: z.ZodLiteral<"file">;
-        filename: z.ZodOptional<z.ZodString>;
-        mediaType: z.ZodOptional<z.ZodString>;
-        url: z.ZodOptional<z.ZodString>;
-        storagePath: z.ZodOptional<z.ZodString>;
-        storage_path: z.ZodOptional<z.ZodString>;
-        computerPath: z.ZodOptional<z.ZodString>;
-        sandboxPath: z.ZodOptional<z.ZodString>;
-        assetId: z.ZodOptional<z.ZodString>;
-    }, z.core.$loose>, z.ZodObject<{
-        type: z.ZodString;
-    }, z.core.$loose>]>>>;
-    agent: z.ZodDefault<z.ZodObject<{
-        harness: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        authMethod: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-            amalgm: "amalgm";
-            byok: "byok";
-            provider_auth: "provider_auth";
-        }>>>;
-        customAgentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        systemPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>>;
-    tools: z.ZodDefault<z.ZodObject<{
-        mcpAppIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        toolIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-    execution: z.ZodDefault<z.ZodObject<{
-        cwd: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        computerId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        workspace: z.ZodOptional<z.ZodNullable<z.ZodDiscriminatedUnion<[z.ZodObject<{
-            kind: z.ZodLiteral<"cwd">;
-            cwd: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
-            kind: z.ZodLiteral<"existing-worktree">;
-            path: z.ZodString;
-        }, z.core.$strip>, z.ZodObject<{
-            kind: z.ZodLiteral<"managed-worktree">;
-            repoPath: z.ZodString;
-            branch: z.ZodString;
-            baseBranch: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            path: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>], "kind">>>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type ChatInputPart = z.infer<typeof ChatInputPartSchema>;
-export type WorkspaceTarget = z.infer<typeof WorkspaceTargetSchema>;
-export type ChatInput = z.infer<typeof ChatInputSchema>;
-/** The legacy flat fields `normalizeChatInput` accepts as fallbacks. */
-export interface ChatInputLegacyFallback {
-    prompt?: unknown;
-    userParts?: unknown;
-    harness?: unknown;
-    modelId?: unknown;
-    model?: unknown;
-    authMethod?: unknown;
-    cwd?: unknown;
-    projectPath?: unknown;
-    computerId?: unknown;
-    mcpAppIds?: unknown;
-    toolIds?: unknown;
-    systemPrompt?: unknown;
-    [key: string]: unknown;
-}
-/** Engine `chatInput.js uniqueStrings`: trimmed, deduped string list. */
-export declare function uniqueStrings(values: unknown): string[];
-/** Engine `getWorkspaceCwd`: the folder a workspace target points at, if any. */
-export declare function getWorkspaceCwd(workspace: unknown): string | null;
-/** Engine `normalizeChatPart` — pass-through normalization for one part. */
-export declare function normalizeChatPart(part: unknown): Record<string, any> | null;
-/** Engine `normalizeChatParts` — normalized parts, else a text part from the prompt. */
-export declare function normalizeChatParts(parts: unknown, fallbackPrompt: unknown): Record<string, any>[];
-/** Engine `getChatInputText` — joined text of all text parts. */
-export declare function getChatInputText(chatInput: unknown, fallbackPrompt?: unknown): string;
-/** Engine `getAttachedFilePaths` — local paths of attached file parts. */
-export declare function getAttachedFilePaths(parts: unknown): string[];
-/** Engine `buildPromptFromParts` — flat prompt text incl. attached-file prefix. */
-export declare function buildPromptFromParts(parts: unknown, fallbackPrompt: unknown): string;
-/**
- * Engine `normalizeChatInput(chatInput, legacy)` — the canonical structured
- * input, merging the structured object with legacy flat fields.
- */
-export declare function normalizeChatInput(chatInput: unknown, legacy?: ChatInputLegacyFallback): ChatInput;
-export interface ChatInputLegacyFields {
-    prompt: string;
-    userParts: ChatInput['parts'];
-    harness: string | null;
-    modelId: string | null;
-    model: string | null;
-    authMethod: string | null;
-    cwd: string | null;
-    projectPath: string | null;
-    computerId: string | null;
-    mcpAppIds: string[];
-    systemPrompt: string | null;
-}
-/**
- * Engine `chatInputToLegacyFields` — project the structured input back onto
- * the flat legacy body fields (the shape `applyPayloadRecord` spreads).
- */
-export declare function chatInputToLegacyFields(chatInput: unknown, fallback?: ChatInputLegacyFallback): ChatInputLegacyFields;
-/** Engine `withChatInputText` — rewrite every text part through `updater`. */
-export declare function withChatInputText(chatInput: unknown, updater: (text: string, part: ChatInputPart) => string, legacy?: ChatInputLegacyFallback): ChatInput;
-//# sourceMappingURL=chat-input.d.ts.map

package/dist/contract/chat-input.d.ts.map

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