@treeseed/sdk 0.3.0 → 0.3.2

package/dist/index.d.ts

@@ -16,6 +16,7 @@ export { getTreeseedVerifyDriverStatus, runTreeseedVerifyDriver } from './verifi
 export * from './platform/contracts.ts';
 export * from './platform/tenant-config.ts';
 export * from './platform/deploy-config.ts';
+export * from './platform/deploy-runtime.ts';
 export * from './platform/environment.ts';
 export * from './platform/plugins.ts';
 export type { SdkContentEntry, SdkCursorEntity, SdkFilterCondition, SdkFollowRequest, SdkGraphEdge, SdkGraphEdgeType, SdkGraphDslRelation, SdkGraphDslParseResult, SdkGraphModelConfig, SdkGraphNode, SdkGraphNodeType, SdkGraphPathExplanation, SdkGraphQueryStage, SdkGraphQueryView, SdkGraphQueryOptions, SdkGraphQueryRequest, SdkGraphQueryResult, SdkGraphRankingBuildInput, SdkGraphRankingDiagnostics, SdkGraphRankingIndex, SdkGraphRankingNodeResult, SdkGraphRankingProvider, SdkGraphRankingQueryRequest, SdkGraphRankingQueryResult, SdkGraphRankingSearchRequest, SdkGraphRefreshPayload, SdkGraphRefreshRequest, SdkGraphSearchOptions, SdkGraphSearchResult, SdkGraphSeed, SdkGraphSeedResolution, SdkGraphTraversalResult, SdkGraphWhereFilter, SdkContextPack, SdkContextPackRequest, SdkGetRequest, SdkJsonEnvelope, SdkLeaseEntity, SdkManagerContextPayload, SdkMessageEntity, SdkModelFieldBinding, SdkModelDefinition, SdkModelRegistry, SdkModelName, SdkMutationRequest, SdkOperation, SdkPickRequest, SdkPickResult, SdkQueueMessageEnvelope, SdkRunEntity, SdkSearchRequest, SdkTaskEntity, SdkTaskEventEntity, SdkTaskOutputEntity, SdkWorkDayEntity, SdkGraphRunEntity, SdkReportEntity, SdkSubscriptionEntity, SdkTemplateCatalogEntry, SdkTemplateCatalogPublisher, SdkTemplateCatalogResponse, SdkTemplateCatalogSource, SdkUpdateRequest, } from './sdk-types.ts';

package/dist/index.js

@@ -50,6 +50,7 @@ import { getTreeseedVerifyDriverStatus, runTreeseedVerifyDriver } from "./verifi
 export * from "./platform/contracts.js";
 export * from "./platform/tenant-config.js";
 export * from "./platform/deploy-config.js";
