@stoneforge/smithy 0.1.0

package/dist/services/task-assignment-service.js

@@ -0,0 +1,454 @@
+/**
+ * Task Assignment Service
+ *
+ * This service provides task assignment functionality for the orchestration system.
+ * It manages the assignment of tasks to agents with orchestrator metadata tracking
+ * including branch, worktree, and session associations.
+ *
+ * Key features:
+ * - Assign tasks to agents with orchestrator metadata
+ * - Query agent workload (tasks assigned to an agent)
+ * - Query unassigned tasks
+ * - Query tasks by assignment status
+ * - Track branch, worktree, sessionId in task metadata
+ *
+ * @module
+ */
+import { createTimestamp, TaskStatus, ElementType, asElementId } from '@stoneforge/core';
+import { getOrchestratorTaskMeta, setOrchestratorTaskMeta, updateOrchestratorTaskMeta, closeTaskSessionHistory, generateBranchName, generateWorktreePath, createSlugFromTitle, } from '../types/index.js';
+import { isAgentEntity, getAgentMetadata, } from '../api/orchestrator-api.js';
+/**
+ * All valid assignment status values
+ */
+export const AssignmentStatusValues = [
+    'unassigned',
+    'assigned',
+    'in_progress',
+    'completed',
+    'merged',
+];
+// ============================================================================
+// Task Assignment Service Implementation
+// ============================================================================
+/**
+ * Implementation of the Task Assignment Service.
+ *
+ * This implementation uses the QuarryAPI for storage operations.
+ */
+export class TaskAssignmentServiceImpl {
+    api;
+    mergeRequestProvider;
+    constructor(api, mergeRequestProvider) {
+        this.api = api;
+        this.mergeRequestProvider = mergeRequestProvider;
+    }
+    // ----------------------------------------
+    // Assignment Operations
+    // ----------------------------------------
+    async assignToAgent(taskId, agentId, options) {
+        // Get and validate the task
+        const task = await this.api.get(taskId);
+        if (!task || task.type !== ElementType.TASK) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        // Note: Previously there was a guard against reassignment here, but
+        // the dispatch service needs to support task reassignment. The dispatch
+        // layer is responsible for determining when reassignment is appropriate
+        // (e.g., for handoffs). Callers who want to prevent reassignment should
+        // check task.assignee before calling assignToAgent.
+        // Get and validate the agent
+        const agent = await this.api.get(asElementId(agentId));
+        if (!agent || agent.type !== ElementType.ENTITY || !isAgentEntity(agent)) {
+            throw new Error(`Agent not found: ${agentId}`);
+        }
+        // Generate branch and worktree names if not provided
+        const slug = createSlugFromTitle(task.title);
+        const branch = options?.branch ?? generateBranchName(agent.name, taskId, slug);
+        const worktree = options?.worktree ?? generateWorktreePath(agent.name, slug);
+        // Update task assignee
+        await this.api.update(taskId, { assignee: agentId });
+        // Get existing orchestrator metadata to preserve handoff history
+        const existingMeta = getOrchestratorTaskMeta(task.metadata);
+        // Build new orchestrator metadata, preserving handoff context if this is a reassignment
+        const orchestratorMeta = {
+            assignedAgent: agentId,
+            branch: options?.branch ?? existingMeta?.handoffBranch ?? branch,
+            worktree: options?.worktree ?? existingMeta?.handoffWorktree ?? worktree,
+            sessionId: options?.sessionId,
+            mergeStatus: 'pending',
+            // Preserve handoff history from previous assignments
+            handoffHistory: existingMeta?.handoffHistory,
+        };
+        // If marking as started, add start time
+        if (options?.markAsStarted) {
+            orchestratorMeta.startedAt = createTimestamp();
+        }
+        const currentMeta = task.metadata;
+        const newMetadata = setOrchestratorTaskMeta(currentMeta, orchestratorMeta);
+        // Update status to active if marking as started
+        const updates = { metadata: newMetadata };
+        if (options?.markAsStarted) {
+            updates.status = TaskStatus.IN_PROGRESS;
+        }
+        return this.api.update(taskId, updates);
+    }
+    async unassignTask(taskId) {
+        const task = await this.api.get(taskId);
+        if (!task || task.type !== ElementType.TASK) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        // Clear assignee
+        await this.api.update(taskId, { assignee: undefined });
+        // Update orchestrator metadata - preserve branch info but clear agent-specific data
+        const currentMeta = getOrchestratorTaskMeta(task.metadata);
+        if (currentMeta) {
+            const newMeta = updateOrchestratorTaskMeta(task.metadata, {
+                assignedAgent: undefined,
+                sessionId: undefined,
+                worktree: undefined,
+                startedAt: undefined,
+            });
+            return this.api.update(taskId, { metadata: newMeta });
+        }
+        return this.api.get(taskId);
+    }
+    async startTask(taskId, sessionId) {
+        const task = await this.api.get(taskId);
+        if (!task || task.type !== ElementType.TASK) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        const updates = {
+            startedAt: createTimestamp(),
+        };
+        if (sessionId) {
+            updates.sessionId = sessionId;
+        }
+        const newMeta = updateOrchestratorTaskMeta(task.metadata, updates);
+        return this.api.update(taskId, {
+            status: TaskStatus.IN_PROGRESS,
+            metadata: newMeta,
+        });
+    }
+    async completeTask(taskId, options) {
+        const task = await this.api.get(taskId);
+        if (!task || task.type !== ElementType.TASK) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        if (task.status === TaskStatus.CLOSED || task.status === TaskStatus.REVIEW) {
+            throw new Error(`Cannot complete task ${taskId}: task is already in '${task.status}' status`);
+        }
+        const currentMeta = getOrchestratorTaskMeta(task.metadata);
+        const branch = currentMeta?.branch;
+        const currentSessionId = currentMeta?.sessionId;
+        // Close the current session's history entry
+        let metadataWithClosedSession = task.metadata;
+        if (currentSessionId) {
+            metadataWithClosedSession = closeTaskSessionHistory(metadataWithClosedSession, currentSessionId, createTimestamp());
+        }
+        // Build the base metadata updates
+        const metaUpdates = {
+            completedAt: createTimestamp(),
+            mergeStatus: 'pending',
+        };
+        // Add optional completion info
+        if (options?.summary) {
+            metaUpdates.completionSummary = options.summary;
+        }
+        if (options?.commitHash) {
+            metaUpdates.lastCommitHash = options.commitHash;
+        }
+        // PR creation is attempted when a provider is configured and not explicitly disabled
+        let mergeRequestUrl;
+        let mergeRequestId;
+        if (branch && this.mergeRequestProvider && options?.createMergeRequest !== false) {
+            const baseBranch = options?.baseBranch || 'main';
+            let body = `## Task\n\n**ID:** ${task.id}\n**Title:** ${task.title}\n\n`;
+            if (options?.summary) {
+                body += `## Summary\n\n${options.summary}\n\n`;
+            }
+            body += `---\n_Created by Stoneforge Smithy_`;
+            const mrResult = await this.mergeRequestProvider.createMergeRequest(task, {
+                title: options?.mergeRequestTitle || task.title,
+                body: options?.mergeRequestBody || body,
+                sourceBranch: branch,
+                targetBranch: baseBranch,
+            });
+            mergeRequestUrl = mrResult.url;
+            mergeRequestId = mrResult.id;
+            metaUpdates.mergeRequestUrl = mergeRequestUrl;
+            metaUpdates.mergeRequestId = mergeRequestId;
+            metaUpdates.mergeRequestProvider = this.mergeRequestProvider.name;
+        }
+        // When no provider is configured, skip PR creation but still complete the task.
+        // The merge steward can create PRs later if needed.
+        // Apply metadata updates on top of the closed session history
+        const newMeta = updateOrchestratorTaskMeta(metadataWithClosedSession, metaUpdates);
+        // Set status to REVIEW (not CLOSED) - merge steward will set CLOSED after merge
+        // Clear assignee - task is now awaiting merge review, not actively being worked on
+        const updatedTask = await this.api.update(taskId, {
+            status: TaskStatus.REVIEW,
+            assignee: undefined,
+            metadata: newMeta,
+        });
+        return {
+            task: updatedTask,
+            mergeRequestUrl,
+            mergeRequestId,
+        };
+    }
+    async handoffTask(taskId, options) {
+        const task = await this.api.get(taskId);
+        if (!task || task.type !== ElementType.TASK) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        const currentMeta = getOrchestratorTaskMeta(task.metadata);
+        const { sessionId, message, branch, worktree } = options;
+        // Close the current session's history entry using the sessionId from orchestrator metadata
+        // (the options.sessionId is the provider session ID, but we match on internal sessionId)
+        const currentSessionId = currentMeta?.sessionId;
+        let metadataWithClosedSession = task.metadata;
+        if (currentSessionId) {
+            metadataWithClosedSession = closeTaskSessionHistory(metadataWithClosedSession, currentSessionId, createTimestamp());
+        }
+        // Determine the branch and worktree to preserve
+        const handoffBranch = branch || currentMeta?.branch;
+        const handoffWorktree = worktree || currentMeta?.worktree;
+        // Build handoff history (append to existing history)
+        const existingHistory = currentMeta?.handoffHistory;
+        const handoffEntry = {
+            sessionId,
+            message,
+            branch: handoffBranch,
+            worktree: handoffWorktree,
+            handoffAt: createTimestamp(),
+        };
+        const handoffHistory = [...(existingHistory || []), handoffEntry];
+        // Append handoff note to the task's description Document
+        if (task.descriptionRef && message) {
+            try {
+                const doc = await this.api.get(asElementId(task.descriptionRef));
+                if (doc) {
+                    const handoffLine = `\n\n[AGENT HANDOFF NOTE]: ${message}`;
+                    await this.api.update(asElementId(task.descriptionRef), {
+                        content: doc.content + handoffLine,
+                    });
+                }
+            }
+            catch {
+                // Non-fatal: handoff note is also preserved in handoffHistory
+            }
+        }
+        // Update orchestrator metadata with handoff info
+        const metaUpdates = {
+            // Clear assignment but preserve branch/worktree for continuation
+            assignedAgent: undefined,
+            sessionId: undefined,
+            startedAt: undefined,
+            // Clear mergeStatus so merge steward doesn't pick up the task
+            mergeStatus: undefined,
+            // Store handoff context
+            handoffBranch,
+            handoffWorktree,
+            lastSessionId: sessionId,
+            handoffAt: createTimestamp(),
+            handoffHistory,
+        };
+        // Apply metadata updates on top of the closed session history
+        const newMeta = updateOrchestratorTaskMeta(metadataWithClosedSession, metaUpdates);
+        // Update task: clear assignee, reset status to OPEN, update metadata
+        // Note: We store the handoff note in metadata since tasks use descriptionRef
+        // Setting status to OPEN ensures dispatch daemon can pick up the task
+        return this.api.update(taskId, {
+            assignee: undefined,
+            status: TaskStatus.OPEN,
+            metadata: newMeta,
+        });
+    }
+    async updateSessionId(taskId, sessionId) {
+        const task = await this.api.get(taskId);
+        if (!task || task.type !== ElementType.TASK) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        const newMeta = updateOrchestratorTaskMeta(task.metadata, { sessionId });
+        return this.api.update(taskId, { metadata: newMeta });
+    }
+    // ----------------------------------------
+    // Workload Queries
+    // ----------------------------------------
+    async getAgentTasks(agentId, filter) {
+        return this.listAssignments({
+            ...filter,
+            agentId,
+        });
+    }
+    async getAgentWorkload(agentId) {
+        const tasks = await this.getAgentTasks(agentId);
+        const byStatus = {
+            open: 0,
+            in_progress: 0,
+            blocked: 0,
+            deferred: 0,
+            backlog: 0,
+            review: 0,
+            closed: 0,
+            tombstone: 0,
+        };
+        let inProgressCount = 0;
+        let awaitingMergeCount = 0;
+        for (const { task, orchestratorMeta } of tasks) {
+            // Count by task status
+            byStatus[task.status] = (byStatus[task.status] || 0) + 1;
+            // Count in-progress (in_progress with start time)
+            if (task.status === TaskStatus.IN_PROGRESS && orchestratorMeta?.startedAt) {
+                inProgressCount++;
+            }
+            // Count awaiting merge (review status with pending merge status)
+            if (task.status === TaskStatus.REVIEW) {
+                const mergeStatus = orchestratorMeta?.mergeStatus;
+                if (!mergeStatus || mergeStatus === 'pending' || mergeStatus === 'testing') {
+                    awaitingMergeCount++;
+                }
+            }
+        }
+        return {
+            agentId,
+            totalTasks: tasks.length,
+            byStatus,
+            inProgressCount,
+            awaitingMergeCount,
+        };
+    }
+    async agentHasCapacity(agentId) {
+        // Get the agent to check their max concurrent tasks
+        const agent = await this.api.get(asElementId(agentId));
+        if (!agent || !isAgentEntity(agent)) {
+            return false;
+        }
+        const meta = getAgentMetadata(agent);
+        const maxConcurrent = meta?.maxConcurrentTasks ?? 1;
+        // Count currently active tasks
+        const workload = await this.getAgentWorkload(agentId);
+        const activeTasks = workload.byStatus.in_progress || 0;
+        return activeTasks < maxConcurrent;
+    }
+    // ----------------------------------------
+    // Task Status Queries
+    // ----------------------------------------
+    async getUnassignedTasks(filter) {
+        const assignments = await this.listAssignments({
+            ...filter,
+            assignmentStatus: 'unassigned',
+        });
+        return assignments.map((a) => a.task);
+    }
+    async getTasksByAssignmentStatus(status, filter) {
+        return this.listAssignments({
+            ...filter,
+            assignmentStatus: status,
+        });
+    }
+    async listAssignments(filter) {
+        // Build task filter from assignment filter
+        const taskFilter = {
+            type: 'task',
+        };
+        if (filter?.taskStatus) {
+            taskFilter.status = filter.taskStatus;
+        }
+        // Push assignee filter to API level when available (M-2)
+        if (filter?.agentId !== undefined) {
+            taskFilter.assignee = filter.agentId;
+        }
+        // Get tasks (pre-filtered by assignee at API level when possible)
+        const tasks = await this.api.list(taskFilter);
+        // Convert to assignments and apply filters
+        let assignments = tasks.map((task) => ({
+            taskId: task.id,
+            task,
+            orchestratorMeta: getOrchestratorTaskMeta(task.metadata),
+        }));
+        // Apply agent filter
+        if (filter?.agentId !== undefined) {
+            assignments = assignments.filter((a) => {
+                // Check both task.assignee and orchestrator metadata
+                return (a.task.assignee === filter.agentId ||
+                    a.orchestratorMeta?.assignedAgent === filter.agentId);
+            });
+        }
+        // Apply assignment status filter
+        if (filter?.assignmentStatus !== undefined) {
+            const statuses = Array.isArray(filter.assignmentStatus)
+                ? filter.assignmentStatus
+                : [filter.assignmentStatus];
+            assignments = assignments.filter((a) => {
+                const assignmentStatus = this.determineAssignmentStatus(a);
+                return statuses.includes(assignmentStatus);
+            });
+        }
+        // Apply merge status filter
+        if (filter?.mergeStatus !== undefined) {
+            const mergeStatuses = Array.isArray(filter.mergeStatus)
+                ? filter.mergeStatus
+                : [filter.mergeStatus];
+            assignments = assignments.filter((a) => {
+                const mergeStatus = a.orchestratorMeta?.mergeStatus;
+                return mergeStatus !== undefined && mergeStatuses.includes(mergeStatus);
+            });
+        }
+        return assignments;
+    }
+    async getTasksAwaitingMerge() {
+        return this.listAssignments({
+            taskStatus: TaskStatus.REVIEW,
+            mergeStatus: ['pending', 'testing'],
+        });
+    }
+    // ----------------------------------------
+    // Private Helpers
+    // ----------------------------------------
+    /**
+     * Determines the assignment status of a task
+     */
+    determineAssignmentStatus(assignment) {
+        const { task, orchestratorMeta } = assignment;
+        // Check status-based assignment states first (regardless of assignee)
+        // REVIEW status = task completed, awaiting merge review
+        if (task.status === TaskStatus.REVIEW) {
+            return 'completed';
+        }
+        // CLOSED status = either merged or completed
+        if (task.status === TaskStatus.CLOSED) {
+            const mergeStatus = orchestratorMeta?.mergeStatus;
+            if (mergeStatus === 'merged') {
+                return 'merged';
+            }
+            // CLOSED without 'merged' status is still 'completed'
+            return 'completed';
+        }
+        // Check if unassigned (only for tasks not in terminal states)
+        const hasAssignment = task.assignee || orchestratorMeta?.assignedAgent;
+        if (!hasAssignment) {
+            return 'unassigned';
+        }
+        // Check if actively being worked on
+        if (task.status === TaskStatus.IN_PROGRESS && orchestratorMeta?.startedAt) {
+            return 'in_progress';
+        }
+        // Assigned but not started
+        return 'assigned';
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Creates a TaskAssignmentService instance
+ *
+ * @param api - The QuarryAPI instance
+ * @param mergeRequestProvider - Optional provider for creating merge requests.
+ *   When omitted, merge request creation is silently skipped.
+ */
+export function createTaskAssignmentService(api, mergeRequestProvider) {
+    return new TaskAssignmentServiceImpl(api, mergeRequestProvider);
+}
+//# sourceMappingURL=task-assignment-service.js.map

package/dist/services/task-assignment-service.js.map

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

package/dist/services/worker-task-service.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Worker Task Service
+ *
+ * This service provides the complete workflow for workers picking up tasks
+ * and working in isolated worktrees. It orchestrates:
+ * - Task dispatch to worker
+ * - Worktree creation for task isolation
+ * - Worker spawning in the worktree
+ * - Task context delivery to worker
+ * - Task completion with branch ready for merge
+ *
+ * @module
+ */
+import type { Task, ElementId, EntityId, Timestamp } from '@stoneforge/core';
+import type { QuarryAPI } from '@stoneforge/quarry';
+import type { AgentEntity } from '../api/orchestrator-api.js';
+import type { TaskAssignmentService } from './task-assignment-service.js';
+import type { AgentRegistry } from './agent-registry.js';
+import type { DispatchService, DispatchResult } from './dispatch-service.js';
+import type { WorktreeManager, CreateWorktreeResult, WorktreeInfo } from '../git/worktree-manager.js';
+import type { SpawnerService } from '../runtime/spawner.js';
+import type { SessionManager, SessionRecord } from '../runtime/session-manager.js';
+/**
+ * Options for starting a worker on a task
+ */
+export interface StartWorkerOnTaskOptions {
+    /** Custom branch name (auto-generated if not provided) */
+    branch?: string;
+    /** Custom worktree path (auto-generated if not provided) */
+    worktreePath?: string;
+    /** Base branch to create the worktree from (defaults to default branch) */
+    baseBranch?: string;
+    /** Additional initial prompt to prepend to task context */
+    additionalPrompt?: string;
+    /** Entity performing the operation */
+    performedBy?: EntityId;
+    /** Skip worktree creation (use existing working directory) */
+    skipWorktree?: boolean;
+    /** Custom working directory (used if skipWorktree is true) */
+    workingDirectory?: string;
+    /** Dispatch priority for notification */
+    priority?: number;
+}
+/**
+ * Result of starting a worker on a task
+ */
+export interface StartWorkerOnTaskResult {
+    /** The task being worked on */
+    task: Task;
+    /** The worker agent */
+    agent: AgentEntity;
+    /** The dispatch result (notification sent) */
+    dispatch: DispatchResult;
+    /** The worktree created (if applicable) */
+    worktree?: CreateWorktreeResult;
+    /** The session spawned */
+    session: SessionRecord;
+    /** The task context prompt that was sent */
+    taskContextPrompt: string;
+    /** Timestamp when the worker started */
+    startedAt: Timestamp;
+}
+/**
+ * Options for completing a task
+ */
+export interface CompleteTaskOptions {
+    /** Summary of what was accomplished */
+    summary?: string;
+    /** Commit hash for the final commit */
+    commitHash?: string;
+    /** Whether to run tests before marking complete (defaults to false) */
+    runTests?: boolean;
+    /** Entity performing the completion */
+    performedBy?: EntityId;
+}
+/**
+ * Result of completing a task
+ */
+export interface CompleteTaskResult {
+    /** The completed task */
+    task: Task;
+    /** The worktree info (if applicable) */
+    worktree?: WorktreeInfo;
+    /** Whether the branch is ready for merge */
+    readyForMerge: boolean;
+    /** Timestamp when the task was completed */
+    completedAt: Timestamp;
+}
+/**
+ * Task context information for generating prompts
+ */
+export interface TaskContext {
+    /** Task ID */
+    taskId: ElementId;
+    /** Task title */
+    title: string;
+    /** Task description (from metadata) */
+    description?: string;
+    /** Task tags */
+    tags: string[];
+    /** Task priority (enum value) */
+    priority?: number;
+    /** Task complexity (enum value) */
+    complexity?: number;
+    /** Branch name */
+    branch?: string;
+    /** Worktree path */
+    worktreePath?: string;
+    /** Additional instructions */
+    additionalInstructions?: string;
+}
+/**
+ * Worker Task Service interface for orchestrating worker task workflow.
+ *
+ * This service provides the complete lifecycle management for workers:
+ * 1. Start worker on a task (dispatch + worktree + spawn)
+ * 2. Build task context prompts
+ * 3. Complete tasks (close + ready for merge)
+ * 4. Clean up after task completion
+ */
+export interface WorkerTaskService {
+    /**
+     * Starts a worker on a task with full worktree isolation.
+     *
+     * This method performs the complete workflow:
+     * 1. Dispatches the task to the worker (assigns + notifies)
+     * 2. Creates a worktree for the task (if worktrees enabled)
+     * 3. Spawns the worker session in the worktree
+     * 4. Sends task context to the worker
+     *
+     * @param taskId - The task to start
+     * @param agentId - The worker agent
+     * @param options - Options for starting
+     * @returns The complete result
+     */
+    startWorkerOnTask(taskId: ElementId, agentId: EntityId, options?: StartWorkerOnTaskOptions): Promise<StartWorkerOnTaskResult>;
+    /**
+     * Completes a task and marks the branch as ready for merge.
+     *
+     * This method:
+     * 1. Marks the task as completed
+     * 2. Updates merge status to 'pending' (ready for Merge Steward)
+     * 3. Optionally runs tests
+     *
+     * @param taskId - The task to complete
+     * @param options - Completion options
+     * @returns The completion result
+     */
+    completeTask(taskId: ElementId, options?: CompleteTaskOptions): Promise<CompleteTaskResult>;
+    /**
+     * Builds the task context prompt for a worker.
+     *
+     * @param taskId - The task
+     * @param workerId - The worker entity ID
+     * @param additionalInstructions - Additional instructions to include
+     * @returns The formatted task context prompt
+     */
+    buildTaskContextPrompt(taskId: ElementId, workerId: EntityId, additionalInstructions?: string): Promise<string>;
+    /**
+     * Gets the task context information.
+     *
+     * @param taskId - The task
+     * @returns The task context
+     */
+    getTaskContext(taskId: ElementId): Promise<TaskContext>;
+    /**
+     * Cleans up after a task is merged or abandoned.
+     *
+     * This method:
+     * 1. Removes the worktree
+     * 2. Optionally deletes the branch
+     * 3. Updates task metadata
+     *
+     * @param taskId - The task to clean up
+     * @param deleteBranch - Whether to delete the branch
+     * @returns Success status
+     */
+    cleanupTask(taskId: ElementId, deleteBranch?: boolean): Promise<boolean>;
+}
+/**
+ * Implementation of the Worker Task Service.
+ */
+export declare class WorkerTaskServiceImpl implements WorkerTaskService {
+    private readonly api;
+    private readonly taskAssignment;
+    private readonly agentRegistry;
+    private readonly dispatchService;
+    private readonly worktreeManager;
+    private readonly _spawnerService;
+    private readonly sessionManager;
+    constructor(api: QuarryAPI, taskAssignment: TaskAssignmentService, agentRegistry: AgentRegistry, dispatchService: DispatchService, spawnerService: SpawnerService, sessionManager: SessionManager, worktreeManager?: WorktreeManager);
+    startWorkerOnTask(taskId: ElementId, agentId: EntityId, options?: StartWorkerOnTaskOptions): Promise<StartWorkerOnTaskResult>;
+    completeTask(taskId: ElementId, options?: CompleteTaskOptions): Promise<CompleteTaskResult>;
+    buildTaskContextPrompt(taskId: ElementId, workerId: EntityId, additionalInstructions?: string): Promise<string>;
+    getTaskContext(taskId: ElementId): Promise<TaskContext>;
+    cleanupTask(taskId: ElementId, deleteBranch?: boolean): Promise<boolean>;
+}
+/**
+ * Creates a WorkerTaskService instance
+ */
+export declare function createWorkerTaskService(api: QuarryAPI, taskAssignment: TaskAssignmentService, agentRegistry: AgentRegistry, dispatchService: DispatchService, spawnerService: SpawnerService, sessionManager: SessionManager, worktreeManager?: WorktreeManager): WorkerTaskService;
+//# sourceMappingURL=worker-task-service.d.ts.map