@treeseed/sdk 0.4.8 → 0.4.10

package/dist/sdk.d.ts

@@ -2,7 +2,7 @@ import type { AgentPermissionConfig, AgentRuntimeSpec } from './types/agents.ts'
 import { ContentStore } from './content-store.ts';
 import { type AgentDatabase } from './d1-store.ts';
 import { type LoadedTreeseedPluginEntry } from './platform/plugins.ts';
-import type { SdkAckMessageRequest, SdkClaimMessageRequest, SdkClaimTaskRequest, SdkCloseWorkDayRequest, SdkCompleteTaskRequest, SdkCreateReportRequest, SdkCreateMessageRequest, SdkCreateTaskRequest, SdkCursorRequest, SdkFailTaskRequest, SdkFollowRequest, SdkGetRequest, SdkGetCursorRequest, SdkJsonEnvelope, SdkLeaseReleaseRequest, SdkManagerContextPayload, SdkMutationRequest, SdkGraphQueryOptions, SdkGraphQueryRequest, SdkGraphRefreshRequest, SdkGraphSearchOptions, SdkContextPackRequest, SdkGraphDslParseResult, SdkPickRequest, SdkRecordRunRequest, SdkSearchRequest, SdkStartWorkDayRequest, SdkTaskProgressRequest, SdkTaskSearchRequest, SdkUpdateRequest, SdkModelDefinition, SdkModelRegistry, SdkGraphRankingProvider } from './sdk-types.ts';
+import type { SdkAckMessageRequest, SdkClaimMessageRequest, SdkClaimTaskRequest, SdkCloseWorkDayRequest, SdkCompleteTaskRequest, SdkCreateReportRequest, SdkCreateMessageRequest, SdkCreatePrioritySnapshotRequest, SdkCreateTaskRequest, SdkCursorRequest, SdkFailTaskRequest, SdkFollowRequest, SdkGetRequest, SdkGetCursorRequest, SdkJsonEnvelope, SdkLeaseReleaseRequest, SdkManagerContextPayload, SdkMutationRequest, SdkGraphQueryOptions, SdkGraphQueryRequest, SdkGraphRefreshRequest, SdkGraphSearchOptions, SdkContextPackRequest, SdkGraphDslParseResult, SdkPickRequest, SdkPriorityOverrideRequest, SdkRecordRunRequest, SdkRecordScaleDecisionRequest, SdkRecordTaskCreditsRequest, SdkSearchRequest, SdkStartWorkDayRequest, SdkTaskProgressRequest, SdkTaskSearchRequest, SdkUpsertWorkPolicyRequest, SdkUpdateRequest, SdkModelDefinition, SdkModelRegistry, SdkGraphRankingProvider, SdkDispatchConfig, SdkDispatchRequest, SdkDispatchResult, PrioritySnapshot, ScaleDecision, TaskCreditLedgerEntry, WorkdayPolicy } from './sdk-types.ts';
 export interface AgentSdkOptions {
     repoRoot?: string;
     database?: AgentDatabase;
@@ -10,12 +10,15 @@ export interface AgentSdkOptions {
     modelRegistry?: SdkModelRegistry;
     graphRankingProvider?: SdkGraphRankingProvider;
     plugins?: LoadedTreeseedPluginEntry[];
+    dispatch?: SdkDispatchConfig;
 }
 export declare class AgentSdk {
+    readonly repoRoot: string;
     readonly database: AgentDatabase;
     readonly content: ContentStore;
     readonly models: SdkModelRegistry;
     private readonly graph;
+    private readonly dispatchConfig?;
     constructor(options?: AgentSdkOptions);
     static createLocal(options: {
         repoRoot?: string;
@@ -24,6 +27,9 @@ export declare class AgentSdk {
         models?: SdkModelDefinition[];
         modelRegistry?: SdkModelRegistry;
     }): AgentSdk;
+    private resolveDispatchToken;
+    private executeDispatchLocally;
+    dispatch(request: SdkDispatchRequest): Promise<SdkDispatchResult>;
     private envelope;
     get(request: SdkGetRequest): Promise<SdkJsonEnvelope<Record<string, unknown> | import("./sdk-types.ts").SdkContentEntry | null>>;
     read(request: SdkGetRequest): Promise<{
@@ -79,6 +85,16 @@ export declare class AgentSdk {
     searchTasks(request: SdkTaskSearchRequest): Promise<SdkJsonEnvelope<import("./sdk-types.ts").SdkTaskEntity[]>>;
     createReport(request: SdkCreateReportRequest): Promise<SdkJsonEnvelope<import("./sdk-types.ts").SdkReportEntity | null>>;
     getManagerContext(taskId: string): Promise<SdkJsonEnvelope<SdkManagerContextPayload>>;
+    getWorkPolicy(projectId: string, environment?: string): Promise<SdkJsonEnvelope<WorkdayPolicy>>;
+    upsertWorkPolicy(request: SdkUpsertWorkPolicyRequest): Promise<SdkJsonEnvelope<WorkdayPolicy>>;
+    listPriorityOverrides(projectId: string): Promise<SdkJsonEnvelope<Record<string, unknown>[]>>;
+    upsertPriorityOverride(request: SdkPriorityOverrideRequest): Promise<SdkJsonEnvelope<Record<string, unknown> | null>>;
+    createPrioritySnapshot(request: SdkCreatePrioritySnapshotRequest): Promise<SdkJsonEnvelope<PrioritySnapshot>>;
+    getLatestPrioritySnapshot(projectId: string, workDayId?: string | null): Promise<SdkJsonEnvelope<PrioritySnapshot>>;
+    recordTaskCredits(request: SdkRecordTaskCreditsRequest): Promise<SdkJsonEnvelope<TaskCreditLedgerEntry>>;
+    listTaskCredits(workDayId: string): Promise<SdkJsonEnvelope<TaskCreditLedgerEntry[]>>;
+    recordScaleDecision(request: SdkRecordScaleDecisionRequest): Promise<SdkJsonEnvelope<ScaleDecision>>;
+    getLatestScaleDecision(projectId: string, environment: string, poolName: string): Promise<SdkJsonEnvelope<ScaleDecision>>;
     listAgentSpecs(options?: {
         enabled?: boolean;
     }): Promise<AgentRuntimeSpec[]>;

package/dist/sdk.js

@@ -5,6 +5,10 @@ import { CloudflareD1AgentDatabase, MemoryAgentDatabase } from "./d1-store.js";
 import { ContentGraphRuntime } from "./graph.js";
 import { loadTreeseedPlugins } from "./platform/plugins.js";
 import { buildScopedModelRegistry, resolveModelDefinition } from "./model-registry.js";
+import { findDispatchCapability } from "./dispatch.js";
+import { RemoteTreeseedClient, RemoteTreeseedDispatchClient } from "./remote.js";
+import { executeSdkOperation } from "./sdk-dispatch.js";
+import { TreeseedOperationsSdk } from "./operations/runtime.js";
 import { WranglerD1Database } from "./wrangler-d1.js";
 function normalizeAgentSpec(entry) {
   if (!entry) {
@@ -27,12 +31,15 @@ function operationAllowed(permissions, model, operation) {
   );
 }
 class AgentSdk {
+  repoRoot;
   database;
   content;
   models;
   graph;
+  dispatchConfig;
   constructor(options = {}) {
     const repoRoot = resolveSdkRepoRoot(options.repoRoot);
+    this.repoRoot = repoRoot;
     this.models = options.modelRegistry ?? buildScopedModelRegistry(repoRoot, options.models);
     this.database = options.database ?? new MemoryAgentDatabase();
     this.content = new ContentStore(repoRoot, this.database, this.models);
@@ -48,6 +55,7 @@ class AgentSdk {
       rankingProvider: options.graphRankingProvider,
       plugins
     });
+    this.dispatchConfig = options.dispatch;
   }
   static createLocal(options) {
     const repoRoot = resolveSdkRepoRoot(options.repoRoot);
@@ -63,6 +71,67 @@ class AgentSdk {
       modelRegistry: options.modelRegistry
     });
   }
+  async resolveDispatchToken(source) {
+    if (!source) {
+      return null;
+    }
+    if (source.type === "bearer") {
+      return source.token;
+    }
+    return await source.resolveToken();
+  }
+  async executeDispatchLocally(request) {
+    const namespace = request.namespace ?? "sdk";
+    if (namespace === "workflow") {
+      const operations = new TreeseedOperationsSdk();
+      return operations.execute({
+        operationName: request.operation,
+        input: request.input ?? {}
+      }, {
+        cwd: this.repoRoot,
+        env: process.env,
+        transport: "sdk"
+      });
+    }
+    return executeSdkOperation(this, request.operation, request.input ?? {});
+  }
+  async dispatch(request) {
+    const namespace = request.namespace ?? "sdk";
+    const capability = findDispatchCapability(namespace, request.operation);
+    if (!capability) {
+      throw new Error(`Unknown dispatch operation "${namespace}:${request.operation}".`);
+    }
+    const preferredMode = request.preferredMode ?? this.dispatchConfig?.policy ?? capability.defaultDispatchMode;
+    const dispatchConfig = this.dispatchConfig;
+    if (!dispatchConfig && preferredMode === "remote_only") {
+      throw new Error(`Dispatch for "${namespace}:${request.operation}" requires a remote market configuration.`);
+    }
+    const shouldStayLocal = capability.executionClass === "local_only" || !dispatchConfig || preferredMode === "prefer_local";
+    if (shouldStayLocal) {
+      return {
+        ok: true,
+        mode: "inline",
+        namespace,
+        operation: request.operation,
+        target: "local",
+        capability,
+        payload: await this.executeDispatchLocally({ ...request, namespace })
+      };
+    }
+    const token = await this.resolveDispatchToken(dispatchConfig.credentialSource);
+    const client = new RemoteTreeseedDispatchClient(new RemoteTreeseedClient({
+      hosts: [{ id: "market", baseUrl: dispatchConfig.marketBaseUrl }],
+      activeHostId: "market",
+      auth: token ? { accessToken: token } : void 0
+    }, {
+      fetchImpl: dispatchConfig.fetchImpl
+    }));
+    return client.dispatch(dispatchConfig.projectId, {
+      ...request,
+      namespace,
+      preferredMode
+    });
+  }
   envelope(model, operation, payload, meta) {
     return {
       ok: true,
@@ -192,6 +261,46 @@ class AgentSdk {
     const payload = await this.database.getManagerContext(taskId);
     return this.envelope("task", "get", payload);
   }
+  async getWorkPolicy(projectId, environment = "local") {
+    const payload = await this.database.getWorkPolicy(projectId, environment);
+    return this.envelope("work_day", "get", payload);
+  }
+  async upsertWorkPolicy(request) {
+    const payload = await this.database.upsertWorkPolicy(request);
+    return this.envelope("work_day", "update", payload);
+  }
+  async listPriorityOverrides(projectId) {
+    const payload = await this.database.listPriorityOverrides(projectId);
+    return this.envelope("task", "search", payload, { count: payload.length });
+  }
+  async upsertPriorityOverride(request) {
+    const payload = await this.database.upsertPriorityOverride(request);
+    return this.envelope("task", "update", payload);
+  }
+  async createPrioritySnapshot(request) {
+    const payload = await this.database.createPrioritySnapshot(request);
+    return this.envelope("report", "create", payload);
+  }
+  async getLatestPrioritySnapshot(projectId, workDayId) {
+    const payload = await this.database.getLatestPrioritySnapshot(projectId, workDayId);
+    return this.envelope("report", "get", payload);
+  }
+  async recordTaskCredits(request) {
+    const payload = await this.database.recordTaskCredits(request);
+    return this.envelope("report", "create", payload);
+  }
+  async listTaskCredits(workDayId) {
+    const payload = await this.database.listTaskCredits(workDayId);
+    return this.envelope("report", "search", payload, { count: payload.length });
+  }
+  async recordScaleDecision(request) {
+    const payload = await this.database.recordScaleDecision(request);
+    return this.envelope("report", "create", payload);
+  }
+  async getLatestScaleDecision(projectId, environment, poolName) {
+    const payload = await this.database.getLatestScaleDecision(projectId, environment, poolName);
+    return this.envelope("report", "get", payload);
+  }
   async listAgentSpecs(options) {
     const rawEntries = await this.listRawAgentSpecs(options);
     return rawEntries.map((entry) => normalizeAgentSpec(entry)).filter((entry) => Boolean(entry && entry.slug));

package/dist/stores/operational-store.d.ts

@@ -1,5 +1,5 @@
-import type { SdkAppendTaskEventRequest, SdkClaimTaskRequest, SdkCloseWorkDayRequest, SdkCompleteTaskRequest, SdkCreateReportRequest, SdkCreateTaskRequest, SdkFailTaskRequest, SdkGraphRunEntity, SdkReportEntity, SdkStartWorkDayRequest, SdkTaskEntity, SdkTaskEventEntity, SdkTaskOutputEntity, SdkTaskProgressRequest, SdkTaskSearchRequest, SdkWorkDayEntity } from '../sdk-types.ts';
-import { SqliteStoreBase } from './helpers.ts';
+import type { PrioritySnapshot, SdkCreatePrioritySnapshotRequest, SdkAppendTaskEventRequest, SdkClaimTaskRequest, SdkCloseWorkDayRequest, SdkCompleteTaskRequest, SdkCreateReportRequest, SdkCreateTaskRequest, SdkFailTaskRequest, SdkGraphRunEntity, SdkPriorityOverrideRequest, SdkReportEntity, SdkRecordScaleDecisionRequest, SdkRecordTaskCreditsRequest, SdkStartWorkDayRequest, SdkTaskEntity, SdkTaskEventEntity, SdkTaskOutputEntity, SdkTaskProgressRequest, SdkTaskSearchRequest, SdkUpsertWorkPolicyRequest, SdkWorkDayEntity, ScaleDecision, TaskCreditLedgerEntry, WorkdayPolicy } from '../sdk-types.ts';
+import { SqliteStoreBase, type DatabaseRow } from './helpers.ts';
 export declare class OperationalStore extends SqliteStoreBase {
     getWorkDay(id: string): Promise<SdkWorkDayEntity | null>;
     searchWorkDays(limit?: number): Promise<SdkWorkDayEntity[]>;
@@ -21,4 +21,24 @@ export declare class OperationalStore extends SqliteStoreBase {
     getLatestGraphRun(workDayId: string): Promise<SdkGraphRunEntity | null>;
     createReport(request: SdkCreateReportRequest): Promise<SdkReportEntity | null>;
     getReport(id: string): Promise<SdkReportEntity | null>;
+    getWorkPolicy(projectId: string, environment?: string): Promise<WorkdayPolicy | null>;
+    upsertWorkPolicy(request: SdkUpsertWorkPolicyRequest): Promise<WorkdayPolicy | null>;
+    listPriorityOverrides(projectId: string): Promise<DatabaseRow[]>;
+    upsertPriorityOverride(request: SdkPriorityOverrideRequest): Promise<{
+        id: string;
+        projectId: string;
+        model: string;
+        subjectId: string;
+        priority: number;
+        estimatedCredits: number | null;
+        metadata: Record<string, unknown>;
+        createdAt: string;
+        updatedAt: string;
+    } | null>;
+    createPrioritySnapshot(request: SdkCreatePrioritySnapshotRequest): Promise<PrioritySnapshot | null>;
+    getLatestPrioritySnapshot(projectId: string, workDayId?: string | null): Promise<PrioritySnapshot | null>;
+    recordTaskCredits(request: SdkRecordTaskCreditsRequest): Promise<TaskCreditLedgerEntry | null>;
+    listTaskCredits(workDayId: string): Promise<TaskCreditLedgerEntry[]>;
+    recordScaleDecision(request: SdkRecordScaleDecisionRequest): Promise<ScaleDecision | null>;
+    getLatestScaleDecision(projectId: string, environment: string, poolName: string): Promise<ScaleDecision | null>;
 }

package/dist/stores/operational-store.js

@@ -88,6 +88,78 @@ function reportFromRow(row) {
     createdAt: String(row.created_at ?? row.createdAt ?? nowIso())
   };
 }
+function parseJsonValue(value, fallback) {
+  if (typeof value !== "string" || !value.trim()) {
+    return fallback;
+  }
+  try {
+    return JSON.parse(value);
+  } catch {
+    return fallback;
+  }
+}
+function normalizeAutoscale(value, fallback) {
+  return {
+    minWorkers: Number(value?.minWorkers ?? fallback?.minWorkers ?? 0),
+    maxWorkers: Number(value?.maxWorkers ?? fallback?.maxWorkers ?? 1),
+    targetQueueDepth: Number(value?.targetQueueDepth ?? fallback?.targetQueueDepth ?? 1),
+    cooldownSeconds: Number(value?.cooldownSeconds ?? fallback?.cooldownSeconds ?? 60)
+  };
+}
+function workPolicyFromRow(row) {
+  return {
+    projectId: String(row.project_id ?? ""),
+    environment: String(row.environment ?? "local"),
+    schedule: parseJsonValue(row.schedule_json, {
+      timezone: "UTC",
+      windows: []
+    }),
+    dailyTaskCreditBudget: Number(row.daily_task_credit_budget ?? 0),
+    maxQueuedTasks: Number(row.max_queued_tasks ?? 0),
+    maxQueuedCredits: Number(row.max_queued_credits ?? 0),
+    autoscale: normalizeAutoscale(parseJsonValue(row.autoscale_json, {})),
+    creditWeights: parseJsonValue(row.credit_weights_json, []),
+    metadata: parseJsonValue(row.metadata_json, {})
+  };
+}
+function prioritySnapshotFromRow(row) {
+  const payload = parseJsonValue(row.snapshot_json, {});
+  return {
+    id: String(row.id ?? ""),
+    projectId: String(row.project_id ?? ""),
+    workDayId: row.work_day_id !== void 0 && row.work_day_id !== null ? String(row.work_day_id) : null,
+    generatedAt: String(row.generated_at ?? row.created_at ?? nowIso()),
+    items: Array.isArray(payload.items) ? payload.items : [],
+    metadata: parseJsonValue(row.metadata_json, {})
+  };
+}
+function taskCreditLedgerEntryFromRow(row) {
+  return {
+    id: String(row.id ?? ""),
+    projectId: String(row.project_id ?? ""),
+    workDayId: String(row.work_day_id ?? ""),
+    taskId: row.task_id !== void 0 && row.task_id !== null ? String(row.task_id) : null,
+    phase: String(row.phase ?? "seed"),
+    credits: Number(row.credits ?? 0),
+    metadata: parseJsonValue(row.metadata_json, {}),
+    createdAt: String(row.created_at ?? nowIso())
+  };
+}
+function scaleDecisionFromRow(row) {
+  return {
+    id: String(row.id ?? ""),
+    projectId: String(row.project_id ?? ""),
+    environment: String(row.environment ?? "local"),
+    poolName: String(row.pool_name ?? ""),
+    workDayId: row.work_day_id !== void 0 && row.work_day_id !== null ? String(row.work_day_id) : null,
+    desiredWorkers: Number(row.desired_workers ?? 0),
+    observedQueueDepth: Number(row.observed_queue_depth ?? 0),
+    observedActiveLeases: Number(row.observed_active_leases ?? 0),
+    reason: String(row.reason ?? "reconcile"),
+    metadata: parseJsonValue(row.metadata_json, {}),
+    createdAt: String(row.created_at ?? nowIso())
+  };
+}
 class OperationalStore extends SqliteStoreBase {
   async getWorkDay(id) {
     const row = await this.selectFirst(`SELECT * FROM work_days WHERE id = ${toSqlValue(id)} LIMIT 1`);
@@ -273,6 +345,169 @@ class OperationalStore extends SqliteStoreBase {
     const row = await this.selectFirst(`SELECT * FROM reports WHERE id = ${toSqlValue(id)} LIMIT 1`);
     return row ? reportFromRow(row) : null;
   }
+  async getWorkPolicy(projectId, environment = "local") {
+    if (!await this.tableExists("work_policies")) {
+      return null;
+    }
+    const row = await this.selectFirst(
+      `SELECT * FROM work_policies WHERE project_id = ${toSqlValue(projectId)} AND environment = ${toSqlValue(environment)} LIMIT 1`
+    );
+    return row ? workPolicyFromRow(row) : null;
+  }
+  async upsertWorkPolicy(request) {
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT OR REPLACE INTO work_policies (
+				project_id, environment, schedule_json, daily_task_credit_budget, max_queued_tasks, max_queued_credits, autoscale_json, credit_weights_json, metadata_json, created_at, updated_at
+			) VALUES (
+				${toSqlValue(request.projectId)},
+				${toSqlValue(request.environment)},
+				${toSqlValue(json(request.schedule))},
+				${Number(request.dailyTaskCreditBudget ?? 0)},
+				${Number(request.maxQueuedTasks ?? 0)},
+				${Number(request.maxQueuedCredits ?? 0)},
+				${toSqlValue(json(request.autoscale))},
+				${toSqlValue(json(request.creditWeights ?? []))},
+				${toSqlValue(json(request.metadata ?? {}))},
+				COALESCE((SELECT created_at FROM work_policies WHERE project_id = ${toSqlValue(request.projectId)} AND environment = ${toSqlValue(request.environment)}), ${toSqlValue(timestamp)}),
+				${toSqlValue(timestamp)}
+			)`
+    );
+    return this.getWorkPolicy(request.projectId, request.environment);
+  }
+  async listPriorityOverrides(projectId) {
+    if (!await this.tableExists("priority_overrides")) {
+      return [];
+    }
+    return this.selectAll(
+      `SELECT * FROM priority_overrides WHERE project_id = ${toSqlValue(projectId)} ORDER BY priority DESC, updated_at DESC`
+    );
+  }
+  async upsertPriorityOverride(request) {
+    const id = request.id ?? crypto.randomUUID();
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT OR REPLACE INTO priority_overrides (
+				id, project_id, model, subject_id, priority, estimated_credits, metadata_json, created_at, updated_at
+			) VALUES (
+				${toSqlValue(id)},
+				${toSqlValue(request.projectId)},
+				${toSqlValue(request.model)},
+				${toSqlValue(request.subjectId)},
+				${Number(request.priority ?? 0)},
+				${toSqlValue(request.estimatedCredits ?? null)},
+				${toSqlValue(json(request.metadata ?? {}))},
+				COALESCE((SELECT created_at FROM priority_overrides WHERE id = ${toSqlValue(id)}), ${toSqlValue(timestamp)}),
+				${toSqlValue(timestamp)}
+			)`
+    );
+    const row = await this.selectFirst(`SELECT * FROM priority_overrides WHERE id = ${toSqlValue(id)} LIMIT 1`);
+    return row ? {
+      id: String(row.id ?? ""),
+      projectId: String(row.project_id ?? ""),
+      model: String(row.model ?? ""),
+      subjectId: String(row.subject_id ?? ""),
+      priority: Number(row.priority ?? 0),
+      estimatedCredits: row.estimated_credits === null || row.estimated_credits === void 0 ? null : Number(row.estimated_credits),
+      metadata: parseJsonValue(row.metadata_json, {}),
+      createdAt: String(row.created_at ?? timestamp),
+      updatedAt: String(row.updated_at ?? timestamp)
+    } : null;
+  }
+  async createPrioritySnapshot(request) {
+    const id = request.id ?? crypto.randomUUID();
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT OR REPLACE INTO priority_snapshots (
+				id, project_id, work_day_id, snapshot_json, metadata_json, generated_at, created_at, updated_at
+			) VALUES (
+				${toSqlValue(id)},
+				${toSqlValue(request.projectId)},
+				${toSqlValue(request.workDayId ?? null)},
+				${toSqlValue(json({ items: request.items }))},
+				${toSqlValue(json(request.metadata ?? {}))},
+				${toSqlValue(timestamp)},
+				COALESCE((SELECT created_at FROM priority_snapshots WHERE id = ${toSqlValue(id)}), ${toSqlValue(timestamp)}),
+				${toSqlValue(timestamp)}
+			)`
+    );
+    const row = await this.selectFirst(`SELECT * FROM priority_snapshots WHERE id = ${toSqlValue(id)} LIMIT 1`);
+    return row ? prioritySnapshotFromRow(row) : null;
+  }
+  async getLatestPrioritySnapshot(projectId, workDayId) {
+    if (!await this.tableExists("priority_snapshots")) {
+      return null;
+    }
+    const row = await this.selectFirst(
+      `SELECT * FROM priority_snapshots WHERE project_id = ${toSqlValue(projectId)}${workDayId ? ` AND work_day_id = ${toSqlValue(workDayId)}` : ""} ORDER BY generated_at DESC LIMIT 1`
+    );
+    return row ? prioritySnapshotFromRow(row) : null;
+  }
+  async recordTaskCredits(request) {
+    const id = request.id ?? crypto.randomUUID();
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT INTO task_credit_ledger (
+				id, project_id, work_day_id, task_id, phase, credits, metadata_json, created_at
+			) VALUES (
+				${toSqlValue(id)},
+				${toSqlValue(request.projectId)},
+				${toSqlValue(request.workDayId)},
+				${toSqlValue(request.taskId ?? null)},
+				${toSqlValue(request.phase)},
+				${Number(request.credits ?? 0)},
+				${toSqlValue(json(request.metadata ?? {}))},
+				${toSqlValue(timestamp)}
+			)`
+    );
+    const delta = request.phase === "refund" ? -Math.abs(Number(request.credits ?? 0)) : Math.abs(Number(request.credits ?? 0));
+    await this.execute(
+      `UPDATE work_days SET capacity_used = MAX(0, capacity_used + ${delta}), updated_at = ${toSqlValue(timestamp)} WHERE id = ${toSqlValue(request.workDayId)}`
+    );
+    const row = await this.selectFirst(`SELECT * FROM task_credit_ledger WHERE id = ${toSqlValue(id)} LIMIT 1`);
+    return row ? taskCreditLedgerEntryFromRow(row) : null;
+  }
+  async listTaskCredits(workDayId) {
+    if (!await this.tableExists("task_credit_ledger")) {
+      return [];
+    }
+    const rows = await this.selectAll(
+      `SELECT * FROM task_credit_ledger WHERE work_day_id = ${toSqlValue(workDayId)} ORDER BY created_at ASC`
+    );
+    return rows.map(taskCreditLedgerEntryFromRow);
+  }
+  async recordScaleDecision(request) {
+    const id = request.id ?? crypto.randomUUID();
+    const timestamp = nowIso();
+    await this.execute(
+      `INSERT INTO scale_decisions (
+				id, project_id, environment, pool_name, work_day_id, desired_workers, observed_queue_depth, observed_active_leases, reason, metadata_json, created_at
+			) VALUES (
+				${toSqlValue(id)},
+				${toSqlValue(request.projectId)},
+				${toSqlValue(request.environment)},
+				${toSqlValue(request.poolName)},
+				${toSqlValue(request.workDayId ?? null)},
+				${Number(request.desiredWorkers ?? 0)},
+				${Number(request.observedQueueDepth ?? 0)},
+				${Number(request.observedActiveLeases ?? 0)},
+				${toSqlValue(request.reason)},
+				${toSqlValue(json(request.metadata ?? {}))},
+				${toSqlValue(timestamp)}
+			)`
+    );
+    const row = await this.selectFirst(`SELECT * FROM scale_decisions WHERE id = ${toSqlValue(id)} LIMIT 1`);
+    return row ? scaleDecisionFromRow(row) : null;
+  }
+  async getLatestScaleDecision(projectId, environment, poolName) {
+    if (!await this.tableExists("scale_decisions")) {
+      return null;
+    }
+    const row = await this.selectFirst(
+      `SELECT * FROM scale_decisions WHERE project_id = ${toSqlValue(projectId)} AND environment = ${toSqlValue(environment)} AND pool_name = ${toSqlValue(poolName)} ORDER BY created_at DESC LIMIT 1`
+    );
+    return row ? scaleDecisionFromRow(row) : null;
+  }
 }
 export {
   OperationalStore

package/dist/template-catalog.js

@@ -67,7 +67,14 @@ function normalizeTemplateCatalogEntry(value) {
     minCoreVersion: optionalString(record.minCoreVersion),
     fulfillment: {
       mode: optionalString(fulfillment.mode),
-      source: {
+      source: optionalString(source.kind) === "r2" ? {
+        kind: "r2",
+        bucket: optionalString(source.bucket),
+        objectKey: expectString(source.objectKey, "fulfillment.source.objectKey"),
+        version: expectString(source.version, "fulfillment.source.version"),
+        publicUrl: optionalString(source.publicUrl),
+        integrity: optionalString(source.integrity)
+      } : {
         kind: "git",
         repoUrl: expectString(source.repoUrl, "fulfillment.source.repoUrl"),
         directory: expectString(source.directory, "fulfillment.source.directory"),

package/dist/treeseed/template-catalog/templates/starter-basic/template/treeseed.site.yaml

@@ -2,9 +2,27 @@ name: __SITE_NAME__
 slug: __SITE_SLUG__
 siteUrl: __SITE_URL__
 contactEmail: __CONTACT_EMAIL__
+hosting:
+  kind: hosted_project
+  registration: optional
+  marketBaseUrl: https://api.treeseed.ai
+  teamId: __SITE_SLUG__
+  projectId: __SITE_SLUG__
 cloudflare:
   accountId: replace-with-cloudflare-account-id
   workerName: __SITE_SLUG__
+  pages:
+    projectName: __SITE_SLUG__
+    previewProjectName: __SITE_SLUG__-staging
+    productionBranch: main
+    stagingBranch: staging
+    buildOutputDir: dist
+  r2:
+    binding: TREESEED_CONTENT_BUCKET
+    bucketName: __SITE_SLUG__-content
+    manifestKeyTemplate: teams/{teamId}/published/common.json
+    previewRootTemplate: teams/{teamId}/previews
+    previewTtlHours: 168
 plugins:
   - package: '@treeseed/sdk/plugin-default'
 providers:
@@ -18,6 +36,8 @@ providers:
     research: stub
   deploy: cloudflare
   content:
+    runtime: team_scoped_r2_overlay
+    publish: team_scoped_r2_overlay
     docs: default
   site: default
 smtp:

package/dist/types/cloudflare.d.ts

@@ -22,11 +22,34 @@ export interface D1DatabaseLike {
 export interface CloudflareRuntimeAssets {
     fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
 }
+export interface R2ObjectBodyLike {
+    text(): Promise<string>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    json<T = unknown>(): Promise<T>;
+}
+export interface R2ObjectLike extends R2ObjectBodyLike {
+    httpEtag?: string;
+    etag?: string;
+    size?: number;
+    uploaded?: Date;
+    writeHttpMetadata?(headers: Headers): void;
+}
+export interface R2PutOptionsLike {
+    httpMetadata?: Record<string, unknown>;
+    customMetadata?: Record<string, string>;
+}
+export interface R2BucketLike {
+    get(key: string): Promise<R2ObjectLike | null>;
+    head?(key: string): Promise<R2ObjectLike | null>;
+    put(key: string, value: string | ArrayBuffer | ArrayBufferView | ReadableStream, options?: R2PutOptionsLike): Promise<unknown>;
+    delete?(key: string | string[]): Promise<void>;
+}
 export interface CloudflareRuntime {
     env: {
         FORM_GUARD_KV: KvNamespaceLike;
         SITE_DATA_DB: D1DatabaseLike;
         SESSION: KvNamespaceLike;
         ASSETS?: CloudflareRuntimeAssets;
+        [key: string]: unknown;
     };
 }

package/dist/workflow/operations.d.ts

@@ -30,7 +30,7 @@ export declare function workflowTasks(helpers: WorkflowOperationHelpers): Promis
 export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?: TreeseedConfigInput): Promise<TreeseedWorkflowResult<{
     mode: string;
     scopes: ("local" | "staging" | "prod")[];
-    sync: "all" | "cloudflare" | "railway" | "none" | "github";
+    sync: "none" | "cloudflare" | "railway" | "github" | "all";
     configPath: string;
     keyPath: string;
     repairs: import("../operations/services/config-runtime.ts").TreeseedRepairAction[];
@@ -79,6 +79,12 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
         }>;
         connectionChecks: ReturnType<typeof checkTreeseedProviderConnections>[];
         validationByScope: Record<import("../operations/services/config-runtime.ts").TreeseedConfigScope, ReturnType<typeof import("../platform/environment.ts").validateTreeseedEnvironmentValues>>;
+        readinessByScope: Record<import("../operations/services/config-runtime.ts").TreeseedConfigScope, {
+            configured: boolean;
+            provisioned: boolean;
+            deployable: boolean;
+            checks: Record<string, unknown>;
+        }>;
         updated: {
             scope: import("../operations/services/config-runtime.ts").TreeseedConfigScope | "shared";
             id: string;
@@ -133,7 +139,7 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
     payload: {
         mode: string;
         scopes: ("local" | "staging" | "prod")[];
-        sync: "all" | "cloudflare" | "railway" | "none" | "github";
+        sync: "none" | "cloudflare" | "railway" | "github" | "all";
         secretsRevealed: boolean;
         reports: {
             scope: "local" | "staging" | "prod";
@@ -196,7 +202,7 @@ export declare function workflowConfig(helpers: WorkflowOperationHelpers, input?
     payload: {
         mode: string;
         scopes: ("local" | "staging" | "prod")[];
-        sync: "all" | "cloudflare" | "railway" | "none" | "github";
+        sync: "none" | "cloudflare" | "railway" | "github" | "all";
         keyPath: string;
         repairs: import("../operations/services/config-runtime.ts").TreeseedRepairAction[];
         preflight: {
@@ -455,9 +461,12 @@ export declare function workflowDestroy(helpers: WorkflowOperationHelpers, input
                 workerName: any;
                 siteUrl: any;
                 accountId: any;
+                pages: any;
                 formGuardKv: any;
                 sessionKv: any;
                 siteDataDb: any;
+                queue: any;
+                content: any;
             };
             operations: {
                 worker: {

package/dist/workflow/policy.d.ts

@@ -9,4 +9,4 @@ export type TreeseedResolvedWorkflowPaths = {
 };
 export declare function classifyTreeseedBranchRole(branchName: string | null, repoDir: string | null): TreeseedWorkflowBranchRole;
 export declare function resolveTreeseedWorkflowPaths(startCwd: string): TreeseedResolvedWorkflowPaths;
-export declare function workflowEnvironmentForBranchRole(branchRole: TreeseedWorkflowBranchRole): "local" | "staging" | "prod" | "none";
+export declare function workflowEnvironmentForBranchRole(branchRole: TreeseedWorkflowBranchRole): "local" | "none" | "staging" | "prod";

package/dist/workflow-state.js

@@ -88,6 +88,7 @@ function resolveTreeseedWorkflowState(cwd) {
       agents: { enabled: false, initialized: false, lastDeploymentTimestamp: null, lastDeployedUrl: null, provider: null },
       manager: { enabled: false, initialized: false, lastDeploymentTimestamp: null, lastDeployedUrl: null, provider: null },
       worker: { enabled: false, initialized: false, lastDeploymentTimestamp: null, lastDeployedUrl: null, provider: null },
+      runner: { enabled: false, initialized: false, lastDeploymentTimestamp: null, lastDeployedUrl: null, provider: null },
       workdayStart: { enabled: false, initialized: false, lastDeploymentTimestamp: null, lastDeployedUrl: null, provider: null },
       workdayReport: { enabled: false, initialized: false, lastDeploymentTimestamp: null, lastDeployedUrl: null, provider: null }
     },
@@ -128,7 +129,7 @@ function resolveTreeseedWorkflowState(cwd) {
             url: typeof latestHistory?.url === "string" ? latestHistory.url : deployState.lastDeployedUrl ?? null
           });
         }
-        for (const serviceKey of ["api", "agents", "manager", "worker", "workdayStart", "workdayReport"]) {
+        for (const serviceKey of ["api", "agents", "manager", "worker", "runner", "workdayStart", "workdayReport"]) {
           const service = deployState.services?.[serviceKey];
           if (!service) continue;
           state.managedServices[serviceKey] = {