@elie-laloum/outpost 4.1.0 → 5.0.0

package/dist/adapters/models/openai-responses.js

@@ -0,0 +1,107 @@
+import { replayable, requestMessages } from "../../domain/model-messages.js";
+import { modelResult, object, requireResponse, stopReason, toolInput, } from "./model-response.js";
+import { openaiUsage, toolArguments } from "./openai-usage.js";
+import { RESPONSES_INCOMPLETE_REASONS } from "./stop-reasons.constants.js";
+export function responsesBody(request, context) {
+    const items = requestMessages(request).flatMap((message) => responseItems(message, context));
+    return {
+        model: context.model,
+        input: request.messages === undefined ? request.prompt : items,
+        ...(request.system === undefined ? {} : { instructions: request.system }),
+        ...(request.tools?.length
+            ? {
+                tools: request.tools.map((tool) => ({
+                    type: "function",
+                    name: tool.name,
+                    description: tool.description,
+                    parameters: tool.inputSchema,
+                })),
+            }
+            : {}),
+        stream: false,
+        store: false,
+        ...(request.maxOutputTokens === undefined
+            ? {}
+            : { max_output_tokens: request.maxOutputTokens }),
+        ...(request.reasoning === undefined
+            ? {}
+            : { reasoning: { effort: request.reasoning } }),
+    };
+}
+export function readModelResponse(value, context = { identity: "openai", model: "" }) {
+    const data = object(value);
+    requireResponse(data.error == null && Array.isArray(data.output));
+    const incomplete = data.status === "incomplete";
+    requireResponse(incomplete || data.status === "completed");
+    let refused = false;
+    const content = data.output.flatMap((value) => {
+        const item = object(value);
+        if (item.type === "reasoning")
+            return [
+                {
+                    type: "reasoning",
+                    provider: context.identity,
+                    model: context.model,
+                    data: item,
+                },
+            ];
+        if (item.type === "function_call")
+            return [functionCall(item)];
+        requireResponse(item.type === "message" && item.role === "assistant");
+        requireResponse(item.status === "completed" || incomplete);
+        requireResponse(Array.isArray(item.content));
+        return item.content.flatMap((value) => {
+            const part = object(value);
+            if (part.type === "refusal") {
+                requireResponse(typeof part.refusal === "string");
+                refused = true;
+                return [];
+            }
+            requireResponse(part.type === "output_text" && typeof part.text === "string");
+            return [{ type: "text", text: part.text }];
+        });
+    });
+    const reason = refused ? "refusal" : completion(data, incomplete);
+    return modelResult(content, reason, openaiUsage(data.usage, "input_tokens", "output_tokens", "input_tokens_details"));
+}
+function completion(data, incomplete) {
+    if (!incomplete)
+        return "end";
+    return stopReason(RESPONSES_INCOMPLETE_REASONS, object(data.incomplete_details).reason);
+}
+function functionCall(item) {
+    requireResponse(typeof item.call_id === "string" &&
+        typeof item.name === "string" &&
+        typeof item.arguments === "string");
+    return {
+        type: "tool-call",
+        id: item.call_id,
+        name: item.name,
+        input: toolInput(item.arguments),
+    };
+}
+function responseItems(message, context) {
+    return message.content
+        .filter((block) => replayable(block, context.identity, context.model))
+        .toSorted((left, right) => order(message, left) - order(message, right))
+        .map((block) => itemEncoders[block.type](block, message.role));
+}
+function order(message, block) {
+    return message.role === "user" && block.type !== "tool-result" ? 1 : 0;
+}
+const itemEncoders = {
+    text: (block, role) => ({ role, content: block.text }),
+    "tool-call": (block) => ({
+        type: "function_call",
+        call_id: block.id,
+        name: block.name,
+        arguments: toolArguments(block.input),
+    }),
+    "tool-result": (block) => ({
+        type: "function_call_output",
+        call_id: block.callId,
+        output: block.content,
+    }),
+    reasoning: (block) => block.data,
+};
+//# sourceMappingURL=openai-responses.js.map

