@treeseed/agent 0.1.2

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

@@ -0,0 +1,117 @@
+import type { AgentHandlerKind, AgentRuntimeSpec, AgentRunStatus, AgentTriggerConfig } from '@treeseed/core/types/agents';
+import type { AgentErrorCategory } from './contracts/run.ts';
+import type { ScopedAgentSdk } from './sdk.ts';
+import type { SdkMessageEntity } from './sdk-types';
+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>;
+}

package/dist/src/agents/sdk-filters.d.ts

@@ -0,0 +1 @@
+export * from '@treeseed/sdk/sdk-filters';

package/dist/src/agents/sdk-types.d.ts

@@ -0,0 +1 @@
+export * from '@treeseed/sdk/types';

package/dist/src/agents/sdk.d.ts

@@ -0,0 +1 @@
+export * from '@treeseed/sdk/sdk';

package/dist/src/agents/spec-loader.d.ts

@@ -0,0 +1,18 @@
+import type { AgentRuntimeSpec } from '@treeseed/core/types/agents';
+import { AgentSdk } from './sdk.ts';
+import type { AgentSpecDiagnostic, NormalizedAgentRuntimeSpec } from './spec-types.ts';
+export interface AgentSpecLoadResult {
+    specs: NormalizedAgentRuntimeSpec[];
+    diagnostics: AgentSpecDiagnostic[];
+}
+export declare function loadAgentSpecs(sdk: AgentSdk, options?: {
+    enabled?: boolean;
+}): Promise<AgentSpecLoadResult>;
+export declare function loadActiveAgentSpecs(sdk: AgentSdk): Promise<AgentSpecLoadResult>;
+export declare function loadAllAgentSpecs(sdk: AgentSdk): Promise<AgentSpecLoadResult>;
+export declare function summarizeAgentSpec(agent: AgentRuntimeSpec): {
+    slug: any;
+    handler: any;
+    enabled: any;
+    triggers: any;
+};

package/dist/src/agents/spec-normalizer.d.ts

@@ -0,0 +1,2 @@
+import type { AgentSpecNormalizationResult, AgentSpecValidationContext, RawAgentRuntimeSpec } from './spec-types.ts';
+export declare function normalizeAgentRuntimeSpec(raw: RawAgentRuntimeSpec, context: AgentSpecValidationContext): AgentSpecNormalizationResult;

package/dist/src/agents/spec-types.d.ts

@@ -0,0 +1,64 @@
+import type { AgentCliOptions, AgentExecutionConfig, AgentHandlerKind, AgentOutputContract, AgentPermissionConfig, AgentRuntimeSpec, AgentTriggerConfig } from '@treeseed/core/types/agents';
+export type AgentSpecDiagnosticSeverity = 'error' | 'warning';
+export interface AgentSpecDiagnostic {
+    severity: AgentSpecDiagnosticSeverity;
+    slug: string;
+    field: string;
+    message: string;
+}
+export interface NormalizedAgentRuntimeSpec extends AgentRuntimeSpec {
+    name?: string;
+    description?: string;
+    summary?: string;
+    operator?: string;
+    runtimeStatus?: string;
+    capabilities?: string[];
+    tags?: string[];
+}
+export interface AgentSpecValidationContext {
+    registeredHandlers: readonly AgentHandlerKind[];
+    messageTypes: readonly string[];
+}
+export interface RawAgentRuntimeSpec {
+    id?: unknown;
+    body?: unknown;
+    slug?: unknown;
+    handler?: unknown;
+    enabled?: unknown;
+    systemPrompt?: unknown;
+    persona?: unknown;
+    cli?: unknown;
+    triggers?: unknown;
+    triggerPolicy?: unknown;
+    permissions?: unknown;
+    execution?: unknown;
+    outputs?: unknown;
+    name?: unknown;
+    description?: unknown;
+    summary?: unknown;
+    operator?: unknown;
+    runtimeStatus?: unknown;
+    capabilities?: unknown;
+    tags?: unknown;
+}
+export interface AgentSpecNormalizationResult {
+    spec: NormalizedAgentRuntimeSpec | null;
+    diagnostics: AgentSpecDiagnostic[];
+}
+export interface NormalizedTriggerPolicy {
+    maxRunsPerCycle?: number;
+    messageBatchSize?: number;
+}
+export interface AgentSpecParts {
+    slug: string;
+    handler: AgentHandlerKind;
+    enabled: boolean;
+    systemPrompt: string;
+    persona: string;
+    cli: AgentCliOptions;
+    triggers: AgentTriggerConfig[];
+    triggerPolicy?: NormalizedTriggerPolicy;
+    permissions: AgentPermissionConfig[];
+    execution: AgentExecutionConfig;
+    outputs: AgentOutputContract;
+}

package/dist/src/agents/stores/cursor-store.d.ts

@@ -0,0 +1 @@
+export * from '@treeseed/sdk/stores/cursor-store';

