@treeseed/core 0.4.13 → 0.5.3

package/dist/agents/adapters/notification.d.ts

@@ -8,4 +8,19 @@ export declare class StubNotificationAdapter implements AgentNotificationAdapter
         deliveredCount: number;
     }>;
 }
-export declare function createNotificationAdapter(): StubNotificationAdapter;
+export declare class SdkMessageNotificationAdapter implements AgentNotificationAdapter {
+    deliver(input: {
+        agent: {
+            slug: string;
+        };
+        runId: string;
+        recipients: string[];
+        subject: string;
+        body: string;
+    }): Promise<{
+        status: "completed";
+        summary: string;
+        deliveredCount: number;
+    }>;
+}
+export declare function createNotificationAdapter(): StubNotificationAdapter | SdkMessageNotificationAdapter;

package/dist/agents/adapters/notification.js

@@ -1,3 +1,6 @@
+import { AgentSdk } from "@treeseed/sdk";
+import { resolveTreeseedTenantRoot } from "@treeseed/sdk/platform/tenant-config";
+import { getTreeseedAgentProviderSelections } from "@treeseed/sdk/platform/deploy-runtime";
 class StubNotificationAdapter {
   async deliver(input) {
     return {
@@ -7,10 +10,37 @@ class StubNotificationAdapter {
     };
   }
 }
+class SdkMessageNotificationAdapter {
+  async deliver(input) {
+    const sdk = AgentSdk.createLocal({ repoRoot: resolveTreeseedTenantRoot() });
+    await sdk.createMessage({
+      type: "agent.notification",
+      payload: {
+        agentSlug: input.agent.slug,
+        runId: input.runId,
+        recipients: input.recipients,
+        subject: input.subject,
+        body: input.body,
+        summary: `Prepared ${input.recipients.length} notification(s).`
+      },
+      relatedModel: "agent",
+      relatedId: input.agent.slug,
+      actor: "agent"
+    });
+    return {
+      status: "completed",
+      summary: input.recipients.length ? `Prepared ${input.recipients.length} notification(s).` : "Notification recorded without recipients.",
+      deliveredCount: input.recipients.length
+    };
+  }
+}
 function createNotificationAdapter() {
-  return new StubNotificationAdapter();
+  return String(
+    process.env.TREESEED_AGENT_NOTIFICATION_PROVIDER ?? getTreeseedAgentProviderSelections().notification
+  ).toLowerCase() === "sdk_message" ? new SdkMessageNotificationAdapter() : new StubNotificationAdapter();
 }
 export {
+  SdkMessageNotificationAdapter,
   StubNotificationAdapter,
   createNotificationAdapter
 };

package/dist/agents/adapters/research.d.ts

@@ -11,4 +11,16 @@ export declare class StubResearchAdapter implements AgentResearchAdapter {
         sources: any[];
     }>;
 }
-export declare function createResearchAdapter(): StubResearchAdapter;
+export declare class ProjectGraphResearchAdapter implements AgentResearchAdapter {
+    research(input: {
+        questionId: string;
+        reason: string | null;
+        runId: string;
+    }): Promise<{
+        status: "completed";
+        summary: string;
+        markdown: string;
+        sources: any;
+    }>;
+}
+export declare function createResearchAdapter(): StubResearchAdapter | ProjectGraphResearchAdapter;

package/dist/agents/adapters/research.js