package/dist/adapters/models/openai-responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-responses.js","sourceRoot":"","sources":["../../../src/adapters/models/openai-responses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAS7E,OAAO,EACL,WAAW,EACX,MAAM,EACN,eAAe,EACf,UAAU,EACV,SAAS,GACV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAE3E,MAAM,UAAU,aAAa,CAC3B,OAAqB,EACrB,OAAwB;IAExB,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CACzD,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAChC,CAAC;IACF,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK;QAC9D,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACzE,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM;YACvB,CAAC,CAAC;gBACE,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBAClC,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,UAAU,EAAE,IAAI,CAAC,WAAW;iBAC7B,CAAC,CAAC;aACJ;YACH,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,KAAK;QACZ,GAAG,CAAC,OAAO,CAAC,eAAe,KAAK,SAAS;YACvC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;QACnD,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;YACjC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAc,EACd,UAA2B,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;IAE5D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,eAAe,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,KAAK,YAAY,CAAC;IAChD,eAAe,CAAC,UAAU,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;IAC3D,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAuB,EAAE;QACjE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YAC3B,OAAO;gBACL;oBACE,IAAI,EAAE,WAAW;oBACjB,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,IAAI,EAAE,IAAI;iBACX;aACF,CAAC;QACJ,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe;YAAE,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/D,eAAe,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QACtE,eAAe,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,UAAU,CAAC,CAAC;QAC3D,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAuB,EAAE;YACzD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC5B,eAAe,CAAC,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC;gBAClD,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,eAAe,CACb,IAAI,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAC7D,CAAC;YACF,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAClE,OAAO,WAAW,CAChB,OAAO,EACP,MAAM,EACN,WAAW,CACT,IAAI,CAAC,KAAK,EACV,cAAc,EACd,eAAe,EACf,sBAAsB,CACvB,CACF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,IAA6B,EAC7B,UAAmB;IAEnB,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,UAAU,CACf,4BAA4B,EAC5B,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,MAAM,CACvC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAA6B;IACjD,eAAe,CACb,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;QAC9B,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;QAC7B,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CACrC,CAAC;IACF,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,EAAE,EAAE,IAAI,CAAC,OAAO;QAChB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,OAAqB,EAAE,OAAwB;IACpE,OAAO,OAAO,CAAC,OAAO;SACnB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;SACrE,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;SACvE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAc,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,KAAK,CAAC,OAAqB,EAAE,KAAwB;IAC5D,OAAO,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,YAAY,GAAgD;IAChE,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACtD,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACvB,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,KAAK,CAAC,EAAE;QACjB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC;KACtC,CAAC;IACF,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACzB,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,KAAK,CAAC,MAAM;QACrB,MAAM,EAAE,KAAK,CAAC,OAAO;KACtB,CAAC;IACF,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI;CACjC,CAAC","sourcesContent":["import { replayable, requestMessages } from \"../../domain/model-messages.ts\";\nimport type {\n  ModelContentBlock,\n  ModelMessage,\n  ModelRequest,\n  ModelResult,\n  ModelStopReason,\n} from \"../../domain/model.types.ts\";\nimport type { BlockEncoders, ProtocolContext } from \"./model-protocol.types.ts\";\nimport {\n  modelResult,\n  object,\n  requireResponse,\n  stopReason,\n  toolInput,\n} from \"./model-response.ts\";\nimport { openaiUsage, toolArguments } from \"./openai-usage.ts\";\nimport { RESPONSES_INCOMPLETE_REASONS } from \"./stop-reasons.constants.ts\";\n\nexport function responsesBody(\n  request: ModelRequest,\n  context: ProtocolContext,\n): Record<string, unknown> {\n  const items = requestMessages(request).flatMap((message) =>\n    responseItems(message, context),\n  );\n  return {\n    model: context.model,\n    input: request.messages === undefined ? request.prompt : items,\n    ...(request.system === undefined ? {} : { instructions: request.system }),\n    ...(request.tools?.length\n      ? {\n          tools: request.tools.map((tool) => ({\n            type: \"function\",\n            name: tool.name,\n            description: tool.description,\n            parameters: tool.inputSchema,\n          })),\n        }\n      : {}),\n    stream: false,\n    store: false,\n    ...(request.maxOutputTokens === undefined\n      ? {}\n      : { max_output_tokens: request.maxOutputTokens }),\n    ...(request.reasoning === undefined\n      ? {}\n      : { reasoning: { effort: request.reasoning } }),\n  };\n}\n\nexport function readModelResponse(\n  value: unknown,\n  context: ProtocolContext = { identity: \"openai\", model: \"\" },\n): ModelResult {\n  const data = object(value);\n  requireResponse(data.error == null && Array.isArray(data.output));\n  const incomplete = data.status === \"incomplete\";\n  requireResponse(incomplete || data.status === \"completed\");\n  let refused = false;\n  const content = data.output.flatMap((value): ModelContentBlock[] => {\n    const item = object(value);\n    if (item.type === \"reasoning\")\n      return [\n        {\n          type: \"reasoning\",\n          provider: context.identity,\n          model: context.model,\n          data: item,\n        },\n      ];\n    if (item.type === \"function_call\") return [functionCall(item)];\n    requireResponse(item.type === \"message\" && item.role === \"assistant\");\n    requireResponse(item.status === \"completed\" || incomplete);\n    requireResponse(Array.isArray(item.content));\n    return item.content.flatMap((value): ModelContentBlock[] => {\n      const part = object(value);\n      if (part.type === \"refusal\") {\n        requireResponse(typeof part.refusal === \"string\");\n        refused = true;\n        return [];\n      }\n      requireResponse(\n        part.type === \"output_text\" && typeof part.text === \"string\",\n      );\n      return [{ type: \"text\", text: part.text }];\n    });\n  });\n  const reason = refused ? \"refusal\" : completion(data, incomplete);\n  return modelResult(\n    content,\n    reason,\n    openaiUsage(\n      data.usage,\n      \"input_tokens\",\n      \"output_tokens\",\n      \"input_tokens_details\",\n    ),\n  );\n}\n\nfunction completion(\n  data: Record<string, unknown>,\n  incomplete: boolean,\n): ModelStopReason {\n  if (!incomplete) return \"end\";\n  return stopReason(\n    RESPONSES_INCOMPLETE_REASONS,\n    object(data.incomplete_details).reason,\n  );\n}\n\nfunction functionCall(item: Record<string, unknown>): ModelContentBlock {\n  requireResponse(\n    typeof item.call_id === \"string\" &&\n      typeof item.name === \"string\" &&\n      typeof item.arguments === \"string\",\n  );\n  return {\n    type: \"tool-call\",\n    id: item.call_id,\n    name: item.name,\n    input: toolInput(item.arguments),\n  };\n}\n\nfunction responseItems(message: ModelMessage, context: ProtocolContext) {\n  return message.content\n    .filter((block) => replayable(block, context.identity, context.model))\n    .toSorted((left, right) => order(message, left) - order(message, right))\n    .map((block) => itemEncoders[block.type](block as never, message.role));\n}\n\nfunction order(message: ModelMessage, block: ModelContentBlock): number {\n  return message.role === \"user\" && block.type !== \"tool-result\" ? 1 : 0;\n}\n\nconst itemEncoders: BlockEncoders<[role: ModelMessage[\"role\"]]> = {\n  text: (block, role) => ({ role, content: block.text }),\n  \"tool-call\": (block) => ({\n    type: \"function_call\",\n    call_id: block.id,\n    name: block.name,\n    arguments: toolArguments(block.input),\n  }),\n  \"tool-result\": (block) => ({\n    type: \"function_call_output\",\n    call_id: block.callId,\n    output: block.content,\n  }),\n  reasoning: (block) => block.data,\n};\n"]}

package/dist/adapters/models/openai-usage.d.ts

@@ -0,0 +1,3 @@
+import type { Usage } from "../../domain/agent.types.ts";
+export declare function openaiUsage(value: unknown, input: string, output: string, details: string): Usage | undefined;
+export declare function toolArguments(input: unknown): string;

