harness-engineering-agent 0.1.0

package/dist/config/config-schema.js

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { SchemaVersionSchema, VerificationCommandSchema } from "../domain/index.js";
+import { WorkspaceRelativePathSchema } from "../path/workspace-path.js";
+const HarnessProfileInputSchema = z
+    .object({
+    provider: z.string().trim().min(1).optional(),
+    model: z.string().trim().min(1).optional(),
+})
+    .strict()
+    .readonly();
+export const HarnessConfigInputSchema = z
+    .object({
+    schemaVersion: SchemaVersionSchema.optional(),
+    enabled: z.boolean().optional(),
+    harness: HarnessProfileInputSchema.optional(),
+    planner: HarnessProfileInputSchema.optional(),
+    worker: HarnessProfileInputSchema.optional(),
+    verifier: HarnessProfileInputSchema.optional(),
+    acceptance: HarnessProfileInputSchema.optional(),
+    failureAnalyzer: HarnessProfileInputSchema.optional(),
+    verificationCommands: z.array(VerificationCommandSchema).readonly().optional(),
+    maxRunAttempts: z.number().int().positive().optional(),
+    stateDirectory: WorkspaceRelativePathSchema.optional(),
+})
+    .strict()
+    .readonly();
+export const HarnessProfileSchema = z
+    .object({
+    provider: z.string().trim().min(1),
+    model: z.string().trim().min(1),
+})
+    .readonly();
+export const HarnessConfigSchema = z
+    .object({
+    schemaVersion: SchemaVersionSchema,
+    enabled: z.boolean(),
+    harness: HarnessProfileSchema,
+    planner: HarnessProfileSchema,
+    worker: HarnessProfileSchema,
+    verifier: HarnessProfileSchema,
+    acceptance: HarnessProfileSchema,
+    failureAnalyzer: HarnessProfileSchema,
+    verificationCommands: z.array(VerificationCommandSchema).readonly(),
+    maxRunAttempts: z.number().int().positive(),
+    stateDirectory: WorkspaceRelativePathSchema,
+})
+    .strict()
+    .readonly();
+export const parseHarnessConfig = (config, availableModels) => {
+    const parsedConfig = HarnessConfigSchema.parse(config);
+    validateAvailableModels(parsedConfig, availableModels);
+    return parsedConfig;
+};
+const validateAvailableModels = (config, availableModels) => {
+    if (availableModels === undefined) {
+        return;
+    }
+    const issues = [
+        ...validateProfileAvailability(config.harness, availableModels, "harness"),
+        ...validateProfileAvailability(config.planner, availableModels, "planner"),
+        ...validateProfileAvailability(config.worker, availableModels, "worker"),
+        ...validateProfileAvailability(config.verifier, availableModels, "verifier"),
+        ...validateProfileAvailability(config.acceptance, availableModels, "acceptance"),
+        ...validateProfileAvailability(config.failureAnalyzer, availableModels, "failureAnalyzer"),
+    ];
+    if (issues.length > 0) {
+        throw new z.ZodError(issues);
+    }
+};
+const validateProfileAvailability = (profile, availableModels, role) => {
+    const providerModels = availableModels[profile.provider];
+    if (providerModels === undefined) {
+        return [
+            {
+                code: "custom",
+                input: profile.provider,
+                message: `Unknown provider: ${profile.provider}`,
+                path: [role, "provider"],
+            },
+        ];
+    }
+    if (!providerModels.includes(profile.model)) {
+        return [
+            {
+                code: "custom",
+                input: profile.model,
+                message: `Unknown model for provider ${profile.provider}: ${profile.model}`,
+                path: [role, "model"],
+            },
+        ];
+    }
+    return [];
+};
+//# sourceMappingURL=config-schema.js.map

package/dist/config/config-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../src/config/config-schema.ts"],"names":[],"mappings":"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"}

package/dist/config/config-types.d.ts

