@hasna/todos 0.11.49 → 0.11.51

package/dist/json-contracts.d.ts

@@ -0,0 +1,56 @@
+export type TodosJsonSurface = "cli" | "api" | "mcp" | "sdk";
+export type TodosJsonStability = "stable" | "experimental";
+export type TodosJsonFieldType = "array" | "boolean" | "integer" | "null" | "number" | "object" | "string";
+export interface CreateJsonContractsManifestOptions {
+    version?: string;
+    generatedAt?: string;
+}
+export interface TodosJsonContractPackageSource {
+    packageName: "@hasna/todos";
+    repository: "hasna/todos";
+    version: string;
+}
+export interface TodosJsonFieldContract {
+    type: TodosJsonFieldType | readonly TodosJsonFieldType[];
+    description: string;
+    nullable?: boolean;
+}
+export interface TodosJsonObjectContract {
+    id: string;
+    name: string;
+    description: string;
+    surfaces: TodosJsonSurface[];
+    stability: TodosJsonStability;
+    required: Record<string, TodosJsonFieldContract>;
+    optional: Record<string, TodosJsonFieldContract>;
+    additionalProperties: true;
+    evolution: {
+        additionalFields: "allowed";
+        removingRequiredFields: "breaking";
+        changingRequiredFieldTypes: "breaking";
+        nullableToNonNullable: "breaking";
+    };
+}
+export interface TodosJsonContractsManifest {
+    schemaVersion: 1;
+    generatedAt: string;
+    package: TodosJsonContractPackageSource;
+    contracts: TodosJsonObjectContract[];
+}
+export interface JsonContractValidationIssue {
+    field: string;
+    expected: readonly TodosJsonFieldType[];
+    actual: string;
+}
+export interface JsonContractValidationResult {
+    ok: boolean;
+    contractId: string;
+    missingRequired: string[];
+    typeMismatches: JsonContractValidationIssue[];
+}
+export declare const TODOS_JSON_CONTRACTS: TodosJsonObjectContract[];
+export declare function getJsonContract(contractId: string): TodosJsonObjectContract | null;
+export declare function validateJsonContract(contractId: string, value: unknown): JsonContractValidationResult;
+export declare function createJsonContractsManifest(options?: CreateJsonContractsManifestOptions): TodosJsonContractsManifest;
+export declare const TODOS_JSON_CONTRACTS_MANIFEST: TodosJsonContractsManifest;
+//# sourceMappingURL=json-contracts.d.ts.map

package/dist/json-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-contracts.d.ts","sourceRoot":"","sources":["../src/json-contracts.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAC7D,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,cAAc,CAAC;AAC3D,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3G,MAAM,WAAW,kCAAkC;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,cAAc,CAAC;IAC5B,UAAU,EAAE,aAAa,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,kBAAkB,GAAG,SAAS,kBAAkB,EAAE,CAAC;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACjD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACjD,oBAAoB,EAAE,IAAI,CAAC;IAC3B,SAAS,EAAE;QACT,gBAAgB,EAAE,SAAS,CAAC;QAC5B,sBAAsB,EAAE,UAAU,CAAC;QACnC,0BAA0B,EAAE,UAAU,CAAC;QACvC,qBAAqB,EAAE,UAAU,CAAC;KACnC,CAAC;CACH;AAED,MAAM,WAAW,0BAA0B;IACzC,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,8BAA8B,CAAC;IACxC,SAAS,EAAE,uBAAuB,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,2BAA2B,EAAE,CAAC;CAC/C;AAsCD,eAAO,MAAM,oBAAoB,EAAE,uBAAuB,EAmzDzD,CAAC;AAyBF,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,uBAAuB,GAAG,IAAI,CAElF;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,4BAA4B,CA8BrG;AAED,wBAAgB,2BAA2B,CACzC,OAAO,GAAE,kCAAuC,GAC/C,0BAA0B,CAQ5B;AAED,eAAO,MAAM,6BAA6B,4BAExC,CAAC"}