package/dist/adapters/models/openai-usage.js

@@ -0,0 +1,20 @@
+import { object, requireResponse, tokens } from "./model-response.js";
+export function openaiUsage(value, input, output, details) {
+    if (value === undefined || value === null)
+        return undefined;
+    const data = object(value);
+    const cached = data[details] == null
+        ? 0
+        : tokens(object(data[details]).cached_tokens ?? 0);
+    const result = {
+        input: tokens(data[input]),
+        output: tokens(data[output]),
+        cached,
+    };
+    requireResponse(cached <= result.input);
+    return result;
+}
+export function toolArguments(input) {
+    return typeof input === "string" ? input : JSON.stringify(input);
+}
+//# sourceMappingURL=openai-usage.js.map

package/dist/adapters/models/openai-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-usage.js","sourceRoot":"","sources":["../../../src/adapters/models/openai-usage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAEtE,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,KAAa,EACb,MAAc,EACd,OAAe;IAEf,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,MAAM,MAAM,GACV,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI;QACnB,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM;KACP,CAAC;IACF,eAAe,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC","sourcesContent":["import type { Usage } from \"../../domain/agent.types.ts\";\nimport { object, requireResponse, tokens } from \"./model-response.ts\";\n\nexport function openaiUsage(\n  value: unknown,\n  input: string,\n  output: string,\n  details: string,\n): Usage | undefined {\n  if (value === undefined || value === null) return undefined;\n  const data = object(value);\n  const cached =\n    data[details] == null\n      ? 0\n      : tokens(object(data[details]).cached_tokens ?? 0);\n  const result = {\n    input: tokens(data[input]),\n    output: tokens(data[output]),\n    cached,\n  };\n  requireResponse(cached <= result.input);\n  return result;\n}\n\nexport function toolArguments(input: unknown): string {\n  return typeof input === \"string\" ? input : JSON.stringify(input);\n}\n"]}

package/dist/adapters/models/stop-reasons.constants.d.ts

@@ -0,0 +1,4 @@
+import type { ModelStopReason } from "../../domain/model.types.ts";
+export declare const ANTHROPIC_STOP_REASONS: Readonly<Record<string, ModelStopReason>>;
+export declare const CHAT_FINISH_REASONS: Readonly<Record<string, ModelStopReason>>;
+export declare const RESPONSES_INCOMPLETE_REASONS: Readonly<Record<string, ModelStopReason>>;

package/dist/adapters/models/stop-reasons.constants.js

@@ -0,0 +1,19 @@
+export const ANTHROPIC_STOP_REASONS = {
+    end_turn: "end",
+    stop_sequence: "end",
+    tool_use: "tool-calls",
+    max_tokens: "max-tokens",
+    model_context_window_exceeded: "max-tokens",
+    refusal: "refusal",
+};
+export const CHAT_FINISH_REASONS = {
+    stop: "end",
+    tool_calls: "tool-calls",
+    length: "max-tokens",
+    content_filter: "refusal",
+};
+export const RESPONSES_INCOMPLETE_REASONS = {
+    max_output_tokens: "max-tokens",
+    content_filter: "refusal",
+};
+//# sourceMappingURL=stop-reasons.constants.js.map

package/dist/adapters/models/stop-reasons.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-reasons.constants.js","sourceRoot":"","sources":["../../../src/adapters/models/stop-reasons.constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GACjC;IACE,QAAQ,EAAE,KAAK;IACf,aAAa,EAAE,KAAK;IACpB,QAAQ,EAAE,YAAY;IACtB,UAAU,EAAE,YAAY;IACxB,6BAA6B,EAAE,YAAY;IAC3C,OAAO,EAAE,SAAS;CACnB,CAAC;AAEJ,MAAM,CAAC,MAAM,mBAAmB,GAA8C;IAC5E,IAAI,EAAE,KAAK;IACX,UAAU,EAAE,YAAY;IACxB,MAAM,EAAE,YAAY;IACpB,cAAc,EAAE,SAAS;CAC1B,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAErC;IACF,iBAAiB,EAAE,YAAY;IAC/B,cAAc,EAAE,SAAS;CAC1B,CAAC","sourcesContent":["import type { ModelStopReason } from \"../../domain/model.types.ts\";\n\nexport const ANTHROPIC_STOP_REASONS: Readonly<Record<string, ModelStopReason>> =\n  {\n    end_turn: \"end\",\n    stop_sequence: \"end\",\n    tool_use: \"tool-calls\",\n    max_tokens: \"max-tokens\",\n    model_context_window_exceeded: \"max-tokens\",\n    refusal: \"refusal\",\n  };\n\nexport const CHAT_FINISH_REASONS: Readonly<Record<string, ModelStopReason>> = {\n  stop: \"end\",\n  tool_calls: \"tool-calls\",\n  length: \"max-tokens\",\n  content_filter: \"refusal\",\n};\n\nexport const RESPONSES_INCOMPLETE_REASONS: Readonly<\n  Record<string, ModelStopReason>\n> = {\n  max_output_tokens: \"max-tokens\",\n  content_filter: \"refusal\",\n};\n"]}

package/dist/adapters/models/stream-events.d.ts

@@ -0,0 +1,3 @@
+import type { ServerSentEvent } from "../../infrastructure/sse.types.ts";
+export declare function eventData(event: ServerSentEvent): Record<string, unknown>;
+export declare function streamFailure(data: Record<string, unknown>): never;

package/dist/adapters/models/stream-events.js

@@ -0,0 +1,22 @@
+import { OutpostError } from "../../domain/errors.js";
+import { object } from "./model-response.js";
+export function eventData(event) {
+    let value;
+    try {
+        value = JSON.parse(event.data);
+    }
+    catch {
+        throw new OutpostError("response", "Model stream event is not valid JSON");
+    }
+    return object(value);
+}
+export function streamFailure(data) {
+    const error = data.error;
+    const type = error && typeof error === "object" && "type" in error
+        ? String(error.type)
+        : undefined;
+    throw new OutpostError("provider", "Model stream reported an error", {
+        ...(type ? { type } : {}),
+    });
+}
+//# sourceMappingURL=stream-events.js.map

