@elie-laloum/outpost 4.2.0 → 5.0.0

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 { 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: \"result\"; readonly text: string }\n  | { readonly kind: \"prompt\"; readonly text: string }\n  | { readonly kind: \"tool\"; readonly name: string; readonly input: unknown }\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 AgentAdapter {\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  request(input: AgentInput): Command;\n  events(line: string): readonly AgentEvent[];\n}\n\nexport interface RequiredAgent {\n  readonly agent: AgentAdapter;\n}\n"]}
+{"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"]}

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

@@ -0,0 +1,7 @@
+export declare const CONTEXT_DEFAULTS: {
+    readonly keepRecentResults: 4;
+    readonly truncatedCharacters: 2000;
+    readonly triggerCharacters: 400000;
+    readonly keepRecentMessages: 6;
+};
+export declare const SUMMARY_INSTRUCTIONS = "Summarize this earlier part of an agent conversation for the agent that will continue it. Keep the task, decisions, files and commands involved, results, errors and open questions. Be factual and concise.";

package/dist/domain/context.constants.js

@@ -0,0 +1,8 @@
+export const CONTEXT_DEFAULTS = {
+    keepRecentResults: 4,
+    truncatedCharacters: 2_000,
+    triggerCharacters: 400_000,
+    keepRecentMessages: 6,
+};
+export const SUMMARY_INSTRUCTIONS = "Summarize this earlier part of an agent conversation for the agent that will continue it. Keep the task, decisions, files and commands involved, results, errors and open questions. Be factual and concise.";
+//# sourceMappingURL=context.constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.constants.js","sourceRoot":"","sources":["../../src/domain/context.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,iBAAiB,EAAE,CAAC;IACpB,mBAAmB,EAAE,KAAK;IAC1B,iBAAiB,EAAE,OAAO;IAC1B,kBAAkB,EAAE,CAAC;CACb,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAC/B,8MAA8M,CAAC","sourcesContent":["export const CONTEXT_DEFAULTS = {\n  keepRecentResults: 4,\n  truncatedCharacters: 2_000,\n  triggerCharacters: 400_000,\n  keepRecentMessages: 6,\n} as const;\n\nexport const SUMMARY_INSTRUCTIONS =\n  \"Summarize this earlier part of an agent conversation for the agent that will continue it. Keep the task, decisions, files and commands involved, results, errors and open questions. Be factual and concise.\";\n"]}

package/dist/domain/context.d.ts

@@ -0,0 +1,4 @@
+import type { HarnessContextStrategy, HarnessContextStrategyOptions, SummarizeHistoryOptions, TruncateToolResultsOptions } from "./context.types.ts";
+export declare function defineHarnessContextStrategy(options: HarnessContextStrategyOptions): HarnessContextStrategy;
+export declare function truncateToolResults(options?: TruncateToolResultsOptions): HarnessContextStrategy;
+export declare function summarizeHistory(options?: SummarizeHistoryOptions): HarnessContextStrategy;

package/dist/domain/context.js

