@ftai/dsh-plugin-acn 0.0.0-stage → 0.1.1

package/lib/types/interaction.d.ts

@@ -0,0 +1,541 @@
+import { z } from 'zod';
+export declare const RuntimeChoiceSchema: z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    agentId: z.ZodString;
+    enabled: z.ZodBoolean;
+    mode: z.ZodEnum<{
+        team: "team";
+        solo: "solo";
+    }>;
+}, z.core.$strip>;
+export declare const SessionViewSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    key: z.ZodString;
+    name: z.ZodString;
+    locked: z.ZodBoolean;
+    available: z.ZodBoolean;
+    phase: z.ZodEnum<{
+        failed: "failed";
+        ready: "ready";
+        syncing: "syncing";
+        blocked: "blocked";
+        unbound: "unbound";
+    }>;
+    message: z.ZodString;
+    messageInfo: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        count: z.ZodOptional<z.ZodNumber>;
+        entityId: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    defaultConnection: z.ZodString;
+    needsPreparation: z.ZodDefault<z.ZodBoolean>;
+    explicitSelection: z.ZodDefault<z.ZodBoolean>;
+    activeMode: z.ZodOptional<z.ZodEnum<{
+        team: "team";
+        solo: "solo";
+    }>>;
+    configurationChanged: z.ZodOptional<z.ZodBoolean>;
+    choices: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        name: z.ZodString;
+        agentId: z.ZodString;
+        enabled: z.ZodBoolean;
+        mode: z.ZodEnum<{
+            team: "team";
+            solo: "solo";
+        }>;
+    }, z.core.$strip>>;
+    showCompletion: z.ZodBoolean;
+}, z.core.$strip>;
+export type SessionView = z.infer<typeof SessionViewSchema>;
+export declare const SourceSessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    available: z.ZodBoolean;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SourceSession = z.infer<typeof SourceSessionSchema>;
+export declare const KnowledgeItemSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        claim: "claim";
+        trace: "trace";
+        dispute: "dispute";
+    }>;
+    id: z.ZodString;
+    name: z.ZodString;
+    status: z.ZodString;
+    detail: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    delivery: z.ZodOptional<z.ZodEnum<{
+        pending: "pending";
+        synced: "synced";
+        local: "local";
+    }>>;
+    sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        available: z.ZodBoolean;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const ActivitySchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodString;
+    state: z.ZodString;
+    attempts: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    unseen: z.ZodDefault<z.ZodBoolean>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        available: z.ZodBoolean;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    summary: z.ZodString;
+    error: z.ZodOptional<z.ZodString>;
+    summaryInfo: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        count: z.ZodOptional<z.ZodNumber>;
+        entityId: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    errorInfo: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        count: z.ZodOptional<z.ZodNumber>;
+        entityId: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    counts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    budgetLimited: z.ZodOptional<z.ZodBoolean>;
+    requiresAttention: z.ZodOptional<z.ZodBoolean>;
+    incompleteCandidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        groupId: z.ZodString;
+        claimIds: z.ZodArray<z.core.$ZodBranded<z.ZodString, "ClaimId", "out">>;
+        reason: z.ZodString;
+    }, z.core.$strip>>>;
+    entityIds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.core.$ZodBranded<z.ZodString, "ClaimId", "out">, z.core.$ZodBranded<z.ZodString, "DisputeId", "out">, z.core.$ZodBranded<z.ZodString, "TraceId", "out">]>>>;
+    entityId: z.ZodOptional<z.ZodString>;
+    retryable: z.ZodOptional<z.ZodBoolean>;
+    acknowledged: z.ZodOptional<z.ZodBoolean>;
+    reportPath: z.ZodOptional<z.ZodString>;
+    phase: z.ZodOptional<z.ZodEnum<{
+        finished: "finished";
+        wrap_up: "wrap_up";
+        exploration: "exploration";
+    }>>;
+}, z.core.$strip>;
+export type Activity = z.infer<typeof ActivitySchema>;
+export declare const KnowledgeViewSchema: z.ZodObject<{
+    key: z.ZodString;
+    name: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            claim: "claim";
+            trace: "trace";
+            dispute: "dispute";
+        }>;
+        id: z.ZodString;
+        name: z.ZodString;
+        status: z.ZodString;
+        detail: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        delivery: z.ZodOptional<z.ZodEnum<{
+            pending: "pending";
+            synced: "synced";
+            local: "local";
+        }>>;
+        sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            available: z.ZodBoolean;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    omitted: z.ZodNumber;
+    activities: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodString;
+        state: z.ZodString;
+        attempts: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+        unseen: z.ZodDefault<z.ZodBoolean>;
+        sessionId: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            available: z.ZodBoolean;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        summary: z.ZodString;
+        error: z.ZodOptional<z.ZodString>;
+        summaryInfo: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            count: z.ZodOptional<z.ZodNumber>;
+            entityId: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        errorInfo: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            count: z.ZodOptional<z.ZodNumber>;
+            entityId: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        counts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        budgetLimited: z.ZodOptional<z.ZodBoolean>;
+        requiresAttention: z.ZodOptional<z.ZodBoolean>;
+        incompleteCandidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            groupId: z.ZodString;
+            claimIds: z.ZodArray<z.core.$ZodBranded<z.ZodString, "ClaimId", "out">>;
+            reason: z.ZodString;
+        }, z.core.$strip>>>;
+        entityIds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.core.$ZodBranded<z.ZodString, "ClaimId", "out">, z.core.$ZodBranded<z.ZodString, "DisputeId", "out">, z.core.$ZodBranded<z.ZodString, "TraceId", "out">]>>>;
+        entityId: z.ZodOptional<z.ZodString>;
+        retryable: z.ZodOptional<z.ZodBoolean>;
+        acknowledged: z.ZodOptional<z.ZodBoolean>;
+        reportPath: z.ZodOptional<z.ZodString>;
+        phase: z.ZodOptional<z.ZodEnum<{
+            finished: "finished";
+            wrap_up: "wrap_up";
+            exploration: "exploration";
+        }>>;
+    }, z.core.$strip>>;
+    activitiesOmitted: z.ZodOptional<z.ZodNumber>;
+    attentionCount: z.ZodOptional<z.ZodNumber>;
+    runningCount: z.ZodOptional<z.ZodNumber>;
+    activityKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    activitySources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    pendingClaims: z.ZodNumber;
+    pendingDisputes: z.ZodNumber;
+}, z.core.$strip>;
+export type KnowledgeView = z.infer<typeof KnowledgeViewSchema>;
+export declare const KnowledgeReferenceSchema: z.ZodObject<{
+    key: z.ZodString;
+    id: z.ZodUnion<readonly [z.core.$ZodBranded<z.ZodString, "ClaimId", "out">, z.core.$ZodBranded<z.ZodString, "DisputeId", "out">, z.core.$ZodBranded<z.ZodString, "TraceId", "out">]>;
+    item: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodEnum<{
+            claim: "claim";
+            trace: "trace";
+            dispute: "dispute";
+        }>;
+        id: z.ZodString;
+        name: z.ZodString;
+        status: z.ZodString;
+        detail: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        updatedAt: z.ZodOptional<z.ZodString>;
+        delivery: z.ZodOptional<z.ZodEnum<{
+            pending: "pending";
+            synced: "synced";
+            local: "local";
+        }>>;
+        sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            available: z.ZodBoolean;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type KnowledgeReference = z.infer<typeof KnowledgeReferenceSchema>;
+export declare const TeamConnectionInputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    agentId: z.core.$ZodBranded<z.ZodString, "AgentId", "out">;
+    routerEndpoint: z.ZodString;
+    maintainerEndpoint: z.ZodString;
+    keyEnv: z.ZodDefault<z.ZodString>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    name: z.ZodDefault<z.ZodString>;
+    agentId: z.core.$ZodBranded<z.ZodString, "AgentId", "out">;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    routerEndpoint: z.ZodDefault<z.ZodString>;
+    maintainerEndpoint: z.ZodDefault<z.ZodString>;
+    keyEnv: z.ZodDefault<z.ZodString>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    id: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>]>;
+export declare const ConnectionChecksSchema: z.ZodArray<z.ZodObject<{
+    service: z.ZodEnum<{
+        router: "router";
+        maintainer: "maintainer";
+    }>;
+    state: z.ZodEnum<{
+        failed: "failed";
+        ok: "ok";
+    }>;
+    message: z.ZodString;
+}, z.core.$strip>>;
+export declare const InteractionRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    action: z.ZodLiteral<"session">;
+    sessionId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"select">;
+    sessionId: z.ZodString;
+    key: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"cancel">;
+    sessionId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"sync">;
+    sessionId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"knowledge">;
+    key: z.ZodString;
+    query: z.ZodDefault<z.ZodString>;
+    kind: z.ZodDefault<z.ZodEnum<{
+        claim: "claim";
+        trace: "trace";
+        dispute: "dispute";
+    }>>;
+    status: z.ZodDefault<z.ZodString>;
+    delivery: z.ZodDefault<z.ZodEnum<{
+        pending: "pending";
+        synced: "synced";
+        local: "local";
+        all: "all";
+    }>>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"activity">;
+    key: z.ZodString;
+    attentionOnly: z.ZodDefault<z.ZodBoolean>;
+    sourceSession: z.ZodDefault<z.ZodString>;
+    kind: z.ZodDefault<z.ZodString>;
+    state: z.ZodDefault<z.ZodString>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"reference">;
+    key: z.ZodString;
+    id: z.ZodUnion<readonly [z.core.$ZodBranded<z.ZodString, "ClaimId", "out">, z.core.$ZodBranded<z.ZodString, "DisputeId", "out">, z.core.$ZodBranded<z.ZodString, "TraceId", "out">]>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"source_session">;
+    sessionId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"open_directory">;
+    path: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"retry_delivery">;
+    key: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"dream_again">;
+    key: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"retry">;
+    key: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"ack">;
+    key: z.ZodString;
+    id: z.ZodString;
+    version: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"recap">;
+    sessionId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"check">;
+    connection: z.ZodUnion<readonly [z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        agentId: z.core.$ZodBranded<z.ZodString, "AgentId", "out">;
+        routerEndpoint: z.ZodString;
+        maintainerEndpoint: z.ZodString;
+        keyEnv: z.ZodDefault<z.ZodString>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+        name: z.ZodDefault<z.ZodString>;
+        agentId: z.core.$ZodBranded<z.ZodString, "AgentId", "out">;
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        routerEndpoint: z.ZodDefault<z.ZodString>;
+        maintainerEndpoint: z.ZodDefault<z.ZodString>;
+        keyEnv: z.ZodDefault<z.ZodString>;
+        timeoutMs: z.ZodDefault<z.ZodNumber>;
+        id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>;
+}, z.core.$strip>, z.ZodObject<{
+    action: z.ZodLiteral<"probe">;
+    provider: z.ZodString;
+    model: z.ZodString;
+}, z.core.$strip>], "action">;
+export type InteractionRequest = z.input<typeof InteractionRequestSchema>;
+export declare const InteractionResultSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    message: z.ZodString;
+    messageInfo: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        count: z.ZodOptional<z.ZodNumber>;
+        entityId: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    serviceAvailable: z.ZodOptional<z.ZodBoolean>;
+    session: z.ZodOptional<z.ZodObject<{
+        sessionId: z.ZodString;
+        key: z.ZodString;
+        name: z.ZodString;
+        locked: z.ZodBoolean;
+        available: z.ZodBoolean;
+        phase: z.ZodEnum<{
+            failed: "failed";
+            ready: "ready";
+            syncing: "syncing";
+            blocked: "blocked";
+            unbound: "unbound";
+        }>;
+        message: z.ZodString;
+        messageInfo: z.ZodOptional<z.ZodObject<{
+            code: z.ZodString;
+            count: z.ZodOptional<z.ZodNumber>;
+            entityId: z.ZodOptional<z.ZodString>;
+            status: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        defaultConnection: z.ZodString;
+        needsPreparation: z.ZodDefault<z.ZodBoolean>;
+        explicitSelection: z.ZodDefault<z.ZodBoolean>;
+        activeMode: z.ZodOptional<z.ZodEnum<{
+            team: "team";
+            solo: "solo";
+        }>>;
+        configurationChanged: z.ZodOptional<z.ZodBoolean>;
+        choices: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            name: z.ZodString;
+            agentId: z.ZodString;
+            enabled: z.ZodBoolean;
+            mode: z.ZodEnum<{
+                team: "team";
+                solo: "solo";
+            }>;
+        }, z.core.$strip>>;
+        showCompletion: z.ZodBoolean;
+    }, z.core.$strip>>;
+    knowledge: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        name: z.ZodString;
+        items: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                claim: "claim";
+                trace: "trace";
+                dispute: "dispute";
+            }>;
+            id: z.ZodString;
+            name: z.ZodString;
+            status: z.ZodString;
+            detail: z.ZodString;
+            summary: z.ZodOptional<z.ZodString>;
+            updatedAt: z.ZodOptional<z.ZodString>;
+            delivery: z.ZodOptional<z.ZodEnum<{
+                pending: "pending";
+                synced: "synced";
+                local: "local";
+            }>>;
+            sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                available: z.ZodBoolean;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+        omitted: z.ZodNumber;
+        activities: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodString;
+            state: z.ZodString;
+            attempts: z.ZodNumber;
+            updatedAt: z.ZodNumber;
+            unseen: z.ZodDefault<z.ZodBoolean>;
+            sessionId: z.ZodOptional<z.ZodString>;
+            source: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                available: z.ZodBoolean;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            summary: z.ZodString;
+            error: z.ZodOptional<z.ZodString>;
+            summaryInfo: z.ZodOptional<z.ZodObject<{
+                code: z.ZodString;
+                count: z.ZodOptional<z.ZodNumber>;
+                entityId: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            errorInfo: z.ZodOptional<z.ZodObject<{
+                code: z.ZodString;
+                count: z.ZodOptional<z.ZodNumber>;
+                entityId: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            counts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            budgetLimited: z.ZodOptional<z.ZodBoolean>;
+            requiresAttention: z.ZodOptional<z.ZodBoolean>;
+            incompleteCandidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                groupId: z.ZodString;
+                claimIds: z.ZodArray<z.core.$ZodBranded<z.ZodString, "ClaimId", "out">>;
+                reason: z.ZodString;
+            }, z.core.$strip>>>;
+            entityIds: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.core.$ZodBranded<z.ZodString, "ClaimId", "out">, z.core.$ZodBranded<z.ZodString, "DisputeId", "out">, z.core.$ZodBranded<z.ZodString, "TraceId", "out">]>>>;
+            entityId: z.ZodOptional<z.ZodString>;
+            retryable: z.ZodOptional<z.ZodBoolean>;
+            acknowledged: z.ZodOptional<z.ZodBoolean>;
+            reportPath: z.ZodOptional<z.ZodString>;
+            phase: z.ZodOptional<z.ZodEnum<{
+                finished: "finished";
+                wrap_up: "wrap_up";
+                exploration: "exploration";
+            }>>;
+        }, z.core.$strip>>;
+        activitiesOmitted: z.ZodOptional<z.ZodNumber>;
+        attentionCount: z.ZodOptional<z.ZodNumber>;
+        runningCount: z.ZodOptional<z.ZodNumber>;
+        activityKinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        activitySources: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        pendingClaims: z.ZodNumber;
+        pendingDisputes: z.ZodNumber;
+    }, z.core.$strip>>;
+    reference: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        id: z.ZodUnion<readonly [z.core.$ZodBranded<z.ZodString, "ClaimId", "out">, z.core.$ZodBranded<z.ZodString, "DisputeId", "out">, z.core.$ZodBranded<z.ZodString, "TraceId", "out">]>;
+        item: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                claim: "claim";
+                trace: "trace";
+                dispute: "dispute";
+            }>;
+            id: z.ZodString;
+            name: z.ZodString;
+            status: z.ZodString;
+            detail: z.ZodString;
+            summary: z.ZodOptional<z.ZodString>;
+            updatedAt: z.ZodOptional<z.ZodString>;
+            delivery: z.ZodOptional<z.ZodEnum<{
+                pending: "pending";
+                synced: "synced";
+                local: "local";
+            }>>;
+            sources: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                available: z.ZodBoolean;
+                title: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    sourceSession: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        available: z.ZodBoolean;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    checks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        service: z.ZodEnum<{
+            router: "router";
+            maintainer: "maintainer";
+        }>;
+        state: z.ZodEnum<{
+            failed: "failed";
+            ok: "ok";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type InteractionResult = z.infer<typeof InteractionResultSchema>;

package/lib/types/knowledge/alignment.d.ts

@@ -0,0 +1,49 @@
+import type { Claim } from '../protocol/claim.js';
+import { JobError } from '../worker/types.js';
+export declare const STALE_PLAN_WARNING = "\u6062\u590D\u65F6 Claim \u5DF2\u53D8\u5316\u6216\u7F3A\u5C11\u5206\u6790\u5FEB\u7167\uFF0C\u5DF2\u653E\u5F03\u672C\u6279\u5C1A\u672A\u6267\u884C\u7684 Claim \u4FEE\u6539\u53CA Dispute\uFF1B\u5DF2\u6267\u884C\u7ED3\u679C\u4FDD\u7559\u3002";
+export declare class AnalysisChanged extends JobError {
+    constructor();
+}
+export declare const sameClaim: (a: Claim, b: Claim) => boolean;
+export declare function observeApplied(targets: readonly Claim[], current: readonly Claim[], applied: Claim[]): void;
+export declare function claimChanges(analysis: readonly Claim[] | null, targets: readonly Claim[], applied: readonly Claim[], current: readonly Claim[]): {
+    id: string & import("zod").$brand<"ClaimId">;
+    before: {
+        id: string & import("zod").$brand<"ClaimId">;
+        name: string;
+        statement: string;
+        scope: string;
+        holder: string & import("zod").$brand<"AgentId">;
+        confidence: "high" | "medium" | "low";
+        status: "active" | "stale" | "deprecated";
+        created_at: string;
+        source_claim_ids: ((string & import("zod").$brand<"ClaimId">) | (string & import("zod").$brand<"PolicyId">))[];
+        evidence_summary: string;
+        updated_at?: string | undefined;
+    } | null;
+    current: {
+        id: string & import("zod").$brand<"ClaimId">;
+        name: string;
+        statement: string;
+        scope: string;
+        holder: string & import("zod").$brand<"AgentId">;
+        confidence: "high" | "medium" | "low";
+        status: "active" | "stale" | "deprecated";
+        created_at: string;
+        source_claim_ids: ((string & import("zod").$brand<"ClaimId">) | (string & import("zod").$brand<"PolicyId">))[];
+        evidence_summary: string;
+        updated_at?: string | undefined;
+    } | null;
+    changed_fields: string[];
+}[];
+export declare function analysisIsStale(analysis: readonly Claim[] | null, changes: readonly unknown[]): boolean;
+export declare class KnowledgeBusy extends JobError {
+    constructor();
+}
+export declare function ensureKnowledgeReady(root: string): Promise<void>;
+export declare class AnalysisReadBoundary {
+    private readonly state;
+    private constructor();
+    static begin(root: string): Promise<AnalysisReadBoundary>;
+    finish(root: string): Promise<void>;
+}

package/lib/types/knowledge/catalog.d.ts

@@ -0,0 +1,5 @@
+import type { Claim } from '../protocol/claim.js';
+export declare function renderCatalog(claims: readonly Claim[], budget: {
+    maxClaims: number;
+    maxChars: number;
+}): string;

package/lib/types/knowledge/changes.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import type { Claim } from '../protocol/claim.js';
+export declare const ClaimIdentitySchema: z.ZodObject<{
+    name: z.ZodString;
+    scope: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        stale: "stale";
+        deprecated: "deprecated";
+    }>;
+    revision: z.ZodString;
+}, z.core.$strip>;
+export declare const ClaimIndexSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    name: z.ZodString;
+    scope: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        stale: "stale";
+        deprecated: "deprecated";
+    }>;
+    revision: z.ZodString;
+}, z.core.$strip>>;
+export type ClaimIndex = z.infer<typeof ClaimIndexSchema>;
+export declare function claimIndex(claims: readonly Claim[]): ClaimIndex;
+export declare function claimChanges(baseline: ClaimIndex, current: ClaimIndex, known: ClaimIndex): {
+    change: string;
+    id: string;
+    name: string;
+    scope: string;
+    status: "active" | "stale" | "deprecated";
+}[];
+export declare function changeNotice(revision: string, baseline: ClaimIndex, current: ClaimIndex, known: ClaimIndex): string;

