agent-step-gate 0.3.0

package/dist/tools/current.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerCurrent(server: McpServer, getSessionId: () => string | null): void;

package/dist/tools/current.js

@@ -0,0 +1,64 @@
+// ============================================================================
+// Agent Step Gate — gate_current MCP Tool
+// Phase 2: Returns ALL current steps (DAG supports multiple active steps).
+// ============================================================================
+import { z } from 'zod';
+import { getTask, getCurrentSteps } from '../storage/repository.js';
+// ---------------------------------------------------------------------------
+// Zod schema for input validation
+// ---------------------------------------------------------------------------
+const GateCurrentSchema = {
+    taskId: z.string().describe('The task ID to query'),
+};
+// ---------------------------------------------------------------------------
+// Tool handler
+// ---------------------------------------------------------------------------
+async function handleCurrent(params, sessionId) {
+    // 1. Get task — enforce session_id isolation
+    const task = getTask(params.taskId);
+    if (!task) {
+        return {
+            taskId: params.taskId,
+            status: 'not_found',
+            currentSteps: [],
+        };
+    }
+    if (task.sessionId && task.sessionId !== sessionId) {
+        return {
+            taskId: params.taskId,
+            status: 'not_found',
+            currentSteps: [],
+        };
+    }
+    // 2. Get all current steps
+    const currentSteps = getCurrentSteps(params.taskId);
+    // 3. Return current step info (do NOT return step_key — security design)
+    return {
+        taskId: params.taskId,
+        status: task.status,
+        currentSteps: currentSteps.map(cs => ({
+            stepId: cs.id,
+            path: cs.path,
+            index: cs.orderIndex,
+            total: task.totalSteps,
+        })),
+    };
+}
+// ---------------------------------------------------------------------------
+// MCP Tool registration
+// ---------------------------------------------------------------------------
+export function registerCurrent(server, getSessionId) {
+    server.tool('gate_current', "Query all current steps for a task. Does NOT return step_keys for security. Keys are only revealed on creation (gate_start_plan) or rotation (gate_checkpoint).", GateCurrentSchema, async (args) => {
+        const sessionId = getSessionId();
+        if (!sessionId) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ taskId: args.taskId, status: 'not_found', currentSteps: [] }) }],
+            };
+        }
+        const result = await handleCurrent(args, sessionId);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result) }],
+        };
+    });
+}
+//# sourceMappingURL=current.js.map

