0agent 1.0.0

package/packages/subagent-runtime/dist/MCPProxy.js

@@ -0,0 +1,31 @@
+/**
+ * MCPProxy — connects to the parent daemon's filtered MCP proxy endpoint.
+ *
+ * In Phase 3 this is a stub that logs calls and returns mock results.
+ * The real implementation will issue HTTP requests to the daemon's
+ * per-subagent MCP proxy endpoint, which filters tool access based on
+ * the capability token's allowed_tools list.
+ */
+export class MCPProxy {
+    proxyUrl;
+    constructor(proxyUrl) {
+        this.proxyUrl = proxyUrl;
+    }
+    /**
+     * Call a tool through the MCP proxy.
+     */
+    async call(toolName, args) {
+        // Phase 3 stub — log and return mock result.
+        // Real implementation: POST to proxyUrl with { tool_name, args }
+        console.log(`[MCPProxy] ${toolName}(${JSON.stringify(args)})`);
+        return { type: 'text', text: `Stub: ${toolName} called` };
+    }
+    /**
+     * List tools available through the proxy.
+     */
+    async listTools() {
+        // Phase 3 stub — real implementation: GET proxyUrl/tools
+        return [];
+    }
+}
+//# sourceMappingURL=MCPProxy.js.map

package/packages/subagent-runtime/dist/MCPProxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MCPProxy.js","sourceRoot":"","sources":["../src/MCPProxy.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,OAAO,QAAQ;IACU;IAA7B,YAA6B,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEjD;;OAEG;IACH,KAAK,CAAC,IAAI,CACR,QAAgB,EAChB,IAA6B;QAE7B,6CAA6C;QAC7C,iEAAiE;QACjE,OAAO,CAAC,GAAG,CAAC,cAAc,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,QAAQ,SAAS,EAAE,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,yDAAyD;QACzD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/packages/subagent-runtime/dist/OutputChannel.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Writes structured JSON output to stdout with a sentinel marker.
+ *
+ * The parent orchestrator reads stdout and splits on the sentinel
+ * to extract the subagent's result payload.
+ */
+export declare class OutputChannel {
+    write(data: Record<string, unknown>): void;
+}
+//# sourceMappingURL=OutputChannel.d.ts.map

package/packages/subagent-runtime/dist/OutputChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutputChannel.d.ts","sourceRoot":"","sources":["../src/OutputChannel.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAI3C"}

package/packages/subagent-runtime/dist/OutputChannel.js

@@ -0,0 +1,14 @@
+const OUTPUT_SENTINEL = '__OUTPUT_END__';
+/**
+ * Writes structured JSON output to stdout with a sentinel marker.
+ *
+ * The parent orchestrator reads stdout and splits on the sentinel
+ * to extract the subagent's result payload.
+ */
+export class OutputChannel {
+    write(data) {
+        const json = JSON.stringify(data);
+        process.stdout.write(json + '\n' + OUTPUT_SENTINEL + '\n');
+    }
+}
+//# sourceMappingURL=OutputChannel.js.map

package/packages/subagent-runtime/dist/OutputChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutputChannel.js","sourceRoot":"","sources":["../src/OutputChannel.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,gBAAgB,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IACxB,KAAK,CAAC,IAA6B;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,GAAG,eAAe,GAAG,IAAI,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/packages/subagent-runtime/dist/ResourceTracker.d.ts

@@ -0,0 +1,29 @@
+export interface ToolCallRecord {
+    tool_name: string;
+    input: Record<string, unknown>;
+    output_summary: string;
+    duration_ms: number;
+    timestamp: number;
+}
+/**
+ * Counts resource usage against token-imposed limits.
+ *
+ * The subagent runtime checks this tracker before every LLM call
+ * and tool call to enforce the capability token's resource budget.
+ */
+export declare class ResourceTracker {
+    private readonly maxLLMCalls;
+    private readonly maxTokens;
+    private readonly maxToolCalls;
+    llm_calls: number;
+    tokens_used: number;
+    tool_calls_count: number;
+    private tool_call_records;
+    constructor(maxLLMCalls: number, maxTokens: number, maxToolCalls: number);
+    canMakeLLMCall(): boolean;
+    canMakeToolCall(): boolean;
+    recordLLMCall(tokensUsed: number): void;
+    recordToolCall(name: string, input: Record<string, unknown>, output: unknown, durationMs: number): void;
+    getToolCallRecords(): ToolCallRecord[];
+}
+//# sourceMappingURL=ResourceTracker.d.ts.map

