@task-shepherd/agent 1.0.5 → 1.0.7

package/shared/dist/mcp-client/types.d.ts

@@ -0,0 +1,822 @@
+/**
+ * Generated MCP Client Types
+ *
+ * This file is auto-generated from MCP tool mappings.
+ * Do not modify directly - run npm run generate:mcp-client instead.
+ */
+export interface ListProjectsInput {
+    limit?: number;
+    offset?: number;
+    search?: Record<string, any>;
+}
+export interface ListProjectsResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * List all projects with optional filtering
+ * GraphQL Operation: projects (query)
+ * Required Permissions: VIEW
+ */
+export interface ListProjectsTool {
+    name: 'list_projects';
+    description: 'List all projects with optional filtering';
+    operationType: 'query';
+    graphqlOperation: 'projects';
+    execute(input: ListProjectsInput): Promise<ListProjectsResult>;
+}
+export interface GetProjectInput {
+    id: string;
+}
+export interface GetProjectResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Get a specific project by ID
+ * GraphQL Operation: project (query)
+ * Required Permissions: VIEW
+ */
+export interface GetProjectTool {
+    name: 'get_project';
+    description: 'Get a specific project by ID';
+    operationType: 'query';
+    graphqlOperation: 'project';
+    execute(input: GetProjectInput): Promise<GetProjectResult>;
+}
+export interface CreateProjectInput {
+    name: string;
+    description?: string;
+    stage?: 'REQUIREMENTS' | 'DESIGN' | 'IMPLEMENTATION' | 'COMPLETE' | 'ARCHIVED';
+    isPublic?: boolean;
+    startDate?: string;
+    targetCompletionDate?: string;
+    repositoryUrl?: string;
+    documentationUrl?: string;
+}
+export interface CreateProjectResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Create a new project
+ * GraphQL Operation: createProject (mutation)
+ * Required Permissions: PRODUCT, ADMIN
+ */
+export interface CreateProjectTool {
+    name: 'create_project';
+    description: 'Create a new project';
+    operationType: 'mutation';
+    graphqlOperation: 'createProject';
+    execute(input: CreateProjectInput): Promise<CreateProjectResult>;
+}
+export interface UpdateProjectInput {
+    id: string;
+    name?: string;
+    description?: string;
+    stage?: 'REQUIREMENTS' | 'DESIGN' | 'IMPLEMENTATION' | 'COMPLETE' | 'ARCHIVED';
+    isPublic?: boolean;
+    startDate?: string;
+    targetCompletionDate?: string;
+    repositoryUrl?: string;
+    documentationUrl?: string;
+}
+export interface UpdateProjectResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Update an existing project
+ * GraphQL Operation: updateProject (mutation)
+ * Required Permissions: PRODUCT, ADMIN
+ */
+export interface UpdateProjectTool {
+    name: 'update_project';
+    description: 'Update an existing project';
+    operationType: 'mutation';
+    graphqlOperation: 'updateProject';
+    execute(input: UpdateProjectInput): Promise<UpdateProjectResult>;
+}
+export interface DeleteProjectInput {
+    id: string;
+}
+export interface DeleteProjectResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Delete a project
+ * GraphQL Operation: deleteProject (mutation)
+ * Required Permissions: PRODUCT, ADMIN
+ */
+export interface DeleteProjectTool {
+    name: 'delete_project';
+    description: 'Delete a project';
+    operationType: 'mutation';
+    graphqlOperation: 'deleteProject';
+    execute(input: DeleteProjectInput): Promise<DeleteProjectResult>;
+}
+export interface ListStoriesInput {
+    limit?: number;
+    offset?: number;
+    projectId?: string;
+    search?: Record<string, any>;
+}
+export interface ListStoriesResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * List stories with filtering and pagination
+ * GraphQL Operation: stories (query)
+ * Required Permissions: VIEW
+ */
+export interface ListStoriesTool {
+    name: 'list_stories';
+    description: 'List stories with filtering and pagination';
+    operationType: 'query';
+    graphqlOperation: 'stories';
+    execute(input: ListStoriesInput): Promise<ListStoriesResult>;
+}
+export interface GetStoryInput {
+    id: string;
+}
+export interface GetStoryResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Get a specific story by ID
+ * GraphQL Operation: story (query)
+ * Required Permissions: VIEW
+ */
+export interface GetStoryTool {
+    name: 'get_story';
+    description: 'Get a specific story by ID';
+    operationType: 'query';
+    graphqlOperation: 'story';
+    execute(input: GetStoryInput): Promise<GetStoryResult>;
+}
+export interface CreateStoryInput {
+    title: string;
+    description?: string;
+    projectId: string;
+    priority?: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+    estimate?: number;
+    tags?: string[];
+    acceptanceCriteria?: string[];
+    storyLink?: string;
+    assignedTo?: string;
+    orderIndex?: number;
+}
+export interface CreateStoryResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Create a new story
+ * GraphQL Operation: createStory (mutation)
+ * Required Permissions: WORKER, PRODUCT, ADMIN
+ */
+export interface CreateStoryTool {
+    name: 'create_story';
+    description: 'Create a new story';
+    operationType: 'mutation';
+    graphqlOperation: 'createStory';
+    execute(input: CreateStoryInput): Promise<CreateStoryResult>;
+}
+export interface UpdateStoryInput {
+    id: string;
+    title?: string;
+    description?: string;
+    priority?: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+    estimate?: number;
+    tags?: string[];
+    acceptanceCriteria?: string[];
+    storyLink?: string;
+    assignedTo?: string;
+}
+export interface UpdateStoryResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Update an existing story
+ * GraphQL Operation: updateStory (mutation)
+ * Required Permissions: WORKER, PRODUCT, ADMIN
+ */
+export interface UpdateStoryTool {
+    name: 'update_story';
+    description: 'Update an existing story';
+    operationType: 'mutation';
+    graphqlOperation: 'updateStory';
+    execute(input: UpdateStoryInput): Promise<UpdateStoryResult>;
+}
+export interface ClaimStoryInput {
+    id: string;
+}
+export interface ClaimStoryResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Claim a story for work
+ * GraphQL Operation: claimStory (mutation)
+ * Required Permissions: WORKER, PRODUCT, ADMIN
+ */
+export interface ClaimStoryTool {
+    name: 'claim_story';
+    description: 'Claim a story for work';
+    operationType: 'mutation';
+    graphqlOperation: 'claimStory';
+    execute(input: ClaimStoryInput): Promise<ClaimStoryResult>;
+}
+export interface UnclaimStoryInput {
+    id: string;
+}
+export interface UnclaimStoryResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Unclaim a previously claimed story
+ * GraphQL Operation: releaseStory (mutation)
+ * Required Permissions: WORKER, PRODUCT, ADMIN
+ */
+export interface UnclaimStoryTool {
+    name: 'unclaim_story';
+    description: 'Unclaim a previously claimed story';
+    operationType: 'mutation';
+    graphqlOperation: 'releaseStory';
+    execute(input: UnclaimStoryInput): Promise<UnclaimStoryResult>;
+}
+export interface CompleteStoryInput {
+    id: string;
+    implementationSummary?: string;
+}
+export interface CompleteStoryResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Mark a story as complete
+ * GraphQL Operation: completeStory (mutation)
+ * Required Permissions: WORKER, PRODUCT, ADMIN
+ */
+export interface CompleteStoryTool {
+    name: 'complete_story';
+    description: 'Mark a story as complete';
+    operationType: 'mutation';
+    graphqlOperation: 'completeStory';
+    execute(input: CompleteStoryInput): Promise<CompleteStoryResult>;
+}
+export interface ReviewStoryInput {
+    id: string;
+    approved: boolean;
+    reviewNotes?: string;
+}
+export interface ReviewStoryResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Review a completed story
+ * GraphQL Operation: reviewStory (mutation)
+ * Required Permissions: PRODUCT, ADMIN
+ */
+export interface ReviewStoryTool {
+    name: 'review_story';
+    description: 'Review a completed story';
+    operationType: 'mutation';
+    graphqlOperation: 'reviewStory';
+    execute(input: ReviewStoryInput): Promise<ReviewStoryResult>;
+}
+export interface ListTasksInput {
+    limit?: number;
+    offset?: number;
+    storyId?: string;
+    search?: Record<string, any>;
+}
+export interface ListTasksResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * List tasks with filtering and pagination
+ * GraphQL Operation: tasks (query)
+ * Required Permissions: VIEW
+ */
+export interface ListTasksTool {
+    name: 'list_tasks';
+    description: 'List tasks with filtering and pagination';
+    operationType: 'query';
+    graphqlOperation: 'tasks';
+    execute(input: ListTasksInput): Promise<ListTasksResult>;
+}
+export interface GetTaskInput {
+    id: string;
+}
+export interface GetTaskResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Get a specific task by ID
+ * GraphQL Operation: task (query)
+ * Required Permissions: VIEW
+ */
+export interface GetTaskTool {
+    name: 'get_task';
+    description: 'Get a specific task by ID';
+    operationType: 'query';
+    graphqlOperation: 'task';
+    execute(input: GetTaskInput): Promise<GetTaskResult>;
+}
+export interface CreateTaskInput {
+    title: string;
+    description?: string;
+    storyId: string;
+    areas: string[];
+    type?: 'PLANNED' | 'FOLLOWUP' | 'ASK';
+    priority?: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+    estimate?: number;
+    assignedTo?: string;
+}
+export interface CreateTaskResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Create a new task
+ * GraphQL Operation: createTask (mutation)
+ * Required Permissions: WORKER, PRODUCT, ADMIN
+ */
+export interface CreateTaskTool {
+    name: 'create_task';
+    description: 'Create a new task';
+    operationType: 'mutation';
+    graphqlOperation: 'createTask';
+    execute(input: CreateTaskInput): Promise<CreateTaskResult>;
+}
+export interface UpdateTaskInput {
+    id: string;
+    title?: string;
+    description?: string;
+    type?: 'PLANNED' | 'FOLLOWUP' | 'ASK';
+    priority?: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+    estimate?: number;
+    assignedTo?: string;
+}
+export interface UpdateTaskResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Update an existing task
+ * GraphQL Operation: updateTask (mutation)
+ * Required Permissions: WORKER, PRODUCT, ADMIN
+ */
+export interface UpdateTaskTool {
+    name: 'update_task';
+    description: 'Update an existing task';
+    operationType: 'mutation';
+    graphqlOperation: 'updateTask';
+    execute(input: UpdateTaskInput): Promise<UpdateTaskResult>;
+}
+export interface ClaimTaskInput {
+    id: string;
+}
+export interface ClaimTaskResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Claim a task for work
+ * GraphQL Operation: claimTask (mutation)
+ * Required Permissions: WORKER, PRODUCT, ADMIN
+ */
+export interface ClaimTaskTool {
+    name: 'claim_task';
+    description: 'Claim a task for work';
+    operationType: 'mutation';
+    graphqlOperation: 'claimTask';
+    execute(input: ClaimTaskInput): Promise<ClaimTaskResult>;
+}
+export interface UnclaimTaskInput {
+    id: string;
+}
+export interface UnclaimTaskResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Unclaim a previously claimed task
+ * GraphQL Operation: unclaimTask (mutation)
+ * Required Permissions: WORKER, PRODUCT, ADMIN
+ */
+export interface UnclaimTaskTool {
+    name: 'unclaim_task';
+    description: 'Unclaim a previously claimed task';
+    operationType: 'mutation';
+    graphqlOperation: 'unclaimTask';
+    execute(input: UnclaimTaskInput): Promise<UnclaimTaskResult>;
+}
+export interface CompleteTaskInput {
+    id: string;
+    implementationSummary?: string;
+}
+export interface CompleteTaskResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Mark a task as complete with implementation details
+ * GraphQL Operation: completeTask (mutation)
+ * Required Permissions: WORKER, PRODUCT, ADMIN
+ */
+export interface CompleteTaskTool {
+    name: 'complete_task';
+    description: 'Mark a task as complete with implementation details';
+    operationType: 'mutation';
+    graphqlOperation: 'completeTask';
+    execute(input: CompleteTaskInput): Promise<CompleteTaskResult>;
+}
+export interface RegisterWorkerInput {
+    email: string;
+    password: string;
+    firstName?: string;
+    lastName?: string;
+    role?: 'VIEW' | 'WORKER' | 'PRODUCT' | 'ADMIN';
+}
+export interface RegisterWorkerResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Register a new worker (human or AI) with the system
+ * GraphQL Operation: register (mutation)
+ * Required Permissions: None
+ */
+export interface RegisterWorkerTool {
+    name: 'register_worker';
+    description: 'Register a new worker (human or AI) with the system';
+    operationType: 'mutation';
+    graphqlOperation: 'register';
+    execute(input: RegisterWorkerInput): Promise<RegisterWorkerResult>;
+}
+export interface ListWorkersInput {
+    activeOnly?: boolean;
+    type?: 'HUMAN' | 'AI';
+    capability?: string;
+}
+export interface ListWorkersResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * List all registered workers
+ * GraphQL Operation: users (query)
+ * Required Permissions: ADMIN
+ */
+export interface ListWorkersTool {
+    name: 'list_workers';
+    description: 'List all registered workers';
+    operationType: 'query';
+    graphqlOperation: 'users';
+    execute(input: ListWorkersInput): Promise<ListWorkersResult>;
+}
+export interface CreateStoryDependencyInput {
+    storyId: string;
+    dependsOnStoryId: string;
+}
+export interface CreateStoryDependencyResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Create a dependency between two stories
+ * GraphQL Operation: createStoryDependency (mutation)
+ * Required Permissions: WORKER, PRODUCT, ADMIN
+ */
+export interface CreateStoryDependencyTool {
+    name: 'create_story_dependency';
+    description: 'Create a dependency between two stories';
+    operationType: 'mutation';
+    graphqlOperation: 'createStoryDependency';
+    execute(input: CreateStoryDependencyInput): Promise<CreateStoryDependencyResult>;
+}
+export interface GetDependencyGraphInput {
+    projectId: string;
+}
+export interface GetDependencyGraphResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Get the complete dependency graph for a project
+ * GraphQL Operation: project (query)
+ * Required Permissions: VIEW
+ */
+export interface GetDependencyGraphTool {
+    name: 'get_dependency_graph';
+    description: 'Get the complete dependency graph for a project';
+    operationType: 'query';
+    graphqlOperation: 'project';
+    execute(input: GetDependencyGraphInput): Promise<GetDependencyGraphResult>;
+}
+export interface GetAvailableStoriesInput {
+    limit?: number;
+    offset?: number;
+    areas?: string[];
+    search?: Record<string, any>;
+}
+export interface GetAvailableStoriesResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Find stories available for claiming
+ * GraphQL Operation: stories (query)
+ * Required Permissions: VIEW
+ */
+export interface GetAvailableStoriesTool {
+    name: 'get_available_stories';
+    description: 'Find stories available for claiming';
+    operationType: 'query';
+    graphqlOperation: 'stories';
+    execute(input: GetAvailableStoriesInput): Promise<GetAvailableStoriesResult>;
+}
+export interface GetAvailableTasksInput {
+    limit?: number;
+    offset?: number;
+    areas?: string[];
+    search?: Record<string, any>;
+}
+export interface GetAvailableTasksResult {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+/**
+ * Find tasks available for claiming
+ * GraphQL Operation: tasks (query)
+ * Required Permissions: VIEW
+ */
+export interface GetAvailableTasksTool {
+    name: 'get_available_tasks';
+    description: 'Find tasks available for claiming';
+    operationType: 'query';
+    graphqlOperation: 'tasks';
+    execute(input: GetAvailableTasksInput): Promise<GetAvailableTasksResult>;
+}
+/**
+ * Tools for managing projects, stories, and tasks
+ */
+export type ProjectManagementTools = ListProjectsTool | GetProjectTool | CreateProjectTool | UpdateProjectTool | DeleteProjectTool;
+/**
+ * Tools for managing user stories and their lifecycle
+ */
+export type StoryManagementTools = ListStoriesTool | GetStoryTool | CreateStoryTool | UpdateStoryTool | ClaimStoryTool | UnclaimStoryTool | CompleteStoryTool | ReviewStoryTool;
+/**
+ * Tools for managing tasks within stories
+ */
+export type TaskManagementTools = ListTasksTool | GetTaskTool | CreateTaskTool | UpdateTaskTool | ClaimTaskTool | UnclaimTaskTool | CompleteTaskTool;
+/**
+ * Tools for user authentication and management
+ */
+export type UserManagementTools = RegisterWorkerTool | ListWorkersTool;
+/**
+ * Tools for managing story and task dependencies
+ */
+export type DependenciesTools = CreateStoryDependencyTool | GetDependencyGraphTool;
+/**
+ * Tools for finding and allocating available work
+ */
+export type WorkManagementTools = GetAvailableStoriesTool | GetAvailableTasksTool;
+/**
+ * Union type of all available MCP tools
+ */
+export type AllMCPTools = ProjectManagementTools | StoryManagementTools | TaskManagementTools | UserManagementTools | DependenciesTools | WorkManagementTools;
+/**
+ * MCP Client interface for executing tools
+ */
+export interface MCPClient {
+    isConnected(): boolean;
+    connect(endpoint?: string): Promise<void>;
+    disconnect(): Promise<void>;
+    execute<T extends AllMCPTools>(tool: T['name'], input: any): Promise<any>;
+    listTools(): string[];
+    getCapabilities(): string[];
+}
+/**
+ * Tool registry for type-safe tool execution
+ */
+export declare const MCP_TOOL_REGISTRY: {
+    readonly list_projects: {
+        readonly name: "list_projects";
+        readonly description: "List all projects with optional filtering";
+        readonly operationType: "query";
+        readonly graphqlOperation: "projects";
+        readonly requiredPermissions: readonly ["VIEW"];
+    };
+    readonly get_project: {
+        readonly name: "get_project";
+        readonly description: "Get a specific project by ID";
+        readonly operationType: "query";
+        readonly graphqlOperation: "project";
+        readonly requiredPermissions: readonly ["VIEW"];
+    };
+    readonly create_project: {
+        readonly name: "create_project";
+        readonly description: "Create a new project";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "createProject";
+        readonly requiredPermissions: readonly ["PRODUCT", "ADMIN"];
+    };
+    readonly update_project: {
+        readonly name: "update_project";
+        readonly description: "Update an existing project";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "updateProject";
+        readonly requiredPermissions: readonly ["PRODUCT", "ADMIN"];
+    };
+    readonly delete_project: {
+        readonly name: "delete_project";
+        readonly description: "Delete a project";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "deleteProject";
+        readonly requiredPermissions: readonly ["PRODUCT", "ADMIN"];
+    };
+    readonly list_stories: {
+        readonly name: "list_stories";
+        readonly description: "List stories with filtering and pagination";
+        readonly operationType: "query";
+        readonly graphqlOperation: "stories";
+        readonly requiredPermissions: readonly ["VIEW"];
+    };
+    readonly get_story: {
+        readonly name: "get_story";
+        readonly description: "Get a specific story by ID";
+        readonly operationType: "query";
+        readonly graphqlOperation: "story";
+        readonly requiredPermissions: readonly ["VIEW"];
+    };
+    readonly create_story: {
+        readonly name: "create_story";
+        readonly description: "Create a new story";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "createStory";
+        readonly requiredPermissions: readonly ["WORKER", "PRODUCT", "ADMIN"];
+    };
+    readonly update_story: {
+        readonly name: "update_story";
+        readonly description: "Update an existing story";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "updateStory";
+        readonly requiredPermissions: readonly ["WORKER", "PRODUCT", "ADMIN"];
+    };
+    readonly claim_story: {
+        readonly name: "claim_story";
+        readonly description: "Claim a story for work";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "claimStory";
+        readonly requiredPermissions: readonly ["WORKER", "PRODUCT", "ADMIN"];
+    };
+    readonly unclaim_story: {
+        readonly name: "unclaim_story";
+        readonly description: "Unclaim a previously claimed story";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "releaseStory";
+        readonly requiredPermissions: readonly ["WORKER", "PRODUCT", "ADMIN"];
+    };
+    readonly complete_story: {
+        readonly name: "complete_story";
+        readonly description: "Mark a story as complete";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "completeStory";
+        readonly requiredPermissions: readonly ["WORKER", "PRODUCT", "ADMIN"];
+    };
+    readonly review_story: {
+        readonly name: "review_story";
+        readonly description: "Review a completed story";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "reviewStory";
+        readonly requiredPermissions: readonly ["PRODUCT", "ADMIN"];
+    };
+    readonly list_tasks: {
+        readonly name: "list_tasks";
+        readonly description: "List tasks with filtering and pagination";
+        readonly operationType: "query";
+        readonly graphqlOperation: "tasks";
+        readonly requiredPermissions: readonly ["VIEW"];
+    };
+    readonly get_task: {
+        readonly name: "get_task";
+        readonly description: "Get a specific task by ID";
+        readonly operationType: "query";
+        readonly graphqlOperation: "task";
+        readonly requiredPermissions: readonly ["VIEW"];
+    };
+    readonly create_task: {
+        readonly name: "create_task";
+        readonly description: "Create a new task";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "createTask";
+        readonly requiredPermissions: readonly ["WORKER", "PRODUCT", "ADMIN"];
+    };
+    readonly update_task: {
+        readonly name: "update_task";
+        readonly description: "Update an existing task";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "updateTask";
+        readonly requiredPermissions: readonly ["WORKER", "PRODUCT", "ADMIN"];
+    };
+    readonly claim_task: {
+        readonly name: "claim_task";
+        readonly description: "Claim a task for work";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "claimTask";
+        readonly requiredPermissions: readonly ["WORKER", "PRODUCT", "ADMIN"];
+    };
+    readonly unclaim_task: {
+        readonly name: "unclaim_task";
+        readonly description: "Unclaim a previously claimed task";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "unclaimTask";
+        readonly requiredPermissions: readonly ["WORKER", "PRODUCT", "ADMIN"];
+    };
+    readonly complete_task: {
+        readonly name: "complete_task";
+        readonly description: "Mark a task as complete with implementation details";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "completeTask";
+        readonly requiredPermissions: readonly ["WORKER", "PRODUCT", "ADMIN"];
+    };
+    readonly register_worker: {
+        readonly name: "register_worker";
+        readonly description: "Register a new worker (human or AI) with the system";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "register";
+        readonly requiredPermissions: readonly [];
+    };
+    readonly list_workers: {
+        readonly name: "list_workers";
+        readonly description: "List all registered workers";
+        readonly operationType: "query";
+        readonly graphqlOperation: "users";
+        readonly requiredPermissions: readonly ["ADMIN"];
+    };
+    readonly create_story_dependency: {
+        readonly name: "create_story_dependency";
+        readonly description: "Create a dependency between two stories";
+        readonly operationType: "mutation";
+        readonly graphqlOperation: "createStoryDependency";
+        readonly requiredPermissions: readonly ["WORKER", "PRODUCT", "ADMIN"];
+    };
+    readonly get_dependency_graph: {
+        readonly name: "get_dependency_graph";
+        readonly description: "Get the complete dependency graph for a project";
+        readonly operationType: "query";
+        readonly graphqlOperation: "project";
+        readonly requiredPermissions: readonly ["VIEW"];
+    };
+    readonly get_available_stories: {
+        readonly name: "get_available_stories";
+        readonly description: "Find stories available for claiming";
+        readonly operationType: "query";
+        readonly graphqlOperation: "stories";
+        readonly requiredPermissions: readonly ["VIEW"];
+    };
+    readonly get_available_tasks: {
+        readonly name: "get_available_tasks";
+        readonly description: "Find tasks available for claiming";
+        readonly operationType: "query";
+        readonly graphqlOperation: "tasks";
+        readonly requiredPermissions: readonly ["VIEW"];
+    };
+};