hyacinth-ai 0.9.6

package/dist/flows/tools.js

@@ -0,0 +1,119 @@
+// ============================================================
+// Flow Tools — 流程控制工具
+// ============================================================
+//
+// complete_flow_step  — 完成当前步骤，推进状态机（触发 guard 检查）
+// activate_todo       — 激活 TODO 模式，开始任务拆分
+// add_todo_step       — 向 TODO Flow 添加执行步骤（ctx 突变，非转移）
+//
+// Flow 工具不记入对话历史——状态由 Zone 5 注入体现。
+// ============================================================
+/** Flow 框架工具名称集合 — 这些工具不记入对话历史 */
+const FLOW_TOOL_NAMES = new Set([
+    'complete_flow_step',
+    'activate_todo',
+    'add_todo_step',
+]);
+/** 判断给定工具名是否为 Flow 框架工具 */
+export function isFlowTool(name) {
+    return FLOW_TOOL_NAMES.has(name);
+}
+// ── complete_flow_step ───────────────────────────────────────
+export function createCompleteFlowStepTool(registry) {
+    return {
+        name: 'complete_flow_step',
+        description: 'Complete the current flow step and advance to the next one. Call this when you have finished the current step\'s task. In TODO planning phase, this finishes planning and starts execution. In execution phase or bootstrap, this advances to the next step. If this is the final step, the flow ends.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+        async execute(_args) {
+            const active = registry.getActive();
+            if (!active) {
+                return 'No active flow. Nothing to complete.';
+            }
+            const snap = active.getSnapshot();
+            const isTodoPlanning = active.id === 'todo' && snap.currentState === 'planning';
+            const steps = snap.context.steps ?? [];
+            const idx = snap.context.stepIndex ?? 0;
+            const currentStep = steps[idx];
+            const stepLabel = currentStep
+                ? `"${currentStep.id}" (step ${idx + 1}/${steps.length})`
+                : isTodoPlanning
+                    ? 'planning phase'
+                    : `step ${idx + 1}`;
+            if (isTodoPlanning) {
+                const stepCount = steps.length;
+                if (stepCount === 0) {
+                    return 'Planning acknowledged. No steps defined — flow will end.';
+                }
+                return `Planning acknowledged. ${stepCount} steps defined, transitioning to execution.`;
+            }
+            return `Step ${stepLabel} acknowledged. Advancing...`;
+        },
+    };
+}
+// ── activate_todo ────────────────────────────────────────────
+export function createActivateTodoTool(registry) {
+    return {
+        name: 'activate_todo',
+        description: 'Activate TODO mode to break down a complex task into ordered steps. After activation, use add_todo_step to add each step, then call complete_flow_step to start execution. The framework will guide you through one step at a time.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                task: {
+                    type: 'string',
+                    description: 'A concise description of the overall task to be completed.',
+                },
+            },
+            required: ['task'],
+        },
+        async execute(args) {
+            const task = args.task ?? '';
+            const todoFlow = registry.get('todo');
+            if (!todoFlow) {
+                return 'TODO flow is not registered. Cannot activate.';
+            }
+            // 激活 TODO Flow（带任务上下文），自动停用当前活跃 Flow
+            registry.activate('todo', { task });
+            return `TODO mode activated for task: "${task}". Break down the task into steps using add_todo_step, then call complete_flow_step to start execution.`;
+        },
+    };
+}
+// ── add_todo_step ────────────────────────────────────────────
+export function createAddTodoStepTool(registry) {
+    return {
+        name: 'add_todo_step',
+        description: 'Add a step to the current TODO flow. Only works when TODO mode is active and in the planning phase. Each step should be a concrete, verifiable action.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                description: {
+                    type: 'string',
+                    description: 'A clear, actionable description of this step. Include what constitutes success.',
+                },
+            },
+            required: ['description'],
+        },
+        async execute(args) {
+            const active = registry.getActive();
+            if (!active || active.id !== 'todo') {
+                return 'TODO mode is not active. Use activate_todo first.';
+            }
+            const todoFlow = registry.get('todo');
+            if (!todoFlow) {
+                return 'TODO flow is not registered.';
+            }
+            const snap = todoFlow.getSnapshot();
+            if (snap.currentState !== 'planning') {
+                return 'Cannot add steps — TODO is already in execution phase.';
+            }
+            const description = args.description ?? '';
+            const step = todoFlow.addStep(description);
+            const allSteps = snap.context.steps ?? [];
+            return `Step #${allSteps.length + 1} added: "${step.prompt}". Total: ${allSteps.length + 1} steps. Add more steps or call complete_flow_step to start execution.`;
+        },
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/flows/types.d.ts

@@ -0,0 +1,27 @@
+import type { MachineContext, MachineSnapshot, AdvanceResult } from '../machine/types.js';
+import type { MachineRunner } from '../machine/runner.js';
+/**
+ * FlowController — 所有 Flow 的统一接口。
+ *
+ * 每个 Flow 内部包装一个 MachineRunner 做状态管理，
+ * 对外提供 getInjection() 给 Zone 5 上下文注入。
+ */
+export interface FlowController {
+    /** Flow 唯一标识（与 MachineDef.id 一致） */
+    readonly id: string;
+    /** 内部状态机 */
+    readonly runner: MachineRunner;
+    /** 激活 Flow */
+    activate(context?: MachineContext): void;
+    /** 停用 Flow */
+    deactivate(): void;
+    /** 通过事件推进状态机（委托给 runner.advance） */
+    advance(event: string): AdvanceResult;
+    /** 结构化快照（委托给 runner.getSnapshot） */
+    getSnapshot(): MachineSnapshot;
+    /** Zone 5 注入文本（当前步骤的提示词） */
+    getInjection(): string | null;
+    /** 是否已完成 */
+    isComplete(): boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/flows/types.js

@@ -0,0 +1,10 @@
+// ============================================================
+// Flow Types — Flow 层类型定义
+// ============================================================
+//
+// 扩展 machine 层的通用类型，添加 Flow 特有的概念：
+//   - getInjection() — Zone 5 注入文本
+//   - FlowController — 统一的 Flow 接口
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/gateway/cli.d.ts

@@ -0,0 +1,5 @@
+/**
+ * CLI 入口 — 使用 commander 解析参数，启动 Agent
+ */
+export declare function runCli(): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map