@amalgm/core 0.1.0 → 0.1.2

package/PURPOSE.md

@@ -72,6 +72,16 @@ source until each module is cut over.
 10. **Amalgm's own surfaces use this SDK.** A private shortcut in the CLI,
     gateway, or runtime means the SDK is incomplete — fix the SDK, not the
     caller.
+11. **The local rail is ordered truth, not durable history.** Every published
+    state event receives one monotonic sequence, reconnects replay only a
+    bounded retained tail, and a missing tail requires a fresh snapshot.
+12. **A snapshot names its resume point.** Resource readers share one
+    per-attempt context and a snapshot is stable only when its sequence is
+    unchanged across the read; a racing write causes a complete retry.
+13. **Credential discovery reports evidence, never credentials.** Local
+    harness discovery may expose auth type and a bounded hint, but secret
+    values cross only an explicit authenticated resolution call and never
+    enter discovery, logs, or state snapshots.
 
 ## Five surfaces, one behavior
 

package/dist/identity/index.d.ts

@@ -9,6 +9,7 @@ export * from './ports.js';
 export * from './labels.js';
 export * from './layout.js';
 export * from './product-state.js';
+export * from './local/index.js';
 export * from './ids.js';
 export * from './auth-records.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC"}

package/dist/identity/index.js

@@ -9,6 +9,7 @@ export * from './ports.js';
 export * from './labels.js';
 export * from './layout.js';
 export * from './product-state.js';
+export * from './local/index.js';
 export * from './ids.js';
 export * from './auth-records.js';
 //# sourceMappingURL=index.js.map

package/dist/identity/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/identity/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC"}

package/dist/identity/local/api.d.ts

@@ -0,0 +1,6 @@
+import type { LocalDiscoveryHost, LocalEnvironmentHost } from './types.js';
+export declare function createLocalApi(options: {
+    readonly discovery: LocalDiscoveryHost;
+    readonly environment: LocalEnvironmentHost;
+}): (request: Request) => Promise<Response>;
+//# sourceMappingURL=api.d.ts.map

package/dist/identity/local/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/identity/local/api.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3E,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACtC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;CAC5C,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAmC1C"}

package/dist/identity/local/api.js

@@ -0,0 +1,40 @@
+import { discoverLocalHarnesses } from './discovery.js';
+import { resolveLocalAgentEnv } from './resolve.js';
+export function createLocalApi(options) {
+    return async (request) => {
+        const url = new URL(request.url);
+        if (request.method === 'GET' && (url.pathname === '/local' || url.pathname === '/local/credentials')) {
+            return json(200, {
+                agents: discoverLocalHarnesses(options.discovery),
+                homedir: options.environment.homedir,
+                workspaceRoot: options.environment.workspaceRoot,
+            });
+        }
+        if (request.method === 'POST' && url.pathname === '/local/init') {
+            const initialized = options.environment.ensure();
+            return json(200, {
+                ok: true,
+                created: initialized.created,
+                amalgmPath: initialized.path,
+                homedir: options.environment.homedir,
+                workspaceRoot: options.environment.workspaceRoot,
+                agents: discoverLocalHarnesses(options.discovery),
+            });
+        }
+        if (request.method === 'POST' && url.pathname === '/local/credentials/resolve') {
+            const body = await request.json();
+            if (typeof body.agentId !== 'string' || typeof body.authMode !== 'string') {
+                return json(400, { error: 'agentId and authMode are required' });
+            }
+            return json(200, { env: resolveLocalAgentEnv(body.agentId, body.authMode, typeof body.proxyToken === 'string' ? body.proxyToken : undefined, typeof body.proxyBaseUrl === 'string' ? body.proxyBaseUrl : undefined) });
+        }
+        return json(404, { error: 'not found' });
+    };
+}
+function json(status, body) {
+    return new Response(JSON.stringify(body), {
+        status,
+        headers: { 'content-type': 'application/json', 'cache-control': 'no-store' },
+    });
+}
+//# sourceMappingURL=api.js.map

