@anhlp/alp-runtime 0.0.0-stage → 0.0.1-beta.3

package/dist/tools.d.ts

@@ -0,0 +1,682 @@
+import { type Task } from '@anhlp/alp-core/tasks';
+import { type ResolvedSession } from './resolve.js';
+export declare const handoffList: (description: string) => {
+    type: string;
+    items: {
+        type: string;
+    };
+    description: string;
+};
+export declare const HANDOFF_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            outcome: {
+                type: string;
+                enum: readonly ["complete", "partial", "blocked", "reconsider"];
+                description: string;
+            };
+            summary: {
+                type: string;
+                description: string;
+            };
+            candidate: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            scope: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            verification: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            risks: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            discovered: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            ownership: {
+                type: string;
+                description: string;
+            };
+            verdict: {
+                type: string;
+                description: string;
+                properties: {
+                    result: {
+                        type: string;
+                        enum: readonly ["pass", "pass_with_findings", "fail", "blocked"];
+                    };
+                    criteria: {
+                        type: string;
+                        items: {
+                            type: string;
+                            properties: {
+                                criterion: {
+                                    type: string;
+                                    description: string;
+                                };
+                                result: {
+                                    type: string;
+                                    enum: readonly ["pass", "fail", "not_checked"];
+                                };
+                                evidence: {
+                                    type: string;
+                                    description: string;
+                                };
+                            };
+                            required: string[];
+                            additionalProperties: boolean;
+                        };
+                    };
+                    findings: {
+                        type: string;
+                        items: {
+                            type: string;
+                            properties: {
+                                severity: {
+                                    type: string;
+                                    enum: readonly ["critical", "high", "medium", "low"];
+                                    description: string;
+                                };
+                                where: {
+                                    type: string;
+                                    description: string;
+                                };
+                                problem: {
+                                    type: string;
+                                    description: string;
+                                };
+                                fix: {
+                                    type: string;
+                                    description: string;
+                                };
+                            };
+                            required: string[];
+                            additionalProperties: boolean;
+                        };
+                    };
+                };
+                required: string[];
+                additionalProperties: boolean;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+export declare const WAIT_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            assignments: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            timeoutMs: {
+                type: string;
+                description: string;
+            };
+        };
+        additionalProperties: boolean;
+    };
+};
+export declare const SEND_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            to: {
+                type: string;
+                description: string;
+            };
+            kind: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            body: {
+                type: string;
+            };
+            replyTo: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+export declare const MERGE_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            assignmentId: {
+                type: string;
+            };
+            skipVerify: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+export declare const VERIFY_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            taskId: {
+                type: string;
+                description: string;
+            };
+        };
+        additionalProperties: boolean;
+    };
+};
+export declare const DISCARD_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            assignmentId: {
+                type: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+export declare const CANCEL_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            assignmentId: {
+                type: string;
+            };
+            reason: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+export declare const RECALL_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            assignmentId: {
+                type: string;
+                description: string;
+            };
+            taskId: {
+                type: string;
+                description: string;
+            };
+            question: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+export declare const PIN_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            kind: {
+                type: string;
+                enum: readonly ["claim", "decision", "finding"];
+            };
+            body: {
+                type: string;
+                description: string;
+            };
+            paths: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+export declare const BOARD_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            kinds: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: readonly ["claim", "decision", "finding"];
+                };
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+        additionalProperties: boolean;
+    };
+};
+export declare const UNPIN_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            pinId: {
+                type: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+export declare const ASK_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            question: {
+                type: string;
+            };
+            to: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            options: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+export declare const LESSON_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            scope: {
+                type: string;
+                enum: string[];
+            };
+            lesson: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+export declare const SKILL_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            body: {
+                type: string;
+                description: string;
+            };
+            roles: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            lessons: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            replace: {
+                type: string;
+                description: string;
+            };
+            requestId: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+export declare const ISSUE_TOOL: {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+            };
+            target: {
+                type: string;
+                enum: string[];
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            body: {
+                type: string;
+                description: string;
+            };
+            issue: {
+                type: string;
+                description: string;
+            };
+            requestId: {
+                type: string;
+                description: string;
+            };
+            labels: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+export declare const TASK_ACTIONS: readonly ["create", "update", "link", "start", "close", "reopen", "gate", "clear", "pour", "formulas", "show", "list", "ready"];
+export type TaskAction = typeof TASK_ACTIONS[number];
+export declare const TASK_PAST: Record<string, string>;
+export declare const TASK_FIELDS: Record<TaskAction, string[]>;
+/** The agent a session's team has as main (ALPD §42); `main` outside a team. */
+export declare const mainOf: (mapping: Pick<ResolvedSession, "team">) => string;
+/** A member's role in the session's team; without a team, the built-in agents' roles by name. */
+export declare const roleOf: (mapping: Pick<ResolvedSession, "team">, agent: string) => string | undefined;
+/** What each role may do with the task graph: main changes it, the others read it. */
+export declare function taskActions(mapping: Pick<ResolvedSession, 'agent' | 'team'>, parentAgent?: string, role?: 'supervisor'): TaskAction[];
+export declare const taskLinks: (description: string) => {
+    type: string;
+    description: string;
+    properties: {
+        blockedBy: {
+            type: string;
+            items: {
+                type: string;
+            };
+            description: string;
+        };
+        related: {
+            type: string;
+            items: {
+                type: string;
+            };
+        };
+        parent: {
+            type: string;
+            description: string;
+        };
+    };
+    additionalProperties: boolean;
+};
+export declare function taskTool(actions: TaskAction[]): {
+    type: string;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            limit?: {
+                type: string;
+                description: string;
+            } | undefined;
+            status?: {
+                type: string;
+                enum: import("@anhlp/alp-core/tasks").TaskStatus[];
+                description: string;
+            } | undefined;
+            label?: {
+                type: string;
+                description: string;
+            } | undefined;
+            title?: {
+                type: string;
+                description: string;
+            } | undefined;
+            description?: {
+                type: string;
+                description: string;
+            } | undefined;
+            type?: {
+                type: string;
+                enum: import("@anhlp/alp-core/tasks").TaskType[];
+            } | undefined;
+            priority?: {
+                type: string;
+                description: string;
+            } | undefined;
+            labels?: {
+                type: string;
+                items: {
+                    type: string;
+                };
+            } | undefined;
+            paths?: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            } | undefined;
+            parent?: {
+                type: string;
+                description: string;
+            } | undefined;
+            blockedBy?: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            } | undefined;
+            discoveredFrom?: {
+                type: string;
+                description: string;
+            } | undefined;
+            add?: {
+                type: string;
+                description: string;
+                properties: {
+                    blockedBy: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                        description: string;
+                    };
+                    related: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                    parent: {
+                        type: string;
+                        description: string;
+                    };
+                };
+                additionalProperties: boolean;
+            } | undefined;
+            remove?: {
+                type: string;
+                description: string;
+                properties: {
+                    blockedBy: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                        description: string;
+                    };
+                    related: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                    };
+                    parent: {
+                        type: string;
+                        description: string;
+                    };
+                };
+                additionalProperties: boolean;
+            } | undefined;
+            reason?: {
+                type: string;
+                enum: import("@anhlp/alp-core/tasks").CloseReason[];
+                description: string;
+            } | undefined;
+            kind?: {
+                type: string;
+                enum: import("@anhlp/alp-core/tasks").GateKind[];
+                description: string;
+            } | undefined;
+            until?: {
+                type: string;
+                description: string;
+            } | undefined;
+            ref?: {
+                type: string;
+                description: string;
+            } | undefined;
+            gate?: {
+                type: string;
+                description: string;
+            } | undefined;
+            formula?: {
+                type: string;
+                description: string;
+            } | undefined;
+            vars?: {
+                type: string;
+                additionalProperties: {
+                    type: string;
+                };
+                description: string;
+            } | undefined;
+            summary?: {
+                type: string;
+                description: string;
+            } | undefined;
+            unverified?: {
+                type: string;
+                description: string;
+            } | undefined;
+            note?: {
+                type: string;
+                description: string;
+            } | undefined;
+            action: {
+                type: string;
+                enum: ("close" | "list" | "create" | "link" | "update" | "start" | "reopen" | "gate" | "clear" | "pour" | "formulas" | "show" | "ready")[];
+            };
+            id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+};
+/** The task an assignment takes, as the start of its brief. */
+export declare function taskBrief(task: Task, writing: boolean): string;