agent-orchestration 0.5.0 → 0.6.0

package/dist/utils/delegationRecovery.js

@@ -0,0 +1,63 @@
+export function evaluateDelegationHealth(params) {
+    const { metadata, isRunning, exitCode, staleAfterMs } = params;
+    const now = params.now ?? new Date();
+    if (exitCode !== undefined) {
+        if (exitCode === 0) {
+            return {
+                state: 'completed',
+                recoverable: false,
+                exitCode,
+                hints: ['Use `cursor_resume_task` to inspect the last session if needed.'],
+            };
+        }
+        return {
+            state: 'failed',
+            recoverable: true,
+            exitCode,
+            reason: `Cursor run exited with code ${exitCode}.`,
+            hints: [
+                'Run `cursor_sync_task` to capture the latest output and recovery hints.',
+                'Inspect the provider log for the failure details.',
+                'Use `cursor_recover_task` to relaunch with the latest shared context.',
+            ],
+        };
+    }
+    if (isRunning) {
+        return {
+            state: 'healthy',
+            recoverable: false,
+            hints: ['The delegated process is still running. Use `cursor_sync_task` for a fresh snapshot.'],
+        };
+    }
+    const referenceTime = metadata.providerLastSyncAt ?? metadata.providerLaunchedAt;
+    if (referenceTime) {
+        const ageMs = now.getTime() - new Date(referenceTime).getTime();
+        if (ageMs >= staleAfterMs) {
+            return {
+                state: 'stale',
+                recoverable: true,
+                reason: `No running process or exit code was found after ${Math.round(ageMs / 1000)}s.`,
+                hints: [
+                    'The delegated process appears stale or crashed without a clean exit.',
+                    'Use `cursor_recover_task` to relaunch with the latest shared knowledge.',
+                    'Record a `cursor_handoff_task` note if a human diagnosis is needed first.',
+                ],
+            };
+        }
+    }
+    return {
+        state: 'unknown',
+        recoverable: true,
+        reason: 'The delegated process is not running and no exit code was captured yet.',
+        hints: [
+            'Run `cursor_sync_task` again after a short wait.',
+            'Use `cursor_recover_task` if the process does not come back.',
+        ],
+    };
+}
+export function getRecoveryDisplayLine(metadata) {
+    const state = metadata.providerRecoveryState ?? 'unknown';
+    const recoverable = metadata.providerRecoverable ? 'recoverable' : 'stable';
+    return `${state} (${recoverable})`;
+}
+//# sourceMappingURL=delegationRecovery.js.map

package/dist/utils/delegationRecovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegationRecovery.js","sourceRoot":"","sources":["../../src/utils/delegationRecovery.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,wBAAwB,CAAC,MAMxC;IACC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IAC/D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IAErC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO;gBACL,KAAK,EAAE,WAAW;gBAClB,WAAW,EAAE,KAAK;gBAClB,QAAQ;gBACR,KAAK,EAAE,CAAC,iEAAiE,CAAC;aAC3E,CAAC;QACJ,CAAC;QAED,OAAO;YACL,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,IAAI;YACjB,QAAQ;YACR,MAAM,EAAE,+BAA+B,QAAQ,GAAG;YAClD,KAAK,EAAE;gBACL,yEAAyE;gBACzE,mDAAmD;gBACnD,uEAAuE;aACxE;SACF,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,KAAK;YAClB,KAAK,EAAE,CAAC,sFAAsF,CAAC;SAChG,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,QAAQ,CAAC,kBAAkB,IAAI,QAAQ,CAAC,kBAAkB,CAAC;IACjF,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE,CAAC;QAChE,IAAI,KAAK,IAAI,YAAY,EAAE,CAAC;YAC1B,OAAO;gBACL,KAAK,EAAE,OAAO;gBACd,WAAW,EAAE,IAAI;gBACjB,MAAM,EAAE,mDAAmD,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI;gBACvF,KAAK,EAAE;oBACL,sEAAsE;oBACtE,yEAAyE;oBACzE,2EAA2E;iBAC5E;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,yEAAyE;QACjF,KAAK,EAAE;YACL,kDAAkD;YAClD,8DAA8D;SAC/D;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAkC;IACvE,MAAM,KAAK,GAAG,QAAQ,CAAC,qBAAqB,IAAI,SAAS,CAAC;IAC1D,MAAM,WAAW,GAAG,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC5E,OAAO,GAAG,KAAK,KAAK,WAAW,GAAG,CAAC;AACrC,CAAC"}

