@treeseed/core 0.3.0 → 0.4.0

package/dist/utils/agents/adapters/execution.js

@@ -1,90 +0,0 @@
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-import { normalizeAgentCliOptions, buildCopilotAllowToolArgs } from "../cli-tools.js";
-import { getTreeseedAgentProviderSelections } from "../../../deploy/runtime.js";
-const execFileAsync = promisify(execFile);
-class StubExecutionAdapter {
-  async runTask(input) {
-    return {
-      status: "completed",
-      summary: `Stubbed Copilot execution for ${input.runId}.`,
-      stdout: [
-        "# Planned Task",
-        "",
-        "1. Inspect the requested architecture context.",
-        "2. Produce a safe local change artifact.",
-        "3. Summarize the implementation intent.",
-        "",
-        `Prompt digest: ${input.prompt.slice(0, 240)}`
-      ].join("\n"),
-      stderr: ""
-    };
-  }
-}
-class CopilotExecutionAdapter {
-  async runTask(input) {
-    const cli = normalizeAgentCliOptions(input.agent.cli);
-    const args = ["copilot", "-p", input.prompt];
-    if (cli.model) {
-      args.push("--model", cli.model);
-    }
-    args.push(...buildCopilotAllowToolArgs(cli.allowTools));
-    args.push(...cli.additionalArgs ?? []);
-    try {
-      const { stdout, stderr } = await execFileAsync("gh", args, {
-        cwd: process.cwd(),
-        env: process.env,
-        maxBuffer: 10 * 1024 * 1024
-      });
-      return {
-        status: "completed",
-        summary: "Copilot task completed.",
-        stdout,
-        stderr
-      };
-    } catch (error) {
-      const stderr = error && typeof error === "object" && "stderr" in error ? String(error.stderr ?? "") : error instanceof Error ? error.message : String(error);
-      return {
-        status: "failed",
-        summary: "Copilot task failed.",
-        stdout: "",
-        stderr
-      };
-    }
-  }
-}
-class ManualExecutionAdapter {
-  async runTask(input) {
-    return {
-      status: "completed",
-      summary: `Manual execution mode is enabled for ${input.runId}.`,
-      stdout: [
-        "# Manual Execution Required",
-        "",
-        "This agent run is configured for manual execution.",
-        "Review the prompt below and complete the work outside the automated adapter.",
-        "",
-        input.prompt
-      ].join("\n"),
-      stderr: ""
-    };
-  }
-}
-function createExecutionAdapter() {
-  const configuredMode = String(
-    process.env.TREESEED_AGENT_EXECUTION_PROVIDER ?? getTreeseedAgentProviderSelections().execution
-  ).toLowerCase();
-  if (configuredMode === "manual") {
-    return new ManualExecutionAdapter();
-  }
-  if (configuredMode !== "copilot") {
-    return new StubExecutionAdapter();
-  }
-  return new CopilotExecutionAdapter();
-}
-export {
-  CopilotExecutionAdapter,
-  ManualExecutionAdapter,
-  StubExecutionAdapter,
-  createExecutionAdapter
-};

package/dist/utils/agents/adapters/mutations.js

@@ -1,30 +0,0 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { GitRuntime } from "@treeseed/sdk/git-runtime";
-class LocalBranchMutationAdapter {
-  git;
-  constructor(repoRoot) {
-    this.git = new GitRuntime(
-      repoRoot,
-      process.env.TREESEED_AGENT_DISABLE_GIT === "true"
-    );
-  }
-  async writeArtifact(input) {
-    const branchName = `${input.agent.execution.branchPrefix}/${input.runId}`;
-    const worktreePath = await this.git.ensureWorktree(branchName);
-    const filePath = path.join(worktreePath, input.relativePath);
-    await mkdir(path.dirname(filePath), { recursive: true });
-    await writeFile(filePath, input.content, "utf8");
-    const git = await this.git.commitFileChange(filePath, branchName, input.commitMessage);
-    return {
-      branchName: git.branchName,
-      commitMessage: git.commitMessage,
-      worktreePath: git.worktreePath,
-      commitSha: git.commitSha,
-      changedPaths: git.changedPaths
-    };
-  }
-}
-export {
-  LocalBranchMutationAdapter
-};

package/dist/utils/agents/adapters/notification.js

@@ -1,16 +0,0 @@
-class StubNotificationAdapter {
-  async deliver(input) {
-    return {
-      status: input.recipients.length ? "completed" : "waiting",
-      summary: input.recipients.length ? `Prepared ${input.recipients.length} notification(s).` : "No recipients available for notification.",
-      deliveredCount: input.recipients.length
-    };
-  }
-}
-function createNotificationAdapter() {
-  return new StubNotificationAdapter();
-}
-export {
-  StubNotificationAdapter,
-  createNotificationAdapter
-};

package/dist/utils/agents/adapters/repository.js