package/dist/identity/local/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/identity/local/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD,MAAM,UAAU,cAAc,CAAC,OAG9B;IACC,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE;QACvB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,oBAAoB,CAAC,EAAE,CAAC;YACrG,OAAO,IAAI,CAAC,GAAG,EAAE;gBACf,MAAM,EAAE,sBAAsB,CAAC,OAAO,CAAC,SAAS,CAAC;gBACjD,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,OAAO;gBACpC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,aAAa;aACjD,CAAC,CAAC;QACL,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;YAChE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC,GAAG,EAAE;gBACf,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,UAAU,EAAE,WAAW,CAAC,IAAI;gBAC5B,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,OAAO;gBACpC,aAAa,EAAE,OAAO,CAAC,WAAW,CAAC,aAAa;gBAChD,MAAM,EAAE,sBAAsB,CAAC,OAAO,CAAC,SAAS,CAAC;aAClD,CAAC,CAAC;QACL,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC,QAAQ,KAAK,4BAA4B,EAAE,CAAC;YAC/E,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAA6B,CAAC;YAC7D,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC1E,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC,CAAC;YACnE,CAAC;YACD,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,oBAAoB,CAC1C,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,QAAQ,EACb,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,EACjE,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CACtE,EAAE,CAAC,CAAC;QACP,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,MAAc,EAAE,IAAa;IACzC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;QACxC,MAAM;QACN,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,UAAU,EAAE;KAC7E,CAAC,CAAC;AACL,CAAC"}

package/dist/identity/local/discovery.d.ts

@@ -0,0 +1,4 @@
+import type { LocalDiscoveryHost, LocalHarness } from './types.js';
+/** Engine reference: runtime/lib/local/credentialResolver.ts. */
+export declare function discoverLocalHarnesses(host: LocalDiscoveryHost): LocalHarness[];
+//# sourceMappingURL=discovery.d.ts.map

package/dist/identity/local/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/identity/local/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEpF,iEAAiE;AACjE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,kBAAkB,GAAG,YAAY,EAAE,CAwE/E"}

package/dist/identity/local/discovery.js

