@loompad/cli 0.1.0 → 1.1.1

package/dist/providers/contracts.d.ts

@@ -0,0 +1,339 @@
+/**
+ * The provider contract: what a harness session is, what a turn takes, and the
+ * one canonical runtime event stream every adapter emits.
+ *
+ * Ported from t3code (MIT, © T3 Tools Inc.):
+ *   packages/contracts/src/provider.ts, providerRuntime.ts, orchestration.ts
+ * as plain TypeScript, reduced to what Codex and Claude Code need. Names and
+ * shapes follow t3code so later phases can keep porting without remapping.
+ *
+ * Vocabulary (see docs/refactoring/T3-PORT-NOTES.md): a t3code *thread* is a
+ * Loom chat, and a provider *instance* is a Loom agent config entry. Loom keys
+ * a session by (thread, instance), because a chat can switch provider.
+ */
+export type ProviderKind = "codex" | "claude-code";
+export declare const PROVIDER_KINDS: readonly ProviderKind[];
+export declare const isProviderKind: (value: string) => value is ProviderKind;
+/** A Loom chat id. */
+export type ThreadId = string;
+/** A Loom agent id: one configured instance of a provider. */
+export type InstanceId = string;
+export type TurnId = string;
+export type ItemId = string;
+export type RequestId = string;
+/** How much the agent may do unasked. Loom's permission modes, in t3code's words. */
+export type RuntimeMode = "approval-required" | "auto-accept-edits" | "full-access";
+export type InteractionMode = "default" | "plan";
+export type ProviderSessionStatus = "connecting" | "ready" | "running" | "error" | "closed";
+export interface ModelSelection {
+    model?: string;
+    /** Reasoning effort, in the provider's own vocabulary (e.g. "high"). */
+    effort?: string;
+}
+export interface ProviderSession {
+    provider: ProviderKind;
+    instanceId: InstanceId;
+    threadId: ThreadId;
+    status: ProviderSessionStatus;
+    runtimeMode: RuntimeMode;
+    cwd: string;
+    model?: string;
+    /** What resumes this session after the process is gone: the native thread/session id. */
+    resumeCursor?: unknown;
+    activeTurnId?: TurnId;
+    createdAt: number;
+    updatedAt: number;
+    lastError?: string;
+}
+export interface SessionStartInput {
+    threadId: ThreadId;
+    instanceId: InstanceId;
+    cwd: string;
+    runtimeMode: RuntimeMode;
+    modelSelection?: ModelSelection;
+    /** Resume this native session instead of starting a new one. */
+    resumeCursor?: unknown;
+}
+export interface SendTurnInput {
+    threadId: ThreadId;
+    instanceId: InstanceId;
+    input: string;
+    modelSelection?: ModelSelection;
+    interactionMode?: InteractionMode;
+    /** Correlates the turn with the caller (Brain run id, client message id). */
+    clientTurnId?: string;
+}
+export interface TurnStartResult {
+    threadId: ThreadId;
+    turnId: TurnId;
+    resumeCursor?: unknown;
+}
+export type ApprovalDecision = "accept" | "acceptForSession" | "decline" | "cancel";
+export type UserInputAnswers = Record<string, unknown>;
+export interface AdapterCapabilities {
+    /** Whether an existing session can change model without restarting. */
+    sessionModelSwitch: "in-session" | "restart" | "unsupported";
+    /** False when native conversation history cannot be rewound. */
+    supportsConversationRollback: boolean;
+    /** Whether the adapter can start a compaction on request. */
+    manualCompaction: boolean;
+}
+export interface ThreadSnapshot {
+    threadId: ThreadId;
+    turns: Array<{
+        id: TurnId;
+        items: unknown[];
+    }>;
+}
+export type RuntimeSessionState = "starting" | "ready" | "running" | "waiting" | "stopped" | "error";
+export type RuntimeThreadState = "active" | "idle" | "closed" | "compacted" | "error";
+export type RuntimeTurnState = "completed" | "failed" | "interrupted" | "cancelled";
+export type RuntimeItemStatus = "inProgress" | "completed" | "failed" | "declined";
+export type ContentStreamKind = "assistant_text" | "reasoning_text" | "reasoning_summary_text" | "plan_text" | "command_output" | "file_change_output" | "unknown";
+export type CanonicalItemType = "user_message" | "assistant_message" | "reasoning" | "plan" | "command_execution" | "file_change" | "mcp_tool_call" | "dynamic_tool_call" | "collab_agent_tool_call" | "web_search" | "image_view" | "context_compaction" | "error" | "unknown";
+export type CanonicalRequestType = "command_execution_approval" | "file_read_approval" | "file_change_approval" | "apply_patch_approval" | "exec_command_approval" | "mcp_elicitation_approval" | "permission_approval" | "tool_user_input" | "unknown";
+export interface ThreadTokenUsage {
+    /** Tokens in the model's context now. */
+    usedTokens: number;
+    maxTokens?: number;
+    totalProcessedTokens?: number;
+    inputTokens?: number;
+    cachedInputTokens?: number;
+    outputTokens?: number;
+    reasoningOutputTokens?: number;
+    compactsAutomatically?: boolean;
+}
+/** One turn's main-agent usage. Input includes cache reads and writes; output includes reasoning. */
+export interface TurnTokenUsage {
+    usageStatus: "complete" | "partial" | "unavailable";
+    inputTokens?: number;
+    outputTokens?: number;
+    cachedInputTokens?: number;
+    cacheCreationTokens?: number;
+    reasoningTokens?: number;
+}
+export interface RateLimitWindow {
+    id: string;
+    usedPercent: number;
+    windowMinutes?: number;
+    /** Epoch ms. */
+    resetsAt?: number;
+}
+export interface UserInputQuestion {
+    id: string;
+    header: string;
+    question: string;
+    options: Array<{
+        label: string;
+        description: string;
+        value?: string;
+    }>;
+    allowCustomAnswer?: boolean;
+    multiSelect?: boolean;
+    /** A password-like answer: typed hidden, never kept in the thread. */
+    secret?: boolean;
+}
+export interface ItemLifecyclePayload {
+    itemType: CanonicalItemType;
+    status?: RuntimeItemStatus;
+    title?: string;
+    detail?: string;
+    data?: unknown;
+    /** Set when the item ran inside a sub-agent. */
+    parentToolUseId?: string;
+}
+/**
+ * Normalized `data` for tool items, so nothing above the adapter parses a
+ * provider's native item. An adapter fills the one matching its `itemType`.
+ * Assistant and reasoning text arrive as `content.delta`; the completed item's
+ * `detail` is the whole text, used only when nothing was streamed.
+ */
+export interface CommandItemData {
+    command: string;
+    cwd?: string;
+    exitCode?: number | null;
+    output?: string;
+}
+export interface FileChangeItemData {
+    changes: Array<{
+        path: string;
+        kind: string;
+        diff?: string;
+    }>;
+}
+/**
+ * An image a tool returned. `data` is base64 straight from the provider; ingestion
+ * writes it under .loom/attachments and logs only the `path`. A `path` alone is a
+ * file the tool looked at (Codex's view_image).
+ */
+export interface ToolImage {
+    data?: string;
+    path?: string;
+    mime?: string;
+}
+export interface ToolItemData {
+    tool: string;
+    input?: Record<string, unknown>;
+    output?: string;
+    error?: string;
+    server?: string;
+    images?: ToolImage[];
+}
+/** Payload by event type. */
+export interface RuntimeEventPayloads {
+    "session.started": {
+        resume?: unknown;
+    };
+    "session.state.changed": {
+        state: RuntimeSessionState;
+        reason?: string;
+    };
+    "session.exited": {
+        reason?: string;
+        recoverable?: boolean;
+        exitKind?: "graceful" | "error";
+    };
+    "thread.started": {
+        providerThreadId?: string;
+    };
+    "thread.state.changed": {
+        state: RuntimeThreadState;
+        beforeTokens?: number;
+        afterTokens?: number;
+        trigger?: "auto" | "manual";
+    };
+    "thread.token-usage.updated": {
+        usage: ThreadTokenUsage;
+    };
+    "turn.started": {
+        model?: string;
+        effort?: string;
+    };
+    "turn.completed": {
+        state: RuntimeTurnState;
+        stopReason?: string | null;
+        errorMessage?: string;
+        totalCostUsd?: number;
+        tokenUsage?: TurnTokenUsage;
+        model?: string;
+    };
+    "turn.aborted": {
+        reason: string;
+        detail?: {
+            stderr?: string;
+        };
+    };
+    "turn.plan.updated": {
+        explanation?: string | null;
+        plan: Array<{
+            step: string;
+            status: "pending" | "inProgress" | "completed";
+        }>;
+    };
+    "turn.proposed.delta": {
+        delta: string;
+    };
+    "turn.proposed.completed": {
+        planMarkdown: string;
+    };
+    "turn.diff.updated": {
+        unifiedDiff: string;
+    };
+    "item.started": ItemLifecyclePayload;
+    "item.updated": ItemLifecyclePayload;
+    "item.completed": ItemLifecyclePayload;
+    "content.delta": {
+        streamKind: ContentStreamKind;
+        delta: string;
+        contentIndex?: number;
+    };
+    "request.opened": {
+        requestType: CanonicalRequestType;
+        detail?: string;
+        args?: unknown;
+        options?: Array<{
+            decision: ApprovalDecision;
+            label: string;
+        }>;
+    };
+    "request.resolved": {
+        requestType: CanonicalRequestType;
+        decision?: string;
+    };
+    /**
+     * Questions for the person. "tool" (default): the turn waits and the answer
+     * goes back through respondToUserInput. "message": the turn has ended and the
+     * person answers with their next message (Codex async questions).
+     */
+    "user-input.requested": {
+        questions: UserInputQuestion[];
+        responseMode?: "tool" | "message";
+    };
+    "user-input.resolved": {
+        answers: UserInputAnswers;
+    };
+    "account.rate-limits.updated": {
+        windows: RateLimitWindow[];
+        reached?: string | null;
+    };
+    "model.rerouted": {
+        fromModel: string;
+        toModel: string;
+        reason?: string;
+    };
+    "config.warning": {
+        summary: string;
+        details?: string;
+    };
+    "runtime.warning": {
+        message: string;
+        detail?: unknown;
+        retrying?: boolean;
+    };
+    "runtime.error": {
+        message: string;
+        class?: "provider_error" | "transport_error" | "permission_error" | "validation_error" | "unknown";
+        detail?: unknown;
+    };
+}
+export type RuntimeEventType = keyof RuntimeEventPayloads;
+interface RuntimeEventBase {
+    eventId: string;
+    provider: ProviderKind;
+    instanceId: InstanceId;
+    threadId: ThreadId;
+    /** Epoch ms. */
+    createdAt: number;
+    turnId?: TurnId;
+    itemId?: ItemId;
+    requestId?: RequestId;
+    /** Native ids, for correlation and debugging. */
+    providerRefs?: {
+        providerTurnId?: string;
+        providerItemId?: string;
+        providerRequestId?: string;
+    };
+    /** The native message, when kept for debugging. Never interpreted above the adapter. */
+    raw?: {
+        source: string;
+        method?: string;
+        payload: unknown;
+    };
+}
+export type ProviderRuntimeEvent = {
+    [K in RuntimeEventType]: RuntimeEventBase & {
+        type: K;
+        payload: RuntimeEventPayloads[K];
+    };
+}[RuntimeEventType];
+export type RuntimeEventOf<K extends RuntimeEventType> = Extract<ProviderRuntimeEvent, {
+    type: K;
+}>;
+/** Loom's permission mode (core/permissions.ts) as a runtime mode, and back. */
+export declare const RUNTIME_MODE_BY_PERMISSION: {
+    readonly bypass: "full-access";
+    readonly auto: "auto-accept-edits";
+    readonly ask: "approval-required";
+};
+export declare const runtimeModeFor: (permission: "bypass" | "auto" | "ask") => RuntimeMode;
+export {};