package/lib/types/knowledge/disputes.d.ts

@@ -0,0 +1,3 @@
+import type { Dispute } from '../protocol/dispute.js';
+import type { StoreContext } from '../store/context.js';
+export declare function newDisputes(context: StoreContext, proposed: readonly Dispute[], local: readonly Dispute[]): Promise<Dispute[]>;

package/lib/types/knowledge/errors.d.ts

@@ -0,0 +1,9 @@
+export type KnowledgeErrorKind = 'validation' | 'not_found' | 'ownership' | 'safety' | 'unconfigured' | 'conflict';
+export declare class KnowledgeError extends Error {
+    readonly kind: KnowledgeErrorKind;
+    constructor(kind: KnowledgeErrorKind, message: string);
+}
+export declare class RevisionConflict extends KnowledgeError {
+    readonly currentRevision: string;
+    constructor(currentRevision: string);
+}

package/lib/types/knowledge/ordering.d.ts

@@ -0,0 +1,7 @@
+import type { Claim } from '../protocol/claim.js';
+import type { Dispute } from '../protocol/dispute.js';
+import type { Trace } from '../protocol/trace.js';
+type Entity = Claim | Dispute | Trace;
+export declare function knowledgeChangedAt(item: Entity): string;
+export declare function compareKnowledge(left: Entity, right: Entity): number;
+export {};

package/lib/types/knowledge/pages.d.ts

@@ -0,0 +1,7 @@
+import type { Claim } from '../protocol/claim.js';
+import type { BoundedText, ClaimListPage, ClaimListQuery, Page } from './types.js';
+export declare function boundedText(value: string, limit: number): BoundedText;
+export declare function validatePage(offset: number, limit: number, maximum?: number): void;
+export declare function page<T>(items: T[], offset: number, limit: number): Page<T>;
+export declare function sortClaims(claims: readonly Claim[]): Claim[];
+export declare function claimListPage(claims: readonly Claim[], query: ClaimListQuery): ClaimListPage;

package/lib/types/knowledge/safety.d.ts

@@ -0,0 +1,2 @@
+export declare function validateClaimText(fields: Record<string, string>): void;
+export declare function textSafetyIssue(value: string): 'invisible_unicode' | 'threat_pattern' | null;