klyro 0.1.63 → 1.0.0

package/dist/tools/agent/spawn-agent.js

@@ -0,0 +1,50 @@
+/**
+ * P1.1 — spawn_agent tool (6-10fix.md §5).
+ *
+ * Delegates to `AgentSpawnBridge.spawnAgent`, which runs the child to
+ * completion (P0/P1 scope: blocking) and returns a compact ChildSummary —
+ * never the child transcript. True background `task_wait` / `task_stop`
+ * arrives in P2.
+ */
+import { z } from 'zod';
+import { defineTool } from '../types.js';
+import { toToolError } from '../normalize.js';
+const InputSchema = z.object({
+    agent: z.string().min(1).describe('Agent id (e.g. explorer, implementer, tester, reviewer)'),
+    task: z.string().min(1).describe('Task brief for the child agent'),
+    cwd: z.string().optional().describe('Working directory override (defaults to parent cwd)'),
+    model: z.string().optional().describe('Model override for the child (must be honoured or error)'),
+    timeoutMs: z.number().int().positive().optional().describe('Child runtime timeout in ms'),
+});
+export const spawnAgentTool = defineTool({
+    name: 'spawn_agent',
+    description: 'Spawn a child agent and return its compact summary { taskId, status, ... }. Child transcript stays separate; use task_get for status.',
+    inputSchema: InputSchema,
+    permission: 'admin',
+    isConcurrencySafe: false,
+    renderCall: (input) => `spawn_agent(${input.agent}): ${input.task.slice(0, 80)}`,
+    execute: async (input, ctx) => {
+        try {
+            const bridge = ctx.agentBridge;
+            if (!bridge) {
+                return {
+                    ok: false,
+                    error: {
+                        code: 'NO_ORCHESTRATOR',
+                        message: 'spawn_agent requires an active orchestrator (run with --agent or via a parent agent)',
+                    },
+                };
+            }
+            return await bridge.spawnAgent({
+                agent: input.agent,
+                task: input.task,
+                ...(input.cwd ? { cwd: input.cwd } : {}),
+                ...(input.model ? { model: input.model } : {}),
+                ...(input.timeoutMs ? { timeoutMs: input.timeoutMs } : {}),
+            });
+        }
+        catch (err) {
+            return { ok: false, error: toToolError(err) };
+        }
+    },
+});

package/dist/tools/agent/task-get.d.ts

@@ -0,0 +1,8 @@
+export declare const taskGetTool: import("../types.js").Tool<{
+    taskId: string;
+}, import("../../agent/task-manager.js").TaskSummary & {
+    error?: {
+        code: string;
+        message: string;
+    };
+}>;

package/dist/tools/agent/task-get.js

@@ -0,0 +1,40 @@
+/**
+ * P1.3 — task_get tool (6-10fix.md §5). Read-only + concurrency-safe.
+ * Returns one task's status and summary by id.
+ */
+import { z } from 'zod';
+import { defineTool } from '../types.js';
+import { toToolError } from '../normalize.js';
+const InputSchema = z.object({
+    taskId: z.string().min(1).describe('Task id (e.g. task_1)'),
+});
+export const taskGetTool = defineTool({
+    name: 'task_get',
+    description: "Return one child-agent task's status and summary by id.",
+    inputSchema: InputSchema,
+    permission: 'read',
+    isConcurrencySafe: true,
+    renderCall: (input) => `task_get(${input.taskId})`,
+    execute: async (input, ctx) => {
+        try {
+            const bridge = ctx.agentBridge;
+            if (!bridge) {
+                return {
+                    ok: false,
+                    error: { code: 'NO_ORCHESTRATOR', message: 'task_get requires an active orchestrator' },
+                };
+            }
+            const rec = bridge.getTask(input.taskId);
+            if (!rec) {
+                return {
+                    ok: false,
+                    error: { code: 'NOT_FOUND', message: `Unknown task: ${input.taskId}` },
+                };
+            }
+            return { ok: true, value: rec };
+        }
+        catch (err) {
+            return { ok: false, error: toToolError(err) };
+        }
+    },
+});

package/dist/tools/agent/task-list.d.ts

@@ -0,0 +1,4 @@
+export declare const taskListTool: import("../types.js").Tool<{
+    parentTaskId?: string | undefined;
+    status?: "running" | "succeeded" | "failed" | "cancelled" | "timed_out" | "blocked" | "queued" | undefined;
+}, import("../../agent/task-manager.js").TaskSummary[]>;