package/dist/lib/access-profiles.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Local access profiles for CLI, MCP, SDK, and optional HTTP server.
+ */
+export declare const ACCESS_PROFILE_SCHEMA = "todos.access_profile.v1";
+export declare const ACCESS_PROFILES: readonly ["read_only", "agent_safe", "minimal", "standard", "full", "admin"];
+export type AccessProfile = (typeof ACCESS_PROFILES)[number];
+export interface AccessProfileMeta {
+    name: AccessProfile;
+    description: string;
+    surfaces: Array<"cli" | "mcp" | "sdk" | "http">;
+    allows_mutations: boolean;
+    allows_admin: boolean;
+}
+export declare const READ_ONLY_TOOLS: Set<string>;
+export declare const MINIMAL_TOOLS: Set<string>;
+export declare const AGENT_SAFE_TOOLS: Set<string>;
+export declare const STANDARD_EXCLUDED: Set<string>;
+export declare const ADMIN_ONLY_TOOLS: Set<string>;
+export declare const DANGEROUS_TOOLS: Set<string>;
+export declare function resolveAccessProfile(envValue?: string): AccessProfile;
+export declare function getAccessProfileMeta(profile?: AccessProfile): AccessProfileMeta;
+export declare function listAccessProfiles(): AccessProfileMeta[];
+export declare function shouldRegisterToolForProfile(toolName: string, profile?: AccessProfile): boolean;
+export declare function assertToolAllowed(toolName: string, profile?: AccessProfile): void;
+export declare function getProfileToolCount(profile: AccessProfile, allTools: string[]): number;
+export declare function getHeadlessUsageNotes(profile?: AccessProfile): string[];
+//# sourceMappingURL=access-profiles.d.ts.map

package/dist/lib/access-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access-profiles.d.ts","sourceRoot":"","sources":["../../src/lib/access-profiles.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAE/D,eAAO,MAAM,eAAe,8EAA+E,CAAC;AAC5G,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC;IAChD,gBAAgB,EAAE,OAAO,CAAC;IAC1B,YAAY,EAAE,OAAO,CAAC;CACvB;AA+CD,eAAO,MAAM,eAAe,aAgB1B,CAAC;AAEH,eAAO,MAAM,aAAa,aAIxB,CAAC;AAEH,eAAO,MAAM,gBAAgB,aAQ3B,CAAC;AAEH,eAAO,MAAM,iBAAiB,aAM5B,CAAC;AAEH,eAAO,MAAM,gBAAgB,aAI3B,CAAC;AAEH,eAAO,MAAM,eAAe,aAG1B,CAAC;AAEH,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,aAAa,CAOrE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,iBAAiB,CAE/E;AAED,wBAAgB,kBAAkB,IAAI,iBAAiB,EAAE,CAExD;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAmB/F;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAOjF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAEtF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,EAAE,CASvE"}

package/dist/lib/activity-audit.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Append-only activity log for tasks, projects, plans, runs, and comments.
+ * Local SQLite storage with redaction and export/import compatibility.
+ */
+import type { Database } from "bun:sqlite";
+export declare const ACTIVITY_LOG_SCHEMA = "todos.activity_log.v1";
+export declare const ACTIVITY_ENTITY_TYPES: readonly ["task", "project", "plan", "agent_run", "run_record", "comment", "session"];
+export type ActivityEntityType = (typeof ACTIVITY_ENTITY_TYPES)[number];
+export interface ActivityRecord {
+    schema_version: typeof ACTIVITY_LOG_SCHEMA;
+    id: string;
+    entity_type: ActivityEntityType;
+    entity_id: string;
+    action: string;
+    field: string | null;
+    old_value: string | null;
+    new_value: string | null;
+    actor_id: string | null;
+    session_id: string | null;
+    machine_id: string | null;
+    metadata: Record<string, unknown>;
+    created_at: string;
+}
+export interface LogActivityInput {
+    entity_type: ActivityEntityType;
+    entity_id: string;
+    action: string;
+    field?: string;
+    old_value?: string | null;
+    new_value?: string | null;
+    actor_id?: string;
+    session_id?: string;
+    machine_id?: string;
+    metadata?: Record<string, unknown>;
+    /** Override timestamp (tests/internal) */
+    created_at?: string;
+}
+export interface ListActivityFilter {
+    entity_type?: ActivityEntityType;
+    entity_id?: string;
+    actor_id?: string;
+    action?: string;
+    since?: string;
+    until?: string;
+    limit?: number;
+    offset?: number;
+    order?: "asc" | "desc";
+}
+export interface ActivityExportBundle {
+    schema_version: typeof ACTIVITY_LOG_SCHEMA;
+    exported_at: string;
+    records: ActivityRecord[];
+}
+export declare function redactActivityRecord(record: ActivityRecord): ActivityRecord;
+export declare function logActivity(input: LogActivityInput, db?: Database): ActivityRecord;
+export declare function getActivityRecord(id: string, db?: Database): ActivityRecord | null;
+export declare function listActivity(filter?: ListActivityFilter, db?: Database): ActivityRecord[];
+export declare function getActivityTimeline(entityType: ActivityEntityType, entityId: string, db?: Database): ActivityRecord[];
+export declare function exportActivityLog(filter?: ListActivityFilter, db?: Database): ActivityExportBundle;
+export declare function importActivityLog(bundle: ActivityExportBundle, options?: {
+    skip_existing?: boolean;
+}, db?: Database): {
+    imported: number;
+    skipped: number;
+};
+export declare function formatActivityRecordText(record: ActivityRecord): string;
+//# sourceMappingURL=activity-audit.d.ts.map