package/packages/subagent-runtime/dist/ResourceTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceTracker.d.ts","sourceRoot":"","sources":["../src/ResourceTracker.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAID;;;;;GAKG;AACH,qBAAa,eAAe;IAOxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAR/B,SAAS,SAAK;IACd,WAAW,SAAK;IAChB,gBAAgB,SAAK;IACrB,OAAO,CAAC,iBAAiB,CAAwB;gBAG9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM;IAGvC,cAAc,IAAI,OAAO;IAIzB,eAAe,IAAI,OAAO;IAI1B,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAKvC,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,OAAO,EACf,UAAU,EAAE,MAAM,GACjB,IAAI;IAWP,kBAAkB,IAAI,cAAc,EAAE;CAGvC"}

package/packages/subagent-runtime/dist/ResourceTracker.js

@@ -0,0 +1,46 @@
+// ─── Types ──────────────────────────────────────────
+// ─── ResourceTracker ────────────────────────────────
+/**
+ * Counts resource usage against token-imposed limits.
+ *
+ * The subagent runtime checks this tracker before every LLM call
+ * and tool call to enforce the capability token's resource budget.
+ */
+export class ResourceTracker {
+    maxLLMCalls;
+    maxTokens;
+    maxToolCalls;
+    llm_calls = 0;
+    tokens_used = 0;
+    tool_calls_count = 0;
+    tool_call_records = [];
+    constructor(maxLLMCalls, maxTokens, maxToolCalls) {
+        this.maxLLMCalls = maxLLMCalls;
+        this.maxTokens = maxTokens;
+        this.maxToolCalls = maxToolCalls;
+    }
+    canMakeLLMCall() {
+        return this.llm_calls < this.maxLLMCalls;
+    }
+    canMakeToolCall() {
+        return this.tool_calls_count < this.maxToolCalls;
+    }
+    recordLLMCall(tokensUsed) {
+        this.llm_calls++;
+        this.tokens_used += tokensUsed;
+    }
+    recordToolCall(name, input, output, durationMs) {
+        this.tool_calls_count++;
+        this.tool_call_records.push({
+            tool_name: name,
+            input,
+            output_summary: String(output).slice(0, 200),
+            duration_ms: durationMs,
+            timestamp: Date.now(),
+        });
+    }
+    getToolCallRecords() {
+        return this.tool_call_records;
+    }
+}
+//# sourceMappingURL=ResourceTracker.js.map

package/packages/subagent-runtime/dist/ResourceTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceTracker.js","sourceRoot":"","sources":["../src/ResourceTracker.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAUvD,uDAAuD;AAEvD;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAOP;IACA;IACA;IARnB,SAAS,GAAG,CAAC,CAAC;IACd,WAAW,GAAG,CAAC,CAAC;IAChB,gBAAgB,GAAG,CAAC,CAAC;IACb,iBAAiB,GAAqB,EAAE,CAAC;IAEjD,YACmB,WAAmB,EACnB,SAAiB,EACjB,YAAoB;QAFpB,gBAAW,GAAX,WAAW,CAAQ;QACnB,cAAS,GAAT,SAAS,CAAQ;QACjB,iBAAY,GAAZ,YAAY,CAAQ;IACpC,CAAC;IAEJ,cAAc;QACZ,OAAO,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC;IAC3C,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,YAAY,CAAC;IACnD,CAAC;IAED,aAAa,CAAC,UAAkB;QAC9B,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,WAAW,IAAI,UAAU,CAAC;IACjC,CAAC;IAED,cAAc,CACZ,IAAY,EACZ,KAA8B,EAC9B,MAAe,EACf,UAAkB;QAElB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;YAC1B,SAAS,EAAE,IAAI;YACf,KAAK;YACL,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;YAC5C,WAAW,EAAE,UAAU;YACvB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/packages/subagent-runtime/dist/TokenValidator.d.ts