package/dist/providers/contracts.js

@@ -0,0 +1,19 @@
+/**
+ * The provider contract: what a harness session is, what a turn takes, and the
+ * one canonical runtime event stream every adapter emits.
+ *
+ * Ported from t3code (MIT, © T3 Tools Inc.):
+ *   packages/contracts/src/provider.ts, providerRuntime.ts, orchestration.ts
+ * as plain TypeScript, reduced to what Codex and Claude Code need. Names and
+ * shapes follow t3code so later phases can keep porting without remapping.
+ *
+ * Vocabulary (see docs/refactoring/T3-PORT-NOTES.md): a t3code *thread* is a
+ * Loom chat, and a provider *instance* is a Loom agent config entry. Loom keys
+ * a session by (thread, instance), because a chat can switch provider.
+ */
+export const PROVIDER_KINDS = ["codex", "claude-code"];
+export const isProviderKind = (value) => PROVIDER_KINDS.includes(value);
+/** Loom's permission mode (core/permissions.ts) as a runtime mode, and back. */
+export const RUNTIME_MODE_BY_PERMISSION = { bypass: "full-access", auto: "auto-accept-edits", ask: "approval-required" };
+export const runtimeModeFor = (permission) => RUNTIME_MODE_BY_PERMISSION[permission];
+//# sourceMappingURL=contracts.js.map