package/dist/lib/activity-audit.d.ts.map

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

package/dist/lib/activity-timeline.d.ts

@@ -0,0 +1,43 @@
+import type { Database } from "bun:sqlite";
+export type LocalActivityTimelineEntityType = "all" | "task" | "project" | "plan" | "run";
+export type LocalActivityTimelineOrder = "asc" | "desc";
+export type LocalActivityTimelineSource = "comment" | "task_history" | "run_event" | "run_command" | "run_artifact";
+export interface LocalActivityTimelineOptions {
+    entity_type?: LocalActivityTimelineEntityType;
+    entity_id?: string;
+    task_id?: string;
+    project_id?: string;
+    plan_id?: string;
+    run_id?: string;
+    since?: string;
+    until?: string;
+    limit?: number;
+    offset?: number;
+    order?: LocalActivityTimelineOrder;
+}
+export interface LocalActivityTimelineEntry {
+    id: string;
+    source: LocalActivityTimelineSource;
+    event_type: string;
+    entity_type: "task" | "run";
+    entity_id: string;
+    task_id: string;
+    project_id: string | null;
+    plan_id: string | null;
+    run_id: string | null;
+    agent_id: string | null;
+    created_at: string;
+    title: string;
+    message: string | null;
+    metadata: Record<string, unknown>;
+}
+export interface LocalActivityTimelinePage {
+    entries: LocalActivityTimelineEntry[];
+    total: number;
+    limit: number;
+    offset: number;
+    order: LocalActivityTimelineOrder;
+    filters: Required<Pick<LocalActivityTimelineOptions, "entity_type">> & Omit<LocalActivityTimelineOptions, "limit" | "offset" | "order">;
+}
+export declare function getLocalActivityTimeline(options?: LocalActivityTimelineOptions, db?: Database): LocalActivityTimelinePage;
+//# sourceMappingURL=activity-timeline.d.ts.map

package/dist/lib/activity-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-timeline.d.ts","sourceRoot":"","sources":["../../src/lib/activity-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,MAAM,MAAM,+BAA+B,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC;AAC1F,MAAM,MAAM,0BAA0B,GAAG,KAAK,GAAG,MAAM,CAAC;AACxD,MAAM,MAAM,2BAA2B,GACnC,SAAS,GACT,cAAc,GACd,WAAW,GACX,aAAa,GACb,cAAc,CAAC;AAEnB,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,+BAA+B,CAAC;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,0BAA0B,CAAC;CACpC;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,2BAA2B,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,0BAA0B,EAAE,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,0BAA0B,CAAC;IAClC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,4BAA4B,EAAE,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC,4BAA4B,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAC;CACzI;AAiMD,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,4BAAiC,EAC1C,EAAE,CAAC,EAAE,QAAQ,GACZ,yBAAyB,CAoB3B"}

package/dist/lib/agent-adapter-docs.d.ts