@@ -0,0 +1,17 @@
+export interface ValidationResult {
+    valid: boolean;
+    reason?: string;
+}
+/**
+ * Validates a capability token inside the sandbox.
+ *
+ * Note: the sandbox does NOT have access to the daemon secret, so HMAC
+ * verification is not possible here. The parent orchestrator already
+ * validated the signature before injecting the token.
+ *
+ * This validator checks structural integrity and expiry only.
+ */
+export declare class TokenValidator {
+    validate(token: Record<string, unknown>): ValidationResult;
+}
+//# sourceMappingURL=TokenValidator.d.ts.map

package/packages/subagent-runtime/dist/TokenValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenValidator.d.ts","sourceRoot":"","sources":["../src/TokenValidator.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;CAmB3D"}

package/packages/subagent-runtime/dist/TokenValidator.js

@@ -0,0 +1,29 @@
+// ─── Types ──────────────────────────────────────────
+// ─── TokenValidator ─────────────────────────────────
+/**
+ * Validates a capability token inside the sandbox.
+ *
+ * Note: the sandbox does NOT have access to the daemon secret, so HMAC
+ * verification is not possible here. The parent orchestrator already
+ * validated the signature before injecting the token.
+ *
+ * This validator checks structural integrity and expiry only.
+ */
+export class TokenValidator {
+    validate(token) {
+        if (!token.id || !token.subagent_id) {
+            return { valid: false, reason: 'missing_fields' };
+        }
+        if (typeof token.expires_at !== 'number') {
+            return { valid: false, reason: 'invalid_expiry' };
+        }
+        if (Date.now() > token.expires_at) {
+            return { valid: false, reason: 'expired' };
+        }
+        if (token.graph_write !== false) {
+            return { valid: false, reason: 'graph_write_not_false' };
+        }
+        return { valid: true };
+    }
+}
+//# sourceMappingURL=TokenValidator.js.map

package/packages/subagent-runtime/dist/TokenValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenValidator.js","sourceRoot":"","sources":["../src/TokenValidator.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAOvD,uDAAuD;AAEvD;;;;;;;;GAQG;AACH,MAAM,OAAO,cAAc;IACzB,QAAQ,CAAC,KAA8B;QACrC,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACpC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QACpD,CAAC;QAED,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACzC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QACpD,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,EAAE,GAAI,KAAK,CAAC,UAAqB,EAAE,CAAC;YAC9C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC7C,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;YAChC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;QAC3D,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;CACF"}

package/packages/subagent-runtime/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { AgentLoop, type AgentLoopResult, type ILLMClient, type LLMMessage, type LLMResponse, } from './AgentLoop.js';
+export { MCPProxy } from './MCPProxy.js';
+export { OutputChannel } from './OutputChannel.js';
+export { TokenValidator } from './TokenValidator.js';
+export { ResourceTracker } from './ResourceTracker.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/subagent-runtime/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,GACjB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/packages/subagent-runtime/dist/index.js

@@ -0,0 +1,11 @@
+// ─── Agent Loop ─────────────────────────────────────
+export { AgentLoop, } from './AgentLoop.js';
+// ─── MCP Proxy ──────────────────────────────────────
+export { MCPProxy } from './MCPProxy.js';
+// ─── Output Channel ─────────────────────────────────
+export { OutputChannel } from './OutputChannel.js';
+// ─── Token Validator ────────────────────────────────
+export { TokenValidator } from './TokenValidator.js';
+// ─── Resource Tracker ───────────────────────────────
+export { ResourceTracker } from './ResourceTracker.js';
+//# sourceMappingURL=index.js.map

package/packages/subagent-runtime/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EACL,SAAS,GAKV,MAAM,gBAAgB,CAAC;AAExB,uDAAuD;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,uDAAuD;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,uDAAuD;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,uDAAuD;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/packages/subagent-runtime/dist/main.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=main.d.ts.map

package/packages/subagent-runtime/dist/main.d.ts.map

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

package/packages/subagent-runtime/dist/main.js