@@ -0,0 +1,81 @@
+import { CONTEXT_DEFAULTS } from "./context.constants.js";
+import { invariant, positive } from "./errors.js";
+export function defineHarnessContextStrategy(options) {
+    invariant(options !== null &&
+        typeof options === "object" &&
+        typeof options.name === "string" &&
+        options.name.trim() &&
+        typeof options.compact === "function", "Context strategies need a name and a compact function");
+    return Object.freeze({
+        kind: "context",
+        name: options.name,
+        compact: async (input) => options.compact(input),
+    });
+}
+export function truncateToolResults(options = {}) {
+    const keepRecent = positive(options.keepRecent ?? CONTEXT_DEFAULTS.keepRecentResults, "keepRecent");
+    const maxCharacters = positive(options.maxCharacters ?? CONTEXT_DEFAULTS.truncatedCharacters, "maxCharacters");
+    return defineHarnessContextStrategy({
+        name: "truncate-tool-results",
+        compact({ messages }) {
+            const carriers = messages.flatMap((message, index) => message.content.some((block) => block.type === "tool-result")
+                ? [index]
+                : []);
+            const older = new Set(carriers.slice(0, -keepRecent));
+            let changed = false;
+            const compacted = messages.map((message, index) => {
+                if (!older.has(index))
+                    return message;
+                return {
+                    ...message,
+                    content: message.content.map((block) => {
+                        if (block.type !== "tool-result" ||
+                            block.content.length <= maxCharacters)
+                            return block;
+                        changed = true;
+                        return {
+                            ...block,
+                            content: `${block.content.slice(0, maxCharacters)}\n[earlier output truncated from ${block.content.length} characters]`,
+                        };
+                    }),
+                };
+            });
+            return changed ? compacted : undefined;
+        },
+    });
+}
+export function summarizeHistory(options = {}) {
+    const trigger = positive(options.triggerCharacters ?? CONTEXT_DEFAULTS.triggerCharacters, "triggerCharacters");
+    const keep = positive(options.keepRecentMessages ?? CONTEXT_DEFAULTS.keepRecentMessages, "keepRecentMessages");
+    return defineHarnessContextStrategy({
+        name: "summarize-history",
+        async compact({ messages, summarize }) {
+            if (JSON.stringify(messages).length <= trigger)
+                return undefined;
+            const cut = boundary(messages, Math.max(2, messages.length - keep));
+            if (cut === undefined)
+                return undefined;
+            const summary = await summarize(messages.slice(1, cut));
+            return [
+                messages[0],
+                {
+                    role: "user",
+                    content: [
+                        {
+                            type: "text",
+                            text: `Summary of the earlier conversation:\n${summary}`,
+                        },
+                    ],
+                },
+                ...messages.slice(cut),
+            ];
+        },
+    });
+}
+function boundary(messages, from) {
+    for (let index = Math.min(from, messages.length - 1); index > 1; index--)
+        if (messages[index].role === "assistant")
+            return index;
+    return undefined;
+}
+//# sourceMappingURL=context.js.map

package/dist/domain/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/domain/context.ts"],"names":[],"mappings":"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","sourcesContent":["import { CONTEXT_DEFAULTS } from \"./context.constants.ts\";\nimport type {\n  HarnessContextInput,\n  HarnessContextStrategy,\n  HarnessContextStrategyOptions,\n  SummarizeHistoryOptions,\n  TruncateToolResultsOptions,\n} from \"./context.types.ts\";\nimport { invariant, positive } from \"./errors.ts\";\nimport type { ModelMessage } from \"./model.types.ts\";\n\nexport function defineHarnessContextStrategy(\n  options: HarnessContextStrategyOptions,\n): HarnessContextStrategy {\n  invariant(\n    options !== null &&\n      typeof options === \"object\" &&\n      typeof options.name === \"string\" &&\n      options.name.trim() &&\n      typeof options.compact === \"function\",\n    \"Context strategies need a name and a compact function\",\n  );\n  return Object.freeze({\n    kind: \"context\",\n    name: options.name,\n    compact: async (input: HarnessContextInput) => options.compact(input),\n  });\n}\n\nexport function truncateToolResults(\n  options: TruncateToolResultsOptions = {},\n): HarnessContextStrategy {\n  const keepRecent = positive(\n    options.keepRecent ?? CONTEXT_DEFAULTS.keepRecentResults,\n    \"keepRecent\",\n  );\n  const maxCharacters = positive(\n    options.maxCharacters ?? CONTEXT_DEFAULTS.truncatedCharacters,\n    \"maxCharacters\",\n  );\n  return defineHarnessContextStrategy({\n    name: \"truncate-tool-results\",\n    compact({ messages }) {\n      const carriers = messages.flatMap((message, index) =>\n        message.content.some((block) => block.type === \"tool-result\")\n          ? [index]\n          : [],\n      );\n      const older = new Set(carriers.slice(0, -keepRecent));\n      let changed = false;\n      const compacted = messages.map((message, index): ModelMessage => {\n        if (!older.has(index)) return message;\n        return {\n          ...message,\n          content: message.content.map((block) => {\n            if (\n              block.type !== \"tool-result\" ||\n              block.content.length <= maxCharacters\n            )\n              return block;\n            changed = true;\n            return {\n              ...block,\n              content: `${block.content.slice(0, maxCharacters)}\\n[earlier output truncated from ${block.content.length} characters]`,\n            };\n          }),\n        };\n      });\n      return changed ? compacted : undefined;\n    },\n  });\n}\n\nexport function summarizeHistory(\n  options: SummarizeHistoryOptions = {},\n): HarnessContextStrategy {\n  const trigger = positive(\n    options.triggerCharacters ?? CONTEXT_DEFAULTS.triggerCharacters,\n    \"triggerCharacters\",\n  );\n  const keep = positive(\n    options.keepRecentMessages ?? CONTEXT_DEFAULTS.keepRecentMessages,\n    \"keepRecentMessages\",\n  );\n  return defineHarnessContextStrategy({\n    name: \"summarize-history\",\n    async compact({ messages, summarize }) {\n      if (JSON.stringify(messages).length <= trigger) return undefined;\n      const cut = boundary(messages, Math.max(2, messages.length - keep));\n      if (cut === undefined) return undefined;\n      const summary = await summarize(messages.slice(1, cut));\n      return [\n        messages[0]!,\n        {\n          role: \"user\",\n          content: [\n            {\n              type: \"text\",\n              text: `Summary of the earlier conversation:\\n${summary}`,\n            },\n          ],\n        },\n        ...messages.slice(cut),\n      ];\n    },\n  });\n}\n\nfunction boundary(\n  messages: readonly ModelMessage[],\n  from: number,\n): number | undefined {\n  for (let index = Math.min(from, messages.length - 1); index > 1; index--)\n    if (messages[index]!.role === \"assistant\") return index;\n  return undefined;\n}\n"]}

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