@@ -0,0 +1,21 @@
+import type { z } from "zod";
+import type { VerificationCommandSchema } from "../domain/index.js";
+export type AvailableModelRegistry = Readonly<Record<string, readonly string[]>>;
+export type MergedHarnessProfile = {
+    readonly provider: string;
+    readonly model: string;
+};
+export type MergedHarnessConfig = {
+    readonly schemaVersion: string;
+    readonly enabled: boolean;
+    readonly harness: MergedHarnessProfile;
+    readonly planner: MergedHarnessProfile;
+    readonly worker: MergedHarnessProfile;
+    readonly verifier: MergedHarnessProfile;
+    readonly acceptance: MergedHarnessProfile;
+    readonly failureAnalyzer: MergedHarnessProfile;
+    readonly verificationCommands: readonly z.infer<typeof VerificationCommandSchema>[];
+    readonly maxRunAttempts: number;
+    readonly stateDirectory: string;
+};
+//# sourceMappingURL=config-types.d.ts.map

package/dist/config/config-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.d.ts","sourceRoot":"","sources":["../../src/config/config-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AAEnE,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAA;AAEhF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;IACtC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;IACvC,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAA;IACzC,QAAQ,CAAC,eAAe,EAAE,oBAAoB,CAAA;IAC9C,QAAQ,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,EAAE,CAAA;IACnF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC,CAAA"}

package/dist/config/config-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config-types.js.map

package/dist/config/config-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.js","sourceRoot":"","sources":["../../src/config/config-types.ts"],"names":[],"mappings":""}

package/dist/config/harness-config.d.ts

@@ -0,0 +1,6 @@
+export { HARNESS_CONFIG_DEFAULTS } from "./config-defaults.js";
+export { ConfigLoadError } from "./config-errors.js";
+export type { HarnessAgentProfile, HarnessConfig, HarnessConfigInput, HarnessProfileInput, } from "./config-schema.js";
+export type { AvailableModelRegistry } from "./config-types.js";
+export { type LoadHarnessConfigOptions, loadHarnessConfig, } from "./load-harness-config.js";
+//# sourceMappingURL=harness-config.d.ts.map

package/dist/config/harness-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-config.d.ts","sourceRoot":"","sources":["../../src/config/harness-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAC/D,OAAO,EACL,KAAK,wBAAwB,EAC7B,iBAAiB,GAClB,MAAM,0BAA0B,CAAA"}

package/dist/config/harness-config.js

@@ -0,0 +1,4 @@
+export { HARNESS_CONFIG_DEFAULTS } from "./config-defaults.js";
+export { ConfigLoadError } from "./config-errors.js";
+export { loadHarnessConfig, } from "./load-harness-config.js";
+//# sourceMappingURL=harness-config.js.map

package/dist/config/harness-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-config.js","sourceRoot":"","sources":["../../src/config/harness-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAQpD,OAAO,EAEL,iBAAiB,GAClB,MAAM,0BAA0B,CAAA"}

package/dist/config/index.d.ts

@@ -0,0 +1,2 @@
+export { type AvailableModelRegistry, ConfigLoadError, HARNESS_CONFIG_DEFAULTS, type HarnessAgentProfile, type HarnessConfig, type HarnessConfigInput, type HarnessProfileInput, type LoadHarnessConfigOptions, loadHarnessConfig, } from "./harness-config.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,sBAAsB,EAC3B,eAAe,EACf,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,iBAAiB,GAClB,MAAM,qBAAqB,CAAA"}

package/dist/config/index.js

@@ -0,0 +1,2 @@
+export { ConfigLoadError, HARNESS_CONFIG_DEFAULTS, loadHarnessConfig, } from "./harness-config.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,EACf,uBAAuB,EAMvB,iBAAiB,GAClB,MAAM,qBAAqB,CAAA"}

package/dist/config/load-harness-config.d.ts