package/dist/adapters/models/stream-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-events.js","sourceRoot":"","sources":["../../../src/adapters/models/stream-events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,UAAU,SAAS,CAAC,KAAsB;IAC9C,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,sCAAsC,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAA6B;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,MAAM,IAAI,GACR,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK;QACnD,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,gCAAgC,EAAE;QACnE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1B,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { OutpostError } from \"../../domain/errors.ts\";\nimport type { ServerSentEvent } from \"../../infrastructure/sse.types.ts\";\nimport { object } from \"./model-response.ts\";\n\nexport function eventData(event: ServerSentEvent): Record<string, unknown> {\n  let value: unknown;\n  try {\n    value = JSON.parse(event.data);\n  } catch {\n    throw new OutpostError(\"response\", \"Model stream event is not valid JSON\");\n  }\n  return object(value);\n}\n\nexport function streamFailure(data: Record<string, unknown>): never {\n  const error = data.error;\n  const type =\n    error && typeof error === \"object\" && \"type\" in error\n      ? String(error.type)\n      : undefined;\n  throw new OutpostError(\"provider\", \"Model stream reported an error\", {\n    ...(type ? { type } : {}),\n  });\n}\n"]}

package/dist/adapters/tools/edit-tools.d.ts

@@ -0,0 +1,2 @@
+import type { HarnessToolset } from "../../domain/tool.types.ts";
+export declare function harnessEditTools(): HarnessToolset;

package/dist/adapters/tools/edit-tools.js

@@ -0,0 +1,84 @@
+import { writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { defineHarnessTool, defineHarnessToolset } from "../../domain/tool.js";
+import { digest, downloadFile, repositoryPath, sandboxPath, withStaging, } from "./sandbox-files.js";
+export function harnessEditTools() {
+    return defineHarnessToolset({
+        name: "edit",
+        tools: [writeFileTool(), editFileTool()],
+    });
+}
+function writeFileTool() {
+    return defineHarnessTool({
+        name: "write_file",
+        description: "Create or replace a UTF-8 file relative to the repository root with the given content. Prefer edit_file to change part of an existing file.",
+        input: {
+            type: "object",
+            properties: {
+                path: { type: "string", minLength: 1 },
+                content: { type: "string" },
+            },
+            required: ["path", "content"],
+            additionalProperties: false,
+        },
+        resources: (input) => ({ paths: [input.path] }),
+        execute: (input, context) => withStaging(async (directory) => {
+            repositoryPath(input.path);
+            const staged = join(directory, "file");
+            await writeFile(staged, input.content);
+            await upload(context, staged, input.path);
+            return `Wrote ${Buffer.byteLength(input.content)} bytes to ${input.path}`;
+        }),
+    });
+}
+function editFileTool() {
+    return defineHarnessTool({
+        name: "edit_file",
+        description: "Replace an exact text in a UTF-8 file. old_text must appear exactly once unless replace_all is true; include surrounding lines to make it unique.",
+        input: {
+            type: "object",
+            properties: {
+                path: { type: "string", minLength: 1 },
+                old_text: { type: "string", minLength: 1 },
+                new_text: { type: "string" },
+                replace_all: { type: "boolean" },
+            },
+            required: ["path", "old_text", "new_text"],
+            additionalProperties: false,
+        },
+        resources: (input) => ({ paths: [input.path] }),
+        execute: (input, context) => withStaging(async (directory) => {
+            const original = await downloadFile(context, input.path, join(directory, "file"));
+            const text = original.bytes.toString("utf8");
+            const occurrences = text.split(input.old_text).length - 1;
+            if (occurrences === 0)
+                return {
+                    content: `old_text was not found in ${input.path}`,
+                    isError: true,
+                };
+            if (occurrences > 1 && !input.replace_all)
+                return {
+                    content: `old_text appears ${occurrences} times in ${input.path}; add surrounding lines or set replace_all`,
+                    isError: true,
+                };
+            const updated = input.replace_all
+                ? text.split(input.old_text).join(input.new_text)
+                : text.replace(input.old_text, () => input.new_text);
+            const current = await downloadFile(context, input.path, join(directory, "current"));
+            if (digest(current.bytes) !== digest(original.bytes))
+                return {
+                    content: `${input.path} changed during the edit; read it again and retry`,
+                    isError: true,
+                };
+            await writeFile(original.staged, updated);
+            await upload(context, original.staged, input.path);
+            return `Replaced ${input.replace_all ? occurrences : 1} occurrence(s) in ${input.path}`;
+        }),
+    });
+}
+function upload(context, staged, path) {
+    return context.sandbox.upload(staged, sandboxPath(context, path), {
+        signal: context.signal,
+    });
+}
+//# sourceMappingURL=edit-tools.js.map

package/dist/adapters/tools/edit-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-tools.js","sourceRoot":"","sources":["../../../src/adapters/tools/edit-tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { defineHarnessTool, defineHarnessToolset } from \"../../domain/tool.ts\";\nimport type {\n  HarnessToolContext,\n  HarnessToolset,\n} from \"../../domain/tool.types.ts\";\nimport {\n  digest,\n  downloadFile,\n  repositoryPath,\n  sandboxPath,\n  withStaging,\n} from \"./sandbox-files.ts\";\nimport type { EditFileInput, WriteFileInput } from \"./tools.types.ts\";\n\nexport function harnessEditTools(): HarnessToolset {\n  return defineHarnessToolset({\n    name: \"edit\",\n    tools: [writeFileTool(), editFileTool()],\n  });\n}\n\nfunction writeFileTool() {\n  return defineHarnessTool({\n    name: \"write_file\",\n    description:\n      \"Create or replace a UTF-8 file relative to the repository root with the given content. Prefer edit_file to change part of an existing file.\",\n    input: {\n      type: \"object\",\n      properties: {\n        path: { type: \"string\", minLength: 1 },\n        content: { type: \"string\" },\n      },\n      required: [\"path\", \"content\"],\n      additionalProperties: false,\n    },\n    resources: (input: WriteFileInput) => ({ paths: [input.path] }),\n    execute: (input: WriteFileInput, context) =>\n      withStaging(async (directory) => {\n        repositoryPath(input.path);\n        const staged = join(directory, \"file\");\n        await writeFile(staged, input.content);\n        await upload(context, staged, input.path);\n        return `Wrote ${Buffer.byteLength(input.content)} bytes to ${input.path}`;\n      }),\n  });\n}\n\nfunction editFileTool() {\n  return defineHarnessTool({\n    name: \"edit_file\",\n    description:\n      \"Replace an exact text in a UTF-8 file. old_text must appear exactly once unless replace_all is true; include surrounding lines to make it unique.\",\n    input: {\n      type: \"object\",\n      properties: {\n        path: { type: \"string\", minLength: 1 },\n        old_text: { type: \"string\", minLength: 1 },\n        new_text: { type: \"string\" },\n        replace_all: { type: \"boolean\" },\n      },\n      required: [\"path\", \"old_text\", \"new_text\"],\n      additionalProperties: false,\n    },\n    resources: (input: EditFileInput) => ({ paths: [input.path] }),\n    execute: (input: EditFileInput, context) =>\n      withStaging(async (directory) => {\n        const original = await downloadFile(\n          context,\n          input.path,\n          join(directory, \"file\"),\n        );\n        const text = original.bytes.toString(\"utf8\");\n        const occurrences = text.split(input.old_text).length - 1;\n        if (occurrences === 0)\n          return {\n            content: `old_text was not found in ${input.path}`,\n            isError: true,\n          };\n        if (occurrences > 1 && !input.replace_all)\n          return {\n            content: `old_text appears ${occurrences} times in ${input.path}; add surrounding lines or set replace_all`,\n            isError: true,\n          };\n        const updated = input.replace_all\n          ? text.split(input.old_text).join(input.new_text)\n          : text.replace(input.old_text, () => input.new_text);\n        const current = await downloadFile(\n          context,\n          input.path,\n          join(directory, \"current\"),\n        );\n        if (digest(current.bytes) !== digest(original.bytes))\n          return {\n            content: `${input.path} changed during the edit; read it again and retry`,\n            isError: true,\n          };\n        await writeFile(original.staged, updated);\n        await upload(context, original.staged, input.path);\n        return `Replaced ${input.replace_all ? occurrences : 1} occurrence(s) in ${input.path}`;\n      }),\n  });\n}\n\nfunction upload(context: HarnessToolContext, staged: string, path: string) {\n  return context.sandbox.upload(staged, sandboxPath(context, path), {\n    signal: context.signal,\n  });\n}\n"]}