package/dist/tools/current.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"current.js","sourceRoot":"","sources":["../../src/tools/current.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,0CAA0C;AAC1C,2EAA2E;AAC3E,+EAA+E;AAG/E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEpE,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG;IACxB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;CACpD,CAAC;AAEF,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E,KAAK,UAAU,aAAa,CAAC,MAAwB,EAAE,SAAiB;IACtE,6CAA6C;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACnD,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,WAAW;YACnB,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEpD,yEAAyE;IACzE,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,YAAY,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACpC,MAAM,EAAE,EAAE,CAAC,EAAE;YACb,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,KAAK,EAAE,EAAE,CAAC,UAAU;YACpB,KAAK,EAAE,IAAI,CAAC,UAAU;SACvB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,UAAU,eAAe,CAAC,MAAiB,EAAE,YAAiC;IAClF,MAAM,CAAC,IAAI,CACT,cAAc,EACd,iKAAiK,EACjK,iBAAiB,EACjB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;aAC3H,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACpD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/finalize.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerFinalize(server: McpServer): void;

package/dist/tools/finalize.js

@@ -0,0 +1,95 @@
+// ============================================================================
+// Agent Step Gate — gate_finalize MCP Tool
+// Phase 2: Returns pendingSteps on failure so Agent sees what's missing.
+// ============================================================================
+import { z } from 'zod';
+import { getTask, getTaskSteps, verifyTaskKey, updateTaskStatus, addEvent } from '../storage/repository.js';
+import { commitProgramNode } from '../core/program.js';
+// ---------------------------------------------------------------------------
+// Zod input schema
+// ---------------------------------------------------------------------------
+const FinalizeInputSchema = {
+    taskId: z.string().describe('The task ID to finalize'),
+    taskKey: z.string().describe('The task key obtained from the last checkpoint'),
+};
+// ---------------------------------------------------------------------------
+// Handler
+// ---------------------------------------------------------------------------
+async function handleFinalize(params) {
+    // 1. Get task
+    const task = getTask(params.taskId);
+    if (!task) {
+        return {
+            accepted: false,
+            status: 'not_found',
+            message: 'Task not found.',
+        };
+    }
+    // 2. Check if task is already completed (idempotent)
+    if (task.status === 'completed') {
+        return {
+            accepted: true,
+            status: 'completed',
+            message: 'Task was already finalized.',
+        };
+    }
+    // 3. Verify task key
+    const isValid = verifyTaskKey(params.taskId, params.taskKey);
+    if (!isValid) {
+        const allSteps = getTaskSteps(params.taskId);
+        const pendingSteps = allSteps
+            .filter(s => s.status !== 'completed' && s.status !== 'skipped')
+            .map(s => ({
+            stepId: s.id,
+            path: s.path,
+            index: s.orderIndex,
+            total: task.totalSteps,
+        }));
+        const response = {
+            accepted: false,
+            status: 'active',
+            message: 'Task cannot be finalized. Some steps are not checkpointed.',
+            pendingSteps,
+        };
+        return response;
+    }
+    // 4. Validation passed — mark task completed
+    updateTaskStatus(params.taskId, 'completed');
+    addEvent(params.taskId, null, 'task_finalized', JSON.stringify({ taskKeyHash: task.finalKeyHash }));
+    const output = {
+        accepted: true,
+        status: 'completed',
+        message: 'All planned steps have been checkpointed.',
+    };
+    // 5. Auto-propagate: check if node is complete
+    if (task.sessionId) {
+        const cr = commitProgramNode(task.sessionId);
+        if (cr) {
+            output.nodeCompleted = { nodeId: cr.nodeId, programId: cr.programId, nodeKey: cr.nodeKey };
+            output.message = 'Task finalized. Node auto-completed (all tasks done).';
+            if (cr.allDone) {
+                output.programCompleted = { programId: cr.programId };
+                output.message = 'Task finalized → Node completed → Program completed.';
+            }
+        }
+    }
+    return output;
+}
+// ---------------------------------------------------------------------------
+// MCP Tool registration
+// ---------------------------------------------------------------------------
+export function registerFinalize(server) {
+    server.tool('gate_finalize', 'Finalize a task by verifying the final_key. Returns pendingSteps when steps are missing. Stop Hooks can call this to prevent premature task completion.', FinalizeInputSchema, async (params) => {
+        const output = await handleFinalize(params);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(output),
+                },
+            ],
+            isError: !output.accepted,
+        };
+    });
+}
+//# sourceMappingURL=finalize.js.map

package/dist/tools/finalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finalize.js","sourceRoot":"","sources":["../../src/tools/finalize.ts"],"names":[],"mappings":"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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,6 @@
+export { registerStartPlan } from './startPlan.js';
+export { registerCurrent } from './current.js';
+export { registerCheckpoint } from './checkpoint.js';
+export { registerFinalize } from './finalize.js';
+export { registerActiveTask } from './activeTask.js';
+export { registerCancelTask } from './cancelTask.js';

package/dist/tools/index.js

@@ -0,0 +1,7 @@
+export { registerStartPlan } from './startPlan.js';
+export { registerCurrent } from './current.js';
+export { registerCheckpoint } from './checkpoint.js';
+export { registerFinalize } from './finalize.js';
+export { registerActiveTask } from './activeTask.js';
+export { registerCancelTask } from './cancelTask.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tools/startPlan.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerStartPlan(server: McpServer): void;

package/dist/tools/startPlan.js

