@kitman-sh/sdk 0.7.2 → 0.7.3

package/types/packages/core/src/agent-capabilities.d.ts

@@ -0,0 +1,1434 @@
+import * as Schema from 'effect/Schema';
+export declare const KitmanAgentCapabilities: readonly [{
+    readonly name: 'kitman_resolve_project_context';
+    readonly description: 'Inspect the current Kitman Workspace and preferred Project context without mutating local or cloud state.';
+    readonly input: Schema.Struct<{
+        readonly workspaceId: Schema.optionalKey<Schema.String>;
+        readonly projectId: Schema.optionalKey<Schema.String>;
+        readonly repoIdentity: Schema.optionalKey<Schema.Struct<{
+            readonly host: Schema.String;
+            readonly owner: Schema.String;
+            readonly name: Schema.String;
+            readonly normalizedUrl: Schema.optionalKey<Schema.String>;
+        }>>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly workspaceId: Schema.optionalKey<Schema.String>;
+        readonly preferredProjectId: Schema.optionalKey<Schema.String>;
+        readonly repoIdentity: Schema.optionalKey<Schema.Struct<{
+            readonly host: Schema.String;
+            readonly owner: Schema.String;
+            readonly name: Schema.String;
+            readonly normalizedUrl: Schema.optionalKey<Schema.String>;
+        }>>;
+        readonly resolutionSource: Schema.Union<readonly [Schema.Literal<"explicit">, Schema.Literal<"preferred_project">, Schema.Literal<"repo_binding">, Schema.Literal<"workspace">, Schema.Literal<"unresolved">]>;
+        readonly warnings: Schema.$Array<Schema.String>;
+        readonly candidates: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly name: Schema.String;
+            readonly slug: Schema.String;
+            readonly description: Schema.optionalKey<Schema.String>;
+            readonly sourceType: Schema.Literal<"manual">;
+            readonly openTaskCount: Schema.Int;
+            readonly blockedTaskCount: Schema.Int;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>>;
+    }>;
+    readonly defaults: {
+        readonly projectIdFromActiveProject: true;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_list_accessible_projects';
+    readonly description: 'List Projects in the current Workspace that the Actor can already access for Task workflows.';
+    readonly input: Schema.Struct<{
+        readonly workspaceId: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly items: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly name: Schema.String;
+            readonly slug: Schema.String;
+            readonly description: Schema.optionalKey<Schema.String>;
+            readonly sourceType: Schema.Literal<"manual">;
+            readonly openTaskCount: Schema.Int;
+            readonly blockedTaskCount: Schema.Int;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_get_task';
+    readonly description: 'Fetch a Kitman Task by id, or by exact task title/source key when one accessible Project match can be resolved.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly projectId: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly task: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly taskKey: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly teamId: Schema.String;
+            readonly number: Schema.Int;
+            readonly projectId: Schema.optionalKey<Schema.String>;
+            readonly title: Schema.String;
+            readonly description: Schema.optionalKey<Schema.String>;
+            readonly acceptanceCriteria: Schema.$Array<Schema.String>;
+            readonly state: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly name: Schema.String;
+                readonly category: Schema.Literals<readonly ["triage", "backlog", "unstarted", "started", "completed", "canceled", "duplicate"]>;
+            }>;
+            readonly priority: Schema.Literals<readonly ["none", "urgent", "high", "medium", "low"]>;
+            readonly assigneeId: Schema.optionalKey<Schema.String>;
+            readonly creator: Schema.Struct<{
+                readonly type: Schema.Literals<readonly ["human", "agent", "system"]>;
+                readonly id: Schema.String;
+            }>;
+            readonly origin: Schema.Union<readonly [Schema.Struct<{
+                readonly kind: Schema.Literal<"manual">;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"plan_ticket">;
+                readonly runId: Schema.String;
+                readonly ticketKey: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"launch">;
+                readonly runId: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"event">;
+                readonly eventId: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"migrated">;
+                readonly previousKeys: Schema.$Array<Schema.String>;
+                readonly formerSourceKind: Schema.String;
+                readonly formerSourceUrl: Schema.optionalKey<Schema.String>;
+            }>]>;
+            readonly parentId: Schema.optionalKey<Schema.String>;
+            readonly labels: Schema.$Array<Schema.String>;
+            readonly startedAt: Schema.optionalKey<Schema.String>;
+            readonly completedAt: Schema.optionalKey<Schema.String>;
+            readonly canceledAt: Schema.optionalKey<Schema.String>;
+            readonly revision: Schema.Int;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>;
+    }>;
+    readonly defaults: {
+        readonly projectIdFromActiveProject: true;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_search_tasks';
+    readonly description: 'Search Tasks by text or key, project, state name or category (status), and limit. Returns full Task records including id, taskKey, workspaceId, and projectId so agents can safely chain follow-up actions.';
+    readonly input: Schema.Struct<{
+        readonly query: Schema.optionalKey<Schema.String>;
+        readonly projectId: Schema.optionalKey<Schema.String>;
+        readonly status: Schema.optionalKey<Schema.String>;
+        readonly limit: Schema.optionalKey<Schema.Int>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly items: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly taskKey: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly teamId: Schema.String;
+            readonly number: Schema.Int;
+            readonly projectId: Schema.optionalKey<Schema.String>;
+            readonly title: Schema.String;
+            readonly description: Schema.optionalKey<Schema.String>;
+            readonly acceptanceCriteria: Schema.$Array<Schema.String>;
+            readonly state: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly name: Schema.String;
+                readonly category: Schema.Literals<readonly ["triage", "backlog", "unstarted", "started", "completed", "canceled", "duplicate"]>;
+            }>;
+            readonly priority: Schema.Literals<readonly ["none", "urgent", "high", "medium", "low"]>;
+            readonly assigneeId: Schema.optionalKey<Schema.String>;
+            readonly creator: Schema.Struct<{
+                readonly type: Schema.Literals<readonly ["human", "agent", "system"]>;
+                readonly id: Schema.String;
+            }>;
+            readonly origin: Schema.Union<readonly [Schema.Struct<{
+                readonly kind: Schema.Literal<"manual">;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"plan_ticket">;
+                readonly runId: Schema.String;
+                readonly ticketKey: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"launch">;
+                readonly runId: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"event">;
+                readonly eventId: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"migrated">;
+                readonly previousKeys: Schema.$Array<Schema.String>;
+                readonly formerSourceKind: Schema.String;
+                readonly formerSourceUrl: Schema.optionalKey<Schema.String>;
+            }>]>;
+            readonly parentId: Schema.optionalKey<Schema.String>;
+            readonly labels: Schema.$Array<Schema.String>;
+            readonly startedAt: Schema.optionalKey<Schema.String>;
+            readonly completedAt: Schema.optionalKey<Schema.String>;
+            readonly canceledAt: Schema.optionalKey<Schema.String>;
+            readonly revision: Schema.Int;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>>;
+        readonly resolvedScope: Schema.optionalKey<Schema.Struct<{
+            readonly kind: Schema.Union<readonly [Schema.Literal<"project">, Schema.Literal<"workspace">]>;
+            readonly workspaceId: Schema.optionalKey<Schema.String>;
+            readonly projectId: Schema.optionalKey<Schema.String>;
+        }>>;
+        readonly resolutionSource: Schema.optionalKey<Schema.String>;
+        readonly resolutionWarnings: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    }>;
+    readonly defaults: {
+        readonly projectIdFromActiveProject: true;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_list_task_dependencies';
+    readonly description: 'List TaskDependency edges for a Task with Project privacy redaction.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly items: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly dependentTask: Schema.Union<readonly [Schema.Struct<{
+                readonly redacted: Schema.Literal<false>;
+                readonly taskId: Schema.String;
+                readonly projectId: Schema.optionalKey<Schema.String>;
+                readonly taskKey: Schema.String;
+                readonly title: Schema.String;
+                readonly state: Schema.Struct<{
+                    readonly id: Schema.String;
+                    readonly name: Schema.String;
+                    readonly category: Schema.Literals<readonly ["triage", "backlog", "unstarted", "started", "completed", "canceled", "duplicate"]>;
+                }>;
+            }>, Schema.Struct<{
+                readonly redacted: Schema.Literal<true>;
+                readonly taskId: Schema.optionalKey<Schema.String>;
+                readonly projectId: Schema.optionalKey<Schema.String>;
+            }>]>;
+            readonly blockingTask: Schema.Union<readonly [Schema.Struct<{
+                readonly redacted: Schema.Literal<false>;
+                readonly taskId: Schema.String;
+                readonly projectId: Schema.optionalKey<Schema.String>;
+                readonly taskKey: Schema.String;
+                readonly title: Schema.String;
+                readonly state: Schema.Struct<{
+                    readonly id: Schema.String;
+                    readonly name: Schema.String;
+                    readonly category: Schema.Literals<readonly ["triage", "backlog", "unstarted", "started", "completed", "canceled", "duplicate"]>;
+                }>;
+            }>, Schema.Struct<{
+                readonly redacted: Schema.Literal<true>;
+                readonly taskId: Schema.optionalKey<Schema.String>;
+                readonly projectId: Schema.optionalKey<Schema.String>;
+            }>]>;
+            readonly reason: Schema.optionalKey<Schema.String>;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_list_repo_bindings';
+    readonly description: 'List non-secret Project RepoBindings used to decide local claim and remote Runner runtime readiness.';
+    readonly input: Schema.Struct<{
+        readonly projectId: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly items: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly projectId: Schema.String;
+            readonly provider: Schema.Union<readonly [Schema.Literal<"github">, Schema.Literal<"gitlab">, Schema.Literal<"generic_git">]>;
+            readonly host: Schema.String;
+            readonly owner: Schema.String;
+            readonly name: Schema.String;
+            readonly repositoryUrl: Schema.optionalKey<Schema.String>;
+            readonly pathPrefix: Schema.optionalKey<Schema.String>;
+            readonly defaultTargetBranch: Schema.String;
+            readonly expectedBranch: Schema.optionalKey<Schema.String>;
+            readonly expectedCommitSha: Schema.optionalKey<Schema.String>;
+            readonly credentialRefs: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+                readonly kind: Schema.Literal<"none">;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"local_env">;
+                readonly envName: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"runner_secret">;
+                readonly runnerSecretName: Schema.String;
+                readonly providerType: Schema.Union<readonly [Schema.Literal<"env">, Schema.Literal<"file">, Schema.Literal<"exec">]>;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"ssh_agent">;
+            }>]>>;
+            readonly status: Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"disabled">]>;
+            readonly webhook: Schema.optionalKey<Schema.Struct<{
+                readonly status: Schema.Literals<readonly ["active", "missing"]>;
+                readonly message: Schema.optionalKey<Schema.String>;
+            }>>;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>>;
+    }>;
+    readonly defaults: {
+        readonly projectIdFromActiveProject: true;
+    };
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_create_repo_binding';
+    readonly description: 'Create a non-secret Project RepoBinding. Store only repository identity, expected revision context, and credential references; never raw tokens, source snapshots, or private keys.';
+    readonly input: Schema.Struct<{
+        readonly projectId: Schema.String;
+        readonly provider: Schema.Union<readonly [Schema.Literal<"github">, Schema.Literal<"gitlab">, Schema.Literal<"generic_git">]>;
+        readonly host: Schema.String;
+        readonly owner: Schema.String;
+        readonly name: Schema.String;
+        readonly repositoryUrl: Schema.optionalKey<Schema.String>;
+        readonly pathPrefix: Schema.optionalKey<Schema.String>;
+        readonly defaultTargetBranch: Schema.String;
+        readonly expectedBranch: Schema.optionalKey<Schema.String>;
+        readonly expectedCommitSha: Schema.optionalKey<Schema.String>;
+        readonly credentialRefs: Schema.optionalKey<Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+            readonly kind: Schema.Literal<"none">;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"local_env">;
+            readonly envName: Schema.String;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"runner_secret">;
+            readonly runnerSecretName: Schema.String;
+            readonly providerType: Schema.Union<readonly [Schema.Literal<"env">, Schema.Literal<"file">, Schema.Literal<"exec">]>;
+        }>, Schema.Struct<{
+            readonly kind: Schema.Literal<"ssh_agent">;
+        }>]>>>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly repoBinding: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly projectId: Schema.String;
+            readonly provider: Schema.Union<readonly [Schema.Literal<"github">, Schema.Literal<"gitlab">, Schema.Literal<"generic_git">]>;
+            readonly host: Schema.String;
+            readonly owner: Schema.String;
+            readonly name: Schema.String;
+            readonly repositoryUrl: Schema.optionalKey<Schema.String>;
+            readonly pathPrefix: Schema.optionalKey<Schema.String>;
+            readonly defaultTargetBranch: Schema.String;
+            readonly expectedBranch: Schema.optionalKey<Schema.String>;
+            readonly expectedCommitSha: Schema.optionalKey<Schema.String>;
+            readonly credentialRefs: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+                readonly kind: Schema.Literal<"none">;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"local_env">;
+                readonly envName: Schema.String;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"runner_secret">;
+                readonly runnerSecretName: Schema.String;
+                readonly providerType: Schema.Union<readonly [Schema.Literal<"env">, Schema.Literal<"file">, Schema.Literal<"exec">]>;
+            }>, Schema.Struct<{
+                readonly kind: Schema.Literal<"ssh_agent">;
+            }>]>>;
+            readonly status: Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"disabled">]>;
+            readonly webhook: Schema.optionalKey<Schema.Struct<{
+                readonly status: Schema.Literals<readonly ["active", "missing"]>;
+                readonly message: Schema.optionalKey<Schema.String>;
+            }>>;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_list_task_members';
+    readonly description: 'List the explicit human members participating in a Task.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly items: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly taskId: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly userId: Schema.String;
+            readonly role: Schema.Literals<readonly ["participant", "watcher", "decision_maker"]>;
+            readonly capabilities: Schema.$Array<Schema.Literals<readonly ["read", "comment", "answer_question", "review", "manage_members"]>>;
+            readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+            readonly createdByActorId: Schema.String;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_add_task_member';
+    readonly description: 'Add or update an explicit human member of a Task.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly member: Schema.Struct<{
+            readonly userId: Schema.String;
+            readonly role: Schema.Literals<readonly ["participant", "watcher", "decision_maker"]>;
+            readonly capabilities: Schema.$Array<Schema.Literals<readonly ["read", "comment", "answer_question", "review", "manage_members"]>>;
+        }>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly member: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly taskId: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly userId: Schema.String;
+            readonly role: Schema.Literals<readonly ["participant", "watcher", "decision_maker"]>;
+            readonly capabilities: Schema.$Array<Schema.Literals<readonly ["read", "comment", "answer_question", "review", "manage_members"]>>;
+            readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+            readonly createdByActorId: Schema.String;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_remove_task_member';
+    readonly description: 'Remove an explicit human member from a Task.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly memberId: Schema.String;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly id: Schema.String;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_list_task_thread_entries';
+    readonly description: 'List Task thread entries visible to the calling actor.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly limit: Schema.optionalKey<Schema.Int>;
+        readonly cursor: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly items: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly taskId: Schema.String;
+            readonly sessionId: Schema.optionalKey<Schema.String>;
+            readonly sourceSession: Schema.optionalKey<Schema.Struct<{
+                readonly id: Schema.String;
+                readonly actorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+                readonly agentIdentityId: Schema.optionalKey<Schema.String>;
+                readonly agentName: Schema.optionalKey<Schema.String>;
+                readonly runtimeProfile: Schema.optionalKey<Schema.String>;
+                readonly modelProvider: Schema.optionalKey<Schema.String>;
+                readonly modelName: Schema.optionalKey<Schema.String>;
+                readonly modelId: Schema.optionalKey<Schema.String>;
+                readonly startedAt: Schema.String;
+            }>>;
+            readonly replyToEntryId: Schema.optionalKey<Schema.String>;
+            readonly kind: Schema.Union<readonly [Schema.Literal<"note">, Schema.Literal<"question">, Schema.Literal<"answer">, Schema.Literal<"decision">, Schema.Literal<"blocker">, Schema.Literal<"finding">, Schema.Literal<"handoff">, Schema.Literal<"test_result">, Schema.Literal<"file_reference">, Schema.Literal<"status_change">, Schema.Literal<"assignment_change">, Schema.Literal<"link">, Schema.Literal<"change_request_review">]>;
+            readonly content: Schema.String;
+            readonly metadata: Schema.$Record<Schema.String, Schema.Unknown>;
+            readonly actorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+            readonly actorId: Schema.String;
+            readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+            readonly createdAt: Schema.String;
+        }>>;
+        readonly nextCursor: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_list_task_sessions';
+    readonly description: 'List Sessions attached to a Task, including session IDs needed for SessionUpdate, blocker, and handoff tools.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly items: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly projectId: Schema.optionalKey<Schema.String>;
+            readonly taskId: Schema.String;
+            readonly actorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+            readonly actorId: Schema.String;
+            readonly actorName: Schema.optionalKey<Schema.String>;
+            readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+            readonly agentName: Schema.optionalKey<Schema.String>;
+            readonly agentIdentityId: Schema.optionalKey<Schema.String>;
+            readonly runtimeMetadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
+            readonly modelMetadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
+            readonly status: Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"ended">]>;
+            readonly summary: Schema.optionalKey<Schema.String>;
+            readonly startedAt: Schema.String;
+            readonly endedAt: Schema.optionalKey<Schema.String>;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_get_session';
+    readonly description: 'Read one Session by id.';
+    readonly input: Schema.Struct<{
+        readonly sessionId: Schema.String;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly session: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly projectId: Schema.optionalKey<Schema.String>;
+            readonly taskId: Schema.String;
+            readonly actorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+            readonly actorId: Schema.String;
+            readonly actorName: Schema.optionalKey<Schema.String>;
+            readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+            readonly agentName: Schema.optionalKey<Schema.String>;
+            readonly agentIdentityId: Schema.optionalKey<Schema.String>;
+            readonly runtimeMetadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
+            readonly modelMetadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
+            readonly status: Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"ended">]>;
+            readonly summary: Schema.optionalKey<Schema.String>;
+            readonly startedAt: Schema.String;
+            readonly endedAt: Schema.optionalKey<Schema.String>;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_list_session_updates';
+    readonly description: 'List structured updates recorded in a Session, including update IDs and handoff/blocker/decision content.';
+    readonly input: Schema.Struct<{
+        readonly sessionId: Schema.String;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly items: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly sessionId: Schema.String;
+            readonly taskId: Schema.String;
+            readonly kind: Schema.Union<readonly [Schema.Literal<"note">, Schema.Literal<"question">, Schema.Literal<"answer">, Schema.Literal<"decision">, Schema.Literal<"blocker">, Schema.Literal<"finding">, Schema.Literal<"handoff">, Schema.Literal<"test_result">, Schema.Literal<"file_reference">, Schema.Literal<"status_change">, Schema.Literal<"assignment_change">, Schema.Literal<"link">]>;
+            readonly content: Schema.String;
+            readonly metadata: Schema.$Record<Schema.String, Schema.Unknown>;
+            readonly createdAt: Schema.String;
+        }>>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_get_context_pack_snapshot';
+    readonly description: 'Read an existing immutable ContextPack snapshot by id.';
+    readonly input: Schema.Struct<{
+        readonly contextPackId: Schema.String;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly contextPackId: Schema.String;
+        readonly mode: Schema.Union<readonly [Schema.Literal<"planning">, Schema.Literal<"implementation">, Schema.Literal<"debugging">, Schema.Literal<"review">, Schema.Literal<"handoff">]>;
+        readonly contentMarkdown: Schema.String;
+        readonly launchBrief: Schema.optionalKey<Schema.Struct<{
+            readonly mode: Schema.Union<readonly [Schema.Literal<"planning">, Schema.Literal<"implementation">, Schema.Literal<"debugging">, Schema.Literal<"review">, Schema.Literal<"handoff">]>;
+            readonly taskTitle: Schema.String;
+            readonly projectName: Schema.optionalKey<Schema.String>;
+            readonly summary: Schema.String;
+        }>>;
+        readonly contextIndex: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly kind: Schema.Literals<readonly ["task", "project", "kit", "memory", "decision", "session", "session_update", "proposal", "task_dependency", "repo_binding", "agent_environment", "loop_step"]>;
+            readonly id: Schema.String;
+            readonly title: Schema.String;
+            readonly reason: Schema.String;
+        }>>>;
+        readonly retrievalRefs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "session", "session_update", "proposal", "task_dependency", "repo_binding", "agent_environment", "loop_step"]>;
+            readonly id: Schema.String;
+            readonly label: Schema.String;
+        }>>>;
+        readonly relevanceSummary: Schema.optionalKey<Schema.Struct<{
+            readonly included: Schema.$Array<Schema.String>;
+            readonly omitted: Schema.$Array<Schema.String>;
+            readonly notes: Schema.$Array<Schema.String>;
+            readonly readiness: Schema.optionalKey<Schema.Struct<{
+                readonly scopeAvailable: Schema.Boolean;
+                readonly acceptanceCriteriaAvailable: Schema.Boolean;
+                readonly dependenciesSatisfied: Schema.Boolean;
+                readonly executionPlanAvailable: Schema.Boolean;
+                readonly repoBindingAvailable: Schema.Boolean;
+                readonly verificationCommands: Schema.$Array<Schema.String>;
+                readonly deliveryTargetAvailable: Schema.Boolean;
+            }>>;
+        }>>;
+        readonly budget: Schema.optionalKey<Schema.Struct<{
+            readonly maxMarkdownChars: Schema.Int;
+            readonly markdownChars: Schema.Int;
+            readonly indexedItemCount: Schema.Int;
+            readonly retrievalRefCount: Schema.Int;
+        }>>;
+        readonly includedDecisionIds: Schema.optionalKey<Schema.$Array<Schema.String>>;
+        readonly includedProposalIds: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_get_latest_context_pack';
+    readonly description: 'Read the latest stored ContextPack for a Task and mode without generating a new snapshot.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly mode: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"planning">, Schema.Literal<"implementation">, Schema.Literal<"debugging">, Schema.Literal<"review">, Schema.Literal<"handoff">]>>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly contextPackId: Schema.String;
+        readonly mode: Schema.Union<readonly [Schema.Literal<"planning">, Schema.Literal<"implementation">, Schema.Literal<"debugging">, Schema.Literal<"review">, Schema.Literal<"handoff">]>;
+        readonly contentMarkdown: Schema.String;
+        readonly launchBrief: Schema.optionalKey<Schema.Struct<{
+            readonly mode: Schema.Union<readonly [Schema.Literal<"planning">, Schema.Literal<"implementation">, Schema.Literal<"debugging">, Schema.Literal<"review">, Schema.Literal<"handoff">]>;
+            readonly taskTitle: Schema.String;
+            readonly projectName: Schema.optionalKey<Schema.String>;
+            readonly summary: Schema.String;
+        }>>;
+        readonly contextIndex: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly kind: Schema.Literals<readonly ["task", "project", "kit", "memory", "decision", "session", "session_update", "proposal", "task_dependency", "repo_binding", "agent_environment", "loop_step"]>;
+            readonly id: Schema.String;
+            readonly title: Schema.String;
+            readonly reason: Schema.String;
+        }>>>;
+        readonly retrievalRefs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "session", "session_update", "proposal", "task_dependency", "repo_binding", "agent_environment", "loop_step"]>;
+            readonly id: Schema.String;
+            readonly label: Schema.String;
+        }>>>;
+        readonly relevanceSummary: Schema.optionalKey<Schema.Struct<{
+            readonly included: Schema.$Array<Schema.String>;
+            readonly omitted: Schema.$Array<Schema.String>;
+            readonly notes: Schema.$Array<Schema.String>;
+            readonly readiness: Schema.optionalKey<Schema.Struct<{
+                readonly scopeAvailable: Schema.Boolean;
+                readonly acceptanceCriteriaAvailable: Schema.Boolean;
+                readonly dependenciesSatisfied: Schema.Boolean;
+                readonly executionPlanAvailable: Schema.Boolean;
+                readonly repoBindingAvailable: Schema.Boolean;
+                readonly verificationCommands: Schema.$Array<Schema.String>;
+                readonly deliveryTargetAvailable: Schema.Boolean;
+            }>>;
+        }>>;
+        readonly budget: Schema.optionalKey<Schema.Struct<{
+            readonly maxMarkdownChars: Schema.Int;
+            readonly markdownChars: Schema.Int;
+            readonly indexedItemCount: Schema.Int;
+            readonly retrievalRefCount: Schema.Int;
+        }>>;
+        readonly includedDecisionIds: Schema.optionalKey<Schema.$Array<Schema.String>>;
+        readonly includedProposalIds: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_get_context_pack_retrieval_ref';
+    readonly description: 'Fetch authorized deeper context for a ContextPack retrieval reference without exposing raw unsafe content by default.';
+    readonly input: Schema.Struct<{
+        readonly contextPackId: Schema.String;
+        readonly ref: Schema.Struct<{
+            readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "session", "session_update", "proposal", "task_dependency", "repo_binding", "agent_environment", "loop_step"]>;
+            readonly id: Schema.String;
+            readonly label: Schema.String;
+        }>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly contextPackId: Schema.String;
+        readonly ref: Schema.Struct<{
+            readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "session", "session_update", "proposal", "task_dependency", "repo_binding", "agent_environment", "loop_step"]>;
+            readonly id: Schema.String;
+            readonly label: Schema.String;
+        }>;
+        readonly contentMarkdown: Schema.String;
+        readonly safety: Schema.Struct<{
+            readonly rawContentIncluded: Schema.Boolean;
+            readonly notes: Schema.$Array<Schema.String>;
+        }>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_record_context_relevance_feedback';
+    readonly description: 'Record missing, irrelevant, stale, or useful ContextPack feedback and optionally create a durable Proposal candidate.';
+    readonly input: Schema.Struct<{
+        readonly kind: Schema.Literals<readonly ["missing_context", "irrelevant_context", "stale_context", "useful_context"]>;
+        readonly contextPackId: Schema.String;
+        readonly sessionId: Schema.optionalKey<Schema.String>;
+        readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+        readonly retrievalRefKind: Schema.optionalKey<Schema.String>;
+        readonly retrievalRefId: Schema.optionalKey<Schema.String>;
+        readonly content: Schema.String;
+        readonly evidence: Schema.optionalKey<Schema.String>;
+        readonly proposalCandidate: Schema.optionalKey<Schema.Struct<{
+            readonly targetType: Schema.Literals<readonly ["memory", "kit", "decision", "agent_environment_policy", "project_context", "context_relevance"]>;
+            readonly title: Schema.String;
+            readonly summary: Schema.String;
+            readonly suggestedChange: Schema.String;
+            readonly riskLevel: Schema.optionalKey<Schema.Literals<readonly ["low", "medium", "high"]>>;
+        }>>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly feedback: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly projectId: Schema.optionalKey<Schema.String>;
+            readonly taskId: Schema.String;
+            readonly contextPackId: Schema.String;
+            readonly sessionId: Schema.optionalKey<Schema.String>;
+            readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+            readonly kind: Schema.Literals<readonly ["missing_context", "irrelevant_context", "stale_context", "useful_context"]>;
+            readonly retrievalRefKind: Schema.optionalKey<Schema.String>;
+            readonly retrievalRefId: Schema.optionalKey<Schema.String>;
+            readonly content: Schema.String;
+            readonly evidence: Schema.optionalKey<Schema.String>;
+            readonly generatedProposalId: Schema.optionalKey<Schema.String>;
+            readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+            readonly createdByActorId: Schema.String;
+            readonly createdAt: Schema.String;
+        }>;
+        readonly proposal: Schema.optionalKey<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly projectId: Schema.optionalKey<Schema.String>;
+            readonly taskId: Schema.optionalKey<Schema.String>;
+            readonly target: Schema.Struct<{
+                readonly type: Schema.Literals<readonly ["memory", "kit", "agent_environment_policy", "decision", "task", "project_context", "context_relevance", "kit_source", "kit_version", "kit_installation", "kit_activation", "kit_trust_policy"]>;
+                readonly id: Schema.optionalKey<Schema.String>;
+                readonly scopeType: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"workspace">, Schema.Literal<"project">, Schema.Literal<"task">, Schema.Literal<"kit">]>>;
+                readonly scopeId: Schema.optionalKey<Schema.String>;
+            }>;
+            readonly title: Schema.String;
+            readonly summary: Schema.String;
+            readonly status: Schema.Literals<readonly ["proposed", "in_review", "approved", "rejected", "applied", "reverted", "superseded", "canceled"]>;
+            readonly riskLevel: Schema.Literals<readonly ["low", "medium", "high"]>;
+            readonly approvalPolicy: Schema.Struct<{
+                readonly mode: Schema.Literals<readonly ["auto_approve_low_risk", "require_other_project_member", "require_workspace_owner_or_admin"]>;
+                readonly requireDifferentApprover: Schema.optionalKey<Schema.Boolean>;
+                readonly autonomousAgentApprovalAllowed: Schema.Literal<false>;
+                readonly deniedViolationCodes: Schema.$Array<Schema.Literals<readonly ["autonomous_self_approval", "self_capability_escalation", "missing_required_approval", "unsafe_payload", "target_conflict"]>>;
+            }>;
+            readonly proposedByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+            readonly proposedByActorId: Schema.String;
+            readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_get_task_execution_record';
+    readonly description: 'Read the authorized, paginated execution record rooted in Runs and StepAttempts for a Task.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly limit: Schema.optionalKey<Schema.Int>;
+        readonly cursor: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly items: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+            readonly id: Schema.String;
+            readonly taskId: Schema.String;
+            readonly occurredAt: Schema.String;
+            readonly links: Schema.optionalKey<Schema.Struct<{
+                readonly sessionId: Schema.optionalKey<Schema.String>;
+                readonly runId: Schema.optionalKey<Schema.String>;
+                readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+                readonly questionId: Schema.optionalKey<Schema.String>;
+                readonly taskThreadEntryId: Schema.optionalKey<Schema.String>;
+                readonly artefactId: Schema.optionalKey<Schema.String>;
+                readonly taskActionId: Schema.optionalKey<Schema.String>;
+            }>>;
+            readonly kind: Schema.Literal<"session">;
+            readonly session: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly actorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+                readonly actorId: Schema.String;
+                readonly agentIdentityId: Schema.optionalKey<Schema.String>;
+                readonly status: Schema.Union<readonly [Schema.Literal<"active">, Schema.Literal<"ended">]>;
+                readonly startedAt: Schema.String;
+                readonly endedAt: Schema.optionalKey<Schema.String>;
+                readonly createdAt: Schema.String;
+                readonly updatedAt: Schema.String;
+            }>;
+        }>, Schema.Struct<{
+            readonly id: Schema.String;
+            readonly taskId: Schema.String;
+            readonly occurredAt: Schema.String;
+            readonly links: Schema.optionalKey<Schema.Struct<{
+                readonly sessionId: Schema.optionalKey<Schema.String>;
+                readonly runId: Schema.optionalKey<Schema.String>;
+                readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+                readonly questionId: Schema.optionalKey<Schema.String>;
+                readonly taskThreadEntryId: Schema.optionalKey<Schema.String>;
+                readonly artefactId: Schema.optionalKey<Schema.String>;
+                readonly taskActionId: Schema.optionalKey<Schema.String>;
+            }>>;
+            readonly kind: Schema.Literal<"run">;
+            readonly run: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly sessionId: Schema.optionalKey<Schema.String>;
+                readonly loopId: Schema.String;
+                readonly resourceVersion: Schema.Int;
+                readonly status: Schema.Literals<readonly ["pending", "running", "blocked", "completed", "failed", "canceled", "expired"]>;
+                readonly startedAt: Schema.optionalKey<Schema.String>;
+                readonly completedAt: Schema.optionalKey<Schema.String>;
+                readonly createdAt: Schema.String;
+                readonly updatedAt: Schema.String;
+            }>;
+        }>, Schema.Struct<{
+            readonly id: Schema.String;
+            readonly taskId: Schema.String;
+            readonly occurredAt: Schema.String;
+            readonly links: Schema.optionalKey<Schema.Struct<{
+                readonly sessionId: Schema.optionalKey<Schema.String>;
+                readonly runId: Schema.optionalKey<Schema.String>;
+                readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+                readonly questionId: Schema.optionalKey<Schema.String>;
+                readonly taskThreadEntryId: Schema.optionalKey<Schema.String>;
+                readonly artefactId: Schema.optionalKey<Schema.String>;
+                readonly taskActionId: Schema.optionalKey<Schema.String>;
+            }>>;
+            readonly kind: Schema.Literal<"step_attempt">;
+            readonly stepAttempt: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly sessionId: Schema.optionalKey<Schema.String>;
+                readonly runId: Schema.String;
+                readonly stepSnapshotId: Schema.optionalKey<Schema.String>;
+                readonly stepKey: Schema.String;
+                readonly sequence: Schema.Int;
+                readonly attempt: Schema.Int;
+                readonly retryOfAttemptId: Schema.optionalKey<Schema.String>;
+                readonly status: Schema.Literals<readonly ["pending", "running", "waiting", "blocked", "completed", "failed", "canceled"]>;
+                readonly inputManifest: Schema.Struct<{
+                    readonly manifestVersion: Schema.Int;
+                    readonly assembledAt: Schema.String;
+                    readonly entries: Schema.$Array<Schema.Union<readonly [Schema.Struct<{
+                        readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "knowledge_record", "context_pack"]>;
+                        readonly sourceId: Schema.String;
+                        readonly sourceScope: Schema.Struct<{
+                            readonly kind: Schema.Literals<readonly ["workspace", "project", "task", "loop", "agent"]>;
+                            readonly id: Schema.String;
+                        }>;
+                        readonly inclusionReason: Schema.String;
+                        readonly resolvedAt: Schema.String;
+                        readonly appliedToStepKey: Schema.String;
+                        readonly availability: Schema.Union<readonly [Schema.Struct<{
+                            readonly kind: Schema.Literal<"available">;
+                            readonly inspectRef: Schema.Struct<{
+                                readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
+                                readonly id: Schema.optionalKey<Schema.String>;
+                                readonly externalId: Schema.optionalKey<Schema.String>;
+                                readonly provider: Schema.optionalKey<Schema.String>;
+                                readonly title: Schema.optionalKey<Schema.String>;
+                            }>;
+                        }>, Schema.Struct<{
+                            readonly kind: Schema.Union<readonly [Schema.Literal<"redacted">, Schema.Literal<"unavailable">]>;
+                            readonly reason: Schema.String;
+                        }>]>;
+                        readonly sourceVersion: Schema.String;
+                    }>, Schema.Struct<{
+                        readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "knowledge_record", "context_pack"]>;
+                        readonly sourceId: Schema.String;
+                        readonly sourceScope: Schema.Struct<{
+                            readonly kind: Schema.Literals<readonly ["workspace", "project", "task", "loop", "agent"]>;
+                            readonly id: Schema.String;
+                        }>;
+                        readonly inclusionReason: Schema.String;
+                        readonly resolvedAt: Schema.String;
+                        readonly appliedToStepKey: Schema.String;
+                        readonly availability: Schema.Union<readonly [Schema.Struct<{
+                            readonly kind: Schema.Literal<"available">;
+                            readonly inspectRef: Schema.Struct<{
+                                readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
+                                readonly id: Schema.optionalKey<Schema.String>;
+                                readonly externalId: Schema.optionalKey<Schema.String>;
+                                readonly provider: Schema.optionalKey<Schema.String>;
+                                readonly title: Schema.optionalKey<Schema.String>;
+                            }>;
+                        }>, Schema.Struct<{
+                            readonly kind: Schema.Union<readonly [Schema.Literal<"redacted">, Schema.Literal<"unavailable">]>;
+                            readonly reason: Schema.String;
+                        }>]>;
+                        readonly contentSha256: Schema.String;
+                    }>]>>;
+                    readonly budget: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<import("./loop").LoopStepOutputDataValue, import("./loop").LoopStepOutputDataValue, never, never>>>;
+                }>;
+                readonly execution: Schema.Struct<{
+                    readonly agent: Schema.optionalKey<Schema.Struct<{
+                        readonly id: Schema.String;
+                        readonly version: Schema.optionalKey<Schema.String>;
+                    }>>;
+                    readonly runner: Schema.optionalKey<Schema.Struct<{
+                        readonly id: Schema.String;
+                    }>>;
+                    readonly harness: Schema.optionalKey<Schema.optionalKey<Schema.String>>;
+                    readonly model: Schema.optionalKey<Schema.optionalKey<Schema.String>>;
+                }>;
+                readonly output: Schema.optionalKey<Schema.Struct<{
+                    readonly summary: Schema.String;
+                    readonly refs: Schema.$Array<Schema.Struct<{
+                        readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
+                        readonly id: Schema.optionalKey<Schema.String>;
+                        readonly externalId: Schema.optionalKey<Schema.String>;
+                        readonly provider: Schema.optionalKey<Schema.String>;
+                        readonly title: Schema.optionalKey<Schema.String>;
+                    }>>;
+                    readonly metadata: Schema.optionalKey<Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<import("./loop").LoopStepOutputDataValue, import("./loop").LoopStepOutputDataValue, never, never>>>>;
+                }>>;
+                readonly failureSummary: Schema.optionalKey<Schema.optionalKey<Schema.String>>;
+                readonly reviewEvidence: Schema.$Array<Schema.Struct<{
+                    readonly kind: Schema.Literals<readonly ["task", "kit", "memory", "decision", "knowledge_record", "context_pack", "step_attempt", "change_request", "change_request_review", "provider_action", "thread_entry", "run", "artifact"]>;
+                    readonly id: Schema.optionalKey<Schema.String>;
+                    readonly externalId: Schema.optionalKey<Schema.String>;
+                    readonly provider: Schema.optionalKey<Schema.String>;
+                    readonly title: Schema.optionalKey<Schema.String>;
+                }>>;
+                readonly startedAt: Schema.optionalKey<Schema.String>;
+                readonly completedAt: Schema.optionalKey<Schema.String>;
+                readonly createdAt: Schema.String;
+                readonly updatedAt: Schema.String;
+            }>;
+        }>, Schema.Struct<{
+            readonly id: Schema.String;
+            readonly taskId: Schema.String;
+            readonly occurredAt: Schema.String;
+            readonly links: Schema.optionalKey<Schema.Struct<{
+                readonly sessionId: Schema.optionalKey<Schema.String>;
+                readonly runId: Schema.optionalKey<Schema.String>;
+                readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+                readonly questionId: Schema.optionalKey<Schema.String>;
+                readonly taskThreadEntryId: Schema.optionalKey<Schema.String>;
+                readonly artefactId: Schema.optionalKey<Schema.String>;
+                readonly taskActionId: Schema.optionalKey<Schema.String>;
+            }>>;
+            readonly kind: Schema.Literal<"question">;
+            readonly question: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly runId: Schema.String;
+                readonly stepKey: Schema.String;
+                readonly status: Schema.Literals<readonly ["open", "answered", "resume_requested", "resumed", "resume_failed", "expired", "cancelled"]>;
+                readonly createdAt: Schema.String;
+                readonly updatedAt: Schema.String;
+                readonly resolvedAt: Schema.optionalKey<Schema.String>;
+            }>;
+        }>, Schema.Struct<{
+            readonly id: Schema.String;
+            readonly taskId: Schema.String;
+            readonly occurredAt: Schema.String;
+            readonly links: Schema.optionalKey<Schema.Struct<{
+                readonly sessionId: Schema.optionalKey<Schema.String>;
+                readonly runId: Schema.optionalKey<Schema.String>;
+                readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+                readonly questionId: Schema.optionalKey<Schema.String>;
+                readonly taskThreadEntryId: Schema.optionalKey<Schema.String>;
+                readonly artefactId: Schema.optionalKey<Schema.String>;
+                readonly taskActionId: Schema.optionalKey<Schema.String>;
+            }>>;
+            readonly kind: Schema.Literal<"task_thread_entry">;
+            readonly threadEntry: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly kind: Schema.Union<readonly [Schema.Literal<"note">, Schema.Literal<"question">, Schema.Literal<"answer">, Schema.Literal<"decision">, Schema.Literal<"blocker">, Schema.Literal<"finding">, Schema.Literal<"handoff">, Schema.Literal<"test_result">, Schema.Literal<"file_reference">, Schema.Literal<"status_change">, Schema.Literal<"assignment_change">, Schema.Literal<"link">, Schema.Literal<"change_request_review">]>;
+                readonly createdAt: Schema.String;
+            }>;
+        }>, Schema.Struct<{
+            readonly id: Schema.String;
+            readonly taskId: Schema.String;
+            readonly occurredAt: Schema.String;
+            readonly links: Schema.optionalKey<Schema.Struct<{
+                readonly sessionId: Schema.optionalKey<Schema.String>;
+                readonly runId: Schema.optionalKey<Schema.String>;
+                readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+                readonly questionId: Schema.optionalKey<Schema.String>;
+                readonly taskThreadEntryId: Schema.optionalKey<Schema.String>;
+                readonly artefactId: Schema.optionalKey<Schema.String>;
+                readonly taskActionId: Schema.optionalKey<Schema.String>;
+            }>>;
+            readonly kind: Schema.Literal<"artefact">;
+            readonly artefact: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly filename: Schema.String;
+                readonly contentType: Schema.String;
+                readonly byteSize: Schema.Finite;
+                readonly status: Schema.Literals<readonly ["pending", "available", "deleted"]>;
+                readonly createdAt: Schema.String;
+                readonly updatedAt: Schema.String;
+            }>;
+        }>, Schema.Struct<{
+            readonly id: Schema.String;
+            readonly taskId: Schema.String;
+            readonly occurredAt: Schema.String;
+            readonly links: Schema.optionalKey<Schema.Struct<{
+                readonly sessionId: Schema.optionalKey<Schema.String>;
+                readonly runId: Schema.optionalKey<Schema.String>;
+                readonly stepAttemptId: Schema.optionalKey<Schema.String>;
+                readonly questionId: Schema.optionalKey<Schema.String>;
+                readonly taskThreadEntryId: Schema.optionalKey<Schema.String>;
+                readonly artefactId: Schema.optionalKey<Schema.String>;
+                readonly taskActionId: Schema.optionalKey<Schema.String>;
+            }>>;
+            readonly kind: Schema.Literal<"task_action">;
+            readonly taskAction: Schema.Struct<{
+                readonly id: Schema.String;
+                readonly action: Schema.String;
+                readonly actorType: Schema.String;
+                readonly actorId: Schema.String;
+            }>;
+        }>]>>;
+        readonly pageInfo: Schema.Struct<{
+            readonly limit: Schema.Int;
+            readonly hasNextPage: Schema.Boolean;
+            readonly nextCursor: Schema.optionalKey<Schema.String>;
+        }>;
+        readonly freshness: Schema.Struct<{
+            readonly generatedAt: Schema.String;
+            readonly isComplete: Schema.Boolean;
+            readonly redactedEntryCount: Schema.Int;
+        }>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_list_memories';
+    readonly description: 'List Memory visible to the calling actor.';
+    readonly input: Schema.Struct<{
+        readonly workspaceId: Schema.optionalKey<Schema.String>;
+        readonly status: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"proposed">, Schema.Literal<"accepted">, Schema.Literal<"rejected">, Schema.Literal<"deprecated">]>>;
+        readonly scopeType: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"kit">, Schema.Literal<"project">, Schema.Literal<"task">]>>;
+        readonly scopeId: Schema.optionalKey<Schema.String>;
+        readonly limit: Schema.optionalKey<Schema.Int>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly items: Schema.$Array<Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly scopeType: Schema.Union<readonly [Schema.Literal<"kit">, Schema.Literal<"project">, Schema.Literal<"task">]>;
+            readonly scopeId: Schema.String;
+            readonly content: Schema.String;
+            readonly status: Schema.Union<readonly [Schema.Literal<"proposed">, Schema.Literal<"accepted">, Schema.Literal<"rejected">, Schema.Literal<"deprecated">]>;
+            readonly confidence: Schema.Union<readonly [Schema.Literal<"low">, Schema.Literal<"medium">, Schema.Literal<"high">]>;
+            readonly sourceType: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"user">, Schema.Literal<"agent">, Schema.Literal<"session">, Schema.Literal<"context_pack">]>>;
+            readonly sourceId: Schema.optionalKey<Schema.String>;
+            readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+            readonly createdByActorId: Schema.String;
+            readonly approvedByUserId: Schema.optionalKey<Schema.String>;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_get_memory';
+    readonly description: 'Read one Memory by id if visible to the calling actor.';
+    readonly input: Schema.Struct<{
+        readonly memoryId: Schema.String;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly memory: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly scopeType: Schema.Union<readonly [Schema.Literal<"kit">, Schema.Literal<"project">, Schema.Literal<"task">]>;
+            readonly scopeId: Schema.String;
+            readonly content: Schema.String;
+            readonly status: Schema.Union<readonly [Schema.Literal<"proposed">, Schema.Literal<"accepted">, Schema.Literal<"rejected">, Schema.Literal<"deprecated">]>;
+            readonly confidence: Schema.Union<readonly [Schema.Literal<"low">, Schema.Literal<"medium">, Schema.Literal<"high">]>;
+            readonly sourceType: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"user">, Schema.Literal<"agent">, Schema.Literal<"session">, Schema.Literal<"context_pack">]>>;
+            readonly sourceId: Schema.optionalKey<Schema.String>;
+            readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+            readonly createdByActorId: Schema.String;
+            readonly approvedByUserId: Schema.optionalKey<Schema.String>;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_get_context_pack';
+    readonly description: 'Generate a fresh Kitman ContextPack for a Task.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly mode: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"planning">, Schema.Literal<"implementation">, Schema.Literal<"debugging">, Schema.Literal<"review">, Schema.Literal<"handoff">]>>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly contextPackId: Schema.String;
+        readonly mode: Schema.Union<readonly [Schema.Literal<"planning">, Schema.Literal<"implementation">, Schema.Literal<"debugging">, Schema.Literal<"review">, Schema.Literal<"handoff">]>;
+        readonly contentMarkdown: Schema.String;
+        readonly launchBrief: Schema.optionalKey<Schema.Struct<{
+            readonly mode: Schema.Union<readonly [Schema.Literal<"planning">, Schema.Literal<"implementation">, Schema.Literal<"debugging">, Schema.Literal<"review">, Schema.Literal<"handoff">]>;
+            readonly taskTitle: Schema.String;
+            readonly projectName: Schema.optionalKey<Schema.String>;
+            readonly summary: Schema.String;
+        }>>;
+        readonly contextIndex: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly kind: Schema.Literals<readonly ["task", "project", "kit", "memory", "decision", "session", "session_update", "proposal", "task_dependency", "repo_binding", "agent_environment", "loop_step"]>;
+            readonly id: Schema.String;
+            readonly title: Schema.String;
+            readonly reason: Schema.String;
+        }>>>;
+        readonly retrievalRefs: Schema.optionalKey<Schema.$Array<Schema.Struct<{
+            readonly kind: Schema.Literals<readonly ["kit", "memory", "decision", "session", "session_update", "proposal", "task_dependency", "repo_binding", "agent_environment", "loop_step"]>;
+            readonly id: Schema.String;
+            readonly label: Schema.String;
+        }>>>;
+        readonly relevanceSummary: Schema.optionalKey<Schema.Struct<{
+            readonly included: Schema.$Array<Schema.String>;
+            readonly omitted: Schema.$Array<Schema.String>;
+            readonly notes: Schema.$Array<Schema.String>;
+            readonly readiness: Schema.optionalKey<Schema.Struct<{
+                readonly scopeAvailable: Schema.Boolean;
+                readonly acceptanceCriteriaAvailable: Schema.Boolean;
+                readonly dependenciesSatisfied: Schema.Boolean;
+                readonly executionPlanAvailable: Schema.Boolean;
+                readonly repoBindingAvailable: Schema.Boolean;
+                readonly verificationCommands: Schema.$Array<Schema.String>;
+                readonly deliveryTargetAvailable: Schema.Boolean;
+            }>>;
+        }>>;
+        readonly budget: Schema.optionalKey<Schema.Struct<{
+            readonly maxMarkdownChars: Schema.Int;
+            readonly markdownChars: Schema.Int;
+            readonly indexedItemCount: Schema.Int;
+            readonly retrievalRefCount: Schema.Int;
+        }>>;
+        readonly includedDecisionIds: Schema.optionalKey<Schema.$Array<Schema.String>>;
+        readonly includedProposalIds: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_record_session_update';
+    readonly description: 'Record a structured session update.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly sessionId: Schema.optionalKey<Schema.String>;
+        readonly kind: Schema.Union<readonly [Schema.Literal<"note">, Schema.Literal<"question">, Schema.Literal<"answer">, Schema.Literal<"decision">, Schema.Literal<"blocker">, Schema.Literal<"finding">, Schema.Literal<"handoff">, Schema.Literal<"test_result">, Schema.Literal<"file_reference">, Schema.Literal<"status_change">, Schema.Literal<"assignment_change">, Schema.Literal<"link">]>;
+        readonly content: Schema.String;
+        readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly sessionId: Schema.String;
+        readonly sessionUpdateId: Schema.String;
+        readonly kind: Schema.Union<readonly [Schema.Literal<"note">, Schema.Literal<"question">, Schema.Literal<"answer">, Schema.Literal<"decision">, Schema.Literal<"blocker">, Schema.Literal<"finding">, Schema.Literal<"handoff">, Schema.Literal<"test_result">, Schema.Literal<"file_reference">, Schema.Literal<"status_change">, Schema.Literal<"assignment_change">, Schema.Literal<"link">]>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_record_task_thread_entry';
+    readonly description: 'Record a typed Task thread entry visible to humans and agents.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly kind: Schema.Union<readonly [Schema.Literal<"note">, Schema.Literal<"question">, Schema.Literal<"answer">, Schema.Literal<"decision">, Schema.Literal<"blocker">, Schema.Literal<"finding">, Schema.Literal<"handoff">, Schema.Literal<"test_result">, Schema.Literal<"file_reference">, Schema.Literal<"status_change">, Schema.Literal<"assignment_change">, Schema.Literal<"link">, Schema.Literal<"change_request_review">]>;
+        readonly content: Schema.String;
+        readonly replyToEntryId: Schema.optionalKey<Schema.String>;
+        readonly sessionId: Schema.optionalKey<Schema.String>;
+        readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly threadEntryId: Schema.String;
+        readonly kind: Schema.Union<readonly [Schema.Literal<"note">, Schema.Literal<"question">, Schema.Literal<"answer">, Schema.Literal<"decision">, Schema.Literal<"blocker">, Schema.Literal<"finding">, Schema.Literal<"handoff">, Schema.Literal<"test_result">, Schema.Literal<"file_reference">, Schema.Literal<"status_change">, Schema.Literal<"assignment_change">, Schema.Literal<"link">, Schema.Literal<"change_request_review">]>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_post_task_question';
+    readonly description: 'Post a question to the Task thread for a human to answer.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly sessionId: Schema.optionalKey<Schema.String>;
+        readonly content: Schema.String;
+        readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly threadEntryId: Schema.String;
+        readonly kind: Schema.Union<readonly [Schema.Literal<"note">, Schema.Literal<"question">, Schema.Literal<"answer">, Schema.Literal<"decision">, Schema.Literal<"blocker">, Schema.Literal<"finding">, Schema.Literal<"handoff">, Schema.Literal<"test_result">, Schema.Literal<"file_reference">, Schema.Literal<"status_change">, Schema.Literal<"assignment_change">, Schema.Literal<"link">, Schema.Literal<"change_request_review">]>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_record_decision';
+    readonly description: 'Record an explicit decision for a Task session.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly sessionId: Schema.optionalKey<Schema.String>;
+        readonly content: Schema.String;
+        readonly rationale: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly sessionId: Schema.String;
+        readonly sessionUpdateId: Schema.String;
+        readonly kind: Schema.Union<readonly [Schema.Literal<"note">, Schema.Literal<"question">, Schema.Literal<"answer">, Schema.Literal<"decision">, Schema.Literal<"blocker">, Schema.Literal<"finding">, Schema.Literal<"handoff">, Schema.Literal<"test_result">, Schema.Literal<"file_reference">, Schema.Literal<"status_change">, Schema.Literal<"assignment_change">, Schema.Literal<"link">]>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_record_blocker';
+    readonly description: 'Record a blocker for a Task session.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly sessionId: Schema.optionalKey<Schema.String>;
+        readonly content: Schema.String;
+        readonly severity: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"low">, Schema.Literal<"medium">, Schema.Literal<"high">]>>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly sessionId: Schema.String;
+        readonly sessionUpdateId: Schema.String;
+        readonly kind: Schema.Union<readonly [Schema.Literal<"note">, Schema.Literal<"question">, Schema.Literal<"answer">, Schema.Literal<"decision">, Schema.Literal<"blocker">, Schema.Literal<"finding">, Schema.Literal<"handoff">, Schema.Literal<"test_result">, Schema.Literal<"file_reference">, Schema.Literal<"status_change">, Schema.Literal<"assignment_change">, Schema.Literal<"link">]>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_link_task_artifact';
+    readonly description: 'Link a delivery artifact such as a merge request to a Task.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly kind: Schema.String;
+        readonly url: Schema.String;
+        readonly title: Schema.optionalKey<Schema.String>;
+        readonly provider: Schema.optionalKey<Schema.String>;
+        readonly externalId: Schema.optionalKey<Schema.String>;
+        readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.Unknown>>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly linkId: Schema.String;
+        readonly threadEntryId: Schema.String;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_create_task_asset_upload';
+    readonly description: 'Create a Task asset upload and return a short-lived direct upload URL.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly filename: Schema.String;
+        readonly contentType: Schema.String;
+        readonly byteSize: Schema.Finite;
+        readonly checksumSha256: Schema.String;
+        readonly sessionId: Schema.optionalKey<Schema.String>;
+        readonly description: Schema.optionalKey<Schema.String>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly asset: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly taskId: Schema.String;
+            readonly sessionId: Schema.optionalKey<Schema.String>;
+            readonly filename: Schema.String;
+            readonly contentType: Schema.String;
+            readonly byteSize: Schema.Finite;
+            readonly checksumSha256: Schema.String;
+            readonly description: Schema.optionalKey<Schema.String>;
+            readonly status: Schema.Literals<readonly ["pending", "available", "deleted"]>;
+            readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+            readonly createdByActorId: Schema.String;
+            readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+            readonly deletedAt: Schema.optionalKey<Schema.String>;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>;
+        readonly upload: Schema.Struct<{
+            readonly method: Schema.Union<readonly [Schema.Literal<"PUT">, Schema.Literal<"GET">]>;
+            readonly url: Schema.String;
+            readonly expiresAt: Schema.String;
+            readonly headers: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+        }>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_complete_task_asset_upload';
+    readonly description: 'Complete a pending Task asset upload after server-side object verification.';
+    readonly input: Schema.Struct<{
+        readonly assetId: Schema.String;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly asset: Schema.Struct<{
+            readonly id: Schema.String;
+            readonly workspaceId: Schema.String;
+            readonly taskId: Schema.String;
+            readonly sessionId: Schema.optionalKey<Schema.String>;
+            readonly filename: Schema.String;
+            readonly contentType: Schema.String;
+            readonly byteSize: Schema.Finite;
+            readonly checksumSha256: Schema.String;
+            readonly description: Schema.optionalKey<Schema.String>;
+            readonly status: Schema.Literals<readonly ["pending", "available", "deleted"]>;
+            readonly createdByActorType: Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"delegated_agent">, Schema.Literal<"agent">]>;
+            readonly createdByActorId: Schema.String;
+            readonly delegatedByUserId: Schema.optionalKey<Schema.String>;
+            readonly deletedAt: Schema.optionalKey<Schema.String>;
+            readonly createdAt: Schema.String;
+            readonly updatedAt: Schema.String;
+        }>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_get_task_asset_download_url';
+    readonly description: 'Get a short-lived download URL for an available Task asset.';
+    readonly input: Schema.Struct<{
+        readonly assetId: Schema.String;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly download: Schema.Struct<{
+            readonly method: Schema.Union<readonly [Schema.Literal<"PUT">, Schema.Literal<"GET">]>;
+            readonly url: Schema.String;
+            readonly expiresAt: Schema.String;
+            readonly headers: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
+        }>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_delete_task_asset';
+    readonly description: 'Delete a Task asset created by the calling agent actor.';
+    readonly input: Schema.Struct<{
+        readonly assetId: Schema.String;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly deleted: Schema.Literal<true>;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: true;
+    };
+}, {
+    readonly name: 'kitman_propose_memory';
+    readonly description: 'Propose durable memory for human approval.';
+    readonly input: Schema.Struct<{
+        readonly scopeType: Schema.Union<readonly [Schema.Literal<"kit">, Schema.Literal<"project">, Schema.Literal<"task">]>;
+        readonly scopeId: Schema.String;
+        readonly content: Schema.String;
+        readonly confidence: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"low">, Schema.Literal<"medium">, Schema.Literal<"high">]>>;
+        readonly source: Schema.optionalKey<Schema.Struct<{
+            readonly taskId: Schema.optionalKey<Schema.String>;
+            readonly sessionId: Schema.optionalKey<Schema.String>;
+        }>>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly memoryId: Schema.String;
+        readonly status: Schema.Literal<"proposed">;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+    };
+}, {
+    readonly name: 'kitman_generate_handoff';
+    readonly description: 'Generate a handoff summary and end the Task session.';
+    readonly input: Schema.Struct<{
+        readonly taskId: Schema.String;
+        readonly sessionId: Schema.optionalKey<Schema.String>;
+        readonly target: Schema.optionalKey<Schema.Union<readonly [Schema.Literal<"human">, Schema.Literal<"agent">]>>;
+        readonly summary: Schema.String;
+        readonly nextSteps: Schema.optionalKey<Schema.$Array<Schema.String>>;
+        readonly openQuestions: Schema.optionalKey<Schema.$Array<Schema.String>>;
+    }>;
+    readonly output: Schema.Struct<{
+        readonly sessionId: Schema.String;
+        readonly sessionUpdateId: Schema.String;
+        readonly ended: Schema.Boolean;
+        readonly handoffMarkdown: Schema.String;
+    }>;
+    readonly annotations: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+    };
+}];
+export declare const KitmanAgentCapabilityNames: readonly ("kitman_add_task_member" | "kitman_complete_task_asset_upload" | "kitman_create_repo_binding" | "kitman_create_task_asset_upload" | "kitman_delete_task_asset" | "kitman_generate_handoff" | "kitman_get_context_pack" | "kitman_get_context_pack_retrieval_ref" | "kitman_get_context_pack_snapshot" | "kitman_get_latest_context_pack" | "kitman_get_memory" | "kitman_get_session" | "kitman_get_task" | "kitman_get_task_asset_download_url" | "kitman_get_task_execution_record" | "kitman_link_task_artifact" | "kitman_list_accessible_projects" | "kitman_list_memories" | "kitman_list_repo_bindings" | "kitman_list_session_updates" | "kitman_list_task_dependencies" | "kitman_list_task_members" | "kitman_list_task_sessions" | "kitman_list_task_thread_entries" | "kitman_post_task_question" | "kitman_propose_memory" | "kitman_record_blocker" | "kitman_record_context_relevance_feedback" | "kitman_record_decision" | "kitman_record_session_update" | "kitman_record_task_thread_entry" | "kitman_remove_task_member" | "kitman_resolve_project_context" | "kitman_search_tasks")[];
+export type KitmanAgentCapabilityName = (typeof KitmanAgentCapabilityNames)[number];