agent-orchestration 0.5.0 → 0.6.0

package/dist/utils/cursorCli.test.js

@@ -0,0 +1,134 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { buildCursorAgentArgs, buildCursorPrompt, shouldUseCursorWorktreeForTask } from './cursorCli.js';
+import { TaskComplexity, TaskPriority, TaskStatus } from '../models.js';
+import { buildDelegationResumePrompt } from './delegationKnowledge.js';
+const config = {
+    binary: 'agent',
+    runtime: 'cli',
+    defaultMode: 'agent',
+    defaultForce: true,
+    autoApproveMcps: true,
+    trustWorkspace: true,
+    useCreateChat: true,
+    logDir: '.agent-orchestration/providers/cursor',
+    preferWorktreeFor: [TaskComplexity.MODERATE, TaskComplexity.COMPLEX],
+    recoveryStaleAfterMs: 10 * 60 * 1000,
+};
+const baseTask = {
+    id: 'task_123',
+    title: 'Implement Cursor delegation',
+    description: 'Launch delegated Cursor agents from orchestrator tasks.',
+    status: TaskStatus.PENDING,
+    priority: TaskPriority.HIGH,
+    complexity: TaskComplexity.COMPLEX,
+    researchReady: true,
+    createdBy: null,
+    assignedTo: null,
+    dependencies: [],
+    metadata: {},
+    output: null,
+    createdAt: new Date('2026-01-01T00:00:00.000Z'),
+    updatedAt: new Date('2026-01-01T00:00:00.000Z'),
+    startedAt: null,
+    completedAt: null,
+};
+test('uses worktrees for moderate and complex tasks by default', () => {
+    assert.equal(shouldUseCursorWorktreeForTask(baseTask, config), true);
+    assert.equal(shouldUseCursorWorktreeForTask({ ...baseTask, complexity: TaskComplexity.SIMPLE }, config), false);
+});
+test('builds a non-interactive Cursor agent command with approvals', () => {
+    const args = buildCursorAgentArgs({
+        config,
+        cwd: '/tmp/project',
+        prompt: 'Solve the task.',
+        chatId: 'chat_123',
+        mode: 'plan',
+        cloud: false,
+        model: 'gpt-5.2',
+        useWorktree: true,
+        force: true,
+    });
+    assert.deepEqual(args.slice(0, 6), ['--workspace', '/tmp/project', '--resume', 'chat_123', '--model', 'gpt-5.2']);
+    assert.ok(args.includes('--mode'));
+    assert.ok(args.includes('--worktree'));
+    assert.ok(args.includes('--print'));
+    assert.ok(args.includes('--force'));
+    assert.ok(args.includes('--approve-mcps'));
+    assert.ok(args.includes('--trust'));
+    assert.equal(args.at(-1), 'Solve the task.');
+});
+test('builds a prompt that includes orchestration workflow instructions', () => {
+    const prompt = buildCursorPrompt({
+        task: baseTask,
+        currentFocus: 'Make Cursor orchestration fully native.',
+        decisions: [{ key: 'runtime', value: 'Cursor CLI first, ACP later.' }],
+        research: {
+            design: [{ key: 'provider', value: 'Use a CursorProvider abstraction.' }],
+        },
+    });
+    assert.match(prompt, /Run the MCP tool `bootstrap` first\./);
+    assert.match(prompt, /Use `lock_check` and `lock_acquire` before editing shared files\./);
+    assert.match(prompt, /Current focus:/);
+    assert.match(prompt, /Recent decisions:/);
+    assert.match(prompt, /Documented research:/);
+});
+test('builds a resume prompt from live knowledge and shared context', () => {
+    const prompt = buildDelegationResumePrompt({
+        task: { ...baseTask, status: TaskStatus.IN_PROGRESS },
+        currentFocus: 'Continue syncing delegated knowledge.',
+        decisions: [
+            {
+                id: 'mem1',
+                key: 'knowledge_loop',
+                value: 'Write delegation updates back to shared memory.',
+                namespace: 'decisions',
+                createdBy: null,
+                ttlSeconds: null,
+                createdAt: new Date(),
+                updatedAt: new Date(),
+                expiresAt: null,
+            },
+        ],
+        research: {
+            context: [
+                {
+                    id: 'mem2',
+                    key: 'current_state',
+                    value: 'Cursor tasks currently sync only raw output.',
+                    namespace: 'research:task_123:context',
+                    createdBy: null,
+                    ttlSeconds: null,
+                    createdAt: new Date(),
+                    updatedAt: new Date(),
+                    expiresAt: null,
+                },
+            ],
+        },
+        knowledge: {
+            brief: [],
+            updates: [],
+            findings: [],
+            decisions: [],
+            handoff: [
+                {
+                    id: 'mem3',
+                    key: 'latest_handoff',
+                    value: { summary: 'Resume from the last sync snapshot.' },
+                    namespace: 'delegation:task_123:handoff',
+                    createdBy: null,
+                    ttlSeconds: null,
+                    createdAt: new Date(),
+                    updatedAt: new Date(),
+                    expiresAt: null,
+                },
+            ],
+        },
+    });
+    assert.match(prompt, /Live orchestration context:/);
+    assert.match(prompt, /Latest shared decisions:/);
+    assert.match(prompt, /Research still relevant to this task:/);
+    assert.match(prompt, /Latest handoff notes:/);
+    assert.match(prompt, /Continue from the latest shared state rather than redoing prior work\./);
+});
+//# sourceMappingURL=cursorCli.test.js.map

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

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

