@hasna/todos 0.15.52 → 0.17.0

package/dist/sdk/resolve.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Credential and authority resolution for the `@hasna/todos/sdk` surface.
+ *
+ * There is exactly ONE resolver on the fleet — the client chain in
+ * `@hasna/contracts/client` — and this module is the SDK's adapter onto it
+ * (2026-09-04 adoption ruling, hasna/apps#1720). The SDK used to carry its own
+ * chain: `TODOS_URL` for the authority and an unprefixed key name (or an `apiKey` field
+ * inside `~/.todos/config.json`) for the credential. Both are gone. A credential
+ * in `config.json` was a world-readable secret in a file the CLI also rewrites
+ * for unrelated settings, and the unprefixed names shadowed the canonical
+ * `HASNA_TODOS_API_URL` / `HASNA_TODOS_API_KEY` pair — an operator who exported
+ * the canonical pair got the localhost default anyway.
+ *
+ * The tiers are the fleet's five, resolved fresh on every call:
+ *
+ *   1. an explicit argument      — `options.apiKey` / `options.baseUrl`
+ *   2. a deliberate env pointer  — `HASNA_TODOS_API_KEY_OVERRIDE`, `HASNA_PROFILE`,
+ *                                  `HASNA_TODOS_API_KEY_REF`
+ *   3. the macOS Keychain        — `hasna.credentials.todos.api-key`
+ *   4. disk                      — `~/.hasna/todos/config/credentials` (0400/0600)
+ *   5. `HASNA_TODOS_API_KEY`     — a legitimate tier, no deprecation notice
+ *
+ * with the authority following `HASNA_TODOS_API_URL`, the Keychain `api-url`
+ * item, the credentials file, and finally the fleet gateway
+ * `https://api.hasna.com/todos`. The legacy unprefixed `TODOS_*` spellings
+ * remain only as the resolver's silent alias fallback for one release.
+ *
+ * LOCAL MODE IS DELIBERATE, NEVER A FALLBACK FROM FAILURE. `TodosClient` speaks
+ * the `/api/*` plane that `todos-serve` exposes on a workstation, so the
+ * unhosted `http://localhost:19427` (no credential) is a real product mode —
+ * but it is reachable in exactly ONE way: the explicit opt-in
+ * `HASNA_TODOS_LOCAL=1` (alias `TODOS_LOCAL=1`), answered before the resolver
+ * runs. An environment where nothing resolves at all THROWS
+ * `TODOS_CREDENTIAL_MISSING`, the same as `createTodosV1Client`; it used to
+ * degrade to the local serve with only a stderr notice, which the 2026-09-04
+ * fail-closed ruling (owner ruling 2026-09-07, hasna/apps#1720 validation)
+ * forbids: "nothing configured" is exactly the state in which a client
+ * silently reading an empty local store looks healthy. A credential that
+ * resolves but cannot be used, an unreadable credential file, an authority that
+ * is set but malformed — every one of those throws too. And when local mode IS
+ * selected the SDK says so, once per process, on stderr.
+ */
+import { type CredentialChainOptions } from "@hasna/contracts/client";
+import { TodosV1Client, type TodosV1ClientOptions } from "./v1.generated.js";
+/** The unhosted `todos-serve` a workstation runs. Never a hosted authority. */
+export declare const TODOS_LOCAL_SERVE_URL = "http://localhost:19427";
+/**
+ * The refusal every hosted SDK entry point raises when the chain resolves no
+ * credential. It names every tier consulted and the one deliberate way to go
+ * local; it never carries a value.
+ */
+export declare const TODOS_CREDENTIAL_MISSING_MESSAGE: string;
+type Env = Record<string, string | undefined>;
+export interface TodosSdkTransport {
+    /** `"http"` for a resolved hosted authority, `"local-serve"` under the explicit local opt-in. */
+    mode: "http" | "local-serve";
+    /**
+     * Origin (plus any gateway path prefix) WITHOUT the `/v1` suffix, so a caller
+     * that composes `/api/...` or `/v1/...` gets exactly one version segment.
+     */
+    baseUrl: string;
+    /** The credential, or null in local mode. */
+    apiKey: string | null;
+    /** WHERE the credential came from — an env key NAME, a Keychain reference, a path. Never a value. */
+    apiKeySource: string | null;
+    /** WHERE the authority came from, or `"local-serve"`. */
+    apiUrlSource: string;
+}
+export interface ResolveTodosSdkTransportOptions {
+    /** Tier 1: an explicit authority. Used verbatim, minus a trailing slash. */
+    baseUrl?: string | undefined;
+    /** Tier 1: an explicit credential. */
+    apiKey?: string | undefined;
+    /** Tier 1 profile selection and the injectable `security` runner tests use. */
+    credentials?: CredentialChainOptions;
+    /** Defaults to `process.env`. */
+    env?: Env;
+    /** Where the one-line local-mode notice goes. Defaults to `process.stderr`. */
+    notice?: (line: string) => void;
+}
+/** Reset the once-per-process local-mode notice. Test seam only. */
+export declare function __resetTodosSdkLocalNotice(): void;
+/**
+ * Resolve the SDK's authority and credential. Explicit arguments win; otherwise
+ * the @hasna/contracts chain decides, and ONLY the deliberate opt-in lands on
+ * the local serve — an environment that resolves nothing throws
+ * {@link TODOS_CREDENTIAL_MISSING_MESSAGE}.
+ */
+export declare function resolveTodosSdkTransport(options?: ResolveTodosSdkTransportOptions): TodosSdkTransport;
+/**
+ * Build the hosted `/v1` client with the fleet resolver behind it — the
+ * generated {@link TodosV1Client} takes an explicit `baseUrl` and has no
+ * environment surface of its own, which left every caller writing a private
+ * copy of the chain.
+ *
+ * Throws when no credential resolves: this client speaks only to the hosted
+ * authority, so even the explicit local opt-in is refused here.
+ */
+export declare function createTodosV1Client(options?: ResolveTodosSdkTransportOptions & Pick<TodosV1ClientOptions, "fetch" | "headers">): TodosV1Client;
+export {};
+//# sourceMappingURL=resolve.d.ts.map

package/dist/sdk/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/sdk/resolve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,OAAO,EAKL,KAAK,sBAAsB,EAE5B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAG7E,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,QAKkB,CAAC;AAEhE,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,iGAAiG;IACjG,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;IAC7B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,qGAAqG;IACrG,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,+BAA+B;IAC9C,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,+EAA+E;IAC/E,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,iCAAiC;IACjC,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,+EAA+E;IAC/E,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAID,oEAAoE;AACpE,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAkBD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,+BAAoC,GAC5C,iBAAiB,CA0FnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,+BAA+B,GAAG,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,SAAS,CAAM,GAC9F,aAAa,CAiDf"}

package/dist/sdk/types.d.ts

@@ -226,11 +226,26 @@ export interface SSEEvent {
     timestamp: string;
 }
 export interface TodosClientOptions {
-    /** Base URL of the todos server. Default: http://localhost:19427 */
+    /**
+     * Base URL of the todos server (tier 1: a deliberate pin, never resolved
+     * around). Default: the authority the `@hasna/contracts` chain resolves —
+     * `HASNA_TODOS_API_URL`, the Keychain `hasna.credentials.todos.api-url`
+     * item, `~/.hasna/todos/config/credentials`, else the fleet gateway
+     * `https://api.hasna.com/todos` once a credential resolves. The unhosted
+     * `http://localhost:19427` is reached ONLY under `HASNA_TODOS_LOCAL=1`.
+     */
     baseUrl?: string;
     /** Request timeout in ms. Default: 10000 */
     timeout?: number;
-    /** API key for auth (sent as x-api-key header). Default: TODOS_API_KEY env */
+    /**
+     * API key for auth (sent as x-api-key header; tier 1, never re-resolved).
+     * Default: the credential the `@hasna/contracts` chain resolves, fresh on
+     * every request — `HASNA_TODOS_API_KEY_OVERRIDE` / `HASNA_PROFILE` /
+     * `HASNA_TODOS_API_KEY_REF`, then the macOS Keychain item
+     * `hasna.credentials.todos.api-key`, then `~/.hasna/todos/config/credentials`,
+     * then `HASNA_TODOS_API_KEY`. With none of them the constructor throws
+     * `TODOS_CREDENTIAL_MISSING`; there is no local fallback.
+     */
     apiKey?: string;
     /** Max retries on 5xx/429. Default: 0 */
     maxRetries?: number;

package/dist/sdk/types.d.ts.map

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

package/dist/sdk/v1.generated.d.ts

@@ -1,3 +1,19 @@
+export interface MachineAuthority {
+    "tenant_id": string;
+    "kid": string;
+}
+export interface Machine {
+    "id": string;
+    "name": string;
+    "hostname": string;
+    "platform": string;
+    "last_seen_at": string;
+    "metadata": Record<string, unknown>;
+    "created_at": string;
+    "ssh_address": string;
+    "is_primary": boolean;
+    "archived_at": string;
+}
 export interface Task {
     "id"?: string;
     "title"?: string;
@@ -17,7 +33,64 @@ export interface Task {
     "created_at"?: string;
     "updated_at"?: string;
 }
+export interface TaskDependency {
+    "task_id": string;
+    "depends_on": string;
+    "external_project_id"?: string | null;
+    "external_task_id"?: string | null;
+}
+export interface DependencyPage {
+    "dependencies": Array<TaskDependency>;
+    "count": number;
+    "total": number;
+    "limit": number;
+    "offset": number;
+    "has_more": boolean;
+    "next_offset": number | null;
+}
+export interface BulkCreateTaskInput {
+    "temp_id"?: string;
+    "depends_on"?: Array<string>;
+    "title": string;
+    "description"?: string | null;
+    "status"?: "pending" | "in_progress" | "completed" | "failed" | "cancelled";
+    "priority"?: "low" | "medium" | "high" | "critical";
+    "project_id"?: string;
+    "parent_id"?: string;
+    "plan_id"?: string;
+    "task_list_id"?: string;
+    "assigned_to"?: string;
+    "agent_id"?: string;
+    "created_by"?: string;
+    "tags"?: Array<string>;
+    "estimated_minutes"?: number;
+}
+export interface BulkCreateReceipt {
+    "schema_version": 1;
+    "atomic": true;
+    "created": Array<{
+        "temp_id": string | null;
+        "id": string;
+        "short_id": string | null;
+        "title": string;
+    }>;
+    "dependencies": Array<TaskDependency>;
+}
+export interface BulkDeleteReceipt {
+    "schema_version": 1;
+    "atomic": true;
+    "force": boolean;
+    "results": Array<{
+        "requested_id": string;
+        "task_id": string | null;
+        "outcome": "deleted" | "skipped" | "missing";
+        "reason": "has_children" | "not_found" | null;
+    }>;
+}
 export interface Project {
+    "status"?: "active" | "completed" | "on_hold" | "archived";
+    "short_id"?: string | null;
+    "metadata"?: Record<string, unknown>;
     "id"?: string;
     "name"?: string;
     "path"?: string;
@@ -412,6 +485,7 @@ export interface ProjectResourcePage {
     "truncated": false;
 }
 export interface TaskList {
+    "status"?: "active" | "completed" | "archived";
     "id"?: string;
     "project_id"?: string | null;
     "slug"?: string;
@@ -500,7 +574,9 @@ export interface Plan {
     "agent_id"?: string | null;
     "name": string;
     "description"?: string | null;
-    "status": "active" | "completed" | "archived";
+    "start_date"?: string | null;
+    "end_date"?: string | null;
+    "status": "active" | "completed" | "archived" | "planning" | "cancelled";
     "created_at": string;
     "updated_at": string;
 }
@@ -613,6 +689,7 @@ export interface UpdateTaskInput {
     "parent_id"?: string | null;
     "plan_id"?: string | null;
     "task_list_id"?: string | null;
+    "archived_at"?: string | null;
     "version"?: number;
 }
 export interface CompleteTaskInput {
@@ -634,6 +711,9 @@ export interface TaskFailureResult {
     "retryTask"?: Task;
 }
 export interface CreateProjectInput {
+    "status"?: "active" | "completed" | "on_hold" | "archived";
+    "short_id"?: string | null;
+    "metadata"?: Record<string, unknown>;
     "name": string;
     "path": string;
     "description"?: string;
@@ -642,6 +722,9 @@ export interface CreateProjectInput {
     "parent_id"?: string;
 }
 export interface UpdateProjectInput {
+    "status"?: "active" | "completed" | "on_hold" | "archived";
+    "short_id"?: string | null;
+    "metadata"?: Record<string, unknown>;
     "name"?: string;
     "path"?: string;
     "description"?: string | null;
@@ -670,12 +753,21 @@ export interface PlanProjectLinkRollbackInput {
     "receipt_id": string;
     "expected_plan_revision": string;
 }
+export interface PlanProjectLinkConflictResponse {
+    "error": string;
+    "code"?: string;
+    "conflict"?: boolean;
+    "operation_committed"?: true;
+    "current_state_matches_receipt"?: false;
+    "receipt"?: PlanProjectLinkReceipt;
+}
 export interface ErrorResponse {
     "error": string;
     "code"?: string;
     "conflict"?: boolean;
 }
 export interface CreateTaskListInput {
+    "status"?: "active" | "completed" | "archived";
     "name": string;
     "slug"?: string;
     "project_id"?: string;
@@ -683,6 +775,7 @@ export interface CreateTaskListInput {
     "metadata"?: Record<string, unknown>;
 }
 export interface UpdateTaskListInput {
+    "status"?: "active" | "completed" | "archived";
     "slug"?: string;
     "name"?: string;
     "description"?: string;
@@ -703,7 +796,9 @@ export interface CreatePlanInput {
     "project_id"?: string;
     "task_list_id"?: string;
     "agent_id"?: string;
-    "status"?: "active" | "completed" | "archived";
+    "start_date"?: string | null;
+    "end_date"?: string | null;
+    "status"?: "active" | "completed" | "archived" | "planning" | "cancelled";
 }
 export interface UpdatePlanInput {
     "name"?: string;
@@ -711,7 +806,9 @@ export interface UpdatePlanInput {
     "description"?: string;
     "task_list_id"?: string;
     "agent_id"?: string;
-    "status"?: "active" | "completed" | "archived";
+    "start_date"?: string | null;
+    "end_date"?: string | null;
+    "status"?: "active" | "completed" | "archived" | "planning" | "cancelled";
 }
 export interface CreateTemplateInput {
     "name": string;
@@ -726,6 +823,7 @@ export interface CreateTemplateInput {
     "tasks"?: Array<CreateTemplateTaskInput>;
 }
 export interface UpdateTemplateInput {
+    "expected_version"?: number;
     "name"?: string;
     "title_pattern"?: string;
     "description"?: string | null;
@@ -1030,6 +1128,33 @@ export declare class TodosV1Client {
     private readonly baseHeaders;
     constructor(options: TodosV1ClientOptions);
     private request;
+    /** List a bounded recent task-history window */
+    listRecentActivity(query?: {
+        "limit"?: number;
+    }, init?: RequestInit): Promise<{
+        "activity": Array<Record<string, unknown>>;
+        "count": number;
+        "limit": number;
+    }>;
+    /** List the shared agent roster with storage-bounded pagination */
+    listAgents(query?: {
+        "limit"?: number;
+        "offset"?: number;
+        "include_archived"?: boolean;
+    }, init?: RequestInit): Promise<{
+        "agents": Array<Record<string, unknown>>;
+        "count": number;
+        "total": number;
+        "limit": number;
+        "offset": number;
+        "has_more": boolean;
+        "next_offset": number | null;
+    }>;
+    /** List dependency edges with storage-bounded pagination */
+    listDependencies(query?: {
+        "limit"?: number;
+        "offset"?: number;
+    }, init?: RequestInit): Promise<DependencyPage>;
     /** Bulk-ingest a snapshot or atomically complete one observed plan */
     importSnapshot(body: {
         "exportedAt"?: string;
@@ -1037,6 +1162,8 @@ export declare class TodosV1Client {
         "tasks"?: Array<Task>;
         "projects"?: Array<Project>;
         "projectMachinePaths"?: Array<Record<string, unknown>>;
+        "machines"?: Array<Machine>;
+        "expected_machine_authority"?: MachineAuthority;
         "plans"?: Array<Record<string, unknown>>;
         "agents"?: Array<Record<string, unknown>>;
         "taskLists"?: Array<Record<string, unknown>>;
@@ -1051,6 +1178,7 @@ export declare class TodosV1Client {
         }>;
     }, init?: RequestInit): Promise<{
         "received"?: number;
+        "machine_authority"?: MachineAuthority;
         "result"?: {
             "inserted"?: number;
             "updated"?: number;
@@ -1066,6 +1194,29 @@ export declare class TodosV1Client {
             "applied": boolean;
         }>;
     }>;
+    /** Read the complete shared machine registry */
+    listMachines(init?: RequestInit): Promise<{
+        "authority": MachineAuthority;
+        "schema_version": 2;
+        "machines": Array<Machine>;
+    }>;
+    /** Apply an atomic machine registry operation */
+    mutateMachineRegistry(body: {
+        "expected_authority": MachineAuthority;
+        "action": "register" | "heartbeat" | "set-primary" | "archive" | "unarchive" | "delete" | "import";
+        "name"?: string;
+        "id"?: string;
+        "options"?: Record<string, unknown>;
+        "machines"?: Array<Machine>;
+    }, init?: RequestInit): Promise<{
+        "authority": MachineAuthority;
+        "schema_version": 2;
+        "machines": Array<Machine>;
+        "machine"?: Machine;
+        "inserted": number;
+        "skipped": number;
+        "deleted"?: boolean;
+    }>;
     /** List plans */
     listPlans(query?: {
         "project_id"?: string;
@@ -1090,6 +1241,39 @@ export declare class TodosV1Client {
     updatePlan(id: string, body: UpdatePlanInput, init?: RequestInit): Promise<{
         "plan"?: Plan;
     }>;
+    /** Read complete plan comment history */
+    listPlanComments(id: string, query?: {
+        "plan_read_contract"?: "1";
+    }, init?: RequestInit): Promise<{
+        "count": number;
+        "comments": Array<{
+            "id": string;
+            "plan_id": string;
+            "content": string;
+            "created_at": string;
+            "agent_id": string | null;
+            "session_id": string | null;
+            "type": "comment" | "progress" | "note";
+            "progress_pct": number | null;
+        }>;
+        "history_selection"?: {
+            "schema_version": 1;
+            "plan_id": string;
+            "complete": true;
+        };
+    }>;
+    /** Delete a plan, detaching linked records only with force and preserving their content/history */
+    deletePlanPreserving(id: string, body: {
+        "force"?: boolean;
+    }, init?: RequestInit): Promise<{
+        "schema_version": 1;
+        "plan_id": string;
+        "deleted": boolean;
+        "detached_task_ids": Array<string>;
+        "detached_task_list_ids": Array<string>;
+        "detached_tasks": number;
+        "detached_task_lists": number;
+    }>;
     /** Plan atomic linkage of an existing plan and every current member task to a project */
     planPlanProjectLink(id: string, query?: {
         "project_id": string;
@@ -1111,6 +1295,50 @@ export declare class TodosV1Client {
     appendPrGroupEvent(id: string, body: AppendPrGroupEventInput, init?: RequestInit): Promise<PrGroupMutationResult>;
     /** Fence the prior attempt and create or adopt a recovery generation */
     recoverPrGroup(id: string, body: RecoverPrGroupInput, init?: RequestInit): Promise<PrGroupMutationResult>;
+    /** Inspect bounded atomic migration authority (explicit todos:migrate scope required) */
+    getAtomicProjectMigrationCapability(init?: RequestInit): Promise<{
+        "schema_version": 1;
+        "authority": {
+            "tenant_id": string;
+            "kid": string;
+            "deployment_id": string;
+        };
+        "supported_families": Array<string>;
+        "supported_tombstones": Array<string>;
+        "max_records": number;
+        "max_bytes": number;
+        "atomic": true;
+    }>;
+    /** Atomically reconcile a bounded project snapshot with durable replay receipts */
+    importAtomicProjectSnapshot(body: {
+        "schema_version": 1;
+        "operation_id": string;
+        "expected_authority": {
+            "tenant_id": string;
+            "kid": string;
+            "deployment_id": string;
+        };
+        "snapshot_hash": string;
+        "snapshot": Record<string, unknown>;
+    }, init?: RequestInit): Promise<{
+        "schema_version": 1;
+        "operation_id": string;
+        "snapshot_hash": string;
+        "authority": {
+            "tenant_id": string;
+            "kid": string;
+            "deployment_id": string;
+        };
+        "status": "complete";
+        "records": Array<{
+            "object_type": string;
+            "object_id": string;
+            "outcome": "inserted" | "updated" | "identical" | "superseded" | "deleted" | "detached";
+            "before_hash": string | null;
+            "after_hash": string;
+            "source_hash": string;
+        }>;
+    }>;
     /** Read the live package-owned Projects to Todos registration capability */
     getProjectRegistrationCapability(init?: RequestInit): Promise<{
         "capability": ProjectRegistrationCapability;
@@ -1196,6 +1424,19 @@ export declare class TodosV1Client {
     updateProject(id: string, body: UpdateProjectInput, init?: RequestInit): Promise<{
         "project"?: Project;
     }>;
+    /** Delete project identity and atomically detach linked records without deleting their content */
+    deleteProjectPreserving(id: string, body: {
+        "force"?: boolean;
+        "require_completed_tasks"?: boolean;
+    }, init?: RequestInit): Promise<{
+        "schema_version": 1;
+        "project_id": string;
+        "deleted": boolean;
+        "preserved_tasks": number;
+        "preserved_plans": number;
+        "detached_task_lists": number;
+        "detached_child_projects": number;
+    }>;
     /** Atomically rename a project and its canonical task list */
     renameProject(id: string, body: RenameProjectInput, init?: RequestInit): Promise<{
         "project"?: Project;
@@ -1241,6 +1482,18 @@ export declare class TodosV1Client {
     updateTaskList(id: string, body: UpdateTaskListInput, init?: RequestInit): Promise<{
         "task_list"?: TaskList;
     }>;
+    /** Delete a task list, optionally detaching linked tasks and plans while retaining their content and history */
+    deleteTaskListPreserving(id: string, body: {
+        "force"?: boolean;
+    }, init?: RequestInit): Promise<{
+        "schema_version": 1;
+        "task_list_id": string;
+        "deleted": boolean;
+        "detached_task_ids": Array<string>;
+        "detached_plan_ids": Array<string>;
+        "detached_tasks": number;
+        "detached_plans": number;
+    }>;
     /** Apply one exact task-manifest graph through the Todos authority */
     applyTaskManifest(body: TaskManifest, init?: RequestInit): Promise<TaskManifestApplyResponse>;
     /** Recover one exact task-manifest apply receipt from its managed plan id */
@@ -1278,6 +1531,9 @@ export declare class TodosV1Client {
         "project_id"?: string;
         "parent_id"?: string | null;
         "include_subtasks"?: boolean;
+        "include_archived"?: boolean;
+        "archived_only"?: boolean;
+        "plan_read_contract"?: "1";
         "plan_id"?: string;
         "task_list_id"?: string;
         "assigned_to"?: string;
@@ -1290,11 +1546,32 @@ export declare class TodosV1Client {
         "tasks": Array<Task>;
         "count": number;
         "total": number;
+        "selection"?: {
+            "schema_version": 1;
+            "plan_id": string;
+            "include_subtasks": true;
+            "include_archived": boolean;
+        };
     }>;
     /** Create a task */
     createTask(body: CreateTaskInput, init?: RequestInit): Promise<{
         "task"?: Task;
     }>;
+    /** Atomically create a bounded task batch and its dependency edges */
+    bulkCreateTasks(body: {
+        "schema_version": 1;
+        "tasks": Array<BulkCreateTaskInput>;
+    }, init?: RequestInit): Promise<{
+        "receipt": BulkCreateReceipt;
+    }>;
+    /** Atomically delete a bounded task set using authoritative child checks */
+    bulkDeleteTasks(body: {
+        "schema_version": 1;
+        "task_ids": Array<string>;
+        "force"?: boolean;
+    }, init?: RequestInit): Promise<{
+        "receipt": BulkDeleteReceipt;
+    }>;
     /** Get a task by id */
     getTask(id: string, init?: RequestInit): Promise<{
         "task"?: Task;
@@ -1330,6 +1607,23 @@ export declare class TodosV1Client {
     failTask(id: string, body?: FailTaskInput, init?: RequestInit): Promise<{
         "result": TaskFailureResult;
     }>;
+    /** List a storage-bounded page of one task's audit history */
+    listTaskHistory(id: string, query?: {
+        "limit"?: number;
+        "offset"?: number;
+        "since"?: string;
+        "until"?: string;
+        "order"?: "asc" | "desc";
+    }, init?: RequestInit): Promise<{
+        "history": Array<Record<string, unknown>>;
+        "count": number;
+        "total": number;
+        "limit": number;
+        "offset": number;
+        "order": "asc" | "desc";
+        "has_more": boolean;
+        "next_offset": number | null;
+    }>;
     /** List git branch and pull-request refs linked to a task */
     listTaskGitRefs(id: string, init?: RequestInit): Promise<{
         "refs": Array<TaskGitRef>;
@@ -1364,6 +1658,19 @@ export declare class TodosV1Client {
     createTemplate(body: CreateTemplateInput, init?: RequestInit): Promise<{
         "template"?: Template;
     }>;
+    /** Atomically initialize server-owned bundled definitions, retaining existing same-name templates */
+    initializeTemplates(body: Record<string, unknown>, init?: RequestInit): Promise<{
+        "schema_version": 1;
+        "created": number;
+        "skipped": number;
+        "names": Array<string>;
+        "records": Array<{
+            "definition_index": number;
+            "ids": Array<string>;
+            "name": string;
+            "status": "created" | "skipped";
+        }>;
+    }>;
     /** Get one reusable task template with its checklist steps */
     getTemplate(id: string, init?: RequestInit): Promise<{
         "template"?: Template;
@@ -1376,6 +1683,30 @@ export declare class TodosV1Client {
     /** Update reusable template metadata and defaults */
     updateTemplate(id: string, body: UpdateTemplateInput, init?: RequestInit): Promise<{
         "template"?: Template;
+        "history_write"?: {
+            "schema_version": 1;
+            "template_id": string;
+            "previous_version": number;
+            "version": number;
+            "recorded": true;
+        };
+    }>;
+    /** Read recorded template versions with explicit missing-version evidence */
+    getTemplateHistory(id: string, init?: RequestInit): Promise<{
+        "current_version": number;
+        "versions": Array<{
+            "id": string;
+            "template_id": string;
+            "version": number;
+            "snapshot": string;
+            "created_at": string;
+        }>;
+        "selection": {
+            "schema_version": 1;
+            "template_id": string;
+            "complete": boolean;
+            "missing_versions": Array<number>;
+        };
     }>;
 }
 //# sourceMappingURL=v1.generated.d.ts.map