package/dist/providers/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/providers/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,MAAM,CAAC,MAAM,cAAc,GAA4B,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;AAChF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAyB,EAAE,CACpE,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAoOxD,gFAAgF;AAChF,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,EAAE,mBAAmB,EAAW,CAAC;AAClI,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAqC,EAAe,EAAE,CAAC,0BAA0B,CAAC,UAAU,CAAC,CAAC"}

package/dist/providers/directory.d.ts

@@ -0,0 +1,70 @@
+/**
+ * The provider session directory: which native session a (chat, agent) pair is
+ * bound to, and what resumes it once its process is gone.
+ *
+ * Ported from t3code's provider/Services/ProviderSessionDirectory.ts (MIT,
+ * © T3 Tools Inc.). Differences: keyed by (thread, instance) instead of thread
+ * alone (Loom switches provider within a chat), and stored as one JSON file
+ * under `.loom/providers/` rather than a SQLite table, because Loom's event log
+ * has a JSONL fallback and this must work with either. Stopped bindings are
+ * kept: their resume cursor is how a reaped or restarted session comes back.
+ */
+import type { InstanceId, ProviderKind, RuntimeMode, ThreadId } from "./contracts.js";
+export type BindingStatus = "starting" | "running" | "stopped" | "error";
+export interface ProviderBinding {
+    threadId: ThreadId;
+    instanceId: InstanceId;
+    provider: ProviderKind;
+    status: BindingStatus;
+    /** The native thread/session id. */
+    resumeCursor: unknown | null;
+    /** What the session was started with, to restart it the same way. */
+    runtimePayload: {
+        cwd?: string;
+        model?: string;
+    } | null;
+    runtimeMode: RuntimeMode;
+    /** Epoch ms of the last start, turn or activity. */
+    lastSeenAt: number;
+}
+export interface SessionDirectory {
+    get(threadId: ThreadId, instanceId: InstanceId): ProviderBinding | undefined;
+    /** Insert or merge; `lastSeenAt` defaults to now. */
+    upsert(binding: Omit<ProviderBinding, "lastSeenAt"> & {
+        lastSeenAt?: number;
+    }): ProviderBinding;
+    /** Mark activity without changing anything else. */
+    touch(threadId: ThreadId, instanceId: InstanceId, at?: number): void;
+    list(options?: {
+        excludeStopped?: boolean;
+        threadId?: ThreadId;
+    }): ProviderBinding[];
+    remove(threadId: ThreadId, instanceId: InstanceId): void;
+}
+export declare class MemorySessionDirectory implements SessionDirectory {
+    protected readonly rows: Map<string, ProviderBinding>;
+    get(threadId: ThreadId, instanceId: InstanceId): ProviderBinding | undefined;
+    upsert(binding: Omit<ProviderBinding, "lastSeenAt"> & {
+        lastSeenAt?: number;
+    }): ProviderBinding;
+    touch(threadId: ThreadId, instanceId: InstanceId, at?: number): void;
+    list(options?: {
+        excludeStopped?: boolean;
+        threadId?: ThreadId;
+    }): ProviderBinding[];
+    remove(threadId: ThreadId, instanceId: InstanceId): void;
+    protected changed(): void;
+}
+/**
+ * The directory persisted to `<loomDir>/providers/sessions.json`, written
+ * atomically (temp file + rename) on every change. A file that can't be read
+ * is moved aside, never overwritten, and the directory starts empty: losing
+ * resume cursors means a fresh native session, not a broken project.
+ */
+export declare class FileSessionDirectory extends MemorySessionDirectory {
+    private readonly warn;
+    readonly file: string;
+    constructor(loomDir: string, warn?: (message: string) => void);
+    private load;
+    protected changed(): void;
+}