+export * from "./platform/deploy-runtime.js";
 export * from "./platform/environment.js";
 export * from "./platform/plugins.js";
 export {

package/dist/platform/deploy-runtime.d.ts

@@ -0,0 +1,18 @@
+import type { TreeseedDeployConfig } from './contracts.ts';
+export declare function getTreeseedDeployConfig(): TreeseedDeployConfig;
+export declare function resetTreeseedDeployConfigForTests(): void;
+export declare function getTreeseedFormsProvider(): string;
+export declare function getTreeseedOperationsProvider(): string;
+export declare function getTreeseedAgentProviderSelections(): {
+    execution: string;
+    mutation: string;
+    repository: string;
+    verification: string;
+    notification: string;
+    research: string;
+};
+export declare function getTreeseedDeployProvider(): string;
+export declare function getTreeseedDocsProvider(): string;
+export declare function getTreeseedSiteProvider(): string;
+export declare function isTreeseedSmtpEnabled(): boolean;
+export declare function isTreeseedTurnstileEnabled(): boolean;

package/dist/platform/deploy-runtime.js

@@ -0,0 +1,78 @@
+import { loadTreeseedDeployConfig } from "./deploy/config.js";
+import { TREESEED_DEFAULT_PLUGIN_REFERENCES, TREESEED_DEFAULT_PROVIDER_SELECTIONS } from "./plugins/constants.js";
+let cachedDeployConfig = null;
+function defaultDeployConfig() {
+  return {
+    name: "Treeseed Site",
+    slug: "treeseed-site",
+    siteUrl: "https://example.com",
+    contactEmail: "contact@example.com",
+    cloudflare: {
+      accountId: "",
+      workerName: "treeseed-site"
+    },
+    plugins: [...TREESEED_DEFAULT_PLUGIN_REFERENCES],
+    providers: structuredClone(TREESEED_DEFAULT_PROVIDER_SELECTIONS),
+    smtp: {
+      enabled: false
+    },
+    turnstile: {
+      enabled: true
+    }
+  };
+}
+function getTreeseedDeployConfig() {
+  if (cachedDeployConfig) {
+    return cachedDeployConfig;
+  }
+  if (typeof __TREESEED_DEPLOY_CONFIG__ !== "undefined" && __TREESEED_DEPLOY_CONFIG__) {
+    cachedDeployConfig = __TREESEED_DEPLOY_CONFIG__;
+    return cachedDeployConfig;
+  }
+  try {
+    cachedDeployConfig = loadTreeseedDeployConfig();
+    return cachedDeployConfig;
+  } catch {
+    cachedDeployConfig = defaultDeployConfig();
+    return cachedDeployConfig;
+  }
+}
+function resetTreeseedDeployConfigForTests() {
+  cachedDeployConfig = null;
+}
+function getTreeseedFormsProvider() {
+  return getTreeseedDeployConfig().providers?.forms ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.forms;
+}
+function getTreeseedOperationsProvider() {
+  return getTreeseedDeployConfig().providers?.operations ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.operations;
+}
+function getTreeseedAgentProviderSelections() {
+  return getTreeseedDeployConfig().providers?.agents ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.agents;
+}
+function getTreeseedDeployProvider() {
+  return getTreeseedDeployConfig().providers?.deploy ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.deploy;
+}
+function getTreeseedDocsProvider() {
+  return getTreeseedDeployConfig().providers?.content?.docs ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.content.docs;
+}
+function getTreeseedSiteProvider() {
+  return getTreeseedDeployConfig().providers?.site ?? TREESEED_DEFAULT_PROVIDER_SELECTIONS.site;
+}
+function isTreeseedSmtpEnabled() {
+  return getTreeseedDeployConfig().smtp?.enabled ?? false;
+}
+function isTreeseedTurnstileEnabled() {
+  return getTreeseedDeployConfig().turnstile?.enabled ?? true;
+}
+export {
+  getTreeseedAgentProviderSelections,
+  getTreeseedDeployConfig,
+  getTreeseedDeployProvider,
+  getTreeseedDocsProvider,
+  getTreeseedFormsProvider,
+  getTreeseedOperationsProvider,
+  getTreeseedSiteProvider,
+  isTreeseedSmtpEnabled,
+  isTreeseedTurnstileEnabled,
+  resetTreeseedDeployConfigForTests
+};

package/dist/platform/plugins/runtime.js

@@ -1,9 +1,11 @@
+import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { loadTreeseedDeployConfig } from "../deploy/config.js";
 import { TREESEED_DEFAULT_PLUGIN_PACKAGE } from "./constants.js";
 const require2 = createRequire(import.meta.url);
+const runtimeDir = path.dirname(fileURLToPath(import.meta.url));
 function normalizeLoadedPlugin(moduleExports, packageName) {
   const plugin = moduleExports?.default ?? moduleExports;
   if (!plugin || typeof plugin !== "object") {
@@ -14,9 +16,46 @@ function normalizeLoadedPlugin(moduleExports, packageName) {
 function isPathLikePluginReference(packageName) {
   return packageName.startsWith(".") || packageName.startsWith("/") || packageName.startsWith("file:");
 }
+function resolveLocalDefaultPluginPath() {
+  const candidates = [
+    path.resolve(runtimeDir, "../../../../core/dist/plugin-default.js"),
+    path.resolve(runtimeDir, "../../../../dist/plugin-default.js")
+  ];
+  let current = runtimeDir;
+  while (true) {
+    const packageJsonPath = path.resolve(current, "package.json");
+    if (existsSync(packageJsonPath)) {
+      try {
+        const packageJson = require2(packageJsonPath);
+        if (packageJson?.name === "@treeseed/core") {
+          candidates.push(path.resolve(current, "dist/plugin-default.js"));
+          break;
+        }
+      } catch {
+      }
+    }
+    const parent = path.resolve(current, "..");
+    if (parent === current) {
+      break;
+    }
+    current = parent;
+  }
+  for (const candidate of candidates) {
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  return null;
+}
+function resolveInstalledPluginPath(packageName, tenantRoot) {
+  return require2.resolve(packageName, {
+    paths: [tenantRoot, process.cwd()]
+  });
+}
 function loadPluginModule(packageName, tenantRoot) {
   if (packageName === TREESEED_DEFAULT_PLUGIN_PACKAGE) {
-    const resolvedPath2 = require2.resolve(packageName);
+    const localDefaultPluginPath = resolveLocalDefaultPluginPath();
+    const resolvedPath2 = localDefaultPluginPath ?? resolveInstalledPluginPath(packageName, tenantRoot);
     return {
       moduleExports: require2(resolvedPath2),
       baseDir: path.dirname(resolvedPath2)
@@ -29,7 +68,7 @@ function loadPluginModule(packageName, tenantRoot) {
       baseDir: path.dirname(resolvedPath2)
     };
   }
-  const resolvedPath = require2.resolve(packageName);
+  const resolvedPath = resolveInstalledPluginPath(packageName, tenantRoot);
   return {
     moduleExports: require2(resolvedPath),
     baseDir: path.dirname(resolvedPath)

package/dist/platform/plugins.d.ts

@@ -1,4 +1,5 @@
 export { TREESEED_DEFAULT_PLUGIN_PACKAGE, TREESEED_DEFAULT_PLUGIN_REFERENCES, TREESEED_DEFAULT_PROVIDER_SELECTIONS, } from './plugins/constants.ts';
+export { getTreeseedAgentProviderSelections, getTreeseedDeployConfig, getTreeseedDeployProvider, getTreeseedDocsProvider, getTreeseedFormsProvider, getTreeseedOperationsProvider, getTreeseedSiteProvider, isTreeseedSmtpEnabled, isTreeseedTurnstileEnabled, resetTreeseedDeployConfigForTests, } from './deploy-runtime.ts';
 export { defineTreeseedPlugin } from './plugins/plugin.ts';
 export type * from './plugins/plugin.ts';
 export { loadTreeseedPluginRuntime, loadTreeseedPlugins, resolveTreeseedGraphRankingProvider } from './plugins/runtime.ts';

package/dist/platform/plugins.js

@@ -3,6 +3,18 @@ import {
   TREESEED_DEFAULT_PLUGIN_REFERENCES,
   TREESEED_DEFAULT_PROVIDER_SELECTIONS
 } from "./plugins/constants.js";
+import {
+  getTreeseedAgentProviderSelections,
+  getTreeseedDeployConfig,
+  getTreeseedDeployProvider,
+  getTreeseedDocsProvider,
+  getTreeseedFormsProvider,
+  getTreeseedOperationsProvider,
+  getTreeseedSiteProvider,
+  isTreeseedSmtpEnabled,
+  isTreeseedTurnstileEnabled,
+  resetTreeseedDeployConfigForTests
+} from "./deploy-runtime.js";
 import { defineTreeseedPlugin } from "./plugins/plugin.js";
 import { loadTreeseedPluginRuntime, loadTreeseedPlugins, resolveTreeseedGraphRankingProvider } from "./plugins/runtime.js";
 export {
@@ -10,7 +22,17 @@ export {
   TREESEED_DEFAULT_PLUGIN_REFERENCES,
   TREESEED_DEFAULT_PROVIDER_SELECTIONS,
   defineTreeseedPlugin,
+  getTreeseedAgentProviderSelections,
+  getTreeseedDeployConfig,
+  getTreeseedDeployProvider,
+  getTreeseedDocsProvider,
+  getTreeseedFormsProvider,
+  getTreeseedOperationsProvider,
+  getTreeseedSiteProvider,
+  isTreeseedSmtpEnabled,
+  isTreeseedTurnstileEnabled,
   loadTreeseedPluginRuntime,
   loadTreeseedPlugins,
+  resetTreeseedDeployConfigForTests,
   resolveTreeseedGraphRankingProvider
 };

package/dist/sdk-types.d.ts

@@ -569,7 +569,7 @@ export interface SdkGraphRefreshPayload {
 }
 export interface SdkCreateMessageRequest {
     type: string;
-    payload: Record<string, unknown>;
+    payload: Record<string, unknown> | string;
     relatedModel?: string | null;
     relatedId?: string | null;
     priority?: number;

package/dist/utils/agents/contracts/messages.d.ts

@@ -0,0 +1,88 @@
+export interface QuestionPriorityUpdatedMessage {
+    questionId: string;
+    reason: string;
+    plannerRunId: string;
+}
+export interface ObjectivePriorityUpdatedMessage {
+    objectiveId: string;
+    reason: string;
+    plannerRunId: string;
+}
+export interface ArchitectureUpdatedMessage {
+    objectiveId: string;
+    knowledgeId: string;
+    architectRunId: string;
+}
+export interface SubscriberNotifiedMessage {
+    email: string;
+    itemCount: number;
+    notifierRunId: string;
+}
+export interface ResearchStartedMessage {
+    questionId: string;
+    researcherRunId: string;
+}
+export interface ResearchCompletedMessage {
+    questionId: string;
+    knowledgeId: string | null;
+    researcherRunId: string;
+}
+export interface TaskCompleteMessage {
+    branchName: string | null;
+    changedTargets: string[];
+    engineerRunId: string;
+}
+export interface TaskWaitingMessage {
+    blockingReason: string;
+    engineerRunId: string;
+}
+export interface TaskFailedMessage {
+    failureSummary: string;
+    engineerRunId: string;
+}
+export interface TaskVerifiedMessage {
+    branchName: string | null;
+    reviewerRunId: string;
+}
+export interface ReviewFailedMessage {
+    failureSummary: string;
+    reviewerRunId: string;
+}
+export interface ReviewWaitingMessage {
+    blockingReason: string;
+    reviewerRunId: string;
+}
+export interface ReleaseStartedMessage {
+    taskRunId: string | null;
+    releaserRunId: string;
+}
+export interface ReleaseCompletedMessage {
+    releaseSummary: string;
+    releaserRunId: string;
+}
+export interface ReleaseFailedMessage {
+    failureSummary: string;
+    releaserRunId: string;
+}
+export interface AgentMessageContracts {
+    question_priority_updated: QuestionPriorityUpdatedMessage;
+    objective_priority_updated: ObjectivePriorityUpdatedMessage;
+    architecture_updated: ArchitectureUpdatedMessage;
+    subscriber_notified: SubscriberNotifiedMessage;
+    research_started: ResearchStartedMessage;
+    research_completed: ResearchCompletedMessage;
+    task_complete: TaskCompleteMessage;
+    task_waiting: TaskWaitingMessage;
+    task_failed: TaskFailedMessage;
+    task_verified: TaskVerifiedMessage;
+    review_failed: ReviewFailedMessage;
+    review_waiting: ReviewWaitingMessage;
+    release_started: ReleaseStartedMessage;
+    release_completed: ReleaseCompletedMessage;
+    release_failed: ReleaseFailedMessage;
+}
+export type AgentMessageType = keyof AgentMessageContracts;
+export type AgentMessagePayload<TType extends AgentMessageType> = AgentMessageContracts[TType];
+export declare const AGENT_MESSAGE_TYPES: readonly ["question_priority_updated", "objective_priority_updated", "architecture_updated", "subscriber_notified", "research_started", "research_completed", "task_complete", "task_waiting", "task_failed", "task_verified", "review_failed", "review_waiting", "release_started", "release_completed", "release_failed"];
+export declare function parseAgentMessagePayload<TType extends AgentMessageType>(type: TType, payloadJson: string): AgentMessagePayload<TType>;
+export declare function serializeAgentMessagePayload<TType extends AgentMessageType>(type: TType, payload: AgentMessagePayload<TType>): string;

package/dist/utils/agents/contracts/messages.js

@@ -0,0 +1,139 @@
+const AGENT_MESSAGE_TYPES = [
+  "question_priority_updated",
+  "objective_priority_updated",
+  "architecture_updated",
+  "subscriber_notified",
+  "research_started",
+  "research_completed",
+  "task_complete",
+  "task_waiting",
+  "task_failed",
+  "task_verified",
+  "review_failed",
+  "review_waiting",
+  "release_started",
+  "release_completed",
+  "release_failed"
+];
+function ensureString(value, label) {
+  if (typeof value !== "string" || value.trim().length === 0) {
+    throw new Error(`Invalid ${label}: expected non-empty string.`);
+  }
+  return value;
+}
+function ensureOptionalString(value, label) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  return ensureString(value, label);
+}
+function ensureStringArray(value, label) {
+  if (!Array.isArray(value)) {
+    throw new Error(`Invalid ${label}: expected array.`);
+  }
+  return value.map((entry, index) => ensureString(entry, `${label}[${index}]`));
+}
+function ensureNumber(value, label) {
+  if (typeof value !== "number" || Number.isNaN(value)) {
+    throw new Error(`Invalid ${label}: expected number.`);
+  }
+  return value;
+}
+function parseAgentMessagePayload(type, payloadJson) {
+  const decoded = JSON.parse(payloadJson);
+  const parsed = typeof decoded === "string" ? JSON.parse(decoded) : decoded;
+  switch (type) {
+    case "question_priority_updated":
+      return {
+        questionId: ensureString(parsed.questionId, "questionId"),
+        reason: ensureString(parsed.reason, "reason"),
+        plannerRunId: ensureString(parsed.plannerRunId, "plannerRunId")
+      };
+    case "objective_priority_updated":
+      return {
+        objectiveId: ensureString(parsed.objectiveId, "objectiveId"),
+        reason: ensureString(parsed.reason, "reason"),
+        plannerRunId: ensureString(parsed.plannerRunId, "plannerRunId")
+      };
+    case "architecture_updated":
+      return {
+        objectiveId: ensureString(parsed.objectiveId, "objectiveId"),
+        knowledgeId: ensureString(parsed.knowledgeId, "knowledgeId"),
+        architectRunId: ensureString(parsed.architectRunId, "architectRunId")
+      };
+    case "subscriber_notified":
+      return {
+        email: ensureString(parsed.email, "email"),
+        itemCount: ensureNumber(parsed.itemCount, "itemCount"),
+        notifierRunId: ensureString(parsed.notifierRunId, "notifierRunId")
+      };
+    case "research_started":
+      return {
+        questionId: ensureString(parsed.questionId, "questionId"),
+        researcherRunId: ensureString(parsed.researcherRunId, "researcherRunId")
+      };
+    case "research_completed":
+      return {
+        questionId: ensureString(parsed.questionId, "questionId"),
+        knowledgeId: ensureOptionalString(parsed.knowledgeId, "knowledgeId"),
+        researcherRunId: ensureString(parsed.researcherRunId, "researcherRunId")
+      };
+    case "task_complete":
+      return {
+        branchName: ensureOptionalString(parsed.branchName, "branchName"),
+        changedTargets: ensureStringArray(parsed.changedTargets, "changedTargets"),
+        engineerRunId: ensureString(parsed.engineerRunId, "engineerRunId")
+      };
+    case "task_waiting":
+      return {
+        blockingReason: ensureString(parsed.blockingReason, "blockingReason"),
+        engineerRunId: ensureString(parsed.engineerRunId, "engineerRunId")
+      };
+    case "task_failed":
+      return {
+        failureSummary: ensureString(parsed.failureSummary, "failureSummary"),
+        engineerRunId: ensureString(parsed.engineerRunId, "engineerRunId")
+      };
+    case "task_verified":
+      return {
+        branchName: ensureOptionalString(parsed.branchName, "branchName"),
+        reviewerRunId: ensureString(parsed.reviewerRunId, "reviewerRunId")
+      };
+    case "review_failed":
+      return {
+        failureSummary: ensureString(parsed.failureSummary, "failureSummary"),
+        reviewerRunId: ensureString(parsed.reviewerRunId, "reviewerRunId")
+      };
+    case "review_waiting":
+      return {
+        blockingReason: ensureString(parsed.blockingReason, "blockingReason"),
+        reviewerRunId: ensureString(parsed.reviewerRunId, "reviewerRunId")
+      };
+    case "release_started":
+      return {
+        taskRunId: ensureOptionalString(parsed.taskRunId, "taskRunId"),
+        releaserRunId: ensureString(parsed.releaserRunId, "releaserRunId")
+      };
+    case "release_completed":
+      return {
+        releaseSummary: ensureString(parsed.releaseSummary, "releaseSummary"),
+        releaserRunId: ensureString(parsed.releaserRunId, "releaserRunId")
+      };
+    case "release_failed":
+      return {
+        failureSummary: ensureString(parsed.failureSummary, "failureSummary"),
+        releaserRunId: ensureString(parsed.releaserRunId, "releaserRunId")
+      };
+    default:
+      throw new Error(`Unknown agent message type "${String(type)}".`);
+  }
+}
+function serializeAgentMessagePayload(type, payload) {
+  parseAgentMessagePayload(type, JSON.stringify(payload));
+  return JSON.stringify(payload);
+}
+export {
+  AGENT_MESSAGE_TYPES,
+  parseAgentMessagePayload,
+  serializeAgentMessagePayload
+};

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

@@ -0,0 +1,20 @@
+export type AgentErrorCategory = 'trigger_resolution_error' | 'permission_error' | 'message_claim_error' | 'lease_error' | 'execution_error' | 'mutation_error' | 'sdk_error';
+export interface AgentRunTrace {
+    [key: string]: unknown;
+    runId: string;
+    agentSlug: string;
+    handlerKind: string;
+    triggerKind: string;
+    triggerSource: string;
+    claimedMessageId: number | null;
+    selectedItemKey: string | null;
+    branchName: string | null;
+    commitSha: string | null;
+    changedPaths: string[];
+    summary: string | null;
+    error: string | null;
+    errorCategory: AgentErrorCategory | null;
+    startedAt: string;
+    finishedAt: string | null;
+    status: string;
+}

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

@@ -0,0 +1,117 @@
+import type { AgentHandlerKind, AgentRuntimeSpec, AgentRunStatus, AgentTriggerConfig } from '../../types/agents.ts';
+import type { AgentErrorCategory } from './contracts/run.ts';
+import type { ScopedAgentSdk, SdkMessageEntity } from '../../sdk.ts';
+export interface AgentTriggerInvocation {
+    kind: 'startup' | 'schedule' | 'message' | 'manual' | 'follow';
+    source: string;
+    trigger: AgentTriggerConfig;
+    message?: SdkMessageEntity | null;
+    followModels?: string[];
+    cursorValue?: string | null;
+}
+export interface AgentExecutionResult {
+    status: AgentRunStatus;
+    summary: string;
+    stdout?: string;
+    stderr?: string;
+    errorCategory?: AgentErrorCategory | null;
+    metadata?: Record<string, unknown>;
+}
+export interface AgentMutationResult {
+    branchName: string | null;
+    commitMessage: string | null;
+    worktreePath: string | null;
+    commitSha: string | null;
+    changedPaths: string[];
+}
+export interface AgentRepositoryInspectionResult {
+    branchName: string | null;
+    changedPaths: string[];
+    commitSha: string | null;
+    summary: string;
+}
+export interface AgentVerificationResult {
+    status: 'completed' | 'failed' | 'waiting';
+    summary: string;
+    stdout?: string;
+    stderr?: string;
+    errorCategory?: AgentErrorCategory | null;
+}
+export interface AgentNotificationResult {
+    status: 'completed' | 'failed' | 'waiting';
+    summary: string;
+    deliveredCount: number;
+}
+export interface AgentResearchResult {
+    status: 'completed' | 'failed' | 'waiting';
+    summary: string;
+    markdown: string;
+    sources?: string[];
+    errorCategory?: AgentErrorCategory | null;
+}
+export interface AgentExecutionAdapter {
+    runTask(input: {
+        agent: AgentRuntimeSpec;
+        runId: string;
+        prompt: string;
+    }): Promise<AgentExecutionResult>;
+}
+export interface AgentMutationAdapter {
+    writeArtifact(input: {
+        runId: string;
+        agent: AgentRuntimeSpec;
+        relativePath: string;
+        content: string;
+        commitMessage: string;
+    }): Promise<AgentMutationResult>;
+}
+export interface AgentRepositoryInspectionAdapter {
+    inspectBranch(input: {
+        repoRoot: string;
+        branchName: string | null;
+    }): Promise<AgentRepositoryInspectionResult>;
+}
+export interface AgentVerificationAdapter {
+    runChecks(input: {
+        agent: AgentRuntimeSpec;
+        runId: string;
+        commands: string[];
+    }): Promise<AgentVerificationResult>;
+}
+export interface AgentNotificationAdapter {
+    deliver(input: {
+        agent: AgentRuntimeSpec;
+        runId: string;
+        recipients: string[];
+        subject: string;
+        body: string;
+    }): Promise<AgentNotificationResult>;
+}
+export interface AgentResearchAdapter {
+    research(input: {
+        agent: AgentRuntimeSpec;
+        runId: string;
+        questionId: string;
+        reason: string | null;
+    }): Promise<AgentResearchResult>;
+}
+export interface AgentContext {
+    runId: string;
+    repoRoot: string;
+    agent: AgentRuntimeSpec;
+    sdk: ScopedAgentSdk;
+    trigger: AgentTriggerInvocation;
+    execution: AgentExecutionAdapter;
+    mutations: AgentMutationAdapter;
+    repository: AgentRepositoryInspectionAdapter;
+    verification: AgentVerificationAdapter;
+    notifications: AgentNotificationAdapter;
+    research: AgentResearchAdapter;
+}
+export interface AgentHandler<TInputs = unknown, TResult = unknown> {
+    kind: AgentHandlerKind;
+    resolveInputs(context: AgentContext): Promise<TInputs>;
+    execute(context: AgentContext, inputs: TInputs): Promise<TResult>;
+    emitOutputs(context: AgentContext, result: TResult): Promise<AgentExecutionResult>;
+}
+export declare const TRESEED_AGENT_RUNTIME_TYPES_MODULE = true;

package/dist/utils/agents/runtime-types.js

@@ -0,0 +1,4 @@
+const TRESEED_AGENT_RUNTIME_TYPES_MODULE = true;
+export {
+  TRESEED_AGENT_RUNTIME_TYPES_MODULE
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Shared Treeseed SDK for content-backed and D1-backed object models.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -102,6 +102,10 @@
       "types": "./dist/platform/deploy-config.d.ts",
       "default": "./dist/platform/deploy-config.js"
     },
+    "./platform/deploy-runtime": {
+      "types": "./dist/platform/deploy-runtime.d.ts",
+      "default": "./dist/platform/deploy-runtime.js"
+    },
     "./platform/environment": {
       "types": "./dist/platform/environment.d.ts",
       "default": "./dist/platform/environment.js"
@@ -217,6 +221,18 @@
     "./stores/subscription-store": {
       "types": "./dist/stores/subscription-store.d.ts",
       "default": "./dist/stores/subscription-store.js"
+    },
+    "./utils/agents/runtime-types": {
+      "types": "./dist/utils/agents/runtime-types.d.ts",
+      "default": "./dist/utils/agents/runtime-types.js"
+    },
+    "./utils/agents/contracts/messages": {
+      "types": "./dist/utils/agents/contracts/messages.d.ts",
+      "default": "./dist/utils/agents/contracts/messages.js"
+    },
+    "./utils/agents/contracts/run": {
+      "types": "./dist/utils/agents/contracts/run.d.ts",
+      "default": "./dist/utils/agents/contracts/run.js"
     }
   }
 }