@@ -0,0 +1,71 @@
+/**
+ * First-party local adapter docs for Codex, Claude Code, and Takumi.
+ * Local-only reference — no hosted API required.
+ */
+import { GOAL_COMMAND_RECIPES } from "./goal-workflow.js";
+export declare const ADAPTER_DOCS_SCHEMA_VERSION = "todos.agent_adapter_docs.v1";
+export declare const AGENT_ADAPTER_HOSTS: readonly ["codex", "claude-code", "takumi"];
+export type AgentAdapterHost = (typeof AGENT_ADAPTER_HOSTS)[number];
+export interface AdapterWorkflowStep {
+    step: number;
+    title: string;
+    cli?: string;
+    mcp?: string;
+    notes?: string;
+}
+export interface AdapterFailureMode {
+    symptom: string;
+    cause: string;
+    recovery: string;
+}
+export interface AgentAdapterDoc {
+    schema_version: typeof ADAPTER_DOCS_SCHEMA_VERSION;
+    host: AgentAdapterHost;
+    display_name: string;
+    install: {
+        bun: string;
+        npm?: string;
+        verify: string;
+    };
+    mcp: {
+        register_cli: string;
+        unregister_cli: string;
+        config_path: string;
+        recommended_profile: string;
+        env: string[];
+    };
+    goal_commands: typeof GOAL_COMMAND_RECIPES;
+    workflow: AdapterWorkflowStep[];
+    task_contract: {
+        claim: string;
+        progress: string;
+        complete: string;
+        fail: string;
+        evidence_fields: string[];
+    };
+    verification: {
+        run: string;
+        attach: string;
+        mcp: string;
+    };
+    handoff: {
+        goal: string;
+        session: string;
+        mcp: string;
+    };
+    failure_modes: AdapterFailureMode[];
+    examples: Array<{
+        title: string;
+        command: string;
+    }>;
+}
+export declare const AGENT_ADAPTER_DOCS: Record<AgentAdapterHost, AgentAdapterDoc>;
+export declare function normalizeAdapterHost(input: string): AgentAdapterHost | null;
+export declare function getAgentAdapterDoc(host: string): AgentAdapterDoc | null;
+export declare function listAgentAdapterDocs(): AgentAdapterDoc[];
+export declare function validateAdapterDocs(): string[];
+export declare function renderAdapterDocMarkdown(host: string): string | null;
+export declare function renderAllAdapterDocsMarkdown(): string;
+/** Stable fingerprint for snapshot tests — changes when doc content changes. */
+export declare function getAdapterDocsFingerprint(): string;
+//# sourceMappingURL=agent-adapter-docs.d.ts.map

package/dist/lib/agent-adapter-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-adapter-docs.d.ts","sourceRoot":"","sources":["../../src/lib/agent-adapter-docs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,eAAO,MAAM,2BAA2B,gCAAgC,CAAC;AAEzE,eAAO,MAAM,mBAAmB,6CAA8C,CAAC;AAC/E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,OAAO,2BAA2B,CAAC;IACnD,IAAI,EAAE,gBAAgB,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,GAAG,EAAE;QACH,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,GAAG,EAAE,MAAM,EAAE,CAAC;KACf,CAAC;IACF,aAAa,EAAE,OAAO,oBAAoB,CAAC;IAC3C,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,aAAa,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;IACF,YAAY,EAAE;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD;AAgCD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,gBAAgB,EAAE,eAAe,CA2IxE,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAM3E;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAGvE;AAED,wBAAgB,oBAAoB,IAAI,eAAe,EAAE,CAExD;AAED,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CA6B9C;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA6EpE;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAIrD;AAED,gFAAgF;AAChF,wBAAgB,yBAAyB,IAAI,MAAM,CAoBlD"}

package/dist/lib/agent-coordination.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Hardened multi-agent locking: leases, heartbeats, stale recovery, safe steal.
+ */
+import type { Database } from "bun:sqlite";
+import { type Task } from "../db/tasks.js";
+export declare const AGENT_COORDINATION_SCHEMA = "todos.agent_coordination.v1";
+export declare const DEFAULT_LEASE_MINUTES = 30;
+export interface TaskLease {
+    task_id: string;
+    agent_id: string;
+    acquired_at: string;
+    expires_at: string;
+    heartbeat_at: string | null;
+    steal_count: number;
+}
+export interface LeaseAcquireResult {
+    success: boolean;
+    lease?: TaskLease;
+    conflict?: LockConflict;
+}
+export interface LockConflict {
+    task_id: string;
+    holder: string;
+    locked_at: string | null;
+    expires_at: string | null;
+    message: string;
+}
+export interface StaleRecoveryResult {
+    recovered: Array<{
+        task_id: string;
+        previous_agent: string | null;
+        action: string;
+    }>;
+    stolen: Task | null;
+}
+export declare function formatLockConflict(taskId: string, holder: string, lockedAt: string | null, expiresAt?: string | null): LockConflict;
+export declare function acquireTaskLease(taskId: string, agentId: string, ttlMinutes?: number, db?: Database): LeaseAcquireResult;
+export declare function renewTaskLease(taskId: string, agentId: string, ttlMinutes?: number, db?: Database): TaskLease;
+export declare function releaseTaskLease(taskId: string, agentId: string, db?: Database): boolean;
+export declare function stealTaskLease(taskId: string, agentId: string, options?: {
+    force?: boolean;
+    stale_minutes?: number;
+    reason?: string;
+}, db?: Database): LeaseAcquireResult;
+export declare function listExpiredLeases(db?: Database): TaskLease[];
+export declare function listActiveLeases(agentId?: string, db?: Database): TaskLease[];
+export declare function recoverStaleLeases(options?: {
+    reclaim_agent?: string;
+    stale_minutes?: number;
+}, db?: Database): StaleRecoveryResult;
+export declare function getTaskLease(taskId: string, db?: Database): TaskLease | null;
+//# sourceMappingURL=agent-coordination.d.ts.map

