@elie-laloum/outpost 5.0.0 → 7.0.0

package/dist/domain/agent.types.d.ts

@@ -1,14 +1,73 @@
-import type { CustomHarness } from "./harness.types.ts";
+import type { Harness } from "./harness.types.ts";
 import type { AgentModel, ModelSpec } from "./model.types.ts";
-import type { Command, Variables } from "./command.types.ts";
+import type { Command, CommandResult, Variables } from "./command.types.ts";
 import type { ConversationStore } from "./conversation.types.ts";
 export interface Usage {
+    readonly complete?: boolean;
     readonly input: number;
     readonly cached: number;
     readonly cacheCreated?: number;
     readonly output: number;
 }
-export type AgentEvent = {
+export type AgentEvent = AgentEventDetails & {
+    readonly subagentId?: string;
+};
+export type AgentEventDetails = {
+    readonly kind: "subagent";
+    readonly id: string;
+    readonly callId: string;
+    readonly name: string;
+    readonly status: "started" | "finished" | "failed";
+    readonly conversation?: string;
+} | {
+    readonly kind: "message-usage";
+    readonly tokens: Usage;
+    readonly messageId?: string;
+    readonly parentCallId?: string;
+} | {
+    readonly kind: "stderr";
+    readonly text: string;
+    readonly truncated?: boolean;
+} | {
+    readonly kind: "stopped";
+    readonly reason: "completion" | "idle-timeout" | "deadline" | "aborted" | "oversized-event";
+} | {
+    readonly kind: "reasoning";
+    readonly text: string;
+    readonly parentCallId?: string;
+} | {
+    readonly kind: "file-change";
+    readonly changes: unknown;
+    readonly callId?: string;
+} | {
+    readonly kind: "model-request";
+    readonly request: unknown;
+} | {
+    readonly kind: "model-response";
+    readonly response: unknown;
+} | {
+    readonly kind: "model-retry";
+    readonly attempt: number;
+    readonly message?: string;
+} | {
+    readonly kind: "model-error";
+    readonly message: string;
+} | {
+    readonly kind: "hook";
+    readonly phase: string;
+    readonly changed: boolean;
+} | {
+    readonly kind: "instructions-loaded";
+    readonly count: number;
+} | {
+    readonly kind: "skills-loaded";
+    readonly names: readonly string[];
+} | {
+    readonly kind: "tool-output";
+    readonly callId: string;
+    readonly channel: "stdout" | "stderr";
+    readonly text: string;
+} | {
     readonly kind: "phase";
     readonly name: string;
     readonly agent?: string;
@@ -39,6 +98,7 @@ export type AgentEvent = {
     readonly name: string;
     readonly input: unknown;
     readonly callId?: string;
+    readonly parentCallId?: string;
 } | {
     readonly kind: "tool-result";
     readonly callId: string;
@@ -46,6 +106,7 @@ export type AgentEvent = {
     readonly isError: boolean;
     readonly preview: string;
     readonly characters: number;
+    readonly parentCallId?: string;
 } | {
     readonly kind: "step";
     readonly index: number;
@@ -67,6 +128,7 @@ export type AgentEvent = {
 } | {
     readonly kind: "usage";
     readonly tokens: Usage;
+    readonly cumulative?: boolean;
 } | {
     readonly kind: "failure";
     readonly message: string;
@@ -75,10 +137,15 @@ export type AgentEvent = {
 } | {
     readonly kind: "raw";
     readonly value: unknown;
+    readonly bytes?: number;
+    readonly truncated?: boolean;
 };
 export type AgentObservation = AgentEvent & {
     readonly pass: number;
     readonly at: string;
+    readonly seq?: number;
+    readonly source?: import("./observation.types.ts").ObservationSource;
+    readonly scope?: import("./observation.types.ts").ObservationScope;
 };
 export type AgentEventHandlers = {
     readonly [Kind in AgentEvent["kind"]]?: (event: Extract<AgentEvent, {
@@ -97,17 +164,22 @@ export interface AgentFeatures {
     readonly name: string;
     readonly bootstrap?: string;
     readonly requiresFinishedEvent?: boolean;
+    readonly usage?: "events" | "session" | "unavailable";
     readonly variables?: Variables;
-    readonly conversations?: "claude" | "codex";
+    readonly conversations?: "claude" | "codex" | "copilot" | "kimi";
     readonly storage?: ConversationStore;
     readonly capture?: boolean;
     readonly resumable?: boolean;
+    readonly forkable?: boolean;
     transcriptUsage?(text: string): Usage | undefined;
 }
 export interface AgentAdapter extends AgentFeatures {
-    authenticate?(variables: Readonly<Record<string, string>>): Command | undefined;
+    fork?(id: string, invoke: (command: Command) => Promise<CommandResult>): Promise<string>;
+    credentials?(variables: Variables): CredentialPlan;
     request(input: AgentInput): Command;
     events(line: string): readonly AgentEvent[];
+    usageCommand?(conversation: string): Command | undefined;
+    usageResult?(text: string): Usage | undefined;
 }
 export interface RequiredAgent {
     readonly agent: Agent;
@@ -116,7 +188,7 @@ export interface CliHarness {
     readonly kind: "cli";
     bind(model?: AgentModel): AgentAdapter;
 }
-export type Harness = CliHarness | CustomHarness;
+export type AgentHarness = CliHarness | Harness;
 export interface CliAgent extends AgentAdapter {
     readonly kind: "cli";
     readonly harness: CliHarness;
@@ -126,7 +198,7 @@ export interface CustomAgent extends AgentFeatures {
     readonly resumable: boolean;
     readonly capture: boolean;
     readonly kind: "custom";
-    readonly harness: CustomHarness;
+    readonly harness: Harness;
     readonly model: AgentModel;
 }
 export type Agent = CliAgent | CustomAgent;
@@ -135,16 +207,52 @@ export interface CliAgentOptions {
     readonly model?: ModelSpec;
 }
 export interface CustomAgentOptions {
-    readonly harness: CustomHarness;
+    readonly harness: Harness;
     readonly model: ModelSpec;
 }
 export type AgentOptions = CliAgentOptions | CustomAgentOptions;
-export type AgentAuthentication = {
-    readonly mode: "api-key";
-    readonly environment?: string;
+export type AccountCredential = {
+    readonly file: string;
 } | {
-    readonly mode: "oauth-token";
+    readonly key: string;
+} | {
+    readonly variable: string;
+};
+export type UsageCredential = {
+    readonly key: string;
 } | {
-    readonly mode: "login";
-    readonly credentials?: string;
+    readonly variable: string;
 };
+export type AgentAuthentication = "account" | "usage" | {
+    readonly account: AccountCredential;
+} | {
+    readonly usage: UsageCredential;
+};
+export interface HostCredentialPath {
+    readonly path: string;
+    readonly home?: {
+        readonly variable: string;
+        readonly path: string;
+    };
+}
+export interface HostCredential {
+    readonly source: HostCredentialPath;
+    readonly destination: {
+        readonly file: string;
+    } | {
+        readonly variable: string;
+    };
+    readonly login: string;
+    readonly alternative?: string;
+    select?(content: string): string;
+}
+export interface GeneratedCredential {
+    readonly path: string;
+    readonly content: string;
+}
+export interface CredentialPlan {
+    readonly variables: Variables;
+    readonly host: readonly HostCredential[];
+    readonly files: readonly GeneratedCredential[];
+    readonly commands: readonly Command[];
+}

package/dist/domain/agent.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.types.js","sourceRoot":"","sources":["../../src/domain/agent.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { CustomHarness } from \"./harness.types.ts\";\nimport type { AgentModel, ModelSpec } from \"./model.types.ts\";\nimport type { Command, Variables } from \"./command.types.ts\";\nimport type { ConversationStore } from \"./conversation.types.ts\";\n\nexport interface Usage {\n  readonly input: number;\n  readonly cached: number;\n  readonly cacheCreated?: number;\n  readonly output: number;\n}\n\nexport type AgentEvent =\n  | {\n      readonly kind: \"phase\";\n      readonly name: string;\n      readonly agent?: string;\n      readonly branch?: string;\n      readonly directory?: string;\n    }\n  | {\n      readonly kind: \"summary\";\n      readonly durationMs: number;\n      readonly status: number;\n      readonly tokens: Usage;\n    }\n  | { readonly kind: \"warning\"; readonly message: string }\n  | { readonly kind: \"text\"; readonly text: string }\n  | { readonly kind: \"text-delta\"; readonly text: string }\n  | { readonly kind: \"result\"; readonly text: string }\n  | { readonly kind: \"prompt\"; readonly text: string }\n  | {\n      readonly kind: \"tool\";\n      readonly name: string;\n      readonly input: unknown;\n      readonly callId?: string;\n    }\n  | {\n      readonly kind: \"tool-result\";\n      readonly callId: string;\n      readonly name: string;\n      readonly isError: boolean;\n      readonly preview: string;\n      readonly characters: number;\n    }\n  | { readonly kind: \"step\"; readonly index: number }\n  | {\n      readonly kind: \"tool-denied\";\n      readonly callId: string;\n      readonly name: string;\n      readonly reason: string;\n    }\n  | { readonly kind: \"stop-prevented\"; readonly message: string }\n  | {\n      readonly kind: \"compaction\";\n      readonly strategy: string;\n      readonly messages: number;\n    }\n  | { readonly kind: \"conversation\"; readonly id: string }\n  | { readonly kind: \"usage\"; readonly tokens: Usage }\n  | { readonly kind: \"failure\"; readonly message: string }\n  | { readonly kind: \"finished\" }\n  | { readonly kind: \"raw\"; readonly value: unknown };\n\nexport type AgentObservation = AgentEvent & {\n  readonly pass: number;\n  readonly at: string;\n};\n\nexport type AgentEventHandlers = {\n  readonly [Kind in AgentEvent[\"kind\"]]?: (\n    event: Extract<AgentEvent, { kind: Kind }>,\n  ) => void;\n};\n\nexport interface AgentInput {\n  readonly text?: string;\n  readonly interactive?: boolean;\n  readonly continuation?: { readonly id: string; readonly fork?: boolean };\n}\n\nexport interface AgentFeatures {\n  readonly name: string;\n  readonly bootstrap?: string;\n  readonly requiresFinishedEvent?: boolean;\n  readonly variables?: Variables;\n  readonly conversations?: \"claude\" | \"codex\";\n  readonly storage?: ConversationStore;\n  readonly capture?: boolean;\n  readonly resumable?: boolean;\n  transcriptUsage?(text: string): Usage | undefined;\n}\n\nexport interface AgentAdapter extends AgentFeatures {\n  authenticate?(\n    variables: Readonly<Record<string, string>>,\n  ): Command | undefined;\n  request(input: AgentInput): Command;\n  events(line: string): readonly AgentEvent[];\n}\n\nexport interface RequiredAgent {\n  readonly agent: Agent;\n}\n\nexport interface CliHarness {\n  readonly kind: \"cli\";\n  bind(model?: AgentModel): AgentAdapter;\n}\n\nexport type Harness = CliHarness | CustomHarness;\n\nexport interface CliAgent extends AgentAdapter {\n  readonly kind: \"cli\";\n  readonly harness: CliHarness;\n  readonly model?: AgentModel;\n}\n\nexport interface CustomAgent extends AgentFeatures {\n  readonly resumable: boolean;\n  readonly capture: boolean;\n  readonly kind: \"custom\";\n  readonly harness: CustomHarness;\n  readonly model: AgentModel;\n}\n\nexport type Agent = CliAgent | CustomAgent;\n\nexport interface CliAgentOptions {\n  readonly harness: CliHarness;\n  readonly model?: ModelSpec;\n}\nexport interface CustomAgentOptions {\n  readonly harness: CustomHarness;\n  readonly model: ModelSpec;\n}\nexport type AgentOptions = CliAgentOptions | CustomAgentOptions;\n\nexport type AgentAuthentication =\n  | { readonly mode: \"api-key\"; readonly environment?: string }\n  | { readonly mode: \"oauth-token\" }\n  | { readonly mode: \"login\"; readonly credentials?: string };\n"]}
+{"version":3,"file":"agent.types.js","sourceRoot":"","sources":["../../src/domain/agent.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Harness } from \"./harness.types.ts\";\nimport type { AgentModel, ModelSpec } from \"./model.types.ts\";\nimport type { Command, CommandResult, Variables } from \"./command.types.ts\";\nimport type { ConversationStore } from \"./conversation.types.ts\";\n\nexport interface Usage {\n  readonly complete?: boolean;\n  readonly input: number;\n  readonly cached: number;\n  readonly cacheCreated?: number;\n  readonly output: number;\n}\n\nexport type AgentEvent = AgentEventDetails & {\n  readonly subagentId?: string;\n};\n\nexport type AgentEventDetails =\n  | {\n      readonly kind: \"subagent\";\n      readonly id: string;\n      readonly callId: string;\n      readonly name: string;\n      readonly status: \"started\" | \"finished\" | \"failed\";\n      readonly conversation?: string;\n    }\n  | {\n      readonly kind: \"message-usage\";\n      readonly tokens: Usage;\n      readonly messageId?: string;\n      readonly parentCallId?: string;\n    }\n  | {\n      readonly kind: \"stderr\";\n      readonly text: string;\n      readonly truncated?: boolean;\n    }\n  | {\n      readonly kind: \"stopped\";\n      readonly reason:\n        | \"completion\"\n        | \"idle-timeout\"\n        | \"deadline\"\n        | \"aborted\"\n        | \"oversized-event\";\n    }\n  | {\n      readonly kind: \"reasoning\";\n      readonly text: string;\n      readonly parentCallId?: string;\n    }\n  | {\n      readonly kind: \"file-change\";\n      readonly changes: unknown;\n      readonly callId?: string;\n    }\n  | { readonly kind: \"model-request\"; readonly request: unknown }\n  | { readonly kind: \"model-response\"; readonly response: unknown }\n  | {\n      readonly kind: \"model-retry\";\n      readonly attempt: number;\n      readonly message?: string;\n    }\n  | { readonly kind: \"model-error\"; readonly message: string }\n  | { readonly kind: \"hook\"; readonly phase: string; readonly changed: boolean }\n  | { readonly kind: \"instructions-loaded\"; readonly count: number }\n  | { readonly kind: \"skills-loaded\"; readonly names: readonly string[] }\n  | {\n      readonly kind: \"tool-output\";\n      readonly callId: string;\n      readonly channel: \"stdout\" | \"stderr\";\n      readonly text: string;\n    }\n  | {\n      readonly kind: \"phase\";\n      readonly name: string;\n      readonly agent?: string;\n      readonly branch?: string;\n      readonly directory?: string;\n    }\n  | {\n      readonly kind: \"summary\";\n      readonly durationMs: number;\n      readonly status: number;\n      readonly tokens: Usage;\n    }\n  | { readonly kind: \"warning\"; readonly message: string }\n  | { readonly kind: \"text\"; readonly text: string }\n  | { readonly kind: \"text-delta\"; readonly text: string }\n  | { readonly kind: \"result\"; readonly text: string }\n  | { readonly kind: \"prompt\"; readonly text: string }\n  | {\n      readonly kind: \"tool\";\n      readonly name: string;\n      readonly input: unknown;\n      readonly callId?: string;\n      readonly parentCallId?: string;\n    }\n  | {\n      readonly kind: \"tool-result\";\n      readonly callId: string;\n      readonly name: string;\n      readonly isError: boolean;\n      readonly preview: string;\n      readonly characters: number;\n      readonly parentCallId?: string;\n    }\n  | { readonly kind: \"step\"; readonly index: number }\n  | {\n      readonly kind: \"tool-denied\";\n      readonly callId: string;\n      readonly name: string;\n      readonly reason: string;\n    }\n  | { readonly kind: \"stop-prevented\"; readonly message: string }\n  | {\n      readonly kind: \"compaction\";\n      readonly strategy: string;\n      readonly messages: number;\n    }\n  | { readonly kind: \"conversation\"; readonly id: string }\n  | {\n      readonly kind: \"usage\";\n      readonly tokens: Usage;\n      readonly cumulative?: boolean;\n    }\n  | { readonly kind: \"failure\"; readonly message: string }\n  | { readonly kind: \"finished\" }\n  | {\n      readonly kind: \"raw\";\n      readonly value: unknown;\n      readonly bytes?: number;\n      readonly truncated?: boolean;\n    };\n\nexport type AgentObservation = AgentEvent & {\n  readonly pass: number;\n  readonly at: string;\n  readonly seq?: number;\n  readonly source?: import(\"./observation.types.ts\").ObservationSource;\n  readonly scope?: import(\"./observation.types.ts\").ObservationScope;\n};\n\nexport type AgentEventHandlers = {\n  readonly [Kind in AgentEvent[\"kind\"]]?: (\n    event: Extract<AgentEvent, { kind: Kind }>,\n  ) => void;\n};\n\nexport interface AgentInput {\n  readonly text?: string;\n  readonly interactive?: boolean;\n  readonly continuation?: { readonly id: string; readonly fork?: boolean };\n}\n\nexport interface AgentFeatures {\n  readonly name: string;\n  readonly bootstrap?: string;\n  readonly requiresFinishedEvent?: boolean;\n  readonly usage?: \"events\" | \"session\" | \"unavailable\";\n  readonly variables?: Variables;\n  readonly conversations?: \"claude\" | \"codex\" | \"copilot\" | \"kimi\";\n  readonly storage?: ConversationStore;\n  readonly capture?: boolean;\n  readonly resumable?: boolean;\n  readonly forkable?: boolean;\n  transcriptUsage?(text: string): Usage | undefined;\n}\n\nexport interface AgentAdapter extends AgentFeatures {\n  fork?(\n    id: string,\n    invoke: (command: Command) => Promise<CommandResult>,\n  ): Promise<string>;\n  credentials?(variables: Variables): CredentialPlan;\n  request(input: AgentInput): Command;\n  events(line: string): readonly AgentEvent[];\n  usageCommand?(conversation: string): Command | undefined;\n  usageResult?(text: string): Usage | undefined;\n}\n\nexport interface RequiredAgent {\n  readonly agent: Agent;\n}\n\nexport interface CliHarness {\n  readonly kind: \"cli\";\n  bind(model?: AgentModel): AgentAdapter;\n}\n\nexport type AgentHarness = CliHarness | Harness;\n\nexport interface CliAgent extends AgentAdapter {\n  readonly kind: \"cli\";\n  readonly harness: CliHarness;\n  readonly model?: AgentModel;\n}\n\nexport interface CustomAgent extends AgentFeatures {\n  readonly resumable: boolean;\n  readonly capture: boolean;\n  readonly kind: \"custom\";\n  readonly harness: Harness;\n  readonly model: AgentModel;\n}\n\nexport type Agent = CliAgent | CustomAgent;\n\nexport interface CliAgentOptions {\n  readonly harness: CliHarness;\n  readonly model?: ModelSpec;\n}\nexport interface CustomAgentOptions {\n  readonly harness: Harness;\n  readonly model: ModelSpec;\n}\nexport type AgentOptions = CliAgentOptions | CustomAgentOptions;\n\nexport type AccountCredential =\n  | { readonly file: string }\n  | { readonly key: string }\n  | { readonly variable: string };\n\nexport type UsageCredential =\n  { readonly key: string } | { readonly variable: string };\n\nexport type AgentAuthentication =\n  | \"account\"\n  | \"usage\"\n  | { readonly account: AccountCredential }\n  | { readonly usage: UsageCredential };\n\nexport interface HostCredentialPath {\n  readonly path: string;\n  readonly home?: { readonly variable: string; readonly path: string };\n}\n\nexport interface HostCredential {\n  readonly source: HostCredentialPath;\n  readonly destination:\n    { readonly file: string } | { readonly variable: string };\n  readonly login: string;\n  readonly alternative?: string;\n  select?(content: string): string;\n}\n\nexport interface GeneratedCredential {\n  readonly path: string;\n  readonly content: string;\n}\n\nexport interface CredentialPlan {\n  readonly variables: Variables;\n  readonly host: readonly HostCredential[];\n  readonly files: readonly GeneratedCredential[];\n  readonly commands: readonly Command[];\n}\n"]}

package/dist/domain/authentication.constants.d.ts

@@ -0,0 +1,3 @@
+import type { AuthenticationForm } from "./authentication.types.ts";
+export declare const authenticationForms: readonly AuthenticationForm[];
+export declare const VARIABLE_NAME: RegExp;

package/dist/domain/authentication.constants.js

@@ -0,0 +1,11 @@
+export const authenticationForms = [
+    "account",
+    "account.file",
+    "account.key",
+    "account.variable",
+    "usage",
+    "usage.key",
+    "usage.variable",
+];
+export const VARIABLE_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+//# sourceMappingURL=authentication.constants.js.map

package/dist/domain/authentication.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authentication.constants.js","sourceRoot":"","sources":["../../src/domain/authentication.constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,mBAAmB,GAAkC;IAChE,SAAS;IACT,cAAc;IACd,aAAa;IACb,kBAAkB;IAClB,OAAO;IACP,WAAW;IACX,gBAAgB;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,0BAA0B,CAAC","sourcesContent":["import type { AuthenticationForm } from \"./authentication.types.ts\";\n\nexport const authenticationForms: readonly AuthenticationForm[] = [\n  \"account\",\n  \"account.file\",\n  \"account.key\",\n  \"account.variable\",\n  \"usage\",\n  \"usage.key\",\n  \"usage.variable\",\n];\n\nexport const VARIABLE_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;\n"]}

package/dist/domain/authentication.d.ts

@@ -0,0 +1,3 @@
+import type { AgentAuthentication } from "./agent.types.ts";
+import type { AuthenticationSelection } from "./authentication.types.ts";
+export declare function authenticationForm(value: AgentAuthentication): AuthenticationSelection;

package/dist/domain/authentication.js

@@ -0,0 +1,22 @@
+import { VARIABLE_NAME, authenticationForms, } from "./authentication.constants.js";
+import { invariant } from "./errors.js";
+const expected = 'Use "account", "usage", { account: { file | key | variable } } or { usage: { key | variable } }';
+function singleEntry(value, label) {
+    invariant(value !== null && typeof value === "object" && !Array.isArray(value), `${label} must be "account", "usage" or an object. ${expected}`);
+    const entries = Object.entries(value);
+    invariant(entries.length === 1, `${label} must have exactly one key. ${expected}`);
+    return entries[0];
+}
+export function authenticationForm(value) {
+    if (value === "account" || value === "usage")
+        return { form: value };
+    const [kind, credential] = singleEntry(value, "Authentication");
+    invariant(kind === "account" || kind === "usage", `Unknown authentication "${kind}". ${expected}`);
+    const [source, text] = singleEntry(credential, `Authentication ${kind}`);
+    const form = authenticationForms.find((candidate) => candidate === `${kind}.${source}`);
+    invariant(form, `${kind} authentication does not accept "${source}". ${expected}`);
+    invariant(typeof text === "string" && text.trim() !== "", `${form} must be a nonempty string`);
+    invariant(source !== "variable" || VARIABLE_NAME.test(text), `Invalid authentication environment variable: ${text}`);
+    return { form, value: text };
+}
+//# sourceMappingURL=authentication.js.map

package/dist/domain/authentication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authentication.js","sourceRoot":"","sources":["../../src/domain/authentication.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,QAAQ,GACZ,iGAAiG,CAAC;AAEpG,SAAS,WAAW,CAAC,KAAc,EAAE,KAAa;IAChD,SAAS,CACP,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EACpE,GAAG,KAAK,6CAA6C,QAAQ,EAAE,CAChE,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,SAAS,CACP,OAAO,CAAC,MAAM,KAAK,CAAC,EACpB,GAAG,KAAK,+BAA+B,QAAQ,EAAE,CAClD,CAAC;IACF,OAAO,OAAO,CAAC,CAAC,CAAE,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAA0B;IAE1B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACrE,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,WAAW,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC;IAChE,SAAS,CACP,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,OAAO,EACtC,2BAA2B,IAAI,MAAM,QAAQ,EAAE,CAChD,CAAC;IACF,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,WAAW,CAAC,UAAU,EAAE,kBAAkB,IAAI,EAAE,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CACnC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,GAAG,IAAI,IAAI,MAAM,EAAE,CACjD,CAAC;IACF,SAAS,CACP,IAAI,EACJ,GAAG,IAAI,oCAAoC,MAAM,MAAM,QAAQ,EAAE,CAClE,CAAC;IACF,SAAS,CACP,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAC9C,GAAG,IAAI,4BAA4B,CACpC,CAAC;IACF,SAAS,CACP,MAAM,KAAK,UAAU,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EACjD,gDAAgD,IAAI,EAAE,CACvD,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC","sourcesContent":["import type { AgentAuthentication } from \"./agent.types.ts\";\nimport {\n  VARIABLE_NAME,\n  authenticationForms,\n} from \"./authentication.constants.ts\";\nimport type { AuthenticationSelection } from \"./authentication.types.ts\";\nimport { invariant } from \"./errors.ts\";\n\nconst expected =\n  'Use \"account\", \"usage\", { account: { file | key | variable } } or { usage: { key | variable } }';\n\nfunction singleEntry(value: unknown, label: string): [string, unknown] {\n  invariant(\n    value !== null && typeof value === \"object\" && !Array.isArray(value),\n    `${label} must be \"account\", \"usage\" or an object. ${expected}`,\n  );\n  const entries = Object.entries(value);\n  invariant(\n    entries.length === 1,\n    `${label} must have exactly one key. ${expected}`,\n  );\n  return entries[0]!;\n}\n\nexport function authenticationForm(\n  value: AgentAuthentication,\n): AuthenticationSelection {\n  if (value === \"account\" || value === \"usage\") return { form: value };\n  const [kind, credential] = singleEntry(value, \"Authentication\");\n  invariant(\n    kind === \"account\" || kind === \"usage\",\n    `Unknown authentication \"${kind}\". ${expected}`,\n  );\n  const [source, text] = singleEntry(credential, `Authentication ${kind}`);\n  const form = authenticationForms.find(\n    (candidate) => candidate === `${kind}.${source}`,\n  );\n  invariant(\n    form,\n    `${kind} authentication does not accept \"${source}\". ${expected}`,\n  );\n  invariant(\n    typeof text === \"string\" && text.trim() !== \"\",\n    `${form} must be a nonempty string`,\n  );\n  invariant(\n    source !== \"variable\" || VARIABLE_NAME.test(text),\n    `Invalid authentication environment variable: ${text}`,\n  );\n  return { form, value: text };\n}\n"]}

package/dist/domain/authentication.types.d.ts

@@ -0,0 +1,5 @@
+export type AuthenticationForm = "account" | "account.file" | "account.key" | "account.variable" | "usage" | "usage.key" | "usage.variable";
+export interface AuthenticationSelection {
+    readonly form: AuthenticationForm;
+    readonly value?: string;
+}

package/dist/domain/authentication.types.js

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

package/dist/domain/authentication.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authentication.types.js","sourceRoot":"","sources":["../../src/domain/authentication.types.ts"],"names":[],"mappings":"","sourcesContent":["export type AuthenticationForm =\n  | \"account\"\n  | \"account.file\"\n  | \"account.key\"\n  | \"account.variable\"\n  | \"usage\"\n  | \"usage.key\"\n  | \"usage.variable\";\n\nexport interface AuthenticationSelection {\n  readonly form: AuthenticationForm;\n  readonly value?: string;\n}\n"]}

package/dist/domain/harness.d.ts

@@ -1,2 +1,2 @@
-import type { CustomHarness, CustomHarnessOptions } from "./harness.types.ts";
-export declare function harness(options: CustomHarnessOptions): CustomHarness;
+import type { Harness, HarnessOptions } from "./harness.types.ts";
+export declare function harness(options: HarnessOptions): Harness;

package/dist/domain/harness.js

@@ -48,6 +48,9 @@ export function harness(options) {
 }
 function limits(value) {
     invariant(value !== null && typeof value === "object", "Harness limits must be an object");
+    if (value.maxDelegationDepth !== undefined)
+        invariant(Number.isSafeInteger(value.maxDelegationDepth) &&
+            value.maxDelegationDepth >= 0, "Harness maxDelegationDepth must be a nonnegative integer");
     const maxSteps = positive(value.maxSteps ?? HARNESS_DEFAULTS.maxSteps, "Harness maxSteps");
     if (value.maxToolCalls !== undefined)
         positive(value.maxToolCalls, "Harness maxToolCalls");
@@ -60,6 +63,9 @@ function limits(value) {
     }
     return Object.freeze({
         maxSteps,
+        ...(value.maxDelegationDepth === undefined
+            ? {}
+            : { maxDelegationDepth: value.maxDelegationDepth }),
         ...(value.maxToolCalls === undefined
             ? {}
             : { maxToolCalls: value.maxToolCalls }),

package/dist/domain/harness.js.map

@@ -1 +1 @@
-{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../src/domain/harness.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ConversationStore } from \"./conversation.types.ts\";\nimport { invariant, positive } from \"./errors.ts\";\nimport {\n  HARNESS_DEFAULTS,\n  HARNESS_FIELDS,\n  USAGE_FIELDS,\n} from \"./harness.constants.ts\";\nimport type {\n  CustomHarness,\n  CustomHarnessOptions,\n  HarnessLimits,\n  HarnessToolExecution,\n  ResolvedHarnessLimits,\n} from \"./harness.types.ts\";\nimport { harnessHooks } from \"./hook.ts\";\nimport {\n  defineHarnessInstructions,\n  harnessInstructions,\n} from \"./instructions.ts\";\nimport { harnessSkills, skillCatalog, skillLoader } from \"./skill.ts\";\nimport { harnessTools } from \"./tool.ts\";\n\nexport function harness(options: CustomHarnessOptions): CustomHarness {\n  invariant(\n    options !== null && typeof options === \"object\",\n    \"Harness options must be an object\",\n  );\n  invariant(\n    !(\"run\" in options),\n    \"harness() no longer accepts run; declare tools, instructions and limits\",\n  );\n  const unsupported = Object.keys(options).filter(\n    (key) => !HARNESS_FIELDS.has(key),\n  );\n  invariant(\n    unsupported.length === 0,\n    `Unsupported harness option: ${unsupported.join(\", \")}`,\n  );\n  invariant(\n    typeof options.modelProvider?.request === \"function\",\n    \"Custom harness requires a model provider\",\n  );\n  invariant(\n    options.modelProvider.validate === undefined ||\n      typeof options.modelProvider.validate === \"function\",\n    \"Model provider validate must be a function\",\n  );\n  invariant(\n    options.cache === undefined || typeof options.cache === \"boolean\",\n    \"Harness cache must be boolean\",\n  );\n  invariant(\n    options.permissions === undefined ||\n      options.permissions?.kind === \"permissions\",\n    \"Declare permissions with defineHarnessPermissions\",\n  );\n  invariant(\n    options.context === undefined || options.context?.kind === \"context\",\n    \"Declare context strategies with defineHarnessContextStrategy\",\n  );\n  invariant(\n    options.conversations === undefined ||\n      options.conversations === false ||\n      conversationStore(options.conversations),\n    \"Harness conversations must be a conversation store or false\",\n  );\n  const skills = harnessSkills(options.skills);\n  return Object.freeze({\n    kind: \"custom\",\n    modelProvider: options.modelProvider,\n    instructions: Object.freeze([\n      ...harnessInstructions(options.instructions),\n      ...(skills.length\n        ? [defineHarnessInstructions(skillCatalog(skills))]\n        : []),\n    ]),\n    tools: harnessTools([\n      ...(options.tools ?? []),\n      ...skills.flatMap((skill) => skill.tools),\n      ...(skills.length ? [skillLoader(skills)] : []),\n    ]),\n    skills,\n    limits: limits(options.limits ?? {}),\n    toolExecution: toolExecution(options.toolExecution ?? {}),\n    hooks: harnessHooks(options.hooks),\n    ...(options.permissions ? { permissions: options.permissions } : {}),\n    ...(options.context ? { context: options.context } : {}),\n    ...(options.conversations === undefined\n      ? {}\n      : { conversations: options.conversations }),\n    cache: options.cache ?? HARNESS_DEFAULTS.cache,\n  });\n}\n\nfunction limits(value: HarnessLimits): ResolvedHarnessLimits {\n  invariant(\n    value !== null && typeof value === \"object\",\n    \"Harness limits must be an object\",\n  );\n  const maxSteps = positive(\n    value.maxSteps ?? HARNESS_DEFAULTS.maxSteps,\n    \"Harness maxSteps\",\n  );\n  if (value.maxToolCalls !== undefined)\n    positive(value.maxToolCalls, \"Harness maxToolCalls\");\n  if (value.usage !== undefined) {\n    invariant(\n      value.usage !== null &&\n        typeof value.usage === \"object\" &&\n        Object.keys(value.usage).every((key) => USAGE_FIELDS.includes(key)),\n      \"Harness usage limits accept input, cached, cacheCreated and output\",\n    );\n    for (const limit of Object.values(value.usage))\n      invariant(\n        Number.isSafeInteger(limit) && limit >= 0,\n        \"Harness usage limits must be nonnegative integers\",\n      );\n  }\n  return Object.freeze({\n    maxSteps,\n    ...(value.maxToolCalls === undefined\n      ? {}\n      : { maxToolCalls: value.maxToolCalls }),\n    ...(value.usage === undefined\n      ? {}\n      : { usage: Object.freeze({ ...value.usage }) }),\n  });\n}\n\nfunction toolExecution(\n  value: HarnessToolExecution,\n): Required<HarnessToolExecution> {\n  invariant(\n    value !== null && typeof value === \"object\",\n    \"Harness toolExecution must be an object\",\n  );\n  invariant(\n    value.onError === undefined ||\n      value.onError === \"return-to-model\" ||\n      value.onError === \"fail\",\n    'Tool onError must be \"return-to-model\" or \"fail\"',\n  );\n  return Object.freeze({\n    concurrency: positive(\n      value.concurrency ?? HARNESS_DEFAULTS.concurrency,\n      \"Tool concurrency\",\n    ),\n    deadlineMs: positive(\n      value.deadlineMs ?? HARNESS_DEFAULTS.toolDeadlineMs,\n      \"Tool deadlineMs\",\n    ),\n    onError: value.onError ?? HARNESS_DEFAULTS.onError,\n  });\n}\n\nfunction conversationStore(value: ConversationStore): boolean {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    typeof value.locate === \"function\" &&\n    typeof value.capture === \"function\" &&\n    typeof value.restore === \"function\"\n  );\n}\n"]}
+{"version":3,"file":"harness.js","sourceRoot":"","sources":["../../src/domain/harness.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ConversationStore } from \"./conversation.types.ts\";\nimport { invariant, positive } from \"./errors.ts\";\nimport {\n  HARNESS_DEFAULTS,\n  HARNESS_FIELDS,\n  USAGE_FIELDS,\n} from \"./harness.constants.ts\";\nimport type {\n  Harness,\n  HarnessOptions,\n  HarnessLimits,\n  HarnessToolExecution,\n  ResolvedHarnessLimits,\n} from \"./harness.types.ts\";\nimport { harnessHooks } from \"./hook.ts\";\nimport {\n  defineHarnessInstructions,\n  harnessInstructions,\n} from \"./instructions.ts\";\nimport { harnessSkills, skillCatalog, skillLoader } from \"./skill.ts\";\nimport { harnessTools } from \"./tool.ts\";\n\nexport function harness(options: HarnessOptions): Harness {\n  invariant(\n    options !== null && typeof options === \"object\",\n    \"Harness options must be an object\",\n  );\n  invariant(\n    !(\"run\" in options),\n    \"harness() no longer accepts run; declare tools, instructions and limits\",\n  );\n  const unsupported = Object.keys(options).filter(\n    (key) => !HARNESS_FIELDS.has(key),\n  );\n  invariant(\n    unsupported.length === 0,\n    `Unsupported harness option: ${unsupported.join(\", \")}`,\n  );\n  invariant(\n    typeof options.modelProvider?.request === \"function\",\n    \"Custom harness requires a model provider\",\n  );\n  invariant(\n    options.modelProvider.validate === undefined ||\n      typeof options.modelProvider.validate === \"function\",\n    \"Model provider validate must be a function\",\n  );\n  invariant(\n    options.cache === undefined || typeof options.cache === \"boolean\",\n    \"Harness cache must be boolean\",\n  );\n  invariant(\n    options.permissions === undefined ||\n      options.permissions?.kind === \"permissions\",\n    \"Declare permissions with defineHarnessPermissions\",\n  );\n  invariant(\n    options.context === undefined || options.context?.kind === \"context\",\n    \"Declare context strategies with defineHarnessContextStrategy\",\n  );\n  invariant(\n    options.conversations === undefined ||\n      options.conversations === false ||\n      conversationStore(options.conversations),\n    \"Harness conversations must be a conversation store or false\",\n  );\n  const skills = harnessSkills(options.skills);\n  return Object.freeze({\n    kind: \"custom\",\n    modelProvider: options.modelProvider,\n    instructions: Object.freeze([\n      ...harnessInstructions(options.instructions),\n      ...(skills.length\n        ? [defineHarnessInstructions(skillCatalog(skills))]\n        : []),\n    ]),\n    tools: harnessTools([\n      ...(options.tools ?? []),\n      ...skills.flatMap((skill) => skill.tools),\n      ...(skills.length ? [skillLoader(skills)] : []),\n    ]),\n    skills,\n    limits: limits(options.limits ?? {}),\n    toolExecution: toolExecution(options.toolExecution ?? {}),\n    hooks: harnessHooks(options.hooks),\n    ...(options.permissions ? { permissions: options.permissions } : {}),\n    ...(options.context ? { context: options.context } : {}),\n    ...(options.conversations === undefined\n      ? {}\n      : { conversations: options.conversations }),\n    cache: options.cache ?? HARNESS_DEFAULTS.cache,\n  });\n}\n\nfunction limits(value: HarnessLimits): ResolvedHarnessLimits {\n  invariant(\n    value !== null && typeof value === \"object\",\n    \"Harness limits must be an object\",\n  );\n  if (value.maxDelegationDepth !== undefined)\n    invariant(\n      Number.isSafeInteger(value.maxDelegationDepth) &&\n        value.maxDelegationDepth >= 0,\n      \"Harness maxDelegationDepth must be a nonnegative integer\",\n    );\n  const maxSteps = positive(\n    value.maxSteps ?? HARNESS_DEFAULTS.maxSteps,\n    \"Harness maxSteps\",\n  );\n  if (value.maxToolCalls !== undefined)\n    positive(value.maxToolCalls, \"Harness maxToolCalls\");\n  if (value.usage !== undefined) {\n    invariant(\n      value.usage !== null &&\n        typeof value.usage === \"object\" &&\n        Object.keys(value.usage).every((key) => USAGE_FIELDS.includes(key)),\n      \"Harness usage limits accept input, cached, cacheCreated and output\",\n    );\n    for (const limit of Object.values(value.usage))\n      invariant(\n        Number.isSafeInteger(limit) && limit >= 0,\n        \"Harness usage limits must be nonnegative integers\",\n      );\n  }\n  return Object.freeze({\n    maxSteps,\n    ...(value.maxDelegationDepth === undefined\n      ? {}\n      : { maxDelegationDepth: value.maxDelegationDepth }),\n    ...(value.maxToolCalls === undefined\n      ? {}\n      : { maxToolCalls: value.maxToolCalls }),\n    ...(value.usage === undefined\n      ? {}\n      : { usage: Object.freeze({ ...value.usage }) }),\n  });\n}\n\nfunction toolExecution(\n  value: HarnessToolExecution,\n): Required<HarnessToolExecution> {\n  invariant(\n    value !== null && typeof value === \"object\",\n    \"Harness toolExecution must be an object\",\n  );\n  invariant(\n    value.onError === undefined ||\n      value.onError === \"return-to-model\" ||\n      value.onError === \"fail\",\n    'Tool onError must be \"return-to-model\" or \"fail\"',\n  );\n  return Object.freeze({\n    concurrency: positive(\n      value.concurrency ?? HARNESS_DEFAULTS.concurrency,\n      \"Tool concurrency\",\n    ),\n    deadlineMs: positive(\n      value.deadlineMs ?? HARNESS_DEFAULTS.toolDeadlineMs,\n      \"Tool deadlineMs\",\n    ),\n    onError: value.onError ?? HARNESS_DEFAULTS.onError,\n  });\n}\n\nfunction conversationStore(value: ConversationStore): boolean {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    typeof value.locate === \"function\" &&\n    typeof value.capture === \"function\" &&\n    typeof value.restore === \"function\"\n  );\n}\n"]}

package/dist/domain/harness.types.d.ts

@@ -20,8 +20,9 @@ export interface HarnessInstructions {
 export type HarnessInstructionsOption = string | HarnessInstructions | readonly (string | HarnessInstructions)[];
 export interface HarnessLimits {
     readonly maxSteps?: number;
+    readonly maxDelegationDepth?: number;
     readonly maxToolCalls?: number;
-    readonly usage?: Partial<Usage>;
+    readonly usage?: Partial<Omit<Usage, "complete">>;
 }
 export interface ResolvedHarnessLimits extends HarnessLimits {
     readonly maxSteps: number;
@@ -31,7 +32,7 @@ export interface HarnessToolExecution {
     readonly deadlineMs?: number;
     readonly onError?: "return-to-model" | "fail";
 }
-export interface CustomHarnessOptions {
+export interface HarnessOptions {
     readonly modelProvider: ModelProvider;
     readonly instructions?: HarnessInstructionsOption;
     readonly tools?: readonly (HarnessTool | HarnessToolset)[];
@@ -44,7 +45,7 @@ export interface CustomHarnessOptions {
     readonly skills?: readonly HarnessSkill[];
     readonly cache?: boolean;
 }
-export interface CustomHarness {
+export interface Harness {
     readonly kind: "custom";
     readonly modelProvider: ModelProvider;
     readonly instructions: readonly HarnessInstructions[];

package/dist/domain/harness.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"harness.types.js","sourceRoot":"","sources":["../../src/domain/harness.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Usage } from \"./agent.types.ts\";\nimport type { HarnessContextStrategy } from \"./context.types.ts\";\nimport type { ConversationStore } from \"./conversation.types.ts\";\nimport type { HarnessHook } from \"./hook.types.ts\";\nimport type { AgentModel, ModelProvider } from \"./model.types.ts\";\nimport type { HarnessPermissions } from \"./permissions.types.ts\";\nimport type { HarnessSkill } from \"./skill.types.ts\";\nimport type { SandboxLease } from \"./sandbox.types.ts\";\nimport type { HarnessTool, HarnessToolset } from \"./tool.types.ts\";\n\nexport interface HarnessInstructionContext {\n  readonly sandbox: SandboxLease;\n  readonly signal: AbortSignal;\n  readonly model: AgentModel;\n}\n\nexport type HarnessInstructionSource =\n  string | ((context: HarnessInstructionContext) => string | Promise<string>);\n\nexport interface HarnessInstructions {\n  readonly kind: \"instructions\";\n  resolve(context: HarnessInstructionContext): Promise<string>;\n}\n\nexport type HarnessInstructionsOption =\n  string | HarnessInstructions | readonly (string | HarnessInstructions)[];\n\nexport interface HarnessLimits {\n  readonly maxSteps?: number;\n  readonly maxToolCalls?: number;\n  readonly usage?: Partial<Usage>;\n}\n\nexport interface ResolvedHarnessLimits extends HarnessLimits {\n  readonly maxSteps: number;\n}\n\nexport interface HarnessToolExecution {\n  readonly concurrency?: number;\n  readonly deadlineMs?: number;\n  readonly onError?: \"return-to-model\" | \"fail\";\n}\n\nexport interface CustomHarnessOptions {\n  readonly modelProvider: ModelProvider;\n  readonly instructions?: HarnessInstructionsOption;\n  readonly tools?: readonly (HarnessTool | HarnessToolset)[];\n  readonly limits?: HarnessLimits;\n  readonly toolExecution?: HarnessToolExecution;\n  readonly hooks?: readonly HarnessHook[];\n  readonly permissions?: HarnessPermissions;\n  readonly context?: HarnessContextStrategy;\n  readonly conversations?: ConversationStore | false;\n  readonly skills?: readonly HarnessSkill[];\n  readonly cache?: boolean;\n}\n\nexport interface CustomHarness {\n  readonly kind: \"custom\";\n  readonly modelProvider: ModelProvider;\n  readonly instructions: readonly HarnessInstructions[];\n  readonly tools: readonly HarnessTool[];\n  readonly limits: ResolvedHarnessLimits;\n  readonly toolExecution: Required<HarnessToolExecution>;\n  readonly hooks: readonly HarnessHook[];\n  readonly permissions?: HarnessPermissions;\n  readonly context?: HarnessContextStrategy;\n  readonly conversations?: ConversationStore | false;\n  readonly skills: readonly HarnessSkill[];\n  readonly cache: boolean;\n}\n"]}
+{"version":3,"file":"harness.types.js","sourceRoot":"","sources":["../../src/domain/harness.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Usage } from \"./agent.types.ts\";\nimport type { HarnessContextStrategy } from \"./context.types.ts\";\nimport type { ConversationStore } from \"./conversation.types.ts\";\nimport type { HarnessHook } from \"./hook.types.ts\";\nimport type { AgentModel, ModelProvider } from \"./model.types.ts\";\nimport type { HarnessPermissions } from \"./permissions.types.ts\";\nimport type { HarnessSkill } from \"./skill.types.ts\";\nimport type { SandboxLease } from \"./sandbox.types.ts\";\nimport type { HarnessTool, HarnessToolset } from \"./tool.types.ts\";\n\nexport interface HarnessInstructionContext {\n  readonly sandbox: SandboxLease;\n  readonly signal: AbortSignal;\n  readonly model: AgentModel;\n}\n\nexport type HarnessInstructionSource =\n  string | ((context: HarnessInstructionContext) => string | Promise<string>);\n\nexport interface HarnessInstructions {\n  readonly kind: \"instructions\";\n  resolve(context: HarnessInstructionContext): Promise<string>;\n}\n\nexport type HarnessInstructionsOption =\n  string | HarnessInstructions | readonly (string | HarnessInstructions)[];\n\nexport interface HarnessLimits {\n  readonly maxSteps?: number;\n  readonly maxDelegationDepth?: number;\n  readonly maxToolCalls?: number;\n  readonly usage?: Partial<Omit<Usage, \"complete\">>;\n}\n\nexport interface ResolvedHarnessLimits extends HarnessLimits {\n  readonly maxSteps: number;\n}\n\nexport interface HarnessToolExecution {\n  readonly concurrency?: number;\n  readonly deadlineMs?: number;\n  readonly onError?: \"return-to-model\" | \"fail\";\n}\n\nexport interface HarnessOptions {\n  readonly modelProvider: ModelProvider;\n  readonly instructions?: HarnessInstructionsOption;\n  readonly tools?: readonly (HarnessTool | HarnessToolset)[];\n  readonly limits?: HarnessLimits;\n  readonly toolExecution?: HarnessToolExecution;\n  readonly hooks?: readonly HarnessHook[];\n  readonly permissions?: HarnessPermissions;\n  readonly context?: HarnessContextStrategy;\n  readonly conversations?: ConversationStore | false;\n  readonly skills?: readonly HarnessSkill[];\n  readonly cache?: boolean;\n}\n\nexport interface Harness {\n  readonly kind: \"custom\";\n  readonly modelProvider: ModelProvider;\n  readonly instructions: readonly HarnessInstructions[];\n  readonly tools: readonly HarnessTool[];\n  readonly limits: ResolvedHarnessLimits;\n  readonly toolExecution: Required<HarnessToolExecution>;\n  readonly hooks: readonly HarnessHook[];\n  readonly permissions?: HarnessPermissions;\n  readonly context?: HarnessContextStrategy;\n  readonly conversations?: ConversationStore | false;\n  readonly skills: readonly HarnessSkill[];\n  readonly cache: boolean;\n}\n"]}

package/dist/domain/model.types.d.ts

@@ -23,6 +23,7 @@ export interface ModelToolResultBlock {
     readonly isError?: boolean;
 }
 export interface ModelReasoningBlock {
+    readonly text?: string;
     readonly type: "reasoning";
     readonly provider: string;
     readonly model: string;
@@ -57,6 +58,13 @@ export interface ModelResult {
     readonly usage?: Usage;
 }
 export type ModelStreamEvent = {
+    readonly type: "reasoning";
+    readonly text: string;
+} | {
+    readonly type: "retry";
+    readonly attempt: number;
+    readonly message?: string;
+} | {
     readonly type: "text-delta";
     readonly text: string;
 } | {

package/dist/domain/model.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.types.js","sourceRoot":"","sources":["../../src/domain/model.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Usage } from \"./agent.types.ts\";\n\nexport type ModelReasoning =\n  \"none\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\";\n\nexport interface AgentModel {\n  readonly name: string;\n  readonly reasoning?: ModelReasoning;\n  readonly maxOutputTokens?: number;\n}\n\nexport type ModelSpec = string | AgentModel;\n\nexport interface ModelTextBlock {\n  readonly type: \"text\";\n  readonly text: string;\n}\n\nexport interface ModelToolCallBlock {\n  readonly type: \"tool-call\";\n  readonly id: string;\n  readonly name: string;\n  readonly input: unknown;\n}\n\nexport interface ModelToolResultBlock {\n  readonly type: \"tool-result\";\n  readonly callId: string;\n  readonly content: string;\n  readonly isError?: boolean;\n}\n\nexport interface ModelReasoningBlock {\n  readonly type: \"reasoning\";\n  readonly provider: string;\n  readonly model: string;\n  readonly data: unknown;\n}\n\nexport type ModelContentBlock =\n  | ModelTextBlock\n  | ModelToolCallBlock\n  | ModelToolResultBlock\n  | ModelReasoningBlock;\n\nexport interface ModelMessage {\n  readonly role: \"user\" | \"assistant\";\n  readonly content: readonly ModelContentBlock[];\n}\n\nexport interface ModelToolSpec {\n  readonly name: string;\n  readonly description: string;\n  readonly inputSchema: Readonly<Record<string, unknown>>;\n}\n\nexport type ModelStopReason = \"end\" | \"tool-calls\" | \"max-tokens\" | \"refusal\";\n\nexport interface ModelRequest {\n  readonly model: string;\n  readonly prompt?: string;\n  readonly messages?: readonly ModelMessage[];\n  readonly system?: string;\n  readonly tools?: readonly ModelToolSpec[];\n  readonly maxOutputTokens?: number;\n  readonly reasoning?: ModelReasoning;\n  readonly cache?: boolean;\n  readonly signal?: AbortSignal;\n}\n\nexport interface ModelResult {\n  readonly text: string;\n  readonly content?: readonly ModelContentBlock[];\n  readonly stopReason?: ModelStopReason;\n  readonly usage?: Usage;\n}\n\nexport type ModelStreamEvent =\n  | { readonly type: \"text-delta\"; readonly text: string }\n  | { readonly type: \"result\"; readonly result: ModelResult };\n\nexport interface ModelProvider {\n  readonly name: string;\n  readonly identity?: string;\n  validate?(model: AgentModel): void;\n  request(request: ModelRequest): Promise<ModelResult>;\n  stream?(request: ModelRequest): AsyncIterable<ModelStreamEvent>;\n}\n"]}
+{"version":3,"file":"model.types.js","sourceRoot":"","sources":["../../src/domain/model.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Usage } from \"./agent.types.ts\";\n\nexport type ModelReasoning =\n  \"none\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\";\n\nexport interface AgentModel {\n  readonly name: string;\n  readonly reasoning?: ModelReasoning;\n  readonly maxOutputTokens?: number;\n}\n\nexport type ModelSpec = string | AgentModel;\n\nexport interface ModelTextBlock {\n  readonly type: \"text\";\n  readonly text: string;\n}\n\nexport interface ModelToolCallBlock {\n  readonly type: \"tool-call\";\n  readonly id: string;\n  readonly name: string;\n  readonly input: unknown;\n}\n\nexport interface ModelToolResultBlock {\n  readonly type: \"tool-result\";\n  readonly callId: string;\n  readonly content: string;\n  readonly isError?: boolean;\n}\n\nexport interface ModelReasoningBlock {\n  readonly text?: string;\n  readonly type: \"reasoning\";\n  readonly provider: string;\n  readonly model: string;\n  readonly data: unknown;\n}\n\nexport type ModelContentBlock =\n  | ModelTextBlock\n  | ModelToolCallBlock\n  | ModelToolResultBlock\n  | ModelReasoningBlock;\n\nexport interface ModelMessage {\n  readonly role: \"user\" | \"assistant\";\n  readonly content: readonly ModelContentBlock[];\n}\n\nexport interface ModelToolSpec {\n  readonly name: string;\n  readonly description: string;\n  readonly inputSchema: Readonly<Record<string, unknown>>;\n}\n\nexport type ModelStopReason = \"end\" | \"tool-calls\" | \"max-tokens\" | \"refusal\";\n\nexport interface ModelRequest {\n  readonly model: string;\n  readonly prompt?: string;\n  readonly messages?: readonly ModelMessage[];\n  readonly system?: string;\n  readonly tools?: readonly ModelToolSpec[];\n  readonly maxOutputTokens?: number;\n  readonly reasoning?: ModelReasoning;\n  readonly cache?: boolean;\n  readonly signal?: AbortSignal;\n}\n\nexport interface ModelResult {\n  readonly text: string;\n  readonly content?: readonly ModelContentBlock[];\n  readonly stopReason?: ModelStopReason;\n  readonly usage?: Usage;\n}\n\nexport type ModelStreamEvent =\n  | { readonly type: \"reasoning\"; readonly text: string }\n  | {\n      readonly type: \"retry\";\n      readonly attempt: number;\n      readonly message?: string;\n    }\n  | { readonly type: \"text-delta\"; readonly text: string }\n  | { readonly type: \"result\"; readonly result: ModelResult };\n\nexport interface ModelProvider {\n  readonly name: string;\n  readonly identity?: string;\n  validate?(model: AgentModel): void;\n  request(request: ModelRequest): Promise<ModelResult>;\n  stream?(request: ModelRequest): AsyncIterable<ModelStreamEvent>;\n}\n"]}

package/dist/domain/observation.constants.d.ts

@@ -0,0 +1,8 @@
+export declare const observationDefaults: {
+    readonly capacity: 1024;
+    readonly deliveryTimeoutMs: 5000;
+    readonly errorLimit: 100;
+    readonly outputCharacters: 8192;
+    readonly previewCharacters: 2000;
+    readonly toolCallLimit: 1024;
+};

package/dist/domain/observation.constants.js

@@ -0,0 +1,9 @@
+export const observationDefaults = {
+    capacity: 1024,
+    deliveryTimeoutMs: 5000,
+    errorLimit: 100,
+    outputCharacters: 8192,
+    previewCharacters: 2000,
+    toolCallLimit: 1024,
+};
+//# sourceMappingURL=observation.constants.js.map

package/dist/domain/observation.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation.constants.js","sourceRoot":"","sources":["../../src/domain/observation.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,IAAI;IACd,iBAAiB,EAAE,IAAI;IACvB,UAAU,EAAE,GAAG;IACf,gBAAgB,EAAE,IAAI;IACtB,iBAAiB,EAAE,IAAI;IACvB,aAAa,EAAE,IAAI;CACX,CAAC","sourcesContent":["export const observationDefaults = {\n  capacity: 1024,\n  deliveryTimeoutMs: 5000,\n  errorLimit: 100,\n  outputCharacters: 8192,\n  previewCharacters: 2000,\n  toolCallLimit: 1024,\n} as const;\n"]}

package/dist/domain/observation.d.ts

@@ -0,0 +1,2 @@
+import type { ObservationHub, ObservationHubOptions } from "./observation.types.ts";
+export declare function createObservationHub(options?: ObservationHubOptions): ObservationHub;