@@ -0,0 +1,9 @@
+import { type HarnessConfig, type HarnessConfigInput } from "./config-schema.js";
+import type { AvailableModelRegistry } from "./config-types.js";
+export type LoadHarnessConfigOptions = {
+    readonly projectRoot: string;
+    readonly runOverride?: HarnessConfigInput;
+    readonly availableModels?: AvailableModelRegistry;
+};
+export declare const loadHarnessConfig: (options: LoadHarnessConfigOptions) => Promise<HarnessConfig>;
+//# sourceMappingURL=load-harness-config.d.ts.map

package/dist/config/load-harness-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-harness-config.d.ts","sourceRoot":"","sources":["../../src/config/load-harness-config.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAsB,MAAM,oBAAoB,CAAA;AACpG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAE/D,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAA;IACzC,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB,CAAA;CAClD,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC5B,SAAS,wBAAwB,KAChC,OAAO,CAAC,aAAa,CAmBvB,CAAA"}

package/dist/config/load-harness-config.js

@@ -0,0 +1,25 @@
+import { join } from "node:path";
+import { HARNESS_CONFIG_DEFAULTS } from "./config-defaults.js";
+import { ConfigLoadError } from "./config-errors.js";
+import { readHarnessConfigFile } from "./config-file.js";
+import { mergeHarnessConfig } from "./config-merge.js";
+import { parseHarnessConfig } from "./config-schema.js";
+export const loadHarnessConfig = async (options) => {
+    const sourcePath = join(options.projectRoot, ".harness", "config.yaml");
+    try {
+        const projectConfig = await readHarnessConfigFile(sourcePath);
+        const mergedConfig = mergeHarnessConfig({
+            defaults: HARNESS_CONFIG_DEFAULTS,
+            projectConfig,
+            runOverride: options.runOverride,
+        });
+        return parseHarnessConfig(mergedConfig, options.availableModels);
+    }
+    catch (error) {
+        if (error instanceof ConfigLoadError) {
+            throw error;
+        }
+        throw new ConfigLoadError(sourcePath, error);
+    }
+};
+//# sourceMappingURL=load-harness-config.js.map

package/dist/config/load-harness-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-harness-config.js","sourceRoot":"","sources":["../../src/config/load-harness-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAA+C,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AASpG,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,OAAiC,EACT,EAAE;IAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,CAAC,CAAA;IAEvE,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,qBAAqB,CAAC,UAAU,CAAC,CAAA;QAC7D,MAAM,YAAY,GAAG,kBAAkB,CAAC;YACtC,QAAQ,EAAE,uBAAuB;YACjC,aAAa;YACb,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAA;QAEF,OAAO,kBAAkB,CAAC,YAAY,EAAE,OAAO,CAAC,eAAe,CAAC,CAAA;IAClE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,MAAM,KAAK,CAAA;QACb,CAAC;QAED,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;IAC9C,CAAC;AACH,CAAC,CAAA"}

package/dist/controller/agent-output.d.ts

@@ -0,0 +1,21 @@
+import { type ZodType } from "zod";
+import type { SessionRunResult } from "../session/index.js";
+type StructuredAgentOutputErrorCode = "agent-status-transition-denied" | "unsupported-schema-version";
+type StructuredAgentOutputErrorDetails = {
+    readonly role: string;
+    readonly suggestedStatus?: string;
+    readonly allowedStatuses?: readonly string[];
+    readonly schemaVersion?: string;
+    readonly supportedMajorVersion?: number;
+};
+export declare class StructuredAgentOutputError extends Error {
+    readonly code: StructuredAgentOutputErrorCode;
+    readonly details: StructuredAgentOutputErrorDetails;
+    readonly name = "StructuredAgentOutputError";
+    constructor(code: StructuredAgentOutputErrorCode, details: StructuredAgentOutputErrorDetails);
+}
+export declare const readAgentOutput: (result: SessionRunResult) => string;
+export declare const parseAgentJson: <T>(text: string, schema: ZodType<T>, role: string) => T;
+export declare const assertAgentSuggestedStatus: (role: string, suggestedStatus: string, allowedStatuses: readonly string[]) => void;
+export {};
+//# sourceMappingURL=agent-output.d.ts.map