@@ -0,0 +1,26 @@
+import type { AgentModel, ModelMessage } from "./model.types.ts";
+export interface HarnessContextInput {
+    readonly messages: readonly ModelMessage[];
+    readonly step: number;
+    readonly model: AgentModel;
+    readonly signal: AbortSignal;
+    summarize(messages: readonly ModelMessage[]): Promise<string>;
+}
+export type HarnessContextResult = readonly ModelMessage[] | undefined;
+export interface HarnessContextStrategyOptions {
+    readonly name: string;
+    compact(input: HarnessContextInput): HarnessContextResult | Promise<HarnessContextResult>;
+}
+export interface HarnessContextStrategy {
+    readonly kind: "context";
+    readonly name: string;
+    compact(input: HarnessContextInput): Promise<HarnessContextResult>;
+}
+export interface TruncateToolResultsOptions {
+    readonly keepRecent?: number;
+    readonly maxCharacters?: number;
+}
+export interface SummarizeHistoryOptions {
+    readonly triggerCharacters?: number;
+    readonly keepRecentMessages?: number;
+}

package/dist/domain/context.types.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.types.js","sourceRoot":"","sources":["../../src/domain/context.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { AgentModel, ModelMessage } from \"./model.types.ts\";\n\nexport interface HarnessContextInput {\n  readonly messages: readonly ModelMessage[];\n  readonly step: number;\n  readonly model: AgentModel;\n  readonly signal: AbortSignal;\n  summarize(messages: readonly ModelMessage[]): Promise<string>;\n}\n\nexport type HarnessContextResult = readonly ModelMessage[] | undefined;\n\nexport interface HarnessContextStrategyOptions {\n  readonly name: string;\n  compact(\n    input: HarnessContextInput,\n  ): HarnessContextResult | Promise<HarnessContextResult>;\n}\n\nexport interface HarnessContextStrategy {\n  readonly kind: \"context\";\n  readonly name: string;\n  compact(input: HarnessContextInput): Promise<HarnessContextResult>;\n}\n\nexport interface TruncateToolResultsOptions {\n  readonly keepRecent?: number;\n  readonly maxCharacters?: number;\n}\n\nexport interface SummarizeHistoryOptions {\n  readonly triggerCharacters?: number;\n  readonly keepRecentMessages?: number;\n}\n"]}

package/dist/domain/dispatch-telemetry.types.d.ts

@@ -0,0 +1,12 @@
+import type { Usage } from "./agent.types.ts";
+export interface DispatchTelemetryOutcome {
+    readonly status: "done" | "failed" | "cancelled";
+    readonly usage: Usage;
+    readonly completed?: boolean;
+}
+export interface DispatchTelemetrySession {
+    finish(outcome: DispatchTelemetryOutcome): void;
+}
+export interface DispatchTelemetry {
+    startDispatch(): DispatchTelemetrySession;
+}

package/dist/domain/dispatch-telemetry.types.js

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