package/dist/utils/delegationRecovery.test.d.ts

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

package/dist/utils/delegationRecovery.test.d.ts.map

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

package/dist/utils/delegationRecovery.test.js

@@ -0,0 +1,42 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { evaluateDelegationHealth } from './delegationRecovery.js';
+const baseMetadata = {
+    provider: 'cursor',
+    providerRuntime: 'cli',
+    providerStatus: 'running',
+    providerChatId: 'chat_123',
+    providerLaunchedAt: '2026-01-01T00:00:00.000Z',
+    providerLastSyncAt: '2026-01-01T00:05:00.000Z',
+};
+test('marks non-zero exit codes as recoverable failures', () => {
+    const result = evaluateDelegationHealth({
+        metadata: baseMetadata,
+        isRunning: false,
+        exitCode: 1,
+        staleAfterMs: 60_000,
+    });
+    assert.equal(result.state, 'failed');
+    assert.equal(result.recoverable, true);
+    assert.match(result.reason ?? '', /exited with code 1/);
+});
+test('marks missing process without exit code as stale after threshold', () => {
+    const result = evaluateDelegationHealth({
+        metadata: baseMetadata,
+        isRunning: false,
+        now: new Date('2026-01-01T00:20:00.000Z'),
+        staleAfterMs: 5 * 60 * 1000,
+    });
+    assert.equal(result.state, 'stale');
+    assert.equal(result.recoverable, true);
+});
+test('marks running delegations as healthy', () => {
+    const result = evaluateDelegationHealth({
+        metadata: baseMetadata,
+        isRunning: true,
+        staleAfterMs: 60_000,
+    });
+    assert.equal(result.state, 'healthy');
+    assert.equal(result.recoverable, false);
+});
+//# sourceMappingURL=delegationRecovery.test.js.map

package/dist/utils/delegationRecovery.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegationRecovery.test.js","sourceRoot":"","sources":["../../src/utils/delegationRecovery.test.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAGnE,MAAM,YAAY,GAA6B;IAC7C,QAAQ,EAAE,QAAQ;IAClB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,SAAS;IACzB,cAAc,EAAE,UAAU;IAC1B,kBAAkB,EAAE,0BAA0B;IAC9C,kBAAkB,EAAE,0BAA0B;CAC/C,CAAC;AAEF,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;IAC7D,MAAM,MAAM,GAAG,wBAAwB,CAAC;QACtC,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,KAAK;QAChB,QAAQ,EAAE,CAAC;QACX,YAAY,EAAE,MAAM;KACrB,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACvC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,oBAAoB,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kEAAkE,EAAE,GAAG,EAAE;IAC5E,MAAM,MAAM,GAAG,wBAAwB,CAAC;QACtC,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,KAAK;QAChB,GAAG,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC;QACzC,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;KAC5B,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,sCAAsC,EAAE,GAAG,EAAE;IAChD,MAAM,MAAM,GAAG,wBAAwB,CAAC;QACtC,QAAQ,EAAE,YAAY;QACtB,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,MAAM;KACrB,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACtC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC"}

package/dist/utils/orchestratorConfig.d.ts

@@ -0,0 +1,19 @@
+import { CursorProviderMode, ProviderRuntime, TaskComplexity } from '../models.js';
+export interface CursorProviderConfig {
+    binary: string;
+    runtime: ProviderRuntime;
+    defaultMode: Exclude<CursorProviderMode, 'cloud'>;
+    defaultForce: boolean;
+    autoApproveMcps: boolean;
+    trustWorkspace: boolean;
+    useCreateChat: boolean;
+    logDir: string;
+    defaultModel?: string;
+    preferWorktreeFor: TaskComplexity[];
+    recoveryStaleAfterMs: number;
+}
+export interface OrchestratorConfig {
+    cursor: CursorProviderConfig;
+}
+export declare function loadOrchestratorConfig(cwd?: string): OrchestratorConfig;
+//# sourceMappingURL=orchestratorConfig.d.ts.map

package/dist/utils/orchestratorConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestratorConfig.d.ts","sourceRoot":"","sources":["../../src/utils/orchestratorConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,kBAAkB,EAElB,eAAe,EACf,cAAc,EACf,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,eAAe,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;IAClD,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,cAAc,EAAE,CAAC;IACpC,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAqBD,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAsB,GAAG,kBAAkB,CAmBtF"}