package/dist/lib/agent-coordination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-coordination.d.ts","sourceRoot":"","sources":["../../src/lib/agent-coordination.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAA2D,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAKpG,eAAO,MAAM,yBAAyB,gCAAgC,CAAC;AACvE,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrF,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;CACrB;AAuBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,CAUnI;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,UAAU,SAAwB,EAClC,EAAE,CAAC,EAAE,QAAQ,GACZ,kBAAkB,CA2BpB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,SAAwB,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,SAAS,CAmB5H;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAYxF;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,EAC1E,EAAE,CAAC,EAAE,QAAQ,GACZ,kBAAkB,CAyDpB;AAED,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,SAAS,EAAE,CAI5D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,SAAS,EAAE,CAO7E;AAED,wBAAgB,kBAAkB,CAChC,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,EAChE,EAAE,CAAC,EAAE,QAAQ,GACZ,mBAAmB,CAgCrB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAI5E"}

package/dist/lib/agent-replay-simulator.d.ts

@@ -0,0 +1,66 @@
+export interface AgentReplayOptions {
+    agent_id?: string;
+    scenario?: string;
+}
+export interface AgentReplayStep {
+    index: number;
+    type: "context" | "plan" | "transition" | "command" | "file" | "artifact" | "approval" | "failure";
+    source: string;
+    label: string;
+    status: string;
+    command?: string;
+    from_status?: string | null;
+    to_status?: string | null;
+    gate?: string;
+    message?: string | null;
+}
+export interface AgentReplaySimulation {
+    schema_version: 1;
+    mode: "dry-run";
+    mutates_database: false;
+    scenario: string;
+    fingerprint: string;
+    agent_id: string | null;
+    task: {
+        id: string | null;
+        title: string | null;
+        initial_status: string | null;
+        final_status: string | null;
+    };
+    plan: {
+        id: string | null;
+        name: string | null;
+        status: string | null;
+        task_count: number;
+    } | null;
+    steps: AgentReplayStep[];
+    commands: {
+        total: number;
+        passed: number;
+        failed: number;
+        unknown: number;
+    };
+    approvals: {
+        total: number;
+        pending: number;
+        approved: number;
+        rejected: number;
+        expired: number;
+    };
+    failures: Array<{
+        source: string;
+        message: string;
+        command?: string;
+    }>;
+    snapshot: {
+        task_status: string | null;
+        plan_status: string | null;
+        files: string[];
+        artifacts: string[];
+        warnings: string[];
+    };
+}
+export declare function simulateAgentReplay(input: unknown, options?: AgentReplayOptions): AgentReplaySimulation;
+export declare function simulateAgentReplayFile(path: string, options?: AgentReplayOptions): AgentReplaySimulation;
+export declare function renderAgentReplaySimulationMarkdown(simulation: AgentReplaySimulation): string;
+//# sourceMappingURL=agent-replay-simulator.d.ts.map

package/dist/lib/agent-replay-simulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-replay-simulator.d.ts","sourceRoot":"","sources":["../../src/lib/agent-replay-simulator.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IACnG,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,CAAC,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,gBAAgB,EAAE,KAAK,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;QAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,CAAC;IACF,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,CAAC;IACT,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAwED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,kBAAuB,GAAG,qBAAqB,CAuK3G;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,qBAAqB,CAG7G;AAED,wBAAgB,mCAAmC,CAAC,UAAU,EAAE,qBAAqB,GAAG,MAAM,CAoB7F"}

package/dist/lib/agent-run-dispatcher.d.ts