package/dist/utils/delegatedTaskRuntime.d.ts

@@ -0,0 +1,45 @@
+import { OrchestratorDatabase } from '../database.js';
+import { CursorDelegationMetadata, Task } from '../models.js';
+import { SpawnTaskResult } from '../providers/types.js';
+import { listDelegationKnowledge } from './delegationKnowledge.js';
+export interface TaskDelegationContext {
+    task: Task;
+    currentFocus: string | null;
+    decisions: ReturnType<OrchestratorDatabase['listMemory']>;
+    research: ReturnType<OrchestratorDatabase['getTaskResearch']>;
+    knowledge: ReturnType<typeof listDelegationKnowledge>;
+}
+export interface RecoverDelegatedTaskOptions {
+    mode?: 'agent' | 'plan' | 'ask';
+    model?: string;
+    useWorktree?: boolean;
+    cloud?: boolean;
+    force?: boolean;
+}
+export type RecoverDelegatedTaskResult = null | {
+    blocked: true;
+    task: Task;
+    reason: string;
+    metadata: CursorDelegationMetadata;
+} | {
+    blocked: false;
+    task: Task;
+    metadata: CursorDelegationMetadata;
+    delegated: SpawnTaskResult;
+};
+export declare function getTaskDelegationContext(db: OrchestratorDatabase, taskId: string): TaskDelegationContext | null;
+export declare function syncDelegatedTask(params: {
+    db: OrchestratorDatabase;
+    taskId: string;
+    persistKnowledge?: boolean;
+    createdBy?: string | null;
+    cwd?: string;
+}): Promise<Task | null>;
+export declare function recoverDelegatedTask(params: {
+    db: OrchestratorDatabase;
+    taskId: string;
+    options?: RecoverDelegatedTaskOptions;
+    createdBy?: string | null;
+    cwd?: string;
+}): Promise<RecoverDelegatedTaskResult>;
+//# sourceMappingURL=delegatedTaskRuntime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegatedTaskRuntime.d.ts","sourceRoot":"","sources":["../../src/utils/delegatedTaskRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,IAAI,EAAc,MAAM,cAAc,CAAC;AAE1E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EACL,uBAAuB,EAIxB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,UAAU,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC,CAAC;IAC1D,QAAQ,EAAE,UAAU,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC9D,SAAS,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,0BAA0B,GAClC,IAAI,GACJ;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,wBAAwB,CAAA;CAAE,GACjF;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,wBAAwB,CAAC;IAAC,SAAS,EAAE,eAAe,CAAA;CAAE,CAAC;AAEnG,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,oBAAoB,EACxB,MAAM,EAAE,MAAM,GACb,qBAAqB,GAAG,IAAI,CAc9B;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,EAAE,EAAE,oBAAoB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CA+CvB;AAED,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,EAAE,EAAE,oBAAoB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAiGtC"}

package/dist/utils/delegatedTaskRuntime.js