package/dist/domain/dispatch-telemetry.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-telemetry.types.js","sourceRoot":"","sources":["../../src/domain/dispatch-telemetry.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Usage } from \"./agent.types.ts\";\n\nexport interface DispatchTelemetryOutcome {\n  readonly status: \"done\" | \"failed\" | \"cancelled\";\n  readonly usage: Usage;\n  readonly completed?: boolean;\n}\n\nexport interface DispatchTelemetrySession {\n  finish(outcome: DispatchTelemetryOutcome): void;\n}\n\nexport interface DispatchTelemetry {\n  startDispatch(): DispatchTelemetrySession;\n}\n"]}

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

@@ -1 +1 @@
-export type FaultCode = "configuration" | "process" | "timeout" | "aborted" | "workspace" | "conflict" | "prompt" | "response" | "session" | "provider";
+export type FaultCode = "configuration" | "process" | "timeout" | "aborted" | "workspace" | "conflict" | "prompt" | "response" | "session" | "provider" | "limit";

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

@@ -1 +1 @@
-{"version":3,"file":"errors.types.js","sourceRoot":"","sources":["../../src/domain/errors.types.ts"],"names":[],"mappings":"","sourcesContent":["export type FaultCode =\n  | \"configuration\"\n  | \"process\"\n  | \"timeout\"\n  | \"aborted\"\n  | \"workspace\"\n  | \"conflict\"\n  | \"prompt\"\n  | \"response\"\n  | \"session\"\n  | \"provider\";\n"]}
+{"version":3,"file":"errors.types.js","sourceRoot":"","sources":["../../src/domain/errors.types.ts"],"names":[],"mappings":"","sourcesContent":["export type FaultCode =\n  | \"configuration\"\n  | \"process\"\n  | \"timeout\"\n  | \"aborted\"\n  | \"workspace\"\n  | \"conflict\"\n  | \"prompt\"\n  | \"response\"\n  | \"session\"\n  | \"provider\"\n  | \"limit\";\n"]}

package/dist/domain/glob.d.ts

@@ -0,0 +1,2 @@
+import type { GlobMode } from "./glob.types.ts";
+export declare function glob(pattern: string, mode: GlobMode): RegExp;

package/dist/domain/glob.js

@@ -0,0 +1,25 @@
+const stars = {
+    path: "[^/]*",
+    text: "[^]*",
+};
+const tokens = {
+    "*": (mode) => stars[mode],
+    "?": () => "[^/]",
+};
+export function glob(pattern, mode) {
+    let source = "";
+    for (let index = 0; index < pattern.length; index++) {
+        const character = pattern[index];
+        if (character === "*" && pattern[index + 1] === "*") {
+            const directory = pattern[index + 2] === "/";
+            source += directory ? "(?:[^]*/)?" : "[^]*";
+            index += directory ? 2 : 1;
+            continue;
+        }
+        source +=
+            tokens[character]?.(mode) ??
+                character.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+    }
+    return new RegExp(`^${source}$`);
+}
+//# sourceMappingURL=glob.js.map

package/dist/domain/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../src/domain/glob.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK,GAAuC;IAChD,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,MAAM,GAAyD;IACnE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;IAC1B,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM;CAClB,CAAC;AAEF,MAAM,UAAU,IAAI,CAAC,OAAe,EAAE,IAAc;IAClD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAE,CAAC;QAClC,IAAI,SAAS,KAAK,GAAG,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACpD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC;YAC7C,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;YAC5C,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,MAAM;YACJ,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC;gBACzB,SAAS,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;AACnC,CAAC","sourcesContent":["import type { GlobMode } from \"./glob.types.ts\";\n\nconst stars: Readonly<Record<GlobMode, string>> = {\n  path: \"[^/]*\",\n  text: \"[^]*\",\n};\n\nconst tokens: Readonly<Record<string, (mode: GlobMode) => string>> = {\n  \"*\": (mode) => stars[mode],\n  \"?\": () => \"[^/]\",\n};\n\nexport function glob(pattern: string, mode: GlobMode): RegExp {\n  let source = \"\";\n  for (let index = 0; index < pattern.length; index++) {\n    const character = pattern[index]!;\n    if (character === \"*\" && pattern[index + 1] === \"*\") {\n      const directory = pattern[index + 2] === \"/\";\n      source += directory ? \"(?:[^]*/)?\" : \"[^]*\";\n      index += directory ? 2 : 1;\n      continue;\n    }\n    source +=\n      tokens[character]?.(mode) ??\n      character.replace(/[.+^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  }\n  return new RegExp(`^${source}$`);\n}\n"]}

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

