robal-framework 0.1.0

package/dist/orchestrator.d.ts

@@ -0,0 +1,51 @@
+import type { OrchestratorConfig, TaskOutput, TaskInput } from './types';
+import { Team } from './team';
+/**
+ * Orchestrator — coordinates multiple teams with different agents.
+ *
+ * @example
+ * ```ts
+ * const orc = new Orchestrator({
+ *   teams: {
+ *     research: { agent: researchAgent },
+ *     writer:   { agent: writerAgent, reviewer: editorAgent },
+ *   },
+ *   channels: [
+ *     { from: 'research', to: 'writer' },
+ *   ],
+ * });
+ *
+ * // Run a single team
+ * const result = await orc.run('research', 'Find market trends for AI agents');
+ *
+ * // Run a pipeline (research → writer, connected by channel)
+ * const final = await orc.pipeline('research', 'Write a report on AI agent market');
+ * ```
+ */
+export declare class Orchestrator {
+    private teams;
+    private channels;
+    private emit;
+    constructor(config: OrchestratorConfig);
+    /** Get a team by ID. */
+    team(id: string): Team;
+    /** Run a task on a specific team. */
+    run(teamId: string, prompt: string, context?: TaskInput['context']): Promise<TaskOutput>;
+    /**
+     * Run a pipeline starting from a team.
+     * Output flows through channels to downstream teams.
+     * Channels with gates hold output until the gate approves.
+     */
+    pipeline(startTeamId: string, prompt: string, context?: TaskInput['context']): Promise<TaskOutput>;
+    /**
+     * Run multiple teams in parallel on different prompts.
+     * Useful for fan-out patterns.
+     */
+    parallel(tasks: {
+        teamId: string;
+        prompt: string;
+        context?: TaskInput['context'];
+    }[]): Promise<TaskOutput[]>;
+    private routeThrough;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAqB,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC5F,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,IAAI,CAAqC;gBAErC,MAAM,EAAE,kBAAkB;IAStC,wBAAwB;IACxB,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMtB,qCAAqC;IAC/B,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAI9F;;;;OAIG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IA6CxG;;;OAGG;IACG,QAAQ,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;KAAE,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YASpG,YAAY;CA2B3B"}

package/dist/orchestrator.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Orchestrator = void 0;
+const team_1 = require("./team");
+/**
+ * Orchestrator — coordinates multiple teams with different agents.
+ *
+ * @example
+ * ```ts
+ * const orc = new Orchestrator({
+ *   teams: {
+ *     research: { agent: researchAgent },
+ *     writer:   { agent: writerAgent, reviewer: editorAgent },
+ *   },
+ *   channels: [
+ *     { from: 'research', to: 'writer' },
+ *   ],
+ * });
+ *
+ * // Run a single team
+ * const result = await orc.run('research', 'Find market trends for AI agents');
+ *
+ * // Run a pipeline (research → writer, connected by channel)
+ * const final = await orc.pipeline('research', 'Write a report on AI agent market');
+ * ```
+ */
+class Orchestrator {
+    teams = new Map();
+    channels;
+    emit;
+    constructor(config) {
+        this.emit = config.onEvent || (() => { });
+        this.channels = config.channels || [];
+        for (const [id, teamConfig] of Object.entries(config.teams)) {
+            this.teams.set(id, new team_1.Team(id, teamConfig, this.emit));
+        }
+    }
+    /** Get a team by ID. */
+    team(id) {
+        const t = this.teams.get(id);
+        if (!t)
+            throw new Error(`Team '${id}' not found. Available: ${[...this.teams.keys()].join(', ')}`);
+        return t;
+    }
+    /** Run a task on a specific team. */
+    async run(teamId, prompt, context) {
+        return this.team(teamId).run(prompt, context);
+    }
+    /**
+     * Run a pipeline starting from a team.
+     * Output flows through channels to downstream teams.
+     * Channels with gates hold output until the gate approves.
+     */
+    async pipeline(startTeamId, prompt, context) {
+        let currentOutput = await this.run(startTeamId, prompt, context);
+        if (currentOutput.status === 'failed')
+            return currentOutput;
+        const visited = new Set([startTeamId]);
+        let currentTeamId = startTeamId;
+        while (true) {
+            const outgoing = (this.channels || []).filter(c => c.from === currentTeamId && !visited.has(c.to));
+            if (outgoing.length === 0)
+                break;
+            if (outgoing.length === 1) {
+                // Linear chain
+                const channel = outgoing[0];
+                const routed = await this.routeThrough(channel, currentOutput.output, context);
+                if (!routed)
+                    break;
+                currentOutput = routed.output;
+                currentTeamId = channel.to;
+                visited.add(currentTeamId);
+                if (currentOutput.status === 'failed')
+                    break;
+            }
+            else {
+                // Fan-out: run downstream teams in parallel
+                const results = await Promise.allSettled(outgoing.map(channel => this.routeThrough(channel, currentOutput.output, context)));
+                const outputs = [];
+                for (let i = 0; i < results.length; i++) {
+                    const r = results[i];
+                    visited.add(outgoing[i].to);
+                    if (r.status === 'fulfilled' && r.value) {
+                        outputs.push(`[${outgoing[i].to}]: ${r.value.output.output}`);
+                    }
+                    else {
+                        outputs.push(`[${outgoing[i].to}]: Error`);
+                    }
+                }
+                currentOutput = { status: 'completed', output: outputs.join('\n\n---\n\n') };
+                break; // Fan-out is a terminal step
+            }
+        }
+        return currentOutput;
+    }
+    /**
+     * Run multiple teams in parallel on different prompts.
+     * Useful for fan-out patterns.
+     */
+    async parallel(tasks) {
+        const results = await Promise.allSettled(tasks.map(t => this.run(t.teamId, t.prompt, t.context)));
+        return results.map(r => r.status === 'fulfilled' ? r.value : { status: 'failed', output: '', error: r.reason?.message });
+    }
+    async routeThrough(channel, output, context) {
+        // Gate check
+        if (channel.gate) {
+            const allowed = await channel.gate(output);
+            if (!allowed) {
+                this.emit({ type: 'channel:gated', from: channel.from, to: channel.to, taskId: '' });
+                return null;
+            }
+        }
+        // Transform
+        const transformed = channel.transform ? channel.transform(output) : output;
+        this.emit({ type: 'channel:routed', from: channel.from, to: channel.to, taskId: '' });
+        const nextContext = {
+            ...context,
+            previousOutputs: [...(context?.previousOutputs || []), output],
+        };
+        const result = await this.team(channel.to).run(transformed, nextContext);
+        return { output: result };
+    }
+}
+exports.Orchestrator = Orchestrator;
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,94 @@
+import type { Agent, TaskInput, TaskOutput, ReviewResult } from './types';
+export interface BridgeHandlers {
+    delegate: (subtasks: {
+        prompt: string;
+        name?: string;
+    }[]) => Promise<string[]>;
+    submitReview: (result: ReviewResult) => void;
+}
+/**
+ * Local HTTP server that exposes framework capabilities to any agent process.
+ * Agents call these endpoints via curl, fetch, subprocess — any language.
+ *
+ * Endpoints:
+ *   POST /delegate       — spawn sub-agents, returns results
+ *   POST /submit-review  — submit review verdict
+ *   POST /submit-result  — submit final task output
+ *   GET  /task           — get current task info
+ *   GET  /health         — health check
+ */
+export declare class AgentServer {
+    private server;
+    private handlers;
+    private currentTask;
+    private reviewResolve;
+    private resultResolve;
+    readonly port: number;
+    constructor(port?: number);
+    start(): Promise<number>;
+    stop(): Promise<void>;
+    setHandlers(handlers: BridgeHandlers): void;
+    setTask(task: TaskInput): void;
+    waitForReview(): Promise<ReviewResult>;
+    waitForResult(): Promise<TaskOutput>;
+    private handle;
+    private json;
+    private readBody;
+}
+/** Description of an available agent for delegation */
+export interface AvailableAgent {
+    name: string;
+    description: string;
+}
+/**
+ * Builds the capability instructions the framework injects for the agent.
+ * The agent receives these so it knows what it can do — delegate, submit results, etc.
+ */
+export declare function buildInstructions(baseUrl: string, canDelegate: boolean, task: TaskInput, availableAgents?: AvailableAgent[]): string;
+/**
+ * Wraps any external process as an Agent by exposing the bridge server.
+ *
+ * Two modes:
+ * - **Simple mode**: just pass `command` — the framework builds the full prompt
+ *   with capability instructions and pipes it to your command.
+ * - **Custom mode**: pass `run` for full control over how the agent is invoked.
+ *
+ * The agent process receives env vars including ROBAL_INSTRUCTIONS which contains
+ * the full prompt with task, context, and available actions (delegate, submit, etc).
+ * The agent just needs to follow the instructions.
+ *
+ * @example
+ * ```ts
+ * // Simple: framework builds prompt, pipes to your CLI
+ * const { agent } = await createAgent({
+ *   command: 'kiro-cli chat --no-interactive --trust-all-tools',
+ * });
+ *
+ * // Custom: full control
+ * const { agent } = await createAgent({
+ *   run: async (task, env) => {
+ *     execSync(`my-agent`, { env: { ...process.env, ...env } });
+ *   },
+ * });
+ * ```
+ */
+export declare function createAgent(opts: {
+    /** Shell command to run. Framework pipes ROBAL_INSTRUCTIONS as stdin. */
+    command?: string;
+    /** Custom run function for full control. */
+    run?: (task: TaskInput, env: Record<string, string>) => Promise<string | void>;
+    /** Agents available for delegation. Shown to the agent so it knows who to delegate to. */
+    availableAgents?: AvailableAgent[];
+    port?: number;
+    timeoutMs?: number;
+}): Promise<{
+    agent: Agent;
+    bridge: AgentServer;
+}>;
+/**
+ * Creates a Reviewer that waits for an external process to POST to /submit-review.
+ */
+export declare function createReviewer(bridge: AgentServer): {
+    reviewer: import('./types').Reviewer;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE1E,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,CAAC,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/E,YAAY,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,aAAa,CAAiD;IACtE,OAAO,CAAC,aAAa,CAA+C;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,SAAI;IAId,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAW9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,WAAW,CAAC,QAAQ,EAAE,cAAc;IACpC,OAAO,CAAC,IAAI,EAAE,SAAS;IAEvB,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;IAItC,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAIpC,OAAO,CAAC,MAAM;IAuEd,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,QAAQ;CAQjB;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,CAAC,EAAE,cAAc,EAAE,GAAG,MAAM,CA4DpI;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE;IACtC,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/E,0FAA0F;IAC1F,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC,CA8EjD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG;IACnD,QAAQ,EAAE,OAAO,SAAS,EAAE,QAAQ,CAAC;CACtC,CASA"}

package/dist/server.js

@@ -0,0 +1,334 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentServer = void 0;
+exports.buildInstructions = buildInstructions;
+exports.createAgent = createAgent;
+exports.createReviewer = createReviewer;
+const http = __importStar(require("http"));
+/**
+ * Local HTTP server that exposes framework capabilities to any agent process.
+ * Agents call these endpoints via curl, fetch, subprocess — any language.
+ *
+ * Endpoints:
+ *   POST /delegate       — spawn sub-agents, returns results
+ *   POST /submit-review  — submit review verdict
+ *   POST /submit-result  — submit final task output
+ *   GET  /task           — get current task info
+ *   GET  /health         — health check
+ */
+class AgentServer {
+    server = null;
+    handlers = null;
+    currentTask = null;
+    reviewResolve = null;
+    resultResolve = null;
+    port;
+    constructor(port = 0) {
+        this.port = port;
+    }
+    async start() {
+        return new Promise((resolve) => {
+            this.server = http.createServer((req, res) => this.handle(req, res));
+            this.server.listen(this.port, '127.0.0.1', () => {
+                const addr = this.server.address();
+                this.port = addr.port;
+                resolve(addr.port);
+            });
+        });
+    }
+    stop() {
+        return new Promise((resolve) => {
+            if (this.server)
+                this.server.close(() => resolve());
+            else
+                resolve();
+        });
+    }
+    setHandlers(handlers) { this.handlers = handlers; }
+    setTask(task) { this.currentTask = task; }
+    waitForReview() {
+        return new Promise((resolve) => { this.reviewResolve = resolve; });
+    }
+    waitForResult() {
+        return new Promise((resolve) => { this.resultResolve = resolve; });
+    }
+    handle(req, res) {
+        const url = req.url || '';
+        const method = req.method || '';
+        res.setHeader('Access-Control-Allow-Origin', '*');
+        res.setHeader('Access-Control-Allow-Methods', 'GET,POST,OPTIONS');
+        res.setHeader('Access-Control-Allow-Headers', 'Content-Type');
+        if (method === 'OPTIONS') {
+            res.writeHead(200);
+            res.end();
+            return;
+        }
+        if (method === 'GET' && url === '/health') {
+            this.json(res, 200, { ok: true });
+            return;
+        }
+        if (method === 'GET' && url === '/task') {
+            if (!this.currentTask) {
+                this.json(res, 404, { error: 'No active task' });
+                return;
+            }
+            const { delegate, ...safe } = this.currentTask;
+            this.json(res, 200, { ...safe, canDelegate: !!delegate });
+            return;
+        }
+        if (method === 'POST' && url === '/delegate') {
+            this.readBody(req, async (body) => {
+                if (!this.handlers?.delegate) {
+                    this.json(res, 400, { error: 'Delegation not available' });
+                    return;
+                }
+                try {
+                    const { subtasks } = body;
+                    if (!Array.isArray(subtasks)) {
+                        this.json(res, 400, { error: 'subtasks must be an array' });
+                        return;
+                    }
+                    const results = await this.handlers.delegate(subtasks);
+                    this.json(res, 200, { results });
+                }
+                catch (err) {
+                    this.json(res, 500, { error: err.message });
+                }
+            });
+            return;
+        }
+        if (method === 'POST' && url === '/submit-review') {
+            this.readBody(req, (body) => {
+                if (!this.reviewResolve) {
+                    this.json(res, 400, { error: 'No review pending' });
+                    return;
+                }
+                const result = {
+                    approved: !!body.approved,
+                    confidence: typeof body.confidence === 'number' ? body.confidence : 0.5,
+                    feedback: body.feedback || '',
+                };
+                this.reviewResolve(result);
+                this.reviewResolve = null;
+                this.json(res, 200, { ok: true });
+            });
+            return;
+        }
+        if (method === 'POST' && url === '/submit-result') {
+            this.readBody(req, (body) => {
+                if (!this.resultResolve) {
+                    this.json(res, 400, { error: 'No result pending' });
+                    return;
+                }
+                const result = {
+                    status: body.status || 'completed',
+                    output: body.output || '',
+                    artifacts: body.artifacts,
+                    usage: body.usage,
+                    error: body.error,
+                };
+                this.resultResolve(result);
+                this.resultResolve = null;
+                this.json(res, 200, { ok: true });
+            });
+            return;
+        }
+        this.json(res, 404, { error: 'Not found' });
+    }
+    json(res, status, body) {
+        res.writeHead(status, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify(body));
+    }
+    readBody(req, cb) {
+        let data = '';
+        req.on('data', (chunk) => data += chunk);
+        req.on('end', () => {
+            try {
+                cb(JSON.parse(data));
+            }
+            catch {
+                cb({});
+            }
+        });
+    }
+}
+exports.AgentServer = AgentServer;
+/**
+ * Builds the capability instructions the framework injects for the agent.
+ * The agent receives these so it knows what it can do — delegate, submit results, etc.
+ */
+function buildInstructions(baseUrl, canDelegate, task, availableAgents) {
+    const lines = [
+        '=== ROBAL FRAMEWORK ===',
+        'You are an agent managed by the Robal orchestration framework.',
+        '',
+        `Your task: ${task.prompt}`,
+    ];
+    if (task.feedback) {
+        lines.push('', `Previous attempt was rejected. Feedback: ${task.feedback}`);
+        if (task.previousOutput) {
+            lines.push('', `Your previous output was:`, task.previousOutput);
+        }
+    }
+    if (task.context?.previousOutputs?.length) {
+        lines.push('', 'Context from previous steps:', ...task.context.previousOutputs.map((o, i) => `[Step ${i + 1}]: ${o}`));
+    }
+    lines.push('', '=== AVAILABLE ACTIONS ===', '', '1. SUBMIT YOUR RESULT (required when done):', `   curl -s -X POST ${baseUrl}/submit-result -H "Content-Type: application/json" -d '{"status":"completed","output":"YOUR_OUTPUT"}'`, '   Replace YOUR_OUTPUT with your final answer/output.');
+    if (canDelegate) {
+        lines.push('', '2. DELEGATE TO SUB-AGENTS (optional — if the task is complex, break it up):', `   curl -s -X POST ${baseUrl}/delegate -H "Content-Type: application/json" -d '{"subtasks":[{"prompt":"subtask 1","name":"agent-name"},{"prompt":"subtask 2","name":"agent-name"}]}'`, '   This returns {"results":["output1","output2"]} with each sub-agent\'s output.', '   You can then use these results to compose your final answer.', '   Use the "name" field to pick which agent handles each subtask.');
+        if (availableAgents?.length) {
+            lines.push('', '   Available agents you can delegate to:', ...availableAgents.map(a => `   - "${a.name}": ${a.description}`));
+        }
+    }
+    lines.push('', '3. READ FULL TASK DETAILS (optional):', `   curl -s ${baseUrl}/task`, '', '=== INSTRUCTIONS ===', canDelegate
+        ? 'Decide: either do the work yourself, or delegate subtasks to sub-agents. Then submit your result.'
+        : 'Do the work and submit your result.', '===================');
+    return lines.join('\n');
+}
+/**
+ * Wraps any external process as an Agent by exposing the bridge server.
+ *
+ * Two modes:
+ * - **Simple mode**: just pass `command` — the framework builds the full prompt
+ *   with capability instructions and pipes it to your command.
+ * - **Custom mode**: pass `run` for full control over how the agent is invoked.
+ *
+ * The agent process receives env vars including ROBAL_INSTRUCTIONS which contains
+ * the full prompt with task, context, and available actions (delegate, submit, etc).
+ * The agent just needs to follow the instructions.
+ *
+ * @example
+ * ```ts
+ * // Simple: framework builds prompt, pipes to your CLI
+ * const { agent } = await createAgent({
+ *   command: 'kiro-cli chat --no-interactive --trust-all-tools',
+ * });
+ *
+ * // Custom: full control
+ * const { agent } = await createAgent({
+ *   run: async (task, env) => {
+ *     execSync(`my-agent`, { env: { ...process.env, ...env } });
+ *   },
+ * });
+ * ```
+ */
+async function createAgent(opts) {
+    const bridge = new AgentServer(opts.port || 0);
+    const port = await bridge.start();
+    const baseUrl = `http://127.0.0.1:${port}`;
+    const timeout = opts.timeoutMs ?? 300_000;
+    const agent = {
+        async execute(task) {
+            bridge.setTask(task);
+            bridge.setHandlers({
+                delegate: task.delegate || (async () => { throw new Error('Delegation not available at this depth'); }),
+                submitReview: () => { },
+            });
+            const canDelegate = !!task.delegate;
+            const instructions = buildInstructions(baseUrl, canDelegate, task, opts.availableAgents);
+            const env = {
+                ROBAL_BRIDGE_URL: baseUrl,
+                ROBAL_TASK_URL: `${baseUrl}/task`,
+                ROBAL_DELEGATE_URL: `${baseUrl}/delegate`,
+                ROBAL_RESULT_URL: `${baseUrl}/submit-result`,
+                ROBAL_TASK_ID: task.id,
+                ROBAL_TEAM_ID: task.teamId,
+                ROBAL_PROMPT: task.prompt,
+                ROBAL_CAN_DELEGATE: canDelegate ? 'true' : 'false',
+                ROBAL_DEPTH: String(task.depth ?? 0),
+                ROBAL_INSTRUCTIONS: instructions,
+                ...(task.feedback ? { ROBAL_FEEDBACK: task.feedback } : {}),
+            };
+            try {
+                const resultPromise = bridge.waitForResult();
+                let runResult;
+                if (opts.command) {
+                    // Command mode: pipe instructions to the command
+                    // Always wait for bridge result — ignore stdout
+                    await new Promise((resolve, reject) => {
+                        const child = require('child_process').spawn('bash', ['-c', opts.command], {
+                            env: { ...process.env, ...env },
+                            timeout: timeout,
+                        });
+                        child.stdin.write(env.ROBAL_INSTRUCTIONS);
+                        child.stdin.end();
+                        child.stdout.on('data', () => { });
+                        child.stderr.on('data', () => { });
+                        child.on('close', (code) => code === 0 ? resolve() : reject(new Error(`exit ${code}`)));
+                        child.on('error', reject);
+                    });
+                    runResult = undefined;
+                }
+                else if (opts.run) {
+                    runResult = await opts.run(task, env);
+                }
+                else {
+                    throw new Error('Either command or run must be provided');
+                }
+                // If run() returned a string, use it directly (return mode)
+                if (typeof runResult === 'string') {
+                    return { status: 'completed', output: runResult };
+                }
+                // Otherwise wait for agent to POST to /submit-result (bridge mode)
+                const timer = setTimeout(() => {
+                    // Resolve with timeout error if agent never posts
+                    bridge.resultResolve?.({ status: 'failed', output: '', error: `Agent did not submit result within ${timeout}ms` });
+                }, timeout);
+                const result = await resultPromise;
+                clearTimeout(timer);
+                return result;
+            }
+            catch (err) {
+                return { status: 'failed', output: '', error: err.message };
+            }
+        },
+    };
+    return { agent, bridge };
+}
+/**
+ * Creates a Reviewer that waits for an external process to POST to /submit-review.
+ */
+function createReviewer(bridge) {
+    return {
+        reviewer: {
+            async review(task, output) {
+                bridge.setTask({ ...task, prompt: `Review: ${task.prompt}\n\nOutput: ${output.output}` });
+                return bridge.waitForReview();
+            },
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/team.d.ts

@@ -0,0 +1,17 @@
+import type { TeamConfig, TaskInput, TaskOutput, OrchestratorEvent, Agent } from './types';
+export declare class Team {
+    readonly id: string;
+    readonly name: string;
+    private config;
+    private emit;
+    constructor(id: string, config: TeamConfig, emit: (event: OrchestratorEvent) => void);
+    /** Run a single task through this team's agent + review cycle. */
+    run(prompt: string, context?: TaskInput['context']): Promise<TaskOutput>;
+    /** Delegate subtasks to parallel child workers under this team. Optionally pass a different agent per subtask. */
+    delegate(subtasks: {
+        prompt: string;
+        name?: string;
+        agent?: Agent;
+    }[], parentPrompt: string, context?: TaskInput['context']): Promise<string[]>;
+}
+//# sourceMappingURL=team.d.ts.map

package/dist/team.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team.d.ts","sourceRoot":"","sources":["../src/team.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAe,iBAAiB,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAKxG,qBAAa,IAAI;IACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,IAAI,CAAqC;gBAErC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI;IAOpF,kEAAkE;IAC5D,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IA6B9E,kHAAkH;IAC5G,QAAQ,CAAC,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAkBtJ"}