package/dist/adapters/tools/file-tools.d.ts

@@ -0,0 +1,2 @@
+import type { HarnessToolset } from "../../domain/tool.types.ts";
+export declare function harnessFileTools(): HarnessToolset;

package/dist/adapters/tools/file-tools.js

@@ -0,0 +1,97 @@
+import { join } from "node:path";
+import { glob } from "../../domain/glob.js";
+import { defineHarnessTool, defineHarnessToolset } from "../../domain/tool.js";
+import { anywhere, downloadFile, repositoryPath, withStaging, } from "./sandbox-files.js";
+import { TOOL_LIMITS } from "./tools.constants.js";
+export function harnessFileTools() {
+    return defineHarnessToolset({
+        name: "files",
+        tools: [readFileTool(), listFilesTool()],
+    });
+}
+function readFileTool() {
+    return defineHarnessTool({
+        name: "read_file",
+        description: "Read a UTF-8 text file relative to the repository root. Lines are numbered; use offset and limit for long files.",
+        readOnly: true,
+        input: {
+            type: "object",
+            properties: {
+                path: { type: "string", minLength: 1 },
+                offset: { type: "integer", minimum: 1 },
+                limit: { type: "integer", minimum: 1, maximum: TOOL_LIMITS.readLines },
+            },
+            required: ["path"],
+            additionalProperties: false,
+        },
+        resources: (input) => ({ paths: [input.path] }),
+        execute: (input, context) => withStaging(async (directory) => {
+            const file = await downloadFile(context, input.path, join(directory, "file"));
+            const lines = file.bytes.toString("utf8").split(/\r?\n/);
+            if (lines.at(-1) === "")
+                lines.pop();
+            const start = (input.offset ?? 1) - 1;
+            const selected = lines.slice(start, start + (input.limit ?? TOOL_LIMITS.readLines));
+            const width = String(start + selected.length).length;
+            const body = selected
+                .map((line, index) => `${String(start + index + 1).padStart(width)}\t${line}`)
+                .join("\n");
+            const end = start + selected.length;
+            const note = end < lines.length || start > 0
+                ? `\n[lines ${start + 1}-${end} of ${lines.length}]`
+                : "";
+            return lines.length ? `${body}${note}` : "(empty file)";
+        }),
+    });
+}
+function listFilesTool() {
+    return defineHarnessTool({
+        name: "list_files",
+        description: "List files in the repository that are tracked or not ignored by Git, optionally under a directory and filtered by a glob such as src/**/*.ts; a glob without a slash matches file names at any depth.",
+        readOnly: true,
+        input: {
+            type: "object",
+            properties: {
+                path: { type: "string" },
+                pattern: { type: "string", minLength: 1 },
+            },
+            additionalProperties: false,
+        },
+        resources: (input) => ({ paths: [input.path ?? "."] }),
+        async execute(input, context) {
+            const scope = repositoryPath(input.path ?? ".") || ".";
+            const result = await context.sandbox.invoke({
+                executable: "git",
+                arguments: [
+                    "ls-files",
+                    "-z",
+                    "--cached",
+                    "--others",
+                    "--exclude-standard",
+                    "--",
+                    scope,
+                ],
+                retain: TOOL_LIMITS.commandCharacters * 10,
+                signal: context.signal,
+            });
+            if (result.status !== 0)
+                return {
+                    content: result.stderr || "git ls-files failed",
+                    isError: true,
+                };
+            const matcher = input.pattern
+                ? glob(anywhere(input.pattern), "path")
+                : undefined;
+            const files = [...new Set(result.stdout.split("\0").filter(Boolean))]
+                .filter((file) => !matcher || matcher.test(file))
+                .sort();
+            const shown = files.slice(0, TOOL_LIMITS.listEntries);
+            if (!shown.length)
+                return "No files found.";
+            return shown.length < files.length
+                ? `${shown.join("\n")}\n[${files.length - shown.length} more files; narrow the path or pattern]`
+                : shown.join("\n");
+        },
+    });
+}
+//# sourceMappingURL=file-tools.js.map

