@treeseed/sdk 0.3.4 → 0.4.1

package/dist/platform/utils/books-data.d.ts

@@ -1,29 +0,0 @@
-import type { TreeseedBookDefinition, TreeseedTenantConfig } from '../contracts.ts';
-interface DocsLibraryDownload {
-    downloadFileName: string;
-    downloadHref: string;
-    downloadTitle: string;
-}
-interface TenantBookRuntime {
-    BOOKS: TreeseedBookDefinition[];
-    BOOKS_LINK: {
-        label: string;
-        link: string;
-    };
-    TREESEED_LINKS: {
-        home: string;
-    };
-    TREESEED_LIBRARY_DOWNLOAD: DocsLibraryDownload;
-}
-export declare function buildTenantBookRuntime(tenantConfig: Pick<TreeseedTenantConfig, 'content'>, options?: {
-    projectRoot?: string;
-    docsHomePath?: string;
-    docsLibraryDownload?: DocsLibraryDownload;
-}): TenantBookRuntime;
-export declare const BOOKS: TreeseedBookDefinition[], BOOKS_LINK: {
-    label: string;
-    link: string;
-}, TREESEED_LINKS: {
-    home: string;
-}, TREESEED_LIBRARY_DOWNLOAD: DocsLibraryDownload;
-export {};

package/dist/platform/utils/books-data.js

@@ -1,82 +0,0 @@
-import { readFileSync, readdirSync, statSync } from "node:fs";
-import path from "node:path";
-import { parse as parseYaml } from "yaml";
-import { getTenantContentRoot } from "../tenant/config.js";
-import { RUNTIME_PROJECT_ROOT, RUNTIME_TENANT } from "../tenant/runtime-config.js";
-function sortPaths(paths) {
-  return [...paths].sort((left, right) => left.localeCompare(right, void 0, { numeric: true, sensitivity: "base" }));
-}
-function collectMarkdownFiles(rootPath) {
-  const stats = statSync(rootPath);
-  if (stats.isFile()) {
-    return [rootPath];
-  }
-  return sortPaths(
-    readdirSync(rootPath, { withFileTypes: true }).flatMap((entry) => {
-      const fullPath = path.join(rootPath, entry.name);
-      if (entry.isDirectory()) {
-        return collectMarkdownFiles(fullPath);
-      }
-      if (entry.isFile() && (entry.name.endsWith(".md") || entry.name.endsWith(".mdx"))) {
-        return [fullPath];
-      }
-      return [];
-    })
-  );
-}
-function parseFrontmatter(filePath) {
-  const raw = readFileSync(filePath, "utf8");
-  const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-  if (!match) {
-    throw new Error(`Book content entry is missing frontmatter: ${filePath}`);
-  }
-  return parseYaml(match[1]);
-}
-function inferDocsLibraryDownload(book) {
-  const title = book?.title ? `${book.title} Library` : "Knowledge Library";
-  return {
-    downloadFileName: "treeseed-knowledge.md",
-    downloadHref: "/books/treeseed-knowledge.md",
-    downloadTitle: title
-  };
-}
-function buildTenantBookRuntime(tenantConfig, options = {}) {
-  const projectRoot = options.projectRoot ?? process.cwd();
-  const booksContentRoot = path.resolve(projectRoot, getTenantContentRoot(tenantConfig, "books"));
-  const books = collectMarkdownFiles(booksContentRoot).map((filePath) => {
-    const frontmatter = parseFrontmatter(filePath);
-    return {
-      ...frontmatter,
-      id: path.basename(filePath, path.extname(filePath))
-    };
-  }).sort((left, right) => left.order - right.order);
-  const docsHomePath = options.docsHomePath ?? "/knowledge/";
-  const docsLibraryDownload = options.docsLibraryDownload ?? inferDocsLibraryDownload(tenantConfig);
-  return {
-    BOOKS: books,
-    BOOKS_LINK: {
-      label: "Books",
-      link: docsHomePath
-    },
-    TREESEED_LINKS: {
-      home: docsHomePath
-    },
-    TREESEED_LIBRARY_DOWNLOAD: docsLibraryDownload
-  };
-}
-const runtime = buildTenantBookRuntime(RUNTIME_TENANT, {
-  projectRoot: RUNTIME_PROJECT_ROOT,
-  docsLibraryDownload: {
-    downloadFileName: "treeseed-knowledge.md",
-    downloadHref: "/books/treeseed-knowledge.md",
-    downloadTitle: "TreeSeed Knowledge Library"
-  }
-});
-const { BOOKS, BOOKS_LINK, TREESEED_LINKS, TREESEED_LIBRARY_DOWNLOAD } = runtime;
-export {
-  BOOKS,
-  BOOKS_LINK,
-  TREESEED_LIBRARY_DOWNLOAD,
-  TREESEED_LINKS,
-  buildTenantBookRuntime
-};

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

@@ -1,88 +0,0 @@
-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

@@ -1,139 +0,0 @@
-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

@@ -1,20 +0,0 @@
-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

@@ -1,117 +0,0 @@
-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

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