@@ -0,0 +1 @@
+export type GlobMode = "path" | "text";

package/dist/domain/glob.types.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"glob.types.js","sourceRoot":"","sources":["../../src/domain/glob.types.ts"],"names":[],"mappings":"","sourcesContent":["export type GlobMode = \"path\" | \"text\";\n"]}

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

@@ -0,0 +1,11 @@
+export declare const HARNESS_DEFAULTS: {
+    readonly maxSteps: 100;
+    readonly concurrency: 4;
+    readonly toolDeadlineMs: 300000;
+    readonly onError: "return-to-model";
+    readonly cache: true;
+};
+export declare const HARNESS_FIELDS: ReadonlySet<string>;
+export declare const TOOL_RESULT_CHARACTERS = 100000;
+export declare const TOOL_PREVIEW_CHARACTERS = 2000;
+export declare const USAGE_FIELDS: string[];

package/dist/domain/harness.constants.js

@@ -0,0 +1,24 @@
+export const HARNESS_DEFAULTS = {
+    maxSteps: 100,
+    concurrency: 4,
+    toolDeadlineMs: 300_000,
+    onError: "return-to-model",
+    cache: true,
+};
+export const HARNESS_FIELDS = new Set([
+    "modelProvider",
+    "instructions",
+    "tools",
+    "limits",
+    "toolExecution",
+    "hooks",
+    "permissions",
+    "context",
+    "conversations",
+    "skills",
+    "cache",
+]);
+export const TOOL_RESULT_CHARACTERS = 100_000;
+export const TOOL_PREVIEW_CHARACTERS = 2_000;
+export const USAGE_FIELDS = ["input", "cached", "cacheCreated", "output"];
+//# sourceMappingURL=harness.constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harness.constants.js","sourceRoot":"","sources":["../../src/domain/harness.constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE,GAAG;IACb,WAAW,EAAE,CAAC;IACd,cAAc,EAAE,OAAO;IACvB,OAAO,EAAE,iBAAiB;IAC1B,KAAK,EAAE,IAAI;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IACzD,eAAe;IACf,cAAc;IACd,OAAO;IACP,QAAQ;IACR,eAAe;IACf,OAAO;IACP,aAAa;IACb,SAAS;IACT,eAAe;IACf,QAAQ;IACR,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAE9C,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAE7C,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC","sourcesContent":["export const HARNESS_DEFAULTS = {\n  maxSteps: 100,\n  concurrency: 4,\n  toolDeadlineMs: 300_000,\n  onError: \"return-to-model\",\n  cache: true,\n} as const;\n\nexport const HARNESS_FIELDS: ReadonlySet<string> = new Set([\n  \"modelProvider\",\n  \"instructions\",\n  \"tools\",\n  \"limits\",\n  \"toolExecution\",\n  \"hooks\",\n  \"permissions\",\n  \"context\",\n  \"conversations\",\n  \"skills\",\n  \"cache\",\n]);\n\nexport const TOOL_RESULT_CHARACTERS = 100_000;\n\nexport const TOOL_PREVIEW_CHARACTERS = 2_000;\n\nexport const USAGE_FIELDS = [\"input\", \"cached\", \"cacheCreated\", \"output\"];\n"]}

package/dist/domain/harness.d.ts

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

package/dist/domain/harness.js