package/dist/utils/orchestratorConfig.js

@@ -0,0 +1,38 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { DEFAULT_CURSOR_WORKTREE_COMPLEXITIES, } from '../models.js';
+const DEFAULT_CONFIG = {
+    cursor: {
+        binary: process.env.CURSOR_AGENT_BINARY || 'agent',
+        runtime: 'cli',
+        defaultMode: 'agent',
+        defaultForce: true,
+        autoApproveMcps: true,
+        trustWorkspace: true,
+        useCreateChat: true,
+        logDir: path.join('.agent-orchestration', 'providers', 'cursor'),
+        preferWorktreeFor: DEFAULT_CURSOR_WORKTREE_COMPLEXITIES,
+        recoveryStaleAfterMs: 10 * 60 * 1000,
+    },
+};
+export function loadOrchestratorConfig(cwd = process.cwd()) {
+    const configPath = path.join(cwd, 'agent-orchestration.config.json');
+    if (!fs.existsSync(configPath)) {
+        return DEFAULT_CONFIG;
+    }
+    try {
+        const content = fs.readFileSync(configPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        return {
+            cursor: {
+                ...DEFAULT_CONFIG.cursor,
+                ...parsed.cursor,
+                preferWorktreeFor: parsed.cursor?.preferWorktreeFor ?? DEFAULT_CONFIG.cursor.preferWorktreeFor,
+            },
+        };
+    }
+    catch {
+        return DEFAULT_CONFIG;
+    }
+}
+//# sourceMappingURL=orchestratorConfig.js.map

package/dist/utils/orchestratorConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestratorConfig.js","sourceRoot":"","sources":["../../src/utils/orchestratorConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAEL,oCAAoC,GAGrC,MAAM,cAAc,CAAC;AAwBtB,MAAM,cAAc,GAAuB;IACzC,MAAM,EAAE;QACN,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,OAAO;QAClD,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,OAAO;QACpB,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,IAAI;QACrB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;QACnB,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,WAAW,EAAE,QAAQ,CAAC;QAChE,iBAAiB,EAAE,oCAAoC;QACvD,oBAAoB,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;KACrC;CACF,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAChE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iCAAiC,CAAC,CAAC;IACrE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAsB,CAAC;QACxD,OAAO;YACL,MAAM,EAAE;gBACN,GAAG,cAAc,CAAC,MAAM;gBACxB,GAAG,MAAM,CAAC,MAAM;gBAChB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,IAAI,cAAc,CAAC,MAAM,CAAC,iBAAiB;aAC/F;SACF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,cAAc,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/utils/subprocess.d.ts

@@ -0,0 +1,27 @@
+export interface CommandResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number | null;
+}
+export interface DetachedCommandInput {
+    command: string;
+    args: string[];
+    cwd: string;
+    logPath: string;
+    exitCodePath: string;
+    env?: NodeJS.ProcessEnv;
+}
+export interface DetachedCommandResult {
+    pid: number;
+    command: string;
+}
+export declare function runCommand(command: string, args: string[], options?: {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}): CommandResult;
+export declare function commandExists(command: string, cwd?: string): boolean;
+export declare function formatCommand(command: string, args: string[]): string;
+export declare function spawnDetachedCommand(input: DetachedCommandInput): DetachedCommandResult;
+export declare function isProcessRunning(pid: number | undefined): boolean;
+//# sourceMappingURL=subprocess.d.ts.map

package/dist/utils/subprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess.d.ts","sourceRoot":"","sources":["../../src/utils/subprocess.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,GAClD,aAAa,CAaf;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAKnF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAUrE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CA+CvF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAWjE"}

package/dist/utils/subprocess.js

