@treeseed/sdk 0.1.1 → 0.3.0

package/dist/model-registry.js

@@ -1,19 +1,52 @@
 import path from "node:path";
 import { resolveSdkRepoRoot } from "./runtime.js";
-function contentRoot() {
-  return process.env.TREESEED_AGENT_CONTENT_ROOT ? path.resolve(process.env.TREESEED_AGENT_CONTENT_ROOT) : path.resolve(resolveSdkRepoRoot(), "src", "content");
+import { validateModelFieldAliases } from "./sdk-fields.js";
+function contentRoot(repoRoot) {
+  return process.env.TREESEED_AGENT_CONTENT_ROOT ? path.resolve(process.env.TREESEED_AGENT_CONTENT_ROOT) : path.resolve(resolveSdkRepoRoot(repoRoot), "src", "content");
 }
-function buildModelRegistry() {
-  const root = contentRoot();
+function field(key, options = {}) {
+  return { key, ...options };
+}
+function deriveFieldLists(fields) {
+  const entries = Object.entries(fields);
+  return {
+    filterableFields: entries.filter(([, binding]) => binding.filterable).map(([key]) => key),
+    sortableFields: entries.filter(([, binding]) => binding.sortable).map(([key]) => key)
+  };
+}
+function graph(config) {
+  return config;
+}
+function buildBuiltinModelRegistry(repoRoot) {
+  const root = contentRoot(repoRoot);
   return {
     page: {
       name: "page",
       aliases: ["pages"],
       storage: "content",
       operations: ["get", "read", "search", "follow", "pick", "create", "update"],
-      filterableFields: ["title", "slug", "status", "audience", "updated"],
-      sortableFields: ["title", "updated"],
-      pickField: "updated",
+      graph: graph({
+        entityType: "Page",
+        titleField: "title",
+        enableSections: true
+      }),
+      fields: {
+        title: field("title", { filterable: true, sortable: true, contentKeys: ["title"], writeContentKey: "title" }),
+        slug: field("slug", { filterable: true, contentKeys: ["slug"], writeContentKey: "slug" }),
+        status: field("status", { filterable: true, contentKeys: ["status"], writeContentKey: "status" }),
+        audience: field("audience", { filterable: true, comparableAs: "string_array", contentKeys: ["audience"], writeContentKey: "audience" }),
+        updated_at: field("updated_at", { aliases: ["updated", "updatedAt"], filterable: true, sortable: true, comparableAs: "date", contentKeys: ["updated_at", "updated", "updatedAt"], writeContentKey: "updated_at" }),
+        created_at: field("created_at", { aliases: ["createdAt"], comparableAs: "date", contentKeys: ["created_at", "createdAt", "date"], writeContentKey: "created_at" })
+      },
+      ...deriveFieldLists({
+        title: field("title", { filterable: true, sortable: true, contentKeys: ["title"], writeContentKey: "title" }),
+        slug: field("slug", { filterable: true, contentKeys: ["slug"], writeContentKey: "slug" }),
+        status: field("status", { filterable: true, contentKeys: ["status"], writeContentKey: "status" }),
+        audience: field("audience", { filterable: true, comparableAs: "string_array", contentKeys: ["audience"], writeContentKey: "audience" }),
+        updated_at: field("updated_at", { aliases: ["updated", "updatedAt"], filterable: true, sortable: true, comparableAs: "date", contentKeys: ["updated_at", "updated", "updatedAt"], writeContentKey: "updated_at" }),
+        created_at: field("created_at", { aliases: ["createdAt"], comparableAs: "date", contentKeys: ["created_at", "createdAt", "date"], writeContentKey: "created_at" })
+      }),
+      pickField: "updated_at",
       contentCollection: "pages",
       contentDir: path.join(root, "pages")
     },
@@ -22,8 +55,22 @@ function buildModelRegistry() {
       aliases: ["notes"],
       storage: "content",
       operations: ["get", "read", "search", "follow", "pick", "create", "update"],
-      filterableFields: ["title", "status", "author", "tags", "date", "updated"],
-      sortableFields: ["title", "date", "updated"],
+      graph: graph({
+        entityType: "Note",
+        titleField: "title",
+        tagField: "tags",
+        enableSections: true
+      }),
+      fields: {
+        title: field("title", { filterable: true, sortable: true, contentKeys: ["title"], writeContentKey: "title" }),
+        status: field("status", { filterable: true, contentKeys: ["status"], writeContentKey: "status" }),
+        author: field("author", { filterable: true, contentKeys: ["author"], writeContentKey: "author" }),
+        tags: field("tags", { filterable: true, comparableAs: "string_array", contentKeys: ["tags"], writeContentKey: "tags" }),
+        date: field("date", { filterable: true, sortable: true, comparableAs: "date", contentKeys: ["date"], writeContentKey: "date" }),
+        updated_at: field("updated_at", { aliases: ["updated", "updatedAt"], sortable: true, filterable: true, comparableAs: "date", contentKeys: ["updated_at", "updated", "updatedAt"], writeContentKey: "updated_at" })
+      },
+      filterableFields: ["title", "status", "author", "tags", "date", "updated_at"],
+      sortableFields: ["title", "date", "updated_at"],
       pickField: "date",
       contentCollection: "notes",
       contentDir: path.join(root, "notes")
@@ -33,8 +80,29 @@ function buildModelRegistry() {
       aliases: ["questions"],
       storage: "content",
       operations: ["get", "read", "search", "follow", "pick", "create", "update"],
-      filterableFields: ["title", "status", "tags", "date", "questionType", "relatedObjectives", "relatedBooks"],
-      sortableFields: ["title", "date", "updated"],
+      graph: graph({
+        entityType: "Question",
+        titleField: "title",
+        tagField: "tags",
+        enableSections: true,
+        referenceFields: [
+          { field: "related_objectives", edgeType: "REFERENCES", targetModels: ["objective"], multiple: true },
+          { field: "related_books", edgeType: "REFERENCES", targetModels: ["book"], multiple: true },
+          { field: "primary_contributor", edgeType: "REFERENCES", targetModels: ["person", "agent"] }
+        ]
+      }),
+      fields: {
+        title: field("title", { filterable: true, sortable: true, contentKeys: ["title"], writeContentKey: "title" }),
+        status: field("status", { filterable: true, contentKeys: ["status"], writeContentKey: "status" }),
+        tags: field("tags", { filterable: true, comparableAs: "string_array", contentKeys: ["tags"], writeContentKey: "tags" }),
+        date: field("date", { filterable: true, sortable: true, comparableAs: "date", contentKeys: ["date"], writeContentKey: "date" }),
+        question_type: field("question_type", { aliases: ["questionType"], filterable: true, contentKeys: ["question_type", "questionType"], writeContentKey: "question_type" }),
+        related_objectives: field("related_objectives", { aliases: ["relatedObjectives"], filterable: true, comparableAs: "string_array", contentKeys: ["related_objectives", "relatedObjectives"], writeContentKey: "related_objectives" }),
+        related_books: field("related_books", { aliases: ["relatedBooks"], filterable: true, comparableAs: "string_array", contentKeys: ["related_books", "relatedBooks"], writeContentKey: "related_books" }),
+        updated_at: field("updated_at", { aliases: ["updated", "updatedAt"], sortable: true, comparableAs: "date", contentKeys: ["updated_at", "updated", "updatedAt"], writeContentKey: "updated_at" })
+      },
+      filterableFields: ["title", "status", "tags", "date", "question_type", "related_objectives", "related_books"],
+      sortableFields: ["title", "date", "updated_at"],
       pickField: "date",
       contentCollection: "questions",
       contentDir: path.join(root, "questions")
@@ -44,8 +112,22 @@ function buildModelRegistry() {
       aliases: ["books"],
       storage: "content",
       operations: ["get", "read", "search", "follow", "pick", "create", "update"],
-      filterableFields: ["title", "slug", "tags", "sectionLabel"],
-      sortableFields: ["title", "order", "updated"],
+      graph: graph({
+        entityType: "Book",
+        titleField: "title",
+        tagField: "tags",
+        enableSections: true
+      }),
+      fields: {
+        title: field("title", { filterable: true, sortable: true, contentKeys: ["title"], writeContentKey: "title" }),
+        slug: field("slug", { filterable: true, contentKeys: ["slug"], writeContentKey: "slug" }),
+        tags: field("tags", { filterable: true, comparableAs: "string_array", contentKeys: ["tags"], writeContentKey: "tags" }),
+        section_label: field("section_label", { aliases: ["sectionLabel"], filterable: true, contentKeys: ["section_label", "sectionLabel"], writeContentKey: "section_label" }),
+        order: field("order", { sortable: true, comparableAs: "number", contentKeys: ["order"], writeContentKey: "order" }),
+        updated_at: field("updated_at", { aliases: ["updated", "updatedAt"], sortable: true, comparableAs: "date", contentKeys: ["updated_at", "updated", "updatedAt"], writeContentKey: "updated_at" })
+      },
+      filterableFields: ["title", "slug", "tags", "section_label"],
+      sortableFields: ["title", "order", "updated_at"],
       pickField: "order",
       contentCollection: "books",
       contentDir: path.join(root, "books")
@@ -55,9 +137,21 @@ function buildModelRegistry() {
       aliases: ["knowledge-base", "docs"],
       storage: "content",
       operations: ["get", "read", "search", "follow", "pick", "create", "update"],
-      filterableFields: ["title", "tags", "updated", "slug"],
-      sortableFields: ["title", "updated"],
-      pickField: "updated",
+      graph: graph({
+        entityType: "Knowledge",
+        titleField: "title",
+        tagField: "tags",
+        enableSections: true
+      }),
+      fields: {
+        title: field("title", { filterable: true, sortable: true, contentKeys: ["title"], writeContentKey: "title" }),
+        tags: field("tags", { filterable: true, comparableAs: "string_array", contentKeys: ["tags"], writeContentKey: "tags" }),
+        updated_at: field("updated_at", { aliases: ["updated", "updatedAt"], filterable: true, sortable: true, comparableAs: "date", contentKeys: ["updated_at", "updated", "updatedAt"], writeContentKey: "updated_at" }),
+        slug: field("slug", { filterable: true, contentKeys: ["slug"], writeContentKey: "slug" })
+      },
+      filterableFields: ["title", "tags", "updated_at", "slug"],
+      sortableFields: ["title", "updated_at"],
+      pickField: "updated_at",
       contentCollection: "docs",
       contentDir: path.join(root, "knowledge")
     },
@@ -66,8 +160,29 @@ function buildModelRegistry() {
       aliases: ["objectives"],
       storage: "content",
       operations: ["get", "read", "search", "follow", "pick", "create", "update"],
-      filterableFields: ["title", "status", "tags", "date", "timeHorizon", "relatedQuestions", "relatedBooks"],
-      sortableFields: ["title", "date", "updated"],
+      graph: graph({
+        entityType: "Objective",
+        titleField: "title",
+        tagField: "tags",
+        enableSections: true,
+        referenceFields: [
+          { field: "related_questions", edgeType: "REFERENCES", targetModels: ["question"], multiple: true },
+          { field: "related_books", edgeType: "REFERENCES", targetModels: ["book"], multiple: true },
+          { field: "primary_contributor", edgeType: "REFERENCES", targetModels: ["person", "agent"] }
+        ]
+      }),
+      fields: {
+        title: field("title", { filterable: true, sortable: true, contentKeys: ["title"], writeContentKey: "title" }),
+        status: field("status", { filterable: true, contentKeys: ["status"], writeContentKey: "status" }),
+        tags: field("tags", { filterable: true, comparableAs: "string_array", contentKeys: ["tags"], writeContentKey: "tags" }),
+        date: field("date", { filterable: true, sortable: true, comparableAs: "date", contentKeys: ["date"], writeContentKey: "date" }),
+        time_horizon: field("time_horizon", { aliases: ["timeHorizon"], filterable: true, contentKeys: ["time_horizon", "timeHorizon"], writeContentKey: "time_horizon" }),
+        related_questions: field("related_questions", { aliases: ["relatedQuestions"], filterable: true, comparableAs: "string_array", contentKeys: ["related_questions", "relatedQuestions"], writeContentKey: "related_questions" }),
+        related_books: field("related_books", { aliases: ["relatedBooks"], filterable: true, comparableAs: "string_array", contentKeys: ["related_books", "relatedBooks"], writeContentKey: "related_books" }),
+        updated_at: field("updated_at", { aliases: ["updated", "updatedAt"], sortable: true, comparableAs: "date", contentKeys: ["updated_at", "updated", "updatedAt"], writeContentKey: "updated_at" })
+      },
+      filterableFields: ["title", "status", "tags", "date", "time_horizon", "related_questions", "related_books"],
+      sortableFields: ["title", "date", "updated_at"],
       pickField: "date",
       contentCollection: "objectives",
       contentDir: path.join(root, "objectives")
@@ -77,9 +192,27 @@ function buildModelRegistry() {
       aliases: ["people", "persons"],
       storage: "content",
       operations: ["get", "read", "search", "follow", "pick", "create", "update"],
+      graph: graph({
+        entityType: "Person",
+        titleField: "name",
+        tagField: "tags",
+        enableSections: true,
+        referenceFields: [
+          { field: "related_questions", edgeType: "REFERENCES", targetModels: ["question"], multiple: true },
+          { field: "related_objectives", edgeType: "REFERENCES", targetModels: ["objective"], multiple: true }
+        ]
+      }),
+      fields: {
+        name: field("name", { filterable: true, sortable: true, contentKeys: ["name"], writeContentKey: "name" }),
+        role: field("role", { filterable: true, contentKeys: ["role"], writeContentKey: "role" }),
+        affiliation: field("affiliation", { filterable: true, contentKeys: ["affiliation"], writeContentKey: "affiliation" }),
+        status: field("status", { filterable: true, contentKeys: ["status"], writeContentKey: "status" }),
+        tags: field("tags", { filterable: true, comparableAs: "string_array", contentKeys: ["tags"], writeContentKey: "tags" }),
+        updated_at: field("updated_at", { aliases: ["updated", "updatedAt"], sortable: true, comparableAs: "date", contentKeys: ["updated_at", "updated", "updatedAt"], writeContentKey: "updated_at" })
+      },
       filterableFields: ["name", "role", "affiliation", "status", "tags"],
-      sortableFields: ["name", "updated"],
-      pickField: "updated",
+      sortableFields: ["name", "updated_at"],
+      pickField: "updated_at",
       contentCollection: "people",
       contentDir: path.join(root, "people")
     },
@@ -88,6 +221,13 @@ function buildModelRegistry() {
       aliases: ["subscriptions", "subscriber", "subscribers"],
       storage: "d1",
       operations: ["get", "read", "search", "follow", "pick", "create", "update"],
+      fields: {
+        email: field("email", { filterable: true, sortable: true, dbColumns: ["email", "lookup_key"], writeDbColumn: "email" }),
+        status: field("status", { filterable: true, dbColumns: ["status"], writeDbColumn: "status" }),
+        source: field("source", { filterable: true, dbColumns: ["source"], payloadPaths: ["$.source"], writeDbColumn: "source" }),
+        created_at: field("created_at", { aliases: ["createdAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["created_at"], writeDbColumn: "created_at" }),
+        updated_at: field("updated_at", { aliases: ["updatedAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["updated_at"], writeDbColumn: "updated_at" })
+      },
       filterableFields: ["email", "status", "source", "created_at", "updated_at"],
       sortableFields: ["email", "created_at", "updated_at"],
       pickField: "updated_at"
@@ -97,18 +237,138 @@ function buildModelRegistry() {
       aliases: ["messages"],
       storage: "d1",
       operations: ["get", "read", "search", "follow", "pick", "create", "update"],
+      fields: {
+        type: field("type", { filterable: true, dbColumns: ["type", "message_type"], writeDbColumn: "type" }),
+        status: field("status", { filterable: true, dbColumns: ["status"], writeDbColumn: "status" }),
+        related_model: field("related_model", { aliases: ["relatedModel"], filterable: true, dbColumns: ["related_model"], writeDbColumn: "related_model" }),
+        related_id: field("related_id", { aliases: ["relatedId"], filterable: true, dbColumns: ["related_id"], writeDbColumn: "related_id" }),
+        priority: field("priority", { filterable: true, sortable: true, comparableAs: "number", dbColumns: ["priority"], writeDbColumn: "priority" }),
+        available_at: field("available_at", { aliases: ["availableAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["available_at"], writeDbColumn: "available_at" }),
+        created_at: field("created_at", { aliases: ["createdAt"], sortable: true, comparableAs: "date", dbColumns: ["created_at"], writeDbColumn: "created_at" }),
+        updated_at: field("updated_at", { aliases: ["updatedAt"], sortable: true, comparableAs: "date", dbColumns: ["updated_at"], writeDbColumn: "updated_at" })
+      },
       filterableFields: ["type", "status", "related_model", "related_id", "priority", "available_at"],
       sortableFields: ["priority", "available_at", "created_at", "updated_at"],
       pickField: "available_at"
     },
+    work_day: {
+      name: "work_day",
+      aliases: ["work_days", "workday"],
+      storage: "d1",
+      operations: ["get", "read", "search", "create", "update"],
+      fields: {
+        project_id: field("project_id", { aliases: ["projectId"], filterable: true, dbColumns: ["project_id"], writeDbColumn: "project_id" }),
+        state: field("state", { filterable: true, dbColumns: ["state"], writeDbColumn: "state" }),
+        started_at: field("started_at", { aliases: ["startedAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["started_at"], writeDbColumn: "started_at" }),
+        updated_at: field("updated_at", { aliases: ["updatedAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["updated_at"], writeDbColumn: "updated_at" })
+      },
+      filterableFields: ["project_id", "state", "started_at", "updated_at"],
+      sortableFields: ["started_at", "updated_at"],
+      pickField: "updated_at"
+    },
+    task: {
+      name: "task",
+      aliases: ["tasks"],
+      storage: "d1",
+      operations: ["get", "read", "search", "pick", "create", "update"],
+      fields: {
+        work_day_id: field("work_day_id", { aliases: ["workDayId"], filterable: true, dbColumns: ["work_day_id"], writeDbColumn: "work_day_id" }),
+        agent_id: field("agent_id", { aliases: ["agentId"], filterable: true, dbColumns: ["agent_id"], writeDbColumn: "agent_id" }),
+        type: field("type", { filterable: true, dbColumns: ["type"], writeDbColumn: "type" }),
+        state: field("state", { filterable: true, dbColumns: ["state"], writeDbColumn: "state" }),
+        priority: field("priority", { filterable: true, sortable: true, comparableAs: "number", dbColumns: ["priority"], writeDbColumn: "priority" }),
+        idempotency_key: field("idempotency_key", { aliases: ["idempotencyKey"], filterable: true, dbColumns: ["idempotency_key"], writeDbColumn: "idempotency_key" }),
+        available_at: field("available_at", { aliases: ["availableAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["available_at"], writeDbColumn: "available_at" }),
+        updated_at: field("updated_at", { aliases: ["updatedAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["updated_at"], writeDbColumn: "updated_at" })
+      },
+      filterableFields: ["work_day_id", "agent_id", "type", "state", "priority", "idempotency_key", "available_at", "updated_at"],
+      sortableFields: ["priority", "available_at", "updated_at"],
+      pickField: "available_at"
+    },
+    task_event: {
+      name: "task_event",
+      aliases: ["task_events"],
+      storage: "d1",
+      operations: ["get", "read", "search", "create"],
+      fields: {
+        task_id: field("task_id", { aliases: ["taskId"], filterable: true, dbColumns: ["task_id"], writeDbColumn: "task_id" }),
+        kind: field("kind", { filterable: true, dbColumns: ["kind"], writeDbColumn: "kind" }),
+        seq: field("seq", { filterable: true, sortable: true, comparableAs: "number", dbColumns: ["seq"], writeDbColumn: "seq" }),
+        created_at: field("created_at", { aliases: ["createdAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["created_at"], writeDbColumn: "created_at" })
+      },
+      filterableFields: ["task_id", "kind", "seq", "created_at"],
+      sortableFields: ["seq", "created_at"],
+      pickField: "created_at"
+    },
+    task_output: {
+      name: "task_output",
+      aliases: ["task_outputs"],
+      storage: "d1",
+      operations: ["get", "read", "search", "create"],
+      fields: {
+        task_id: field("task_id", { aliases: ["taskId"], filterable: true, dbColumns: ["task_id"], writeDbColumn: "task_id" }),
+        created_at: field("created_at", { aliases: ["createdAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["created_at"], writeDbColumn: "created_at" })
+      },
+      filterableFields: ["task_id", "created_at"],
+      sortableFields: ["created_at"],
+      pickField: "created_at"
+    },
+    graph_run: {
+      name: "graph_run",
+      aliases: ["graph_runs"],
+      storage: "d1",
+      operations: ["get", "read", "search", "create"],
+      fields: {
+        work_day_id: field("work_day_id", { aliases: ["workDayId"], filterable: true, dbColumns: ["work_day_id"], writeDbColumn: "work_day_id" }),
+        graph_version: field("graph_version", { aliases: ["graphVersion"], filterable: true, sortable: true, dbColumns: ["graph_version"], writeDbColumn: "graph_version" }),
+        created_at: field("created_at", { aliases: ["createdAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["created_at"], writeDbColumn: "created_at" })
+      },
+      filterableFields: ["work_day_id", "graph_version", "created_at"],
+      sortableFields: ["created_at"],
+      pickField: "created_at"
+    },
+    report: {
+      name: "report",
+      aliases: ["reports"],
+      storage: "d1",
+      operations: ["get", "read", "search", "create", "update"],
+      fields: {
+        work_day_id: field("work_day_id", { aliases: ["workDayId"], filterable: true, dbColumns: ["work_day_id"], writeDbColumn: "work_day_id" }),
+        kind: field("kind", { filterable: true, dbColumns: ["kind"], writeDbColumn: "kind" }),
+        sent_at: field("sent_at", { aliases: ["sentAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["sent_at"], writeDbColumn: "sent_at" }),
+        created_at: field("created_at", { aliases: ["createdAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["created_at"], writeDbColumn: "created_at" })
+      },
+      filterableFields: ["work_day_id", "kind", "sent_at", "created_at"],
+      sortableFields: ["sent_at", "created_at"],
+      pickField: "created_at"
+    },
     agent: {
       name: "agent",
       aliases: ["agents"],
       storage: "content",
       operations: ["get", "read", "search", "follow", "pick", "create", "update"],
-      filterableFields: ["slug", "runtimeStatus", "tags", "operator"],
-      sortableFields: ["name", "slug", "updated"],
-      pickField: "updated",
+      graph: graph({
+        entityType: "Agent",
+        titleField: "name",
+        tagField: "tags",
+        enableSections: true,
+        referenceFields: [
+          { field: "related_questions", edgeType: "REFERENCES", targetModels: ["question"], multiple: true },
+          { field: "related_objectives", edgeType: "REFERENCES", targetModels: ["objective"], multiple: true }
+        ]
+      }),
+      fields: {
+        name: field("name", { sortable: true, contentKeys: ["name"], writeContentKey: "name" }),
+        slug: field("slug", { filterable: true, sortable: true, contentKeys: ["slug"], writeContentKey: "slug" }),
+        runtime_status: field("runtime_status", { aliases: ["runtimeStatus"], filterable: true, contentKeys: ["runtime_status", "runtimeStatus"], writeContentKey: "runtime_status" }),
+        tags: field("tags", { filterable: true, comparableAs: "string_array", contentKeys: ["tags"], writeContentKey: "tags" }),
+        operator: field("operator", { filterable: true, contentKeys: ["operator"], writeContentKey: "operator" }),
+        updated_at: field("updated_at", { aliases: ["updated", "updatedAt"], sortable: true, comparableAs: "date", contentKeys: ["updated_at", "updated", "updatedAt"], writeContentKey: "updated_at" }),
+        enabled: field("enabled", { aliases: ["is_enabled"], filterable: true, comparableAs: "boolean", contentKeys: ["enabled", "is_enabled"], writeContentKey: "enabled" })
+      },
+      filterableFields: ["slug", "runtime_status", "tags", "operator", "enabled"],
+      sortableFields: ["name", "slug", "updated_at"],
+      pickField: "updated_at",
       contentCollection: "agents",
       contentDir: path.join(root, "agents")
     },
@@ -117,6 +377,13 @@ function buildModelRegistry() {
       aliases: ["agent_runs", "run", "runs"],
       storage: "d1",
       operations: ["get", "read", "search", "follow", "create", "update"],
+      fields: {
+        run_id: field("run_id", { aliases: ["runId"], filterable: true, dbColumns: ["run_id", "record_key"], writeDbColumn: "run_id" }),
+        agent_slug: field("agent_slug", { aliases: ["agentSlug"], filterable: true, dbColumns: ["agent_slug", "lookup_key"], writeDbColumn: "agent_slug" }),
+        status: field("status", { filterable: true, dbColumns: ["status"], writeDbColumn: "status" }),
+        started_at: field("started_at", { aliases: ["startedAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["started_at", "created_at"], writeDbColumn: "started_at" }),
+        finished_at: field("finished_at", { aliases: ["finishedAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["finished_at"], payloadPaths: ["$.finishedAt"], writeDbColumn: "finished_at" })
+      },
       filterableFields: ["run_id", "agent_slug", "status", "started_at", "finished_at"],
       sortableFields: ["started_at", "finished_at"],
       pickField: "started_at"
@@ -126,6 +393,12 @@ function buildModelRegistry() {
       aliases: ["agent_cursors", "cursor", "cursors"],
       storage: "d1",
       operations: ["get", "read", "search", "follow", "create", "update"],
+      fields: {
+        agent_slug: field("agent_slug", { aliases: ["agentSlug"], filterable: true, sortable: true, dbColumns: ["agent_slug"], writeDbColumn: "agent_slug" }),
+        cursor_key: field("cursor_key", { aliases: ["cursorKey"], filterable: true, sortable: true, dbColumns: ["cursor_key"], writeDbColumn: "cursor_key" }),
+        cursor_value: field("cursor_value", { aliases: ["cursorValue"], filterable: true, dbColumns: ["cursor_value"], payloadPaths: ["$.cursorValue"], writeDbColumn: "cursor_value" }),
+        updated_at: field("updated_at", { aliases: ["updatedAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["updated_at"], writeDbColumn: "updated_at" })
+      },
       filterableFields: ["agent_slug", "cursor_key", "cursor_value", "updated_at"],
       sortableFields: ["updated_at", "agent_slug", "cursor_key"],
       pickField: "updated_at"
@@ -135,15 +408,64 @@ function buildModelRegistry() {
       aliases: ["content_leases", "lease", "leases"],
       storage: "d1",
       operations: ["get", "read", "search", "follow", "create", "update"],
+      fields: {
+        model: field("model", { filterable: true, dbColumns: ["model"], writeDbColumn: "model" }),
+        item_key: field("item_key", { aliases: ["itemKey"], filterable: true, dbColumns: ["item_key"], writeDbColumn: "item_key" }),
+        claimed_by: field("claimed_by", { aliases: ["claimedBy"], filterable: true, dbColumns: ["claimed_by"], writeDbColumn: "claimed_by" }),
+        claimed_at: field("claimed_at", { aliases: ["claimedAt"], sortable: true, comparableAs: "date", dbColumns: ["claimed_at"], writeDbColumn: "claimed_at" }),
+        lease_expires_at: field("lease_expires_at", { aliases: ["leaseExpiresAt"], filterable: true, sortable: true, comparableAs: "date", dbColumns: ["lease_expires_at"], writeDbColumn: "lease_expires_at" })
+      },
       filterableFields: ["model", "item_key", "claimed_by", "lease_expires_at"],
       sortableFields: ["lease_expires_at", "claimed_at"],
       pickField: "lease_expires_at"
     }
   };
 }
+function normalizeDefinition(definition) {
+  const normalizedFields = Object.fromEntries(
+    Object.entries(definition.fields ?? {}).map(([canonicalKey, binding]) => [
+      canonicalKey,
+      {
+        ...binding,
+        key: canonicalKey,
+        aliases: [...new Set((binding.aliases ?? []).map((alias) => alias.trim().toLowerCase()).filter(Boolean))],
+        contentKeys: [...new Set(binding.contentKeys ?? [])],
+        dbColumns: [...new Set(binding.dbColumns ?? [])],
+        payloadPaths: [...new Set(binding.payloadPaths ?? [])]
+      }
+    ])
+  );
+  const normalized = {
+    ...definition,
+    name: definition.name.trim(),
+    aliases: [...new Set((definition.aliases ?? []).map((alias) => alias.trim().toLowerCase()).filter(Boolean))],
+    fields: normalizedFields,
+    filterableFields: [...new Set(definition.filterableFields ?? Object.entries(normalizedFields).filter(([, binding]) => binding.filterable).map(([key]) => key))],
+    sortableFields: [...new Set(definition.sortableFields ?? Object.entries(normalizedFields).filter(([, binding]) => binding.sortable).map(([key]) => key))]
+  };
+  validateModelFieldAliases(normalized);
+  return normalized;
+}
+function mergeModelRegistries(baseRegistry, definitions = []) {
+  const registry = { ...baseRegistry };
+  for (const rawDefinition of definitions) {
+    const definition = normalizeDefinition(rawDefinition);
+    if (!definition.name) {
+      throw new Error("SDK model definitions require a non-empty name.");
+    }
+    registry[definition.name] = definition;
+  }
+  return registry;
+}
+function buildModelRegistry(definitions = []) {
+  return mergeModelRegistries(buildBuiltinModelRegistry(), definitions);
+}
+function buildScopedModelRegistry(repoRoot, definitions = []) {
+  return mergeModelRegistries(buildBuiltinModelRegistry(repoRoot), definitions);
+}
+const BUILTIN_MODEL_REGISTRY = buildBuiltinModelRegistry();
 const MODEL_REGISTRY = buildModelRegistry();
-function resolveModelDefinition(model) {
-  const registry = buildModelRegistry();
+function resolveModelDefinition(model, registry = MODEL_REGISTRY) {
   const directMatch = registry[model];
   if (directMatch) {
     return directMatch;
@@ -158,7 +480,11 @@ function resolveModelDefinition(model) {
   return aliasMatch;
 }
 export {
+  BUILTIN_MODEL_REGISTRY,
   MODEL_REGISTRY,
+  buildBuiltinModelRegistry,
   buildModelRegistry,
+  buildScopedModelRegistry,
+  mergeModelRegistries,
   resolveModelDefinition
 };

package/dist/operations/providers/default.d.ts

@@ -0,0 +1,10 @@
+import type { TreeseedOperationImplementation, TreeseedOperationMetadata, TreeseedOperationProvider } from '../../operations-types.ts';
+export declare class DefaultTreeseedOperationsProvider implements TreeseedOperationProvider {
+    readonly id = "default";
+    private readonly operations;
+    constructor();
+    listOperations(): TreeseedOperationImplementation<Record<string, unknown>, Record<string, unknown>>[];
+    findOperation(name: string | null | undefined): TreeseedOperationImplementation<Record<string, unknown>, Record<string, unknown>> | null;
+}
+export declare function createDefaultTreeseedOperationsProvider(): DefaultTreeseedOperationsProvider;
+export declare function listDefaultOperationMetadata(): TreeseedOperationMetadata[];