package/dist/providers/directory.js

@@ -0,0 +1,95 @@
+/**
+ * The provider session directory: which native session a (chat, agent) pair is
+ * bound to, and what resumes it once its process is gone.
+ *
+ * Ported from t3code's provider/Services/ProviderSessionDirectory.ts (MIT,
+ * © T3 Tools Inc.). Differences: keyed by (thread, instance) instead of thread
+ * alone (Loom switches provider within a chat), and stored as one JSON file
+ * under `.loom/providers/` rather than a SQLite table, because Loom's event log
+ * has a JSONL fallback and this must work with either. Stopped bindings are
+ * kept: their resume cursor is how a reaped or restarted session comes back.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+const key = (threadId, instanceId) => `${threadId}\u0000${instanceId}`;
+export class MemorySessionDirectory {
+    rows = new Map();
+    get(threadId, instanceId) {
+        const row = this.rows.get(key(threadId, instanceId));
+        return row ? { ...row } : undefined;
+    }
+    upsert(binding) {
+        const row = { ...binding, lastSeenAt: binding.lastSeenAt ?? Date.now() };
+        this.rows.set(key(row.threadId, row.instanceId), row);
+        this.changed();
+        return { ...row };
+    }
+    touch(threadId, instanceId, at = Date.now()) {
+        const row = this.rows.get(key(threadId, instanceId));
+        if (!row)
+            return;
+        row.lastSeenAt = Math.max(row.lastSeenAt, at);
+        this.changed();
+    }
+    list(options = {}) {
+        return [...this.rows.values()]
+            .filter(r => (!options.excludeStopped || r.status !== "stopped") && (options.threadId === undefined || r.threadId === options.threadId))
+            .map(r => ({ ...r }));
+    }
+    remove(threadId, instanceId) {
+        if (this.rows.delete(key(threadId, instanceId)))
+            this.changed();
+    }
+    changed() { }
+}
+const BindingFile = z.object({
+    version: z.literal(1),
+    bindings: z.array(z.object({
+        threadId: z.string().min(1), instanceId: z.string().min(1), provider: z.enum(["codex", "claude-code"]),
+        status: z.enum(["starting", "running", "stopped", "error"]), resumeCursor: z.unknown().nullable(),
+        runtimePayload: z.object({ cwd: z.string().optional(), model: z.string().optional() }).nullable(),
+        runtimeMode: z.enum(["approval-required", "auto-accept-edits", "full-access"]), lastSeenAt: z.number(),
+    })),
+});
+/**
+ * The directory persisted to `<loomDir>/providers/sessions.json`, written
+ * atomically (temp file + rename) on every change. A file that can't be read
+ * is moved aside, never overwritten, and the directory starts empty: losing
+ * resume cursors means a fresh native session, not a broken project.
+ */
+export class FileSessionDirectory extends MemorySessionDirectory {
+    warn;
+    file;
+    constructor(loomDir, warn = () => { }) {
+        super();
+        this.warn = warn;
+        this.file = path.join(loomDir, "providers", "sessions.json");
+        this.load();
+    }
+    load() {
+        if (!fs.existsSync(this.file))
+            return;
+        try {
+            const parsed = BindingFile.parse(JSON.parse(fs.readFileSync(this.file, "utf8")));
+            for (const b of parsed.bindings)
+                this.rows.set(key(b.threadId, b.instanceId), b);
+        }
+        catch (error) {
+            const aside = `${this.file}.unreadable.${randomUUID()}`;
+            try {
+                fs.renameSync(this.file, aside);
+            }
+            catch { /* reported below either way */ }
+            this.warn(`provider session directory was unreadable and was moved to ${path.basename(aside)}: ${error.message}`);
+        }
+    }
+    changed() {
+        fs.mkdirSync(path.dirname(this.file), { recursive: true });
+        const tmp = `${this.file}.${process.pid}.${randomUUID()}.tmp`;
+        fs.writeFileSync(tmp, JSON.stringify({ version: 1, bindings: [...this.rows.values()] }, null, 1), { mode: 0o600 });
+        fs.renameSync(tmp, this.file);
+    }
+}
+//# sourceMappingURL=directory.js.map