package/dist/src/agents/stores/helpers.d.ts

@@ -0,0 +1 @@
+export * from '@treeseed/sdk/stores/helpers';

package/dist/src/agents/stores/lease-store.d.ts

@@ -0,0 +1 @@
+export * from '@treeseed/sdk/stores/lease-store';

package/dist/src/agents/stores/message-store.d.ts

@@ -0,0 +1 @@
+export * from '@treeseed/sdk/stores/message-store';

package/dist/src/agents/stores/run-store.d.ts

@@ -0,0 +1 @@
+export * from '@treeseed/sdk/stores/run-store';

package/dist/src/agents/stores/subscription-store.d.ts

@@ -0,0 +1 @@
+export * from '@treeseed/sdk/stores/subscription-store';

package/dist/src/agents/testing/agents-smoke.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/agents/testing/e2e-harness.d.ts

@@ -0,0 +1,44 @@
+import type { AgentExecutionAdapter, AgentMutationAdapter } from '../runtime-types.ts';
+import type { SdkCreateMessageRequest, SdkMessageEntity, SdkRunEntity } from '../sdk-types';
+import type { AgentKernel } from '../kernel/agent-kernel.ts';
+import type { AgentSdk } from '../sdk.ts';
+export interface AgentTestRuntime {
+    rootDir: string;
+    repoRoot: string;
+    persistTo: string;
+    sdk: AgentSdk;
+    kernel: AgentKernel;
+    seedObjectives(entries: Array<{
+        slug: string;
+        date?: string;
+    }>): Promise<void>;
+    seedQuestions(entries: Array<{
+        slug: string;
+        date?: string;
+        relatedObjectives?: string[];
+    }>): Promise<void>;
+    seedKnowledge(entries: Array<{
+        slug: string;
+        title?: string;
+    }>): Promise<void>;
+    seedMessages(entries: Array<Omit<SdkCreateMessageRequest, 'actor'>>): Promise<SdkMessageEntity[]>;
+    clearModelContent(model: 'objective' | 'question' | 'knowledge'): Promise<void>;
+    runAgent(slug: string): Promise<unknown>;
+    runCycle(): Promise<unknown>;
+    readMessages(): Promise<SdkMessageEntity[]>;
+    readRunLogs(): Promise<SdkRunEntity[]>;
+    readContentLeases(): Promise<Record<string, unknown>[]>;
+    readSandboxArtifacts(): Promise<Array<{
+        path: string;
+        content: string;
+    }>>;
+    claimMessage(messageTypes: string[], workerId?: string): Promise<SdkMessageEntity | null>;
+    claimObjectiveLease(itemKey: string, workerId?: string): Promise<string | null>;
+    cleanup(): Promise<void>;
+}
+export declare function createAgentTestRuntime(options?: {
+    execution?: AgentExecutionAdapter;
+    mutations?: AgentMutationAdapter;
+    executionMode?: 'stub' | 'copilot';
+    databaseMode?: 'memory' | 'local-d1';
+}): Promise<AgentTestRuntime>;

package/dist/src/agents/wrangler-d1.d.ts

@@ -0,0 +1 @@
+export * from '@treeseed/sdk/wrangler-d1';

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+export { AgentKernel } from './agents/kernel/agent-kernel.ts';
+export { runTreeseedAgentCli } from './agents/cli.ts';
+export { resolveAgentHandler, listRegisteredAgentHandlers } from './agents/registry.ts';

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@treeseed/agent",
+  "version": "0.1.2",
+  "description": "Treeseed agent service runtime package.",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/treeseed-ai/agent.git",
+    "directory": "."
+  },
+  "homepage": "https://treeseed.ai",
+  "bugs": {
+    "url": "https://github.com/treeseed-ai/agent/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "README.md",
+    "dist",
+    "Dockerfile"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "setup": "npm install",
+    "setup:ci": "npm ci",
+    "build": "npm run build:dist",
+    "build:dist": "node ./scripts/run-ts.mjs ./scripts/build-dist.ts",
+    "test": "npm run test:smoke",
+    "prepare": "npm run build:dist",
+    "prepack": "npm run build:dist",
+    "test:smoke": "node ./scripts/run-ts.mjs ./scripts/test-smoke.ts",
+    "release:setup": "npm run setup:ci",
+    "release:check-tag": "node ./scripts/run-ts.mjs ./scripts/assert-release-tag-version.ts",
+    "release:verify": "node ./scripts/run-ts.mjs ./scripts/release-verify.ts",
+    "release:publish": "node ./scripts/run-ts.mjs ./scripts/publish-package.ts"
+  },
+  "dependencies": {
+    "@treeseed/core": "^0.1.2",
+    "@treeseed/sdk": "^0.1.2",
+    "esbuild": "0.28.0",
+    "typescript": "^5.9.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.6.0"
+  },
+  "bin": {
+    "treeseed-agents": "./dist/scripts/treeseed-agents.js"
+  }
+}