package/dist/controller/agent-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-output.d.ts","sourceRoot":"","sources":["../../src/controller/agent-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,KAAK,CAAA;AAE5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAK3D,KAAK,8BAA8B,GAC/B,gCAAgC,GAChC,4BAA4B,CAAA;AAEhC,KAAK,iCAAiC,GAAG;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAA;CACxC,CAAA;AAED,qBAAa,0BAA2B,SAAQ,KAAK;IAIjD,QAAQ,CAAC,IAAI,EAAE,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,iCAAiC;IAJrD,QAAQ,CAAC,IAAI,gCAA+B;gBAGjC,IAAI,EAAE,8BAA8B,EACpC,OAAO,EAAE,iCAAiC;CAItD;AAED,eAAO,MAAM,eAAe,GAAI,QAAQ,gBAAgB,KAAG,MAS1D,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,MAAM,MAAM,EAAE,QAAQ,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,MAAM,KAAG,CAclF,CAAA;AAED,eAAO,MAAM,0BAA0B,GACrC,MAAM,MAAM,EACZ,iBAAiB,MAAM,EACvB,iBAAiB,SAAS,MAAM,EAAE,KACjC,IASF,CAAA"}

package/dist/controller/agent-output.js

@@ -0,0 +1,75 @@
+import { ZodError } from "zod";
+import { AgentOutputParseError, AgentRunFailedError, RunCancellationError } from "./errors.js";
+const SUPPORTED_SCHEMA_MAJOR_VERSION = 1;
+export class StructuredAgentOutputError extends Error {
+    code;
+    details;
+    name = "StructuredAgentOutputError";
+    constructor(code, details) {
+        super(createStructuredErrorMessage(code, details));
+        this.code = code;
+        this.details = details;
+    }
+}
+export const readAgentOutput = (result) => {
+    switch (result.kind) {
+        case "completed":
+            return result.outputText;
+        case "failed":
+            throw new AgentRunFailedError(result.role, result.error.message);
+        case "aborted":
+            throw new RunCancellationError(result.sessionId);
+    }
+};
+export const parseAgentJson = (text, schema, role) => {
+    try {
+        const parsed = JSON.parse(text);
+        assertSupportedSchemaVersion(parsed, role);
+        return schema.parse(parsed);
+    }
+    catch (error) {
+        if (error instanceof StructuredAgentOutputError) {
+            throw new AgentOutputParseError(role, error.message, { cause: error });
+        }
+        if (error instanceof ZodError || error instanceof SyntaxError) {
+            throw new AgentOutputParseError(role, error.message, { cause: error });
+        }
+        throw error;
+    }
+};
+export const assertAgentSuggestedStatus = (role, suggestedStatus, allowedStatuses) => {
+    if (allowedStatuses.includes(suggestedStatus)) {
+        return;
+    }
+    throw new StructuredAgentOutputError("agent-status-transition-denied", {
+        role,
+        suggestedStatus,
+        allowedStatuses,
+    });
+};
+const assertSupportedSchemaVersion = (value, role) => {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        return;
+    }
+    const schemaVersion = Reflect.get(value, "schemaVersion");
+    if (typeof schemaVersion !== "string") {
+        return;
+    }
+    const major = Number.parseInt(schemaVersion.split(".")[0] ?? "", 10);
+    if (major !== SUPPORTED_SCHEMA_MAJOR_VERSION) {
+        throw new StructuredAgentOutputError("unsupported-schema-version", {
+            role,
+            schemaVersion,
+            supportedMajorVersion: SUPPORTED_SCHEMA_MAJOR_VERSION,
+        });
+    }
+};
+const createStructuredErrorMessage = (code, details) => {
+    switch (code) {
+        case "agent-status-transition-denied":
+            return `${details.role} suggested unsupported status ${details.suggestedStatus}; allowed: ${details.allowedStatuses?.join(", ") ?? "none"}`;
+        case "unsupported-schema-version":
+            return `${details.role} returned unsupported schemaVersion ${details.schemaVersion}; supported major is ${details.supportedMajorVersion}`;
+    }
+};
+//# sourceMappingURL=agent-output.js.map