@@ -1,61 +0,0 @@
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-import { getTreeseedAgentProviderSelections } from "../../../deploy/runtime.js";
-const execFileAsync = promisify(execFile);
-class StubRepositoryInspectionAdapter {
-  async inspectBranch(input) {
-    return {
-      branchName: input.branchName,
-      changedPaths: [],
-      commitSha: null,
-      summary: input.branchName ? `Stub repository inspection for ${input.branchName}.` : "No branch to inspect."
-    };
-  }
-}
-class GitRepositoryInspectionAdapter {
-  async inspectBranch(input) {
-    if (!input.branchName) {
-      return {
-        branchName: null,
-        changedPaths: [],
-        commitSha: null,
-        summary: "No branch to inspect."
-      };
-    }
-    try {
-      const { stdout: changedStdout } = await execFileAsync(
-        "git",
-        ["diff", "--name-only", "HEAD~1..HEAD"],
-        { cwd: input.repoRoot, env: process.env }
-      );
-      const { stdout: shaStdout } = await execFileAsync("git", ["rev-parse", "HEAD"], {
-        cwd: input.repoRoot,
-        env: process.env
-      });
-      const changedPaths = changedStdout.split("\n").map((entry) => entry.trim()).filter(Boolean);
-      return {
-        branchName: input.branchName,
-        changedPaths,
-        commitSha: shaStdout.trim() || null,
-        summary: `Inspected ${changedPaths.length} changed path(s) on ${input.branchName}.`
-      };
-    } catch {
-      return {
-        branchName: input.branchName,
-        changedPaths: [],
-        commitSha: null,
-        summary: `Unable to inspect branch ${input.branchName}.`
-      };
-    }
-  }
-}
-function createRepositoryInspectionAdapter() {
-  return String(
-    process.env.TREESEED_AGENT_REPOSITORY_PROVIDER ?? getTreeseedAgentProviderSelections().repository
-  ).toLowerCase() !== "git" ? new StubRepositoryInspectionAdapter() : new GitRepositoryInspectionAdapter();
-}
-export {
-  GitRepositoryInspectionAdapter,
-  StubRepositoryInspectionAdapter,
-  createRepositoryInspectionAdapter
-};

package/dist/utils/agents/adapters/research.js

@@ -1,25 +0,0 @@
-class StubResearchAdapter {
-  async research(input) {
-    return {
-      status: "completed",
-      summary: `Research prepared for ${input.questionId}.`,
-      markdown: [
-        "# Research Summary",
-        "",
-        `Question: ${input.questionId}`,
-        `Reason: ${input.reason ?? "not provided"}`,
-        `Run: ${input.runId}`,
-        "",
-        "This is a stub research summary produced by the runtime adapter."
-      ].join("\n"),
-      sources: []
-    };
-  }
-}
-function createResearchAdapter() {
-  return new StubResearchAdapter();
-}
-export {
-  StubResearchAdapter,
-  createResearchAdapter
-};

package/dist/utils/agents/adapters/verification.js

@@ -1,62 +0,0 @@
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-import { getTreeseedAgentProviderSelections } from "../../../deploy/runtime.js";
-const execFileAsync = promisify(execFile);
-class StubVerificationAdapter {
-  async runChecks(input) {
-    return {
-      status: "completed",
-      summary: input.commands.length ? `Stub verification completed for ${input.runId}.` : "No verification commands configured.",
-      stdout: input.commands.join("\n"),
-      stderr: ""
-    };
-  }
-}
-class LocalVerificationAdapter {
-  async runChecks(input) {
-    if (!input.commands.length) {
-      return {
-        status: "waiting",
-        summary: "No verification commands configured.",
-        stdout: "",
-        stderr: ""
-      };
-    }
-    const stdoutChunks = [];
-    const stderrChunks = [];
-    for (const command of input.commands) {
-      try {
-        const { stdout, stderr } = await execFileAsync("/bin/bash", ["-lc", command], {
-          env: process.env,
-          maxBuffer: 10 * 1024 * 1024
-        });
-        stdoutChunks.push(stdout);
-        stderrChunks.push(stderr);
-      } catch (error) {
-        return {
-          status: "failed",
-          summary: `Verification command failed: ${command}`,
-          stdout: stdoutChunks.join("\n"),
-          stderr: error && typeof error === "object" && "stderr" in error ? String(error.stderr ?? "") : String(error),
-          errorCategory: "execution_error"
-        };
-      }
-    }
-    return {
-      status: "completed",
-      summary: `Verification completed for ${input.commands.length} command(s).`,
-      stdout: stdoutChunks.join("\n"),
-      stderr: stderrChunks.join("\n")
-    };
-  }
-}
-function createVerificationAdapter() {
-  return String(
-    process.env.TREESEED_AGENT_VERIFICATION_PROVIDER ?? getTreeseedAgentProviderSelections().verification
-  ).toLowerCase() !== "local" ? new StubVerificationAdapter() : new LocalVerificationAdapter();
-}
-export {
-  LocalVerificationAdapter,
-  StubVerificationAdapter,
-  createVerificationAdapter
-};

package/dist/utils/agents/cli-tools.js

@@ -1,5 +0,0 @@
-import { normalizeAgentCliOptions, buildCopilotAllowToolArgs } from "@treeseed/sdk/cli-tools";
-export {
-  buildCopilotAllowToolArgs,
-  normalizeAgentCliOptions
-};

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>): Record<string, unknown>;

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

@@ -1,138 +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 parsed = JSON.parse(payloadJson);
-  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(`Unsupported message type "${type}".`);
-  }
-}
-function serializeAgentMessagePayload(type, payload) {
-  parseAgentMessagePayload(type, JSON.stringify(payload));
-  return 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 '@treeseed/sdk/types/agents';
-import type { AgentErrorCategory } from './contracts/run.ts';
-import type { ScopedAgentSdk, SdkMessageEntity } from '@treeseed/sdk';
-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
-};

package/dist/utils/books-data.js

@@ -1,14 +0,0 @@
-import {
-  BOOKS,
-  BOOKS_LINK,
-  TREESEED_LIBRARY_DOWNLOAD,
-  TREESEED_LINKS,
-  buildTenantBookRuntime
-} from "@treeseed/sdk/platform/books-data";
-export {
-  BOOKS,
-  BOOKS_LINK,
-  TREESEED_LIBRARY_DOWNLOAD,
-  TREESEED_LINKS,
-  buildTenantBookRuntime
-};