package/dist/providers/directory.js.map

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

package/dist/providers/errors.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Provider errors. Each says which operation failed and whether a native turn
+ * could have started, which is what the caller (Brain above all) needs to know.
+ *
+ * Shaped after t3code's provider/Errors.ts (MIT, © T3 Tools Inc.).
+ */
+import type { InstanceId, ProviderKind, ThreadId } from "./contracts.js";
+export type ProviderErrorCode = 
+/** The input was wrong; nothing was sent. */
+"validation"
+/** No instance, adapter or session to route to; nothing was sent. */
+ | "not_found"
+/** The native session to resume is gone; nothing was sent. */
+ | "session_missing"
+/** The adapter doesn't support this operation. */
+ | "unsupported"
+/** The provider refused or failed the request. `mayHaveStarted` says whether a turn could exist. */
+ | "request"
+/** The process or connection failed. */
+ | "transport";
+export declare class ProviderError extends Error {
+    readonly code: ProviderErrorCode;
+    readonly operation: string;
+    readonly details: {
+        provider?: ProviderKind;
+        instanceId?: InstanceId;
+        threadId?: ThreadId;
+        /** True when a native turn may exist despite the error (outcome unknown). */
+        mayHaveStarted?: boolean;
+        cause?: unknown;
+        /** The harness's recent stderr, when it explains the failure. */
+        stderr?: string;
+    };
+    constructor(code: ProviderErrorCode, operation: string, message: string, details?: {
+        provider?: ProviderKind;
+        instanceId?: InstanceId;
+        threadId?: ThreadId;
+        /** True when a native turn may exist despite the error (outcome unknown). */
+        mayHaveStarted?: boolean;
+        cause?: unknown;
+        /** The harness's recent stderr, when it explains the failure. */
+        stderr?: string;
+    });
+    /** Nothing reached the provider as a turn: safe to retry or rebuild. */
+    get notSubmitted(): boolean;
+}
+export declare const isProviderError: (error: unknown, code?: ProviderErrorCode) => error is ProviderError;