@@ -0,0 +1,74 @@
+/** Engine reference: runtime/lib/local/credentialResolver.ts. */
+export function discoverLocalHarnesses(host) {
+    const found = [];
+    const path = (...parts) => host.join(host.homedir, ...parts);
+    const claudeDir = path('.claude');
+    if (host.exists(claudeDir)) {
+        found.push(harness('claude_code', 'Claude Code', claudeDir, host.authStatus('claude_code')));
+    }
+    const codexDir = path('.codex');
+    const codexAuth = host.readJson(path('.codex', 'auth.json'));
+    if (codexAuth) {
+        const tokens = codexAuth.tokens;
+        const apiKey = typeof codexAuth.OPENAI_API_KEY === 'string' ? codexAuth.OPENAI_API_KEY : '';
+        const status = tokens && typeof tokens === 'object'
+            ? { hasAuth: true, authDetails: { type: 'oauth', hint: clean(codexAuth.auth_mode) || 'configured' } }
+            : apiKey
+                ? { hasAuth: true, authDetails: { type: 'api_key', hint: apiKey.slice(-4) } }
+                : { hasAuth: false };
+        found.push(harness('codex', 'Codex', codexDir, status));
+    }
+    const openCodeDir = path('.config', 'opencode');
+    const openCodeAuth = path('.local', 'share', 'opencode', 'auth.json');
+    if (host.exists(openCodeDir) || host.exists(openCodeAuth)) {
+        found.push(harness('opencode', 'OpenCode', openCodeDir, host.nonEmptyFile(openCodeAuth)
+            ? { hasAuth: true, authDetails: { type: 'oauth', hint: 'configured' } }
+            : { hasAuth: false }));
+    }
+    const piDir = path('.pi');
+    const piCredentials = [path('.pi', 'agent', 'auth.json'), path('.pi', 'agent', 'models.json')];
+    if (host.exists(piDir) || piCredentials.some((candidate) => host.exists(candidate))) {
+        const hasAuth = piCredentials.some((candidate) => host.nonEmptyFile(candidate));
+        found.push(harness('pi', 'Pi', piDir, hasAuth
+            ? { hasAuth, authDetails: { type: 'unknown', hint: 'configured' } }
+            : { hasAuth }));
+    }
+    const ampDir = path('.config', 'amp');
+    const ampKey = host.env('AMP_API_KEY') ?? '';
+    const ampCredentials = [path('.config', 'amp', 'settings.json'), path('.amp', 'config.json'), path('.amp', 'auth.json')];
+    if (ampKey || host.exists(ampDir) || ampCredentials.some((candidate) => host.exists(candidate))) {
+        const hasFile = ampCredentials.some((candidate) => host.nonEmptyFile(candidate));
+        const hasAuth = Boolean(ampKey || hasFile);
+        found.push(harness('amp', 'Amp', ampDir, hasAuth
+            ? { hasAuth, authDetails: { type: ampKey ? 'api_key' : 'unknown', hint: ampKey ? ampKey.slice(-4) : 'configured' } }
+            : { hasAuth }));
+    }
+    const cursorDir = path('.cursor');
+    const cursorKey = host.env('CURSOR_API_KEY') ?? '';
+    const cursorCredentials = [
+        path('.cursor', 'credentials.json'),
+        path('.config', 'cursor', 'credentials.json'),
+        path('.local', 'share', 'cursor-agent', 'auth.json'),
+    ];
+    const cursorStatus = host.authStatus('cursor');
+    if (cursorKey || cursorStatus?.hasAuth || host.exists(cursorDir)
+        || cursorCredentials.some((candidate) => host.exists(candidate))) {
+        const hasFile = cursorCredentials.some((candidate) => host.nonEmptyFile(candidate));
+        const hasAuth = Boolean(cursorKey || cursorStatus?.hasAuth || hasFile);
+        found.push(harness('cursor', 'Cursor', cursorDir, hasAuth
+            ? cursorKey
+                ? { hasAuth, authDetails: { type: 'api_key', hint: cursorKey.slice(-4) } }
+                : cursorStatus?.hasAuth
+                    ? cursorStatus
+                    : { hasAuth, authDetails: { type: 'oauth', hint: 'configured' } }
+            : { hasAuth }));
+    }
+    return found;
+}
+function harness(id, name, configDir, status) {
+    return { id, name, configDir, ...(status ?? { hasAuth: false }) };
+}
+function clean(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+//# sourceMappingURL=discovery.js.map

package/dist/identity/local/discovery.js.map

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

package/dist/identity/local/index.d.ts

@@ -0,0 +1,5 @@
+export { createLocalApi } from './api.js';
+export { discoverLocalHarnesses } from './discovery.js';
+export { localReauthCommand, resolveLocalAgentEnv } from './resolve.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/identity/local/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/identity/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACxE,mBAAmB,YAAY,CAAC"}

package/dist/identity/local/index.js

@@ -0,0 +1,4 @@
+export { createLocalApi } from './api.js';
+export { discoverLocalHarnesses } from './discovery.js';
+export { localReauthCommand, resolveLocalAgentEnv } from './resolve.js';
+//# sourceMappingURL=index.js.map

package/dist/identity/local/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/identity/local/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/identity/local/resolve.d.ts

@@ -0,0 +1,7 @@
+import type { LocalHarness } from './types.js';
+export declare function resolveLocalAgentEnv(agentId: LocalHarness['id'] | string, authMode: string, proxyToken?: string, proxyBaseUrl?: string): Record<string, string>;
+export declare function localReauthCommand(agentId: string): {
+    shell: string;
+    description: string;
+} | null;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/identity/local/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/identity/local/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,EACpC,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAexB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAajG"}

package/dist/identity/local/resolve.js

@@ -0,0 +1,32 @@
+export function resolveLocalAgentEnv(agentId, authMode, proxyToken, proxyBaseUrl) {
+    if (authMode !== 'amalgm' || !proxyToken || !proxyBaseUrl)
+        return {};
+    const base = proxyBaseUrl.replace(/\/+$/, '');
+    switch (agentId) {
+        case 'claude_code':
+            return { ANTHROPIC_API_KEY: proxyToken, ANTHROPIC_BASE_URL: `${base}/anthropic` };
+        case 'codex':
+            return { OPENAI_API_KEY: proxyToken, OPENAI_BASE_URL: `${base}/openai/v1` };
+        case 'opencode':
+            return { AI_GATEWAY_API_KEY: proxyToken, AI_GATEWAY_BASE_URL: `${base}/ai_gateway/v3/ai` };
+        case 'pi':
+            return { AI_GATEWAY_API_KEY: proxyToken, AI_GATEWAY_BASE_URL: `${base}/ai_gateway/v1` };
+        default:
+            return {};
+    }
+}
+export function localReauthCommand(agentId) {
+    switch (agentId) {
+        case 'claude_code': return { shell: 'claude', description: 'Run `claude`, then type /login to authenticate.' };
+        case 'codex': return { shell: 'codex login', description: '`codex login` walks through OAuth or API-key setup.' };
+        case 'opencode': return { shell: 'opencode auth login', description: '`opencode auth login` walks through provider setup.' };
+        case 'pi': return { shell: 'pi --terminal-login', description: '`pi --terminal-login` authenticates Pi in the terminal.' };
+        case 'amp': return { shell: 'amp --setup', description: '`amp --setup` configures Amp credentials.' };
+        case 'cursor': return {
+            shell: 'if command -v cursor-agent >/dev/null 2>&1; then cursor-agent login; else "$HOME/.local/bin/cursor-agent" login; fi',
+            description: '`cursor-agent login` opens the browser login flow.',
+        };
+        default: return null;
+    }
+}
+//# sourceMappingURL=resolve.js.map

package/dist/identity/local/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/identity/local/resolve.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAClC,OAAoC,EACpC,QAAgB,EAChB,UAAmB,EACnB,YAAqB;IAErB,IAAI,QAAQ,KAAK,QAAQ,IAAI,CAAC,UAAU,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,CAAC;IACrE,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9C,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,aAAa;YAChB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,kBAAkB,EAAE,GAAG,IAAI,YAAY,EAAE,CAAC;QACpF,KAAK,OAAO;YACV,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,IAAI,YAAY,EAAE,CAAC;QAC9E,KAAK,UAAU;YACb,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,mBAAmB,EAAE,GAAG,IAAI,mBAAmB,EAAE,CAAC;QAC7F,KAAK,IAAI;YACP,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,mBAAmB,EAAE,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAC1F;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,aAAa,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE,CAAC;QAC/G,KAAK,OAAO,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,qDAAqD,EAAE,CAAC;QAClH,KAAK,UAAU,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,qDAAqD,EAAE,CAAC;QAC7H,KAAK,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,yDAAyD,EAAE,CAAC;QAC3H,KAAK,KAAK,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC;QACtG,KAAK,QAAQ,CAAC,CAAC,OAAO;YACpB,KAAK,EAAE,qHAAqH;YAC5H,WAAW,EAAE,oDAAoD;SAClE,CAAC;QACF,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/identity/local/types.d.ts

@@ -0,0 +1,30 @@
+export interface LocalAuthStatus {
+    readonly hasAuth: boolean;
+    readonly authDetails?: {
+        readonly type: 'oauth' | 'api_key' | 'unknown';
+        readonly hint: string;
+    };
+}
+export interface LocalHarness extends LocalAuthStatus {
+    readonly id: 'claude_code' | 'codex' | 'opencode' | 'pi' | 'amp' | 'cursor';
+    readonly name: string;
+    readonly configDir: string;
+}
+export interface LocalDiscoveryHost {
+    readonly homedir: string;
+    join(...parts: string[]): string;
+    exists(path: string): boolean;
+    nonEmptyFile(path: string): boolean;
+    readJson(path: string): unknown;
+    env(name: string): string | undefined;
+    authStatus(harnessId: LocalHarness['id']): LocalAuthStatus | null;
+}
+export interface LocalEnvironmentHost {
+    readonly homedir: string;
+    readonly workspaceRoot: string;
+    ensure(): {
+        readonly created: boolean;
+        readonly path: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/identity/local/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/identity/local/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAClG;AAED,MAAM,WAAW,YAAa,SAAQ,eAAe;IACnD,QAAQ,CAAC,EAAE,EAAE,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,IAAI,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACjC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,UAAU,CAAC,SAAS,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,eAAe,GAAG,IAAI,CAAC;CACnE;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,MAAM,IAAI;QAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE"}

package/dist/identity/local/types.js

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

package/dist/identity/local/types.js.map

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

package/dist/transport/index.d.ts

@@ -16,6 +16,7 @@
 export * from './auth.js';
 export * from './routing.js';
 export * from './shipped-routes.js';
+export * from './state/index.js';
 export * from './admission.js';
 export * from './ingress.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/transport/index.js

@@ -16,6 +16,7 @@
 export * from './auth.js';
 export * from './routing.js';
 export * from './shipped-routes.js';
+export * from './state/index.js';
 export * from './admission.js';
 export * from './ingress.js';
 //# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/transport/state/api.d.ts

@@ -0,0 +1,3 @@
+import { StateRail } from './rail.js';
+export declare function createStateApi(rail: StateRail): (request: Request) => Promise<Response>;
+//# sourceMappingURL=api.d.ts.map

package/dist/transport/state/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/transport/state/api.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAKtC,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAqBvF"}

package/dist/transport/state/api.js

@@ -0,0 +1,106 @@
+import { StateRail } from './rail.js';
+const JSON_HEADERS = { 'content-type': 'application/json', 'cache-control': 'no-store' };
+const encoder = new TextEncoder();
+export function createStateApi(rail) {
+    return async (request) => {
+        const url = new URL(request.url);
+        if (request.method === 'GET' && url.pathname === '/state') {
+            return json(200, { service: 'state', seq: rail.currentSeq(), resources: rail.resources.names() });
+        }
+        if (request.method === 'GET' && url.pathname === '/state/resources') {
+            return json(200, { resources: rail.resources.names(), defaults: rail.resources.defaults() });
+        }
+        if (request.method === 'GET' && url.pathname === '/state/snapshot') {
+            return json(200, await rail.snapshot(url.searchParams.get('resources') ?? undefined));
+        }
+        if (request.method === 'GET' && url.pathname === '/state/events') {
+            const result = rail.eventsAfter(url.searchParams.get('after'), url.searchParams.get('limit'));
+            return json(result.reset ? 409 : 200, result);
+        }
+        if (request.method === 'GET' && url.pathname === '/state/stream') {
+            return stateStream(rail, request, url.searchParams);
+        }
+        return json(404, { error: 'not found' });
+    };
+}
+function json(status, body) {
+    return new Response(JSON.stringify(body), { status, headers: JSON_HEADERS });
+}
+function stateStream(rail, request, query) {
+    let unsubscribe = () => { };
+    const body = new ReadableStream({
+        start(controller) {
+            let open = true;
+            let held = query.get('bootstrap') === '1' ? [] : null;
+            const send = (text) => {
+                if (open)
+                    controller.enqueue(encoder.encode(text));
+            };
+            const close = () => {
+                if (!open)
+                    return;
+                open = false;
+                unsubscribe();
+                controller.close();
+            };
+            const eventFrame = (event) => `id: ${event.seq}\nevent: state\ndata: ${JSON.stringify(event)}\n\n`;
+            send(': local-live-store connected\n\n');
+            let floor = Math.max(0, Number(query.get('after')) || 0);
+            unsubscribe = rail.subscribe((event) => {
+                if (held)
+                    held.push(event);
+                else if (event.seq > floor)
+                    send(eventFrame(event));
+            });
+            request.signal.addEventListener('abort', close, { once: true });
+            void (async () => {
+                if (held) {
+                    try {
+                        const snapshot = await rail.snapshot(query.get('resources') ?? undefined);
+                        floor = snapshot.seq;
+                        send(`event: snapshot\ndata: ${JSON.stringify(snapshot)}\n\n`);
+                        const buffered = held;
+                        held = null;
+                        for (const event of buffered)
+                            if (event.seq > floor)
+                                send(eventFrame(event));
+                    }
+                    catch (error) {
+                        send(`event: error\ndata: ${JSON.stringify({
+                            status: 500,
+                            error: error instanceof Error ? error.message : 'internal error',
+                        })}\n\n`);
+                        close();
+                    }
+                    return;
+                }
+                const replay = rail.eventsAfter(floor, 1001);
+                if (replay.reset || replay.events.length > 1000) {
+                    send(`event: reset\ndata: ${JSON.stringify(replay.reset ? replay : {
+                        code: 'state_replay_too_large',
+                        message: 'Too many missed events to replay; fetch a fresh snapshot.',
+                        after: floor,
+                        reset: true,
+                    })}\n\n`);
+                    close();
+                    return;
+                }
+                for (const event of replay.events)
+                    send(eventFrame(event));
+            })();
+        },
+        cancel() {
+            unsubscribe();
+        },
+    });
+    return new Response(body, {
+        status: 200,
+        headers: {
+            'content-type': 'text/event-stream; charset=utf-8',
+            'cache-control': 'no-cache, no-transform',
+            connection: 'keep-alive',
+            'x-accel-buffering': 'no',
+        },
+    });
+}
+//# sourceMappingURL=api.js.map

package/dist/transport/state/api.js.map

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

package/dist/transport/state/index.d.ts

@@ -0,0 +1,7 @@
+export { createStateApi } from './api.js';
+export { MemoryStateEventStore } from './memory-store.js';
+export { StateRail } from './rail.js';
+export type { StateRailOptions } from './rail.js';
+export { StateResourceRegistry } from './registry.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/transport/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,mBAAmB,YAAY,CAAC"}

package/dist/transport/state/index.js

@@ -0,0 +1,5 @@
+export { createStateApi } from './api.js';
+export { MemoryStateEventStore } from './memory-store.js';
+export { StateRail } from './rail.js';
+export { StateResourceRegistry } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/transport/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/transport/state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/transport/state/memory-store.d.ts

@@ -0,0 +1,16 @@
+import type { StateEvent, StateEventInput, StateEventStore } from './types.js';
+/** A bounded host adapter useful for embedded runtimes and tests. */
+export declare class MemoryStateEventStore implements StateEventStore {
+    #private;
+    constructor(options?: {
+        maxEvents?: number;
+    });
+    currentSeq(): number;
+    append(input: StateEventInput, ts: string): StateEvent;
+    listAfter(after: number, limit: number): readonly StateEvent[];
+    bounds(): {
+        minSeq: number;
+        maxSeq: number;
+    };
+}
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/transport/state/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../../src/transport/state/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE/E,qEAAqE;AACrE,qBAAa,qBAAsB,YAAW,eAAe;;gBAK/C,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO;IAIhD,UAAU,IAAI,MAAM;IAIpB,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU;IAStD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE;IAI9D,MAAM,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAM7C"}

package/dist/transport/state/memory-store.js

@@ -0,0 +1,30 @@
+/** A bounded host adapter useful for embedded runtimes and tests. */
+export class MemoryStateEventStore {
+    #events = [];
+    #maxEvents;
+    #seq = 0;
+    constructor(options = {}) {
+        this.#maxEvents = Math.max(1, Math.floor(options.maxEvents ?? 5000));
+    }
+    currentSeq() {
+        return this.#seq;
+    }
+    append(input, ts) {
+        const event = { seq: ++this.#seq, ts, ...input };
+        this.#events.push(event);
+        if (this.#events.length > this.#maxEvents) {
+            this.#events.splice(0, this.#events.length - this.#maxEvents);
+        }
+        return event;
+    }
+    listAfter(after, limit) {
+        return this.#events.filter((event) => event.seq > after).slice(0, limit);
+    }
+    bounds() {
+        return {
+            minSeq: this.#events[0]?.seq ?? 0,
+            maxSeq: this.#events.at(-1)?.seq ?? 0,
+        };
+    }
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/transport/state/memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.js","sourceRoot":"","sources":["../../../src/transport/state/memory-store.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,MAAM,OAAO,qBAAqB;IACvB,OAAO,GAAiB,EAAE,CAAC;IAC3B,UAAU,CAAS;IAC5B,IAAI,GAAG,CAAC,CAAC;IAET,YAAY,UAAkC,EAAE;QAC9C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,KAAsB,EAAE,EAAU;QACvC,MAAM,KAAK,GAAe,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC;QAC7D,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC1C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,SAAS,CAAC,KAAa,EAAE,KAAa;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM;QACJ,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;YACjC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;SACtC,CAAC;IACJ,CAAC;CACF"}

package/dist/transport/state/rail.d.ts

@@ -0,0 +1,27 @@
+import { StateResourceRegistry } from './registry.js';
+import type { StateEvent, StateEventInput, StateEventStore, StateResourceSpec, StateSnapshot } from './types.js';
+export interface StateRailOptions {
+    readonly store: StateEventStore;
+    readonly now?: () => Date;
+}
+export declare class StateRail {
+    #private;
+    readonly resources: StateResourceRegistry;
+    constructor(options: StateRailOptions);
+    currentSeq(): number;
+    registerResource(name: string, spec: StateResourceSpec): void;
+    registerResourcePrefix(prefix: string, spec: StateResourceSpec): void;
+    append(input: StateEventInput): StateEvent;
+    eventsAfter(afterInput: unknown, limitInput?: unknown): {
+        readonly events: readonly StateEvent[];
+        readonly seq: number;
+        readonly reset?: true;
+        readonly code?: 'state_event_gap';
+        readonly message?: string;
+        readonly minSeq?: number;
+        readonly maxSeq?: number;
+    };
+    snapshot(resourcesInput?: string | readonly string[]): Promise<StateSnapshot>;
+    subscribe(listener: (event: StateEvent) => void): () => void;
+}
+//# sourceMappingURL=rail.d.ts.map

package/dist/transport/state/rail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rail.d.ts","sourceRoot":"","sources":["../../../src/transport/state/rail.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,qBAAa,SAAS;;IACpB,QAAQ,CAAC,SAAS,wBAA+B;gBAKrC,OAAO,EAAE,gBAAgB;IAKrC,UAAU,IAAI,MAAM;IAIpB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAI7D,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAIrE,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU;IAS1C,WAAW,CAAC,UAAU,EAAE,OAAO,EAAE,UAAU,GAAE,OAAc,GAAG;QAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;QACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC;QAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;KAC1B;IAeK,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAoBnF,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,MAAM,IAAI;CAI7D"}

package/dist/transport/state/rail.js

@@ -0,0 +1,79 @@
+import { StateResourceRegistry } from './registry.js';
+export class StateRail {
+    resources = new StateResourceRegistry();
+    #store;
+    #now;
+    #listeners = new Set();
+    constructor(options) {
+        this.#store = options.store;
+        this.#now = options.now ?? (() => new Date());
+    }
+    currentSeq() {
+        return this.#store.currentSeq();
+    }
+    registerResource(name, spec) {
+        this.resources.register(name, spec);
+    }
+    registerResourcePrefix(prefix, spec) {
+        this.resources.registerPrefix(prefix, spec);
+    }
+    append(input) {
+        if (!input || typeof input.resource !== 'string' || typeof input.op !== 'string') {
+            throw new Error('state event requires resource and op');
+        }
+        const event = this.#store.append(input, this.#now().toISOString());
+        for (const listener of this.#listeners)
+            listener(event);
+        return event;
+    }
+    eventsAfter(afterInput, limitInput = 1000) {
+        const after = nonNegativeInteger(afterInput, 0);
+        const limit = Math.min(nonNegativeInteger(limitInput, 1000), 5000);
+        const { minSeq, maxSeq } = this.#store.bounds();
+        if (after > 0 && minSeq > after + 1) {
+            return {
+                events: [], seq: after, reset: true, code: 'state_event_gap',
+                message: 'State event history has been compacted; fetch a fresh snapshot.',
+                minSeq, maxSeq,
+            };
+        }
+        const events = this.#store.listAfter(after, Math.max(1, limit));
+        return { events, seq: events.at(-1)?.seq ?? after };
+    }
+    async snapshot(resourcesInput) {
+        const resources = normalizeResources(resourcesInput, this.resources.defaults());
+        let last = null;
+        for (let attempt = 0; attempt < 3; attempt += 1) {
+            const before = this.currentSeq();
+            const context = {};
+            const data = {};
+            for (const resource of resources) {
+                const spec = this.resources.spec(resource);
+                if (!spec)
+                    continue;
+                const value = await spec.read(context, resource);
+                if (value !== undefined)
+                    data[resource] = value;
+            }
+            const after = this.currentSeq();
+            if (before === after)
+                return { seq: after, stable: true, resources: data };
+            last = { seq: before, stable: false, resources: data };
+        }
+        return last;
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+}
+function nonNegativeInteger(value, fallback) {
+    const parsed = Number(value);
+    return Number.isInteger(parsed) && parsed >= 0 ? parsed : fallback;
+}
+function normalizeResources(input, defaults) {
+    const values = Array.isArray(input) ? input : input ? String(input).split(',') : defaults;
+    const clean = values.map((value) => String(value ?? '').trim()).filter(Boolean);
+    return clean.length > 0 ? [...new Set(clean)] : defaults;
+}
+//# sourceMappingURL=rail.js.map

package/dist/transport/state/rail.js.map

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

package/dist/transport/state/registry.d.ts

@@ -0,0 +1,11 @@
+import type { StateResourceSpec } from './types.js';
+export declare class StateResourceRegistry {
+    #private;
+    register(name: string, spec: StateResourceSpec): void;
+    registerPrefix(prefix: string, spec: StateResourceSpec): void;
+    unregister(name: string): boolean;
+    spec(name: string): Required<StateResourceSpec> | undefined;
+    names(): string[];
+    defaults(): string[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/transport/state/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/transport/state/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,qBAAa,qBAAqB;;IAIhC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAMrD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAM7D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,iBAAiB,CAAC,GAAG,SAAS;IAS3D,KAAK,IAAI,MAAM,EAAE;IAIjB,QAAQ,IAAI,MAAM,EAAE;CAcrB"}

package/dist/transport/state/registry.js

@@ -0,0 +1,46 @@
+export class StateResourceRegistry {
+    #resources = new Map();
+    #prefixes = new Map();
+    register(name, spec) {
+        this.#assert(name, spec);
+        if (this.#resources.has(name))
+            throw new Error(`resource "${name}" is already registered`);
+        this.#resources.set(name, { snapshotDefault: false, ...spec });
+    }
+    registerPrefix(prefix, spec) {
+        this.#assert(prefix, spec);
+        if (this.#prefixes.has(prefix))
+            throw new Error(`resource prefix "${prefix}" is already registered`);
+        this.#prefixes.set(prefix, { snapshotDefault: false, ...spec });
+    }
+    unregister(name) {
+        return this.#resources.delete(name);
+    }
+    spec(name) {
+        const direct = this.#resources.get(name);
+        if (direct)
+            return direct;
+        for (const [prefix, spec] of this.#prefixes) {
+            if (name.startsWith(prefix))
+                return spec;
+        }
+        return undefined;
+    }
+    names() {
+        return [...this.#resources.keys()];
+    }
+    defaults() {
+        return [...this.#resources]
+            .filter(([, spec]) => spec.snapshotDefault)
+            .map(([name]) => name);
+    }
+    #assert(name, spec) {
+        if (!name || typeof name !== 'string') {
+            throw new Error('registerResource requires a non-empty string name');
+        }
+        if (!spec || typeof spec.read !== 'function') {
+            throw new Error(`resource "${name}" requires a read() function`);
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/transport/state/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/transport/state/registry.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,qBAAqB;IACvB,UAAU,GAAG,IAAI,GAAG,EAAuC,CAAC;IAC5D,SAAS,GAAG,IAAI,GAAG,EAAuC,CAAC;IAEpE,QAAQ,CAAC,IAAY,EAAE,IAAuB;QAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,yBAAyB,CAAC,CAAC;QAC3F,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,cAAc,CAAC,MAAc,EAAE,IAAuB;QACpD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,yBAAyB,CAAC,CAAC;QACrG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,IAAY;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAC1B,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC3C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK;QACH,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;aACxB,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC;aAC1C,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,CAAC,IAAY,EAAE,IAAuB;QAC3C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,8BAA8B,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF"}

package/dist/transport/state/types.d.ts

@@ -0,0 +1,37 @@
+/** Engine reference: runtime/scripts/amalgm-mcp/state/{events,registry,snapshot}.js. */
+export interface StateEventInput {
+    readonly resource: string;
+    readonly op: string;
+    readonly id?: string;
+    readonly value?: unknown;
+    readonly patch?: unknown;
+    readonly clientMutationId?: string;
+    readonly mutationId?: string;
+    readonly sharedResourceId?: string;
+    readonly source?: string;
+    readonly version?: number;
+}
+export interface StateEvent extends StateEventInput {
+    readonly seq: number;
+    readonly ts: string;
+}
+export interface StateEventStore {
+    currentSeq(): number;
+    append(input: StateEventInput, ts: string): StateEvent;
+    listAfter(after: number, limit: number): readonly StateEvent[];
+    bounds(): {
+        readonly minSeq: number;
+        readonly maxSeq: number;
+    };
+}
+export type StateResourceReader = (context: Record<string, unknown>, resource: string) => unknown | Promise<unknown>;
+export interface StateResourceSpec {
+    readonly read: StateResourceReader;
+    readonly snapshotDefault?: boolean;
+}
+export interface StateSnapshot {
+    readonly seq: number;
+    readonly stable: boolean;
+    readonly resources: Readonly<Record<string, unknown>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transport/state/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/transport/state/types.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,UAAW,SAAQ,eAAe;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,IAAI,MAAM,CAAC;IACrB,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC;IACvD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,UAAU,EAAE,CAAC;IAC/D,MAAM,IAAI;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE;AAED,MAAM,MAAM,mBAAmB,GAAG,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,KACb,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD"}

package/dist/transport/state/types.js

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

package/dist/transport/state/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amalgm/core",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "The Amalgm kernel SDK — identity, transport, supervision, and host capability contracts behind host-injected adapters.",
   "type": "module",
   "license": "UNLICENSED",
@@ -20,10 +20,18 @@
       "types": "./dist/identity/index.d.ts",
       "default": "./dist/identity/index.js"
     },
+    "./local": {
+      "types": "./dist/identity/local/index.d.ts",
+      "default": "./dist/identity/local/index.js"
+    },
     "./transport": {
       "types": "./dist/transport/index.d.ts",
       "default": "./dist/transport/index.js"
     },
+    "./state": {
+      "types": "./dist/transport/state/index.d.ts",
+      "default": "./dist/transport/state/index.js"
+    },
     "./supervision": {
       "types": "./dist/supervision/index.d.ts",
       "default": "./dist/supervision/index.js"