@@ -0,0 +1,102 @@
+import { AgentLoop } from './AgentLoop.js';
+import { MCPProxy } from './MCPProxy.js';
+import { OutputChannel } from './OutputChannel.js';
+import { TokenValidator } from './TokenValidator.js';
+import { ResourceTracker } from './ResourceTracker.js';
+const INPUT_SENTINEL = '__PAYLOAD_END__';
+// ─── Stub LLM client (Phase 3) ─────────────────────
+/**
+ * Placeholder LLM client. In production this will be replaced by
+ * the real Anthropic/OpenAI client injected via config.
+ */
+const stubLLM = {
+    async complete(messages) {
+        const lastMessage = messages[messages.length - 1];
+        return {
+            content: `[stub] Processed: ${lastMessage?.content?.slice(0, 100) ?? ''}`,
+            finish_reason: 'stop',
+            tokens_used: 0,
+        };
+    },
+};
+// ─── Read stdin until sentinel ──────────────────────
+function readStdin() {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        process.stdin.on('data', (chunk) => {
+            chunks.push(chunk);
+            const combined = Buffer.concat(chunks).toString('utf-8');
+            if (combined.includes(INPUT_SENTINEL)) {
+                const payload = combined.split(INPUT_SENTINEL)[0].trim();
+                resolve(payload);
+            }
+        });
+        process.stdin.on('error', reject);
+        process.stdin.on('end', () => {
+            const combined = Buffer.concat(chunks).toString('utf-8');
+            const payload = combined.split(INPUT_SENTINEL)[0].trim();
+            resolve(payload);
+        });
+        process.stdin.resume();
+    });
+}
+// ─── Main ───────────────────────────────────────────
+async function main() {
+    const output = new OutputChannel();
+    try {
+        // 1. Read payload from stdin
+        const raw = await readStdin();
+        const payload = JSON.parse(raw);
+        // 2. Validate token
+        const validator = new TokenValidator();
+        const validation = validator.validate(payload.token);
+        if (!validation.valid) {
+            output.write({
+                output: '',
+                exit_reason: 'error',
+                error: `Token validation failed: ${validation.reason}`,
+                tool_calls: [],
+                llm_calls_used: 0,
+                tokens_used: 0,
+                tool_calls_count: 0,
+                artifacts: [],
+            });
+            process.exit(1);
+        }
+        // 3. Create resource tracker from token limits
+        const tracker = new ResourceTracker(payload.token.max_llm_calls ?? 10, payload.token.max_llm_tokens ?? 20_000, payload.token.max_tool_calls ?? 20);
+        // 4. Create MCP proxy
+        const proxyUrl = payload.mcp_proxy_url ?? 'http://localhost:3000/mcp';
+        const proxy = new MCPProxy(proxyUrl);
+        // 5. Create and run agent loop
+        const systemPrompt = payload.system_prompt || 'You are a subagent. Complete the given task.';
+        const loop = new AgentLoop(systemPrompt, stubLLM, proxy, tracker);
+        const result = await loop.run(payload.task);
+        // 6. Write result to stdout
+        output.write({
+            output: result.output,
+            exit_reason: result.exit_reason,
+            tool_calls: result.tool_calls,
+            llm_calls_used: result.llm_calls_used,
+            tokens_used: result.tokens_used,
+            tool_calls_count: result.tool_calls.length,
+            artifacts: [],
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        output.write({
+            output: '',
+            exit_reason: 'error',
+            error: message,
+            tool_calls: [],
+            llm_calls_used: 0,
+            tokens_used: 0,
+            tool_calls_count: 0,
+            artifacts: [],
+        });
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=main.js.map

package/packages/subagent-runtime/dist/main.js.map

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

package/seeds/b2b-outbound/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@0agent/seed-b2b-outbound",
+  "version": "0.1.0",
+  "main": "install.js",
+  "type": "module"
+}

package/seeds/research/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@0agent/seed-research",
+  "version": "0.1.0",
+  "main": "install.js",
+  "type": "module"
+}

package/seeds/software-engineering/install.ts

@@ -0,0 +1,78 @@
+import type { KnowledgeGraph } from '@0agent/core';
+import { createNode, createEdge, NodeType, EdgeType } from '@0agent/core';
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+interface SeedNodeData {
+  id?: string;
+  label: string;
+  type: string;
+  metadata?: Record<string, unknown>;
+}
+
+interface SeedEdgeData {
+  id?: string;
+  from: string;
+  to: string;
+  type?: string;
+  weight?: number;
+}
+
+interface SeedGraph {
+  nodes: SeedNodeData[];
+  edges: SeedEdgeData[];
+}
+
+export async function installSeed(
+  graph: KnowledgeGraph,
+  graphId: string = 'root',
+): Promise<{ nodes: number; edges: number }> {
+  // Check idempotency
+  const existing = graph.nodeCount(graphId);
+  if (existing > 0) {
+    console.log('[Seed] software-engineering already installed, skipping');
+    return { nodes: 0, edges: 0 };
+  }
+
+  // Read graph data from the same directory
+  const dir = dirname(fileURLToPath(import.meta.url));
+  const data: SeedGraph = JSON.parse(
+    readFileSync(join(dir, 'sprint-workflow.json'), 'utf8'),
+  );
+
+  let nodeCount = 0;
+  let edgeCount = 0;
+
+  for (const n of data.nodes) {
+    graph.addNode(
+      createNode({
+        id: n.id ?? crypto.randomUUID(),
+        graph_id: graphId,
+        label: n.label,
+        type: n.type as NodeType,
+        metadata: n.metadata ?? {},
+      }),
+    );
+    nodeCount++;
+  }
+
+  for (const e of data.edges) {
+    graph.addEdge(
+      createEdge({
+        id: e.id ?? crypto.randomUUID(),
+        graph_id: graphId,
+        from_node: e.from,
+        to_node: e.to,
+        type: (e.type as EdgeType) ?? EdgeType.LEADS_TO,
+        weight: e.weight ?? 0.5,
+      }),
+    );
+    edgeCount++;
+  }
+
+  console.log(
+    `[Seed] Installed software-engineering: ${nodeCount} nodes, ${edgeCount} edges`,
+  );
+  return { nodes: nodeCount, edges: edgeCount };
+}

package/seeds/software-engineering/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@0agent/seed-software-engineering",
+  "version": "0.1.0",
+  "main": "install.js",
+  "type": "module"
+}

package/seeds/software-engineering/sprint-workflow.json

@@ -0,0 +1,102 @@
+{
+  "name": "@0agent/software-engineering",
+  "version": "1.0.0",
+  "description": "Sprint workflow: Think → Plan → Build → Review → Test → Ship → Reflect",
+
+  "nodes": [
+    {"label": "new_feature", "type": "context"},
+    {"label": "bug_fix", "type": "context"},
+    {"label": "refactor_needed", "type": "context"},
+    {"label": "tech_debt", "type": "context"},
+
+    {"label": "office-hours", "type": "plan", "metadata": {"is_skill": true}},
+    {"label": "plan-ceo-review", "type": "plan", "metadata": {"is_skill": true}},
+    {"label": "plan-eng-review", "type": "plan", "metadata": {"is_skill": true}},
+    {"label": "build", "type": "step", "metadata": {"is_skill": true}},
+    {"label": "review", "type": "step", "metadata": {"is_skill": true}},
+    {"label": "qa", "type": "step", "metadata": {"is_skill": true}},
+    {"label": "security-audit", "type": "step", "metadata": {"is_skill": true}},
+    {"label": "ship", "type": "step", "metadata": {"is_skill": true}},
+    {"label": "retro", "type": "outcome", "metadata": {"is_skill": true}},
+    {"label": "debug", "type": "step", "metadata": {"is_skill": true}},
+    {"label": "test-writer", "type": "step", "metadata": {"is_skill": true}},
+    {"label": "refactor", "type": "step", "metadata": {"is_skill": true}},
+    {"label": "research", "type": "step", "metadata": {"is_skill": true}},
+    {"label": "design-review", "type": "step", "metadata": {"is_skill": true}},
+    {"label": "doc", "type": "step", "metadata": {"is_skill": true}},
+
+    {"label": "shipped_clean", "type": "outcome"},
+    {"label": "qa_caught_bugs", "type": "signal"},
+    {"label": "review_caught_bugs", "type": "signal"},
+    {"label": "shipped_with_issues", "type": "outcome"}
+  ],
+
+  "edges": [
+    {"from": "new_feature", "to": "office-hours", "weight": 0.80, "type": "leads_to",
+     "rationale": "New features benefit from design thinking before building"},
+    {"from": "new_feature", "to": "build", "weight": 0.30, "type": "leads_to",
+     "rationale": "Sometimes you just need to build it — but risky without planning"},
+
+    {"from": "bug_fix", "to": "debug", "weight": 0.85, "type": "leads_to",
+     "rationale": "Bugs should be diagnosed before fixed"},
+    {"from": "bug_fix", "to": "build", "weight": 0.50, "type": "leads_to",
+     "rationale": "Simple bugs can go straight to fix"},
+
+    {"from": "refactor_needed", "to": "test-writer", "weight": 0.80, "type": "leads_to",
+     "rationale": "Write tests before refactoring — safety net first"},
+    {"from": "refactor_needed", "to": "refactor", "weight": 0.40, "type": "leads_to",
+     "rationale": "Refactoring without tests is risky — lower initial weight"},
+
+    {"from": "office-hours", "to": "plan-ceo-review", "weight": 0.85, "type": "leads_to",
+     "rationale": "Design docs should be validated for product fit"},
+    {"from": "plan-ceo-review", "to": "plan-eng-review", "weight": 0.80, "type": "leads_to",
+     "rationale": "Product-approved plans need technical architecture review"},
+    {"from": "plan-eng-review", "to": "build", "weight": 0.90, "type": "leads_to",
+     "rationale": "Technically reviewed plans are ready for implementation"},
+
+    {"from": "build", "to": "review", "weight": 0.90, "type": "leads_to",
+     "rationale": "All code should be reviewed before testing"},
+    {"from": "build", "to": "design-review", "weight": 0.45, "type": "leads_to",
+     "rationale": "UI changes benefit from design review — context-dependent"},
+    {"from": "build", "to": "qa", "weight": 0.35, "type": "leads_to",
+     "rationale": "Skipping review is risky — low initial weight, will learn"},
+
+    {"from": "design-review", "to": "review", "weight": 0.70, "type": "leads_to",
+     "rationale": "Design-reviewed code proceeds to code review"},
+
+    {"from": "review", "to": "qa", "weight": 0.85, "type": "leads_to",
+     "rationale": "Reviewed code should proceed to QA testing"},
+    {"from": "review", "to": "security-audit", "weight": 0.50, "type": "leads_to",
+     "rationale": "Security audit is context-dependent — starts neutral"},
+    {"from": "review", "to": "ship", "weight": 0.30, "type": "leads_to",
+     "rationale": "Shipping without QA is risky — low initial weight"},
+
+    {"from": "security-audit", "to": "qa", "weight": 0.75, "type": "leads_to",
+     "rationale": "Security-audited code still needs QA"},
+
+    {"from": "qa", "to": "ship", "weight": 0.85, "type": "leads_to",
+     "rationale": "QA-passed code is ready to ship"},
+    {"from": "qa", "to": "build", "weight": 0.60, "type": "leads_to",
+     "rationale": "QA failures go back to build for fixes"},
+
+    {"from": "ship", "to": "retro", "weight": 0.70, "type": "leads_to",
+     "rationale": "Shipped features benefit from retrospective — not always needed"},
+    {"from": "ship", "to": "doc", "weight": 0.55, "type": "leads_to",
+     "rationale": "Shipped features should be documented"},
+
+    {"from": "ship", "to": "shipped_clean", "weight": 0.50, "type": "leads_to",
+     "rationale": "Neutral — will learn from actual ship outcomes"},
+
+    {"from": "review", "to": "review_caught_bugs", "weight": 0.50, "type": "leads_to",
+     "rationale": "Starts neutral — /retro will adjust based on actual catch rate"},
+    {"from": "qa", "to": "qa_caught_bugs", "weight": 0.50, "type": "leads_to",
+     "rationale": "Starts neutral — /retro will adjust based on actual catch rate"},
+
+    {"from": "debug", "to": "build", "weight": 0.85, "type": "leads_to",
+     "rationale": "Diagnosed bugs proceed to fix implementation"},
+    {"from": "test-writer", "to": "refactor", "weight": 0.80, "type": "leads_to",
+     "rationale": "Tests written → safe to refactor"},
+    {"from": "refactor", "to": "review", "weight": 0.85, "type": "leads_to",
+     "rationale": "Refactored code needs review"}
+  ]
+}