package/dist/providers/errors.js

@@ -0,0 +1,24 @@
+/**
+ * Provider errors. Each says which operation failed and whether a native turn
+ * could have started, which is what the caller (Brain above all) needs to know.
+ *
+ * Shaped after t3code's provider/Errors.ts (MIT, © T3 Tools Inc.).
+ */
+export class ProviderError extends Error {
+    code;
+    operation;
+    details;
+    constructor(code, operation, message, details = {}) {
+        super(message);
+        this.code = code;
+        this.operation = operation;
+        this.details = details;
+        this.name = "ProviderError";
+    }
+    /** Nothing reached the provider as a turn: safe to retry or rebuild. */
+    get notSubmitted() {
+        return this.code !== "request" && this.code !== "transport" ? true : this.details.mayHaveStarted === false;
+    }
+}
+export const isProviderError = (error, code) => error instanceof ProviderError && (code === undefined || error.code === code);
+//# sourceMappingURL=errors.js.map

package/dist/providers/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/providers/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAE3B;IACA;IAEA;IAJX,YACW,IAAuB,EACvB,SAAiB,EAC1B,OAAe,EACN,UAIa,EAAE;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;QATN,SAAI,GAAJ,IAAI,CAAmB;QACvB,cAAS,GAAT,SAAS,CAAQ;QAEjB,YAAO,GAAP,OAAO,CAIQ;QAGxB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;IAED,wEAAwE;IACxE,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,KAAK,KAAK,CAAC;IAC7G,CAAC;CACF;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAc,EAAE,IAAwB,EAA0B,EAAE,CAClG,KAAK,YAAY,aAAa,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC"}