package/dist/tools/agent/task-list.js

@@ -0,0 +1,41 @@
+/**
+ * P1.2 — task_list tool (6-10fix.md §5). Read-only + concurrency-safe.
+ * Returns TaskSummary[] snapshots from the orchestrator's TaskManager.
+ */
+import { z } from 'zod';
+import { defineTool } from '../types.js';
+import { toToolError } from '../normalize.js';
+const InputSchema = z.object({
+    parentTaskId: z.string().optional().describe('Filter by parent task id'),
+    status: z
+        .enum(['queued', 'running', 'succeeded', 'failed', 'cancelled', 'timed_out', 'blocked'])
+        .optional()
+        .describe('Filter by status'),
+});
+export const taskListTool = defineTool({
+    name: 'task_list',
+    description: 'List child-agent tasks (running and completed) with status summaries.',
+    inputSchema: InputSchema,
+    permission: 'read',
+    isConcurrencySafe: true,
+    renderCall: () => 'task_list',
+    execute: async (input, ctx) => {
+        try {
+            const bridge = ctx.agentBridge;
+            if (!bridge) {
+                return {
+                    ok: false,
+                    error: { code: 'NO_ORCHESTRATOR', message: 'task_list requires an active orchestrator' },
+                };
+            }
+            const tasks = bridge.listTasks({
+                ...(input.parentTaskId ? { parentTaskId: input.parentTaskId } : {}),
+                ...(input.status ? { status: input.status } : {}),
+            });
+            return { ok: true, value: tasks };
+        }
+        catch (err) {
+            return { ok: false, error: toToolError(err) };
+        }
+    },
+});

package/dist/tools/plan/todo-write.d.ts

@@ -2,7 +2,7 @@ export declare const todoWriteTool: import("../types.js").Tool<{
     todos: {
         id: string;
         title: string;
-        status: "done" | "pending" | "in_progress" | "failed" | "skipped";
+        status: "done" | "pending" | "failed" | "in_progress" | "skipped";
         files?: string[] | undefined;
     }[];
 }, {

package/dist/tools/registry.js

@@ -25,6 +25,9 @@ import { findSymbolTool } from './symbols/find-symbol.js';
 import { lspDiagnosticsTool, lspGotoDefinitionTool } from './lsp/diagnostics.js';
 import { expandResultTool } from './expand-result.js';
 import { memoryWriteTool } from './memory-write.js';
+import { spawnAgentTool } from './agent/spawn-agent.js';
+import { taskListTool } from './agent/task-list.js';
+import { taskGetTool } from './agent/task-get.js';
 import { zodToJsonSchema } from './schema.js';
 export class ToolRegistry {
     tools = new Map();
@@ -107,5 +110,8 @@ export const builtinRegistry = () => {
     r.register(lspGotoDefinitionTool);
     r.register(expandResultTool);
     r.register(memoryWriteTool);
+    r.register(spawnAgentTool);
+    r.register(taskListTool);
+    r.register(taskGetTool);
     return r;
 };

package/dist/tools/types.d.ts

@@ -48,6 +48,18 @@ export interface ToolContext {
     };
     /** Emit KlyroEvent */
     emit?: (ev: import('../events/catalog.js').KlyroEvent) => void;
+    /** Delegation bridge (set when an orchestrator is active). Powers spawn_agent/task_* tools. */
+    agentBridge?: import('../agent/orchestrator.js').AgentSpawnBridge;
+    /** The task id this agent belongs to, when running under an orchestrator. */
+    parentTaskId?: string;
+    /** Depth of the current agent in the spawn tree (0 = root). Used to build ParentContextRef for spawn_agent. */
+    agentDepth?: number;
+    /** Max allowed spawn depth for this branch. */
+    agentMaxDepth?: number;
+    /** Effective tool allow-set of the current agent (null = all). Child can never exceed this. */
+    agentAllowedTools?: ReadonlySet<string> | null;
+    /** Model override active for the current agent. */
+    agentModel?: string;
 }
 /**
  * A typed tool definition. TInput is the validated input shape; TOutput is

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "klyro",
-  "version": "0.1.63",
+  "version": "1.0.0",
   "description": "Klyro — autonomous coding harness CLI that streams from any OpenAI-compatible or Anthropic LLM endpoint.",
   "type": "module",
   "main": "dist/index.js",