@@ -1,3 +1,6 @@
+import { AgentSdk } from "@treeseed/sdk";
+import { resolveTreeseedTenantRoot } from "@treeseed/sdk/platform/tenant-config";
+import { getTreeseedAgentProviderSelections } from "@treeseed/sdk/platform/deploy-runtime";
 class StubResearchAdapter {
   async research(input) {
     return {
@@ -16,10 +19,41 @@ class StubResearchAdapter {
     };
   }
 }
+class ProjectGraphResearchAdapter {
+  async research(input) {
+    const repoRoot = resolveTreeseedTenantRoot();
+    const sdk = AgentSdk.createLocal({ repoRoot });
+    const graphResult = await sdk.queryGraph({
+      query: input.questionId,
+      options: {
+        limit: 5
+      }
+    }).catch(() => null);
+    const items = Array.isArray(graphResult?.items) ? graphResult.items : [];
+    return {
+      status: "completed",
+      summary: `Graph-backed research prepared for ${input.questionId}.`,
+      markdown: [
+        "# Research Summary",
+        "",
+        `Question: ${input.questionId}`,
+        `Reason: ${input.reason ?? "not provided"}`,
+        `Run: ${input.runId}`,
+        "",
+        items.length ? "Relevant graph context:" : "No ranked graph context was available. The question is still recorded for follow-up.",
+        ...items.map((item) => `- ${String(item.title ?? item.id ?? "context")}`)
+      ].join("\n"),
+      sources: items.map((item) => String(item.id ?? item.title ?? "")).filter(Boolean)
+    };
+  }
+}
 function createResearchAdapter() {
-  return new StubResearchAdapter();
+  return String(
+    process.env.TREESEED_AGENT_RESEARCH_PROVIDER ?? getTreeseedAgentProviderSelections().research
+  ).toLowerCase() === "project_graph" ? new ProjectGraphResearchAdapter() : new StubResearchAdapter();
 }
 export {
+  ProjectGraphResearchAdapter,
   StubResearchAdapter,
   createResearchAdapter
 };

package/dist/agents/contracts/run.d.ts

@@ -18,3 +18,4 @@ export interface AgentRunTrace {
     finishedAt: string | null;
     status: string;
 }
+export {};

package/dist/agents/kernel/agent-kernel.d.ts

@@ -1,4 +1,4 @@
-import type { AgentExecutionAdapter, AgentMutationAdapter, AgentNotificationAdapter, AgentRepositoryInspectionAdapter, AgentResearchAdapter, AgentVerificationAdapter } from '../runtime-types.ts';
+import type { AgentExecutionAdapter, AgentMutationAdapter, AgentNotificationAdapter, AgentRepositoryInspectionAdapter, AgentResearchAdapter, AgentTriggerInvocation, AgentVerificationAdapter } from '../runtime-types.ts';
 import { AgentSdk } from '@treeseed/sdk/sdk';
 export declare class AgentKernel {
     private readonly sdk;
@@ -34,7 +34,7 @@ export declare class AgentKernel {
     private buildTrace;
     private categorizeError;
     private executeAgent;
-    runAgent(slug: string, mode?: 'auto' | 'manual'): Promise<{
+    runAgent(slug: string, mode?: 'auto' | 'manual', invocation?: AgentTriggerInvocation | null): Promise<{
         status: string;
         summary: string;
     }>;

package/dist/agents/kernel/agent-kernel.js

@@ -6,7 +6,7 @@ import { createResearchAdapter } from "../adapters/research.js";
 import { createVerificationAdapter } from "../adapters/verification.js";
 import { resolveAgentHandler } from "../registry.js";
 import { AgentSdk } from "@treeseed/sdk/sdk";
-import { resolveTriggerDecision } from "./trigger-resolver.js";
+import { followCursorKey, resolveTriggerDecision } from "./trigger-resolver.js";
 import { loadActiveAgentSpecs, loadAllAgentSpecs, summarizeAgentSpec } from "../spec-loader.js";
 import { getTreeseedAgentProviderSelections } from "@treeseed/sdk/platform/deploy-runtime";
 import { resolveAgentRuntimeProviders } from "../../agent-runtime.js";
@@ -170,6 +170,13 @@ class AgentKernel {
         cursorKey: "last_run_at",
         cursorValue: nowIso()
       });
+      if (trigger.kind === "follow") {
+        await this.sdk.upsertCursor({
+          agentSlug: agent.slug,
+          cursorKey: followCursorKey(trigger.followModels),
+          cursorValue: nowIso()
+        });
+      }
       this.lastRunAt.set(agent.slug, Date.now());
       return output;
     } catch (error) {
@@ -192,7 +199,7 @@ class AgentKernel {
       this.activeRuns.delete(agent.slug);
     }
   }
-  async runAgent(slug, mode = "manual") {
+  async runAgent(slug, mode = "manual", invocation) {
     const { specs, diagnostics } = await loadActiveAgentSpecs(this.sdk);
     const errors = diagnostics.filter((entry) => entry.severity === "error");
     if (errors.length) {
@@ -205,7 +212,7 @@ class AgentKernel {
     if (!agent) {
       throw new Error(`Unknown or disabled agent "${slug}".`);
     }
-    const trigger = await this.resolveTrigger(agent, mode);
+    const trigger = invocation ?? await this.resolveTrigger(agent, mode);
     if (!trigger) {
       return {
         status: "waiting",

package/dist/agents/kernel/trigger-resolver.d.ts

@@ -15,4 +15,5 @@ export interface TriggerResolverInput {
     lastRunAt?: number;
     sdk: ScopedAgentSdk;
 }
+export declare function followCursorKey(models: string[] | undefined): string;
 export declare function resolveTriggerDecision(input: TriggerResolverInput): Promise<TriggerDecision>;

package/dist/agents/kernel/trigger-resolver.js

@@ -1,4 +1,7 @@
 import crypto from "node:crypto";
+function followCursorKey(models) {
+  return `follow:${(models ?? []).join(",") || "all"}`;
+}
 function buildManualInvocation(agent) {
   const scheduleLike = agent.triggers.find((trigger) => trigger.type === "schedule" || trigger.type === "startup");
   if (!scheduleLike) {
@@ -44,7 +47,7 @@ async function resolveFollowTrigger(agent, sdk, trigger) {
   const models = trigger.models ?? [];
   const since = (await sdk.getCursor({
     agentSlug: agent.slug,
-    cursorKey: `follow:${models.join(",") || "all"}`
+    cursorKey: followCursorKey(models)
   })).payload ?? trigger.sinceField ?? (/* @__PURE__ */ new Date(0)).toISOString();
   for (const model of models) {
     const followed = await sdk.follow({
@@ -149,5 +152,6 @@ async function resolveTriggerDecision(input) {
   };
 }
 export {
+  followCursorKey,
   resolveTriggerDecision
 };

package/dist/agents/runtime-types.d.ts

@@ -115,3 +115,4 @@ export interface AgentHandler<TInputs = unknown, TResult = unknown> {
     execute(context: AgentContext, inputs: TInputs): Promise<TResult>;
     emitOutputs(context: AgentContext, result: TResult): Promise<AgentExecutionResult>;
 }
+export {};

package/dist/api/app.js

@@ -6,6 +6,7 @@ import { resolveApiConfig } from "./config.js";
 import { bearerTokenFromRequest, jsonError, requirePermission, requireScope } from "./http.js";
 import { registerOperationRoutes } from "./operations-routes.js";
 import { resolveApiRuntimeProviders } from "./providers.js";
+import { registerProjectRoutes } from "./project-routes.js";
 import { registerSdkRoutes } from "./sdk-routes.js";
 import { loadTemplateCatalog } from "./templates.js";
 function mergeApiOptions(options) {
@@ -29,6 +30,7 @@ function mergeApiOptions(options) {
       sdk: true,
       agent: true,
       operations: true,
+      project: true,
       ...options.surfaces ?? {}
     },
     scopes: {
@@ -303,11 +305,19 @@ function createTreeseedApiApp(options = {}) {
   }
   if (resolved.surfaces.operations) {
     registerOperationRoutes(app, {
+      config: resolved.config,
       scope: resolved.scopes.operations,
       prefix: internalPrefix,
+      sdk: sharedSdk,
       executeOperation: options.workflowExecutor
     });
   }
+  if (resolved.surfaces.project) {
+    registerProjectRoutes(app, {
+      config: resolved.config,
+      sharedSdk
+    });
+  }
   options.extendApp?.(app, {
     resolved,
     runtimeProviders,

package/dist/api/auth/d1-store.js

@@ -620,6 +620,11 @@ class D1AuthStore {
         ...principalRecord.principal.metadata,
         actingSessionId: claims.sessionId,
         identityId: claims.identityId,
+        teamId: claims.teamId ?? null,
+        projectId: claims.projectId ?? null,
+        membershipId: claims.membershipId ?? null,
+        teamRoles: [...new Set((claims.teamRoles ?? []).filter((entry) => typeof entry === "string" && entry.trim()))],
+        teamCapabilities: [...new Set((claims.teamCapabilities ?? []).filter((entry) => typeof entry === "string" && entry.trim()))],
         authTime: claims.authTime
       },
       iat: Math.floor(Date.now() / 1e3),

package/dist/api/auth/memory-provider.js

@@ -208,7 +208,12 @@ class MemoryDeviceCodeAuthProvider {
       permissions: ["auth:read:self"],
       metadata: {
         sessionId: claims.sessionId,
-        identityId: claims.identityId
+        identityId: claims.identityId,
+        teamId: claims.teamId ?? null,
+        projectId: claims.projectId ?? null,
+        membershipId: claims.membershipId ?? null,
+        teamRoles: claims.teamRoles ?? [],
+        teamCapabilities: claims.teamCapabilities ?? []
       }
     };
     const expiresAt = nowSeconds() + this.config.accessTokenTtlSeconds;

package/dist/api/auth/rbac.d.ts

@@ -1,6 +1,6 @@
-export declare const CONTENT_RESOURCES: readonly ["pages", "notes", "questions", "objectives", "people", "agents", "books", "templates", "knowledge_packs", "workdays"];
+export declare const CONTENT_RESOURCES: readonly ["pages", "notes", "questions", "objectives", "proposals", "decisions", "people", "agents", "books", "templates", "knowledge_packs", "workdays"];
 export declare const PLATFORM_RESOURCES: readonly ["users", "roles", "api_tokens", "services", "jobs", "audit", "auth", "sdk", "agent", "operations"];
-export declare const ALL_PERMISSION_RESOURCES: readonly ["pages", "notes", "questions", "objectives", "people", "agents", "books", "templates", "knowledge_packs", "workdays", "users", "roles", "api_tokens", "services", "jobs", "audit", "auth", "sdk", "agent", "operations"];
+export declare const ALL_PERMISSION_RESOURCES: readonly ["pages", "notes", "questions", "objectives", "proposals", "decisions", "people", "agents", "books", "templates", "knowledge_packs", "workdays", "users", "roles", "api_tokens", "services", "jobs", "audit", "auth", "sdk", "agent", "operations"];
 export type PermissionResource = (typeof ALL_PERMISSION_RESOURCES)[number];
 export type PermissionAction = 'read' | 'create' | 'update' | 'delete' | 'manage' | 'execute' | 'impersonate';
 export type PermissionScope = 'self' | 'global';

package/dist/api/auth/rbac.js

@@ -3,6 +3,8 @@ const CONTENT_RESOURCES = [
   "notes",
   "questions",
   "objectives",
+  "proposals",
+  "decisions",
   "people",
   "agents",
   "books",

package/dist/api/capabilities.d.ts

@@ -0,0 +1,9 @@
+import type { ApiPrincipal } from '@treeseed/sdk/remote';
+import { type ApiContext } from './http.ts';
+export declare function principalTeamCapabilities(principal: ApiPrincipal | null): string[];
+export declare function principalTeamRoles(principal: ApiPrincipal | null): string[];
+export declare function hasTeamCapability(principal: ApiPrincipal | null, capability: string): boolean;
+export declare function requireTeamCapability(c: ApiContext, capability: string): Response & import("hono").TypedResponse<{
+    ok: false;
+    error: string;
+}, never, "json">;

package/dist/api/capabilities.js

@@ -0,0 +1,33 @@
+import { jsonError } from "./http.js";
+function stringArray(value) {
+  return Array.isArray(value) ? [...new Set(value.filter((entry) => typeof entry === "string" && entry.trim().length > 0))] : [];
+}
+function principalTeamCapabilities(principal) {
+  return stringArray(principal?.metadata?.teamCapabilities);
+}
+function principalTeamRoles(principal) {
+  return stringArray(principal?.metadata?.teamRoles);
+}
+function hasTeamCapability(principal, capability) {
+  if (!principal) return false;
+  if (principal.permissions.includes("*:*:*") || principal.roles.includes("project_api") || principal.roles.includes("platform_admin")) {
+    return true;
+  }
+  const capabilities = principalTeamCapabilities(principal);
+  if (capabilities.includes(capability)) {
+    return true;
+  }
+  return principalTeamRoles(principal).includes("team_owner");
+}
+function requireTeamCapability(c, capability) {
+  if (!hasTeamCapability(c.get("principal"), capability)) {
+    return jsonError(c, 403, "Permission denied.", { capability });
+  }
+  return null;
+}
+export {
+  hasTeamCapability,
+  principalTeamCapabilities,
+  principalTeamRoles,
+  requireTeamCapability
+};

package/dist/api/operations-routes.d.ts

@@ -1,7 +1,11 @@
 import type { Hono } from 'hono';
+import type { AgentSdk } from '@treeseed/sdk';
 import { executeHttpWorkflowOperation } from './operations.ts';
+import type { ApiConfig } from './types.ts';
 export declare function registerOperationRoutes(app: Hono<any>, options: {
+    config: ApiConfig;
     scope: string;
     prefix?: string;
+    sdk?: AgentSdk;
     executeOperation?: typeof executeHttpWorkflowOperation;
 }): void;

package/dist/api/operations-routes.js

@@ -1,5 +1,8 @@
-import { findTreeseedOperation } from "@treeseed/sdk";
+import crypto from "node:crypto";
+import { findDispatchCapability, findTreeseedOperation } from "@treeseed/sdk";
 import { executeHttpWorkflowOperation, isHttpWorkflowOperationAllowed } from "./operations.js";
+import { enqueueTaskFromSdk } from "../services/common.js";
+import { enqueueTaskAndEnsureCapacity } from "../services/worker-capacity.js";
 import { jsonError, requireScope } from "./http.js";
 function registerOperationRoutes(app, options) {
   const executeOperation = options.executeOperation ?? executeHttpWorkflowOperation;
@@ -25,6 +28,51 @@ function registerOperationRoutes(app, options) {
     }
     const body = await c.req.json().catch(() => ({}));
     try {
+      const capability = findDispatchCapability("workflow", resolvedOperation.name);
+      if (capability?.executionClass === "remote_job" && options.sdk) {
+        const input = body && typeof body.input === "object" ? body.input : {};
+        const idempotencyKey = typeof body.idempotencyKey === "string" && body.idempotencyKey.trim() ? body.idempotencyKey.trim() : `workflow:${resolvedOperation.name}:${crypto.createHash("sha256").update(JSON.stringify(input)).digest("hex")}`;
+        const created = await options.sdk.createTask({
+          workDayId: typeof body.workDayId === "string" ? body.workDayId : "",
+          agentId: "workflow-dispatch",
+          type: "workflow_dispatch",
+          priority: typeof body.priority === "number" ? body.priority : 75,
+          idempotencyKey,
+          payload: {
+            executionKind: "workflow_dispatch",
+            namespace: "workflow",
+            operation: resolvedOperation.name,
+            input,
+            requestedByType: c.get("actorType"),
+            requestedById: c.get("principal")?.id ?? null
+          },
+          actor: c.get("principal")?.id ?? "api"
+        });
+        if (!created.payload) {
+          return jsonError(c, 500, `Failed to create workflow task for "${resolvedOperation.name}".`, {
+            operation: resolvedOperation.name
+          });
+        }
+        const capacity = await enqueueTaskAndEnsureCapacity(options.sdk, {
+          taskId: String(created.payload.id ?? ""),
+          actor: c.get("principal")?.id ?? "api",
+          priorityClass: "interactive",
+          projectId: options.config.projectId,
+          enqueueTask: enqueueTaskFromSdk
+        });
+        return c.json({
+          ok: true,
+          mode: "task",
+          operation: resolvedOperation.name,
+          payload: created.payload,
+          workerState: capacity.workerState,
+          capacity: {
+            desiredWorkers: capacity.desiredWorkers,
+            scaleApplied: capacity.scaleApplied,
+            reason: capacity.scaleReason
+          }
+        }, { status: 202 });
+      }
       const result = await executeOperation(resolvedOperation.name, body);
       return c.json(result, { status: result.ok ? 200 : 400 });
     } catch (error) {

package/dist/api/project-routes.d.ts

@@ -0,0 +1,8 @@
+import type { Hono } from 'hono';
+import type { AgentSdk } from '@treeseed/sdk';
+import type { ApiConfig } from './types.ts';
+export declare function registerProjectRoutes(app: Hono<any>, options: {
+    config: ApiConfig;
+    sharedSdk: AgentSdk;
+    prefix?: string;
+}): void;