package/dist/providers/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Provider layer: the adapter contract, the service that routes (chat, agent)
+ * to live sessions, the session directory and reaper, and ingestion into
+ * Loom's log. Ported from t3code's provider core; see
+ * docs/proposals/t3code-port.md and docs/refactoring/T3-PORT-NOTES.md.
+ */
+export * from "./contracts.js";
+export * from "./errors.js";
+export { EventHub, type ProviderAdapter, type RuntimeEventListener } from "./adapter.js";
+export { FileSessionDirectory, MemorySessionDirectory, type ProviderBinding, type SessionDirectory } from "./directory.js";
+export { ProviderService, type EnsureSessionInput, type EnsuredSession } from "./service.js";
+export { SessionReaper, DEFAULT_INACTIVITY_MS, DEFAULT_SWEEP_MS } from "./reaper.js";
+export { RuntimeIngestion, type IngestedEvent, type LiveDelta, type TurnTags } from "./ingestion.js";
+export { ApprovalBridge } from "./approvals.js";
+export * from "./live.js";
+export { ProviderAgent, stopAllProviderSessions } from "./agent.js";
+export { CodexProviderAdapter, codexBin } from "./codex/adapter.js";
+export { ClaudeProviderAdapter, claudeBin } from "./claude/adapter.js";

package/dist/providers/index.js

@@ -0,0 +1,19 @@
+/**
+ * Provider layer: the adapter contract, the service that routes (chat, agent)
+ * to live sessions, the session directory and reaper, and ingestion into
+ * Loom's log. Ported from t3code's provider core; see
+ * docs/proposals/t3code-port.md and docs/refactoring/T3-PORT-NOTES.md.
+ */
+export * from "./contracts.js";
+export * from "./errors.js";
+export { EventHub } from "./adapter.js";
+export { FileSessionDirectory, MemorySessionDirectory } from "./directory.js";
+export { ProviderService } from "./service.js";
+export { SessionReaper, DEFAULT_INACTIVITY_MS, DEFAULT_SWEEP_MS } from "./reaper.js";
+export { RuntimeIngestion } from "./ingestion.js";
+export { ApprovalBridge } from "./approvals.js";
+export * from "./live.js";
+export { ProviderAgent, stopAllProviderSessions } from "./agent.js";
+export { CodexProviderAdapter, codexBin } from "./codex/adapter.js";
+export { ClaudeProviderAdapter, claudeBin } from "./claude/adapter.js";
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAmD,MAAM,cAAc,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAA+C,MAAM,gBAAgB,CAAC;AAC3H,OAAO,EAAE,eAAe,EAAgD,MAAM,cAAc,CAAC;AAC7F,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAqD,MAAM,gBAAgB,CAAC;AACrG,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC"}