@signhify/agents 0.0.0-stage → 0.3.2

package/dist/planner.js

@@ -0,0 +1,119 @@
+import { shouldUseAdapter, completeWithAdapter } from './llm.js';
+const SUBAGENT_ROLES = ['file-picker', 'editor', 'reviewer', 'browser-use'];
+/**
+ * Parse a model plan out of its reply: a JSON array under a [plan] or ```json
+ * fence, or anywhere in the text. Returns null when nothing usable is there —
+ * the caller then falls back to the template roadmap.
+ */
+export function parsePlanSteps(text) {
+    if (!text.trim())
+        return null;
+    const match = text.match(/\[[\s\S]*\]/);
+    if (!match)
+        return null;
+    try {
+        const parsed = JSON.parse(match[0]);
+        if (!Array.isArray(parsed) || parsed.length === 0)
+            return null;
+        const steps = [];
+        for (const item of parsed) {
+            if (item === null || typeof item !== 'object')
+                return null;
+            const step = item;
+            if (typeof step.id !== 'string' || typeof step.title !== 'string' || !step.title.trim())
+                return null;
+            if (!SUBAGENT_ROLES.includes(step.subagent))
+                return null;
+            steps.push({ id: step.id, title: step.title, subagent: step.subagent });
+        }
+        return steps;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * TaskNode[] mirroring the plan: first step is the root, the rest become its
+ * children — this is the `T1 → T1.n` tree the sidebar and TaskManager read.
+ */
+export function buildTaskNodes(steps) {
+    if (steps.length === 0)
+        return [];
+    const root = steps[0];
+    return steps.map((step, i) => ({
+        id: step.id,
+        title: step.title,
+        status: 'pending',
+        ...(i > 0 ? { parentId: root.id } : {}),
+    }));
+}
+export class PlannerSubagent {
+    role = 'planner';
+    name = '@Planner';
+    description = 'Formulates hierarchical task roadmaps and assigns specialized subagents';
+    async run(task, _cwd, ctx) {
+        if (ctx?.signal?.aborted) {
+            return { success: false, output: '', error: 'Subagent cancelled by user' };
+        }
+        const objective = task.objective;
+        let steps;
+        if (shouldUseAdapter(ctx)) {
+            const system = 'You are @Planner, a coding-task planner. Reply with ONLY a JSON array ' +
+                '(no prose) of 2-5 steps shaped [{"id":"T1","title":"...","subagent":"file-picker|editor|reviewer"}]. ' +
+                'The first step scopes the work (subagent file-picker); later steps implement and verify.';
+            try {
+                const reply = await completeWithAdapter(ctx, system, `Objective: "${objective}". Existing context notes: ${JSON.stringify(task.context ?? {})}`);
+                const parsed = parsePlanSteps(reply);
+                if (parsed) {
+                    steps = parsed;
+                }
+                else {
+                    steps = this.templateSteps(objective);
+                }
+            }
+            catch (error) {
+                if (ctx?.signal?.aborted)
+                    throw error;
+                steps = this.templateSteps(objective);
+            }
+        }
+        else {
+            steps = this.templateSteps(objective);
+        }
+        const tasks = buildTaskNodes(steps);
+        // Persist the task tree when a store is wired (tasks table, T1 → T1.n).
+        for (const t of tasks) {
+            ctx?.memory?.saveTask({ id: t.id, parentId: t.parentId, title: t.title, status: t.status });
+        }
+        const planSummary = [
+            `### Roadmap Generated by @Planner for: "${objective}"`,
+            ...steps.map(s => `- **[${s.id}]** ${s.title} -> Assigned to \`@${s.subagent}\``),
+            ctx?.memory ? `\nPersisted ${tasks.length} task node(s) to the task tree.` : '',
+        ].join('\n');
+        return {
+            success: true,
+            output: planSummary,
+            metadata: { steps, tasks },
+        };
+    }
+    templateSteps(objective) {
+        return [
+            {
+                id: 'T1',
+                title: `Scope and inspect files related to: ${objective.slice(0, 50)}`,
+                subagent: 'file-picker',
+            },
+            {
+                id: 'T1.1',
+                title: `Implement changes for: ${objective.slice(0, 50)}`,
+                subagent: 'editor',
+            },
+            {
+                id: 'T1.2',
+                title: `Verify changes, run tests and validate stop condition`,
+                subagent: 'reviewer',
+            },
+        ];
+    }
+}
+//# sourceMappingURL=planner.js.map

package/dist/planner.js.map

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

package/dist/reviewer.d.ts

@@ -0,0 +1,10 @@
+import { Subagent, SubagentTask, SubagentResult, SubagentContext, ReviewVerdict } from './types.js';
+export declare function parseReviewVerdict(text: string): ReviewVerdict | null;
+export declare class ReviewerSubagent implements Subagent {
+    readonly role = "reviewer";
+    readonly name = "@Reviewer";
+    readonly description = "Executes verification suites, inspects diffs, and validates goal stop conditions";
+    run(task: SubagentTask, _cwd: string, ctx?: SubagentContext): Promise<SubagentResult>;
+    private defaultVerdict;
+}
+//# sourceMappingURL=reviewer.d.ts.map

package/dist/reviewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewer.d.ts","sourceRoot":"","sources":["../src/reviewer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGpG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CA8BrE;AAED,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,QAAQ,CAAC,IAAI,cAAc;IAC3B,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,sFAAsF;IAEpG,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAmH3F,OAAO,CAAC,cAAc;CAiBvB"}

package/dist/reviewer.js

@@ -0,0 +1,164 @@
+import { shouldUseAdapter, completeWithAdapter } from './llm.js';
+export function parseReviewVerdict(text) {
+    if (!text || !text.trim())
+        return null;
+    const trimmed = text.trim();
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed?.met === 'boolean') {
+            return {
+                met: parsed.met,
+                reason: typeof parsed.reason === 'string' ? parsed.reason : '',
+                remainingSteps: Array.isArray(parsed.remainingSteps) ? parsed.remainingSteps.map(String) : [],
+            };
+        }
+    }
+    catch {
+        // not raw JSON
+    }
+    const match = trimmed.match(/\{[\s\S]*?\}/);
+    if (!match)
+        return null;
+    try {
+        const parsed = JSON.parse(match[0]);
+        if (typeof parsed?.met === 'boolean') {
+            return {
+                met: parsed.met,
+                reason: typeof parsed.reason === 'string' ? parsed.reason : '',
+                remainingSteps: Array.isArray(parsed.remainingSteps) ? parsed.remainingSteps.map(String) : [],
+            };
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+export class ReviewerSubagent {
+    role = 'reviewer';
+    name = '@Reviewer';
+    description = 'Executes verification suites, inspects diffs, and validates goal stop conditions';
+    async run(task, _cwd, ctx) {
+        if (ctx?.signal?.aborted) {
+            return { success: false, output: '', error: 'Subagent cancelled by user' };
+        }
+        const testCommand = task.context?.testCommand === false
+            ? undefined
+            : (typeof task.context?.testCommand === 'string' ? task.context.testCommand : 'npm test -- --run');
+        const instructions = (typeof task.context?.instructions === 'string' && task.context.instructions) ||
+            task.objective ||
+            'Verify implementation against requirements';
+        const diff = (typeof task.context?.diff === 'string' && task.context.diff) || '';
+        if (testCommand && !ctx?.invokeTool) {
+            return { success: false, output: '', error: 'Reviewer commands require the host shell-exec permission pipeline.' };
+        }
+        let execution = { exitCode: 0, stdout: '', stderr: '' };
+        let testError;
+        if (testCommand && ctx?.invokeTool) {
+            try {
+                const result = await ctx.invokeTool('shell-exec', { command: testCommand, timeoutMs: 30_000 });
+                if (ctx?.signal?.aborted) {
+                    return { success: false, output: '', error: 'Subagent cancelled by user' };
+                }
+                if (result.isError) {
+                    execution = { exitCode: 1, stderr: result.content };
+                    testError = result.content;
+                }
+                else {
+                    try {
+                        execution = JSON.parse(result.content);
+                    }
+                    catch {
+                        execution = { exitCode: 0, stdout: result.content };
+                    }
+                    if (execution.exitCode !== 0) {
+                        testError = (execution.stderr || execution.stdout || `Command exited with code ${execution.exitCode ?? 'unknown'}`).slice(0, 500);
+                    }
+                }
+            }
+            catch (err) {
+                if (ctx?.signal?.aborted) {
+                    return { success: false, output: '', error: 'Subagent cancelled by user' };
+                }
+                const errorOutput = err instanceof Error ? err.message : String(err);
+                execution = { exitCode: 1, stderr: errorOutput };
+                testError = errorOutput;
+            }
+        }
+        let verdict;
+        // Check if a structured verdict was explicitly provided in task context (e.g. testing)
+        if (task.context?.verdict && typeof task.context.verdict === 'object') {
+            const v = task.context.verdict;
+            verdict = {
+                met: v.met ?? false,
+                reason: v.reason ?? '',
+                remainingSteps: Array.isArray(v.remainingSteps) ? v.remainingSteps.map(String) : [],
+                exitCode: execution.exitCode,
+            };
+        }
+        else if (shouldUseAdapter(ctx)) {
+            const system = 'You are @Reviewer, a verification and code review subagent. Evaluate the changes and test results against the task instructions. ' +
+                'Respond with ONLY a JSON object: { "met": boolean, "reason": string, "remainingSteps": string[] }. No markdown fences, no preamble.';
+            const user = [
+                `Instructions: ${instructions}`,
+                testCommand ? `Test Command: ${testCommand}` : '',
+                `Test Exit Code: ${execution.exitCode ?? 0}`,
+                execution.stdout ? `Test Stdout: ${execution.stdout.slice(0, 500)}` : '',
+                execution.stderr ? `Test Stderr: ${execution.stderr.slice(0, 500)}` : '',
+                diff ? `Changes/Diff:\n${diff}` : '',
+            ].filter(Boolean).join('\n');
+            try {
+                const reply = await completeWithAdapter(ctx, system, user);
+                if (ctx?.signal?.aborted) {
+                    return { success: false, output: '', error: 'Subagent cancelled by user' };
+                }
+                const parsedVerdict = parseReviewVerdict(reply);
+                if (parsedVerdict) {
+                    verdict = { ...parsedVerdict, exitCode: execution.exitCode };
+                }
+                else {
+                    verdict = this.defaultVerdict(execution, testError);
+                }
+            }
+            catch (error) {
+                if (ctx?.signal?.aborted)
+                    throw error;
+                verdict = this.defaultVerdict(execution, testError);
+            }
+        }
+        else {
+            verdict = this.defaultVerdict(execution, testError);
+        }
+        const stdout = execution.stdout ?? '';
+        const stderr = execution.stderr ?? '';
+        const statusText = verdict.met ? 'verified: command completed successfully.' : `check failed:\n${verdict.reason}`;
+        return {
+            success: verdict.met,
+            output: `@Reviewer ${statusText}${verdict.remainingSteps.length > 0 ? `\nRemaining steps:\n${verdict.remainingSteps.map((s) => `- ${s}`).join('\n')}` : ''}${stdout && verdict.met ? `\n\n${stdout.slice(0, 500)}` : ''}`,
+            metadata: {
+                verdict,
+                exitCode: execution.exitCode,
+                stdout: stdout.slice(0, 500),
+                stderr: stderr.slice(0, 500),
+            },
+            ...(verdict.met ? {} : { error: verdict.reason }),
+        };
+    }
+    defaultVerdict(execution, testError) {
+        if (testError || (execution.exitCode !== undefined && execution.exitCode !== 0)) {
+            return {
+                met: false,
+                reason: testError || `Command exited with code ${execution.exitCode ?? 'unknown'}`,
+                remainingSteps: ['Fix failing tests and review issues.'],
+                exitCode: execution.exitCode,
+            };
+        }
+        return {
+            met: true,
+            reason: 'Verification completed successfully against instructions.',
+            remainingSteps: [],
+            exitCode: execution.exitCode ?? 0,
+        };
+    }
+}
+//# sourceMappingURL=reviewer.js.map

package/dist/reviewer.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,56 @@
+export type SubagentRole = 'file-picker' | 'planner' | 'editor' | 'reviewer' | 'browser-use';
+export interface SubagentTask {
+    id: string;
+    role: SubagentRole;
+    objective: string;
+    context?: Record<string, unknown>;
+    dependsOn?: string[];
+    parentId?: string | null;
+}
+export interface ReviewVerdict {
+    met: boolean;
+    reason: string;
+    remainingSteps: string[];
+    exitCode?: number;
+}
+export interface SubagentResult {
+    success: boolean;
+    output: string;
+    artifacts?: string[];
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+/** Persistence seam for planner task trees; satisfied by MemoryStore.saveTask. */
+export interface TaskPersister {
+    saveTask(task: {
+        id: string;
+        parentId?: string | null;
+        title: string;
+        status?: 'pending' | 'in_progress' | 'blocked' | 'done';
+        progressLog?: string;
+    }): void;
+}
+/** Runtime handed to every subagent by the orchestrator. */
+export interface SubagentContext {
+    adapter?: import('@signhify/providers').ModelProviderAdapter;
+    model?: string;
+    signal?: AbortSignal;
+    memory?: TaskPersister;
+    invokeTool?: (name: 'file-io' | 'shell-exec', args: Record<string, unknown>) => Promise<{
+        content: string;
+        isError?: boolean;
+    }>;
+    onProgress?: (event: SubagentProgressEvent) => void;
+}
+export interface SubagentProgressEvent {
+    type: 'status' | 'log' | 'diff' | 'error' | 'done';
+    message: string;
+    data?: unknown;
+}
+export interface Subagent {
+    readonly role: SubagentRole;
+    readonly name: string;
+    readonly description: string;
+    run(task: SubagentTask, cwd: string, ctx?: SubagentContext): Promise<SubagentResult>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB,aAAa,GACb,SAAS,GACT,QAAQ,GACR,UAAU,GACV,aAAa,CAAC;AAElB,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,kFAAkF;AAClF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE;QACb,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,MAAM,CAAC;QACxD,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,IAAI,CAAC;CACV;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,oBAAoB,CAAC;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAChI,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACrD;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACtF"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@signhify/agents",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.2",
+  "description": "Specialized subagents for Signhify CLI (@FilePicker, @Planner, @Editor, @Reviewer, @BrowserUse)",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "tsc -b --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "node -e \"const {rmSync,existsSync}=require('fs');['dist','*.tsbuildinfo'].forEach(p=>{if(existsSync(p))rmSync(p,{recursive:true,force:true})})\""
+  },
+  "dependencies": {
+    "@signhify/core": "^0.3.2",
+    "@signhify/providers": "^0.3.2"
+  },
+  "devDependencies": {
+    "@signhify/memory": "^0.2.0",
+    "@types/node": "^20.11.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}