@hasna/todos 0.15.52 → 0.17.0

package/dist/sdk/index.js

@@ -52,1292 +52,1456 @@ class TodosTimeoutError extends Error {
   }
 }
 
-// src/lib/config.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2 } from "fs";
-import { dirname, join as join3 } from "path";
+// src/sdk/resolve.ts
+import {
+  ClientTransportConfigurationError,
+  resolveClientTransport,
+  resolveCredential
+} from "@hasna/contracts/client";
 
-// src/lib/sync-utils.ts
-import { existsSync as existsSync2, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "fs";
-import { homedir as homedir3 } from "os";
-
-// src/lib/paths.ts
-import { existsSync } from "fs";
-import { homedir as homedir2 } from "os";
-import { join as join2, resolve } from "path";
-
-// node_modules/.bun/@hasna+paths@0.1.0/node_modules/@hasna/paths/dist/index.js
-import { homedir } from "os";
-import { join } from "path";
-var KIND_ENV = {
-  config: "HASNA_CONFIG_HOME",
-  data: "HASNA_DATA_HOME",
-  state: "HASNA_STATE_HOME",
-  cache: "HASNA_CACHE_HOME"
-};
-var APP_SLUG_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-function assertApp(app) {
-  if (typeof app !== "string" || app.length === 0) {
-    throw new TypeError("paths: app must be a non-empty string");
-  }
-  if (!APP_SLUG_RE.test(app)) {
-    throw new TypeError(`paths: invalid app slug "${app}" \u2014 expected lowercase kebab-case ([a-z0-9]+(-[a-z0-9]+)*)`);
-  }
-}
-function envOf(options) {
-  return options.env ?? process.env;
-}
-function envValue(options, kind) {
-  const value = envOf(options)[KIND_ENV[kind]];
-  return typeof value === "string" && value.length > 0 ? value : undefined;
-}
-function isMacOS(platform) {
-  return platform === "darwin";
-}
-function baseDir(kind, options) {
-  const override = envValue(options, kind);
-  if (override)
-    return override;
-  const home = options.home ?? homedir();
-  const platform = options.platform ?? process.platform;
-  if (isMacOS(platform)) {
-    switch (kind) {
-      case "config":
-      case "data":
-        return join(home, "Library", "Application Support", "Hasna");
-      case "cache":
-        return join(home, "Library", "Caches", "Hasna");
-      case "state":
-        return join(home, "Library", "Logs", "Hasna");
-    }
-  }
-  switch (kind) {
-    case "config":
-      return join(home, ".config", "hasna");
-    case "data":
-      return join(home, ".local", "share", "hasna");
-    case "state":
-      return join(home, ".local", "state", "hasna");
-    case "cache":
-      return join(home, ".cache", "hasna");
+// src/project-registration/types.ts
+class TodosProjectRegistrationError extends Error {
+  code;
+  details;
+  constructor(code, message, details = {}) {
+    super(message);
+    this.code = code;
+    this.details = details;
+    this.name = "TodosProjectRegistrationError";
   }
 }
-function resolvePath(kind, options) {
-  assertApp(options.app);
-  const appSegment = options.internal === true ? join("internal", options.app) : options.app;
-  return join(baseDir(kind, options), appSegment);
-}
-function dataDir(options) {
-  return resolvePath("data", options);
-}
 
-// src/lib/paths.ts
-function effectiveHome(env = process.env) {
-  return env.HOME || env.USERPROFILE || homedir2();
-}
-function legacyHomeDir(env = process.env) {
-  return join2(effectiveHome(env), ".hasna", "todos");
-}
-function resolverHome(env = process.env) {
-  return dataDir({ app: "todos", home: effectiveHome(env), env });
-}
-function adoptResolverHome(resolved, env = process.env) {
-  const dataOverride = env.HASNA_DATA_HOME;
-  if (typeof dataOverride === "string" && dataOverride.trim().length > 0)
-    return true;
-  return existsSync(join2(resolved, "todos.db")) || existsSync(join2(resolved, "config.json"));
+// src/project-registration/adoption-validation.ts
+var VALIDATION_KEYS = [
+  "valid",
+  "resource_kind",
+  "target_id",
+  "source_receipt_id",
+  "accepted_receipt_id",
+  "source_outcome",
+  "created_at",
+  "current_revision",
+  "accepted_result_digest"
+];
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
 }
-function getTodosDir(env = process.env) {
-  const resolved = resolverHome(env);
-  return resolve(adoptResolverHome(resolved, env) ? resolved : legacyHomeDir(env));
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.length > 0;
 }
-
-// src/lib/sync-utils.ts
-function getHomeDir() {
-  return process.env["HOME"] || process.env["USERPROFILE"] || homedir3();
+function hasExactKeys(value, expected) {
+  const actual = Object.keys(value).sort();
+  const wanted = [...expected].sort();
+  return actual.length === wanted.length && actual.every((key, index) => key === wanted[index]);
 }
-var HOME = getHomeDir();
-function getTodosGlobalDir() {
-  return getTodosDir();
+function adoptionRejected(message) {
+  throw new TodosProjectRegistrationError("TODOS_PROJECT_REGISTRATION_ADOPTION_REJECTED", `TODOS_PROJECT_REGISTRATION_ADOPTION_REJECTED: ${message}`);
 }
-function readJsonFile(path) {
-  try {
-    return JSON.parse(readFileSync(path, "utf-8"));
-  } catch {
-    return null;
+function assertTodosPriorRegistrationAdoptionValidationEnvelope(value, input) {
+  if (!isRecord(input) || !hasExactKeys(input, [
+    "source_request",
+    "source_receipt",
+    "current_record"
+  ])) {
+    adoptionRejected("prior-adoption validation input is incomplete");
   }
+  const request = input["source_request"];
+  const receipt = input["source_receipt"];
+  const current = input["current_record"];
+  if (!isRecord(request) || !isRecord(receipt) || !isRecord(current)) {
+    adoptionRejected("prior-adoption validation input records are incomplete");
+  }
+  const resourceKind = request["resource_kind"];
+  const sourceOutcome = receipt["outcome"];
+  const acceptedReceiptId = sourceOutcome === "accepted" ? receipt["receipt_id"] : sourceOutcome === "duplicate_of_accepted" ? receipt["duplicate_of_receipt_id"] : null;
+  if (resourceKind !== "project" && resourceKind !== "task_list" || request["direction"] !== "forward" || sourceOutcome !== "accepted" && sourceOutcome !== "duplicate_of_accepted" || !isNonEmptyString(acceptedReceiptId) || !isNonEmptyString(receipt["receipt_id"]) || !isNonEmptyString(receipt["target_id"]) || !isNonEmptyString(receipt["result_revision"]) || !isNonEmptyString(receipt["result_digest"]) || !isNonEmptyString(current["id"]) || !isNonEmptyString(current["created_at"]) || !isNonEmptyString(current["updated_at"]) || receipt["authority"] !== "todos" || receipt["route"] !== request["authority_route"] || receipt["package_version"] !== request["package_version"] || receipt["authority_id"] !== request["authority_id"] || receipt["tenant_id"] !== request["tenant_id"] || receipt["corpus_id"] !== request["corpus_id"] || receipt["operation_id"] !== request["operation_id"] || receipt["step_id"] !== request["step_id"] || receipt["resource_kind"] !== resourceKind || receipt["direction"] !== "forward" || receipt["idempotency_key"] !== request["idempotency_key"] || receipt["request_digest"] !== request["request_digest"] || receipt["precondition_digest"] !== request["precondition_digest"] || receipt["accepted_receipt_id"] !== null || receipt["target_id"] !== current["id"] || receipt["result_revision"] !== current["created_at"]) {
+    adoptionRejected("prior-adoption validation input does not carry one complete accepted receipt and current target incarnation");
+  }
+  if (sourceOutcome === "accepted" && receipt["duplicate_of_receipt_id"] !== null || sourceOutcome === "duplicate_of_accepted" && receipt["duplicate_of_receipt_id"] !== acceptedReceiptId) {
+    adoptionRejected("prior-adoption validation source receipt lineage is incomplete");
+  }
+  if (!isRecord(value) || !hasExactKeys(value, ["validation"]) || !isRecord(value["validation"]) || !hasExactKeys(value["validation"], VALIDATION_KEYS)) {
+    adoptionRejected("prior-adoption validation response envelope is incomplete");
+  }
+  const validation = value["validation"];
+  if (validation["valid"] !== true || validation["resource_kind"] !== resourceKind || validation["target_id"] !== current["id"] || validation["source_receipt_id"] !== receipt["receipt_id"] || validation["accepted_receipt_id"] !== acceptedReceiptId || validation["source_outcome"] !== sourceOutcome || validation["created_at"] !== current["created_at"] || validation["current_revision"] !== current["updated_at"] || validation["accepted_result_digest"] !== receipt["result_digest"]) {
+    adoptionRejected("prior-adoption validation response does not prove the exact accepted receipt and current target");
+  }
+  return validation;
 }
 
-// src/lib/config.ts
-function getConfigPath() {
-  return join3(getTodosGlobalDir(), "config.json");
-}
-var cached = null;
-function loadConfig() {
-  if (cached)
-    return cached;
-  if (!existsSync3(getConfigPath())) {
-    cached = {};
-    return cached;
-  }
-  const config = readJsonFile(getConfigPath()) || {};
-  if (typeof config.sync_agents === "string") {
-    config.sync_agents = config.sync_agents.split(",").map((a) => a.trim()).filter(Boolean);
-  }
-  cached = config;
-  return cached;
-}
-function normalizeApiUrl(value) {
-  const trimmed = value?.trim();
-  if (!trimmed)
-    return null;
-  return trimmed.replace(/\/+$/, "");
-}
-function getLocalApiConfig(env = process.env) {
-  const config = loadConfig();
-  const envApiUrl = normalizeApiUrl(env["TODOS_URL"]);
-  const configApiUrl = normalizeApiUrl(config.apiUrl);
-  const apiUrl = envApiUrl ?? configApiUrl;
-  const apiKey = env["TODOS_API_KEY"] || config.apiKey || null;
-  return {
-    apiUrl,
-    apiKey,
-    source: {
-      apiUrl: envApiUrl ? "TODOS_URL" : configApiUrl ? "config" : "none",
-      apiKey: env["TODOS_API_KEY"] ? "TODOS_API_KEY" : config.apiKey ? "config" : "none"
-    }
-  };
-}
-
-// src/sdk/client.ts
-function buildQuery(params) {
-  const search = new URLSearchParams;
-  for (const [k, v] of Object.entries(params)) {
-    if (v !== undefined)
-      search.set(k, Array.isArray(v) ? v.join(",") : String(v));
+// src/sdk/v1.generated.ts
+class ApiError extends Error {
+  status;
+  body;
+  constructor(status, message, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "ApiError";
   }
-  const s = search.toString();
-  return s ? `?${s}` : "";
 }
 
-class TasksResource {
-  client;
-  constructor(client) {
-    this.client = client;
+class TodosV1Client {
+  baseUrl;
+  apiKey;
+  fetchImpl;
+  baseHeaders;
+  constructor(options) {
+    if (!options.baseUrl)
+      throw new Error("TodosV1Client requires a baseUrl.");
+    this.baseUrl = options.baseUrl.replace(/\/$/, "");
+    this.apiKey = options.apiKey;
+    this.fetchImpl = options.fetch ?? globalThis.fetch;
+    this.baseHeaders = options.headers ?? {};
   }
-  async list(options) {
-    return this.client._get("/api/tasks", buildQuery(options || {}));
+  async request(method, path, opts) {
+    const url = new URL(this.baseUrl + path);
+    if (opts.query) {
+      for (const [key, value] of Object.entries(opts.query)) {
+        if (value === undefined || value === null)
+          continue;
+        if (Array.isArray(value)) {
+          for (const item of value) {
+            if (item !== undefined && item !== null)
+              url.searchParams.append(key, String(item));
+          }
+        } else {
+          url.searchParams.set(key, String(value));
+        }
+      }
+    }
+    const headers = { Accept: "application/json", ...this.baseHeaders, ...opts.init?.headers };
+    if (this.apiKey)
+      headers["x-api-key"] = this.apiKey;
+    let payload;
+    if (opts.body !== undefined) {
+      headers["Content-Type"] = "application/json";
+      payload = JSON.stringify(opts.body);
+    }
+    const response = await this.fetchImpl(url.toString(), { ...opts.init, method, headers, body: payload });
+    const text = await response.text();
+    const data = text ? (() => {
+      try {
+        return JSON.parse(text);
+      } catch {
+        return text;
+      }
+    })() : undefined;
+    if (!response.ok) {
+      throw new ApiError(response.status, `${method} ${path} failed: ${response.status}`, data);
+    }
+    return data;
   }
-  async get(id, options) {
-    return this.client._get(`/api/tasks/${id}`, buildQuery(options || {}));
+  async listRecentActivity(query, init) {
+    return this.request("GET", `/v1/activity`, {
+      body: undefined,
+      query,
+      init
+    });
   }
-  async getWithRelations(id) {
-    return this.client._get(`/api/tasks/${id}`, buildQuery({ format: "full" }));
+  async listAgents(query, init) {
+    return this.request("GET", `/v1/agents`, {
+      body: undefined,
+      query,
+      init
+    });
   }
-  async create(data) {
-    return this.client._post("/api/tasks", data);
+  async listDependencies(query, init) {
+    return this.request("GET", `/v1/dependencies`, {
+      body: undefined,
+      query,
+      init
+    });
   }
-  async update(id, data) {
-    return this.client._patch(`/api/tasks/${id}`, data);
+  async importSnapshot(body, init) {
+    if (body.machines !== undefined && !Array.isArray(body.machines))
+      throw new Error("Invalid machine snapshot array; no snapshot was posted");
+    if (body.machines?.length) {
+      let capability;
+      try {
+        capability = await this.listMachines(init);
+      } catch {
+        throw new Error("REMOTE_API_INCOMPATIBLE: machine import requires an upgraded Todos server; no snapshot was posted");
+      }
+      if (capability?.schema_version !== 2 || !Array.isArray(capability.machines) || !capability.authority || typeof capability.authority.tenant_id !== "string" || !capability.authority.tenant_id || typeof capability.authority.kid !== "string" || !capability.authority.kid)
+        throw new Error("REMOTE_API_INCOMPATIBLE: machine registry capability is missing; no snapshot was posted");
+      if (body.expected_machine_authority && (body.expected_machine_authority.kid !== capability.authority.kid || body.expected_machine_authority.tenant_id !== capability.authority.tenant_id))
+        throw new Error("Machine migration authority changed before POST; no snapshot was posted");
+      body = { ...body, expected_machine_authority: { ...capability.authority } };
+    }
+    const result = await this.request("POST", `/v1/import`, {
+      body,
+      query: undefined,
+      init
+    });
+    if (body.machines?.length && (result.machine_authority?.kid !== body.expected_machine_authority?.kid || result.machine_authority?.tenant_id !== body.expected_machine_authority?.tenant_id))
+      throw new Error("Machine receipt authority changed; preserve the source and inspect before retrying");
+    return result;
   }
-  async delete(id) {
-    return this.client._delete(`/api/tasks/${id}`);
+  async listMachines(init) {
+    return this.request("GET", `/v1/machines`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async start(id, agentId) {
-    return this.client._post(`/api/tasks/${id}/start`, { agent_id: agentId });
+  async mutateMachineRegistry(body, init) {
+    return this.request("POST", `/v1/machines`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async complete(id, agentId) {
-    return this.client._post(`/api/tasks/${id}/complete`, { agent_id: agentId });
+  async listPlans(query, init) {
+    return this.request("GET", `/v1/plans`, {
+      body: undefined,
+      query,
+      init
+    });
   }
-  async fail(id, options) {
-    return this.client._post(`/api/tasks/${id}/fail`, options || {});
+  async createPlan(body, init) {
+    return this.request("POST", `/v1/plans`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async logProgress(taskId, message, pctComplete, agentId) {
-    return this.client._post(`/api/tasks/${taskId}/progress`, {
-      message,
-      pct_complete: pctComplete,
-      agent_id: agentId
+  async getPlan(id, init) {
+    return this.request("GET", `/v1/plans/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
     });
   }
-  async getProgress(id, options) {
-    return this.client._get(`/api/tasks/${id}/progress`, buildQuery(options || {}));
+  async deletePlan(id, init) {
+    return this.request("DELETE", `/v1/plans/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async getHistory(id, options) {
-    return this.client._get(`/api/tasks/${id}/history`, buildQuery(options || {}));
+  async updatePlan(id, body, init) {
+    return this.request("PATCH", `/v1/plans/${encodeURIComponent(String(id))}`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async getAttachments(id) {
-    return this.client._get(`/api/tasks/${id}/attachments`);
+  async listPlanComments(id, query, init) {
+    return this.request("GET", `/v1/plans/${encodeURIComponent(String(id))}/comments`, {
+      body: undefined,
+      query,
+      init
+    });
   }
-  async status(options) {
-    return this.client._get("/api/tasks/status", buildQuery(options || {}));
+  async deletePlanPreserving(id, body, init) {
+    return this.request("POST", `/v1/plans/${encodeURIComponent(String(id))}/delete-preserving`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async next(options) {
-    return this.client._get("/api/tasks/next", buildQuery(options || {}));
+  async planPlanProjectLink(id, query, init) {
+    return this.request("GET", `/v1/plans/${encodeURIComponent(String(id))}/project-link`, {
+      body: undefined,
+      query,
+      init
+    });
   }
-  async active(projectId) {
-    return this.client._get("/api/tasks/active", projectId ? `?project_id=${projectId}` : "");
-  }
-  async stale(options) {
-    return this.client._get("/api/tasks/stale", buildQuery(options || {}));
-  }
-  async changedSince(since, projectId, options) {
-    return this.client._get("/api/tasks/changed", buildQuery({ since, project_id: projectId, fields: options?.fields }));
+  async applyPlanProjectLink(id, body, init) {
+    return this.request("POST", `/v1/plans/${encodeURIComponent(String(id))}/project-link`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async context(options) {
-    const q = buildQuery({
-      agent_id: options?.agentId,
-      project_id: options?.projectId,
-      format: options?.format,
-      fields: options?.fields
+  async rollbackPlanProjectLink(id, body, init) {
+    return this.request("POST", `/v1/plans/${encodeURIComponent(String(id))}/project-link/rollback`, {
+      body,
+      query: undefined,
+      init
     });
-    const url = `${this.client.baseUrl}/api/tasks/context${q}`;
-    const res = await this.client._fetchRaw(url);
-    if (!res.ok)
-      return options?.format === "json" ? {} : "";
-    if (options?.format === "json")
-      return res.json();
-    return res.text();
   }
-  async export(options) {
-    const q = buildQuery(options || {});
-    const url = `${this.client.baseUrl}/api/tasks/export${q}`;
-    const res = await this.client._fetchRaw(url);
-    if (!res.ok)
-      throw new TodosAPIError("Export failed", res.status, res.statusText, null);
-    if (options?.format === "csv")
-      return res.text();
-    return res.json();
+  async admitPrGroup(body, init) {
+    return this.request("POST", `/v1/pr-groups/admit`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async bulk(ids, action) {
-    return this.client._post("/api/tasks/bulk", { ids, action });
+  async getPrGroupState(id, init) {
+    return this.request("GET", `/v1/pr-groups/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async claim(agentId, projectId) {
-    return this.client._post("/api/tasks/claim", { agent_id: agentId, project_id: projectId });
+  async getPrGroupEvents(id, query, init) {
+    return this.request("GET", `/v1/pr-groups/${encodeURIComponent(String(id))}/events`, {
+      body: undefined,
+      query,
+      init
+    });
   }
-  async* subscribe(options = {}) {
-    const q = buildQuery({
-      agent_id: options.agentId,
-      project_id: options.projectId,
-      events: options.events?.join(",")
+  async appendPrGroupEvent(id, body, init) {
+    return this.request("POST", `/v1/pr-groups/${encodeURIComponent(String(id))}/events`, {
+      body,
+      query: undefined,
+      init
     });
-    const url = `${this.client.baseUrl}/api/tasks/stream${q}`;
-    const resp = await this.client._fetchRaw(url);
-    if (!resp.ok || !resp.body)
-      throw new Error(`SSE connection failed: ${resp.status}`);
-    const reader = resp.body.getReader();
-    const decoder = new TextDecoder;
-    let buffer = "";
-    try {
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done)
-          break;
-        buffer += decoder.decode(value, { stream: true });
-        const lines = buffer.split(`
-`);
-        buffer = lines.pop() || "";
-        for (const line of lines) {
-          if (line.startsWith("data: ")) {
-            try {
-              const data = JSON.parse(line.slice(6));
-              if (data.type !== "connected")
-                yield data;
-            } catch {}
-          }
-        }
-      }
-    } finally {
-      reader.releaseLock();
-    }
   }
-}
-
-class AgentsResource {
-  client;
-  constructor(client) {
-    this.client = client;
+  async recoverPrGroup(id, body, init) {
+    return this.request("POST", `/v1/pr-groups/${encodeURIComponent(String(id))}/recover`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async list(options) {
-    return this.client._get("/api/agents", buildQuery(options || {}));
+  async getAtomicProjectMigrationCapability(init) {
+    return this.request("GET", `/v1/project-migrations`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async register(data) {
-    return this.client._post("/api/agents", data);
+  async importAtomicProjectSnapshot(body, init) {
+    return this.request("POST", `/v1/project-migrations`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async fullRegister(data) {
-    return this.client._post("/api/agents", data);
+  async getProjectRegistrationCapability(init) {
+    return this.request("GET", `/v1/project-registration/capability`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async update(id, data) {
-    return this.client._patch(`/api/agents/${id}`, data);
+  async compensateProjectRegistrationResource(body, init) {
+    return this.request("POST", `/v1/project-registration/compensate`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async delete(id) {
-    return this.client._delete(`/api/agents/${id}`);
+  async createProjectRegistrationResource(body, init) {
+    return this.request("POST", `/v1/project-registration/create`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async bulkDelete(ids) {
-    return this.client._post("/api/agents/bulk", { ids, action: "delete" });
+  async readExactProjectRegistrationResource(body, init) {
+    return this.request("POST", `/v1/project-registration/read-exact`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async me(name) {
-    return this.client._get("/api/agents/me", `?name=${encodeURIComponent(name)}`);
+  async lookupProjectRegistrationReceipt(body, init) {
+    return this.request("POST", `/v1/project-registration/receipts/lookup`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async queue(agentId) {
-    return this.client._get(`/api/agents/${encodeURIComponent(agentId)}/queue`);
+  async listProjectRegistrationResources(query, init) {
+    return this.request("GET", `/v1/project-registration/resources`, {
+      body: undefined,
+      query,
+      init
+    });
   }
-  async team(agentId) {
-    return this.client._get(`/api/agents/${encodeURIComponent(agentId)}/team`);
+  async validatePriorRegistrationAdoption(body, init) {
+    const response = await this.request("POST", `/v1/project-registration/validate-prior-adoption`, {
+      body,
+      query: undefined,
+      init
+    });
+    return {
+      validation: assertTodosPriorRegistrationAdoptionValidationEnvelope(response, body)
+    };
   }
-  async orgChart() {
-    return this.client._get("/api/org");
+  async verifyInverseProjectRegistrationResource(body, init) {
+    return this.request("POST", `/v1/project-registration/verify-inverse`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-}
-
-class ProjectsResource {
-  client;
-  constructor(client) {
-    this.client = client;
+  async listProjects(init) {
+    return this.request("GET", `/v1/projects`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async list(options) {
-    return this.client._get("/api/projects", buildQuery(options || {}));
+  async createProject(body, init) {
+    return this.request("POST", `/v1/projects`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async create(data) {
-    return this.client._post("/api/projects", data);
+  async getProject(id, init) {
+    return this.request("GET", `/v1/projects/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async delete(id) {
-    return this.client._delete(`/api/projects/${id}`);
+  async deleteProject(id, init) {
+    return this.request("DELETE", `/v1/projects/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async bulkDelete(ids) {
-    return this.client._post("/api/projects/bulk", { ids, action: "delete" });
+  async updateProject(id, body, init) {
+    return this.request("PATCH", `/v1/projects/${encodeURIComponent(String(id))}`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-}
-
-class PlansResource {
-  client;
-  constructor(client) {
-    this.client = client;
+  async deleteProjectPreserving(id, body, init) {
+    return this.request("POST", `/v1/projects/${encodeURIComponent(String(id))}/delete-preserving`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async list(projectId) {
-    return this.client._get("/api/plans", projectId ? `?project_id=${projectId}` : "");
+  async renameProject(id, body, init) {
+    return this.request("POST", `/v1/projects/${encodeURIComponent(String(id))}/rename`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async create(data) {
-    return this.client._post("/api/plans", data);
+  async planProjectTaskListEnsure(id, init) {
+    return this.request("GET", `/v1/projects/${encodeURIComponent(String(id))}/task-list/ensure`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async get(id) {
-    return this.client._get(`/api/plans/${id}`);
+  async ensureProjectTaskList(id, body, init) {
+    return this.request("POST", `/v1/projects/${encodeURIComponent(String(id))}/task-list/ensure`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async update(id, data) {
-    return this.client._patch(`/api/plans/${id}`, data);
+  async rollbackProjectTaskListEnsure(id, body, init) {
+    return this.request("POST", `/v1/projects/${encodeURIComponent(String(id))}/task-list/rollback`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async delete(id) {
-    return this.client._delete(`/api/plans/${id}`);
+  async findTaskGitRefs(ref, init) {
+    return this.request("GET", `/v1/refs/${encodeURIComponent(String(ref))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async bulkDelete(ids) {
-    return this.client._post("/api/plans/bulk", { ids, action: "delete" });
+  async getStats(init) {
+    return this.request("GET", `/v1/stats`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-}
-
-class OrgsResource {
-  client;
-  constructor(client) {
-    this.client = client;
+  async listTaskLists(query, init) {
+    return this.request("GET", `/v1/task-lists`, {
+      body: undefined,
+      query,
+      init
+    });
   }
-  async list() {
-    return this.client._get("/api/orgs");
+  async createTaskList(body, init) {
+    return this.request("POST", `/v1/task-lists`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async create(data) {
-    return this.client._post("/api/orgs", data);
+  async getTaskList(id, init) {
+    return this.request("GET", `/v1/task-lists/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async update(id, data) {
-    return this.client._patch(`/api/orgs/${id}`, data);
+  async deleteTaskList(id, init) {
+    return this.request("DELETE", `/v1/task-lists/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async delete(id) {
-    return this.client._delete(`/api/orgs/${id}`);
+  async updateTaskList(id, body, init) {
+    return this.request("PATCH", `/v1/task-lists/${encodeURIComponent(String(id))}`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-}
-
-class WebhooksResource {
-  client;
-  constructor(client) {
-    this.client = client;
+  async deleteTaskListPreserving(id, body, init) {
+    return this.request("POST", `/v1/task-lists/${encodeURIComponent(String(id))}/delete-preserving`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async list() {
-    return this.client._get("/api/webhooks");
+  async applyTaskManifest(body, init) {
+    return this.request("POST", `/v1/task-manifest/apply`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async create(data) {
-    return this.client._post("/api/webhooks", data);
+  async lookupTaskManifestBinding(body, init) {
+    return this.request("POST", `/v1/task-manifest/bindings/lookup`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async delete(id) {
-    return this.client._delete(`/api/webhooks/${id}`);
+  async getTaskManifestCapability(init) {
+    return this.request("GET", `/v1/task-manifest/capability`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-}
-
-class TemplatesResource {
-  client;
-  constructor(client) {
-    this.client = client;
+  async compensateTaskManifest(body, init) {
+    return this.request("POST", `/v1/task-manifest/compensate`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async list() {
-    return this.client._get("/api/templates");
+  async readExactTaskManifest(body, init) {
+    return this.request("POST", `/v1/task-manifest/read-exact`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async create(data) {
-    return this.client._post("/api/templates", data);
+  async applyTaskSubtreeTransfer(body, init) {
+    return this.request("POST", `/v1/task-subtree-transfer/apply`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async delete(id) {
-    return this.client._delete(`/api/templates/${id}`);
+  async getTaskSubtreeTransferCapability(init) {
+    return this.request("GET", `/v1/task-subtree-transfer/capability`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-}
-
-class PrGroupsResource {
-  client;
-  constructor(client) {
-    this.client = client;
+  async inspectTaskSubtreeTransfer(body, init) {
+    return this.request("POST", `/v1/task-subtree-transfer/inspect`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async admit(input) {
-    return this.client._post("/api/pr-groups/admit", input);
+  async readExactTaskSubtreeTransfer(body, init) {
+    return this.request("POST", `/v1/task-subtree-transfer/read-exact`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async get(groupId) {
-    const result = await this.client._get(`/api/pr-groups/${encodeURIComponent(groupId)}`);
-    return result.view;
+  async rollbackTaskSubtreeTransfer(body, init) {
+    return this.request("POST", `/v1/task-subtree-transfer/rollback`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async events(groupId, options = {}) {
-    const result = await this.client._get(`/api/pr-groups/${encodeURIComponent(groupId)}/events`, buildQuery({
-      limit: options.limit,
-      after_sequence: options.after_sequence
-    }));
-    return result.history;
+  async listTasks(query, init) {
+    return this.request("GET", `/v1/tasks`, {
+      body: undefined,
+      query,
+      init
+    });
   }
-  async append(input) {
-    return this.client._post(`/api/pr-groups/${encodeURIComponent(input.group_id)}/events`, input);
+  async createTask(body, init) {
+    return this.request("POST", `/v1/tasks`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async recover(input) {
-    return this.client._post(`/api/pr-groups/${encodeURIComponent(input.group_id)}/recover`, input);
+  async bulkCreateTasks(body, init) {
+    return this.request("POST", `/v1/tasks/bulk-create`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-}
-
-class TodosClient {
-  baseUrl;
-  timeout;
-  apiKey;
-  maxRetries;
-  retryDelay;
-  tasks;
-  agents;
-  projects;
-  plans;
-  orgs;
-  webhooks;
-  templates;
-  prGroups;
-  constructor(options = {}) {
-    const localConfig = getLocalApiConfig();
-    this.baseUrl = normalizeApiUrl(options.baseUrl) || localConfig.apiUrl || "http://localhost:19427";
-    this.timeout = options.timeout ?? 1e4;
-    this.apiKey = options.apiKey || localConfig.apiKey;
-    this.maxRetries = options.maxRetries ?? 0;
-    this.retryDelay = options.retryDelay ?? 1000;
-    this.tasks = new TasksResource(this);
-    this.agents = new AgentsResource(this);
-    this.projects = new ProjectsResource(this);
-    this.plans = new PlansResource(this);
-    this.orgs = new OrgsResource(this);
-    this.webhooks = new WebhooksResource(this);
-    this.templates = new TemplatesResource(this);
-    this.prGroups = new PrGroupsResource(this);
+  async bulkDeleteTasks(body, init) {
+    return this.request("POST", `/v1/tasks/bulk-delete`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  static fromEnv(apiKey) {
-    return new TodosClient({ apiKey });
+  async getTask(id, init) {
+    return this.request("GET", `/v1/tasks/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async _fetchRaw(url, init) {
-    const controller = new AbortController;
-    const timer = setTimeout(() => controller.abort(), this.timeout);
-    try {
-      const headers = this._buildHeaders(init?.headers);
-      return await fetch(url, { ...init, headers, signal: controller.signal });
-    } finally {
-      clearTimeout(timer);
-    }
-  }
-  _buildHeaders(existing) {
-    const headers = { "Content-Type": "application/json" };
-    if (this.apiKey)
-      headers["x-api-key"] = this.apiKey;
-    if (existing) {
-      if (existing instanceof Headers) {
-        existing.forEach((v, k) => {
-          headers[k] = v;
-        });
-      } else if (Array.isArray(existing)) {
-        for (const [k, v] of existing)
-          headers[k] = v;
-      } else {
-        Object.assign(headers, existing);
-      }
-    }
-    return headers;
-  }
-  async _fetchWithRetry(path, init) {
-    let lastError = null;
-    const maxAttempts = this.maxRetries + 1;
-    for (let attempt = 0;attempt < maxAttempts; attempt++) {
-      try {
-        return await this._fetch(path, init);
-      } catch (e) {
-        lastError = e;
-        if (e instanceof TodosAPIError && e.status < 500 && e.status !== 429)
-          throw e;
-        if (e instanceof TodosUnauthorizedError || e instanceof TodosNotFoundError || e instanceof TodosConflictError)
-          throw e;
-        if (attempt < maxAttempts - 1) {
-          const delay = this.retryDelay * Math.pow(2, attempt);
-          if (e instanceof TodosRateLimitError) {
-            await this._sleep(e.retryAfter * 1000);
-          } else {
-            await this._sleep(delay);
-          }
-        }
-      }
-    }
-    throw lastError || new Error("Request failed after retries");
-  }
-  async _fetch(path, init) {
-    const controller = new AbortController;
-    const timer = setTimeout(() => controller.abort(), this.timeout);
-    try {
-      const url = `${this.baseUrl}${path}`;
-      const headers = this._buildHeaders(init?.headers);
-      const res = await fetch(url, { ...init, headers, signal: controller.signal });
-      if (!res.ok) {
-        const body = await res.json().catch(() => ({ error: res.statusText }));
-        const message = body.error || `HTTP ${res.status}: ${res.statusText}`;
-        if (res.status === 401)
-          throw new TodosUnauthorizedError(message, body);
-        if (res.status === 404)
-          throw new TodosNotFoundError(message, body);
-        if (res.status === 409)
-          throw new TodosConflictError(message, body);
-        if (res.status === 429) {
-          const retryAfter = parseInt(res.headers.get("retry-after") || "60", 10);
-          throw new TodosRateLimitError(message, retryAfter, body);
-        }
-        throw new TodosAPIError(message, res.status, res.statusText, body);
-      }
-      if (res.status === 204)
-        return null;
-      const text = await res.text();
-      if (text.length === 0)
-        return null;
-      return JSON.parse(text);
-    } catch (e) {
-      if (e instanceof DOMException && e.name === "AbortError") {
-        throw new TodosTimeoutError(this.timeout);
-      }
-      throw e;
-    } finally {
-      clearTimeout(timer);
-    }
-  }
-  async _get(path, query = "") {
-    return this._fetchWithRetry(`${path}${query}`);
+  async deleteTask(id, init) {
+    return this.request("DELETE", `/v1/tasks/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async _post(path, body) {
-    return this._fetchWithRetry(path, {
-      method: "POST",
-      body: body ? JSON.stringify(body) : undefined
+  async updateTask(id, body, init) {
+    return this.request("PATCH", `/v1/tasks/${encodeURIComponent(String(id))}`, {
+      body,
+      query: undefined,
+      init
     });
   }
-  async _patch(path, body) {
-    return this._fetchWithRetry(path, {
-      method: "PATCH",
-      body: JSON.stringify(body)
+  async listTaskComments(id, query, init) {
+    return this.request("GET", `/v1/tasks/${encodeURIComponent(String(id))}/comments`, {
+      body: undefined,
+      query,
+      init
     });
   }
-  async _delete(path) {
-    return this._fetchWithRetry(path, { method: "DELETE" });
+  async createTaskComment(id, body, init) {
+    return this.request("POST", `/v1/tasks/${encodeURIComponent(String(id))}/comments`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  _sleep(ms) {
-    return new Promise((resolve2) => setTimeout(resolve2, ms));
+  async completeTask(id, body, init) {
+    return this.request("POST", `/v1/tasks/${encodeURIComponent(String(id))}/complete`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async getHealth() {
-    return this._get("/api/health");
+  async failTask(id, body, init) {
+    return this.request("POST", `/v1/tasks/${encodeURIComponent(String(id))}/fail`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async isAlive() {
-    try {
-      await this._get("/api/stats");
-      return true;
-    } catch {
-      return false;
-    }
+  async listTaskHistory(id, query, init) {
+    return this.request("GET", `/v1/tasks/${encodeURIComponent(String(id))}/history`, {
+      body: undefined,
+      query,
+      init
+    });
   }
-  async getStats() {
-    return this._get("/api/stats");
+  async listTaskGitRefs(id, init) {
+    return this.request("GET", `/v1/tasks/${encodeURIComponent(String(id))}/refs`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async getReport(options) {
-    return this._get("/api/report", buildQuery({ days: options?.days, project_id: options?.projectId }));
+  async linkTaskGitRef(id, body, init) {
+    return this.request("POST", `/v1/tasks/${encodeURIComponent(String(id))}/refs`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async doctor() {
-    return this._get("/api/doctor");
+  async handoffStaleTaskLock(id, body, init) {
+    return this.request("POST", `/v1/tasks/${encodeURIComponent(String(id))}/stale-lock-handoff`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async activity(limit) {
-    return this._get("/api/activity", limit ? `?limit=${limit}` : "");
+  async startTask(id, init) {
+    return this.request("POST", `/v1/tasks/${encodeURIComponent(String(id))}/start`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async listTasks(filter = {}) {
-    return this.tasks.list(filter);
+  async listTemplates(query, init) {
+    return this.request("GET", `/v1/templates`, {
+      body: undefined,
+      query,
+      init
+    });
   }
-  async getTask(id, options) {
-    return this.tasks.get(id, options);
+  async createTemplate(body, init) {
+    return this.request("POST", `/v1/templates`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async createTask(data) {
-    return this.tasks.create(data);
+  async initializeTemplates(body, init) {
+    return this.request("POST", `/v1/templates/initialize`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async updateTask(id, data) {
-    return this.tasks.update(id, data);
+  async getTemplate(id, init) {
+    return this.request("GET", `/v1/templates/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async deleteTask(id) {
-    await this.tasks.delete(id);
+  async deleteTemplate(id, init) {
+    return this.request("DELETE", `/v1/templates/${encodeURIComponent(String(id))}`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async startTask(id, agentId) {
-    return this.tasks.start(id, agentId);
+  async updateTemplate(id, body, init) {
+    return this.request("PATCH", `/v1/templates/${encodeURIComponent(String(id))}`, {
+      body,
+      query: undefined,
+      init
+    });
   }
-  async completeTask(id, agentId) {
-    return this.tasks.complete(id, agentId);
+  async getTemplateHistory(id, init) {
+    return this.request("GET", `/v1/templates/${encodeURIComponent(String(id))}/history`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
   }
-  async failTask(id, options = {}) {
-    return this.tasks.fail(id, options);
+}
+
+// src/lib/local-opt-in.ts
+import {
+  clientTransportEnvKeys,
+  credentialOverrideEnvKey,
+  credentialPointerEnvKey,
+  CREDENTIAL_PROFILE_ENV_KEY
+} from "@hasna/contracts/client";
+var TODOS_LOCAL_OPT_IN_ENV_KEYS = ["HASNA_TODOS_LOCAL", "TODOS_LOCAL"];
+function isTodosLocalOptIn(env = process.env) {
+  return TODOS_LOCAL_OPT_IN_ENV_KEYS.some((key) => (env[key] ?? "").trim() !== "");
+}
+function todosAuthorityEnvKeys() {
+  const keys = clientTransportEnvKeys("todos");
+  return [
+    ...keys.apiUrlKeys,
+    ...keys.apiKeyKeys,
+    credentialOverrideEnvKey("todos"),
+    credentialPointerEnvKey("todos"),
+    CREDENTIAL_PROFILE_ENV_KEY
+  ];
+}
+function hasTodosEnvAuthorityIntent(env = process.env) {
+  return todosAuthorityEnvKeys().some((key) => (env[key] ?? "").trim() !== "");
+}
+function selectsTodosLocalStore(env = process.env) {
+  return !hasTodosEnvAuthorityIntent(env) && isTodosLocalOptIn(env);
+}
+function todosResolverEnv(env) {
+  const blanks = todosAuthorityEnvKeys().filter((key) => (key in env) && (env[key] ?? "").trim() === "");
+  if (blanks.length === 0)
+    return env;
+  const next = { ...env };
+  for (const key of blanks)
+    delete next[key];
+  return next;
+}
+var CONTRACTS_AMBIENT_ENVIRONMENT = Symbol.for("hasna:contracts:ambientClientEnvironment");
+function isAmbientTodosEnv(env) {
+  if (typeof process !== "undefined" && env === process.env)
+    return true;
+  return env[CONTRACTS_AMBIENT_ENVIRONMENT] === true;
+}
+function todosResolverInputs(env, credentials = {}) {
+  const normalised = todosResolverEnv(env);
+  if (normalised === env)
+    return { env: normalised, credentials };
+  const keychain = { ...credentials.keychain };
+  if (keychain.enabled === undefined && keychain.run === undefined) {
+    keychain.enabled = isAmbientTodosEnv(env);
+  }
+  return { env: normalised, credentials: { ...credentials, keychain } };
+}
+
+// src/sdk/resolve.ts
+var TODOS_LOCAL_SERVE_URL = "http://localhost:19427";
+var TODOS_CREDENTIAL_MISSING_MESSAGE = "TODOS_CREDENTIAL_MISSING: no Hasna Todos credential resolved. Looked at " + "HASNA_TODOS_API_KEY_OVERRIDE / HASNA_PROFILE / HASNA_TODOS_API_KEY_REF, the Keychain item " + "hasna.credentials.todos.api-key, ~/.hasna/todos/config/credentials, then HASNA_TODOS_API_KEY. " + "There is no local fallback: the on-box todos-serve is opt-in only (HASNA_TODOS_LOCAL=1, alias " + "TODOS_LOCAL=1) and is disabled by default \u2014 failing closed.";
+var localNoticePrinted = false;
+function __resetTodosSdkLocalNotice() {
+  localNoticePrinted = false;
+}
+function stripV1(baseUrl) {
+  return baseUrl.replace(/\/+$/, "").replace(/\/v1$/, "");
+}
+function announceLocal(notice) {
+  if (localNoticePrinted)
+    return;
+  localNoticePrinted = true;
+  const line = `todos: LOCAL mode \u2014 HASNA_TODOS_LOCAL is set and nothing configures a Todos authority; reading and ` + `writing the local todos-serve at ${TODOS_LOCAL_SERVE_URL}, not the hosted fleet. Unset it, and ` + `provide a credential via the Keychain item hasna.credentials.todos.api-key, ` + `~/.hasna/todos/config/credentials, or HASNA_TODOS_API_KEY, to work against https://api.hasna.com/todos.`;
+  if (notice)
+    notice(line);
+  else if (typeof process !== "undefined")
+    process.stderr.write(`${line}
+`);
+}
+function resolveTodosSdkTransport(options = {}) {
+  const rawEnv = options.env ?? (typeof process !== "undefined" ? process.env : {});
+  const requestedCredentials = {
+    ...options.credentials,
+    ...options.apiKey !== undefined ? { apiKey: options.apiKey } : {}
+  };
+  const { env, credentials } = todosResolverInputs(rawEnv, requestedCredentials);
+  if (options.baseUrl) {
+    return {
+      mode: "http",
+      baseUrl: stripV1(options.baseUrl),
+      apiKey: options.apiKey ?? null,
+      apiKeySource: options.apiKey ? "explicit apiKey argument" : null,
+      apiUrlSource: "explicit baseUrl argument"
+    };
   }
-  async logProgress(taskId, message, pctComplete, agentId) {
-    return this.tasks.logProgress(taskId, message, pctComplete, agentId);
+  if (selectsTodosLocalStore(env)) {
+    announceLocal(options.notice);
+    return {
+      mode: "local-serve",
+      baseUrl: TODOS_LOCAL_SERVE_URL,
+      apiKey: options.apiKey ?? null,
+      apiKeySource: options.apiKey ? "explicit apiKey argument" : null,
+      apiUrlSource: "local-serve"
+    };
   }
-  async getStatus(projectId, agentId) {
-    return this.tasks.status({ project_id: projectId, agent_id: agentId });
+  const credential = resolveCredential("todos", env, credentials);
+  const chainOptions = {
+    credentials: credential ? { ...credentials, apiKey: credential.apiKey } : credentials
+  };
+  let resolution;
+  try {
+    resolution = resolveClientTransport("todos", env, chainOptions);
+  } catch (error) {
+    if (error instanceof ClientTransportConfigurationError && /is not set and no API key could be resolved/.test(error.message)) {
+      throw new Error(`${TODOS_CREDENTIAL_MISSING_MESSAGE} ${error.message}`, { cause: error });
+    }
+    throw error;
   }
-  async getActiveWork(projectId) {
-    const res = await this.tasks.active(projectId);
-    return res.active;
-  }
-  async getTasksChangedSince(since, projectId) {
-    return this.tasks.changedSince(since, projectId);
+  return {
+    mode: "http",
+    baseUrl: stripV1(resolution.baseUrl),
+    apiKey: credential ? credential.apiKey : null,
+    apiKeySource: credential ? credential.source : resolution.apiKeySource,
+    apiUrlSource: resolution.apiUrlSource ?? "default"
+  };
+}
+function createTodosV1Client(options = {}) {
+  const resolved = resolveTodosSdkTransport(options);
+  if (resolved.mode !== "http" || !resolved.apiKey) {
+    throw new Error(`${TODOS_CREDENTIAL_MISSING_MESSAGE} The /v1 client is hosted-only: the local opt-in does not apply to it.`);
+  }
+  const baseFetch = options.fetch ?? ((input, init) => fetch(input, init));
+  const refreshOptions = { ...options, notice: () => {} };
+  const fetchWithFreshCredential = (input, init) => {
+    const headers = {};
+    new Headers(init?.headers ?? {}).forEach((value, key) => {
+      headers[key] = value;
+    });
+    try {
+      const fresh = resolveTodosSdkTransport(refreshOptions).apiKey;
+      if (fresh)
+        headers["x-api-key"] = fresh;
+    } catch {}
+    return baseFetch(input, { ...init, headers });
+  };
+  return new TodosV1Client({
+    baseUrl: resolved.baseUrl,
+    apiKey: resolved.apiKey,
+    fetch: fetchWithFreshCredential,
+    ...options.headers ? { headers: options.headers } : {}
+  });
+}
+
+// src/sdk/client.ts
+function buildQuery(params) {
+  const search = new URLSearchParams;
+  for (const [k, v] of Object.entries(params)) {
+    if (v !== undefined)
+      search.set(k, Array.isArray(v) ? v.join(",") : String(v));
   }
-  async getStaleTasks(minutes, projectId) {
-    return this.tasks.stale({ minutes, project_id: projectId });
+  const s = search.toString();
+  return s ? `?${s}` : "";
+}
+
+class TasksResource {
+  client;
+  constructor(client) {
+    this.client = client;
   }
-  async getContext(options = {}) {
-    return this.tasks.context(options);
+  async list(options) {
+    return this.client._get("/api/tasks", buildQuery(options || {}));
   }
-  async exportTasks(filter = {}) {
-    return this.tasks.export(filter);
+  async get(id, options) {
+    return this.client._get(`/api/tasks/${id}`, buildQuery(options || {}));
   }
-  async claimNextTask(agentId, projectId) {
-    return this.tasks.claim(agentId, projectId);
+  async getWithRelations(id) {
+    return this.client._get(`/api/tasks/${id}`, buildQuery({ format: "full" }));
   }
-  async getTaskHistory(id, options) {
-    return this.tasks.getHistory(id, options);
+  async create(data) {
+    return this.client._post("/api/tasks", data);
   }
-  async getTaskAttachments(id) {
-    return this.tasks.getAttachments(id);
+  async update(id, data) {
+    return this.client._patch(`/api/tasks/${id}`, data);
   }
-  async getTaskProgress(id, options) {
-    return this.tasks.getProgress(id, options);
+  async delete(id) {
+    return this.client._delete(`/api/tasks/${id}`);
   }
-  async* subscribeToStream(options = {}) {
-    yield* this.tasks.subscribe(options);
+  async start(id, agentId) {
+    return this.client._post(`/api/tasks/${id}/start`, { agent_id: agentId });
   }
-  async getProjects() {
-    return this.projects.list();
+  async complete(id, agentId) {
+    return this.client._post(`/api/tasks/${id}/complete`, { agent_id: agentId });
   }
-}
-function createClient(options) {
-  return new TodosClient(options);
-}
-// src/project-registration/types.ts
-class TodosProjectRegistrationError extends Error {
-  code;
-  details;
-  constructor(code, message, details = {}) {
-    super(message);
-    this.code = code;
-    this.details = details;
-    this.name = "TodosProjectRegistrationError";
+  async fail(id, options) {
+    return this.client._post(`/api/tasks/${id}/fail`, options || {});
   }
-}
-
-// src/project-registration/adoption-validation.ts
-var VALIDATION_KEYS = [
-  "valid",
-  "resource_kind",
-  "target_id",
-  "source_receipt_id",
-  "accepted_receipt_id",
-  "source_outcome",
-  "created_at",
-  "current_revision",
-  "accepted_result_digest"
-];
-function isRecord(value) {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-function isNonEmptyString(value) {
-  return typeof value === "string" && value.length > 0;
-}
-function hasExactKeys(value, expected) {
-  const actual = Object.keys(value).sort();
-  const wanted = [...expected].sort();
-  return actual.length === wanted.length && actual.every((key, index) => key === wanted[index]);
-}
-function adoptionRejected(message) {
-  throw new TodosProjectRegistrationError("TODOS_PROJECT_REGISTRATION_ADOPTION_REJECTED", `TODOS_PROJECT_REGISTRATION_ADOPTION_REJECTED: ${message}`);
-}
-function assertTodosPriorRegistrationAdoptionValidationEnvelope(value, input) {
-  if (!isRecord(input) || !hasExactKeys(input, [
-    "source_request",
-    "source_receipt",
-    "current_record"
-  ])) {
-    adoptionRejected("prior-adoption validation input is incomplete");
+  async logProgress(taskId, message, pctComplete, agentId) {
+    return this.client._post(`/api/tasks/${taskId}/progress`, {
+      message,
+      pct_complete: pctComplete,
+      agent_id: agentId
+    });
   }
-  const request = input["source_request"];
-  const receipt = input["source_receipt"];
-  const current = input["current_record"];
-  if (!isRecord(request) || !isRecord(receipt) || !isRecord(current)) {
-    adoptionRejected("prior-adoption validation input records are incomplete");
+  async getProgress(id, options) {
+    return this.client._get(`/api/tasks/${id}/progress`, buildQuery(options || {}));
   }
-  const resourceKind = request["resource_kind"];
-  const sourceOutcome = receipt["outcome"];
-  const acceptedReceiptId = sourceOutcome === "accepted" ? receipt["receipt_id"] : sourceOutcome === "duplicate_of_accepted" ? receipt["duplicate_of_receipt_id"] : null;
-  if (resourceKind !== "project" && resourceKind !== "task_list" || request["direction"] !== "forward" || sourceOutcome !== "accepted" && sourceOutcome !== "duplicate_of_accepted" || !isNonEmptyString(acceptedReceiptId) || !isNonEmptyString(receipt["receipt_id"]) || !isNonEmptyString(receipt["target_id"]) || !isNonEmptyString(receipt["result_revision"]) || !isNonEmptyString(receipt["result_digest"]) || !isNonEmptyString(current["id"]) || !isNonEmptyString(current["created_at"]) || !isNonEmptyString(current["updated_at"]) || receipt["authority"] !== "todos" || receipt["route"] !== request["authority_route"] || receipt["package_version"] !== request["package_version"] || receipt["authority_id"] !== request["authority_id"] || receipt["tenant_id"] !== request["tenant_id"] || receipt["corpus_id"] !== request["corpus_id"] || receipt["operation_id"] !== request["operation_id"] || receipt["step_id"] !== request["step_id"] || receipt["resource_kind"] !== resourceKind || receipt["direction"] !== "forward" || receipt["idempotency_key"] !== request["idempotency_key"] || receipt["request_digest"] !== request["request_digest"] || receipt["precondition_digest"] !== request["precondition_digest"] || receipt["accepted_receipt_id"] !== null || receipt["target_id"] !== current["id"] || receipt["result_revision"] !== current["created_at"]) {
-    adoptionRejected("prior-adoption validation input does not carry one complete accepted receipt and current target incarnation");
+  async getHistory(id, options) {
+    return this.client._get(`/api/tasks/${id}/history`, buildQuery(options || {}));
   }
-  if (sourceOutcome === "accepted" && receipt["duplicate_of_receipt_id"] !== null || sourceOutcome === "duplicate_of_accepted" && receipt["duplicate_of_receipt_id"] !== acceptedReceiptId) {
-    adoptionRejected("prior-adoption validation source receipt lineage is incomplete");
+  async getAttachments(id) {
+    return this.client._get(`/api/tasks/${id}/attachments`);
   }
-  if (!isRecord(value) || !hasExactKeys(value, ["validation"]) || !isRecord(value["validation"]) || !hasExactKeys(value["validation"], VALIDATION_KEYS)) {
-    adoptionRejected("prior-adoption validation response envelope is incomplete");
+  async status(options) {
+    return this.client._get("/api/tasks/status", buildQuery(options || {}));
   }
-  const validation = value["validation"];
-  if (validation["valid"] !== true || validation["resource_kind"] !== resourceKind || validation["target_id"] !== current["id"] || validation["source_receipt_id"] !== receipt["receipt_id"] || validation["accepted_receipt_id"] !== acceptedReceiptId || validation["source_outcome"] !== sourceOutcome || validation["created_at"] !== current["created_at"] || validation["current_revision"] !== current["updated_at"] || validation["accepted_result_digest"] !== receipt["result_digest"]) {
-    adoptionRejected("prior-adoption validation response does not prove the exact accepted receipt and current target");
+  async next(options) {
+    return this.client._get("/api/tasks/next", buildQuery(options || {}));
   }
-  return validation;
-}
-
-// src/sdk/v1.generated.ts
-class ApiError extends Error {
-  status;
-  body;
-  constructor(status, message, body) {
-    super(message);
-    this.status = status;
-    this.body = body;
-    this.name = "ApiError";
+  async active(projectId) {
+    return this.client._get("/api/tasks/active", projectId ? `?project_id=${projectId}` : "");
   }
-}
-
-class TodosV1Client {
-  baseUrl;
-  apiKey;
-  fetchImpl;
-  baseHeaders;
-  constructor(options) {
-    if (!options.baseUrl)
-      throw new Error("TodosV1Client requires a baseUrl.");
-    this.baseUrl = options.baseUrl.replace(/\/$/, "");
-    this.apiKey = options.apiKey;
-    this.fetchImpl = options.fetch ?? globalThis.fetch;
-    this.baseHeaders = options.headers ?? {};
+  async stale(options) {
+    return this.client._get("/api/tasks/stale", buildQuery(options || {}));
   }
-  async request(method, path, opts) {
-    const url = new URL(this.baseUrl + path);
-    if (opts.query) {
-      for (const [key, value] of Object.entries(opts.query)) {
-        if (value !== undefined && value !== null)
-          url.searchParams.set(key, String(value));
-      }
-    }
-    const headers = { Accept: "application/json", ...this.baseHeaders, ...opts.init?.headers };
-    if (this.apiKey)
-      headers["x-api-key"] = this.apiKey;
-    let payload;
-    if (opts.body !== undefined) {
-      headers["Content-Type"] = "application/json";
-      payload = JSON.stringify(opts.body);
-    }
-    const response = await this.fetchImpl(url.toString(), { ...opts.init, method, headers, body: payload });
-    const text = await response.text();
-    const data = text ? (() => {
-      try {
-        return JSON.parse(text);
-      } catch {
-        return text;
-      }
-    })() : undefined;
-    if (!response.ok) {
-      throw new ApiError(response.status, `${method} ${path} failed: ${response.status}`, data);
-    }
-    return data;
+  async changedSince(since, projectId, options) {
+    return this.client._get("/api/tasks/changed", buildQuery({ since, project_id: projectId, fields: options?.fields }));
   }
-  async importSnapshot(body, init) {
-    return this.request("POST", `/v1/import`, {
-      body,
-      query: undefined,
-      init
+  async context(options) {
+    const q = buildQuery({
+      agent_id: options?.agentId,
+      project_id: options?.projectId,
+      format: options?.format,
+      fields: options?.fields
     });
+    const url = `${this.client.baseUrl}/api/tasks/context${q}`;
+    const res = await this.client._fetchRaw(url);
+    if (!res.ok)
+      return options?.format === "json" ? {} : "";
+    if (options?.format === "json")
+      return res.json();
+    return res.text();
   }
-  async listPlans(query, init) {
-    return this.request("GET", `/v1/plans`, {
-      body: undefined,
-      query,
-      init
-    });
+  async export(options) {
+    const q = buildQuery(options || {});
+    const url = `${this.client.baseUrl}/api/tasks/export${q}`;
+    const res = await this.client._fetchRaw(url);
+    if (!res.ok)
+      throw new TodosAPIError("Export failed", res.status, res.statusText, null);
+    if (options?.format === "csv")
+      return res.text();
+    return res.json();
   }
-  async createPlan(body, init) {
-    return this.request("POST", `/v1/plans`, {
-      body,
-      query: undefined,
-      init
-    });
+  async bulk(ids, action) {
+    return this.client._post("/api/tasks/bulk", { ids, action });
   }
-  async getPlan(id, init) {
-    return this.request("GET", `/v1/plans/${encodeURIComponent(String(id))}`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async claim(agentId, projectId) {
+    return this.client._post("/api/tasks/claim", { agent_id: agentId, project_id: projectId });
   }
-  async deletePlan(id, init) {
-    return this.request("DELETE", `/v1/plans/${encodeURIComponent(String(id))}`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
-  }
-  async updatePlan(id, body, init) {
-    return this.request("PATCH", `/v1/plans/${encodeURIComponent(String(id))}`, {
-      body,
-      query: undefined,
-      init
+  async* subscribe(options = {}) {
+    const q = buildQuery({
+      agent_id: options.agentId,
+      project_id: options.projectId,
+      events: options.events?.join(",")
     });
+    const url = `${this.client.baseUrl}/api/tasks/stream${q}`;
+    const resp = await this.client._fetchRaw(url);
+    if (!resp.ok || !resp.body)
+      throw new Error(`SSE connection failed: ${resp.status}`);
+    const reader = resp.body.getReader();
+    const decoder = new TextDecoder;
+    let buffer = "";
+    try {
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+          break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split(`
+`);
+        buffer = lines.pop() || "";
+        for (const line of lines) {
+          if (line.startsWith("data: ")) {
+            try {
+              const data = JSON.parse(line.slice(6));
+              if (data.type !== "connected")
+                yield data;
+            } catch {}
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+    }
   }
-  async planPlanProjectLink(id, query, init) {
-    return this.request("GET", `/v1/plans/${encodeURIComponent(String(id))}/project-link`, {
-      body: undefined,
-      query,
-      init
-    });
+}
+
+class AgentsResource {
+  client;
+  constructor(client) {
+    this.client = client;
   }
-  async applyPlanProjectLink(id, body, init) {
-    return this.request("POST", `/v1/plans/${encodeURIComponent(String(id))}/project-link`, {
-      body,
-      query: undefined,
-      init
-    });
+  async list(options) {
+    return this.client._get("/api/agents", buildQuery(options || {}));
   }
-  async rollbackPlanProjectLink(id, body, init) {
-    return this.request("POST", `/v1/plans/${encodeURIComponent(String(id))}/project-link/rollback`, {
-      body,
-      query: undefined,
-      init
-    });
+  async register(data) {
+    return this.client._post("/api/agents", data);
   }
-  async admitPrGroup(body, init) {
-    return this.request("POST", `/v1/pr-groups/admit`, {
-      body,
-      query: undefined,
-      init
-    });
+  async fullRegister(data) {
+    return this.client._post("/api/agents", data);
   }
-  async getPrGroupState(id, init) {
-    return this.request("GET", `/v1/pr-groups/${encodeURIComponent(String(id))}`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async update(id, data) {
+    return this.client._patch(`/api/agents/${id}`, data);
   }
-  async getPrGroupEvents(id, query, init) {
-    return this.request("GET", `/v1/pr-groups/${encodeURIComponent(String(id))}/events`, {
-      body: undefined,
-      query,
-      init
-    });
+  async delete(id) {
+    return this.client._delete(`/api/agents/${id}`);
   }
-  async appendPrGroupEvent(id, body, init) {
-    return this.request("POST", `/v1/pr-groups/${encodeURIComponent(String(id))}/events`, {
-      body,
-      query: undefined,
-      init
-    });
+  async bulkDelete(ids) {
+    return this.client._post("/api/agents/bulk", { ids, action: "delete" });
   }
-  async recoverPrGroup(id, body, init) {
-    return this.request("POST", `/v1/pr-groups/${encodeURIComponent(String(id))}/recover`, {
-      body,
-      query: undefined,
-      init
-    });
+  async me(name) {
+    return this.client._get("/api/agents/me", `?name=${encodeURIComponent(name)}`);
   }
-  async getProjectRegistrationCapability(init) {
-    return this.request("GET", `/v1/project-registration/capability`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async queue(agentId) {
+    return this.client._get(`/api/agents/${encodeURIComponent(agentId)}/queue`);
   }
-  async compensateProjectRegistrationResource(body, init) {
-    return this.request("POST", `/v1/project-registration/compensate`, {
-      body,
-      query: undefined,
-      init
-    });
+  async team(agentId) {
+    return this.client._get(`/api/agents/${encodeURIComponent(agentId)}/team`);
   }
-  async createProjectRegistrationResource(body, init) {
-    return this.request("POST", `/v1/project-registration/create`, {
-      body,
-      query: undefined,
-      init
-    });
+  async orgChart() {
+    return this.client._get("/api/org");
   }
-  async readExactProjectRegistrationResource(body, init) {
-    return this.request("POST", `/v1/project-registration/read-exact`, {
-      body,
-      query: undefined,
-      init
-    });
+}
+
+class ProjectsResource {
+  client;
+  constructor(client) {
+    this.client = client;
   }
-  async lookupProjectRegistrationReceipt(body, init) {
-    return this.request("POST", `/v1/project-registration/receipts/lookup`, {
-      body,
-      query: undefined,
-      init
-    });
+  async list(options) {
+    return this.client._get("/api/projects", buildQuery(options || {}));
   }
-  async listProjectRegistrationResources(query, init) {
-    return this.request("GET", `/v1/project-registration/resources`, {
-      body: undefined,
-      query,
-      init
-    });
+  async create(data) {
+    return this.client._post("/api/projects", data);
   }
-  async validatePriorRegistrationAdoption(body, init) {
-    const response = await this.request("POST", `/v1/project-registration/validate-prior-adoption`, {
-      body,
-      query: undefined,
-      init
-    });
-    return {
-      validation: assertTodosPriorRegistrationAdoptionValidationEnvelope(response, body)
-    };
+  async delete(id) {
+    return this.client._delete(`/api/projects/${id}`);
   }
-  async verifyInverseProjectRegistrationResource(body, init) {
-    return this.request("POST", `/v1/project-registration/verify-inverse`, {
-      body,
-      query: undefined,
-      init
-    });
+  async bulkDelete(ids) {
+    return this.client._post("/api/projects/bulk", { ids, action: "delete" });
   }
-  async listProjects(init) {
-    return this.request("GET", `/v1/projects`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+}
+
+class PlansResource {
+  client;
+  constructor(client) {
+    this.client = client;
   }
-  async createProject(body, init) {
-    return this.request("POST", `/v1/projects`, {
-      body,
-      query: undefined,
-      init
-    });
+  async list(projectId) {
+    return this.client._get("/api/plans", projectId ? `?project_id=${projectId}` : "");
   }
-  async getProject(id, init) {
-    return this.request("GET", `/v1/projects/${encodeURIComponent(String(id))}`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async create(data) {
+    return this.client._post("/api/plans", data);
   }
-  async deleteProject(id, init) {
-    return this.request("DELETE", `/v1/projects/${encodeURIComponent(String(id))}`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async get(id) {
+    return this.client._get(`/api/plans/${id}`);
   }
-  async updateProject(id, body, init) {
-    return this.request("PATCH", `/v1/projects/${encodeURIComponent(String(id))}`, {
-      body,
-      query: undefined,
-      init
-    });
+  async update(id, data) {
+    return this.client._patch(`/api/plans/${id}`, data);
   }
-  async renameProject(id, body, init) {
-    return this.request("POST", `/v1/projects/${encodeURIComponent(String(id))}/rename`, {
-      body,
-      query: undefined,
-      init
-    });
+  async delete(id) {
+    return this.client._delete(`/api/plans/${id}`);
   }
-  async planProjectTaskListEnsure(id, init) {
-    return this.request("GET", `/v1/projects/${encodeURIComponent(String(id))}/task-list/ensure`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async bulkDelete(ids) {
+    return this.client._post("/api/plans/bulk", { ids, action: "delete" });
   }
-  async ensureProjectTaskList(id, body, init) {
-    return this.request("POST", `/v1/projects/${encodeURIComponent(String(id))}/task-list/ensure`, {
-      body,
-      query: undefined,
-      init
-    });
+}
+
+class OrgsResource {
+  client;
+  constructor(client) {
+    this.client = client;
   }
-  async rollbackProjectTaskListEnsure(id, body, init) {
-    return this.request("POST", `/v1/projects/${encodeURIComponent(String(id))}/task-list/rollback`, {
-      body,
-      query: undefined,
-      init
-    });
+  async list() {
+    return this.client._get("/api/orgs");
   }
-  async findTaskGitRefs(ref, init) {
-    return this.request("GET", `/v1/refs/${encodeURIComponent(String(ref))}`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async create(data) {
+    return this.client._post("/api/orgs", data);
   }
-  async getStats(init) {
-    return this.request("GET", `/v1/stats`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async update(id, data) {
+    return this.client._patch(`/api/orgs/${id}`, data);
   }
-  async listTaskLists(query, init) {
-    return this.request("GET", `/v1/task-lists`, {
-      body: undefined,
-      query,
-      init
-    });
+  async delete(id) {
+    return this.client._delete(`/api/orgs/${id}`);
   }
-  async createTaskList(body, init) {
-    return this.request("POST", `/v1/task-lists`, {
-      body,
-      query: undefined,
-      init
-    });
+}
+
+class WebhooksResource {
+  client;
+  constructor(client) {
+    this.client = client;
   }
-  async getTaskList(id, init) {
-    return this.request("GET", `/v1/task-lists/${encodeURIComponent(String(id))}`, {
-      body: undefined,
-      query: undefined,
-      init
+  async list() {
+    return this.client._get("/api/webhooks");
+  }
+  async create(data) {
+    return this.client._post("/api/webhooks", data);
+  }
+  async delete(id) {
+    return this.client._delete(`/api/webhooks/${id}`);
+  }
+}
+
+class TemplatesResource {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client._get("/api/templates");
+  }
+  async create(data) {
+    return this.client._post("/api/templates", data);
+  }
+  async delete(id) {
+    return this.client._delete(`/api/templates/${id}`);
+  }
+}
+
+class PrGroupsResource {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  async admit(input) {
+    return this.client._post("/api/pr-groups/admit", input);
+  }
+  async get(groupId) {
+    const result = await this.client._get(`/api/pr-groups/${encodeURIComponent(groupId)}`);
+    return result.view;
+  }
+  async events(groupId, options = {}) {
+    const result = await this.client._get(`/api/pr-groups/${encodeURIComponent(groupId)}/events`, buildQuery({
+      limit: options.limit,
+      after_sequence: options.after_sequence
+    }));
+    return result.history;
+  }
+  async append(input) {
+    return this.client._post(`/api/pr-groups/${encodeURIComponent(input.group_id)}/events`, input);
+  }
+  async recover(input) {
+    return this.client._post(`/api/pr-groups/${encodeURIComponent(input.group_id)}/recover`, input);
+  }
+}
+
+class TodosClient {
+  baseUrl;
+  timeout;
+  maxRetries;
+  retryDelay;
+  explicitApiKey;
+  constructedApiKey;
+  pinnedAuthority;
+  tasks;
+  agents;
+  projects;
+  plans;
+  orgs;
+  webhooks;
+  templates;
+  prGroups;
+  constructor(options = {}) {
+    const resolved = resolveTodosSdkTransport({
+      ...options.baseUrl !== undefined ? { baseUrl: options.baseUrl } : {},
+      ...options.apiKey !== undefined ? { apiKey: options.apiKey } : {}
     });
+    this.baseUrl = resolved.baseUrl;
+    this.timeout = options.timeout ?? 1e4;
+    this.explicitApiKey = options.apiKey;
+    this.constructedApiKey = resolved.apiKey;
+    this.pinnedAuthority = Boolean(options.baseUrl);
+    this.maxRetries = options.maxRetries ?? 0;
+    this.retryDelay = options.retryDelay ?? 1000;
+    this.tasks = new TasksResource(this);
+    this.agents = new AgentsResource(this);
+    this.projects = new ProjectsResource(this);
+    this.plans = new PlansResource(this);
+    this.orgs = new OrgsResource(this);
+    this.webhooks = new WebhooksResource(this);
+    this.templates = new TemplatesResource(this);
+    this.prGroups = new PrGroupsResource(this);
+  }
+  static fromEnv(apiKey) {
+    return new TodosClient(apiKey === undefined ? {} : { apiKey });
+  }
+  async _fetchRaw(url, init) {
+    const controller = new AbortController;
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const headers = this._buildHeaders(init?.headers);
+      return await fetch(url, { ...init, headers, signal: controller.signal });
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  currentApiKey() {
+    if (this.explicitApiKey !== undefined)
+      return this.explicitApiKey;
+    if (this.pinnedAuthority)
+      return this.constructedApiKey;
+    try {
+      const fresh = resolveTodosSdkTransport({ notice: () => {} }).apiKey;
+      if (fresh)
+        return fresh;
+    } catch {}
+    return this.constructedApiKey;
+  }
+  get apiKey() {
+    return this.currentApiKey();
+  }
+  _buildHeaders(existing) {
+    const headers = { "Content-Type": "application/json" };
+    const apiKey = this.currentApiKey();
+    if (apiKey)
+      headers["x-api-key"] = apiKey;
+    if (existing) {
+      if (existing instanceof Headers) {
+        existing.forEach((v, k) => {
+          headers[k] = v;
+        });
+      } else if (Array.isArray(existing)) {
+        for (const [k, v] of existing)
+          headers[k] = v;
+      } else {
+        Object.assign(headers, existing);
+      }
+    }
+    return headers;
+  }
+  async _fetchWithRetry(path, init) {
+    let lastError = null;
+    const maxAttempts = this.maxRetries + 1;
+    for (let attempt = 0;attempt < maxAttempts; attempt++) {
+      try {
+        return await this._fetch(path, init);
+      } catch (e) {
+        lastError = e;
+        if (e instanceof TodosAPIError && e.status < 500 && e.status !== 429)
+          throw e;
+        if (e instanceof TodosUnauthorizedError || e instanceof TodosNotFoundError || e instanceof TodosConflictError)
+          throw e;
+        if (attempt < maxAttempts - 1) {
+          const delay = this.retryDelay * Math.pow(2, attempt);
+          if (e instanceof TodosRateLimitError) {
+            await this._sleep(e.retryAfter * 1000);
+          } else {
+            await this._sleep(delay);
+          }
+        }
+      }
+    }
+    throw lastError || new Error("Request failed after retries");
+  }
+  async _fetch(path, init) {
+    const controller = new AbortController;
+    const timer = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const url = `${this.baseUrl}${path}`;
+      const headers = this._buildHeaders(init?.headers);
+      const res = await fetch(url, { ...init, headers, signal: controller.signal });
+      if (!res.ok) {
+        const body = await res.json().catch(() => ({ error: res.statusText }));
+        const message = body.error || `HTTP ${res.status}: ${res.statusText}`;
+        if (res.status === 401)
+          throw new TodosUnauthorizedError(message, body);
+        if (res.status === 404)
+          throw new TodosNotFoundError(message, body);
+        if (res.status === 409)
+          throw new TodosConflictError(message, body);
+        if (res.status === 429) {
+          const retryAfter = parseInt(res.headers.get("retry-after") || "60", 10);
+          throw new TodosRateLimitError(message, retryAfter, body);
+        }
+        throw new TodosAPIError(message, res.status, res.statusText, body);
+      }
+      if (res.status === 204)
+        return null;
+      const text = await res.text();
+      if (text.length === 0)
+        return null;
+      return JSON.parse(text);
+    } catch (e) {
+      if (e instanceof DOMException && e.name === "AbortError") {
+        throw new TodosTimeoutError(this.timeout);
+      }
+      throw e;
+    } finally {
+      clearTimeout(timer);
+    }
   }
-  async deleteTaskList(id, init) {
-    return this.request("DELETE", `/v1/task-lists/${encodeURIComponent(String(id))}`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async _get(path, query = "") {
+    return this._fetchWithRetry(`${path}${query}`);
   }
-  async updateTaskList(id, body, init) {
-    return this.request("PATCH", `/v1/task-lists/${encodeURIComponent(String(id))}`, {
-      body,
-      query: undefined,
-      init
+  async _post(path, body) {
+    return this._fetchWithRetry(path, {
+      method: "POST",
+      body: body ? JSON.stringify(body) : undefined
     });
   }
-  async applyTaskManifest(body, init) {
-    return this.request("POST", `/v1/task-manifest/apply`, {
-      body,
-      query: undefined,
-      init
+  async _patch(path, body) {
+    return this._fetchWithRetry(path, {
+      method: "PATCH",
+      body: JSON.stringify(body)
     });
   }
-  async lookupTaskManifestBinding(body, init) {
-    return this.request("POST", `/v1/task-manifest/bindings/lookup`, {
-      body,
-      query: undefined,
-      init
-    });
+  async _delete(path) {
+    return this._fetchWithRetry(path, { method: "DELETE" });
   }
-  async getTaskManifestCapability(init) {
-    return this.request("GET", `/v1/task-manifest/capability`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  _sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
   }
-  async compensateTaskManifest(body, init) {
-    return this.request("POST", `/v1/task-manifest/compensate`, {
-      body,
-      query: undefined,
-      init
-    });
+  async getHealth() {
+    return this._get("/api/health");
   }
-  async readExactTaskManifest(body, init) {
-    return this.request("POST", `/v1/task-manifest/read-exact`, {
-      body,
-      query: undefined,
-      init
-    });
+  async isAlive() {
+    try {
+      await this._get("/api/stats");
+      return true;
+    } catch {
+      return false;
+    }
   }
-  async applyTaskSubtreeTransfer(body, init) {
-    return this.request("POST", `/v1/task-subtree-transfer/apply`, {
-      body,
-      query: undefined,
-      init
-    });
+  async getStats() {
+    return this._get("/api/stats");
   }
-  async getTaskSubtreeTransferCapability(init) {
-    return this.request("GET", `/v1/task-subtree-transfer/capability`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async getReport(options) {
+    return this._get("/api/report", buildQuery({ days: options?.days, project_id: options?.projectId }));
   }
-  async inspectTaskSubtreeTransfer(body, init) {
-    return this.request("POST", `/v1/task-subtree-transfer/inspect`, {
-      body,
-      query: undefined,
-      init
-    });
+  async doctor() {
+    return this._get("/api/doctor");
   }
-  async readExactTaskSubtreeTransfer(body, init) {
-    return this.request("POST", `/v1/task-subtree-transfer/read-exact`, {
-      body,
-      query: undefined,
-      init
-    });
+  async activity(limit) {
+    return this._get("/api/activity", limit ? `?limit=${limit}` : "");
   }
-  async rollbackTaskSubtreeTransfer(body, init) {
-    return this.request("POST", `/v1/task-subtree-transfer/rollback`, {
-      body,
-      query: undefined,
-      init
-    });
+  async listTasks(filter = {}) {
+    return this.tasks.list(filter);
   }
-  async listTasks(query, init) {
-    return this.request("GET", `/v1/tasks`, {
-      body: undefined,
-      query,
-      init
-    });
+  async getTask(id, options) {
+    return this.tasks.get(id, options);
   }
-  async createTask(body, init) {
-    return this.request("POST", `/v1/tasks`, {
-      body,
-      query: undefined,
-      init
-    });
+  async createTask(data) {
+    return this.tasks.create(data);
   }
-  async getTask(id, init) {
-    return this.request("GET", `/v1/tasks/${encodeURIComponent(String(id))}`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async updateTask(id, data) {
+    return this.tasks.update(id, data);
   }
-  async deleteTask(id, init) {
-    return this.request("DELETE", `/v1/tasks/${encodeURIComponent(String(id))}`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async deleteTask(id) {
+    await this.tasks.delete(id);
   }
-  async updateTask(id, body, init) {
-    return this.request("PATCH", `/v1/tasks/${encodeURIComponent(String(id))}`, {
-      body,
-      query: undefined,
-      init
-    });
+  async startTask(id, agentId) {
+    return this.tasks.start(id, agentId);
   }
-  async listTaskComments(id, query, init) {
-    return this.request("GET", `/v1/tasks/${encodeURIComponent(String(id))}/comments`, {
-      body: undefined,
-      query,
-      init
-    });
+  async completeTask(id, agentId) {
+    return this.tasks.complete(id, agentId);
   }
-  async createTaskComment(id, body, init) {
-    return this.request("POST", `/v1/tasks/${encodeURIComponent(String(id))}/comments`, {
-      body,
-      query: undefined,
-      init
-    });
+  async failTask(id, options = {}) {
+    return this.tasks.fail(id, options);
   }
-  async completeTask(id, body, init) {
-    return this.request("POST", `/v1/tasks/${encodeURIComponent(String(id))}/complete`, {
-      body,
-      query: undefined,
-      init
-    });
+  async logProgress(taskId, message, pctComplete, agentId) {
+    return this.tasks.logProgress(taskId, message, pctComplete, agentId);
   }
-  async failTask(id, body, init) {
-    return this.request("POST", `/v1/tasks/${encodeURIComponent(String(id))}/fail`, {
-      body,
-      query: undefined,
-      init
-    });
+  async getStatus(projectId, agentId) {
+    return this.tasks.status({ project_id: projectId, agent_id: agentId });
   }
-  async listTaskGitRefs(id, init) {
-    return this.request("GET", `/v1/tasks/${encodeURIComponent(String(id))}/refs`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async getActiveWork(projectId) {
+    const res = await this.tasks.active(projectId);
+    return res.active;
   }
-  async linkTaskGitRef(id, body, init) {
-    return this.request("POST", `/v1/tasks/${encodeURIComponent(String(id))}/refs`, {
-      body,
-      query: undefined,
-      init
-    });
+  async getTasksChangedSince(since, projectId) {
+    return this.tasks.changedSince(since, projectId);
   }
-  async handoffStaleTaskLock(id, body, init) {
-    return this.request("POST", `/v1/tasks/${encodeURIComponent(String(id))}/stale-lock-handoff`, {
-      body,
-      query: undefined,
-      init
-    });
+  async getStaleTasks(minutes, projectId) {
+    return this.tasks.stale({ minutes, project_id: projectId });
   }
-  async startTask(id, init) {
-    return this.request("POST", `/v1/tasks/${encodeURIComponent(String(id))}/start`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async getContext(options = {}) {
+    return this.tasks.context(options);
   }
-  async listTemplates(query, init) {
-    return this.request("GET", `/v1/templates`, {
-      body: undefined,
-      query,
-      init
-    });
+  async exportTasks(filter = {}) {
+    return this.tasks.export(filter);
   }
-  async createTemplate(body, init) {
-    return this.request("POST", `/v1/templates`, {
-      body,
-      query: undefined,
-      init
-    });
+  async claimNextTask(agentId, projectId) {
+    return this.tasks.claim(agentId, projectId);
   }
-  async getTemplate(id, init) {
-    return this.request("GET", `/v1/templates/${encodeURIComponent(String(id))}`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async getTaskHistory(id, options) {
+    return this.tasks.getHistory(id, options);
   }
-  async deleteTemplate(id, init) {
-    return this.request("DELETE", `/v1/templates/${encodeURIComponent(String(id))}`, {
-      body: undefined,
-      query: undefined,
-      init
-    });
+  async getTaskAttachments(id) {
+    return this.tasks.getAttachments(id);
   }
-  async updateTemplate(id, body, init) {
-    return this.request("PATCH", `/v1/templates/${encodeURIComponent(String(id))}`, {
-      body,
-      query: undefined,
-      init
-    });
+  async getTaskProgress(id, options) {
+    return this.tasks.getProgress(id, options);
+  }
+  async* subscribeToStream(options = {}) {
+    yield* this.tasks.subscribe(options);
+  }
+  async getProjects() {
+    return this.projects.list();
   }
 }
+function createClient(options) {
+  return new TodosClient(options);
+}
 export {
+  resolveTodosSdkTransport,
+  createTodosV1Client,
   createClient,
+  __resetTodosSdkLocalNotice,
   TodosV1Client,
   ApiError as TodosV1ApiError,
   TodosUnauthorizedError,
@@ -1346,5 +1510,6 @@ export {
   TodosNotFoundError,
   TodosConflictError,
   TodosClient,
-  TodosAPIError
+  TodosAPIError,
+  TODOS_LOCAL_SERVE_URL
 };