@geminilight/mindos 1.1.26 → 1.1.30

package/dist/agent/ledger/run-ledger-types.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Agent run ledger contract: run records, event taxonomy, and the input
+ * shapes used to start/update/complete runs. Pure types — the ledger
+ * implementation itself sinks from the web package in a later wave, but the
+ * contract lives here so policy/reducer modules (and external consumers)
+ * never depend on the web package.
+ */
+export type AgentNodeKind = 'mindos-main' | 'mindos-headless' | 'native-runtime' | 'pi-subagent' | 'acp' | 'a2a';
+export type AgentRunStatus = 'queued' | 'running' | 'streaming' | 'completed' | 'failed' | 'canceled' | 'timed_out';
+export type AgentRunPermissionMode = 'readonly' | 'organize' | 'agent';
+/**
+ * Pointer to the runtime's own conversation archive. Each runtime keeps its
+ * own full transcript (Claude Code under ~/.claude, Codex under ~/.codex);
+ * the ledger is only an index card across runtimes, so it stores a pointer
+ * instead of re-saving content. Embedded pi currently runs with
+ * `SessionManager.inMemory()` — no archive file, so its runs carry no ref.
+ */
+export interface AgentRunArchiveRef {
+    /** Runtime-side session/conversation id (Claude session id, Codex thread id). */
+    sessionId?: string;
+    /** Path to the runtime's own transcript file, when the runtime exposes one. */
+    path?: string;
+}
+export interface AgentRunRecord {
+    id: string;
+    rootRunId?: string;
+    parentRunId?: string;
+    chatSessionId?: string;
+    agentKind: AgentNodeKind;
+    runtimeId: string;
+    displayName: string;
+    status: AgentRunStatus;
+    cwd?: string;
+    permissionMode: AgentRunPermissionMode;
+    inputSummary: string;
+    outputSummary?: string;
+    error?: string;
+    startedAt: number;
+    completedAt?: number;
+    durationMs?: number;
+    archive?: AgentRunArchiveRef;
+    metadata?: Record<string, unknown>;
+}
+export type AgentEventType = 'run_started' | 'run_updated' | 'run_completed' | 'run_failed' | 'run_canceled' | 'status' | 'text' | 'tool' | 'tool_started' | 'tool_updated' | 'tool_completed' | 'file' | 'file_changed' | 'permission' | 'permission_requested' | 'permission_resolved' | 'user_question_started' | 'user_question_resolved' | 'runtime_status' | 'error';
+export type AgentEventVisibility = 'timeline' | 'debug';
+export type AgentEventCategory = 'status' | 'text' | 'tool' | 'file' | 'permission' | 'question' | 'error';
+export type AgentEventData = {
+    kind: 'status';
+    previousStatus?: AgentRunStatus;
+    nextStatus: AgentRunStatus;
+    summary?: string;
+} | {
+    kind: 'text';
+    text: string;
+    channel?: 'assistant' | 'reasoning' | 'stdout' | 'stderr' | 'system';
+} | {
+    kind: 'tool';
+    name: string;
+    status?: 'started' | 'running' | 'completed' | 'failed' | 'canceled';
+    inputSummary?: string;
+    outputSummary?: string;
+    error?: string;
+} | {
+    kind: 'file';
+    path: string;
+    action: 'read' | 'created' | 'updated' | 'deleted' | 'renamed' | 'diff' | 'unknown';
+    status?: 'started' | 'completed' | 'failed';
+    summary?: string;
+} | {
+    kind: 'permission';
+    action: string;
+    status: 'requested' | 'approved' | 'denied' | 'expired' | 'skipped';
+    requestId?: string;
+    resource?: string;
+    prompt?: string;
+    decision?: string;
+    decisionLabel?: string;
+    decisionIntent?: 'allow' | 'deny' | 'cancel';
+    decisionScope?: 'once' | 'session' | 'always' | 'turn';
+    options?: Array<{
+        id: string;
+        label: string;
+        intent?: 'allow' | 'deny' | 'cancel';
+        scope?: 'once' | 'session' | 'always' | 'turn';
+    }>;
+    risk?: {
+        level: 'low' | 'medium' | 'high';
+        summary: string;
+        reasons?: string[];
+    };
+} | {
+    kind: 'question';
+    status: 'requested' | 'answered' | 'cancelled';
+    prompt?: string;
+    summary?: string;
+} | {
+    kind: 'error';
+    message: string;
+    code?: string;
+    recoverable?: boolean;
+};
+export interface AppendAgentEventInput {
+    type: AgentEventType;
+    status?: AgentRunStatus;
+    message?: unknown;
+    category?: AgentEventCategory;
+    data?: AgentEventData;
+    title?: string;
+    toolCallId?: string;
+    toolName?: string;
+    filePath?: string;
+    runtime?: string;
+    visibility?: AgentEventVisibility;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentEvent {
+    id: string;
+    runId: string;
+    type: AgentEventType;
+    category: AgentEventCategory;
+    ts: number;
+    status: AgentRunStatus;
+    record: AgentRunRecord;
+    message?: string;
+    data?: AgentEventData;
+    title?: string;
+    toolCallId?: string;
+    toolName?: string;
+    filePath?: string;
+    runtime?: string;
+    visibility?: AgentEventVisibility;
+    metadata?: Record<string, unknown>;
+}
+export interface StartAgentRunInput {
+    id?: string;
+    rootRunId?: string;
+    parentRunId?: string;
+    chatSessionId?: string;
+    agentKind: AgentNodeKind;
+    runtimeId: string;
+    displayName: string;
+    status?: Extract<AgentRunStatus, 'queued' | 'running' | 'streaming'>;
+    cwd?: string;
+    permissionMode?: AgentRunPermissionMode;
+    inputSummary: string;
+    archive?: AgentRunArchiveRef;
+    metadata?: Record<string, unknown>;
+}
+export interface CompleteAgentRunInput {
+    outputSummary?: string;
+    archive?: AgentRunArchiveRef;
+    metadata?: Record<string, unknown>;
+}
+export interface FailAgentRunInput {
+    error: unknown;
+    outputSummary?: string;
+    status?: Extract<AgentRunStatus, 'failed' | 'canceled' | 'timed_out'>;
+    archive?: AgentRunArchiveRef;
+    metadata?: Record<string, unknown>;
+}
+export interface CancelAgentRunInput {
+    reason?: unknown;
+    outputSummary?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateAgentRunInput {
+    displayName?: string;
+    runtimeId?: string;
+    cwd?: string;
+    permissionMode?: AgentRunPermissionMode;
+    inputSummary?: string;
+    outputSummary?: string;
+    error?: string;
+    status?: AgentRunStatus;
+    archive?: AgentRunArchiveRef;
+    metadata?: Record<string, unknown>;
+}
+export interface ListAgentRunsOptions {
+    runId?: string;
+    rootRunId?: string;
+    kind?: AgentNodeKind;
+    status?: AgentRunStatus;
+    parentRunId?: string;
+    chatSessionId?: string;
+    startedAfter?: number;
+    limit?: number;
+}
+export interface ListAgentEventsOptions {
+    runId?: string;
+    rootRunId?: string;
+    chatSessionId?: string;
+    type?: AgentEventType;
+    category?: AgentEventCategory;
+    startedAfter?: number;
+    limit?: number;
+}
+//# sourceMappingURL=run-ledger-types.d.ts.map

package/dist/agent/ledger/run-ledger-types.d.ts.map

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

package/dist/agent/ledger/run-ledger-types.js

@@ -0,0 +1,9 @@
+/**
+ * Agent run ledger contract: run records, event taxonomy, and the input
+ * shapes used to start/update/complete runs. Pure types — the ledger
+ * implementation itself sinks from the web package in a later wave, but the
+ * contract lives here so policy/reducer modules (and external consumers)
+ * never depend on the web package.
+ */
+export {};
+//# sourceMappingURL=run-ledger-types.js.map

package/dist/agent/ledger/run-ledger-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-ledger-types.js","sourceRoot":"","sources":["../../../src/agent/ledger/run-ledger-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/agent/ledger/run-ledger.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Cross-runtime agent run ledger — an INDEX CARD store, not a transcript
+ * store (spec-agent-core-consolidation B.1/C).
+ *
+ * Each runtime keeps its own full archive (Claude Code: ~/.claude, Codex:
+ * ~/.codex, embedded pi: in-memory session injected per request). The ledger
+ * persists only run records — id / kind / status / parent-child links /
+ * timestamps / capped summaries / an `archive` pointer into the runtime's
+ * own archive. Fine-grained timeline events still flow through the in-memory
+ * store and realtime subscribers for live UI, but are NOT written to disk;
+ * after a restart the UI can list runs and their terminal state (the ledger's
+ * minimal crash-survival contract), not replay old timelines.
+ *
+ * Persistence model — one shard per process, no shared writers:
+ *   <mindRoot>/.mindos/agent-run-ledger.<pid>-<startTs>.jsonl
+ * Reads scan the directory and merge every shard plus the two legacy files
+ * (agent-run-ledger.json v1, agent-run-ledger.jsonl v2), which are read-only
+ * and never written again. Compaction rewrites ONLY this process's shard —
+ * single writer per file, so no cross-process locking exists or is needed.
+ * Nothing in this module may rewrite a file another process wrote.
+ */
+export * from './run-ledger-types.js';
+import type { AgentEvent, AgentRunPermissionMode, AgentRunRecord, AppendAgentEventInput, CancelAgentRunInput, CompleteAgentRunInput, FailAgentRunInput, ListAgentEventsOptions, ListAgentRunsOptions, StartAgentRunInput, UpdateAgentRunInput } from './run-ledger-types.js';
+export type AgentRunEventSubscriber = (event: AgentEvent) => void;
+export declare function appendAgentRunEvent(runId: string, input: AppendAgentEventInput): AgentEvent | undefined;
+export declare function startAgentRun(input: StartAgentRunInput): AgentRunRecord;
+export declare function updateAgentRun(id: string, input: UpdateAgentRunInput): AgentRunRecord | undefined;
+export declare function completeAgentRun(id: string, input?: CompleteAgentRunInput): AgentRunRecord | undefined;
+export declare function failAgentRun(id: string, input: FailAgentRunInput): AgentRunRecord | undefined;
+export declare function cancelAgentRun(id: string, input?: CancelAgentRunInput): AgentRunRecord | undefined;
+export declare function getAgentRun(id: string): AgentRunRecord | undefined;
+export declare function listAgentRuns(options?: ListAgentRunsOptions): AgentRunRecord[];
+export declare function listAgentEvents(options?: ListAgentEventsOptions): AgentEvent[];
+export declare function subscribeAgentRunEvents(subscriber: AgentRunEventSubscriber): () => void;
+export declare function coerceAgentRunPermissionMode(mode: unknown): AgentRunPermissionMode;
+/**
+ * Test-only: clear memory and delete every ledger file under the current
+ * mind root — shards of other (test) processes and legacy files included.
+ * Production code must never delete foreign shards; tests need a clean slate.
+ */
+export declare function resetAgentRunsForTest(): void;
+/** Test-only: drop the in-memory store so the next access re-merges from disk. */
+export declare function reloadAgentRunsFromDiskForTest(): void;
+//# sourceMappingURL=run-ledger.d.ts.map

package/dist/agent/ledger/run-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-ledger.d.ts","sourceRoot":"","sources":["../../../src/agent/ledger/run-ledger.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,cAAc,uBAAuB,CAAC;AACtC,OAAO,KAAK,EACV,UAAU,EAKV,sBAAsB,EACtB,cAAc,EAEd,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAW/B,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;AA8mBlE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,UAAU,GAAG,SAAS,CAIvG;AAoCD,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,cAAc,CAiCvE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,cAAc,GAAG,SAAS,CAwBjG;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,GAAE,qBAA0B,GAAG,cAAc,GAAG,SAAS,CAO1G;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,cAAc,GAAG,SAAS,CAQ7F;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,GAAE,mBAAwB,GAAG,cAAc,GAAG,SAAS,CAOtG;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAElE;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,cAAc,EAAE,CAWlF;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,UAAU,EAAE,CAUlF;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,uBAAuB,GAAG,MAAM,IAAI,CAMvF;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,OAAO,GAAG,sBAAsB,CAElF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAiB5C;AAED,kFAAkF;AAClF,wBAAgB,8BAA8B,IAAI,IAAI,CAErD"}