package/dist/adapters/tools/file-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-tools.js","sourceRoot":"","sources":["../../../src/adapters/tools/file-tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { join } from \"node:path\";\nimport { glob } from \"../../domain/glob.ts\";\nimport { defineHarnessTool, defineHarnessToolset } from \"../../domain/tool.ts\";\nimport type { HarnessToolset } from \"../../domain/tool.types.ts\";\nimport {\n  anywhere,\n  downloadFile,\n  repositoryPath,\n  withStaging,\n} from \"./sandbox-files.ts\";\nimport { TOOL_LIMITS } from \"./tools.constants.ts\";\nimport type { ListFilesInput, ReadFileInput } from \"./tools.types.ts\";\n\nexport function harnessFileTools(): HarnessToolset {\n  return defineHarnessToolset({\n    name: \"files\",\n    tools: [readFileTool(), listFilesTool()],\n  });\n}\n\nfunction readFileTool() {\n  return defineHarnessTool({\n    name: \"read_file\",\n    description:\n      \"Read a UTF-8 text file relative to the repository root. Lines are numbered; use offset and limit for long files.\",\n    readOnly: true,\n    input: {\n      type: \"object\",\n      properties: {\n        path: { type: \"string\", minLength: 1 },\n        offset: { type: \"integer\", minimum: 1 },\n        limit: { type: \"integer\", minimum: 1, maximum: TOOL_LIMITS.readLines },\n      },\n      required: [\"path\"],\n      additionalProperties: false,\n    },\n    resources: (input: ReadFileInput) => ({ paths: [input.path] }),\n    execute: (input: ReadFileInput, context) =>\n      withStaging(async (directory) => {\n        const file = await downloadFile(\n          context,\n          input.path,\n          join(directory, \"file\"),\n        );\n        const lines = file.bytes.toString(\"utf8\").split(/\\r?\\n/);\n        if (lines.at(-1) === \"\") lines.pop();\n        const start = (input.offset ?? 1) - 1;\n        const selected = lines.slice(\n          start,\n          start + (input.limit ?? TOOL_LIMITS.readLines),\n        );\n        const width = String(start + selected.length).length;\n        const body = selected\n          .map(\n            (line, index) =>\n              `${String(start + index + 1).padStart(width)}\\t${line}`,\n          )\n          .join(\"\\n\");\n        const end = start + selected.length;\n        const note =\n          end < lines.length || start > 0\n            ? `\\n[lines ${start + 1}-${end} of ${lines.length}]`\n            : \"\";\n        return lines.length ? `${body}${note}` : \"(empty file)\";\n      }),\n  });\n}\n\nfunction listFilesTool() {\n  return defineHarnessTool({\n    name: \"list_files\",\n    description:\n      \"List files in the repository that are tracked or not ignored by Git, optionally under a directory and filtered by a glob such as src/**/*.ts; a glob without a slash matches file names at any depth.\",\n    readOnly: true,\n    input: {\n      type: \"object\",\n      properties: {\n        path: { type: \"string\" },\n        pattern: { type: \"string\", minLength: 1 },\n      },\n      additionalProperties: false,\n    },\n    resources: (input: ListFilesInput) => ({ paths: [input.path ?? \".\"] }),\n    async execute(input: ListFilesInput, context) {\n      const scope = repositoryPath(input.path ?? \".\") || \".\";\n      const result = await context.sandbox.invoke({\n        executable: \"git\",\n        arguments: [\n          \"ls-files\",\n          \"-z\",\n          \"--cached\",\n          \"--others\",\n          \"--exclude-standard\",\n          \"--\",\n          scope,\n        ],\n        retain: TOOL_LIMITS.commandCharacters * 10,\n        signal: context.signal,\n      });\n      if (result.status !== 0)\n        return {\n          content: result.stderr || \"git ls-files failed\",\n          isError: true,\n        };\n      const matcher = input.pattern\n        ? glob(anywhere(input.pattern), \"path\")\n        : undefined;\n      const files = [...new Set(result.stdout.split(\"\\0\").filter(Boolean))]\n        .filter((file) => !matcher || matcher.test(file))\n        .sort();\n      const shown = files.slice(0, TOOL_LIMITS.listEntries);\n      if (!shown.length) return \"No files found.\";\n      return shown.length < files.length\n        ? `${shown.join(\"\\n\")}\\n[${files.length - shown.length} more files; narrow the path or pattern]`\n        : shown.join(\"\\n\");\n    },\n  });\n}\n"]}

package/dist/adapters/tools/git-tools.d.ts

@@ -0,0 +1,2 @@
+import type { HarnessToolset } from "../../domain/tool.types.ts";
+export declare function harnessGitTools(): HarnessToolset;

package/dist/adapters/tools/git-tools.js