@@ -0,0 +1,89 @@
+import { invariant, positive } from "./errors.js";
+import { HARNESS_DEFAULTS, HARNESS_FIELDS, USAGE_FIELDS, } from "./harness.constants.js";
+import { harnessHooks } from "./hook.js";
+import { defineHarnessInstructions, harnessInstructions, } from "./instructions.js";
+import { harnessSkills, skillCatalog, skillLoader } from "./skill.js";
+import { harnessTools } from "./tool.js";
+export function harness(options) {
+    invariant(options !== null && typeof options === "object", "Harness options must be an object");
+    invariant(!("run" in options), "harness() no longer accepts run; declare tools, instructions and limits");
+    const unsupported = Object.keys(options).filter((key) => !HARNESS_FIELDS.has(key));
+    invariant(unsupported.length === 0, `Unsupported harness option: ${unsupported.join(", ")}`);
+    invariant(typeof options.modelProvider?.request === "function", "Custom harness requires a model provider");
+    invariant(options.modelProvider.validate === undefined ||
+        typeof options.modelProvider.validate === "function", "Model provider validate must be a function");
+    invariant(options.cache === undefined || typeof options.cache === "boolean", "Harness cache must be boolean");
+    invariant(options.permissions === undefined ||
+        options.permissions?.kind === "permissions", "Declare permissions with defineHarnessPermissions");
+    invariant(options.context === undefined || options.context?.kind === "context", "Declare context strategies with defineHarnessContextStrategy");
+    invariant(options.conversations === undefined ||
+        options.conversations === false ||
+        conversationStore(options.conversations), "Harness conversations must be a conversation store or false");
+    const skills = harnessSkills(options.skills);
+    return Object.freeze({
+        kind: "custom",
+        modelProvider: options.modelProvider,
+        instructions: Object.freeze([
+            ...harnessInstructions(options.instructions),
+            ...(skills.length
+                ? [defineHarnessInstructions(skillCatalog(skills))]
+                : []),
+        ]),
+        tools: harnessTools([
+            ...(options.tools ?? []),
+            ...skills.flatMap((skill) => skill.tools),
+            ...(skills.length ? [skillLoader(skills)] : []),
+        ]),
+        skills,
+        limits: limits(options.limits ?? {}),
+        toolExecution: toolExecution(options.toolExecution ?? {}),
+        hooks: harnessHooks(options.hooks),
+        ...(options.permissions ? { permissions: options.permissions } : {}),
+        ...(options.context ? { context: options.context } : {}),
+        ...(options.conversations === undefined
+            ? {}
+            : { conversations: options.conversations }),
+        cache: options.cache ?? HARNESS_DEFAULTS.cache,
+    });
+}
+function limits(value) {
+    invariant(value !== null && typeof value === "object", "Harness limits must be an object");
+    const maxSteps = positive(value.maxSteps ?? HARNESS_DEFAULTS.maxSteps, "Harness maxSteps");
+    if (value.maxToolCalls !== undefined)
+        positive(value.maxToolCalls, "Harness maxToolCalls");
+    if (value.usage !== undefined) {
+        invariant(value.usage !== null &&
+            typeof value.usage === "object" &&
+            Object.keys(value.usage).every((key) => USAGE_FIELDS.includes(key)), "Harness usage limits accept input, cached, cacheCreated and output");
+        for (const limit of Object.values(value.usage))
+            invariant(Number.isSafeInteger(limit) && limit >= 0, "Harness usage limits must be nonnegative integers");
+    }
+    return Object.freeze({
+        maxSteps,
+        ...(value.maxToolCalls === undefined
+            ? {}
+            : { maxToolCalls: value.maxToolCalls }),
+        ...(value.usage === undefined
+            ? {}
+            : { usage: Object.freeze({ ...value.usage }) }),
+    });
+}
+function toolExecution(value) {
+    invariant(value !== null && typeof value === "object", "Harness toolExecution must be an object");
+    invariant(value.onError === undefined ||
+        value.onError === "return-to-model" ||
+        value.onError === "fail", 'Tool onError must be "return-to-model" or "fail"');
+    return Object.freeze({
+        concurrency: positive(value.concurrency ?? HARNESS_DEFAULTS.concurrency, "Tool concurrency"),
+        deadlineMs: positive(value.deadlineMs ?? HARNESS_DEFAULTS.toolDeadlineMs, "Tool deadlineMs"),
+        onError: value.onError ?? HARNESS_DEFAULTS.onError,
+    });
+}
+function conversationStore(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        typeof value.locate === "function" &&
+        typeof value.capture === "function" &&
+        typeof value.restore === "function");
+}
+//# sourceMappingURL=harness.js.map

package/dist/domain/harness.js.map

@@ -0,0 +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"]}

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