@@ -0,0 +1,114 @@
+import type { Database } from "bun:sqlite";
+import { type TaskRun } from "../db/task-runs.js";
+import { type AgentRunAdapterConfig } from "./config.js";
+export type AgentRunDispatchState = "queued" | "running" | "completed" | "failed" | "cancelled";
+export interface QueueAgentRunInput {
+    task_id: string;
+    agent_id?: string;
+    adapter?: string;
+    command?: string;
+    sandbox?: string;
+    cwd?: string;
+    title?: string;
+    summary?: string;
+    claim?: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface QueuedAgentRun {
+    run: TaskRun;
+    dispatcher: AgentRunDispatchMetadata;
+}
+export interface AgentRunDispatchMetadata {
+    state: AgentRunDispatchState;
+    adapter?: string;
+    command: string;
+    sandbox?: string;
+    cwd?: string;
+    attempt: number;
+    queued_at: string;
+    started_at?: string;
+    completed_at?: string;
+    last_error?: string;
+}
+export interface RunNextAgentDispatchInput {
+    adapter?: string;
+    dry_run?: boolean;
+    limit?: number;
+}
+export interface RunAgentDispatchResult {
+    run_id: string;
+    task_id: string;
+    command: string;
+    dry_run: boolean;
+    status: "queued" | "completed" | "failed" | "cancelled";
+    exit_code: number | null;
+    output_summary: string | null;
+}
+export interface UpsertAgentRunAdapterInput {
+    name: string;
+    command: string;
+    sandbox?: string;
+    cwd?: string;
+    env?: Record<string, string>;
+}
+export declare function upsertAgentRunAdapter(input: UpsertAgentRunAdapterInput): AgentRunAdapterConfig;
+export declare function listAgentRunAdapters(): AgentRunAdapterConfig[];
+export declare function removeAgentRunAdapter(name: string): boolean;
+export declare function queueAgentRun(input: QueueAgentRunInput, db?: Database): QueuedAgentRun;
+export declare function listAgentRunQueue(db?: Database): QueuedAgentRun[];
+export declare function cancelAgentRunDispatch(runId: string, db?: Database): QueuedAgentRun;
+export declare function retryAgentRunDispatch(runId: string, db?: Database): QueuedAgentRun;
+export declare function runNextAgentDispatch(input?: RunNextAgentDispatchInput, db?: Database): Promise<RunAgentDispatchResult | null>;
+export declare function listAgentRuns(filter?: {
+    task_id?: string;
+    status?: string;
+    agent_id?: string;
+    limit?: number;
+}, db?: Database): QueuedAgentRun[];
+export declare function retryAgentRun(runId: string, db?: Database): QueuedAgentRun;
+export declare const AGENT_RUN_SCHEMA_VERSION = "todos.agent_run.v1";
+export type AgentRunStatus = AgentRunDispatchState;
+export type AgentAdapterConfig = AgentRunAdapterConfig;
+export interface EnqueueAgentRunInput {
+    task_id: string;
+    adapter?: string;
+    agent_id?: string;
+    command?: string;
+    plan_id?: string;
+    evidence?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentRun {
+    id: string;
+    task_id: string;
+    agent_id: string | null;
+    adapter: string | null;
+    status: AgentRunStatus;
+    command: string | null;
+    evidence: Record<string, unknown>;
+    queued_at: string;
+    started_at: string | null;
+    completed_at: string | null;
+    metadata: Record<string, unknown>;
+}
+export interface ListAgentRunsFilter {
+    task_id?: string;
+    agent_id?: string;
+    status?: AgentRunStatus;
+    adapter?: string;
+    limit?: number;
+}
+export declare function enqueueAgentRun(input: EnqueueAgentRunInput, db?: Database): AgentRun;
+export declare function claimNextAgentRun(agentId: string, options?: {
+    adapter?: string;
+}, db?: Database): AgentRun | null;
+export declare function completeAgentRun(runId: string, evidence?: Record<string, unknown>, db?: Database): AgentRun;
+export declare function failAgentRun(runId: string, error?: string, db?: Database): AgentRun;
+export declare function cancelAgentRun(runId: string, db?: Database): AgentRun;
+export declare function getAgentRun(runId: string, db?: Database): AgentRun | null;
+export declare function loadAgentAdapters(): AgentAdapterConfig[];
+export declare function saveAgentAdapters(adapters: AgentAdapterConfig[]): void;
+export declare function getAgentAdapter(name: string): AgentAdapterConfig | null;
+export declare function getDefaultAgentAdapters(): AgentAdapterConfig[];
+export declare function resetAgentAdapterCache(): void;
+//# sourceMappingURL=agent-run-dispatcher.d.ts.map

package/dist/lib/agent-run-dispatcher.d.ts.map

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

package/dist/lib/agent-tasks.d.ts

@@ -0,0 +1,11 @@
+import type { SyncPrefer, SyncResult } from "./sync-types.js";
+export declare function pushToAgentTaskList(agent: string, taskListId: string, projectId?: string, options?: {
+    prefer?: SyncPrefer;
+}): SyncResult;
+export declare function pullFromAgentTaskList(agent: string, taskListId: string, projectId?: string, options?: {
+    prefer?: SyncPrefer;
+}): SyncResult;
+export declare function syncAgentTaskList(agent: string, taskListId: string, projectId?: string, options?: {
+    prefer?: SyncPrefer;
+}): SyncResult;
+//# sourceMappingURL=agent-tasks.d.ts.map

package/dist/lib/agent-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tasks.d.ts","sourceRoot":"","sources":["../../src/lib/agent-tasks.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAwD9D,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACpC,UAAU,CAuFZ;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACpC,UAAU,CAoFZ;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,UAAU,CAAA;CAAO,GACpC,UAAU,CAQZ"}

package/dist/lib/agent-workflow-demo.d.ts

@@ -0,0 +1,87 @@
+/**
+ * One-command local agent workflow demo — agents, projects, tasks, and runs.
+ * Fully local; uses in-memory or temp SQLite. No hosted dependencies.
+ */
+import type { Database } from "bun:sqlite";
+export declare const AGENT_WORKFLOW_DEMO_SCHEMA = "todos.agent_workflow_demo.v1";
+export declare const DEMO_DEFAULT_AGENT = "demo-agent";
+export declare const DEMO_DEFAULT_PROJECT = "Agent Workflow Demo";
+export declare const DEMO_PROJECT_PATH = "/tmp/todos-agent-workflow-demo";
+export interface DemoStep {
+    step: number;
+    action: string;
+    detail: string;
+    status: "ok" | "skipped";
+}
+export interface AgentWorkflowDemoResult {
+    schema_version: typeof AGENT_WORKFLOW_DEMO_SCHEMA;
+    ephemeral: boolean;
+    db_path: string;
+    agent: {
+        id: string;
+        name: string;
+    };
+    project: {
+        id: string;
+        name: string;
+        path: string;
+        task_prefix: string | null;
+    };
+    task_list: {
+        id: string;
+        slug: string;
+        name: string;
+    };
+    tasks: Array<{
+        id: string;
+        short_id: string | null;
+        title: string;
+        status: string;
+    }>;
+    agent_run: {
+        id: string;
+        status: string;
+        task_id: string | null;
+        adapter: string;
+    };
+    run_record: {
+        id: string;
+        status: string;
+        objective: string | null;
+    };
+    status_summary: {
+        pending: number;
+        in_progress: number;
+        completed: number;
+        total: number;
+    };
+    steps: DemoStep[];
+    completed_at: string;
+    message: string;
+}
+export interface RunAgentWorkflowDemoOptions {
+    db?: Database;
+    ephemeral?: boolean;
+    persist?: boolean;
+    db_path?: string;
+    agent_name?: string;
+    project_name?: string;
+    project_path?: string;
+    exported_at?: string;
+}
+export interface EphemeralDbHandle {
+    db_path: string;
+    restore: () => void;
+}
+export declare function setupEphemeralDemoDb(options?: {
+    persist?: boolean;
+    db_path?: string;
+}): EphemeralDbHandle;
+export declare function runAgentWorkflowDemo(options?: RunAgentWorkflowDemoOptions): AgentWorkflowDemoResult;
+export declare function sanitizeDemoVolatileIds(text: string): string;
+export declare function normalizeAgentWorkflowDemoResult(result: AgentWorkflowDemoResult, exportedAt?: string): Record<string, unknown>;
+export declare function formatAgentWorkflowDemoReport(result: AgentWorkflowDemoResult, exportedAt?: string, options?: {
+    deterministic?: boolean;
+}): string;
+export declare function getAgentWorkflowDemoDocs(): string;
+//# sourceMappingURL=agent-workflow-demo.d.ts.map