@@ -0,0 +1,54 @@
+import { defineHarnessTool, defineHarnessToolset } from "../../domain/tool.js";
+import { commandOutput } from "./sandbox-files.js";
+import { GIT_BLOCKED_OPTIONS, GIT_READ_COMMANDS, TOOL_LIMITS, } from "./tools.constants.js";
+export function harnessGitTools() {
+    return defineHarnessToolset({
+        name: "git",
+        tools: [
+            defineHarnessTool({
+                name: "git",
+                description: "Run a read-only Git command (status, diff, log or show) in the repository with extra arguments, for example log with -n 5 --oneline.",
+                readOnly: true,
+                input: {
+                    type: "object",
+                    properties: {
+                        command: { enum: [...GIT_READ_COMMANDS] },
+                        arguments: { type: "array", items: { type: "string" } },
+                    },
+                    required: ["command"],
+                    additionalProperties: false,
+                },
+                resources: (input) => ({
+                    command: ["git", input.command, ...(input.arguments ?? [])].join(" "),
+                }),
+                async execute(input, context) {
+                    const blocked = (input.arguments ?? []).find((argument) => GIT_BLOCKED_OPTIONS.some((option) => argument.startsWith(option)));
+                    if (blocked)
+                        return {
+                            content: `Unsupported Git option: ${blocked}`,
+                            isError: true,
+                        };
+                    const result = await context.sandbox.invoke({
+                        executable: "git",
+                        arguments: [
+                            "--no-pager",
+                            input.command,
+                            ...(input.command === "status"
+                                ? []
+                                : ["--no-ext-diff", "--no-textconv"]),
+                            ...(input.arguments ?? []),
+                        ],
+                        stdin: "",
+                        retain: TOOL_LIMITS.commandCharacters,
+                        signal: context.signal,
+                    });
+                    return {
+                        content: commandOutput(result),
+                        isError: result.status !== 0,
+                    };
+                },
+            }),
+        ],
+    });
+}
+//# sourceMappingURL=git-tools.js.map

package/dist/adapters/tools/git-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-tools.js","sourceRoot":"","sources":["../../../src/adapters/tools/git-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAG9B,MAAM,UAAU,eAAe;IAC7B,OAAO,oBAAoB,CAAC;QAC1B,IAAI,EAAE,KAAK;QACX,KAAK,EAAE;YACL,iBAAiB,CAAC;gBAChB,IAAI,EAAE,KAAK;gBACX,WAAW,EACT,sIAAsI;gBACxI,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,iBAAiB,CAAC,EAAE;wBACzC,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;qBACxD;oBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;oBACrB,oBAAoB,EAAE,KAAK;iBAC5B;gBACD,SAAS,EAAE,CAAC,KAAe,EAAE,EAAE,CAAC,CAAC;oBAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;iBACtE,CAAC;gBACF,KAAK,CAAC,OAAO,CAAC,KAAe,EAAE,OAAO;oBACpC,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CACxD,mBAAmB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAClE,CAAC;oBACF,IAAI,OAAO;wBACT,OAAO;4BACL,OAAO,EAAE,2BAA2B,OAAO,EAAE;4BAC7C,OAAO,EAAE,IAAI;yBACd,CAAC;oBACJ,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;wBAC1C,UAAU,EAAE,KAAK;wBACjB,SAAS,EAAE;4BACT,YAAY;4BACZ,KAAK,CAAC,OAAO;4BACb,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,QAAQ;gCAC5B,CAAC,CAAC,EAAE;gCACJ,CAAC,CAAC,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;4BACvC,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;yBAC3B;wBACD,KAAK,EAAE,EAAE;wBACT,MAAM,EAAE,WAAW,CAAC,iBAAiB;wBACrC,MAAM,EAAE,OAAO,CAAC,MAAM;qBACvB,CAAC,CAAC;oBACH,OAAO;wBACL,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC;wBAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;qBAC7B,CAAC;gBACJ,CAAC;aACF,CAAC;SACH;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { defineHarnessTool, defineHarnessToolset } from \"../../domain/tool.ts\";\nimport type { HarnessToolset } from \"../../domain/tool.types.ts\";\nimport { commandOutput } from \"./sandbox-files.ts\";\nimport {\n  GIT_BLOCKED_OPTIONS,\n  GIT_READ_COMMANDS,\n  TOOL_LIMITS,\n} from \"./tools.constants.ts\";\nimport type { GitInput } from \"./tools.types.ts\";\n\nexport function harnessGitTools(): HarnessToolset {\n  return defineHarnessToolset({\n    name: \"git\",\n    tools: [\n      defineHarnessTool({\n        name: \"git\",\n        description:\n          \"Run a read-only Git command (status, diff, log or show) in the repository with extra arguments, for example log with -n 5 --oneline.\",\n        readOnly: true,\n        input: {\n          type: \"object\",\n          properties: {\n            command: { enum: [...GIT_READ_COMMANDS] },\n            arguments: { type: \"array\", items: { type: \"string\" } },\n          },\n          required: [\"command\"],\n          additionalProperties: false,\n        },\n        resources: (input: GitInput) => ({\n          command: [\"git\", input.command, ...(input.arguments ?? [])].join(\" \"),\n        }),\n        async execute(input: GitInput, context) {\n          const blocked = (input.arguments ?? []).find((argument) =>\n            GIT_BLOCKED_OPTIONS.some((option) => argument.startsWith(option)),\n          );\n          if (blocked)\n            return {\n              content: `Unsupported Git option: ${blocked}`,\n              isError: true,\n            };\n          const result = await context.sandbox.invoke({\n            executable: \"git\",\n            arguments: [\n              \"--no-pager\",\n              input.command,\n              ...(input.command === \"status\"\n                ? []\n                : [\"--no-ext-diff\", \"--no-textconv\"]),\n              ...(input.arguments ?? []),\n            ],\n            stdin: \"\",\n            retain: TOOL_LIMITS.commandCharacters,\n            signal: context.signal,\n          });\n          return {\n            content: commandOutput(result),\n            isError: result.status !== 0,\n          };\n        },\n      }),\n    ],\n  });\n}\n"]}

package/dist/adapters/tools/sandbox-files.d.ts

@@ -0,0 +1,10 @@
+import type { CommandResult } from "../../domain/command.types.ts";
+import type { HarnessToolContext } from "../../domain/tool.types.ts";
+import type { SandboxFile } from "./tools.types.ts";
+export declare function repositoryPath(path: string): string;
+export declare function sandboxPath(context: HarnessToolContext, path: string): string;
+export declare function withStaging<T>(operation: (directory: string) => Promise<T>): Promise<T>;
+export declare function downloadFile(context: HarnessToolContext, path: string, staged: string): Promise<SandboxFile>;
+export declare function digest(bytes: Buffer): string;
+export declare function commandOutput(result: CommandResult): string;
+export declare function anywhere(pattern: string): string;