@@ -0,0 +1,60 @@
+import type { Usage } from "./agent.types.ts";
+import type { HarnessContextStrategy } from "./context.types.ts";
+import type { ConversationStore } from "./conversation.types.ts";
+import type { HarnessHook } from "./hook.types.ts";
+import type { AgentModel, ModelProvider } from "./model.types.ts";
+import type { HarnessPermissions } from "./permissions.types.ts";
+import type { HarnessSkill } from "./skill.types.ts";
+import type { SandboxLease } from "./sandbox.types.ts";
+import type { HarnessTool, HarnessToolset } from "./tool.types.ts";
+export interface HarnessInstructionContext {
+    readonly sandbox: SandboxLease;
+    readonly signal: AbortSignal;
+    readonly model: AgentModel;
+}
+export type HarnessInstructionSource = string | ((context: HarnessInstructionContext) => string | Promise<string>);
+export interface HarnessInstructions {
+    readonly kind: "instructions";
+    resolve(context: HarnessInstructionContext): Promise<string>;
+}
+export type HarnessInstructionsOption = string | HarnessInstructions | readonly (string | HarnessInstructions)[];
+export interface HarnessLimits {
+    readonly maxSteps?: number;
+    readonly maxToolCalls?: number;
+    readonly usage?: Partial<Usage>;
+}
+export interface ResolvedHarnessLimits extends HarnessLimits {
+    readonly maxSteps: number;
+}
+export interface HarnessToolExecution {
+    readonly concurrency?: number;
+    readonly deadlineMs?: number;
+    readonly onError?: "return-to-model" | "fail";
+}
+export interface CustomHarnessOptions {
+    readonly modelProvider: ModelProvider;
+    readonly instructions?: HarnessInstructionsOption;
+    readonly tools?: readonly (HarnessTool | HarnessToolset)[];
+    readonly limits?: HarnessLimits;
+    readonly toolExecution?: HarnessToolExecution;
+    readonly hooks?: readonly HarnessHook[];
+    readonly permissions?: HarnessPermissions;
+    readonly context?: HarnessContextStrategy;
+    readonly conversations?: ConversationStore | false;
+    readonly skills?: readonly HarnessSkill[];
+    readonly cache?: boolean;
+}
+export interface CustomHarness {
+    readonly kind: "custom";
+    readonly modelProvider: ModelProvider;
+    readonly instructions: readonly HarnessInstructions[];
+    readonly tools: readonly HarnessTool[];
+    readonly limits: ResolvedHarnessLimits;
+    readonly toolExecution: Required<HarnessToolExecution>;
+    readonly hooks: readonly HarnessHook[];
+    readonly permissions?: HarnessPermissions;
+    readonly context?: HarnessContextStrategy;
+    readonly conversations?: ConversationStore | false;
+    readonly skills: readonly HarnessSkill[];
+    readonly cache: boolean;
+}

package/dist/domain/harness.types.js

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

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,3 @@
+import type { HarnessHookPhase } from "./hook.types.ts";
+export declare const HOOK_PHASES: ReadonlySet<HarnessHookPhase>;
+export declare const HOOK_FIELDS: ReadonlySet<string>;

package/dist/domain/hook.constants.js

@@ -0,0 +1,10 @@
+export const HOOK_PHASES = new Set([
+    "session-start",
+    "before-model",
+    "after-model",
+    "before-tool",
+    "after-tool",
+    "stop",
+]);
+export const HOOK_FIELDS = new Set(["on", "name", "run"]);
+//# sourceMappingURL=hook.constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hook.constants.js","sourceRoot":"","sources":["../../src/domain/hook.constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAkC,IAAI,GAAG,CAAC;IAChE,eAAe;IACf,cAAc;IACd,aAAa;IACb,aAAa;IACb,YAAY;IACZ,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAwB,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC","sourcesContent":["import type { HarnessHookPhase } from \"./hook.types.ts\";\n\nexport const HOOK_PHASES: ReadonlySet<HarnessHookPhase> = new Set([\n  \"session-start\",\n  \"before-model\",\n  \"after-model\",\n  \"before-tool\",\n  \"after-tool\",\n  \"stop\",\n]);\n\nexport const HOOK_FIELDS: ReadonlySet<string> = new Set([\"on\", \"name\", \"run\"]);\n"]}

package/dist/domain/hook.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessHook, HarnessHookOptions, HarnessHookPhase } from "./hook.types.ts";
+export declare function defineHarnessHook<Phase extends HarnessHookPhase>(options: HarnessHookOptions<Phase>): HarnessHook<Phase>;
+export declare function harnessHooks(hooks: readonly HarnessHook[] | undefined): readonly HarnessHook[];