@@ -0,0 +1,147 @@
+import { TaskStatus } from '../models.js';
+import { CursorProvider, getCursorMetadata, getTaskStatusForDelegation } from '../providers/cursor.js';
+import { generateTaskDocumentation } from './autoDocumentation.js';
+import { listDelegationKnowledge, writeDelegationBrief, writeDelegationHandoff, writeDelegationSync, } from './delegationKnowledge.js';
+import { syncToActiveContext } from './contextSync.js';
+export function getTaskDelegationContext(db, taskId) {
+    const task = db.getTask(taskId);
+    if (!task) {
+        return null;
+    }
+    const focus = db.getMemory('current_focus', 'context');
+    return {
+        task,
+        currentFocus: focus ? String(focus.value) : null,
+        decisions: db.listMemory('decisions'),
+        research: db.getTaskResearch(task.id),
+        knowledge: listDelegationKnowledge(db, task.id),
+    };
+}
+export async function syncDelegatedTask(params) {
+    const { db, taskId, persistKnowledge = true, createdBy, cwd } = params;
+    const task = db.getTask(taskId);
+    if (!task) {
+        return null;
+    }
+    const metadata = getCursorMetadata(task.metadata);
+    if (!metadata) {
+        return task;
+    }
+    const provider = new CursorProvider(cwd ?? process.cwd());
+    const result = await provider.syncTask(metadata);
+    const nextStatus = getTaskStatusForDelegation(result.metadata);
+    const updates = {
+        metadata: result.metadata,
+    };
+    if (result.outputSummary && (!task.output || result.finished)) {
+        updates.output = result.outputSummary;
+    }
+    if (nextStatus && ![TaskStatus.COMPLETED, TaskStatus.FAILED, TaskStatus.CANCELLED].includes(task.status)) {
+        updates.status = nextStatus;
+    }
+    const updated = db.updateTask(task.id, updates);
+    if (updated && persistKnowledge) {
+        writeDelegationSync({
+            db,
+            task: updated,
+            metadata: result.metadata,
+            outputSummary: result.outputSummary,
+            finished: result.finished,
+            createdBy,
+        });
+        generateTaskDocumentation(db, updated.id, cwd);
+    }
+    syncToActiveContext();
+    return updated;
+}
+export async function recoverDelegatedTask(params) {
+    const { db, taskId, options, createdBy, cwd } = params;
+    const syncedTask = await syncDelegatedTask({
+        db,
+        taskId,
+        persistKnowledge: true,
+        createdBy,
+        cwd,
+    });
+    if (!syncedTask) {
+        return null;
+    }
+    const metadata = getCursorMetadata(syncedTask.metadata);
+    if (!metadata) {
+        return null;
+    }
+    if (metadata.providerRecoveryState === 'healthy' && !options?.force) {
+        return {
+            task: syncedTask,
+            blocked: true,
+            reason: 'The delegated Cursor task still appears healthy. Use force to relaunch anyway.',
+            metadata,
+        };
+    }
+    const context = getTaskDelegationContext(db, taskId);
+    if (!context) {
+        return null;
+    }
+    const provider = new CursorProvider(cwd ?? process.cwd());
+    const retryCount = (typeof metadata.providerRetryCount === 'number' ? metadata.providerRetryCount : 0) + 1;
+    const delegated = await provider.spawnTask({
+        cwd: cwd ?? process.cwd(),
+        task: {
+            ...context.task,
+            metadata: {
+                ...context.task.metadata,
+                providerRetryCount: retryCount,
+            },
+        },
+        currentFocus: context.currentFocus,
+        decisions: context.decisions,
+        research: context.research,
+        mode: options?.mode ?? (metadata.providerMode && metadata.providerMode !== 'cloud' ? metadata.providerMode : undefined),
+        model: options?.model ?? metadata.providerModel,
+        useWorktree: options?.useWorktree ?? metadata.providerWorktree,
+        cloud: options?.cloud ?? (metadata.providerMode === 'cloud'),
+        force: options?.force,
+        spawnedBy: createdBy,
+    });
+    const mergedMetadata = {
+        ...delegated.metadata,
+        providerRetryCount: retryCount,
+        providerRecoveredAt: new Date().toISOString(),
+        providerRecoveryState: 'healthy',
+        providerRecoverable: false,
+    };
+    const updated = db.updateTask(context.task.id, {
+        status: TaskStatus.IN_PROGRESS,
+        metadata: mergedMetadata,
+        output: context.task.output ?? undefined,
+    });
+    if (updated) {
+        writeDelegationBrief({
+            db,
+            task: updated,
+            currentFocus: context.currentFocus,
+            decisions: context.decisions,
+            research: context.research,
+            metadata: mergedMetadata,
+            createdBy,
+        });
+        writeDelegationHandoff({
+            db,
+            taskId: updated.id,
+            summary: `Recovered delegated Cursor task after ${metadata.providerRecoveryState ?? 'unknown'} state.`,
+            findings: metadata.providerLastError ? [metadata.providerLastError] : [],
+            nextSteps: ['Resume or sync the new delegated run.', 'Verify the recovery succeeded.'],
+            blockers: [],
+            createdBy,
+        });
+        generateTaskDocumentation(db, updated.id, cwd);
+    }
+    syncToActiveContext();
+    return {
+        task: updated ?? context.task,
+        blocked: false,
+        metadata: mergedMetadata,
+        delegated,
+    };
+}
+//# sourceMappingURL=delegatedTaskRuntime.js.map

