@treeseed/sdk 0.1.2 → 0.3.1

package/dist/cli-tools.js

@@ -1,6 +1,8 @@
-import {
-  AGENT_CLI_ALLOW_TOOLS
-} from "./types/agents.js";
+const AGENT_CLI_ALLOW_TOOLS = [
+  "shell(git)",
+  "shell(npm)",
+  "web"
+];
 const ALLOWED_TOOL_SET = new Set(AGENT_CLI_ALLOW_TOOLS);
 function normalizeStringArray(value, field) {
   if (value === void 0 || value === null) {

package/dist/{src/content-store.d.ts → content-store.d.ts}

@@ -1,10 +1,11 @@
-import type { SdkContentEntry, SdkFollowRequest, SdkGetRequest, SdkMutationRequest, SdkPickRequest, SdkPickResult, SdkSearchRequest, SdkUpdateRequest } from './sdk-types.ts';
+import type { SdkContentEntry, SdkFollowRequest, SdkGetRequest, SdkModelRegistry, SdkMutationRequest, SdkPickRequest, SdkPickResult, SdkSearchRequest, SdkUpdateRequest } from './sdk-types.ts';
 import type { AgentDatabase } from './d1-store.ts';
 export declare class ContentStore {
     private readonly repoRoot;
     private readonly database;
+    private readonly models;
     private readonly gitRuntime;
-    constructor(repoRoot: string, database: AgentDatabase);
+    constructor(repoRoot: string, database: AgentDatabase, models: SdkModelRegistry);
     list(model: string): Promise<SdkContentEntry[]>;
     get(request: SdkGetRequest): Promise<SdkContentEntry | null>;
     search(request: SdkSearchRequest): Promise<SdkContentEntry[]>;

package/dist/content-store.js

@@ -4,7 +4,26 @@ import crypto from "node:crypto";
 import { parseFrontmatterDocument, serializeFrontmatterDocument } from "./frontmatter.js";
 import { resolveModelDefinition } from "./model-registry.js";
 import { applyFilters, applySort } from "./sdk-filters.js";
+import { canonicalizeFrontmatter, normalizeFilterFields, normalizeMutationData, normalizeRecordToCanonicalShape, normalizeSortFields, readCanonicalFieldValue } from "./sdk-fields.js";
+import { assertExpectedVersion } from "./sdk-version.js";
 import { GitRuntime } from "./git-runtime.js";
+function pickSortForStrategy(definition, request) {
+  switch (request.strategy) {
+    case "oldest":
+      return [{ field: definition.pickField, direction: "asc" }];
+    case "highest_priority":
+      if (definition.sortableFields.includes("priority") || definition.filterableFields.includes("priority")) {
+        return [
+          { field: "priority", direction: "desc" },
+          { field: definition.pickField, direction: "desc" }
+        ];
+      }
+      return [{ field: definition.pickField, direction: "desc" }];
+    case "latest":
+    default:
+      return [{ field: definition.pickField, direction: "desc" }];
+  }
+}
 async function walkMarkdownFiles(root) {
   try {
     const entries = await readdir(root, { withFileTypes: true });
@@ -45,16 +64,20 @@ async function readContentEntry(definition, filePath, contentDir) {
   const parsed = parseFrontmatterDocument(source);
   const fileStats = await stat(filePath);
   const slug = inferSlug(filePath, contentDir);
+  const titleField = definition.fields.title ? readCanonicalFieldValue(definition, { frontmatter: parsed.frontmatter }, "title") : void 0;
+  const createdField = definition.fields.created_at ? readCanonicalFieldValue(definition, { frontmatter: parsed.frontmatter }, "created_at") : void 0;
+  const updatedField = definition.fields.updated_at ? readCanonicalFieldValue(definition, { frontmatter: parsed.frontmatter }, "updated_at") : void 0;
+  const nameField = definition.fields.name ? readCanonicalFieldValue(definition, { frontmatter: parsed.frontmatter }, "name") : void 0;
   return {
     id: slug,
     slug,
     model: definition.name,
-    title: typeof parsed.frontmatter.title === "string" ? parsed.frontmatter.title : void 0,
+    title: typeof titleField === "string" ? String(titleField) : typeof nameField === "string" ? String(nameField) : void 0,
     path: filePath,
     body: parsed.body,
     frontmatter: parsed.frontmatter,
-    createdAt: typeof parsed.frontmatter.date === "string" ? String(parsed.frontmatter.date) : fileStats.birthtime.toISOString(),
-    updatedAt: typeof parsed.frontmatter.updated === "string" ? String(parsed.frontmatter.updated) : fileStats.mtime.toISOString()
+    createdAt: typeof createdField === "string" ? String(createdField) : fileStats.birthtime.toISOString(),
+    updatedAt: typeof updatedField === "string" ? String(updatedField) : fileStats.mtime.toISOString()
   };
 }
 function entryMatchesIdentity(entry, request) {
@@ -72,9 +95,10 @@ function sanitizeFrontmatterInput(data) {
   return next;
 }
 class ContentStore {
-  constructor(repoRoot, database) {
+  constructor(repoRoot, database, models) {
     this.repoRoot = repoRoot;
     this.database = database;
+    this.models = models;
     this.gitRuntime = new GitRuntime(
       repoRoot,
       process.env.TREESEED_AGENT_DISABLE_GIT === "true"
@@ -82,9 +106,10 @@ class ContentStore {
   }
   repoRoot;
   database;
+  models;
   gitRuntime;
   async list(model) {
-    const definition = resolveModelDefinition(model);
+    const definition = resolveModelDefinition(model, this.models);
     if (definition.storage !== "content" || !definition.contentDir) {
       throw new Error(`Model "${model}" is not content-backed.`);
     }
@@ -122,9 +147,10 @@ class ContentStore {
     return entries.find((entry) => entryMatchesIdentity(entry, request)) ?? null;
   }
   async search(request) {
+    const definition = resolveModelDefinition(request.model, this.models);
     const items = await this.list(request.model);
-    const filtered = applyFilters(items, request.filters);
-    const sorted = applySort(filtered, request.sort);
+    const filtered = applyFilters(items, normalizeFilterFields(definition, request.filters), definition);
+    const sorted = applySort(filtered, normalizeSortFields(definition, request.sort), definition);
     return sorted.slice(0, request.limit ?? sorted.length);
   }
   async follow(request) {
@@ -145,11 +171,11 @@ class ContentStore {
     };
   }
   async pick(request) {
-    const definition = resolveModelDefinition(request.model);
+    const definition = resolveModelDefinition(request.model, this.models);
     const sorted = await this.search({
       model: request.model,
       filters: request.filters,
-      sort: [{ field: definition.pickField, direction: "desc" }],
+      sort: pickSortForStrategy(definition, request),
       limit: 25
     });
     for (const item of sorted) {
@@ -172,7 +198,7 @@ class ContentStore {
     };
   }
   async create(request) {
-    const definition = resolveModelDefinition(request.model);
+    const definition = resolveModelDefinition(request.model, this.models);
     ensureMutationAllowed(definition, "create");
     if (!definition.contentDir) {
       throw new Error(`Model "${request.model}" is not content-backed.`);
@@ -185,11 +211,12 @@ class ContentStore {
     const contentDirInWorktree = path.join(worktreePath, path.relative(this.repoRoot, definition.contentDir));
     const relativePath = path.relative(this.repoRoot, path.join(definition.contentDir, `${slug}${extension}`));
     const filePath = path.join(worktreePath, relativePath);
-    const frontmatter = {
-      ...sanitizeFrontmatterInput(request.data),
+    const mutationData = normalizeMutationData(definition, sanitizeFrontmatterInput(request.data));
+    const frontmatter = canonicalizeFrontmatter(definition, {}, {
+      ...mutationData,
       slug,
-      updated: (/* @__PURE__ */ new Date()).toISOString()
-    };
+      updated_at: mutationData.updated_at ?? (/* @__PURE__ */ new Date()).toISOString()
+    });
     await mkdir(path.dirname(filePath), { recursive: true });
     await writeFile(filePath, serializeFrontmatterDocument(frontmatter, body), "utf8");
     const git = await this.gitRuntime.commitFileChange(
@@ -203,21 +230,26 @@ class ContentStore {
     };
   }
   async update(request) {
-    const definition = resolveModelDefinition(request.model);
+    const definition = resolveModelDefinition(request.model, this.models);
     ensureMutationAllowed(definition, "update");
     const existing = await this.get(request);
     if (!existing) {
       throw new Error(`No ${request.model} entry found for update.`);
     }
+    assertExpectedVersion(request.expectedVersion, existing, `${definition.name} "${existing.slug}"`);
     const branchName = `${String(request.data.branchPrefix ?? "agent")}/${definition.name}-${existing.slug}`;
     const worktreePath = await this.gitRuntime.ensureWorktree(branchName);
     const relativePath = path.relative(this.repoRoot, existing.path);
     const targetPath = path.join(worktreePath, relativePath);
-    const nextFrontmatter = {
-      ...existing.frontmatter,
-      ...sanitizeFrontmatterInput(request.data),
-      updated: (/* @__PURE__ */ new Date()).toISOString()
-    };
+    const mutationData = normalizeMutationData(definition, sanitizeFrontmatterInput(request.data));
+    const nextFrontmatter = canonicalizeFrontmatter(
+      definition,
+      normalizeRecordToCanonicalShape(definition, existing.frontmatter),
+      {
+        ...mutationData,
+        updated_at: mutationData.updated_at ?? (/* @__PURE__ */ new Date()).toISOString()
+      }
+    );
     const nextBody = typeof request.data.body === "string" ? request.data.body : existing.body;
     await mkdir(path.dirname(targetPath), { recursive: true });
     await writeFile(targetPath, serializeFrontmatterDocument(nextFrontmatter, nextBody), "utf8");

package/dist/{src/d1-store.d.ts → d1-store.d.ts}

@@ -1,6 +1,6 @@
 import type { ContentLeaseRecord } from './types/agents.ts';
 import type { D1DatabaseLike } from './types/cloudflare.ts';
-import type { SdkAckMessageRequest, SdkClaimMessageRequest, SdkCreateMessageRequest, SdkCursorEntity, SdkCursorRequest, SdkFollowRequest, SdkGetRequest, SdkGetCursorRequest, SdkLeaseEntity, SdkLeaseReleaseRequest, SdkMessageEntity, SdkMutationRequest, SdkPickRequest, SdkPickResult, SdkRecordRunRequest, SdkRunEntity, SdkSearchRequest, SdkSubscriptionEntity, SdkUpdateRequest } from './sdk-types.ts';
+import type { SdkAppendTaskEventRequest, SdkAckMessageRequest, SdkClaimMessageRequest, SdkClaimTaskRequest, SdkCloseWorkDayRequest, SdkCompleteTaskRequest, SdkCreateReportRequest, SdkCreateMessageRequest, SdkCreateTaskRequest, SdkCursorEntity, SdkCursorRequest, SdkFailTaskRequest, SdkFollowRequest, SdkGetRequest, SdkGetCursorRequest, SdkLeaseEntity, SdkLeaseReleaseRequest, SdkManagerContextPayload, SdkMessageEntity, SdkMutationRequest, SdkPickRequest, SdkPickResult, SdkRecordRunRequest, SdkReportEntity, SdkRunEntity, SdkSearchRequest, SdkStartWorkDayRequest, SdkSubscriptionEntity, SdkTaskEntity, SdkTaskSearchRequest, SdkTaskProgressRequest, SdkUpdateRequest, SdkWorkDayEntity } from './sdk-types.ts';
 import { type LeaseClaimInput } from './stores/lease-store.ts';
 export interface TryClaimContentLeaseInput extends LeaseClaimInput {
 }
@@ -23,6 +23,17 @@ export interface AgentDatabase {
     releaseLease(request: SdkLeaseReleaseRequest): Promise<void>;
     tryClaimContentLease(input: TryClaimContentLeaseInput): Promise<string | null>;
     releaseAllLeases(): Promise<number>;
+    startWorkDay(request: SdkStartWorkDayRequest): Promise<SdkWorkDayEntity | null>;
+    closeWorkDay(request: SdkCloseWorkDayRequest): Promise<SdkWorkDayEntity | null>;
+    createTask(request: SdkCreateTaskRequest): Promise<SdkTaskEntity | null>;
+    claimTask(request: SdkClaimTaskRequest): Promise<SdkTaskEntity | null>;
+    recordTaskProgress(request: SdkTaskProgressRequest): Promise<SdkTaskEntity | null>;
+    completeTask(request: SdkCompleteTaskRequest): Promise<SdkTaskEntity | null>;
+    failTask(request: SdkFailTaskRequest): Promise<SdkTaskEntity | null>;
+    appendTaskEvent(request: SdkAppendTaskEventRequest): Promise<Record<string, unknown> | null>;
+    searchTasks(request: SdkTaskSearchRequest): Promise<SdkTaskEntity[]>;
+    createReport(request: SdkCreateReportRequest): Promise<SdkReportEntity | null>;
+    getManagerContext(taskId: string): Promise<SdkManagerContextPayload>;
 }
 export declare class MemoryAgentDatabase implements AgentDatabase {
     private readonly subscriptions;
@@ -30,6 +41,12 @@ export declare class MemoryAgentDatabase implements AgentDatabase {
     private readonly runs;
     private readonly contentLeases;
     private readonly cursors;
+    private readonly workDays;
+    private readonly tasks;
+    private readonly taskEvents;
+    private readonly taskOutputs;
+    private readonly graphRuns;
+    private readonly reports;
     private messageId;
     constructor(seed?: {
         subscriptions?: SdkSubscriptionEntity[];
@@ -72,6 +89,31 @@ export declare class MemoryAgentDatabase implements AgentDatabase {
     releaseAllLeases(): Promise<number>;
     inspectRuns(): SdkRunEntity[];
     inspectLeases(): ContentLeaseRecord[];
+    startWorkDay(request: SdkStartWorkDayRequest): Promise<SdkWorkDayEntity>;
+    closeWorkDay(request: SdkCloseWorkDayRequest): Promise<SdkWorkDayEntity | null>;
+    createTask(request: SdkCreateTaskRequest): Promise<SdkTaskEntity>;
+    claimTask(request: SdkClaimTaskRequest): Promise<SdkTaskEntity | null>;
+    recordTaskProgress(request: SdkTaskProgressRequest): Promise<SdkTaskEntity | null>;
+    completeTask(request: SdkCompleteTaskRequest): Promise<SdkTaskEntity | null>;
+    failTask(request: SdkFailTaskRequest): Promise<SdkTaskEntity | null>;
+    appendTaskEvent(request: SdkAppendTaskEventRequest): Promise<{
+        id: `${string}-${string}-${string}-${string}-${string}`;
+        taskId: string;
+        seq: number;
+        kind: string;
+        dataJson: string;
+        createdAt: string;
+    }>;
+    searchTasks(request: SdkTaskSearchRequest): Promise<SdkTaskEntity[]>;
+    createReport(request: SdkCreateReportRequest): Promise<SdkReportEntity>;
+    getManagerContext(taskId: string): Promise<{
+        task: SdkTaskEntity | null;
+        workDay: SdkWorkDayEntity | null;
+        agent: null;
+        graph: {
+            graphVersion: string;
+        } | null;
+    }>;
 }
 export declare class CloudflareD1AgentDatabase implements AgentDatabase {
     readonly db: D1DatabaseLike;
@@ -80,6 +122,7 @@ export declare class CloudflareD1AgentDatabase implements AgentDatabase {
     private readonly runs;
     private readonly cursors;
     private readonly leases;
+    private readonly operational;
     constructor(db: D1DatabaseLike);
     get(request: SdkGetRequest): Promise<Record<string, unknown> | null>;
     search(request: SdkSearchRequest): Promise<Record<string, unknown>[]>;
@@ -105,4 +148,22 @@ export declare class CloudflareD1AgentDatabase implements AgentDatabase {
     releaseLease(request: SdkLeaseReleaseRequest): Promise<void>;
     tryClaimContentLease(input: TryClaimContentLeaseInput): Promise<`${string}-${string}-${string}-${string}-${string}` | null>;
     releaseAllLeases(): Promise<number>;
+    startWorkDay(request: SdkStartWorkDayRequest): Promise<SdkWorkDayEntity | null>;
+    closeWorkDay(request: SdkCloseWorkDayRequest): Promise<SdkWorkDayEntity | null>;
+    createTask(request: SdkCreateTaskRequest): Promise<SdkTaskEntity | null>;
+    claimTask(request: SdkClaimTaskRequest): Promise<SdkTaskEntity | null>;
+    recordTaskProgress(request: SdkTaskProgressRequest): Promise<SdkTaskEntity | null>;
+    completeTask(request: SdkCompleteTaskRequest): Promise<SdkTaskEntity | null>;
+    failTask(request: SdkFailTaskRequest): Promise<SdkTaskEntity | null>;
+    appendTaskEvent(request: SdkAppendTaskEventRequest): Promise<import("./sdk-types.ts").SdkTaskEventEntity | null>;
+    searchTasks(request: SdkTaskSearchRequest): Promise<SdkTaskEntity[]>;
+    createReport(request: SdkCreateReportRequest): Promise<SdkReportEntity | null>;
+    getManagerContext(taskId: string): Promise<{
+        task: SdkTaskEntity | null;
+        workDay: SdkWorkDayEntity | null;
+        agent: null;
+        graph: {
+            graphVersion: string;
+        } | null;
+    }>;
 }