package/dist/domain/hook.js

@@ -0,0 +1,25 @@
+import { invariant } from "./errors.js";
+import { HOOK_FIELDS, HOOK_PHASES } from "./hook.constants.js";
+export function defineHarnessHook(options) {
+    invariant(options !== null && typeof options === "object", "Hook options must be an object");
+    invariant(Object.keys(options).every((key) => HOOK_FIELDS.has(key)), "Unsupported hook option");
+    invariant(HOOK_PHASES.has(options.on), `Hook phase must be one of ${[...HOOK_PHASES].join(", ")}`);
+    invariant(typeof options.run === "function", "Hook run must be a function");
+    invariant(options.name === undefined ||
+        (typeof options.name === "string" && options.name.trim()), "Hook name must be nonempty text");
+    return Object.freeze({
+        kind: "hook",
+        on: options.on,
+        name: options.name ?? options.on,
+        run: (input) => options.run(input),
+    });
+}
+export function harnessHooks(hooks) {
+    if (hooks === undefined)
+        return [];
+    invariant(Array.isArray(hooks), "Hooks must be an array");
+    for (const hook of hooks)
+        invariant(hook?.kind === "hook", "Declare hooks with defineHarnessHook");
+    return Object.freeze([...hooks]);
+}
+//# sourceMappingURL=hook.js.map

package/dist/domain/hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.js","sourceRoot":"","sources":["../../src/domain/hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAQ/D,MAAM,UAAU,iBAAiB,CAC/B,OAAkC;IAElC,SAAS,CACP,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAC/C,gCAAgC,CACjC,CAAC;IACF,SAAS,CACP,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EACzD,yBAAyB,CAC1B,CAAC;IACF,SAAS,CACP,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAC3B,6BAA6B,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3D,CAAC;IACF,SAAS,CAAC,OAAO,OAAO,CAAC,GAAG,KAAK,UAAU,EAAE,6BAA6B,CAAC,CAAC;IAC5E,SAAS,CACP,OAAO,CAAC,IAAI,KAAK,SAAS;QACxB,CAAC,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAC3D,iCAAiC,CAClC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM;QACZ,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE;QAChC,GAAG,EAAE,CAAC,KAA8B,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;KAC5D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,KAAyC;IAEzC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,wBAAwB,CAAC,CAAC;IAC1D,KAAK,MAAM,IAAI,IAAI,KAAK;QACtB,SAAS,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,EAAE,sCAAsC,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;AACnC,CAAC","sourcesContent":["import { invariant } from \"./errors.ts\";\nimport { HOOK_FIELDS, HOOK_PHASES } from \"./hook.constants.ts\";\nimport type {\n  HarnessHook,\n  HarnessHookInput,\n  HarnessHookOptions,\n  HarnessHookPhase,\n} from \"./hook.types.ts\";\n\nexport function defineHarnessHook<Phase extends HarnessHookPhase>(\n  options: HarnessHookOptions<Phase>,\n): HarnessHook<Phase> {\n  invariant(\n    options !== null && typeof options === \"object\",\n    \"Hook options must be an object\",\n  );\n  invariant(\n    Object.keys(options).every((key) => HOOK_FIELDS.has(key)),\n    \"Unsupported hook option\",\n  );\n  invariant(\n    HOOK_PHASES.has(options.on),\n    `Hook phase must be one of ${[...HOOK_PHASES].join(\", \")}`,\n  );\n  invariant(typeof options.run === \"function\", \"Hook run must be a function\");\n  invariant(\n    options.name === undefined ||\n      (typeof options.name === \"string\" && options.name.trim()),\n    \"Hook name must be nonempty text\",\n  );\n  return Object.freeze({\n    kind: \"hook\",\n    on: options.on,\n    name: options.name ?? options.on,\n    run: (input: HarnessHookInput<Phase>) => options.run(input),\n  });\n}\n\nexport function harnessHooks(\n  hooks: readonly HarnessHook[] | undefined,\n): readonly HarnessHook[] {\n  if (hooks === undefined) return [];\n  invariant(Array.isArray(hooks), \"Hooks must be an array\");\n  for (const hook of hooks)\n    invariant(hook?.kind === \"hook\", \"Declare hooks with defineHarnessHook\");\n  return Object.freeze([...hooks]);\n}\n"]}