package/dist/utils/delegatedTaskRuntime.js.map

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

package/dist/utils/delegationKnowledge.d.ts

@@ -0,0 +1,51 @@
+import { OrchestratorDatabase } from '../database.js';
+import { CursorDelegationMetadata, MemoryEntry, Task } from '../models.js';
+export type DelegationKnowledgeCategory = 'brief' | 'updates' | 'findings' | 'decisions' | 'handoff';
+export interface DelegationKnowledgeBundle {
+    brief: MemoryEntry[];
+    updates: MemoryEntry[];
+    findings: MemoryEntry[];
+    decisions: MemoryEntry[];
+    handoff: MemoryEntry[];
+}
+export declare function getDelegationNamespace(taskId: string, category: DelegationKnowledgeCategory): string;
+export declare function listDelegationKnowledge(db: OrchestratorDatabase, taskId: string): DelegationKnowledgeBundle;
+export declare function serializeMemoryEntries(entries: MemoryEntry[]): Array<{
+    key: string;
+    value: unknown;
+    updatedAt: string;
+}>;
+export declare function writeDelegationBrief(params: {
+    db: OrchestratorDatabase;
+    task: Task;
+    currentFocus: string | null;
+    decisions: MemoryEntry[];
+    research: Record<string, MemoryEntry[]>;
+    metadata: CursorDelegationMetadata;
+    createdBy?: string | null;
+}): void;
+export declare function writeDelegationSync(params: {
+    db: OrchestratorDatabase;
+    task: Task;
+    metadata: CursorDelegationMetadata;
+    outputSummary?: string;
+    finished: boolean;
+    createdBy?: string | null;
+}): void;
+export declare function writeDelegationHandoff(params: {
+    db: OrchestratorDatabase;
+    taskId: string;
+    summary: string;
+    findings?: string[];
+    nextSteps?: string[];
+    blockers?: string[];
+    createdBy?: string | null;
+}): void;
+export declare function buildDelegationResumePrompt(params: {
+    task: Task;
+    currentFocus: string | null;
+    decisions: MemoryEntry[];
+    research: Record<string, MemoryEntry[]>;
+    knowledge: DelegationKnowledgeBundle;
+}): string;
+//# sourceMappingURL=delegationKnowledge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegationKnowledge.d.ts","sourceRoot":"","sources":["../../src/utils/delegationKnowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,MAAM,2BAA2B,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAErG,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,2BAA2B,GAAG,MAAM,CAEpG;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,GAAG,yBAAyB,CAQ3G;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAMxH;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,EAAE,EAAE,oBAAoB,CAAC;IACzB,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACxC,QAAQ,EAAE,wBAAwB,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GAAG,IAAI,CAiDP;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,EAAE,EAAE,oBAAoB,CAAC;IACzB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,wBAAwB,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GAAG,IAAI,CA+CP;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,EAAE,EAAE,oBAAoB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GAAG,IAAI,CAyBP;AAUD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACxC,SAAS,EAAE,yBAAyB,CAAC;CACtC,GAAG,MAAM,CAmET"}

