tila-sdk 0.1.0 → 0.2.0

package/dist/index.cjs

@@ -1,10 +1,8 @@
 'use strict';
 
-var module$1 = require('module');
 var zod = require('zod');
 
-var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
-// src/client.ts
+// ../schemas/dist/entity.js
 zod.z.object({
   id: zod.z.string(),
   type: zod.z.string(),
@@ -13,7 +11,8 @@ zod.z.object({
   archived: zod.z.number().int().default(0),
   created_at: zod.z.number().int(),
   updated_at: zod.z.number().int(),
-  created_by: zod.z.string()
+  created_by: zod.z.string(),
+  tags: zod.z.array(zod.z.string()).default([])
 });
 var ClaimModeSchema = zod.z.enum(["exclusive", "owner", "presence"]);
 zod.z.object({
@@ -75,7 +74,8 @@ zod.z.object({
   produced_at: zod.z.number().int(),
   produced_by: zod.z.string(),
   expires_at: zod.z.number().int().nullable(),
-  tombstoned: zod.z.number().int().default(0)
+  tombstoned: zod.z.number().int().default(0),
+  tags: zod.z.array(zod.z.string()).default([])
 });
 zod.z.object({
   entity_id: zod.z.string(),
@@ -163,15 +163,15 @@ zod.z.object({
   payload: zod.z.unknown().optional(),
   ttl_ms: zod.z.number().int().min(1e3).max(864e5).optional()
 });
-zod.z.object({
+var SendSignalResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   id: zod.z.string()
 });
-zod.z.object({
+var InboxResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   signals: zod.z.array(SignalSchema)
 });
-zod.z.object({
+var AckSignalResponseSchema = zod.z.object({
   ok: zod.z.literal(true)
 });
 zod.z.object({
@@ -335,6 +335,21 @@ zod.z.object({
   pages_project_name: zod.z.string().optional(),
   infra_slug: zod.z.string().optional()
 });
+var TagSchema = zod.z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9_:.-]{0,63}$/, "Invalid tag format");
+var TagsSchema = zod.z.array(TagSchema).transform((tags) => {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const tag of tags) {
+    const lower = tag.toLowerCase();
+    if (!seen.has(lower)) {
+      seen.add(lower);
+      result.push(lower);
+    }
+  }
+  return result;
+}).refine((tags) => tags.length <= 20, "may not have more than 20 tags");
+
+// ../schemas/dist/record.js
 var RecordTypeSchema = zod.z.string().regex(/^[a-z][a-z0-9_-]*$/, "Record type must start with lowercase letter and contain only lowercase letters, digits, underscores, and hyphens");
 var RecordKeySchema = zod.z.string().superRefine((val, ctx) => {
   if (val.length === 0) {
@@ -411,18 +426,7 @@ var RecordKeySchema = zod.z.string().superRefine((val, ctx) => {
     }
   }
 });
-var RecordTagSchema = zod.z.array(zod.z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9_:.-]{0,63}$/, "Invalid tag format")).transform((tags) => {
-  const seen = /* @__PURE__ */ new Set();
-  const result = [];
-  for (const tag of tags) {
-    const lower = tag.toLowerCase();
-    if (!seen.has(lower)) {
-      seen.add(lower);
-      result.push(lower);
-    }
-  }
-  return result;
-}).refine((tags) => tags.length <= 20, "Record may not have more than 20 tags");
+var RecordTagSchema = TagsSchema;
 function sortKeysDeep(v) {
   if (Array.isArray(v))
     return v.map(sortKeysDeep);
@@ -461,7 +465,7 @@ zod.z.object({
   idempotency_key: zod.z.string().optional(),
   metadata: zod.z.record(zod.z.unknown()).optional()
 });
-zod.z.object({
+var AcquireSuccessResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   fence: zod.z.number().int(),
   expires_at: zod.z.number().int()
@@ -471,7 +475,7 @@ zod.z.object({
   fence: zod.z.number().int(),
   ttl_ms: zod.z.number().int().positive()
 });
-zod.z.object({
+var RenewSuccessResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   expires_at: zod.z.number().int()
 });
@@ -479,10 +483,10 @@ zod.z.object({
   resource: zod.z.string(),
   fence: zod.z.number().int()
 });
-zod.z.object({
+var ReleaseSuccessResponseSchema = zod.z.object({
   ok: zod.z.literal(true)
 });
-zod.z.object({
+var StateResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   claim: zod.z.object({
     resource: zod.z.string(),
@@ -511,16 +515,18 @@ zod.z.object({
 zod.z.object({
   id: zod.z.string(),
   type: zod.z.string(),
-  data: zod.z.record(zod.z.unknown()).default({})
+  data: zod.z.record(zod.z.unknown()).default({}),
+  tags: TagsSchema.optional()
 });
 zod.z.object({
   data: zod.z.record(zod.z.unknown()),
-  fence: zod.z.number().int()
+  fence: zod.z.number().int(),
+  tags: TagsSchema.optional()
 });
 zod.z.object({
   fence: zod.z.number().int()
 });
-zod.z.object({
+var EntityResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   entity: zod.z.object({
     id: zod.z.string(),
@@ -530,7 +536,8 @@ zod.z.object({
     archived: zod.z.number().int(),
     created_at: zod.z.number().int(),
     updated_at: zod.z.number().int(),
-    created_by: zod.z.string()
+    created_by: zod.z.string(),
+    tags: zod.z.array(zod.z.string())
   })
 });
 zod.z.object({
@@ -543,10 +550,11 @@ zod.z.object({
     archived: zod.z.number().int(),
     created_at: zod.z.number().int(),
     updated_at: zod.z.number().int(),
-    created_by: zod.z.string()
+    created_by: zod.z.string(),
+    tags: zod.z.array(zod.z.string())
   }))
 });
-zod.z.object({
+var PaginatedEntityListResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   entities: zod.z.array(zod.z.object({
     id: zod.z.string(),
@@ -556,14 +564,15 @@ zod.z.object({
     archived: zod.z.number().int(),
     created_at: zod.z.number().int(),
     updated_at: zod.z.number().int(),
-    created_by: zod.z.string()
+    created_by: zod.z.string(),
+    tags: zod.z.array(zod.z.string())
   })),
   total: zod.z.number().int(),
   limit: zod.z.number().int().nullable(),
   offset: zod.z.number().int(),
   has_more: zod.z.boolean()
 });
-zod.z.object({
+var ListReadyEntitiesResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   entities: zod.z.array(zod.z.object({
     id: zod.z.string(),
@@ -593,7 +602,7 @@ zod.z.object({
   ok: zod.z.literal(true),
   entity: CompactEntitySchema
 });
-zod.z.object({
+var PaginatedCompactEntityListResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   entities: zod.z.array(CompactEntitySchema),
   total: zod.z.number().int(),
@@ -601,7 +610,7 @@ zod.z.object({
   offset: zod.z.number().int(),
   has_more: zod.z.boolean()
 });
-zod.z.object({
+var SummaryResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   project: zod.z.object({
     entity_count: zod.z.number().int(),
@@ -620,7 +629,7 @@ zod.z.object({
     }))
   })
 });
-zod.z.object({
+var EntityDetailResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   entity: zod.z.object({
     id: zod.z.string(),
@@ -630,11 +639,12 @@ zod.z.object({
     archived: zod.z.number().int(),
     created_at: zod.z.number().int(),
     updated_at: zod.z.number().int(),
-    created_by: zod.z.string()
+    created_by: zod.z.string(),
+    tags: zod.z.array(zod.z.string())
   }),
   relationships: zod.z.array(EntityRelationshipSchema).default([])
 });
-zod.z.object({
+var ArchiveSuccessResponseSchema = zod.z.object({
   ok: zod.z.literal(true)
 });
 zod.z.object({
@@ -642,7 +652,7 @@ zod.z.object({
   to_id: zod.z.string().min(1),
   type: EntityRelationshipTypeSchema
 });
-zod.z.object({
+var CreateEntityRelationshipResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   created: zod.z.boolean().default(true)
 });
@@ -651,7 +661,7 @@ zod.z.object({
   to_id: zod.z.string().min(1).optional(),
   type: EntityRelationshipTypeSchema.optional()
 });
-zod.z.object({
+var ListEntityRelationshipsResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   relationships: zod.z.array(EntityRelationshipSchema)
 });
@@ -660,7 +670,7 @@ zod.z.object({
   to_id: zod.z.string().min(1),
   type: EntityRelationshipTypeSchema
 });
-zod.z.object({
+var DeleteEntityRelationshipResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   removed: zod.z.boolean()
 });
@@ -671,7 +681,7 @@ zod.z.object({
   after_seq: zod.z.number().int().optional(),
   limit: zod.z.number().int().positive().default(100)
 });
-zod.z.object({
+var JournalResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   events: zod.z.array(zod.z.object({
     seq: zod.z.number().int(),
@@ -698,7 +708,7 @@ zod.z.object({
     info: zod.z.record(zod.z.unknown())
   }))
 });
-zod.z.object({
+var PresenceAllListResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   machines: zod.z.array(zod.z.object({
     machine: zod.z.string(),
@@ -707,7 +717,7 @@ zod.z.object({
     active: zod.z.boolean()
   }))
 });
-zod.z.object({
+var PresenceHeartbeatSuccessResponseSchema = zod.z.object({
   ok: zod.z.literal(true)
 });
 zod.z.object({
@@ -849,7 +859,7 @@ zod.z.object({
   slot: zod.z.string().min(1),
   metadata: zod.z.record(zod.z.unknown()).default({})
 });
-zod.z.object({
+var EntityArtifactReferenceListResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   references: zod.z.array(zod.z.object({
     entity_id: zod.z.string(),
@@ -859,6 +869,46 @@ zod.z.object({
     created_at: zod.z.number().int()
   }))
 });
+function parseTagFilter(raw) {
+  if (!raw)
+    return void 0;
+  const parts = raw.split(",").map((s) => s.trim().toLowerCase()).filter((s) => s.length > 0);
+  if (parts.length === 0)
+    return void 0;
+  for (const part of parts) {
+    TagSchema.parse(part);
+  }
+  const unique = [...new Set(parts)];
+  if (unique.length > 20) {
+    throw new zod.z.ZodError([
+      {
+        code: zod.z.ZodIssueCode.too_big,
+        maximum: 20,
+        type: "array",
+        inclusive: true,
+        exact: false,
+        message: "tag_filter may not have more than 20 tags",
+        path: ["tag_filter"]
+      }
+    ]);
+  }
+  return unique;
+}
+var tagFilterQueryParam = zod.z.string().optional().superRefine((v, ctx) => {
+  if (!v)
+    return;
+  try {
+    parseTagFilter(v);
+  } catch (err) {
+    if (err instanceof zod.z.ZodError) {
+      for (const issue of err.issues) {
+        ctx.addIssue(issue);
+      }
+    } else {
+      throw err;
+    }
+  }
+}).transform((v) => parseTagFilter(v));
 zod.z.object({
   ok: zod.z.literal(true),
   results: zod.z.array(ArtifactSearchResultSchema),
@@ -869,7 +919,8 @@ zod.z.object({
   kind: zod.z.string().optional(),
   resource: zod.z.string().optional(),
   source_only: zod.z.string().optional().transform((v) => v === "true").pipe(zod.z.boolean()),
-  limit: zod.z.string().optional().default("20").transform((v) => Number.parseInt(v, 10)).pipe(zod.z.number().int().min(1).max(100))
+  limit: zod.z.string().optional().default("20").transform((v) => Number.parseInt(v, 10)).pipe(zod.z.number().int().min(1).max(100)),
+  tag_filter: tagFilterQueryParam
 });
 var ArtifactGrepLineSchema = zod.z.object({
   line: zod.z.number().int(),
@@ -887,7 +938,7 @@ var ArtifactGrepResultSchema = zod.z.object({
   truncated: zod.z.boolean().optional()
   // this blob hit the per-blob byte cap
 });
-zod.z.object({
+var ArtifactGrepResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   results: zod.z.array(ArtifactGrepResultSchema),
   scanned: zod.z.number().int(),
@@ -923,16 +974,18 @@ zod.z.object({
 });
 zod.z.object({
   q: zod.z.string().min(1).max(200),
-  limit: zod.z.string().optional().default("20").transform((v) => Number.parseInt(v, 10)).pipe(zod.z.number().int().min(1).max(100))
+  limit: zod.z.string().optional().default("20").transform((v) => Number.parseInt(v, 10)).pipe(zod.z.number().int().min(1).max(100)),
+  tag_filter: tagFilterQueryParam
 });
 zod.z.object({
   content: zod.z.string().min(1),
   kind: zod.z.string().min(1),
   mime_type: zod.z.string().default("text/markdown"),
   resource: zod.z.string().optional(),
-  fence: zod.z.number().int().optional()
+  fence: zod.z.number().int().optional(),
+  tags: TagsSchema.optional()
 });
-zod.z.object({
+var ArtifactPutResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   key: zod.z.string(),
   bytes: zod.z.number(),
@@ -951,7 +1004,8 @@ zod.z.object({
     produced_at: zod.z.number(),
     produced_by: zod.z.string(),
     expires_at: zod.z.number().nullable(),
-    tombstoned: zod.z.number()
+    tombstoned: zod.z.number(),
+    tags: zod.z.array(zod.z.string())
   }))
 });
 zod.z.object({
@@ -1038,12 +1092,15 @@ var RecordItemSchema = zod.z.object({
   updated_by: zod.z.string(),
   tags: zod.z.array(zod.z.string())
 });
-zod.z.object({
+RecordItemSchema.extend({
+  fence: zod.z.number().int()
+});
+var RecordGetResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   record: RecordItemSchema,
   fence: zod.z.number().int()
 });
-zod.z.object({
+var RecordMutateResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   record: RecordItemSchema,
   fence: zod.z.number().int(),
@@ -1058,7 +1115,7 @@ var RecordListItemSchema = zod.z.object({
   archived: zod.z.number().int(),
   tags: zod.z.array(zod.z.string())
 });
-zod.z.object({
+var RecordListResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   items: zod.z.array(RecordListItemSchema),
   meta: zod.z.object({
@@ -1078,9 +1135,12 @@ var RecordHistoryItemSchema = zod.z.object({
   source_artifact_key: zod.z.string().nullable(),
   actor: zod.z.string(),
   created_at: zod.z.number().int(),
-  message: zod.z.string().nullable()
+  message: zod.z.string().nullable(),
+  // Populated only when the history is requested with `includeValues=true`
+  // (wire: `?values=true`). Optional so existing parsers stay compatible.
+  value: zod.z.record(zod.z.unknown()).optional()
 });
-zod.z.object({
+var RecordHistoryResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   items: zod.z.array(RecordHistoryItemSchema),
   meta: zod.z.object({
@@ -1190,392 +1250,208 @@ zod.z.object({
 zod.z.object({
   resolution: zod.z.string().optional()
 });
-zod.z.object({
+var GateResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   gate: GateSchema
 });
-zod.z.object({
+var GateListResponseSchema = zod.z.object({
   ok: zod.z.literal(true),
   gates: zod.z.array(GateSchema)
 });
 
-// src/client.ts
-var require2 = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
-var SDK_VERSION = require2("../package.json").version;
-var TilaClient = class _TilaClient {
-  baseUrl;
-  token;
-  validate;
-  timeoutMs;
-  extraHeaders;
-  constructor(opts) {
-    this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
-    this.token = opts.token;
-    this.validate = opts.validate ?? false;
-    this.timeoutMs = opts.timeoutMs ?? 3e4;
-    this.extraHeaders = {
-      "X-Tila-Source": `sdk/${SDK_VERSION}`,
-      ...opts.extraHeaders
-    };
-  }
-  /**
-   * Creates an AbortSignal that fires after this.timeoutMs.
-   * Uses AbortSignal.timeout() when available (Node 18.8+, Bun 0.5+, browsers),
-   * falls back to manual setTimeout + AbortController for older runtimes.
-   *
-   * Note: Cloudflare Workers has supported AbortSignal.timeout() since 2023;
-   * the fallback branch will never execute there.
-   */
-  createAbortSignal() {
-    if (typeof AbortSignal.timeout === "function") {
-      return AbortSignal.timeout(this.timeoutMs);
-    }
-    const controller = new AbortController();
-    setTimeout(
-      () => controller.abort(
-        new DOMException(
-          "The operation was aborted due to timeout",
-          "TimeoutError"
-        )
-      ),
-      this.timeoutMs
-    );
-    return controller.signal;
-  }
-  static fromConfig(config, token) {
-    if (!config.worker_url) {
-      throw new Error(
-        `Cannot create TilaClient: config has no worker_url. Use 'tila project create' or set backend = "cloudflare" in .tila/config.toml.`
+// src/artifacts.ts
+function createArtifactMethods(client, projectId) {
+  const base = `/projects/${projectId}/artifacts`;
+  return {
+    upload: Object.assign(
+      function upload(input, opts) {
+        if (input instanceof ReadableStream) {
+          if (!opts.mimeType) {
+            throw new TypeError(
+              "mimeType is required when uploading a ReadableStream. Pass opts.mimeType explicitly."
+            );
+          }
+          return new Response(input).arrayBuffer().then((bytes) => {
+            const uploadFile = new Blob([bytes], {
+              type: opts.mimeType
+            });
+            const formData2 = new FormData();
+            formData2.append("file", uploadFile);
+            formData2.append("kind", opts.kind);
+            formData2.append("mime_type", opts.mimeType);
+            if (opts.resource) formData2.append("resource", opts.resource);
+            if (opts.fence !== void 0)
+              formData2.append("fence", String(opts.fence));
+            if (opts.flavor) formData2.append("flavor", opts.flavor);
+            if (opts.tags !== void 0)
+              formData2.append("tags", JSON.stringify(opts.tags));
+            return client.postFormData(base, formData2);
+          });
+        }
+        const contentType = opts.mimeType || (input instanceof File ? input.type : "") || "";
+        if (!contentType) {
+          throw new TypeError(
+            "contentType is required for uploads when file.type is absent. Pass opts.mimeType explicitly."
+          );
+        }
+        const formData = new FormData();
+        formData.append("file", input);
+        formData.append("kind", opts.kind);
+        formData.append("mime_type", contentType);
+        if (opts.resource) formData.append("resource", opts.resource);
+        if (opts.fence !== void 0)
+          formData.append("fence", String(opts.fence));
+        if (opts.flavor) formData.append("flavor", opts.flavor);
+        if (opts.tags !== void 0)
+          formData.append("tags", JSON.stringify(opts.tags));
+        return client.postFormData(base, formData);
+      },
+      {}
+    ),
+    async download(key) {
+      const res = await client.requestRaw(
+        "GET",
+        `${base}/${encodeURIComponent(key)}`
       );
-    }
-    return new _TilaClient({ baseUrl: config.worker_url, token });
-  }
-  async request(method, path, opts) {
-    const url = new URL(path, `${this.baseUrl}/`);
-    if (opts?.query) {
-      for (const [key, value] of Object.entries(opts.query)) {
-        if (value !== void 0) {
-          url.searchParams.set(key, value);
+      return {
+        body: res.body ?? new ReadableStream(),
+        contentType: res.headers.get("content-type") || "application/octet-stream",
+        contentLength: res.headers.has("content-length") ? Number(res.headers.get("content-length")) : null
+      };
+    },
+    async list(query) {
+      const { tagFilter, ...rest } = query ?? {};
+      const q = { ...rest };
+      if (tagFilter?.length) q.tag_filter = tagFilter.join(",");
+      return client.get(base, { query: q });
+    },
+    async search(q, opts) {
+      const { tagFilter, ...rest } = opts ?? {};
+      const query = { q, ...rest };
+      if (tagFilter?.length) query.tag_filter = tagFilter.join(",");
+      return client.get(`${base}/search`, { query });
+    },
+    async grep(pattern, opts) {
+      const query = { pattern };
+      if (opts?.kind) query.kind = opts.kind;
+      if (opts?.resource) query.resource = opts.resource;
+      if (opts?.regex) query.regex = "true";
+      if (opts?.limit != null) query.limit = String(opts.limit);
+      return client.get(`${base}/grep`, { query });
+    },
+    async addRelationship(fromKey, toKeyOrUri, type, metadata) {
+      const isUri = toKeyOrUri.includes("://");
+      return client.post(
+        `${base}/${encodeURIComponent(fromKey)}/relationships`,
+        {
+          [isUri ? "to_uri" : "to_key"]: toKeyOrUri,
+          type,
+          metadata
         }
+      );
+    },
+    async listRelationships(key) {
+      return client.get(
+        `${base}/${encodeURIComponent(key)}/relationships`
+      );
+    },
+    async getLatest(kind, resource) {
+      let res;
+      try {
+        res = await client.requestRaw("GET", `${base}/latest`, {
+          query: { kind, resource }
+        });
+      } catch (err) {
+        if (err instanceof TilaApiError && err.status === 404) return null;
+        throw err;
       }
-    }
-    const headers = {
-      Authorization: `Bearer ${this.token}`,
-      Accept: "application/json",
-      ...this.extraHeaders
-    };
-    const init = {
-      method,
-      headers,
-      signal: this.createAbortSignal()
-    };
-    if (opts?.body !== void 0) {
-      headers["Content-Type"] = "application/json";
-      init.body = JSON.stringify(opts.body);
-    }
-    let res;
-    try {
-      res = await fetch(url.toString(), init);
-    } catch (err) {
-      if (err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError")) {
-        throw new Error(
-          `Request to ${url.origin} timed out after ${this.timeoutMs}ms`
+      const body = await res.json();
+      return body.pointer;
+    },
+    async writeText(content, opts) {
+      const body = {
+        content,
+        kind: opts.kind,
+        mime_type: opts.mimeType ?? "text/markdown",
+        resource: opts.resource,
+        fence: opts.fence
+      };
+      if (opts.tags !== void 0) body.tags = opts.tags;
+      return client.post(`${base}/text`, body);
+    },
+    async readText(key) {
+      const res = await client.requestRaw(
+        "GET",
+        `${base}/${encodeURIComponent(key)}`
+      );
+      const contentType = res.headers.get("content-type") || "application/octet-stream";
+      if (!contentType.startsWith("text/")) {
+        throw new TypeError(
+          `Artifact ${key} has MIME type ${contentType} \u2014 readText only supports text/* artifacts`
         );
       }
-      throw new Error(
-        `Network error connecting to ${url.origin}: ${err instanceof Error ? err.message : String(err)}`
-      );
-    }
-    if (!res.ok) {
-      await this.throwApiError(res);
-    }
-    const body = await res.json();
-    const shouldValidate = opts?.validate ?? this.validate;
-    if (shouldValidate && opts?.schema) {
-      const result = opts.schema.safeParse(body);
-      if (!result.success) {
-        const issues = result.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
-        throw new Error(
-          `Unexpected response shape from ${method} ${path}:
-${issues}`
-        );
-      }
-      return result.data;
-    }
-    return body;
-  }
-  async get(path, opts) {
-    return this.request("GET", path, {
-      schema: opts?.schema,
-      query: opts?.query,
-      validate: opts?.validate
-    });
-  }
-  async post(path, body, opts) {
-    return this.request("POST", path, {
-      body,
-      schema: opts?.schema,
-      validate: opts?.validate
-    });
-  }
-  async put(path, body, opts) {
-    return this.request("PUT", path, {
-      body,
-      schema: opts?.schema,
-      validate: opts?.validate
-    });
-  }
-  async patch(path, body, opts) {
-    return this.request("PATCH", path, {
-      body,
-      schema: opts?.schema,
-      validate: opts?.validate
-    });
-  }
-  async delete(path, opts) {
-    return this.request("DELETE", path, {
-      schema: opts?.schema,
-      validate: opts?.validate
-    });
-  }
-  async requestRaw(method, path, opts) {
-    const url = new URL(path, `${this.baseUrl}/`);
-    if (opts?.query) {
-      for (const [key, value] of Object.entries(opts.query)) {
-        if (value !== void 0) {
-          url.searchParams.set(key, value);
-        }
-      }
+      const text = await res.text();
+      return { content: text, mimeType: contentType };
     }
-    const headers = {
-      Authorization: `Bearer ${this.token}`,
-      ...this.extraHeaders
-    };
-    let res;
-    try {
-      res = await fetch(url.toString(), {
-        method,
-        headers,
-        signal: this.createAbortSignal()
+  };
+}
+
+// src/claims.ts
+function createClaimMethods(client, projectId) {
+  const base = `/projects/${projectId}/claims`;
+  return {
+    async acquire(resource, mode, ttlMs, opts) {
+      return client.post(`${base}/acquire`, {
+        resource,
+        mode,
+        ttl_ms: ttlMs,
+        ...opts
       });
-    } catch (err) {
-      if (err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError")) {
-        throw new Error(
-          `Request to ${url.origin} timed out after ${this.timeoutMs}ms`
-        );
-      }
-      throw new Error(
-        `Network error connecting to ${url.origin}: ${err instanceof Error ? err.message : String(err)}`
-      );
-    }
-    if (!res.ok) {
-      await this.throwApiError(res);
-    }
-    return res;
-  }
-  async postFormData(path, formData, opts) {
-    const url = new URL(path, `${this.baseUrl}/`);
-    const headers = {
-      Authorization: `Bearer ${this.token}`,
-      Accept: "application/json",
-      ...this.extraHeaders
-    };
-    let res;
-    try {
-      res = await fetch(url.toString(), {
-        method: "POST",
-        headers,
-        body: formData,
-        signal: this.createAbortSignal()
+    },
+    async renew(resource, fence, ttlMs) {
+      return client.post(`${base}/renew`, {
+        resource,
+        fence,
+        ttl_ms: ttlMs
       });
-    } catch (err) {
-      if (err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError")) {
-        throw new Error(
-          `Request to ${url.origin} timed out after ${this.timeoutMs}ms`
-        );
-      }
-      throw new Error(
-        `Network error connecting to ${url.origin}: ${err instanceof Error ? err.message : String(err)}`
+    },
+    async release(resource, fence) {
+      return client.post(`${base}/release`, {
+        resource,
+        fence
+      });
+    },
+    async list() {
+      return client.get(base);
+    },
+    async get(resource) {
+      return client.get(
+        `${base}/${encodeURIComponent(resource)}`
       );
     }
-    if (!res.ok) {
-      await this.throwApiError(res);
-    }
-    const body = await res.json();
-    const shouldValidate = opts?.validate ?? this.validate;
-    if (shouldValidate && opts?.schema) {
-      const result = opts.schema.safeParse(body);
-      if (!result.success) {
-        const issues = result.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
-        throw new Error(
-          `Unexpected response shape from POST ${path}:
-${issues}`
-        );
-      }
-      return result.data;
-    }
-    return body;
-  }
-  async throwApiError(res) {
-    try {
-      const body = await res.json();
-      const parsed = ErrorEnvelopeSchema.safeParse(body);
-      if (parsed.success) {
-        const { code, message, retryable } = parsed.data.error;
-        throw new TilaApiError(res.status, code, message, retryable);
-      }
-    } catch (err) {
-      if (err instanceof TilaApiError) throw err;
-    }
-    throw new TilaApiError(
-      res.status,
-      "UNKNOWN",
-      `HTTP ${res.status}: ${res.statusText}`,
-      false
-    );
-  }
-};
-var TilaApiError = class extends Error {
-  constructor(status, code, message, retryable) {
-    super(message);
-    this.status = status;
-    this.code = code;
-    this.retryable = retryable;
-    this.name = "TilaApiError";
-  }
-  status;
-  code;
-  retryable;
-};
-function isTilaApiError(err) {
-  return err instanceof TilaApiError;
-}
-async function exchangeGitHubToken(baseUrl, projectId, githubToken) {
-  const url = `${baseUrl.replace(/\/+$/, "")}/api/auth/github/exchange`;
-  let res;
-  try {
-    res = await fetch(url, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        project_id: projectId,
-        github_token: githubToken
-      })
-    });
-  } catch (err) {
-    throw new Error(
-      `Network error during GitHub token exchange: ${err instanceof Error ? err.message : String(err)}`
-    );
-  }
-  if (!res.ok) {
-    try {
-      const body2 = await res.json();
-      const parsed = ErrorEnvelopeSchema.safeParse(body2);
-      if (parsed.success) {
-        const { code, message, retryable } = parsed.data.error;
-        throw new TilaApiError(res.status, code, message, retryable);
-      }
-    } catch (err) {
-      if (err instanceof TilaApiError) throw err;
-    }
-    throw new TilaApiError(
-      res.status,
-      "UNKNOWN",
-      `HTTP ${res.status}: ${res.statusText}`,
-      false
-    );
-  }
-  const body = await res.json();
-  if (!body.session_token || typeof body.expires_at !== "number") {
-    throw new TypeError(
-      "Exchange returned unexpected response shape: missing session_token or expires_at"
-    );
-  }
-  return {
-    sessionToken: body.session_token,
-    expiresAt: body.expires_at,
-    permission: body.permission ?? "read"
   };
 }
 
-// src/retry.ts
-async function withRetry(fn, opts) {
-  const maxRetries = opts?.maxRetries ?? 3;
-  const baseDelayMs = opts?.baseDelayMs ?? 200;
-  const maxDelayMs = opts?.maxDelayMs ?? 3e4;
-  const jitter = opts?.jitter ?? true;
-  for (let attempt = 0; attempt <= maxRetries; attempt++) {
-    try {
-      return await fn();
-    } catch (err) {
-      if (isTilaApiError(err) && err.retryable === false) {
-        throw err;
-      }
-      if (attempt === maxRetries) {
-        throw err;
-      }
-      const cap = Math.min(maxDelayMs, baseDelayMs * 2 ** attempt);
-      const sleepMs = jitter ? Math.random() * cap : cap;
-      await new Promise((resolve) => setTimeout(resolve, sleepMs));
-    }
-  }
-  throw new Error("withRetry: unreachable");
-}
-
-// src/error-codes.ts
-var TILA_ERRORS = {
-  // Auth / middleware (worker layer — SCREAMING_SNAKE_CASE wire values)
-  UNAUTHORIZED: "UNAUTHORIZED",
-  SESSION_EXPIRED: "SESSION_EXPIRED",
-  RATE_LIMITED: "RATE_LIMITED",
-  PERMISSION_DENIED: "PERMISSION_DENIED",
-  PROJECT_MISMATCH: "PROJECT_MISMATCH",
-  CSRF_MISSING_ORIGIN: "CSRF_MISSING_ORIGIN",
-  CSRF_ORIGIN_MISMATCH: "CSRF_ORIGIN_MISMATCH",
-  INTERNAL_ERROR: "INTERNAL_ERROR",
-  DO_UNREACHABLE: "do-unreachable",
-  // Auth endpoint specific
-  REPO_NOT_ALLOWED: "REPO_NOT_ALLOWED",
-  GITHUB_AUTH_FAILED: "GITHUB_AUTH_FAILED",
-  HMAC_NOT_CONFIGURED: "HMAC_NOT_CONFIGURED",
-  // Token endpoint specific
-  TOKEN_NAME_CONFLICT: "TOKEN_NAME_CONFLICT",
-  TOKEN_AUTHZ_DENIED: "TOKEN_AUTHZ_DENIED",
-  TOKEN_NOT_FOUND: "TOKEN_NOT_FOUND",
-  // Validation (worker layer uses SCREAMING_SNAKE for this code)
-  VALIDATION_ERROR: "VALIDATION_ERROR",
-  // DO errors (project-do-router — kebab-case wire values)
-  STALE_FENCE: "stale-fence",
-  NOT_FOUND: "not-found",
-  GATE_ALREADY_SETTLED: "gate-already-settled",
-  NO_FENCE: "no-fence",
-  INTERNAL: "internal",
-  CONSTRAINT_VIOLATION: "constraint-violation",
-  IDEMPOTENCY_KEY_CONFLICT: "idempotency-key-conflict",
-  // DO-layer validation uses kebab-case (distinct from VALIDATION_ERROR above)
-  VALIDATION_ERROR_DO: "validation-error",
-  ALREADY_HELD: "already-held",
-  RENEW_FAILED: "renew-failed",
-  BAD_REQUEST: "bad-request",
-  MISSING_QUERY: "missing-query",
-  INVALID_QUERY: "invalid-query",
-  INVALID_SLOT: "invalid-slot",
-  INVALID_RELATIONSHIP_TYPE: "invalid-relationship-type",
-  // Fallback (SDK-generated when response is unparseable)
-  UNKNOWN: "UNKNOWN"
-};
-
 // src/entities.ts
 function _createMethods(client, base) {
   return {
-    async create(id, type, data) {
-      return client.post(base, { id, type, data });
+    async create(id, type, data, tags) {
+      return client.post(base, {
+        id,
+        type,
+        data,
+        ...tags !== void 0 ? { tags } : {}
+      });
     },
     async get(id) {
       return client.get(`${base}/${id}`);
     },
     async list(query) {
-      return client.get(base, { query });
+      const { tagFilter, compact, ...rest } = query ?? {};
+      const q = { ...rest };
+      if (tagFilter?.length) q.tag_filter = tagFilter.join(",");
+      if (compact) q.compact = "true";
+      return client.get(base, { query: q });
     },
     async update(id, data, fence) {
       return client.patch(`${base}/${id}`, { data, fence });
@@ -1587,13 +1463,34 @@ function _createMethods(client, base) {
     },
     async addRelationship(fromId, toId, type) {
       return client.post(
-        `${base}/${fromId}/relationships`,
+        `${base}/relationships`,
         {
+          from_id: fromId,
           to_id: toId,
           type
         }
       );
     },
+    async listRelationships(filter) {
+      const query = {
+        from_id: filter?.fromId,
+        to_id: filter?.toId,
+        type: filter?.type
+      };
+      return client.get(
+        `${base}/relationships`,
+        { query }
+      );
+    },
+    async ready(query) {
+      const q = {
+        type: query?.type,
+        parent: query?.parent,
+        limit: query?.limit !== void 0 ? String(query.limit) : void 0
+      };
+      if (query?.includeSoftBlocked) q["include-soft-blocked"] = "true";
+      return client.get(`${base}/ready`, { query: q });
+    },
     async addArtifactRef(entityId, artifactKey, slot, metadata) {
       return client.post(`${base}/${entityId}/artifact-refs`, {
         artifact_key: artifactKey,
@@ -1608,366 +1505,663 @@ function _createMethods(client, base) {
     }
   };
 }
-function createTaskMethods(client, projectId) {
-  return _createMethods(client, `/projects/${projectId}/tasks`);
-}
-function createEntityMethods(client, projectId) {
-  return _createMethods(client, `/projects/${projectId}/entities`);
-}
-function createWorkUnitMethods(client, projectId) {
-  return _createMethods(client, `/projects/${projectId}/work-units`);
-}
+function createTaskMethods(client, projectId) {
+  return _createMethods(client, `/projects/${projectId}/tasks`);
+}
+function createEntityMethods(client, projectId) {
+  return _createMethods(client, `/projects/${projectId}/entities`);
+}
+function createWorkUnitMethods(client, projectId) {
+  return _createMethods(client, `/projects/${projectId}/work-units`);
+}
+
+// src/gates.ts
+function createGateMethods(client, projectId) {
+  const base = `/projects/${projectId}/gates`;
+  return {
+    /** List gates with optional filters. GET /projects/:id/gates */
+    async list(query) {
+      return client.get(base, { query });
+    },
+    /** Create a new gate. POST /projects/:id/gates */
+    async create(req) {
+      return client.post(base, req);
+    },
+    /** Resolve a gate. POST /projects/:id/gates/:gateId/resolve */
+    async resolve(gateId, req) {
+      return client.post(`${base}/${gateId}/resolve`, req ?? {});
+    },
+    /** Delete a gate. DELETE /projects/:id/gates/:gateId */
+    async remove(gateId) {
+      return client.delete(`${base}/${gateId}`);
+    }
+  };
+}
+
+// src/journal.ts
+function createJournalMethods(client, projectId) {
+  const base = `/projects/${projectId}/journal`;
+  return {
+    async query(opts) {
+      return client.get(base, {
+        query: {
+          resource: opts?.resource,
+          kind: opts?.kind,
+          after_seq: opts?.after_seq,
+          limit: opts?.limit
+        }
+      });
+    }
+  };
+}
+
+// src/presence.ts
+function createPresenceMethods(client, projectId) {
+  const base = `/projects/${projectId}/presence`;
+  return {
+    async heartbeat(machine, info) {
+      return client.post(
+        `${base}/heartbeat`,
+        {
+          machine,
+          info: info ?? {}
+        }
+      );
+    },
+    async list() {
+      return client.get(base);
+    },
+    /**
+     * List all presence records across all machines, including whether each is active.
+     * Hits GET /projects/:projectId/presence/all
+     */
+    async listAll() {
+      return client.get(`${base}/all`);
+    }
+  };
+}
+
+// src/records.ts
+function encodeKey(key) {
+  return key.split("/").map(encodeURIComponent).join("/");
+}
+function createRecordMethods(client, projectId) {
+  const base = `/projects/${projectId}/records`;
+  return {
+    async create(type, req) {
+      return client.post(`${base}/${type}`, req);
+    },
+    async set(type, key, req) {
+      return client.put(
+        `${base}/${type}/${encodeKey(key)}`,
+        req
+      );
+    },
+    async get(type, key) {
+      return client.get(`${base}/${type}/${encodeKey(key)}`);
+    },
+    async patch(type, key, req) {
+      return client.patch(
+        `${base}/${type}/${encodeKey(key)}`,
+        req
+      );
+    },
+    async archive(type, key, req) {
+      return client.post(
+        `${base}/${type}/~/archive/${encodeKey(key)}`,
+        req
+      );
+    },
+    async unarchive(type, key, req) {
+      return client.post(
+        `${base}/${type}/~/unarchive/${encodeKey(key)}`,
+        req
+      );
+    },
+    async history(type, key, opts) {
+      const query = {};
+      if (opts?.limit !== void 0) query.limit = String(opts.limit);
+      if (opts?.values !== void 0) query.values = String(opts.values);
+      return client.get(
+        `${base}/${type}/~/history/${encodeKey(key)}`,
+        { query }
+      );
+    },
+    async list(type, query) {
+      const { tagFilter, ...rest } = query ?? {};
+      const q = { ...rest };
+      if (tagFilter?.length) q.tag_filter = tagFilter.join(",");
+      return client.get(`${base}/${type}`, { query: q });
+    },
+    async types() {
+      return client.get(`${base}/_types`);
+    },
+    async typesInUse() {
+      const raw = await client.get(`${base}/_types`);
+      return { ok: true, types: raw.in_use_types ?? [] };
+    }
+  };
+}
+
+// src/schema.ts
+function createSchemaMethods(client, projectId) {
+  const base = `/projects/${projectId}/schema`;
+  return {
+    async get() {
+      return client.get(base);
+    },
+    async apply(schema, strategy) {
+      const definition = typeof schema === "string" ? schema : JSON.stringify(schema);
+      return client.post(base, { definition, strategy });
+    },
+    async history(opts) {
+      return client.get(`${base}/history`, { query: opts });
+    }
+  };
+}
+
+// src/search.ts
+function createSearchMethods(client, projectId) {
+  const base = `/projects/${projectId}`;
+  return {
+    async search(q, opts) {
+      const query = { q };
+      if (opts?.limit !== void 0) query.limit = String(opts.limit);
+      if (opts?.tagFilter?.length) query.tag_filter = opts.tagFilter.join(",");
+      return client.get(`${base}/search`, { query });
+    }
+  };
+}
+
+// src/signals.ts
+function createSignalMethods(client, projectId) {
+  const base = `/projects/${projectId}/signals`;
+  return {
+    /** Fetch the signal inbox for the current token. GET /projects/:id/signals */
+    async inbox() {
+      return client.get(base);
+    },
+    /** Send a signal to a target. POST /projects/:id/signals/send */
+    async send(req) {
+      return client.post(`${base}/send`, req);
+    },
+    /** Acknowledge a signal. POST /projects/:id/signals/:signalId/ack */
+    async ack(signalId) {
+      return client.post(`${base}/${signalId}/ack`, {});
+    }
+  };
+}
+
+// src/summary.ts
+function createSummaryMethods(client, projectId) {
+  return {
+    /** Get project summary. GET /projects/:id/summary */
+    async get() {
+      return client.get(`/projects/${projectId}/summary`);
+    }
+  };
+}
+
+// src/templates.ts
+function createTemplateMethods(client, projectId) {
+  const base = `/projects/${projectId}/templates`;
+  return {
+    /** Instantiate an entity template. POST /projects/:id/templates/instantiate */
+    async instantiate(req) {
+      return client.post(
+        `${base}/instantiate`,
+        req
+      );
+    },
+    /** List available templates from the project schema. GET /projects/:id/templates */
+    async list() {
+      return client.get(base);
+    }
+  };
+}
 
-// src/claims.ts
-function createClaimMethods(client, projectId) {
-  const base = `/projects/${projectId}/claims`;
+// src/tokens.ts
+function createTokenMethods(client) {
+  const base = "/api/tokens";
   return {
-    async acquire(resource, mode, ttlMs, opts) {
-      return client.post(`${base}/acquire`, {
-        resource,
-        mode,
-        ttl_ms: ttlMs,
-        ...opts
-      });
-    },
-    async renew(resource, fence, ttlMs) {
-      return client.post(`${base}/renew`, {
-        resource,
-        fence,
-        ttl_ms: ttlMs
-      });
+    async issue(name, note) {
+      return client.post(base, { name, note });
     },
-    async release(resource, fence) {
-      return client.post(`${base}/release`, {
-        resource,
-        fence
-      });
+    async revoke(name) {
+      return client.delete(
+        `${base}/${encodeURIComponent(name)}`
+      );
     },
     async list() {
       return client.get(base);
-    },
-    async get(resource) {
-      return client.get(
-        `${base}/${encodeURIComponent(resource)}`
-      );
     }
   };
 }
 
-// src/artifacts.ts
-function createArtifactMethods(client, projectId) {
-  const base = `/projects/${projectId}/artifacts`;
-  return {
-    upload: Object.assign(
-      function upload(input, opts) {
-        if (input instanceof ReadableStream) {
-          if (!opts.mimeType) {
-            throw new TypeError(
-              "mimeType is required when uploading a ReadableStream. Pass opts.mimeType explicitly."
-            );
-          }
-          return new Response(input).arrayBuffer().then((bytes) => {
-            const uploadFile = new Blob([bytes], {
-              type: opts.mimeType
-            });
-            const formData2 = new FormData();
-            formData2.append("file", uploadFile);
-            formData2.append("kind", opts.kind);
-            formData2.append("mime_type", opts.mimeType);
-            if (opts.resource) formData2.append("resource", opts.resource);
-            if (opts.fence !== void 0)
-              formData2.append("fence", String(opts.fence));
-            if (opts.flavor) formData2.append("flavor", opts.flavor);
-            return client.postFormData(base, formData2);
-          });
-        }
-        const contentType = opts.mimeType || (input instanceof File ? input.type : "") || "";
-        if (!contentType) {
-          throw new TypeError(
-            "contentType is required for uploads when file.type is absent. Pass opts.mimeType explicitly."
-          );
+// src/version.ts
+var SDK_VERSION = "0.2.0";
+
+// src/client.ts
+var TilaClient = class _TilaClient {
+  baseUrl;
+  token;
+  validate;
+  timeoutMs;
+  extraHeaders;
+  constructor(opts) {
+    this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
+    this.token = opts.token;
+    this.validate = opts.validate ?? false;
+    this.timeoutMs = opts.timeoutMs ?? 3e4;
+    this.extraHeaders = {
+      "X-Tila-Source": `sdk/${SDK_VERSION}`,
+      ...opts.extraHeaders
+    };
+  }
+  /**
+   * Creates an AbortSignal that fires after this.timeoutMs.
+   * Uses AbortSignal.timeout() when available (Node 18.8+, Bun 0.5+, browsers),
+   * falls back to manual setTimeout + AbortController for older runtimes.
+   *
+   * Note: Cloudflare Workers has supported AbortSignal.timeout() since 2023;
+   * the fallback branch will never execute there.
+   */
+  createAbortSignal() {
+    if (typeof AbortSignal.timeout === "function") {
+      return AbortSignal.timeout(this.timeoutMs);
+    }
+    const controller = new AbortController();
+    setTimeout(
+      () => controller.abort(
+        new DOMException(
+          "The operation was aborted due to timeout",
+          "TimeoutError"
+        )
+      ),
+      this.timeoutMs
+    );
+    return controller.signal;
+  }
+  static fromConfig(config, token, opts) {
+    if (config.backend === "local") {
+      throw new Error(
+        `Cannot create an HTTP TilaClient for a local backend (backend = "local"). The local backend runs in-process on SQLite \u2014 use createTila(config) (which routes to the in-process backend) or import createTilaLocal from 'tila-sdk/local' directly.`
+      );
+    }
+    if (!config.worker_url) {
+      throw new Error(
+        `Cannot create TilaClient: config has no worker_url. Use 'tila project create' or set backend = "cloudflare" in .tila/config.toml.`
+      );
+    }
+    return new _TilaClient({
+      baseUrl: config.worker_url,
+      token,
+      // Optional caller attribution (e.g. mcp-server/<version>). When omitted,
+      // the constructor's default X-Tila-Source (sdk/<version>) applies.
+      ...opts?.extraHeaders ? { extraHeaders: opts.extraHeaders } : {}
+    });
+  }
+  async request(method, path, opts) {
+    const url = new URL(path, `${this.baseUrl}/`);
+    if (opts?.query) {
+      for (const [key, value] of Object.entries(opts.query)) {
+        if (value !== void 0) {
+          url.searchParams.set(key, value);
         }
-        const formData = new FormData();
-        formData.append("file", input);
-        formData.append("kind", opts.kind);
-        formData.append("mime_type", contentType);
-        if (opts.resource) formData.append("resource", opts.resource);
-        if (opts.fence !== void 0)
-          formData.append("fence", String(opts.fence));
-        if (opts.flavor) formData.append("flavor", opts.flavor);
-        return client.postFormData(base, formData);
-      },
-      {}
-    ),
-    async download(key) {
-      const res = await client.requestRaw(
-        "GET",
-        `${base}/${encodeURIComponent(key)}`
+      }
+    }
+    const headers = {
+      Authorization: `Bearer ${this.token}`,
+      Accept: "application/json",
+      ...this.extraHeaders
+    };
+    const init = {
+      method,
+      headers,
+      signal: this.createAbortSignal()
+    };
+    if (opts?.body !== void 0) {
+      headers["Content-Type"] = "application/json";
+      init.body = JSON.stringify(opts.body);
+    }
+    let res;
+    try {
+      res = await fetch(url.toString(), init);
+    } catch (err) {
+      if (err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError")) {
+        throw new Error(
+          `Request to ${url.origin} timed out after ${this.timeoutMs}ms`
+        );
+      }
+      throw new Error(
+        `Network error connecting to ${url.origin}: ${err instanceof Error ? err.message : String(err)}`
       );
-      return {
-        body: res.body ?? new ReadableStream(),
-        contentType: res.headers.get("content-type") || "application/octet-stream",
-        contentLength: res.headers.has("content-length") ? Number(res.headers.get("content-length")) : null
-      };
-    },
-    async list(query) {
-      return client.get(base, { query });
-    },
-    async search(q, opts) {
-      return client.get(`${base}/search`, {
-        query: { q, ...opts }
-      });
-    },
-    async grep(pattern, opts) {
-      const query = { pattern };
-      if (opts?.kind) query.kind = opts.kind;
-      if (opts?.resource) query.resource = opts.resource;
-      if (opts?.regex) query.regex = "true";
-      if (opts?.limit != null) query.limit = String(opts.limit);
-      return client.get(`${base}/grep`, { query });
-    },
-    async addRelationship(fromKey, toKeyOrUri, type, metadata) {
-      const isUri = toKeyOrUri.includes("://");
-      return client.post(
-        `${base}/${encodeURIComponent(fromKey)}/relationships`,
-        {
-          [isUri ? "to_uri" : "to_key"]: toKeyOrUri,
-          type,
-          metadata
+    }
+    if (!res.ok) {
+      await this.throwApiError(res);
+    }
+    const body = await res.json();
+    const shouldValidate = opts?.validate ?? this.validate;
+    if (shouldValidate && opts?.schema) {
+      const result = opts.schema.safeParse(body);
+      if (!result.success) {
+        const issues = result.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+        throw new Error(
+          `Unexpected response shape from ${method} ${path}:
+${issues}`
+        );
+      }
+      return result.data;
+    }
+    return body;
+  }
+  async get(path, opts) {
+    return this.request("GET", path, {
+      schema: opts?.schema,
+      query: opts?.query,
+      validate: opts?.validate
+    });
+  }
+  async post(path, body, opts) {
+    return this.request("POST", path, {
+      body,
+      schema: opts?.schema,
+      validate: opts?.validate
+    });
+  }
+  async put(path, body, opts) {
+    return this.request("PUT", path, {
+      body,
+      schema: opts?.schema,
+      validate: opts?.validate
+    });
+  }
+  async patch(path, body, opts) {
+    return this.request("PATCH", path, {
+      body,
+      schema: opts?.schema,
+      validate: opts?.validate
+    });
+  }
+  async delete(path, opts) {
+    return this.request("DELETE", path, {
+      schema: opts?.schema,
+      validate: opts?.validate
+    });
+  }
+  async requestRaw(method, path, opts) {
+    const url = new URL(path, `${this.baseUrl}/`);
+    if (opts?.query) {
+      for (const [key, value] of Object.entries(opts.query)) {
+        if (value !== void 0) {
+          url.searchParams.set(key, value);
         }
-      );
-    },
-    async listRelationships(key) {
-      return client.get(
-        `${base}/${encodeURIComponent(key)}/relationships`
-      );
-    },
-    async getLatest(kind, resource) {
-      const res = await client.requestRaw("GET", `${base}/latest`, {
-        query: { kind, resource }
+      }
+    }
+    const headers = {
+      Authorization: `Bearer ${this.token}`,
+      ...this.extraHeaders
+    };
+    let res;
+    try {
+      res = await fetch(url.toString(), {
+        method,
+        headers,
+        signal: this.createAbortSignal()
       });
-      if (res.status === 404) return null;
-      if (!res.ok) {
-        const body2 = await res.json().catch(() => ({}));
+    } catch (err) {
+      if (err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError")) {
         throw new Error(
-          `getLatest failed with status ${res.status}: ${JSON.stringify(body2)}`
+          `Request to ${url.origin} timed out after ${this.timeoutMs}ms`
         );
       }
-      const body = await res.json();
-      return body.pointer;
-    },
-    async writeText(content, opts) {
-      return client.post(`${base}/text`, {
-        content,
-        kind: opts.kind,
-        mime_type: opts.mimeType ?? "text/markdown",
-        resource: opts.resource,
-        fence: opts.fence
-      });
-    },
-    async readText(key) {
-      const res = await client.requestRaw(
-        "GET",
-        `${base}/${encodeURIComponent(key)}`
+      throw new Error(
+        `Network error connecting to ${url.origin}: ${err instanceof Error ? err.message : String(err)}`
       );
-      const contentType = res.headers.get("content-type") || "application/octet-stream";
-      if (!contentType.startsWith("text/")) {
-        throw new TypeError(
-          `Artifact ${key} has MIME type ${contentType} \u2014 readText only supports text/* artifacts`
+    }
+    if (!res.ok) {
+      await this.throwApiError(res);
+    }
+    return res;
+  }
+  async postFormData(path, formData, opts) {
+    const url = new URL(path, `${this.baseUrl}/`);
+    const headers = {
+      Authorization: `Bearer ${this.token}`,
+      Accept: "application/json",
+      ...this.extraHeaders
+    };
+    let res;
+    try {
+      res = await fetch(url.toString(), {
+        method: "POST",
+        headers,
+        body: formData,
+        signal: this.createAbortSignal()
+      });
+    } catch (err) {
+      if (err instanceof Error && (err.name === "AbortError" || err.name === "TimeoutError")) {
+        throw new Error(
+          `Request to ${url.origin} timed out after ${this.timeoutMs}ms`
         );
       }
-      const text = await res.text();
-      return { content: text, mimeType: contentType };
-    }
-  };
-}
-
-// src/tokens.ts
-function createTokenMethods(client) {
-  const base = "/api/tokens";
-  return {
-    async issue(name, note) {
-      return client.post(base, { name, note });
-    },
-    async revoke(name) {
-      return client.delete(
-        `${base}/${encodeURIComponent(name)}`
+      throw new Error(
+        `Network error connecting to ${url.origin}: ${err instanceof Error ? err.message : String(err)}`
       );
-    },
-    async list() {
-      return client.get(base);
     }
-  };
-}
-
-// src/journal.ts
-function createJournalMethods(client, projectId) {
-  const base = `/projects/${projectId}/journal`;
-  return {
-    async query(opts) {
-      return client.get(base, { query: opts });
+    if (!res.ok) {
+      await this.throwApiError(res);
     }
-  };
-}
-
-// src/presence.ts
-function createPresenceMethods(client, projectId) {
-  const base = `/projects/${projectId}/presence`;
-  return {
-    async heartbeat(machine, ttlMs) {
-      return client.post(base, {
-        machine,
-        ttl_ms: ttlMs
-      });
-    },
-    async list() {
-      return client.get(base);
-    },
-    /**
-     * List all presence records across all machines, including whether each is active.
-     * Hits GET /projects/:projectId/presence/all
-     */
-    async listAll() {
-      return client.get(`${base}/all`);
+    const body = await res.json();
+    const shouldValidate = opts?.validate ?? this.validate;
+    if (shouldValidate && opts?.schema) {
+      const result = opts.schema.safeParse(body);
+      if (!result.success) {
+        const issues = result.error.issues.map((i) => `  - ${i.path.join(".")}: ${i.message}`).join("\n");
+        throw new Error(
+          `Unexpected response shape from POST ${path}:
+${issues}`
+        );
+      }
+      return result.data;
     }
-  };
-}
-
-// src/records.ts
-function encodeKey(key) {
-  return key.split("/").map(encodeURIComponent).join("/");
+    return body;
+  }
+  async throwApiError(res) {
+    try {
+      const body = await res.json();
+      const parsed = ErrorEnvelopeSchema.safeParse(body);
+      if (parsed.success) {
+        const { code, message, retryable } = parsed.data.error;
+        throw new TilaApiError(res.status, code, message, retryable);
+      }
+    } catch (err) {
+      if (err instanceof TilaApiError) throw err;
+    }
+    throw new TilaApiError(
+      res.status,
+      "UNKNOWN",
+      `HTTP ${res.status}: ${res.statusText}`,
+      false
+    );
+  }
+};
+var TilaApiError = class extends Error {
+  constructor(status, code, message, retryable) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.retryable = retryable;
+    this.name = "TilaApiError";
+  }
+  status;
+  code;
+  retryable;
+};
+function isTilaApiError(err) {
+  return err instanceof TilaApiError;
 }
-function createRecordMethods(client, projectId) {
-  const base = `/projects/${projectId}/records`;
-  return {
-    async create(type, req) {
-      return client.post(`${base}/${type}`, req);
-    },
-    async set(type, key, req) {
-      return client.put(
-        `${base}/${type}/${encodeKey(key)}`,
-        req
-      );
-    },
-    async get(type, key) {
-      return client.get(`${base}/${type}/${encodeKey(key)}`);
-    },
-    async patch(type, key, req) {
-      return client.patch(
-        `${base}/${type}/${encodeKey(key)}`,
-        req
-      );
-    },
-    async archive(type, key, req) {
-      return client.post(
-        `${base}/${type}/~/archive/${encodeKey(key)}`,
-        req
-      );
-    },
-    async unarchive(type, key, req) {
-      return client.post(
-        `${base}/${type}/~/unarchive/${encodeKey(key)}`,
-        req
-      );
-    },
-    async history(type, key, opts) {
-      const query = {};
-      if (opts?.limit !== void 0) query.limit = String(opts.limit);
-      if (opts?.values !== void 0) query.values = String(opts.values);
-      return client.get(
-        `${base}/${type}/~/history/${encodeKey(key)}`,
-        { query }
-      );
-    },
-    async list(type, query) {
-      return client.get(`${base}/${type}`, { query });
-    },
-    async types() {
-      return client.get(`${base}/_types`);
-    },
-    async typesInUse() {
-      const raw = await client.get(`${base}/_types`);
-      return { ok: true, types: raw.in_use_types ?? [] };
+async function exchangeGitHubToken(baseUrl, projectId, githubToken) {
+  const url = `${baseUrl.replace(/\/+$/, "")}/api/auth/github/exchange`;
+  let res;
+  try {
+    res = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        project_id: projectId,
+        github_token: githubToken
+      })
+    });
+  } catch (err) {
+    throw new Error(
+      `Network error during GitHub token exchange: ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  if (!res.ok) {
+    try {
+      const body2 = await res.json();
+      const parsed = ErrorEnvelopeSchema.safeParse(body2);
+      if (parsed.success) {
+        const { code, message, retryable } = parsed.data.error;
+        throw new TilaApiError(res.status, code, message, retryable);
+      }
+    } catch (err) {
+      if (err instanceof TilaApiError) throw err;
     }
-  };
-}
-
-// src/schema.ts
-function createSchemaMethods(client, projectId) {
-  const base = `/projects/${projectId}/schema`;
+    throw new TilaApiError(
+      res.status,
+      "UNKNOWN",
+      `HTTP ${res.status}: ${res.statusText}`,
+      false
+    );
+  }
+  const body = await res.json();
+  if (!body.session_token || typeof body.expires_at !== "number") {
+    throw new TypeError(
+      "Exchange returned unexpected response shape: missing session_token or expires_at"
+    );
+  }
   return {
-    async get() {
-      return client.get(base);
-    },
-    async apply(schema, strategy) {
-      return client.post(`${base}/apply`, { schema, strategy });
-    },
-    async history(opts) {
-      return client.get(`${base}/history`, { query: opts });
-    }
+    sessionToken: body.session_token,
+    expiresAt: body.expires_at,
+    permission: body.permission ?? "read"
   };
 }
-
-// src/signals.ts
-function createSignalMethods(client, projectId) {
-  const base = `/projects/${projectId}/signals`;
+function buildHttpFacade(client, projectId) {
   return {
-    /** Fetch the signal inbox for the current token. GET /projects/:id/signals */
-    async inbox() {
-      return client.get(base);
-    },
-    /** Send a signal to a target. POST /projects/:id/signals/send */
-    async send(req) {
-      return client.post(`${base}/send`, req);
-    },
-    /** Acknowledge a signal. POST /projects/:id/signals/:signalId/ack */
-    async ack(signalId) {
-      return client.post(`${base}/${signalId}/ack`, {});
+    tasks: createTaskMethods(client, projectId),
+    records: createRecordMethods(client, projectId),
+    claims: createClaimMethods(client, projectId),
+    artifacts: createArtifactMethods(client, projectId),
+    gates: createGateMethods(client, projectId),
+    signals: createSignalMethods(client, projectId),
+    journal: createJournalMethods(client, projectId),
+    presence: createPresenceMethods(client, projectId),
+    schema: createSchemaMethods(client, projectId),
+    summary: createSummaryMethods(client, projectId),
+    search: createSearchMethods(client, projectId),
+    templates: createTemplateMethods(client, projectId),
+    tokens: createTokenMethods(client),
+    close: () => {
     }
   };
 }
-
-// src/gates.ts
-function createGateMethods(client, projectId) {
-  const base = `/projects/${projectId}/gates`;
-  return {
-    /** List gates with optional filters. GET /projects/:id/gates */
-    async list(query) {
-      return client.get(base, { query });
-    },
-    /** Create a new gate. POST /projects/:id/gates */
-    async create(req) {
-      return client.post(base, req);
-    },
-    /** Resolve a gate. POST /projects/:id/gates/:gateId/resolve */
-    async resolve(gateId, req) {
-      return client.post(`${base}/${gateId}/resolve`, req ?? {});
-    },
-    /** Delete a gate. DELETE /projects/:id/gates/:gateId */
-    async remove(gateId) {
-      return client.delete(`${base}/${gateId}`);
+async function createTila(config, token, opts) {
+  if (config.backend === "local") {
+    if (!config.local) {
+      throw new Error(
+        'createTila: backend = "local" requires a [local] config section with db_path and artifacts_path.'
+      );
     }
-  };
+    const { createTilaLocal, buildLocalResources } = await import('./local.js');
+    const { project, artifacts, close } = await createTilaLocal({
+      dbPath: config.local.db_path,
+      artifactsPath: config.local.artifacts_path,
+      org: config.local.org,
+      project: config.project_id
+    });
+    const resources = buildLocalResources(project, artifacts);
+    return { ...resources, close };
+  }
+  if (token === void 0) {
+    throw new Error(
+      'createTila: the Cloudflare backend requires a token. Pass createTila(config, token), or set backend = "local".'
+    );
+  }
+  const client = TilaClient.fromConfig(config, token, {
+    extraHeaders: opts?.extraHeaders
+  });
+  return buildHttpFacade(client, config.project_id);
 }
 
-// src/templates.ts
-function createTemplateMethods(client, projectId) {
-  const base = `/projects/${projectId}/templates`;
-  return {
-    /** Instantiate an entity template. POST /projects/:id/templates/instantiate */
-    async instantiate(req) {
-      return client.post(
-        `${base}/instantiate`,
-        req
-      );
-    },
-    /** List available templates from the project schema. GET /projects/:id/templates */
-    async list() {
-      return client.get(base);
+// src/retry.ts
+async function withRetry(fn, opts) {
+  const maxRetries = opts?.maxRetries ?? 3;
+  const baseDelayMs = opts?.baseDelayMs ?? 200;
+  const maxDelayMs = opts?.maxDelayMs ?? 3e4;
+  const jitter = opts?.jitter ?? true;
+  for (let attempt = 0; attempt <= maxRetries; attempt++) {
+    try {
+      return await fn();
+    } catch (err) {
+      if (isTilaApiError(err) && err.retryable === false) {
+        throw err;
+      }
+      if (attempt === maxRetries) {
+        throw err;
+      }
+      const cap = Math.min(maxDelayMs, baseDelayMs * 2 ** attempt);
+      const sleepMs = jitter ? Math.random() * cap : cap;
+      await new Promise((resolve) => setTimeout(resolve, sleepMs));
     }
-  };
+  }
+  throw new Error("withRetry: unreachable");
 }
 
+// src/error-codes.ts
+var TILA_ERRORS = {
+  // Auth / middleware (worker layer — SCREAMING_SNAKE_CASE wire values)
+  UNAUTHORIZED: "UNAUTHORIZED",
+  SESSION_EXPIRED: "SESSION_EXPIRED",
+  RATE_LIMITED: "RATE_LIMITED",
+  PERMISSION_DENIED: "PERMISSION_DENIED",
+  PROJECT_MISMATCH: "PROJECT_MISMATCH",
+  CSRF_MISSING_ORIGIN: "CSRF_MISSING_ORIGIN",
+  CSRF_ORIGIN_MISMATCH: "CSRF_ORIGIN_MISMATCH",
+  INTERNAL_ERROR: "INTERNAL_ERROR",
+  DO_UNREACHABLE: "do-unreachable",
+  // Auth endpoint specific
+  REPO_NOT_ALLOWED: "REPO_NOT_ALLOWED",
+  GITHUB_AUTH_FAILED: "GITHUB_AUTH_FAILED",
+  HMAC_NOT_CONFIGURED: "HMAC_NOT_CONFIGURED",
+  // Token endpoint specific
+  TOKEN_NAME_CONFLICT: "TOKEN_NAME_CONFLICT",
+  TOKEN_AUTHZ_DENIED: "TOKEN_AUTHZ_DENIED",
+  TOKEN_NOT_FOUND: "TOKEN_NOT_FOUND",
+  // Validation (worker layer uses SCREAMING_SNAKE for this code)
+  VALIDATION_ERROR: "VALIDATION_ERROR",
+  // DO errors (project-do-router — kebab-case wire values)
+  STALE_FENCE: "stale-fence",
+  NOT_FOUND: "not-found",
+  GATE_ALREADY_SETTLED: "gate-already-settled",
+  NO_FENCE: "no-fence",
+  INTERNAL: "internal",
+  CONSTRAINT_VIOLATION: "constraint-violation",
+  IDEMPOTENCY_KEY_CONFLICT: "idempotency-key-conflict",
+  // DO-layer validation uses kebab-case (distinct from VALIDATION_ERROR above)
+  VALIDATION_ERROR_DO: "validation-error",
+  ALREADY_HELD: "already-held",
+  RENEW_FAILED: "renew-failed",
+  BAD_REQUEST: "bad-request",
+  MISSING_QUERY: "missing-query",
+  INVALID_QUERY: "invalid-query",
+  INVALID_SLOT: "invalid-slot",
+  INVALID_RELATIONSHIP_TYPE: "invalid-relationship-type",
+  // Fallback (SDK-generated when response is unparseable)
+  UNKNOWN: "UNKNOWN"
+};
+
 // src/indexes.ts
 function createIndexMethods(client, projectId) {
   const base = `/projects/${projectId}/artifacts`;
@@ -2010,26 +2204,240 @@ function createIndexMethods(client, projectId) {
     }
   };
 }
-
-// src/summary.ts
-function createSummaryMethods(client, projectId) {
+
+// src/namespace-prefix.ts
+function validateNamespace(ns) {
+  if (!/^[a-z][a-z0-9_-]*$/.test(ns)) {
+    throw new TypeError(
+      `Invalid namespace "${ns}": must match /^[a-z][a-z0-9_-]*$/ (lowercase letter start, then lowercase letters, digits, underscores, or hyphens).`
+    );
+  }
+}
+function applyPrefix(ns, name) {
+  if (name.startsWith(`${ns}_`)) {
+    throw new Error(
+      `Namespace collision: "${name}" already starts with prefix "${ns}_". Call the raw factory if this name is intentional.`
+    );
+  }
+  return `${ns}_${name}`;
+}
+function stripPrefix(ns, name) {
+  const prefix = `${ns}_`;
+  if (name.startsWith(prefix)) {
+    return name.slice(prefix.length);
+  }
+  return name;
+}
+
+// src/namespace.ts
+function namespacedTaskMethods(client, projectId, ns) {
+  const inner = createTaskMethods(client, projectId);
+  return {
+    ...inner,
+    async create(id, type, data) {
+      const result = await inner.create(id, applyPrefix(ns, type), data);
+      return {
+        ...result,
+        entity: { ...result.entity, type: stripPrefix(ns, result.entity.type) }
+      };
+    },
+    async get(id) {
+      const result = await inner.get(id);
+      return {
+        ...result,
+        entity: { ...result.entity, type: stripPrefix(ns, result.entity.type) }
+      };
+    },
+    async update(id, data, fence) {
+      const result = await inner.update(id, data, fence);
+      return {
+        ...result,
+        entity: { ...result.entity, type: stripPrefix(ns, result.entity.type) }
+      };
+    },
+    async list(query) {
+      const prefixedQuery = query ? {
+        ...query,
+        type: query.type !== void 0 ? applyPrefix(ns, query.type) : void 0
+      } : void 0;
+      const result = await inner.list(prefixedQuery);
+      return {
+        ...result,
+        entities: result.entities.map((e) => ({
+          ...e,
+          type: stripPrefix(ns, e.type)
+        }))
+      };
+    }
+  };
+}
+function namespacedRecordMethods(client, projectId, ns) {
+  const inner = createRecordMethods(client, projectId);
+  function stripRecordType(result) {
+    return {
+      ...result,
+      record: { ...result.record, type: stripPrefix(ns, result.record.type) }
+    };
+  }
+  return {
+    async create(type, req) {
+      return stripRecordType(await inner.create(applyPrefix(ns, type), req));
+    },
+    async set(type, key, req) {
+      return stripRecordType(await inner.set(applyPrefix(ns, type), key, req));
+    },
+    async get(type, key) {
+      return stripRecordType(await inner.get(applyPrefix(ns, type), key));
+    },
+    async patch(type, key, req) {
+      return stripRecordType(
+        await inner.patch(applyPrefix(ns, type), key, req)
+      );
+    },
+    async archive(type, key, req) {
+      return stripRecordType(
+        await inner.archive(applyPrefix(ns, type), key, req)
+      );
+    },
+    async unarchive(type, key, req) {
+      return stripRecordType(
+        await inner.unarchive(applyPrefix(ns, type), key, req)
+      );
+    },
+    async history(type, key, opts) {
+      const result = await inner.history(applyPrefix(ns, type), key, opts);
+      return {
+        ...result,
+        items: result.items.map((item) => ({
+          ...item,
+          type: stripPrefix(ns, item.type)
+        }))
+      };
+    },
+    async list(type, query) {
+      const result = await inner.list(applyPrefix(ns, type), query);
+      return {
+        ...result,
+        items: result.items.map((item) => ({
+          ...item,
+          type: stripPrefix(ns, item.type)
+        }))
+      };
+    },
+    async types() {
+      const result = await inner.types();
+      return {
+        ...result,
+        types: result.types.map((t) => stripPrefix(ns, t))
+      };
+    },
+    async typesInUse() {
+      const result = await inner.typesInUse();
+      return {
+        ...result,
+        types: result.types.map((t) => stripPrefix(ns, t))
+      };
+    }
+  };
+}
+function namespacedArtifactMethods(client, projectId, ns) {
+  const inner = createArtifactMethods(client, projectId);
+  return {
+    ...inner,
+    upload(input, opts) {
+      return inner.upload(input, { ...opts, kind: applyPrefix(ns, opts.kind) });
+    },
+    async writeText(content, opts) {
+      return inner.writeText(content, {
+        ...opts,
+        kind: applyPrefix(ns, opts.kind)
+      });
+    },
+    async list(query) {
+      const prefixedQuery = query ? {
+        ...query,
+        kind: query.kind !== void 0 ? applyPrefix(ns, query.kind) : void 0
+      } : void 0;
+      const result = await inner.list(prefixedQuery);
+      return {
+        ...result,
+        pointers: result.pointers.map((p) => ({
+          ...p,
+          kind: stripPrefix(ns, p.kind)
+        }))
+      };
+    },
+    async search(q, opts) {
+      const prefixedOpts = opts ? {
+        ...opts,
+        kind: opts.kind !== void 0 ? applyPrefix(ns, opts.kind) : void 0
+      } : void 0;
+      const result = await inner.search(q, prefixedOpts);
+      return {
+        ...result,
+        results: result.results.map((r) => ({
+          ...r,
+          kind: stripPrefix(ns, r.kind)
+        }))
+      };
+    },
+    async grep(pattern, opts) {
+      const prefixedOpts = opts ? {
+        ...opts,
+        kind: opts.kind !== void 0 ? applyPrefix(ns, opts.kind) : void 0
+      } : void 0;
+      const result = await inner.grep(pattern, prefixedOpts);
+      return {
+        ...result,
+        results: result.results.map((r) => ({
+          ...r,
+          kind: stripPrefix(ns, r.kind)
+        }))
+      };
+    },
+    async getLatest(kind, resource) {
+      let pointer;
+      try {
+        pointer = await inner.getLatest(applyPrefix(ns, kind), resource);
+      } catch (err) {
+        if (err instanceof TilaApiError && err.status === 404) return null;
+        throw err;
+      }
+      if (pointer === null) return null;
+      return { ...pointer, kind: stripPrefix(ns, pointer.kind) };
+    }
+  };
+}
+function namespacedTemplateMethods(client, projectId, ns) {
+  const inner = createTemplateMethods(client, projectId);
   return {
-    /** Get project summary. GET /projects/:id/summary */
-    async get() {
-      return client.get(`/projects/${projectId}/summary`);
+    ...inner,
+    async instantiate(req) {
+      return inner.instantiate({
+        ...req,
+        template_name: applyPrefix(ns, req.template_name)
+      });
+    },
+    async list() {
+      const result = await inner.list();
+      return {
+        ...result,
+        templates: result.templates.map((t) => ({
+          ...t,
+          name: stripPrefix(ns, t.name),
+          type: stripPrefix(ns, t.type)
+        }))
+      };
     }
   };
 }
-
-// src/search.ts
-function createSearchMethods(client, projectId) {
-  const base = `/projects/${projectId}`;
+function createNamespace(client, projectId, ns) {
+  validateNamespace(ns);
   return {
-    async search(q, opts) {
-      const query = { q };
-      if (opts?.limit !== void 0) query.limit = String(opts.limit);
-      return client.get(`${base}/search`, { query });
-    }
+    tasks: namespacedTaskMethods(client, projectId, ns),
+    records: namespacedRecordMethods(client, projectId, ns),
+    artifacts: namespacedArtifactMethods(client, projectId, ns),
+    templates: namespacedTemplateMethods(client, projectId, ns)
   };
 }
 
@@ -2141,17 +2549,884 @@ async function withClaim(client, projectId, resource, mode, ttlMs, callback) {
     }
   }
 }
+var ArtifactPointerInternalSchema = zod.z.object({
+  r2_key: zod.z.string(),
+  resource: zod.z.string().nullable(),
+  kind: zod.z.string(),
+  sha256: zod.z.string(),
+  bytes: zod.z.number(),
+  mime_type: zod.z.string(),
+  produced_at: zod.z.number(),
+  produced_by: zod.z.string(),
+  expires_at: zod.z.number().nullable(),
+  tombstoned: zod.z.number()
+}).passthrough();
+var ArtifactListInternalSchema = zod.z.object({
+  ok: zod.z.literal(true),
+  pointers: zod.z.array(ArtifactPointerInternalSchema)
+});
+var OkSchema = zod.z.object({ ok: zod.z.literal(true) }).passthrough();
+var RecordTypesInternalSchema = zod.z.object({
+  ok: zod.z.literal(true),
+  types: zod.z.array(zod.z.string()),
+  in_use_types: zod.z.array(zod.z.string()).optional()
+});
+var SchemaShowResponseSchema = zod.z.object({
+  ok: zod.z.literal(true),
+  schema: zod.z.record(zod.z.unknown()).nullable(),
+  version: zod.z.number().int().nullable()
+});
+var SchemaApplyLenientSchema = zod.z.object({
+  ok: zod.z.literal(true),
+  version: zod.z.number().int().nullable().optional(),
+  changes: zod.z.array(zod.z.string()).optional(),
+  noChange: zod.z.boolean().optional()
+});
+var StateListInternalSchema = zod.z.object({
+  ok: zod.z.literal(true),
+  claims: zod.z.array(
+    zod.z.object({
+      resource: zod.z.string(),
+      machine: zod.z.string(),
+      user: zod.z.string(),
+      mode: zod.z.enum(["exclusive", "owner", "presence"]),
+      fence: zod.z.number(),
+      acquired_at: zod.z.number(),
+      expires_at: zod.z.number(),
+      metadata: zod.z.record(zod.z.unknown()).optional()
+    })
+  )
+});
+var ArtifactSearchResponseSchema2 = zod.z.object({
+  ok: zod.z.literal(true),
+  results: zod.z.array(
+    zod.z.object({
+      r2_key: zod.z.string(),
+      kind: zod.z.string(),
+      title: zod.z.string().nullable(),
+      snippet: zod.z.string().nullable()
+    }).passthrough()
+  )
+});
+var RelListResponseSchema = zod.z.object({
+  ok: zod.z.literal(true),
+  relationships: zod.z.array(
+    zod.z.object({
+      from_key: zod.z.string(),
+      to_key: zod.z.string().nullable(),
+      to_uri: zod.z.string().nullable(),
+      type: zod.z.string(),
+      created_at: zod.z.number()
+    }).passthrough()
+  )
+});
+var IndexEntriesResponseSchema = zod.z.object({
+  ok: zod.z.literal(true),
+  entries: zod.z.array(
+    zod.z.object({
+      r2_key: zod.z.string(),
+      resource: zod.z.string().nullable(),
+      kind: zod.z.string(),
+      sha256: zod.z.string(),
+      bytes: zod.z.number(),
+      mime_type: zod.z.string(),
+      produced_at: zod.z.number(),
+      produced_by: zod.z.string(),
+      expires_at: zod.z.number().nullable(),
+      tombstoned: zod.z.number(),
+      exists: zod.z.boolean()
+    })
+  )
+});
+var RemoteBackend = class {
+  constructor(client, projectId) {
+    this.client = client;
+    this.projectId = projectId;
+  }
+  client;
+  projectId;
+  // --- EntityBackend ---
+  async create(input) {
+    const body = {
+      id: input.id,
+      type: input.type,
+      data: input.data,
+      created_by: input.created_by
+    };
+    if (input.tags !== void 0) body.tags = input.tags;
+    const result = await this.client.post(
+      `/projects/${this.projectId}/tasks`,
+      body,
+      { schema: EntityResponseSchema, validate: true }
+    );
+    return result.entity;
+  }
+  async get(id) {
+    try {
+      const result = await this.client.get(
+        `/projects/${this.projectId}/tasks/${encodeURIComponent(id)}`,
+        { schema: EntityDetailResponseSchema, validate: true }
+      );
+      return result.entity;
+    } catch (err) {
+      if (err instanceof TilaApiError && err.status === 404) {
+        return null;
+      }
+      throw err;
+    }
+  }
+  async list(filter) {
+    const query = {};
+    if (filter?.type) query.type = filter.type;
+    if (filter?.archived !== void 0)
+      query.archived = String(filter.archived);
+    const DATA_FIELD_TO_QUERY_PARAM = {
+      parent_id: "parent"
+    };
+    if (filter?.dataFilter) {
+      for (const [key, value] of Object.entries(filter.dataFilter)) {
+        if (value !== void 0 && value !== null) {
+          const param = DATA_FIELD_TO_QUERY_PARAM[key] ?? key;
+          query[param] = String(value);
+        }
+      }
+    }
+    if (filter?.tagFilter?.length)
+      query.tag_filter = filter.tagFilter.join(",");
+    if (filter?.sort) query.sort = filter.sort;
+    if (filter?.order) query.order = filter.order;
+    if (filter?.limit !== void 0) query.limit = String(filter.limit);
+    if (filter?.offset !== void 0) query.offset = String(filter.offset);
+    const result = await this.client.get(`/projects/${this.projectId}/tasks`, {
+      schema: PaginatedEntityListResponseSchema,
+      validate: true,
+      query
+    });
+    return result.entities;
+  }
+  async update(id, data) {
+    const acquired = await this.acquire(id, "cli", "cli", "exclusive", 3e4);
+    try {
+      const result = await this.client.patch(
+        `/projects/${this.projectId}/tasks/${encodeURIComponent(id)}`,
+        { data, fence: acquired.fence },
+        { schema: EntityResponseSchema, validate: true }
+      );
+      return result.entity;
+    } finally {
+      try {
+        await this.release(id, acquired.fence);
+      } catch {
+      }
+    }
+  }
+  async archive(id) {
+    const acquired = await this.acquire(id, "cli", "cli", "exclusive", 3e4);
+    await this.client.post(
+      `/projects/${this.projectId}/tasks/${encodeURIComponent(id)}/archive`,
+      { fence: acquired.fence },
+      { schema: ArchiveSuccessResponseSchema, validate: true }
+    );
+  }
+  async addRelationship(input) {
+    const result = await this.client.post(
+      `/projects/${this.projectId}/tasks/relationships`,
+      { from_id: input.from_id, to_id: input.to_id, type: input.type },
+      { schema: CreateEntityRelationshipResponseSchema, validate: true }
+    );
+    return { created: result.created ?? true };
+  }
+  async listRelationships(filter) {
+    const query = {};
+    if (filter?.from_id) query.from_id = filter.from_id;
+    if (filter?.to_id) query.to_id = filter.to_id;
+    if (filter?.type) query.type = filter.type;
+    const result = await this.client.get(
+      `/projects/${this.projectId}/tasks/relationships`,
+      { schema: ListEntityRelationshipsResponseSchema, validate: true, query }
+    );
+    return result.relationships;
+  }
+  async removeRelationship(input) {
+    const params = new URLSearchParams({
+      from_id: input.from_id,
+      to_id: input.to_id,
+      type: input.type
+    });
+    const result = await this.client.delete(
+      `/projects/${this.projectId}/tasks/relationships?${params.toString()}`,
+      { schema: DeleteEntityRelationshipResponseSchema, validate: true }
+    );
+    return { removed: result.removed };
+  }
+  // GET /projects/:projectId/tasks/ready (worker entities.ts ~129 -> DO /entity/ready)
+  async listReady(filter) {
+    const query = {};
+    if (filter?.type) query.type = filter.type;
+    if (filter?.parent) query.parent = filter.parent;
+    if (filter?.limit !== void 0) query.limit = String(filter.limit);
+    if (filter?.includeSoftBlocked) query["include-soft-blocked"] = "true";
+    const result = await this.client.get(
+      `/projects/${this.projectId}/tasks/ready`,
+      { schema: ListReadyEntitiesResponseSchema, validate: true, query }
+    );
+    return result.entities.map((e) => ({ ...e, tags: [] }));
+  }
+  // Tree = compact list (GET /tasks?compact=true) + parent-child edges
+  // (GET /tasks/relationships?type=parent-child). The Worker has no dedicated
+  // tree endpoint; these are the two routes the DO/worker already expose.
+  async tree(_rootId) {
+    const listResult = await this.client.get(
+      `/projects/${this.projectId}/tasks`,
+      {
+        schema: PaginatedCompactEntityListResponseSchema,
+        validate: true,
+        query: { compact: "true" }
+      }
+    );
+    const relResult = await this.client.get(
+      `/projects/${this.projectId}/tasks/relationships`,
+      {
+        schema: ListEntityRelationshipsResponseSchema,
+        validate: true,
+        query: { type: "parent-child" }
+      }
+    );
+    return { nodes: listResult.entities, edges: relResult.relationships };
+  }
+  // PATCH /projects/:projectId/tasks/:id with a caller-supplied fence.
+  // Unlike update() (which auto-acquires), the caller owns the fence here, so a
+  // stale fence surfaces the Worker's fence-conflict error verbatim.
+  async updateWithFence(id, data, fence) {
+    const result = await this.client.patch(
+      `/projects/${this.projectId}/tasks/${encodeURIComponent(id)}`,
+      { data, fence },
+      { schema: EntityResponseSchema, validate: true }
+    );
+    return result.entity;
+  }
+  // POST /projects/:projectId/tasks/:entityId/artifact-refs (worker entities.ts ~264)
+  async addArtifactRef(input) {
+    const body = {
+      artifact_key: input.artifact_key,
+      slot: input.slot
+    };
+    if (input.metadata !== void 0) body.metadata = input.metadata;
+    await this.client.post(
+      `/projects/${this.projectId}/tasks/${encodeURIComponent(input.entity_id)}/artifact-refs`,
+      body,
+      { schema: OkSchema, validate: true }
+    );
+  }
+  // GET /projects/:projectId/tasks/:entityId/artifact-refs (worker entities.ts ~340)
+  async listArtifactRefs(entityId) {
+    const result = await this.client.get(
+      `/projects/${this.projectId}/tasks/${encodeURIComponent(entityId)}/artifact-refs`,
+      { schema: EntityArtifactReferenceListResponseSchema, validate: true }
+    );
+    return result.references;
+  }
+  // --- CoordinationBackend ---
+  async acquire(resource, machine, user, mode, ttlMs) {
+    const result = await this.client.post(
+      `/projects/${this.projectId}/claims/acquire`,
+      { resource, mode, ttl_ms: ttlMs },
+      { schema: AcquireSuccessResponseSchema, validate: true }
+    );
+    return {
+      acquired: true,
+      fence: result.fence,
+      expires_at: result.expires_at
+    };
+  }
+  async renew(resource, _machine, _user, fence, ttlMs) {
+    const result = await this.client.post(
+      `/projects/${this.projectId}/claims/renew`,
+      { resource, fence, ttl_ms: ttlMs },
+      { schema: RenewSuccessResponseSchema, validate: true }
+    );
+    return { renewed: true, expires_at: result.expires_at };
+  }
+  async release(resource, fence) {
+    await this.client.post(
+      `/projects/${this.projectId}/claims/release`,
+      { resource, fence },
+      { schema: ReleaseSuccessResponseSchema, validate: true }
+    );
+  }
+  async state(resource) {
+    const result = await this.client.get(
+      `/projects/${this.projectId}/claims/state/${encodeURIComponent(resource)}`,
+      { schema: StateResponseSchema, validate: true }
+    );
+    return result.claim ?? null;
+  }
+  async heartbeat(machine, info) {
+    await this.client.post(
+      `/projects/${this.projectId}/presence/heartbeat`,
+      { machine, info: info ?? {} },
+      { schema: PresenceHeartbeatSuccessResponseSchema, validate: true }
+    );
+  }
+  async listPresence() {
+    const result = await this.client.get(
+      `/projects/${this.projectId}/presence/all`,
+      { schema: PresenceAllListResponseSchema, validate: true }
+    );
+    return result.machines.map(({ machine, last_seen, info }) => ({
+      machine,
+      last_seen,
+      info
+    }));
+  }
+  async listClaims() {
+    const result = await this.client.get(`/projects/${this.projectId}/claims`, {
+      schema: StateListInternalSchema,
+      validate: true
+    });
+    return result.claims.map((c) => ({
+      resource: c.resource,
+      machine: c.machine,
+      user: c.user,
+      mode: c.mode,
+      fence: c.fence,
+      acquired_at: c.acquired_at,
+      expires_at: c.expires_at,
+      metadata: c.metadata ?? {}
+    }));
+  }
+  // --- JournalBackend ---
+  async listJournal(query) {
+    const result = await this.client.get(
+      `/projects/${this.projectId}/journal`,
+      {
+        schema: JournalResponseSchema,
+        validate: true,
+        query: {
+          resource: query.resource,
+          kind: query.kind,
+          limit: query.limit !== void 0 ? String(query.limit) : void 0
+        }
+      }
+    );
+    return result.events.map((ev) => ({
+      seq: ev.seq,
+      t: ev.t,
+      kind: ev.kind,
+      resource: ev.resource,
+      actor: ev.actor,
+      fence: ev.fence
+    }));
+  }
+  // --- GateBackend ---
+  async createGate(resource, awaitType, fence, timeoutAt) {
+    const body = {
+      resource,
+      await_type: awaitType,
+      fence
+    };
+    if (timeoutAt !== void 0) body.timeout_at = timeoutAt;
+    const result = await this.client.post(
+      `/projects/${this.projectId}/gates`,
+      body,
+      { schema: GateResponseSchema, validate: true }
+    );
+    return {
+      id: result.gate.id,
+      resource: result.gate.resource,
+      await_type: result.gate.await_type,
+      status: result.gate.status,
+      fence: result.gate.fence,
+      timeout_at: result.gate.timeout_at,
+      resolved_at: result.gate.resolved_at,
+      resolution: result.gate.resolution,
+      created_at: result.gate.created_at,
+      created_by: result.gate.created_by
+    };
+  }
+  async listGates(filter) {
+    const params = new URLSearchParams();
+    if (filter?.resource) params.set("resource", filter.resource);
+    if (filter?.status) params.set("status", filter.status);
+    const qs = params.toString();
+    const url = `/projects/${this.projectId}/gates${qs ? `?${qs}` : ""}`;
+    const result = await this.client.get(url, {
+      schema: GateListResponseSchema,
+      validate: true
+    });
+    return result.gates.map((g) => ({
+      id: g.id,
+      resource: g.resource,
+      await_type: g.await_type,
+      status: g.status,
+      fence: g.fence,
+      timeout_at: g.timeout_at,
+      resolved_at: g.resolved_at,
+      resolution: g.resolution,
+      created_at: g.created_at,
+      created_by: g.created_by
+    }));
+  }
+  async resolveGate(gateId, resolution) {
+    const body = {};
+    if (resolution) body.resolution = resolution;
+    await this.client.post(
+      `/projects/${this.projectId}/gates/${gateId}/resolve`,
+      body,
+      { schema: OkSchema, validate: true }
+    );
+  }
+  async cancelGate(gateId) {
+    await this.client.delete(`/projects/${this.projectId}/gates/${gateId}`, {
+      schema: OkSchema,
+      validate: true
+    });
+  }
+  // --- SignalBackend ---
+  async sendSignal(input, _createdBy) {
+    const body = {
+      target: input.target,
+      kind: input.kind
+    };
+    if (input.resource) body.resource = input.resource;
+    if (input.payload !== void 0) body.payload = input.payload;
+    if (input.ttl_ms !== void 0) body.ttl_ms = input.ttl_ms;
+    const result = await this.client.post(
+      `/projects/${this.projectId}/signals/send`,
+      body,
+      { schema: SendSignalResponseSchema, validate: true }
+    );
+    return { id: result.id };
+  }
+  async listSignals(_tokenName) {
+    const result = await this.client.get(
+      `/projects/${this.projectId}/signals`,
+      { schema: InboxResponseSchema, validate: true }
+    );
+    return result.signals.map((s) => ({
+      id: s.id,
+      target: s.target,
+      kind: s.kind,
+      resource: s.resource ?? null,
+      payload: s.payload,
+      created_by: s.created_by,
+      created_at: s.created_at,
+      expires_at: s.expires_at,
+      acked_at: s.acked_at
+    }));
+  }
+  async ackSignal(signalId) {
+    await this.client.post(
+      `/projects/${this.projectId}/signals/${signalId}/ack`,
+      {},
+      { schema: AckSignalResponseSchema, validate: true }
+    );
+    return { found: true };
+  }
+  // --- SchemaBackend ---
+  async getCurrentSchema() {
+    const result = await this.client.get(`/projects/${this.projectId}/schema`, {
+      schema: SchemaShowResponseSchema,
+      validate: true
+    });
+    return {
+      version: result.version,
+      definition: result.schema ? JSON.stringify(result.schema) : null
+    };
+  }
+  async applySchema(input) {
+    const body = {
+      definition: input.definition
+    };
+    if (input.strategy) body.strategy = input.strategy;
+    const result = await this.client.post(
+      `/projects/${this.projectId}/schema`,
+      body,
+      { schema: SchemaApplyLenientSchema, validate: true }
+    );
+    return {
+      ok: true,
+      version: result.version ?? null,
+      changes: result.changes ?? [],
+      noChange: result.noChange ?? false
+    };
+  }
+  // --- SummaryBackend ---
+  async getSummary() {
+    const result = await this.client.get(
+      `/projects/${this.projectId}/summary`,
+      { schema: SummaryResponseSchema, validate: true }
+    );
+    return result.project;
+  }
+};
+var RemoteArtifactBackend = class {
+  constructor(client, projectId) {
+    this.client = client;
+    this.projectId = projectId;
+  }
+  client;
+  projectId;
+  // --- ArtifactBackend ---
+  async put(options) {
+    let bodyBlob;
+    if (typeof options.body === "string") {
+      bodyBlob = new Blob([options.body], { type: options.contentType });
+    } else if (options.body instanceof ArrayBuffer) {
+      bodyBlob = new Blob([options.body], { type: options.contentType });
+    } else {
+      const arrayBuf = await new Response(options.body).arrayBuffer();
+      bodyBlob = new Blob([arrayBuf], { type: options.contentType });
+    }
+    const formData = new FormData();
+    formData.append("file", bodyBlob, options.key.split("/").pop() ?? "file");
+    if (options.kind) formData.append("kind", options.kind);
+    if (options.resource) formData.append("resource", options.resource);
+    if (options.fence !== void 0)
+      formData.append("fence", String(options.fence));
+    if (options.flavor) formData.append("flavor", options.flavor);
+    const result = await this.client.postFormData(
+      `/projects/${this.projectId}/artifacts`,
+      formData,
+      { schema: ArtifactPutResponseSchema, validate: true }
+    );
+    return { key: result.key, bytes: result.bytes };
+  }
+  async get(key) {
+    let response;
+    try {
+      response = await this.client.requestRaw(
+        "GET",
+        `/projects/${this.projectId}/artifacts/${encodeURIComponent(key)}`
+      );
+    } catch (err) {
+      if (err instanceof TilaApiError && err.status === 404) {
+        return null;
+      }
+      throw err;
+    }
+    if (response.status === 404) return null;
+    if (!response.ok) {
+      throw new TilaApiError(
+        response.status,
+        "artifact-get-failed",
+        `GET artifact ${key} failed: ${response.statusText}`,
+        false
+      );
+    }
+    return {
+      body: response.body,
+      contentType: response.headers.get("Content-Type") ?? "application/octet-stream",
+      metadata: {}
+    };
+  }
+  async list(prefix) {
+    const result = await this.client.get(
+      `/projects/${this.projectId}/artifacts`,
+      {
+        schema: ArtifactListInternalSchema,
+        validate: true,
+        query: { resource: prefix }
+      }
+    );
+    return result.pointers.map((p) => ({
+      key: p.r2_key,
+      size: p.bytes
+    }));
+  }
+  async delete(key) {
+    await this.client.delete(
+      `/projects/${this.projectId}/artifacts/${encodeURIComponent(key)}`,
+      {
+        schema: OkSchema,
+        validate: true
+      }
+    );
+  }
+  async listPointers(query) {
+    const q = {};
+    if (query.resource) q.resource = query.resource;
+    if (query.kind) q.kind = query.kind;
+    const result = await this.client.get(
+      `/projects/${this.projectId}/artifacts`,
+      {
+        schema: ArtifactListInternalSchema,
+        validate: true,
+        query: q
+      }
+    );
+    return result.pointers;
+  }
+  async addRelationship(fromKey, toKeyOrUri, type) {
+    const body = {
+      from_key: fromKey,
+      type
+    };
+    if (toKeyOrUri.to_key) body.to_key = toKeyOrUri.to_key;
+    if (toKeyOrUri.to_uri) body.to_uri = toKeyOrUri.to_uri;
+    await this.client.post(
+      `/projects/${this.projectId}/artifacts/relationship`,
+      body,
+      { schema: OkSchema, validate: true }
+    );
+  }
+  async listRelationships(key) {
+    const result = await this.client.get(
+      `/projects/${this.projectId}/artifacts/${encodeURIComponent(key)}/relationships`,
+      { schema: RelListResponseSchema, validate: true }
+    );
+    return result.relationships;
+  }
+  async searchArtifacts(query) {
+    const q = {
+      q: query.q
+    };
+    if (query.kind) q.kind = query.kind;
+    if (query.resource) q.resource = query.resource;
+    if (query.limit !== void 0) q.limit = String(query.limit);
+    const result = await this.client.get(
+      `/projects/${this.projectId}/artifacts/search`,
+      { schema: ArtifactSearchResponseSchema2, validate: true, query: q }
+    );
+    return result.results;
+  }
+  async grepArtifacts(query) {
+    const q = { pattern: query.pattern };
+    if (query.kind) q.kind = query.kind;
+    if (query.resource) q.resource = query.resource;
+    if (query.regex) q.regex = "true";
+    if (query.limit != null) q.limit = String(query.limit);
+    const result = await this.client.get(
+      `/projects/${this.projectId}/artifacts/grep`,
+      { schema: ArtifactGrepResponseSchema, validate: true, query: q }
+    );
+    return result;
+  }
+  async listIndexEntries(indexKey) {
+    const result = await this.client.get(
+      `/projects/${this.projectId}/artifacts/index/entries`,
+      {
+        schema: IndexEntriesResponseSchema,
+        validate: true,
+        query: { index_key: indexKey }
+      }
+    );
+    return result.entries;
+  }
+  async getLatest(kind, resource) {
+    let response;
+    try {
+      response = await this.client.requestRaw(
+        "GET",
+        `/projects/${this.projectId}/artifacts/latest`,
+        { query: { kind, resource } }
+      );
+    } catch (err) {
+      if (err instanceof TilaApiError && err.status === 404) {
+        return null;
+      }
+      throw err;
+    }
+    if (response.status === 404) return null;
+    if (!response.ok) {
+      throw new TilaApiError(
+        response.status,
+        "artifact-get-latest-failed",
+        `GET artifact latest failed: ${response.statusText}`,
+        false
+      );
+    }
+    const body = await response.json();
+    return body.pointer;
+  }
+  async writeText(content, opts) {
+    const result = await this.client.post(
+      `/projects/${this.projectId}/artifacts/text`,
+      {
+        content,
+        kind: opts.kind,
+        mime_type: opts.mimeType ?? "text/markdown",
+        resource: opts.resource,
+        fence: opts.fence
+      },
+      { schema: ArtifactPutResponseSchema, validate: true }
+    );
+    return { key: result.key, bytes: result.bytes };
+  }
+  async readText(key) {
+    let response;
+    try {
+      response = await this.client.requestRaw(
+        "GET",
+        `/projects/${this.projectId}/artifacts/${encodeURIComponent(key)}`
+      );
+    } catch (err) {
+      if (err instanceof TilaApiError && err.status === 404) {
+        return null;
+      }
+      throw err;
+    }
+    if (response.status === 404) return null;
+    const contentType = response.headers.get("content-type") || "application/octet-stream";
+    if (!contentType.startsWith("text/")) {
+      throw new TypeError(
+        `Artifact ${key} has MIME type ${contentType} \u2014 readText only supports text/* artifacts`
+      );
+    }
+    const text = await response.text();
+    return { content: text, mimeType: contentType };
+  }
+};
+var RemoteRecordBackend = class {
+  constructor(client, projectId) {
+    this.client = client;
+    this.projectId = projectId;
+  }
+  client;
+  projectId;
+  base() {
+    return `/projects/${this.projectId}/records`;
+  }
+  /** Encode a record key per-segment so embedded `/` separators are preserved. */
+  encodeKey(key) {
+    return key.split("/").map(encodeURIComponent).join("/");
+  }
+  async createRecord(input) {
+    const body = {
+      key: input.key,
+      value: input.value
+    };
+    if (input.tags) body.tags = input.tags;
+    if (input.message != null) body.message = input.message;
+    if (input.sourceArtifactKey != null)
+      body.source_artifact_key = input.sourceArtifactKey;
+    const result = await this.client.post(
+      `${this.base()}/${input.type}`,
+      body,
+      { schema: RecordMutateResponseSchema, validate: true }
+    );
+    return { ...result.record, fence: result.fence };
+  }
+  async setRecord(input) {
+    const body = {
+      value: input.value,
+      fence: input.fence
+    };
+    if (input.tags) body.tags = input.tags;
+    if (input.message != null) body.message = input.message;
+    if (input.sourceArtifactKey != null)
+      body.source_artifact_key = input.sourceArtifactKey;
+    const result = await this.client.put(
+      `${this.base()}/${input.type}/${this.encodeKey(input.key)}`,
+      body,
+      { schema: RecordMutateResponseSchema, validate: true }
+    );
+    return { ...result.record, fence: result.fence };
+  }
+  async getRecord(type, key) {
+    try {
+      const result = await this.client.get(
+        `${this.base()}/${type}/${this.encodeKey(key)}`,
+        { schema: RecordGetResponseSchema, validate: true }
+      );
+      return { ...result.record, fence: result.fence };
+    } catch (err) {
+      if (err instanceof TilaApiError && err.status === 404) {
+        return null;
+      }
+      throw err;
+    }
+  }
+  async patchRecord(input) {
+    const body = {
+      patch: input.patch,
+      fence: input.fence
+    };
+    if (input.message != null) body.message = input.message;
+    const result = await this.client.patch(
+      `${this.base()}/${input.type}/${this.encodeKey(input.key)}`,
+      body,
+      { schema: RecordMutateResponseSchema, validate: true }
+    );
+    return { ...result.record, fence: result.fence };
+  }
+  async archiveRecord(input) {
+    const body = { fence: input.fence };
+    if (input.message != null) body.message = input.message;
+    const result = await this.client.post(
+      `${this.base()}/${input.type}/~/archive/${this.encodeKey(input.key)}`,
+      body,
+      { schema: RecordMutateResponseSchema, validate: true }
+    );
+    return { ...result.record, fence: result.fence };
+  }
+  async unarchiveRecord(input) {
+    const body = { fence: input.fence };
+    if (input.message != null) body.message = input.message;
+    const result = await this.client.post(
+      `${this.base()}/${input.type}/~/unarchive/${this.encodeKey(input.key)}`,
+      body,
+      { schema: RecordMutateResponseSchema, validate: true }
+    );
+    return { ...result.record, fence: result.fence };
+  }
+  async listRecords(filter) {
+    const query = {};
+    if (filter.tag) query.tag = filter.tag;
+    if (filter.includeArchived) query["include-archived"] = "true";
+    if (filter.tagFilter?.length) query.tag_filter = filter.tagFilter.join(",");
+    if (filter.dataFilter) query.filter = JSON.stringify(filter.dataFilter);
+    if (filter.limit !== void 0) query.limit = String(filter.limit);
+    const result = await this.client.get(`${this.base()}/${filter.type}`, {
+      schema: RecordListResponseSchema,
+      validate: true,
+      query
+    });
+    return {
+      items: result.items,
+      total: result.meta.total,
+      next_cursor: result.meta.next_cursor
+    };
+  }
+  async listRecordHistory(type, key, opts) {
+    const query = {};
+    if (opts?.limit !== void 0) query.limit = String(opts.limit);
+    if (opts?.includeValues !== void 0)
+      query.values = String(opts.includeValues);
+    const result = await this.client.get(
+      `${this.base()}/${type}/~/history/${this.encodeKey(key)}`,
+      { schema: RecordHistoryResponseSchema, validate: true, query }
+    );
+    return {
+      items: result.items,
+      total: result.meta.total,
+      next_cursor: result.meta.next_cursor
+    };
+  }
+  async listRecordTypesInUse() {
+    const result = await this.client.get(`${this.base()}/_types`, {
+      schema: RecordTypesInternalSchema,
+      validate: true
+    });
+    return result.in_use_types ?? [];
+  }
+};
 
 exports.ClaimHandle = ClaimHandle;
+exports.RemoteArtifactBackend = RemoteArtifactBackend;
+exports.RemoteBackend = RemoteBackend;
+exports.RemoteRecordBackend = RemoteRecordBackend;
 exports.TILA_ERRORS = TILA_ERRORS;
 exports.TilaApiError = TilaApiError;
 exports.TilaClient = TilaClient;
+exports.applyPrefix = applyPrefix;
 exports.createArtifactMethods = createArtifactMethods;
 exports.createClaimMethods = createClaimMethods;
 exports.createEntityMethods = createEntityMethods;
 exports.createGateMethods = createGateMethods;
 exports.createIndexMethods = createIndexMethods;
 exports.createJournalMethods = createJournalMethods;
+exports.createNamespace = createNamespace;
 exports.createPresenceMethods = createPresenceMethods;
 exports.createRecordMethods = createRecordMethods;
 exports.createSchemaMethods = createSchemaMethods;
@@ -2160,9 +3435,12 @@ exports.createSignalMethods = createSignalMethods;
 exports.createSummaryMethods = createSummaryMethods;
 exports.createTaskMethods = createTaskMethods;
 exports.createTemplateMethods = createTemplateMethods;
+exports.createTila = createTila;
 exports.createTokenMethods = createTokenMethods;
 exports.createWorkUnitMethods = createWorkUnitMethods;
 exports.exchangeGitHubToken = exchangeGitHubToken;
 exports.isTilaApiError = isTilaApiError;
+exports.stripPrefix = stripPrefix;
+exports.validateNamespace = validateNamespace;
 exports.withClaim = withClaim;
 exports.withRetry = withRetry;