package/dist/adapters/tools/sandbox-files.js

@@ -0,0 +1,60 @@
+import { createHash } from "node:crypto";
+import { lstat, mkdtemp, readFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join, posix } from "node:path";
+import { normalizeResourcePath } from "../../domain/permissions.js";
+import { TOOL_LIMITS } from "./tools.constants.js";
+export function repositoryPath(path) {
+    const normalized = normalizeResourcePath(path);
+    if (normalized === undefined)
+        throw new Error(`Path must stay inside the repository: ${path}`);
+    return normalized;
+}
+export function sandboxPath(context, path) {
+    const normalized = repositoryPath(path);
+    return normalized
+        ? posix.join(context.sandbox.root, normalized)
+        : context.sandbox.root;
+}
+export async function withStaging(operation) {
+    const directory = await mkdtemp(join(tmpdir(), "outpost-tool-"));
+    try {
+        return await operation(directory);
+    }
+    finally {
+        await rm(directory, { recursive: true, force: true });
+    }
+}
+export async function downloadFile(context, path, staged) {
+    await context.sandbox.download(sandboxPath(context, path), staged, {
+        signal: context.signal,
+    });
+    const info = await lstat(staged);
+    if (info.isSymbolicLink())
+        throw new Error(`${path} is a symbolic link; links are not followed`);
+    if (!info.isFile())
+        throw new Error(`${path} is not a regular file`);
+    if (info.size > TOOL_LIMITS.fileBytes)
+        throw new Error(`${path} has ${info.size} bytes; the limit is ${TOOL_LIMITS.fileBytes}`);
+    const bytes = await readFile(staged);
+    if (bytes.subarray(0, TOOL_LIMITS.binaryProbeBytes).includes(0))
+        throw new Error(`${path} looks binary and cannot be read as text`);
+    return { staged, bytes };
+}
+export function digest(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+export function commandOutput(result) {
+    const note = (text) => text.length >= TOOL_LIMITS.commandCharacters
+        ? `[output truncated to the last ${TOOL_LIMITS.commandCharacters} characters]\n${text}`
+        : text;
+    return [
+        `exit status: ${result.status}`,
+        ...(result.stdout ? ["--- stdout ---", note(result.stdout)] : []),
+        ...(result.stderr ? ["--- stderr ---", note(result.stderr)] : []),
+    ].join("\n");
+}
+export function anywhere(pattern) {
+    return pattern.includes("/") ? pattern : `**/${pattern}`;
+}
+//# sourceMappingURL=sandbox-files.js.map

package/dist/adapters/tools/sandbox-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-files.js","sourceRoot":"","sources":["../../../src/adapters/tools/sandbox-files.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { lstat, mkdtemp, readFile, rm } from \"node:fs/promises\";\nimport { tmpdir } from \"node:os\";\nimport { join, posix } from \"node:path\";\nimport { normalizeResourcePath } from \"../../domain/permissions.ts\";\nimport type { CommandResult } from \"../../domain/command.types.ts\";\nimport type { HarnessToolContext } from \"../../domain/tool.types.ts\";\nimport { TOOL_LIMITS } from \"./tools.constants.ts\";\nimport type { SandboxFile } from \"./tools.types.ts\";\n\nexport function repositoryPath(path: string): string {\n  const normalized = normalizeResourcePath(path);\n  if (normalized === undefined)\n    throw new Error(`Path must stay inside the repository: ${path}`);\n  return normalized;\n}\n\nexport function sandboxPath(context: HarnessToolContext, path: string): string {\n  const normalized = repositoryPath(path);\n  return normalized\n    ? posix.join(context.sandbox.root, normalized)\n    : context.sandbox.root;\n}\n\nexport async function withStaging<T>(\n  operation: (directory: string) => Promise<T>,\n): Promise<T> {\n  const directory = await mkdtemp(join(tmpdir(), \"outpost-tool-\"));\n  try {\n    return await operation(directory);\n  } finally {\n    await rm(directory, { recursive: true, force: true });\n  }\n}\n\nexport async function downloadFile(\n  context: HarnessToolContext,\n  path: string,\n  staged: string,\n): Promise<SandboxFile> {\n  await context.sandbox.download(sandboxPath(context, path), staged, {\n    signal: context.signal,\n  });\n  const info = await lstat(staged);\n  if (info.isSymbolicLink())\n    throw new Error(`${path} is a symbolic link; links are not followed`);\n  if (!info.isFile()) throw new Error(`${path} is not a regular file`);\n  if (info.size > TOOL_LIMITS.fileBytes)\n    throw new Error(\n      `${path} has ${info.size} bytes; the limit is ${TOOL_LIMITS.fileBytes}`,\n    );\n  const bytes = await readFile(staged);\n  if (bytes.subarray(0, TOOL_LIMITS.binaryProbeBytes).includes(0))\n    throw new Error(`${path} looks binary and cannot be read as text`);\n  return { staged, bytes };\n}\n\nexport function digest(bytes: Buffer): string {\n  return createHash(\"sha256\").update(bytes).digest(\"hex\");\n}\n\nexport function commandOutput(result: CommandResult): string {\n  const note = (text: string) =>\n    text.length >= TOOL_LIMITS.commandCharacters\n      ? `[output truncated to the last ${TOOL_LIMITS.commandCharacters} characters]\\n${text}`\n      : text;\n  return [\n    `exit status: ${result.status}`,\n    ...(result.stdout ? [\"--- stdout ---\", note(result.stdout)] : []),\n    ...(result.stderr ? [\"--- stderr ---\", note(result.stderr)] : []),\n  ].join(\"\\n\");\n}\n\nexport function anywhere(pattern: string): string {\n  return pattern.includes(\"/\") ? pattern : `**/${pattern}`;\n}\n"]}

package/dist/adapters/tools/search-tools.d.ts

@@ -0,0 +1,2 @@
+import type { HarnessToolset } from "../../domain/tool.types.ts";
+export declare function harnessSearchTools(): HarnessToolset;