package/dist/utils/delegationKnowledge.js

@@ -0,0 +1,197 @@
+export function getDelegationNamespace(taskId, category) {
+    return `delegation:${taskId}:${category}`;
+}
+export function listDelegationKnowledge(db, taskId) {
+    return {
+        brief: db.listMemory(getDelegationNamespace(taskId, 'brief')),
+        updates: db.listMemory(getDelegationNamespace(taskId, 'updates')),
+        findings: db.listMemory(getDelegationNamespace(taskId, 'findings')),
+        decisions: db.listMemory(getDelegationNamespace(taskId, 'decisions')),
+        handoff: db.listMemory(getDelegationNamespace(taskId, 'handoff')),
+    };
+}
+export function serializeMemoryEntries(entries) {
+    return entries.map((entry) => ({
+        key: entry.key,
+        value: entry.value,
+        updatedAt: entry.updatedAt.toISOString(),
+    }));
+}
+export function writeDelegationBrief(params) {
+    const { db, task, currentFocus, decisions, research, metadata, createdBy } = params;
+    db.setMemory({
+        namespace: getDelegationNamespace(task.id, 'brief'),
+        key: 'task_brief',
+        value: {
+            taskId: task.id,
+            title: task.title,
+            description: task.description,
+            priority: task.priority,
+            complexity: task.complexity,
+            dependencies: task.dependencies,
+            currentFocus,
+            provider: {
+                status: metadata.providerStatus,
+                mode: metadata.providerMode,
+                chatId: metadata.providerChatId,
+                worktree: metadata.providerWorktree,
+                launchedAt: metadata.providerLaunchedAt,
+            },
+            researchCategories: Object.keys(research),
+        },
+        createdBy,
+    });
+    if (decisions.length > 0) {
+        db.setMemory({
+            namespace: getDelegationNamespace(task.id, 'decisions'),
+            key: 'decision_snapshot',
+            value: serializeMemoryEntries(decisions),
+            createdBy,
+        });
+    }
+    db.setMemory({
+        namespace: getDelegationNamespace(task.id, 'handoff'),
+        key: 'initial_handoff',
+        value: {
+            summary: `Delegated task '${task.title}' to Cursor.`,
+            nextSteps: [
+                'Resume the delegated agent as needed.',
+                'Use cursor_sync_task to refresh shared knowledge.',
+                'Use cursor_handoff_task to record a human or agent handoff.',
+            ],
+            updatedAt: new Date().toISOString(),
+        },
+        createdBy,
+    });
+}
+export function writeDelegationSync(params) {
+    const { db, task, metadata, outputSummary, finished, createdBy } = params;
+    const updatedAt = new Date().toISOString();
+    db.setMemory({
+        namespace: getDelegationNamespace(task.id, 'updates'),
+        key: 'last_sync',
+        value: {
+            status: metadata.providerStatus,
+            recoveryState: metadata.providerRecoveryState,
+            recoverable: metadata.providerRecoverable,
+            mode: metadata.providerMode,
+            chatId: metadata.providerChatId,
+            lastSyncAt: updatedAt,
+            finished,
+            lastError: metadata.providerLastError,
+        },
+        createdBy,
+    });
+    if (outputSummary) {
+        db.setMemory({
+            namespace: getDelegationNamespace(task.id, 'findings'),
+            key: 'latest_output',
+            value: {
+                summary: outputSummary,
+                status: metadata.providerStatus,
+                recoveryState: metadata.providerRecoveryState,
+                updatedAt,
+            },
+            createdBy,
+        });
+    }
+    if (finished) {
+        db.setMemory({
+            namespace: getDelegationNamespace(task.id, 'handoff'),
+            key: 'latest_handoff',
+            value: {
+                summary: outputSummary ?? `Task '${task.title}' finished with status ${metadata.providerStatus}.`,
+                status: metadata.providerStatus,
+                recoveryState: metadata.providerRecoveryState,
+                updatedAt,
+            },
+            createdBy,
+        });
+    }
+}
+export function writeDelegationHandoff(params) {
+    const { db, taskId, summary, findings, nextSteps, blockers, createdBy } = params;
+    const updatedAt = new Date().toISOString();
+    db.setMemory({
+        namespace: getDelegationNamespace(taskId, 'handoff'),
+        key: 'manual_handoff',
+        value: {
+            summary,
+            findings: findings ?? [],
+            nextSteps: nextSteps ?? [],
+            blockers: blockers ?? [],
+            updatedAt,
+        },
+        createdBy,
+    });
+    if (findings && findings.length > 0) {
+        db.setMemory({
+            namespace: getDelegationNamespace(taskId, 'findings'),
+            key: 'manual_findings',
+            value: findings,
+            createdBy,
+        });
+    }
+}
+function formatEntryValue(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    return JSON.stringify(value, null, 2);
+}
+export function buildDelegationResumePrompt(params) {
+    const { task, currentFocus, decisions, research, knowledge } = params;
+    const lines = [
+        `Resume work on orchestrated task '${task.title}'.`,
+        '',
+        'Live orchestration context:',
+        `- Task ID: ${task.id}`,
+        `- Status: ${task.status}`,
+        `- Priority: ${task.priority}`,
+        `- Complexity: ${task.complexity}`,
+        `- Current focus: ${currentFocus ?? 'Not set.'}`,
+    ];
+    if (decisions.length > 0) {
+        lines.push('', 'Latest shared decisions:');
+        for (const entry of decisions.slice(0, 8)) {
+            lines.push(`- ${entry.key}: ${formatEntryValue(entry.value)}`);
+        }
+    }
+    const researchCategories = Object.keys(research);
+    if (researchCategories.length > 0) {
+        lines.push('', 'Research still relevant to this task:');
+        for (const category of researchCategories) {
+            lines.push(`- ${category}:`);
+            for (const entry of research[category].slice(0, 8)) {
+                lines.push(`  - ${entry.key}: ${formatEntryValue(entry.value)}`);
+            }
+        }
+    }
+    if (knowledge.brief.length > 0) {
+        lines.push('', 'Original delegation brief:');
+        for (const entry of knowledge.brief.slice(0, 3)) {
+            lines.push(`- ${entry.key}: ${formatEntryValue(entry.value)}`);
+        }
+    }
+    if (knowledge.updates.length > 0) {
+        lines.push('', 'Recent delegation updates:');
+        for (const entry of knowledge.updates.slice(0, 3)) {
+            lines.push(`- ${entry.key}: ${formatEntryValue(entry.value)}`);
+        }
+    }
+    if (knowledge.findings.length > 0) {
+        lines.push('', 'Known findings from prior runs:');
+        for (const entry of knowledge.findings.slice(0, 3)) {
+            lines.push(`- ${entry.key}: ${formatEntryValue(entry.value)}`);
+        }
+    }
+    if (knowledge.handoff.length > 0) {
+        lines.push('', 'Latest handoff notes:');
+        for (const entry of knowledge.handoff.slice(0, 3)) {
+            lines.push(`- ${entry.key}: ${formatEntryValue(entry.value)}`);
+        }
+    }
+    lines.push('', 'Continue from the latest shared state rather than redoing prior work.', 'Before editing, re-check locks and preserve the orchestration workflow.', 'When done, write a concise summary and complete the task.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=delegationKnowledge.js.map

package/dist/utils/delegationKnowledge.js.map

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

package/dist/utils/delegationRecovery.d.ts

@@ -0,0 +1,17 @@
+import { CursorDelegationMetadata, ProviderRecoveryState } from '../models.js';
+export interface DelegationHealth {
+    state: ProviderRecoveryState;
+    recoverable: boolean;
+    reason?: string;
+    hints: string[];
+    exitCode?: number;
+}
+export declare function evaluateDelegationHealth(params: {
+    metadata: CursorDelegationMetadata;
+    isRunning: boolean;
+    exitCode?: number;
+    now?: Date;
+    staleAfterMs: number;
+}): DelegationHealth;
+export declare function getRecoveryDisplayLine(metadata: CursorDelegationMetadata): string;
+//# sourceMappingURL=delegationRecovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegationRecovery.d.ts","sourceRoot":"","sources":["../../src/utils/delegationRecovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE/E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,qBAAqB,CAAC;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,QAAQ,EAAE,wBAAwB,CAAC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,gBAAgB,CA6DnB;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,CAIjF"}