@@ -0,0 +1,124 @@
+import { z } from 'zod';
+import { flattenPlan } from '../core/plan.js';
+import { generateStepKey, randomCode } from '../core/keys.js';
+import { createSession } from '../core/session.js';
+import { createTask } from '../storage/repository.js';
+import { GateErrorCode } from '../core/errors.js';
+// One session per MCP process. Created lazily on first gate_start_plan call.
+let processSession = null;
+const stepNodeSchema = z.lazy(() => z.object({
+    id: z.string().optional(),
+    title: z.string(),
+    children: z.array(stepNodeSchema).optional(),
+    dependsOn: z.array(z.string()).optional(),
+}));
+export function registerStartPlan(server) {
+    server.tool('gate_start_plan', 'Create a task plan with nested steps and DAG dependencies. Creates a session on first call. Returns session credentials for CLI resume.', {
+        title: z.string(),
+        steps: z.array(stepNodeSchema),
+    }, async (params) => {
+        // 1. Validate input
+        if (!params.title || !params.steps || params.steps.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            accepted: false,
+                            error: GateErrorCode.PLAN_SCHEMA_INVALID,
+                            message: 'Title and at least one step are required',
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // 2. Ensure session exists (created lazily on first call)
+        if (!processSession) {
+            processSession = createSession(process.cwd());
+        }
+        const sessionId = processSession.sessionId;
+        // 3. Generate task_id (6-char alphanumeric)
+        const taskId = `tsk_${randomCode(6)}`;
+        // 4. Flatten nested plan into leaf steps (with DAG dependsOn)
+        const leafSteps = flattenPlan(params.steps, taskId);
+        // 5. Determine initial current steps: those with empty dependsOn
+        const initialCurrent = leafSteps.filter(s => s.dependsOn.length === 0);
+        const stepKeys = {};
+        // 6. Build TaskRow
+        const now = new Date().toISOString();
+        const task = {
+            id: taskId,
+            title: params.title,
+            status: 'active',
+            currentIndex: 1,
+            totalSteps: leafSteps.length,
+            finalKeyHash: null,
+            sessionId,
+            createdAt: now,
+            updatedAt: now,
+        };
+        // 7. Build StepRow[] — initial current steps get 'current', others 'pending'
+        const steps = leafSteps.map((ls) => {
+            const isInitialCurrent = initialCurrent.some(cs => cs.id === ls.id);
+            if (isInitialCurrent) {
+                const { plaintext, hash } = generateStepKey();
+                stepKeys[ls.id] = plaintext;
+                return {
+                    id: ls.id,
+                    taskId: ls.taskId,
+                    parentPath: ls.parentPath,
+                    title: ls.title,
+                    path: ls.path,
+                    orderIndex: ls.orderIndex,
+                    dependsOn: ls.dependsOn,
+                    status: 'current',
+                    stepKeyHash: hash,
+                    completedAt: null,
+                    createdAt: ls.createdAt,
+                };
+            }
+            return {
+                id: ls.id,
+                taskId: ls.taskId,
+                parentPath: ls.parentPath,
+                title: ls.title,
+                path: ls.path,
+                orderIndex: ls.orderIndex,
+                dependsOn: ls.dependsOn,
+                status: 'pending',
+                stepKeyHash: null,
+                completedAt: null,
+                createdAt: ls.createdAt,
+            };
+        });
+        // 8. Write to database (atomic transaction)
+        createTask(task, steps);
+        // 9. Return result with session credentials (for CLI resume)
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        taskId: task.id,
+                        status: 'active',
+                        session: {
+                            sessionId: processSession.sessionId,
+                            sessionSecret: processSession.sessionSecret,
+                            recoveryToken: processSession.recoveryToken,
+                            cliInstanceId: processSession.cliInstanceId,
+                        },
+                        currentSteps: initialCurrent.map(s => ({
+                            stepId: s.id,
+                            path: s.path,
+                            index: s.orderIndex,
+                            total: leafSteps.length,
+                        })),
+                        stepKeys: stepKeys,
+                    }),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=startPlan.js.map

package/dist/tools/startPlan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startPlan.js","sourceRoot":"","sources":["../../src/tools/startPlan.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,142 @@
+/** Nested step node — input format for gate_start_plan */
+export interface PlanNode {
+    id?: string;
+    title: string;
+    children?: PlanNode[];
+    dependsOn?: string[];
+    /** Old key proving this step was completed in a previous task */
+    skipKey?: string;
+    /** The taskId from the previous (cancelled) task where skipKey was used */
+    skipTaskId?: string;
+}
+/** Leaf step after flattening the nested plan (one row in steps table) */
+export interface LeafStep {
+    id: string;
+    taskId: string;
+    parentPath: string | null;
+    title: string;
+    path: string;
+    orderIndex: number;
+    dependsOn: string[];
+    status: 'pending' | 'current' | 'completed' | 'skipped';
+    completedAt: string | null;
+    createdAt: string;
+}
+/** Row shape for the tasks table */
+export interface TaskRow {
+    id: string;
+    title: string;
+    status: 'active' | 'completed' | 'cancelled';
+    currentIndex: number;
+    totalSteps: number;
+    finalKeyHash: string | null;
+    sessionId: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Row shape for the steps table (includes step_key_hash) */
+export interface StepRow {
+    id: string;
+    taskId: string;
+    parentPath: string | null;
+    title: string;
+    path: string;
+    orderIndex: number;
+    dependsOn: string[];
+    status: 'pending' | 'current' | 'completed' | 'skipped';
+    stepKeyHash: string | null;
+    completedAt: string | null;
+    createdAt: string;
+}
+/** Row shape for the events table */
+export interface EventRow {
+    id: string;
+    taskId: string;
+    stepId: string | null;
+    eventType: string;
+    payload: string | null;
+    createdAt: string;
+}
+/** Snapshot of the currently-active step returned by several tools */
+export interface CurrentStepInfo {
+    stepId: string;
+    path: string;
+    index: number;
+    total: number;
+}
+export interface GateStartPlanInput {
+    title: string;
+    steps: PlanNode[];
+}
+export interface GateStartPlanOutput {
+    taskId: string;
+    status: 'active';
+    sessionId: string;
+    currentSteps: CurrentStepInfo[];
+    stepKeys: Record<string, string>;
+}
+export interface GateCurrentInput {
+    taskId: string;
+}
+export interface GateCurrentOutput {
+    taskId: string;
+    status: string;
+    currentSteps: CurrentStepInfo[];
+}
+export interface GateCheckpointInput {
+    taskId: string;
+    stepId: string;
+    stepKey: string;
+}
+export interface GateCheckpointOutput {
+    accepted: boolean;
+    completedStep?: {
+        stepId: string;
+        path: string;
+    };
+    nextSteps?: CurrentStepInfo[];
+    nextStepKeys?: Record<string, string>;
+    allStepsCompleted?: boolean;
+    taskKey?: string;
+    error?: string;
+    message?: string;
+    currentStep?: CurrentStepInfo;
+    pendingSteps?: CurrentStepInfo[];
+}
+export interface GateFinalizeInput {
+    taskId: string;
+    taskKey: string;
+}
+export interface GateFinalizeOutput {
+    accepted: boolean;
+    status?: string;
+    message?: string;
+    currentStep?: CurrentStepInfo;
+    pendingSteps?: CurrentStepInfo[];
+    nodeCompleted?: {
+        nodeId: string;
+        programId: string;
+        nodeKey: string;
+    };
+    programCompleted?: {
+        programId: string;
+    };
+}
+export interface GateActiveTaskOutput {
+    sessionId: string;
+    activeTasks: Array<{
+        taskId: string;
+        title: string;
+        status: string;
+        totalSteps: number;
+        completedSteps: number;
+        currentSteps: CurrentStepInfo[];
+    }>;
+}
+export interface GateCancelTaskInput {
+    taskId: string;
+}
+export interface GateCancelTaskOutput {
+    accepted: boolean;
+    message: string;
+}

package/dist/types/index.js

@@ -0,0 +1,6 @@
+// ============================================================================
+// Agent Step Gate — Core Types
+// Phase 2: DAG step dependencies, multi-step support, multi-task support
+// ============================================================================
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,+BAA+B;AAC/B,yEAAyE;AACzE,+EAA+E"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "agent-step-gate",
+  "version": "0.3.0",
+  "description": "CLI + Skill-based Step Ledger & Key Gate for long-running multi-agent orchestration",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "step-gate": "dist/cli.js"
+  },
+  "repository": "github:3er1inWa11/Step-Gate-Skill",
+  "homepage": "https://github.com/3er1inWa11/Step-Gate-Skill#readme",
+  "keywords": [
+    "agent",
+    "orchestration",
+    "step-gate",
+    "dag",
+    "multi-agent",
+    "skill",
+    "checkpoint"
+  ],
+  "files": [
+    "dist/",
+    "scripts/",
+    "SKILL.md",
+    "Weaver.md",
+    "ARCHITECTURE.md"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^11.0.0",
+    "zod": "^4.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "cli": "node dist/cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}