package/dist/controller/agent-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-output.js","sourceRoot":"","sources":["../../src/controller/agent-output.ts"],"names":[],"mappings":"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"}

package/dist/controller/agent-session.d.ts

@@ -0,0 +1,49 @@
+import type { RunId } from "../domain/index.js";
+import type { HarnessSessionRole, SessionAdapter, SessionEvidenceReference, SessionOutputContract } from "../session/index.js";
+import type { RunStore } from "../store/index.js";
+import type { ControllerIdSource } from "./contracts.js";
+export type SendAgentInput = {
+    readonly runId: RunId;
+    readonly role: HarnessSessionRole;
+    readonly title: string;
+    readonly brief: string;
+    readonly constraints: readonly string[];
+    readonly evidence: readonly SessionEvidenceReference[];
+    readonly outputContract: SessionOutputContract;
+    readonly messageLabel: string;
+    readonly systemPrompt?: string;
+    readonly timeoutMs?: number;
+    readonly parentSessionId?: string;
+    readonly workingDirectory?: string;
+};
+export type AgentSessionRuntime = {
+    readonly sendAgent: (input: SendAgentInput) => Promise<string>;
+    readonly abortActiveSession: (runId: RunId) => Promise<void>;
+    readonly hasActiveSession: (runId: RunId) => boolean;
+    readonly isCancelled: (runId: RunId) => boolean;
+    readonly markCancelled: (runId: RunId) => void;
+    readonly listOrphanSessions: () => Promise<readonly OrphanSession[]>;
+    readonly rebindSession: (input: RebindSessionInput) => Promise<void>;
+    readonly safeAbandonSession: (input: AbandonSessionInput) => Promise<void>;
+};
+export type OrphanSession = {
+    readonly runId: RunId;
+    readonly sessionId: string;
+    readonly role: HarnessSessionRole;
+    readonly state: "created" | "rebound";
+};
+export type RebindSessionInput = {
+    readonly runId: RunId;
+    readonly sessionId: string;
+    readonly actorId: string;
+};
+export type AbandonSessionInput = RebindSessionInput & {
+    readonly reason: string;
+};
+export declare const createAgentSessionRuntime: (input: {
+    readonly sessionAdapter: SessionAdapter;
+    readonly ids: ControllerIdSource;
+    readonly store: RunStore;
+    readonly workingDirectory: string;
+}) => AgentSessionRuntime;
+//# sourceMappingURL=agent-session.d.ts.map

package/dist/controller/agent-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.d.ts","sourceRoot":"","sources":["../../src/controller/agent-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,wBAAwB,EACxB,qBAAqB,EAEtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAIxD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,CAAA;IACtD,QAAQ,CAAC,cAAc,EAAE,qBAAqB,CAAA;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9D,QAAQ,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,QAAQ,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;IACpD,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;IAC/C,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAC9C,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAAA;IACpE,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpE,QAAQ,CAAC,kBAAkB,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3E,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAOlF,eAAO,MAAM,yBAAyB,GAAI,OAAO;IAC/C,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAA;IACvC,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;IACxB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;CAClC,KAAG,mBAgOH,CAAA"}

package/dist/controller/agent-session.js

