@omnitype-code/adapter-sdk 2.0.0

package/README.md

@@ -0,0 +1,163 @@
+# @omnitype-code/adapter-sdk
+
+The adapter layer for OmniType v2 deterministic attribution.
+
+This SDK is for **AI tool authors** and **open-source contributors** who want to add OmniType attribution support to a coding tool (Cursor, Windsurf, Cline, a custom CLI, etc.).
+
+If you are an AI tool **end user** looking to track attribution in your own workflow, install the VSCode extension instead.
+
+---
+
+## How the tier system works
+
+Every file edit tracked by OmniType gets an attribution **tier**:
+
+| Tier | Name | How it's produced | Confidence |
+|---|---|---|---|
+| **T0** | Deterministic | AI tool embeds `@omnitype-code/agent-sdk` directly | 100% |
+| **T1** | Hook-inferred | `preToolUse` hook fires before each tool call | 85% |
+| **T2** | Retrospective | Transcript scavenger reads session logs after the fact | 60% |
+| **T3** | Filesystem-only | File watcher sees a change with no session context | 30% |
+
+The goal is to get as much attribution as possible at T0 or T1. T3 spans have `origin='unknown'` — they are **never** assumed to be AI.
+
+---
+
+## Option A — Embed the Agent SDK (T0 path)
+
+Use `@omnitype-code/agent-sdk` if your tool writes files directly (not via shell hooks).
+
+```bash
+npm install @omnitype-code/agent-sdk
+```
+
+```typescript
+import { OmniTypeAgent } from '@omnitype-code/agent-sdk';
+
+// On session start (once per AI conversation)
+const agent = await OmniTypeAgent.tryConnect({
+  workspace: '/path/to/git/repo',
+  sessionId: crypto.randomUUID(),
+  model: 'claude-sonnet-4-6',
+  tool: 'my-tool',
+});
+
+// Wrap every file write — produces T0 (deterministic) attribution
+if (agent) {
+  await agent.withEdit('src/foo.ts', newContent, async (absPath, content) => {
+    await fs.writeFile(absPath, content, 'utf-8');
+  });
+} else {
+  // Daemon not running — write normally, attribution will be T3
+  await fs.writeFile(absPath, newContent, 'utf-8');
+}
+
+// On session end
+await agent?.end('tool-exit');
+```
+
+`tryConnect` returns `null` if the daemon isn't running — your tool continues working normally and writes are tracked at T3 by the filesystem watcher.
+
+### Fine-grained API
+
+```typescript
+// Manual txn control (for multi-file edits)
+const txn = await agent.beginTxn(['src/a.ts', 'src/b.ts']);
+await writeA();
+await writeB();
+await agent.commitTxn(txn, [
+  { path: 'src/a.ts', preHash, postHash, splices },
+  { path: 'src/b.ts', preHash, postHash, splices },
+]);
+
+// Emit the prompt (privacy-safe — only hash stored by default)
+await agent.emitPrompt(promptText, /* shareText= */ false);
+```
+
+---
+
+## Option B — Write a Manifest (T1 path)
+
+If your tool runs shell commands that can be intercepted via hooks, write a 30-line JSON manifest.
+
+Create `.omnitype/adapters/my-tool/manifest.json`:
+
+```json
+{
+  "id": "my-tool",
+  "version": "1.0.0",
+  "display_name": "My AI Tool",
+  "tool_binary": "my-tool",
+  "trust": { "trust_circle": 2 },
+  "declared_capabilities": [
+    "tool.identity",
+    "session.id",
+    "hook.preToolUse",
+    "operation.editOp.path_only"
+  ],
+  "hooks": {
+    "preToolUse": {
+      "install_path": "~/.config/my-tool/hooks/preToolUse.sh",
+      "one_liner": "echo '{\"type\":\"hook\",\"tool\":\"my-tool\",\"session\":\"$SESSION_ID\",\"file\":\"$FILE\"}' >> ${OMNITYPE_HOOKS_DIR}/event-$(date +%s%N).json"
+    }
+  },
+  "normalize": [
+    {
+      "match": { "tool_name": "write_file" },
+      "emit": "EditOp",
+      "path_from": "$.arguments.path",
+      "origin": "ai"
+    }
+  ]
+}
+```
+
+Then run:
+```bash
+omnitype-daemon install-hooks
+```
+
+The daemon will install the hook and start receiving T1 events from your tool.
+
+### Trust circles
+
+| Circle | Level | Who uses it |
+|---|---|---|
+| 1 | Verified partner | Claude Code, Cursor, Windsurf (manifests maintained by OmniType) |
+| 2 | Community verified | Cline, Copilot (community-maintained, OmniType-reviewed) |
+| 3 | Community | Unreviewed third-party manifests |
+
+T0 is only achievable via the Agent SDK. Community (circle 3) adapters are capped at T1.
+
+---
+
+## The attribution guarantee
+
+**OmniType v2 never assumes an unknown write is AI-generated.**
+
+- `origin='unknown'` means: a file changed, but we don't know who wrote it.
+- `origin='ai'` requires positive evidence: an active AI session txn, a signed Agent SDK event, or a hook payload.
+- This is enforced in the SQLite materializer — there is no code path that promotes `'unknown'` to `'ai'`.
+
+---
+
+## Verifying your adapter
+
+```bash
+# Check your adapter is installed and recognised
+omnitype-daemon doctor
+
+# See live attribution as you code
+omnitype-daemon blame src/foo.ts
+
+# Check tier breakdown for the workspace
+omnitype-daemon health
+```
+
+---
+
+## Filing issues
+
+Open an issue at [github.com/omnitype-code/omnitype-v2](https://github.com/omnitype-code/omnitype-v2) with the label `adapter`.
+
+Include the output of `omnitype-daemon doctor` and `omnitype-daemon health --json`.

package/dist/adapters/filesystem-only.d.ts

@@ -0,0 +1,30 @@
+/**
+ * filesystem-only-adapter — always loaded, cannot be disabled.
+ *
+ * Watches files for changes that weren't recorded by any other adapter,
+ * computes a Myers diff, and emits UnattributedDelta with confidence < 1.0.
+ *
+ * Key invariants:
+ *  - NEVER emits origin='ai'. Unknown writers are 'unknown'.
+ *  - Always tier T3.
+ *  - Only emits for files that have an existing FileOpened record (tracked).
+ *  - Deduplicates against changes already recorded by higher-tier adapters
+ *    (if post_hash matches materialized hash, skip).
+ */
+import type { EmitFn } from '../loader.js';
+export declare const ADAPTER_ID = "org.omnitype.adapters.filesystem-only";
+export declare class FilesystemOnlyAdapter {
+    private watched;
+    private watchers;
+    private emit;
+    private workspace;
+    private actor;
+    constructor(emit: EmitFn, workspace: string, user: string, host: string);
+    /** Called by the materializer when a file is first opened/tracked */
+    trackFile(relPath: string, currentHash: string): void;
+    untrackFile(relPath: string): void;
+    private onFileChange;
+    private guessCandidates;
+    stopAll(): void;
+}
+//# sourceMappingURL=filesystem-only.d.ts.map

package/dist/adapters/filesystem-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-only.d.ts","sourceRoot":"","sources":["../../src/adapters/filesystem-only.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,eAAO,MAAM,UAAU,0CAA0C,CAAC;AAQlE,qBAAa,qBAAqB;IAChC,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,QAAQ,CAA+C;IAC/D,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAQ;gBAET,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAYvE,qEAAqE;IACrE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAarD,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMlC,OAAO,CAAC,YAAY;IAiCpB,OAAO,CAAC,eAAe;IAMvB,OAAO,IAAI,IAAI;CAKhB"}

package/dist/adapters/filesystem-only.js

@@ -0,0 +1,115 @@
+/**
+ * filesystem-only-adapter — always loaded, cannot be disabled.
+ *
+ * Watches files for changes that weren't recorded by any other adapter,
+ * computes a Myers diff, and emits UnattributedDelta with confidence < 1.0.
+ *
+ * Key invariants:
+ *  - NEVER emits origin='ai'. Unknown writers are 'unknown'.
+ *  - Always tier T3.
+ *  - Only emits for files that have an existing FileOpened record (tracked).
+ *  - Deduplicates against changes already recorded by higher-tier adapters
+ *    (if post_hash matches materialized hash, skip).
+ */
+import { watch, readFileSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { hashBytes } from '@omnitype-code/journal';
+export const ADAPTER_ID = 'org.omnitype.adapters.filesystem-only';
+export class FilesystemOnlyAdapter {
+    watched = new Map();
+    watchers = new Map();
+    emit;
+    workspace;
+    actor;
+    constructor(emit, workspace, user, host) {
+        this.emit = emit;
+        this.workspace = workspace;
+        this.actor = {
+            kind: 'unknown',
+            tool: 'unknown',
+            user,
+            host,
+            workspace,
+        };
+    }
+    /** Called by the materializer when a file is first opened/tracked */
+    trackFile(relPath, currentHash) {
+        const absPath = join(this.workspace, relPath);
+        this.watched.set(relPath, { path: relPath, absPath, lastHash: currentHash });
+        if (this.watchers.has(relPath))
+            return;
+        const watcher = watch(absPath, { persistent: false }, () => {
+            // Debounce 150ms
+            setTimeout(() => this.onFileChange(relPath), 150);
+        });
+        this.watchers.set(relPath, watcher);
+    }
+    untrackFile(relPath) {
+        this.watchers.get(relPath)?.close();
+        this.watchers.delete(relPath);
+        this.watched.delete(relPath);
+    }
+    onFileChange(relPath) {
+        const entry = this.watched.get(relPath);
+        if (!entry)
+            return;
+        let newContent;
+        try {
+            newContent = readFileSync(entry.absPath, 'utf-8');
+        }
+        catch {
+            return; // file deleted or unreadable
+        }
+        const newHash = hashBytes(Buffer.from(newContent, 'utf-8'));
+        if (newHash === entry.lastHash)
+            return; // no real change
+        const oldHash = entry.lastHash;
+        entry.lastHash = newHash;
+        const ops = computeSimpleDiff(entry.absPath, oldHash, newContent);
+        if (ops.length === 0)
+            return;
+        const body = {
+            type: 'UnattributedDelta',
+            path: relPath,
+            pre_hash: oldHash,
+            post_hash: newHash,
+            ops,
+            candidates: this.guessCandidates(relPath),
+            confidence: 0.0, // explicitly zero — we don't know who did this
+        };
+        this.emit(this.actor, body, 'T3', ADAPTER_ID);
+    }
+    guessCandidates(relPath) {
+        // In the future: query process-observation-adapter here
+        // For now: empty candidate list (honest unknown)
+        return [];
+    }
+    stopAll() {
+        for (const w of this.watchers.values())
+            w.close();
+        this.watchers.clear();
+        this.watched.clear();
+    }
+}
+// ─── Simple diff: whole-file replace represented as one splice ────────────────
+// This is the v1 LCS downgraded to its honest role: T3, UnattributedDelta only.
+// A real Myers diff is a future improvement; correctness of attribution doesn't
+// depend on diff quality here since everything is already tagged T3/confidence=0.
+function computeSimpleDiff(absPath, oldHash, newContent) {
+    // Represent as a full-file replacement splice.
+    // Byte-accurate diff can be added later; for now we model it as:
+    // delete everything, insert new content.
+    let oldLen = 0;
+    try {
+        oldLen = statSync(absPath).size;
+    }
+    catch { /* file might be new */ }
+    return [
+        {
+            offset: 0,
+            delete_len: oldLen,
+            insert_text: newContent,
+        },
+    ];
+}
+//# sourceMappingURL=filesystem-only.js.map

package/dist/adapters/filesystem-only.js.map

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

package/dist/adapters/hook-poller.d.ts

@@ -0,0 +1,40 @@
+/**
+ * hook-poller — polls the .omnitype/hooks/ directory for events written
+ * by hook one-liners and converts them to journal events.
+ *
+ * Each tool's preToolUse hook writes a JSON file to the pipeDir.
+ * This poller drains those files every POLL_INTERVAL_MS and emits:
+ *   - SessionStarted (if session_id is new)
+ *   - ModelClaim (if model is present)
+ *   - TxnBegin (for write-type tool calls)
+ *   - The actual EditOp comes later from the VSCode discriminator or
+ *     the filesystem watcher — NOT from the hook itself.
+ *
+ * This replaces the v1 sentinel approach.
+ * Key improvements over v1:
+ *   - Events are consumed and deleted — no stale TTL races.
+ *   - Session is tracked explicitly — no 30s window heuristics.
+ *   - Model comes from actual hook payload — not terminal scraping.
+ *   - process.cwd() issue is avoided: we know the workspace because
+ *     the daemon already owns the workspace context.
+ */
+import type { EmitFn } from '../loader.js';
+export declare const ADAPTER_ID = "org.omnitype.adapters.hook-poller";
+export declare class HookPoller {
+    private pipeDir;
+    private emit;
+    private workspace;
+    private user;
+    private host;
+    private timer;
+    private seenSessions;
+    private openTxns;
+    constructor(emit: EmitFn, workspace: string, user: string, host: string);
+    start(): void;
+    private poll;
+    private processHookEvent;
+    getOpenTxn(sessionId: string): string | undefined;
+    closeOpenTxn(sessionId: string): void;
+    stop(): void;
+}
+//# sourceMappingURL=hook-poller.d.ts.map

package/dist/adapters/hook-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-poller.d.ts","sourceRoot":"","sources":["../../src/adapters/hook-poller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAUH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAQ3C,eAAO,MAAM,UAAU,sCAAsC,CAAC;AAI9D,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,YAAY,CAAqB;IAEzC,OAAO,CAAC,QAAQ,CAA6B;gBAEjC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAQvE,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,gBAAgB;IAgExB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIjD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAIrC,IAAI,IAAI,IAAI;CAMb"}

package/dist/adapters/hook-poller.js

@@ -0,0 +1,125 @@
+/**
+ * hook-poller — polls the .omnitype/hooks/ directory for events written
+ * by hook one-liners and converts them to journal events.
+ *
+ * Each tool's preToolUse hook writes a JSON file to the pipeDir.
+ * This poller drains those files every POLL_INTERVAL_MS and emits:
+ *   - SessionStarted (if session_id is new)
+ *   - ModelClaim (if model is present)
+ *   - TxnBegin (for write-type tool calls)
+ *   - The actual EditOp comes later from the VSCode discriminator or
+ *     the filesystem watcher — NOT from the hook itself.
+ *
+ * This replaces the v1 sentinel approach.
+ * Key improvements over v1:
+ *   - Events are consumed and deleted — no stale TTL races.
+ *   - Session is tracked explicitly — no 30s window heuristics.
+ *   - Model comes from actual hook payload — not terminal scraping.
+ *   - process.cwd() issue is avoided: we know the workspace because
+ *     the daemon already owns the workspace context.
+ */
+import { join } from 'node:path';
+import { createHash, randomBytes } from 'node:crypto';
+import { drainHookEvents } from './stdin-json-hook-tool.js';
+import { isWriteToolCall, hookPayloadToFilePath, hookPayloadToSessionEvent, } from '../normalize.js';
+export const ADAPTER_ID = 'org.omnitype.adapters.hook-poller';
+const POLL_INTERVAL_MS = 100;
+const HOOK_TIER = 'T1'; // hook + workspace context = T1
+export class HookPoller {
+    pipeDir;
+    emit;
+    workspace;
+    user;
+    host;
+    timer = null;
+    seenSessions = new Set();
+    // Maps session_id → open txn_id (for deduplication)
+    openTxns = new Map();
+    constructor(emit, workspace, user, host) {
+        this.pipeDir = join(workspace, '.omnitype', 'hooks');
+        this.emit = emit;
+        this.workspace = workspace;
+        this.user = user;
+        this.host = host;
+    }
+    start() {
+        this.timer = setInterval(() => this.poll(), POLL_INTERVAL_MS);
+        this.timer.unref();
+    }
+    poll() {
+        const events = drainHookEvents(this.pipeDir);
+        for (const event of events) {
+            this.processHookEvent(event);
+        }
+    }
+    processHookEvent(event) {
+        const { tool, payload, ts } = event;
+        const sessionInfo = hookPayloadToSessionEvent(payload, tool);
+        const filePath = hookPayloadToFilePath(payload);
+        // Antigravity uses toolCall.name; legacy tools use tool_name
+        const toolName = payload.tool_name ?? payload.toolCall?.name;
+        const actor = {
+            kind: 'ai',
+            tool,
+            model: payload.model ?? sessionInfo?.model ?? 'unknown',
+            session_id: sessionInfo?.session_id,
+            user: this.user,
+            host: this.host,
+            workspace: this.workspace,
+        };
+        // Emit SessionStarted (once per session_id)
+        if (sessionInfo?.session_id && !this.seenSessions.has(sessionInfo.session_id)) {
+            this.seenSessions.add(sessionInfo.session_id);
+            const dummyPromptHash = createHash('sha256').update(sessionInfo.session_id).digest('hex');
+            const sessionEvent = {
+                type: 'SessionStarted',
+                session_id: sessionInfo.session_id,
+                tool,
+                model: sessionInfo.model || 'unknown',
+                prompt_hash: dummyPromptHash,
+                prompt_bytes: 0,
+            };
+            this.emit(actor, sessionEvent, HOOK_TIER, ADAPTER_ID);
+        }
+        // Emit ModelClaim if model present
+        if (payload.model && sessionInfo?.session_id) {
+            const modelEvent = {
+                type: 'ModelClaim',
+                session_id: sessionInfo.session_id,
+                model: payload.model,
+                source: 'hook-stdin',
+            };
+            this.emit(actor, modelEvent, HOOK_TIER, ADAPTER_ID);
+        }
+        // Emit TxnBegin for write-type tool calls
+        if (isWriteToolCall(toolName) && sessionInfo?.session_id) {
+            const existingTxn = this.openTxns.get(sessionInfo.session_id);
+            if (!existingTxn) {
+                const txnId = randomBytes(16).toString('hex');
+                this.openTxns.set(sessionInfo.session_id, txnId);
+                const txnBegin = {
+                    type: 'TxnBegin',
+                    txn_id: txnId,
+                    session_id: sessionInfo.session_id,
+                    expected_files: filePath ? [filePath] : [],
+                };
+                this.emit(actor, txnBegin, HOOK_TIER, ADAPTER_ID);
+            }
+        }
+        // Note: TxnCommit is emitted by the VSCode extension or watcher
+        // when the actual file change is observed and linked to this txn.
+    }
+    getOpenTxn(sessionId) {
+        return this.openTxns.get(sessionId);
+    }
+    closeOpenTxn(sessionId) {
+        this.openTxns.delete(sessionId);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+}
+//# sourceMappingURL=hook-poller.js.map

package/dist/adapters/hook-poller.js.map

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

package/dist/adapters/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Built-in adapter suite.
+ *
+ * Production guarantees:
+ *   - Any individual adapter failing to start does NOT abort the daemon.
+ *   - The suite always returns a usable handle, even when every adapter fails
+ *     (the FilesystemOnlyAdapter is the always-on graceful-degradation path).
+ *   - Each adapter's health is reported through `getHealth()`, so the daemon
+ *     can expose it via `query_health` and the dashboard can show users
+ *     which tools fell back to T3.
+ */
+import { FilesystemOnlyAdapter } from './filesystem-only.js';
+import { HookPoller } from './hook-poller.js';
+import { TranscriptScavengerAdapter } from './transcript-scavenger.js';
+import type { EmitFn } from '../loader.js';
+export interface AdapterHealth {
+    id: string;
+    started: boolean;
+    error?: string;
+}
+export interface AdapterSuite {
+    filesystemOnly: FilesystemOnlyAdapter;
+    hookPoller: HookPoller | null;
+    transcriptScavenger: TranscriptScavengerAdapter | null;
+    getHealth(): AdapterHealth[];
+    stop(): void;
+}
+export declare function startBuiltinAdapters(emit: EmitFn, workspace: string, user: string, host: string): AdapterSuite;
+export { FilesystemOnlyAdapter } from './filesystem-only.js';
+export { HookPoller } from './hook-poller.js';
+export { TranscriptScavengerAdapter } from './transcript-scavenger.js';
+export { installHooks, TOOL_SPECS, buildHookOneliner } from './stdin-json-hook-tool.js';
+export type { InstallResult, ToolHookSpec } from './stdin-json-hook-tool.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,qBAAqB,CAAC;IACtC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,mBAAmB,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACvD,SAAS,IAAI,aAAa,EAAE,CAAC;IAC7B,IAAI,IAAI,IAAI,CAAC;CACd;AAmBD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,YAAY,CA+Bd;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACxF,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,61 @@
+/**
+ * Built-in adapter suite.
+ *
+ * Production guarantees:
+ *   - Any individual adapter failing to start does NOT abort the daemon.
+ *   - The suite always returns a usable handle, even when every adapter fails
+ *     (the FilesystemOnlyAdapter is the always-on graceful-degradation path).
+ *   - Each adapter's health is reported through `getHealth()`, so the daemon
+ *     can expose it via `query_health` and the dashboard can show users
+ *     which tools fell back to T3.
+ */
+import { FilesystemOnlyAdapter } from './filesystem-only.js';
+import { HookPoller } from './hook-poller.js';
+import { TranscriptScavengerAdapter } from './transcript-scavenger.js';
+function safeStart(adapter, id, health) {
+    try {
+        adapter.start();
+        health.push({ id, started: true });
+        return adapter;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[omnitype-adapters] ${id} failed to start: ${msg}`);
+        health.push({ id, started: false, error: msg });
+        return null;
+    }
+}
+export function startBuiltinAdapters(emit, workspace, user, host) {
+    const health = [];
+    // FilesystemOnlyAdapter is always-on, started per-file via trackFile().
+    // It is the universal fallback: any unsupported tool's writes are caught here.
+    const filesystemOnly = new FilesystemOnlyAdapter(emit, workspace, user, host);
+    health.push({ id: 'org.omnitype.adapters.filesystem-only', started: true });
+    const hookPoller = safeStart(new HookPoller(emit, workspace, user, host), 'org.omnitype.adapters.hook-poller', health);
+    const transcriptScavenger = safeStart(new TranscriptScavengerAdapter(emit, workspace, user, host), 'org.omnitype.adapters.transcript-scavenger', health);
+    return {
+        filesystemOnly,
+        hookPoller,
+        transcriptScavenger,
+        getHealth: () => health.slice(),
+        stop() {
+            try {
+                filesystemOnly.stopAll();
+            }
+            catch { /* */ }
+            try {
+                hookPoller?.stop();
+            }
+            catch { /* */ }
+            try {
+                transcriptScavenger?.stop();
+            }
+            catch { /* */ }
+        },
+    };
+}
+export { FilesystemOnlyAdapter } from './filesystem-only.js';
+export { HookPoller } from './hook-poller.js';
+export { TranscriptScavengerAdapter } from './transcript-scavenger.js';
+export { installHooks, TOOL_SPECS, buildHookOneliner } from './stdin-json-hook-tool.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAiBvE,SAAS,SAAS,CAChB,OAAU,EACV,EAAU,EACV,MAAuB;IAEvB,IAAI,CAAC;QACH,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,qBAAqB,GAAG,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,SAAiB,EACjB,IAAY,EACZ,IAAY;IAEZ,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,wEAAwE;IACxE,+EAA+E;IAC/E,MAAM,cAAc,GAAG,IAAI,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9E,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,uCAAuC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5E,MAAM,UAAU,GAAG,SAAS,CAC1B,IAAI,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,EAC3C,mCAAmC,EACnC,MAAM,CACP,CAAC;IAEF,MAAM,mBAAmB,GAAG,SAAS,CACnC,IAAI,0BAA0B,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,EAC3D,4CAA4C,EAC5C,MAAM,CACP,CAAC;IAEF,OAAO;QACL,cAAc;QACd,UAAU;QACV,mBAAmB;QACnB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;QAC/B,IAAI;YACF,IAAI,CAAC;gBAAC,cAAc,CAAC,OAAO,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;YACjD,IAAI,CAAC;gBAAC,UAAU,EAAE,IAAI,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC;gBAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;QACtD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}