@@ -0,0 +1,84 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { spawn, spawnSync } from 'child_process';
+export function runCommand(command, args, options) {
+    const result = spawnSync(command, args, {
+        cwd: options?.cwd,
+        env: options?.env,
+        encoding: 'utf-8',
+    });
+    return {
+        success: result.status === 0,
+        stdout: result.stdout ?? '',
+        stderr: result.stderr ?? '',
+        exitCode: result.status,
+    };
+}
+export function commandExists(command, cwd = process.cwd()) {
+    const probe = process.platform === 'win32'
+        ? runCommand('where', [command], { cwd })
+        : runCommand('which', [command], { cwd });
+    return probe.success;
+}
+export function formatCommand(command, args) {
+    const shellQuote = (value) => {
+        if (/^[A-Za-z0-9_./:=+-]+$/.test(value)) {
+            return value;
+        }
+        return `'${value.replace(/'/g, `'\\''`)}'`;
+    };
+    return [command, ...args].map(shellQuote).join(' ');
+}
+export function spawnDetachedCommand(input) {
+    fs.mkdirSync(path.dirname(input.logPath), { recursive: true });
+    fs.mkdirSync(path.dirname(input.exitCodePath), { recursive: true });
+    const encodedPayload = Buffer.from(JSON.stringify({
+        ...input,
+        env: { ...process.env, ...input.env },
+    }), 'utf-8').toString('base64');
+    const wrapper = `
+const fs = require('fs');
+const { spawn } = require('child_process');
+const payload = JSON.parse(Buffer.from(process.argv[1], 'base64').toString('utf8'));
+const stream = fs.createWriteStream(payload.logPath, { flags: 'a' });
+const child = spawn(payload.command, payload.args, {
+  cwd: payload.cwd,
+  env: payload.env,
+  stdio: ['ignore', 'pipe', 'pipe'],
+});
+child.stdout.on('data', (chunk) => stream.write(chunk));
+child.stderr.on('data', (chunk) => stream.write(chunk));
+child.on('error', (error) => {
+  stream.write(String(error) + '\\n');
+  fs.writeFileSync(payload.exitCodePath, '1', 'utf-8');
+  stream.end(() => process.exit(0));
+});
+child.on('close', (code) => {
+  fs.writeFileSync(payload.exitCodePath, String(code ?? 0), 'utf-8');
+  stream.end(() => process.exit(0));
+});
+`;
+    const child = spawn(process.execPath, ['-e', wrapper, encodedPayload], {
+        cwd: input.cwd,
+        detached: true,
+        stdio: 'ignore',
+    });
+    child.unref();
+    return {
+        pid: child.pid ?? -1,
+        command: formatCommand(input.command, input.args),
+    };
+}
+export function isProcessRunning(pid) {
+    if (!pid || pid <= 0) {
+        return false;
+    }
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=subprocess.js.map

package/dist/utils/subprocess.js.map

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

package/package.json

@@ -1,18 +1,29 @@
 {
   "name": "agent-orchestration",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Agent Orchestration - MCP server for multi-agent coordination across IDEs and CLI tools",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
     "agent-orchestration": "dist/bin/cli.js"
   },
+  "files": [
+    "dist",
+    "templates",
+    ".cursor/rules",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
+    "build": "node ./node_modules/typescript/bin/tsc",
+    "dev": "node ./node_modules/typescript/bin/tsc --watch",
     "start": "node dist/index.js",
-    "lint": "eslint src --ext .ts",
-    "clean": "rm -rf dist"
+    "lint": "node ./node_modules/typescript/bin/tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test dist/**/*.test.js",
+    "clean": "rm -rf dist",
+    "prepack": "npm run build",
+    "release": "release-it"
   },
   "keywords": [
     "mcp",
@@ -46,6 +57,7 @@
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.12",
     "@types/node": "^22.10.5",
+    "release-it": "^19.2.2",
     "typescript": "^5.7.3"
   },
   "engines": {

package/templates/AGENTS.md

@@ -0,0 +1,164 @@
+# AGENTS.md
+
+This project uses **Agent Orchestration** for multi-agent coordination.
+
+## MCP Server Setup
+
+Add this to your IDE's MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "agent-orchestration": {
+      "command": "npx",
+      "args": ["-y", "agent-orchestration", "serve"],
+      "env": {
+        "MCP_ORCH_SYNC_CONTEXT": "true"
+      }
+    }
+  }
+}
+```
+
+**Note**: Run from your project root. The server uses the current directory.
+
+---
+
+## First Action: Bootstrap
+
+Before doing any work, you MUST run:
+
+```
+bootstrap
+```
+
+**Important**: `bootstrap` is an MCP **tool invocation inside your agent/IDE**, not a terminal command.
+
+This registers you with the orchestrator and shows:
+- Current project focus
+- Tasks assigned to you
+- Recent decisions
+
+---
+
+## If You Have a Specific Task
+
+If you were given a specific task to work on, run:
+
+```
+claim_todo:
+  title: "<the task title>"
+```
+
+This registers you AND claims the task in one call.
+
+---
+
+## Available Tools
+
+### Session Management
+| Tool | Description |
+|------|-------------|
+| `bootstrap` | Initialize session: register, get focus, tasks, decisions |
+| `claim_todo` | Register + claim a task in one call |
+| `agent_whoami` | Get your current agent info |
+
+### Agent Coordination
+| Tool | Description |
+|------|-------------|
+| `agent_register` | Register with the orchestration system |
+| `agent_heartbeat` | Send heartbeat to indicate you're active |
+| `agent_list` | List all registered agents |
+| `agent_unregister` | Unregister (releases all locks) |
+
+### Shared Memory
+| Tool | Description |
+|------|-------------|
+| `memory_set` | Store a value in shared memory |
+| `memory_get` | Retrieve a value from shared memory |
+| `memory_list` | List all keys in a namespace |
+| `memory_delete` | Delete a value from shared memory |
+
+### Task Management
+| Tool | Description |
+|------|-------------|
+| `task_create` | Create a new task |
+| `task_claim` | Claim a task to work on |
+| `task_update` | Update task status or progress |
+| `task_complete` | Mark task as completed |
+| `task_list` | List tasks with filters |
+| `is_my_turn` | Check if work is available |
+
+### Resource Locking
+| Tool | Description |
+|------|-------------|
+| `lock_acquire` | Acquire a lock on a file/resource |
+| `lock_release` | Release a held lock |
+| `lock_check` | Check if a resource is locked |
+| `coordination_status` | Get overall system status |
+
+---
+
+## Workflow for Main Orchestrator
+
+```
+1. bootstrap                          # Start session
+2. memory_set current_focus "..."     # Set project focus
+3. task_create "Feature X"            # Create tasks
+4. coordination_status                # Monitor progress
+```
+
+## Workflow for Sub-Agents
+
+```
+1. claim_todo "Feature X"             # Register + claim
+2. lock_acquire "src/feature.ts"      # Lock before editing
+3. [do the work]
+4. task_complete <task_id> "Done"     # Complete the task
+5. agent_unregister                   # Clean up
+```
+
+---
+
+## Memory Namespaces
+
+Use these namespaces for organization:
+
+| Namespace | Purpose | Example Keys |
+|-----------|---------|--------------|
+| `context` | Current state and focus | `current_focus`, `current_branch` |
+| `decisions` | Architectural decisions | `auth_strategy`, `db_choice` |
+| `findings` | Analysis results | `perf_issues`, `security_audit` |
+| `blockers` | Issues blocking progress | `api_down`, `missing_deps` |
+
+---
+
+## Coordination Patterns
+
+### Before Editing Files
+```
+lock_check: { resource: "src/file.ts" }
+lock_acquire: { resource: "src/file.ts", reason: "Implementing feature" }
+```
+
+### After Editing Files
+```
+lock_release: { resource: "src/file.ts" }
+```
+
+### Check Before Major Work
+```
+is_my_turn
+```
+
+### When Done
+```
+task_complete: { task_id: "<id>", output: "Summary of changes" }
+agent_unregister
+```
+
+---
+
+## Reference activeContext.md
+
+Check `activeContext.md` for current project state - it's auto-updated.

package/activeContext.md

@@ -1,37 +0,0 @@
-# Active Context
-
-_Last updated: Renamed to Agent Orchestration_
-
-## Current Focus
-
-Agent Orchestration - MCP server for multi-agent coordination across IDEs and CLI tools.
-
-## Active Agents
-
-_No active agents. Start the MCP server and register agents to see them here._
-
-## In Progress
-
-_No tasks in progress._
-
-## Pending Tasks
-
-_No pending tasks. Create tasks using the `task_create` tool._
-
-## Recent Decisions
-
-- **name**: Renamed from mcp-orchestrator to agent-orchestration
-- **compatibility**: Added AGENTS.md support for cross-IDE compatibility
-- **runtime**: TypeScript/Node.js for easier installation
-- **database**: better-sqlite3 for synchronous, high-performance SQLite
-
-## Context Notes
-
-- **turn_based_execution**: Agents check `is_my_turn` before starting work
-- **sub_agent_workflow**: Sub-agents use `claim_todo` to register + claim in one call
-- **shared_memory_namespaces**: context, decisions, findings, blockers
-
----
-
-_This file is auto-generated by the Agent Orchestration server._
-_Edit shared memory to update this context._