@@ -0,0 +1,220 @@
+import { readAgentOutput } from "./agent-output.js";
+import { RunCancellationError } from "./errors.js";
+import { roleSystemPrompt } from "./role-prompts.js";
+export const createAgentSessionRuntime = (input) => {
+    const activeSessions = new Map();
+    const cancelledRunIds = new Set();
+    const throwIfCancelled = (runId) => {
+        if (cancelledRunIds.has(runId)) {
+            throw new RunCancellationError(runId);
+        }
+    };
+    const createPromptInput = (request) => ({
+        brief: request.brief,
+        constraints: request.constraints,
+        evidence: request.evidence,
+        outputContract: request.outputContract,
+    });
+    const appendSessionEvent = async (runId, type, sessionId, payload) => {
+        await input.store.appendEvents(runId, [
+            {
+                schemaVersion: "1.0.0",
+                eventId: input.ids.createEventId(`${type}-${runId}-${sessionId}`),
+                idempotencyKey: input.ids.createEventId(`session-${type}-${runId}-${sessionId}`),
+                runId,
+                type,
+                timestamp: new Date().toISOString(),
+                payload,
+            },
+        ]);
+    };
+    const setActiveSession = (runId, session) => {
+        const sessions = activeSessions.get(runId) ?? new Map();
+        sessions.set(session.sessionId, session);
+        activeSessions.set(runId, sessions);
+    };
+    const releaseActiveSession = async (runId, sessionId, reason) => {
+        const sessions = activeSessions.get(runId);
+        const activeSession = sessions?.get(sessionId);
+        if (activeSession === undefined) {
+            return;
+        }
+        if (activeSession.timeoutId !== undefined) {
+            clearTimeout(activeSession.timeoutId);
+        }
+        sessions?.delete(sessionId);
+        if (sessions?.size === 0) {
+            activeSessions.delete(runId);
+        }
+        await input.sessionAdapter.release({ sessionId: activeSession.sessionId, reason });
+    };
+    const requireOrphanSession = async (runId, sessionId) => {
+        const orphanSession = (await listOrphanSessions()).find((candidate) => candidate.runId === runId && candidate.sessionId === sessionId);
+        if (orphanSession === undefined) {
+            throw new TypeError(`orphan session ${sessionId} for run ${runId} does not exist`);
+        }
+        return orphanSession;
+    };
+    const listOrphanSessions = async () => {
+        if (input.store.listRunIds === undefined) {
+            return [];
+        }
+        const orphanSessions = [];
+        for (const runId of await input.store.listRunIds()) {
+            const events = await input.store.listEvents(runId);
+            const sessions = new Map();
+            for (const event of events) {
+                const sessionId = readStringPayload(event.payload, "sessionId");
+                if (sessionId === undefined) {
+                    continue;
+                }
+                if (event.type === "session.created") {
+                    const role = readRolePayload(event.payload);
+                    if (role !== undefined) {
+                        sessions.set(sessionId, { runId, sessionId, role, state: "created" });
+                    }
+                }
+                else if (event.type === "session.released" || event.type === "session.safe-abandoned") {
+                    sessions.delete(sessionId);
+                }
+                else if (event.type === "session.rebound") {
+                    const current = sessions.get(sessionId);
+                    if (current !== undefined) {
+                        sessions.set(sessionId, { ...current, state: "rebound" });
+                    }
+                }
+            }
+            orphanSessions.push(...sessions.values());
+        }
+        return orphanSessions;
+    };
+    const createTimeout = (runId, sessionId, timeoutMs) => {
+        if (timeoutMs === undefined) {
+            return undefined;
+        }
+        return setTimeout(() => {
+            void input.sessionAdapter.abort({ sessionId, reason: "timeout" }).catch(() => undefined);
+            void releaseActiveSession(runId, sessionId, "timeout");
+        }, timeoutMs);
+    };
+    return {
+        async sendAgent(request) {
+            throwIfCancelled(request.runId);
+            const session = await input.sessionAdapter.create({
+                role: request.role,
+                title: request.title,
+                workingDirectory: request.workingDirectory ?? input.workingDirectory,
+                ...(request.parentSessionId === undefined
+                    ? {}
+                    : { parentSessionId: request.parentSessionId }),
+                promptInput: createPromptInput(request),
+                ...(request.timeoutMs === undefined ? {} : { timeoutMs: request.timeoutMs }),
+            });
+            const timeoutId = createTimeout(request.runId, session.session.sessionId, request.timeoutMs);
+            setActiveSession(request.runId, timeoutId === undefined
+                ? { sessionId: session.session.sessionId }
+                : { sessionId: session.session.sessionId, timeoutId });
+            await appendSessionEvent(request.runId, "session.created", session.session.sessionId, {
+                sessionId: session.session.sessionId,
+                role: request.role,
+            });
+            try {
+                const result = await input.sessionAdapter.send({
+                    sessionId: session.session.sessionId,
+                    messageId: input.ids.createMessageId(request.messageLabel),
+                    prompt: request.brief,
+                    promptInput: createPromptInput(request),
+                    systemPrompt: request.systemPrompt ?? roleSystemPrompt(request.role),
+                });
+                throwIfCancelled(request.runId);
+                return readAgentOutput(result);
+            }
+            finally {
+                await appendSessionEvent(request.runId, "session.released", session.session.sessionId, {
+                    sessionId: session.session.sessionId,
+                    reason: "completed",
+                });
+                await releaseActiveSession(request.runId, session.session.sessionId, "completed");
+            }
+        },
+        async abortActiveSession(runId) {
+            cancelledRunIds.add(runId);
+            const sessions = activeSessions.get(runId);
+            if (sessions !== undefined) {
+                for (const activeSession of sessions.values()) {
+                    await input.sessionAdapter.abort({
+                        sessionId: activeSession.sessionId,
+                        reason: "controller",
+                    });
+                    await releaseActiveSession(runId, activeSession.sessionId, "controller");
+                }
+            }
+        },
+        hasActiveSession(runId) {
+            return (activeSessions.get(runId)?.size ?? 0) > 0;
+        },
+        isCancelled(runId) {
+            return cancelledRunIds.has(runId);
+        },
+        markCancelled(runId) {
+            cancelledRunIds.add(runId);
+        },
+        async listOrphanSessions() {
+            return listOrphanSessions();
+        },
+        async rebindSession(session) {
+            const orphanSession = await requireOrphanSession(session.runId, session.sessionId);
+            const snapshot = input.sessionAdapter.getSession(session.sessionId);
+            if (snapshot === undefined || snapshot.role !== orphanSession.role) {
+                throw new TypeError(`session ${session.sessionId} is not available for rebind`);
+            }
+            setActiveSession(session.runId, { sessionId: session.sessionId });
+            await appendSessionEvent(session.runId, "session.rebound", session.sessionId, {
+                sessionId: session.sessionId,
+                actorId: session.actorId,
+            });
+        },
+        async safeAbandonSession(session) {
+            await requireOrphanSession(session.runId, session.sessionId);
+            const sessions = activeSessions.get(session.runId);
+            if (sessions?.has(session.sessionId) === true) {
+                sessions.delete(session.sessionId);
+                if (sessions.size === 0) {
+                    activeSessions.delete(session.runId);
+                }
+            }
+            await input.sessionAdapter.release({
+                sessionId: session.sessionId,
+                reason: `safe-abandon:${session.reason}`,
+            });
+            await appendSessionEvent(session.runId, "session.safe-abandoned", session.sessionId, {
+                sessionId: session.sessionId,
+                actorId: session.actorId,
+                reason: session.reason,
+            });
+        },
+    };
+};
+const readStringPayload = (payload, key) => {
+    if (typeof payload !== "object" || payload === null || Array.isArray(payload)) {
+        return undefined;
+    }
+    const value = Reflect.get(payload, key);
+    return typeof value === "string" ? value : undefined;
+};
+const readRolePayload = (payload) => {
+    const role = readStringPayload(payload, "role");
+    switch (role) {
+        case "intake":
+        case "planner":
+        case "worker":
+        case "verifier":
+        case "acceptance":
+        case "failure-analyzer":
+        case "repair-worker":
+            return role;
+        default:
+            return undefined;
+    }
+};
+//# sourceMappingURL=agent-session.js.map

package/dist/controller/agent-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session.js","sourceRoot":"","sources":["../../src/controller/agent-session.ts"],"names":[],"mappings":"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"}