@kisev/agentomatic 11.0.0-dev.46.gfbe1e4c6992e

package/dist/routing.d.ts

@@ -0,0 +1,133 @@
+export declare const CATEGORIES: readonly ["exploration", "architecture", "implementation", "review"];
+export type Category = (typeof CATEGORIES)[number];
+export type AvailableAgent = {
+    agent: string;
+    available?: boolean;
+    capabilities?: string[];
+    tools?: string[];
+};
+export type RoutingInput = {
+    category: Category;
+    task?: string;
+    requirements: string[];
+    agents: AvailableAgent[];
+    inventory_revision?: string;
+    execution_card?: unknown;
+    override?: string;
+    trusted_override?: boolean;
+    budget?: {
+        cost_class?: string;
+        latency_class?: string;
+    };
+};
+export type RoutingDecision = {
+    schema_version: 1;
+    status: "selected" | "escalate";
+    category: Category;
+    agent?: string;
+    reason_codes: string[];
+    alternatives: {
+        agent: string;
+        excluded_reasons: string[];
+    }[];
+    matrix_revision: string;
+    host_inventory_revision: string;
+    task_digest: string;
+    requirements_digest: string;
+    execution_card_digest?: string;
+    execution_card_revision?: number;
+    decision_digest: string;
+};
+export type RoutingReceipt = {
+    schema_version: 1;
+    task_digest: string;
+    requirements_digest: string;
+    destination: Category;
+    agent: string;
+    card_digest: string | null;
+    card_revision: number | null;
+    host_inventory_revision: string;
+    expires_at: string;
+    nonce: string;
+    receipt_digest: string;
+};
+export type ControlMarker = {
+    path: string;
+    expected?: string;
+    expected_absent?: boolean;
+};
+export type ExecutionCard = {
+    schema_version: 1;
+    status: "READY";
+    card_id: string;
+    revision: number;
+    objective: string;
+    evidence: string[];
+    changed_behavior: string[];
+    risks: string[];
+    write_set: string[];
+    control_markers: ControlMarker[];
+    decisions: string[];
+    steps: Array<{
+        path: string;
+        operation: string;
+    }>;
+    acceptance_criteria: string[];
+    checks: string[];
+    operations: Array<{
+        kind: "write" | "check" | "commit" | "rebase" | "push" | "merge" | "tag" | "release";
+        command: string;
+        path?: string;
+        confirmation_ref?: string;
+    }>;
+    confirmations: {
+        execution: string;
+        publication?: string;
+        history_rewrite?: string;
+    };
+    boundaries: {
+        forbidden_paths: string[];
+        scope: string;
+    };
+};
+export type ExecutionCardStatus = ExecutionCard["status"] | "RUNNING" | "COMPLETED" | "BLOCKED" | "FAILED" | "REJECTED_PLAN" | "APPROVED" | "CHANGES_REQUIRED" | "CANCELLED";
+export declare function validateRoutingReceipt(value: unknown, context?: {
+    task?: string;
+    category?: string;
+    requirements?: string[];
+    card?: unknown;
+}): RoutingDecision;
+export declare function resolveRouting(input: RoutingInput): RoutingDecision;
+export declare function validateExecutionCard(card: unknown): {
+    valid: true;
+    card: ExecutionCard;
+} | {
+    valid: false;
+    failedField: string;
+};
+type ReceiptContext = {
+    task?: string;
+    requirements?: string[];
+    card?: unknown;
+};
+export declare class ExecutionCardLifecycle {
+    #private;
+    constructor(card: unknown);
+    get status(): ExecutionCardStatus;
+    get card_id(): string;
+    get revision(): number;
+    transition(status: ExecutionCardStatus, identity: {
+        card_id: string;
+        revision: number;
+    }): ExecutionCardStatus;
+}
+export declare class RoutingGate {
+    #private;
+    preview(input: RoutingInput): RoutingDecision;
+    dispatch(input: RoutingInput, provided: unknown): RoutingDecision;
+    grant(sessionID: string, decision: RoutingDecision, context?: ReceiptContext): RoutingReceipt;
+    cancel(sessionID: string): void;
+    consume(sessionID: string, agent: string, context?: ReceiptContext): void;
+    complete(sessionID: string, agent: string, output: unknown): void;
+}
+export {};