npm - agent-hitch - Versions diffs - 0.2.1 → 0.2.3 - Mend

agent-hitch 0.2.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (19) hide show

package/README.md +88 -256
package/README.zh-CN.md +84 -235
package/dist/src/artifacts/handoff.js +12 -0
package/dist/src/artifacts/handoff.js.map +1 -0
package/dist/src/artifacts/index.js +2 -0
package/dist/src/artifacts/index.js.map +1 -1
package/dist/src/artifacts/store.js +72 -2
package/dist/src/artifacts/store.js.map +1 -1
package/dist/src/backends/harbor/backend.js +22 -3
package/dist/src/backends/harbor/backend.js.map +1 -1
package/dist/src/cli/commands/run.js +65 -3
package/dist/src/cli/commands/run.js.map +1 -1
package/dist/src/evals/service.js +57 -1
package/dist/src/evals/service.js.map +1 -1
package/dist/src/runs/executor.js +10 -4
package/dist/src/runs/executor.js.map +1 -1
package/docs/schemas/eval-result.schema.json +14 -0
package/integrations/harbor/hitch_harbor_agent.py +426 -13
package/package.json +1 -1

package/README.zh-CN.md CHANGED Viewed

@@ -6,171 +6,126 @@
 [English](README.md) | [简体中文](README.zh-CN.md)
-**面向智能体 Harness 的内容寻址版本控制与证据存储。**
+**让智能体 Harness 的每次运行都可复现。**
-Hitch 让每一次智能体运行都可以追溯到确定的 Harness 版本。它将 Harness
-引用解析为不可变身份，准备内容寻址的可运行制品，通过稳定接口执行这些
-制品，并保存每次运行产生的轨迹与评测证据。
-Git 可以标识发生变化的 Harness 源代码，而 Hitch 将这个身份贯穿构建与
-执行的全过程：
+Hitch 可以从确定的软件版本或 Git 提交运行 Codex、Claude Code、Pi、OpenCode
+和 DeepSeek Harness。每次运行都会关联 Harness 版本、不可变制品、工作区、
+轨迹、日志和评测证据。
 ```text
-Harness 引用
-  -> 已解析版本
-  -> 已准备制品
-  -> 运行 / 评测
-  -> 轨迹
-  -> 反馈与评测证据
-Hitch 控制器
-  -> 内容寻址的运行时包
-  -> 由容器化评测引用
+版本或提交 -> 不可变制品 -> 运行或评测 -> 可验证证据
 ```
-Hitch 是开发、比较和演化智能体 Harness 的系统基础设施。它负责版本解析、
-可运行制品、执行记录和证据；候选方案生成、比较策略与晋级决策则由使用
-Hitch 的上层系统负责。
+```bash
+npm install --global agent-hitch
-> **状态：** pre-alpha。核心身份与证据链路已经实现，包括不可变版本解析、
-> 制品准备与缓存、直接运行与守护进程运行、Harbor 评测、内容寻址的控制器
-> 运行时、兼容 DSH 的规范化轨迹，以及消息反馈。
+hitch run \
+  --harness codex@version:0.92.0 \
+  --prompt "Inspect this repository"
+```
-## 为什么 Harness 需要版本控制？
+> **状态：** pre-alpha。核心运行、来源追踪、轨迹、反馈、守护进程和 Harbor
+> 评测链路已经实现。
-智能体 Harness 不只是一次源代码提交。实际运行的内容还可能取决于软件包
-版本、构建产物、控制器代码、工作区模式、原生适配器，以及机器上可变的
-已安装可执行文件。如果分数或记录没有关联这些身份，就很难审计，更难复现。
+## 为什么使用 Hitch？
-Hitch 保存从请求的 Harness 引用到执行证据的完整、显式链路：
+Git 告诉你哪些源码发生了变化，Hitch 则告诉你究竟运行了什么，以及它产生了
+哪些证据。
-| 记录 | 标识的内容 |
-| --- | --- |
-| Harness 引用 | 调用方请求的软件版本、提交、本地源码或已安装可执行文件 |
-| 已解析版本 | 为本次运行选定的不可变源码身份 |
-| 已准备制品 | 经过验证、采用内容寻址的可运行构建产物 |
-| 控制器运行时 | 上传到容器化评测中的确切 Hitch 运行时 |
-| 运行或评测记录 | 请求、工作区、生命周期、结果以及各身份之间的关联 |
-| 规范化轨迹 | 采用稳定、兼容 DSH 格式记录的智能体消息与工具活动 |
-| 反馈与评测证据 | 消息级反馈、验证器输出、奖励及后端记录 |
+- **复现：** 从确定的软件包版本或源码提交重新运行。
+- **比较：** 通过统一的执行契约比较不同 Harness 和模型。
+- **审计：** 用不可变制品、原生事件、规范化轨迹、日志、反馈和评测记录验证
+  结果。
-它是一个本地版本与证据层，不是 Git 的替代品，目前也不是远端制品注册表。
-Hitch 当前尚未提供分支、标签、差异比较、候选晋级或回滚策略。
+Hitch 适合构建智能体评测、Harness 实验、Coding Agent 基础设施和自动晋级
+流水线的团队。
 ## 快速开始
-Hitch 要求 Node.js 22 或更高版本。通过 npm 安装：
+Hitch 要求 Node.js 22 或更高版本。
 ```bash
 npm install --global agent-hitch
 hitch --version
-hitch list --json
 ```
-解析并准备一个确定的 Harness 版本：
-```bash
-hitch resolve codex@version:0.92.0 --json
-hitch prepare codex@version:0.92.0 --json
-```
-在隔离的 Git worktree 中运行这个确定版本：
+在隔离的 Git worktree 中运行一个确定的 Harness 版本：
 ```bash
 hitch run \
   --harness codex@version:0.92.0 \
-  --model gpt-5.6-terra \
-  --cwd /workspace/project \
   --workspace-mode worktree \
-  --prompt-file task.md \
+  --prompt "Inspect this repository" \
   --output jsonl
 ```
-每次运行都会在 `~/.hitch/runs/RUN_ID` 下写入原子的 manifest 与结果、原始
-进程日志、规范化事件和规范化轨迹。可以通过 CLI 检查轨迹：
+输出中包含 run ID，可以用它查看保存的轨迹：
 ```bash
-hitch trajectory inspect RUN_ID --json
+hitch trajectory inspect RUN_ID
 ```
-从源码检出进行开发：
-```bash
-npm install
-npm run check
-npm link
-hitch list --json
-```
+每次运行的 manifest、结果、事件、日志和轨迹都会保存在
+`~/.hitch/runs/RUN_ID` 下。
-## Harness 引用
+## 固定任意 Harness 版本
-每次运行都需要显式选择 Harness。确定的软件包版本与 Git 提交会被解析为
-不可变身份，并在 Hitch 的制品存储中完成准备。
+每次运行都会显式选择 Harness：
 ```bash
-# 使用并指纹识别本机已经安装的可执行文件。
+# 对本机已经安装的可执行文件生成指纹并运行。
 hitch run --harness codex@installed --prompt "Inspect this repository"
-# 解析、准备或运行一个确定的已发布版本。
-hitch resolve codex@version:0.92.0 --json
-hitch prepare codex@version:0.92.0 --json
+# 解析并运行一个确定的已发布版本。
 hitch run --harness codex@version:0.92.0 --prompt "Inspect this repository"
-# 从已注册的上游仓库构建一个提交。
+# 从已注册的上游仓库构建并运行一个确定的提交。
 hitch run --harness codex@commit:0123456789abcdef --prompt "Inspect this repository"
-# 从本地 Harness 仓库构建一个干净的提交。
-hitch run \
-  --harness 'pi@git+file:///workspace/pi#0123456789abcdef' \
-  --prompt "Inspect this repository"
 ```
-`codex` 之类的裸名称是 `codex@installed` 的兼容别名。已安装的可执行文件
-适合本地使用；如果需要可移植性，应优先选择确定的版本或提交引用。
+| Harness | 已安装版本 | 确定的软件包版本 | 源码提交 |
+| --- | :---: | :---: | :---: |
+| Codex | ✓ | ✓ | ✓ |
+| Claude Code | ✓ | ✓ | — |
+| Pi | ✓ | ✓ | ✓ |
+| OpenCode | ✓ | ✓ | — |
+| DeepSeek Harness | ✓ | ✓ | ✓ |
-版本选择器必须使用确定的语义化版本，不接受版本范围和 `latest` 等可变
-标签。短提交 ID 会被展开，并且必须没有歧义。本地 Git 仓库必须处于干净
-状态。Codex、Pi 和 DeepSeek Harness 支持从源码提交准备制品；Claude Code
-与 OpenCode 目前支持已安装版本和确定的软件包版本。
+确定的版本和提交会被准备为经过验证、采用内容寻址的制品，并从 Hitch 的本地
+缓存中复用。已安装的可执行文件适合本地工作；需要可移植性时，应使用不可变
+引用。
-准备过程会以 Hitch 进程的权限执行已注册的软件包生命周期命令或源码构建
-命令。内容寻址让制品可以审计和缓存，但不会让不可信的构建代码变得安全。
+## 每次运行都会留下证据
-## 每次运行的证据
+Hitch 记录从请求到结果的完整链路：
-Hitch 将生命周期事件与智能体轨迹保存为两类相关但相互独立的记录：
+- 请求的引用及解析后的不可变版本；
+- 经过验证、采用内容寻址的可运行制品；
+- 工作区、模型身份、生命周期与最终结果；
+- 规范化控制面事件与原始进程日志；
+- 支持场景下经过脱敏的 provider-native 事件；
+- 采用 SHA-256 绑定文件、兼容 DSH 的规范化轨迹；
+- 带版本的消息反馈与评测证据。
-- 规范化 JSONL 事件描述 Hitch 的控制平面，包括解析、准备、进程生命周期、
-  取消和最终状态；
-- 支持结构化输出的 adapter 会先保存经过显式脱敏的 provider-native 事件，
-  兼容 DSH 的规范化轨迹则作为派生视图继续提供；
-- `trajectory.ref.json` V2 通过相对路径、文件角色、字节数与 SHA-256 摘要
-  绑定完整轨迹文件集；
-- 反馈 sidecar 可以为助手消息附加带版本的正向或负向评分与备注，而无需
-  改写不可变轨迹。
+可以通过 CLI 查询运行，并在不改写轨迹的情况下附加反馈：
 ```bash
-hitch trajectory inspect RUN_ID
-hitch runs list --context-kind benchmark_task --json
-hitch compare model --benchmark BENCHMARK --task TASK --json
+hitch runs list --json
 hitch feedback list RUN_ID --json
 hitch feedback put RUN_ID \
   --message MESSAGE_ID \
   --rating positive \
-  --note "修改保持了足够聚焦" \
-  --json
+  --note "修改保持了足够聚焦"
 ```
-带版本的机器接口 Schema 位于 [`docs/schemas`](docs/schemas)。运行时校验会
-拒绝未知的请求字段，并在守护进程 HTTP 边界两侧保留类型化错误。
+带版本的机器接口 Schema 位于 [`docs/schemas`](docs/schemas)。
-## Harbor 评测
+## 可复现的智能体评测
-Hitch 可以通过 [Harbor](https://github.com/harbor-framework/harbor) 评测一个
-确定且可移植的 Harness 版本：
+Hitch 集成了 [Harbor](https://github.com/harbor-framework/harbor)，可以在 Docker
+中评测确定且可移植的 Harness 版本：
 ```bash
-# 将固定版本的 Harbor 安装到 ~/.hitch/tools，不修改系统 Python。
 hitch eval setup harbor
 hitch eval doctor
@@ -178,157 +133,51 @@ hitch eval run \
   --backend harbor \
   --dataset terminal-bench@2.0 \
   --harness codex@version:0.92.0 \
-  --model openai/gpt-5.6 \
-  --attempts 1 \
-  --max-concurrent 4
-hitch eval list
-hitch eval inspect EVAL_ID --json
+  --model openai/gpt-5.6
 ```
-Harbor 负责任务发现、Docker 生命周期、验证与奖励。它的自定义 Hitch agent
-会将最小化、采用 SHA-256 寻址的 Hitch 控制器运行时上传到每个任务容器，
-并在 `/app` 中执行选定的 Harness 版本。生成的评测记录会关联请求、已解析
-版本、控制器运行时、后端配置与日志、规范化结果、奖励摘要和轨迹证据。
-评测接受确定的 `version:`、已注册远端的 `commit:`，以及显式本地
-`git+file:///绝对路径#<完整小写commit>` 引用。本地 Git 评测只会将该提交
-所需并经过校验的 Git 对象包传入 Harbor trial；未提交文件、Git 配置、凭证
-和无关历史不会被携带。仓库必须干净，缩写 commit、分支、tag、`HEAD` 和
-已安装可执行文件会被拒绝。常用模型供应商凭证通过环境变量引用转发；使用
-`--pass-env NAME` 可以额外传入一个环境变量。
-有关安装、可移植性规则和执行边界，请参阅
+每次评测都会关联已解析的 Harness 版本、采用内容寻址的 Hitch 控制器运行时、
+后端配置、奖励、日志和轨迹证据。安装方法和可移植性规则参见
 [Harbor 智能体评测](docs/evals.md)。
-## 稳定执行层
+## 为自动化而设计
-带版本的制品仍然需要一致的运行方式。Hitch 为 Codex CLI、Claude Code、
-Pi、OpenCode 和 DeepSeek Harness 提供适配器，并通过一个面向机器的统一
-接口规范化它们的调用方式和生命周期行为。
+- 提供 JSON 和 JSONL 输出、带版本的 Schema 与类型化错误
+- 支持直接执行或具有并发上限的持久化守护进程
+- 支持共享、detached Git worktree 和独立副本工作区
+- 支持超时、取消、进程树清理和中断运行恢复
+- 通过 `--root <path>` 或 `HITCH_ROOT` 隔离本地状态
-```text
-调用方 -> Hitch CLI / 守护进程 -> 共享运行引擎 -> Codex CLI
-                                         \----> Claude Code
-                                         \----> Pi
-                                         \----> OpenCode
-                                         \----> DeepSeek Harness
-```
-直接 CLI 与持久化守护进程使用同一个运行引擎，因此版本解析、记录、超时、
-取消和事件行为不会发生偏移。当前运行时提供：
-- 可执行文件发现、版本探测和可执行文件指纹；
-- 确定的软件包版本与 Git 提交解析；
-- 带完整性校验缓存的不可变制品；
-- 输出规范化 JSONL 事件的直接执行；
-- 具备并发上限的持久化本地守护进程；
-- 队列中及运行中任务的取消、超时与完整进程树清理；
-- 受管理的共享、Git worktree 和独立副本工作区模式；
-- 原子的 manifest 与结果，以及原始 stdout 和 stderr 日志；
-- 守护进程重启后对中断记录的保守恢复。
-需要长期运行的队列时，可以通过守护进程执行：
+需要长期执行队列时，可以启动守护进程：
 ```bash
 hitch daemon start --max-concurrent 4
-hitch run \
-  --daemon \
-  --harness codex@version:0.92.0 \
-  --cwd /workspace/project \
-  --prompt-file task.md \
-  --output jsonl
-hitch daemon status --json
-hitch daemon stop
-```
-也可以异步提交并取消：
-```bash
-hitch daemon submit \
-  --harness claude@version:EXACT_VERSION \
-  --cwd /workspace/project \
-  --prompt-file task.md
-hitch daemon cancel RUN_ID
+hitch run --daemon --harness codex@version:0.92.0 --prompt-file task.md
 ```
-## 状态与隔离
-状态默认存储在 `~/.hitch` 下。可以使用 `--root <path>` 或 `HITCH_ROOT`
-修改位置。每个 root 都拥有独立的制品存储、控制器运行时存储、运行与评测
-记录、守护进程令牌和队列。
-可以通过 `HITCH_CODEX_PATH`、`HITCH_CLAUDE_PATH`、`HITCH_PI_PATH`、
-`HITCH_OPENCODE_PATH` 和 `HITCH_DEEPSEEK_PATH` 覆盖原生可执行文件路径。
-工作区模式会明确数据修改的边界：
-- `shared` 直接在源码目录中运行；
-- `worktree` 从干净的 `HEAD` 创建 detached Git worktree；
-- `copy` 创建独立的文件系统副本。
-工作区隔离并不等同于进程安全沙箱。
-## 设计原则
-- **默认可追溯：** 每次运行都会关联请求的引用、已解析版本、可运行制品、
-  执行记录与证据。
-- **不可变解析：** 在准备或执行前将可变输入解析为不可变身份，并记录该
-  身份。
-- **内容寻址复用：** 通过摘要复用经过验证的制品与控制器运行时，而不是为
-  每次运行重复复制。
-- **不以有损抽象换取证据统一：** 稳定的规范化记录与原始 Harness 输出并存，
-  并明确记录轨迹保真度。
-- **机器优先的接口：** 结构化输出、带版本的 Schema 和类型化错误构成公共
-  接口。
-- **策略位于 Hitch 之上：** 变更、排序、晋级与回滚都是调用方系统的显式
-  决策。
-- **安全中断：** 取消操作覆盖完整子进程树，涉及工作区修改的中断运行绝不
-  隐式重放。
-## 计划中的工作
-- [x] 基于 run 证据的严格模型/Harness 比较原语
-- [ ] 命名的候选与 champion 引用
-- [ ] 不内嵌晋级策略的晋级与回滚记录
-- [ ] 远端制品与证据同步
-- [ ] 更多 Harness 适配器
-- [ ] 更多 API 供应商支持
-- [ ] 本地模型推理支持
-## 动态
-- **2026-08-20：** Hitch 0.2 开发版将项目迁移到编译为 ESM 的严格
-  TypeScript，加入共享 SHA-256 控制器运行时缓存，为每次运行记录兼容 DSH
-  的规范化轨迹，并引入与生命周期绑定的消息反馈。
-- **2026-08-13：** Hitch 加入对 DeepSeek Harness 的支持。
 ## 文档
-- [Hitch 0.2 开发规范](docs/hitch-0.2-development-spec.md)
-- [设计文档](docs/design.md)
-- [智能体守护进程分析与移植](docs/daemon.md)
-- [工作区隔离](docs/workspaces.md)
+- [设计与架构](docs/design.md)
 - [Harbor 评测](docs/evals.md)
+- [工作区隔离](docs/workspaces.md)
+- [守护进程设计](docs/daemon.md)
+- [Hitch 0.2 开发规范](docs/hitch-0.2-development-spec.md)
 - [发布流程](docs/releasing.md)
-## 社区
+## 项目状态
-加入 [Hitch Discord 社区](https://discord.gg/cZ4NBbHDk)，提问、分享反馈，
-并讨论智能体 Harness 基础设施。
+Hitch 是 pre-alpha 阶段的本地版本与证据层。它是 Git 的补充，目前不提供远端
+制品注册表、分支、标签、候选晋级或回滚策略。
-## 致谢
+远端制品同步、命名候选、晋级记录和更多 Harness 适配器已列入计划。
-Hitch 的设计受到 [Multica](https://github.com/multica-ai/multica) 启发，并
-使用 [Harbor](https://github.com/harbor-framework/harbor) 作为评测后端。感谢
-这两个项目提供的基础。
+## 社区
-## 命名
+加入 [Hitch Discord 社区](https://discord.gg/cZ4NBbHDk)，提问、分享反馈，
+并讨论智能体 Harness 基础设施。
-代码仓库名为 `agent-hitch`；产品与可执行文件分别命名为 `Hitch` 和 `hitch`。
+Hitch 的设计受到 [Multica](https://github.com/multica-ai/multica) 启发，并使用
+[Harbor](https://github.com/harbor-framework/harbor) 作为评测后端。
 ## 许可证

package/dist/src/artifacts/handoff.js ADDED Viewed

@@ -0,0 +1,12 @@
+import { HitchError } from "../foundation/index.js";
+export function assertPreparedArtifactRevision(artifact, resolution) {
+    if (artifact.harness_id !== resolution.harness_id
+        || artifact.revision_identity !== resolution.identity
+        || artifact.resolved_revision?.identity !== resolution.identity) {
+        throw new HitchError("prepared artifact does not match the resolved harness revision", {
+            code: "artifact_integrity_mismatch",
+            exitCode: 5,
+        });
+    }
+}
+//# sourceMappingURL=handoff.js.map

package/dist/src/artifacts/handoff.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"handoff.js","sourceRoot":"","sources":["../../../src/artifacts/handoff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIpD,MAAM,UAAU,8BAA8B,CAC5C,QAA0B,EAC1B,UAA4B;IAE5B,IACE,QAAQ,CAAC,UAAU,KAAK,UAAU,CAAC,UAAU;WAC1C,QAAQ,CAAC,iBAAiB,KAAK,UAAU,CAAC,QAAQ;WAClD,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,KAAK,UAAU,CAAC,QAAQ,EAC/D,CAAC;QACD,MAAM,IAAI,UAAU,CAAC,gEAAgE,EAAE;YACrF,IAAI,EAAE,6BAA6B;YACnC,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/src/artifacts/index.js CHANGED Viewed

@@ -1,3 +1,5 @@
 export { listPreparedArtifacts, prepareHarness } from "./preparer.js";
+export { loadPreparedArtifact, preparedArtifactDirectory } from "./store.js";
+export { assertPreparedArtifactRevision } from "./handoff.js";
 export { resolveHarness } from "../revisions/index.js";
 //# sourceMappingURL=index.js.map

package/dist/src/artifacts/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/artifacts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;~~AAEtE~~,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/artifacts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/src/artifacts/store.js CHANGED Viewed

@@ -1,8 +1,8 @@
 import { randomBytes } from "node:crypto";
 import { constants } from "node:fs";
-import { access, rename, rm } from "node:fs/promises";
+import { access, lstat, rename, rm } from "node:fs/promises";
 import path from "node:path";
-import { SCHEMA_VERSION, atomicWriteJSON, ensureDir, readJSON, withFileLock } from "../foundation/index.js";
+import { HitchError, SCHEMA_VERSION, atomicWriteJSON, ensureDir, readJSON, statePaths, withFileLock } from "../foundation/index.js";
 import { artifactInvocation, artifactMatches } from "./integrity.js";
 const RECIPE_VERSION = "1";
 export function artifactManifest(resolved, adapter, artifactId, entrypoint, toolchain, extra = {}) {
@@ -81,6 +81,76 @@ export async function readCachedArtifact(paths, preparationKey, expectedRevision
     }
     return { ...manifest, ...artifactInvocation(manifest, directory), cache_hit: true };
 }
+export function preparedArtifactDirectory(root, artifactId) {
+    if (!/^sha256:[0-9a-f]{64}$/.test(artifactId)) {
+        throw new HitchError(`invalid artifact ID: ${artifactId}`, { code: "artifact_invalid", exitCode: 5 });
+    }
+    return path.join(statePaths(root).artifacts, artifactId.slice("sha256:".length));
+}
+/**
+ * Load an artifact handed across an isolation boundary. The caller supplies
+ * independently pinned identity and integrity values (from Harbor's job
+ * configuration); the uploaded manifest is never allowed to redefine them.
+ */
+export async function loadPreparedArtifact(directory, expected) {
+    const absolute = path.resolve(directory);
+    const info = await lstat(absolute).catch(() => null);
+    if (!info?.isDirectory() || info.isSymbolicLink()) {
+        throw new HitchError("prepared artifact handoff is not a regular directory", {
+            code: "artifact_integrity_mismatch",
+            exitCode: 5,
+        });
+    }
+    const manifestPath = path.join(absolute, "artifact.json");
+    const manifestInfo = await lstat(manifestPath).catch(() => null);
+    if (!manifestInfo?.isFile() || manifestInfo.isSymbolicLink()) {
+        throw new HitchError("prepared artifact handoff has no regular manifest", {
+            code: "artifact_integrity_mismatch",
+            exitCode: 5,
+        });
+    }
+    let manifest;
+    try {
+        manifest = await readJSON(manifestPath, null);
+    }
+    catch (error) {
+        throw new HitchError("prepared artifact manifest is unreadable", {
+            code: "artifact_integrity_mismatch",
+            exitCode: 5,
+            cause: error,
+        });
+    }
+    if (!manifest
+        || manifest.artifact_id !== expected.artifact_id
+        || manifest.artifact_integrity !== expected.artifact_integrity
+        || manifest.entrypoint_integrity !== expected.entrypoint_integrity
+        || manifest.harness_id !== expected.harness_id
+        || manifest.revision_identity !== expected.revision_identity
+        || manifest.platform !== expected.platform
+        || manifest.resolved_revision?.harness_id !== expected.harness_id
+        || manifest.resolved_revision?.identity !== expected.revision_identity) {
+        throw new HitchError("prepared artifact handoff does not match its job-pinned identity", {
+            code: "artifact_integrity_mismatch",
+            exitCode: 5,
+        });
+    }
+    const currentPlatform = `${process.platform}-${process.arch}`;
+    if (manifest.platform !== currentPlatform) {
+        throw new HitchError(`prepared artifact platform ${manifest.platform} is incompatible with ${currentPlatform}`, {
+            code: "artifact_platform_mismatch",
+            exitCode: 5,
+        });
+    }
+    if (manifest.source_type === "installed" || !await artifactMatches(absolute, manifest)) {
+        throw new HitchError("prepared artifact handoff failed content verification", {
+            code: "artifact_integrity_mismatch",
+            exitCode: 5,
+        });
+    }
+    const invocation = artifactInvocation(manifest, absolute);
+    await access(invocation.entrypoint_args[0] || invocation.executable, manifest.launcher === "node" ? constants.R_OK : constants.X_OK);
+    return { ...manifest, ...invocation, cache_hit: true };
+}
 export async function withArtifactLock(paths, key, operation, options = {}) {
     return withFileLock(paths.artifactLocks, key, operation, options);
 }

package/dist/src/artifacts/store.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/artifacts/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;~~AACtD~~,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;~~AAG5G~~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"}
1	+ {"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/artifacts/store.ts"],"names":[],"mappings":"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"}

package/dist/src/backends/harbor/backend.js CHANGED Viewed

@@ -2,11 +2,12 @@ import { spawn } from "node:child_process";
 import { createWriteStream } from "node:fs";
 import { readdir, stat } from "node:fs/promises";
 import path from "node:path";
-import { HitchError, atomicWriteJSON, consumeLines, detectVersion, ensureDir, fingerprintExecutable, invalidInput, packageRoot, readJSON, sha256JSON, terminateProcess } from "../../foundation/index.js";
+import { HitchError, atomicWriteJSON, consumeLines, detectVersion, ensureDir, fingerprintExecutable, invalidInput, packageRoot, readJSON, sha256JSON, statePaths, terminateProcess } from "../../foundation/index.js";
 import { HARBOR_CREDENTIAL_ENV, locateHarbor } from "./tools.js";
 const BRIDGE_DIRECTORY = path.join(packageRoot(), "integrations", "harbor");
-export async function runHarborBackend({ evalId, evalDirectory, request, root, resolvedRevision, runtimeDirectory, runtimeId, localTransport, env = process.env, harborExecutable, signal, emit = () => { }, }) {
+export async function runHarborBackend({ evalId, evalDirectory, request, root, resolvedRevision, runtimeDirectory, runtimeId, preparedArtifact, localTransport, env = process.env, harborExecutable, signal, emit = () => { }, }) {
     const backendDirectory = await ensureDir(path.join(evalDirectory, "harbor"));
+    const harnessArtifactCacheDirectory = await ensureDir(path.join(statePaths(root).store, "harbor-artifacts"));
     const executable = await discoverHarbor(harborExecutable, root, env);
     const version = await detectVersion(executable, ["--version"]);
     const identity = await fingerprintExecutable(executable);
@@ -20,6 +21,8 @@ export async function runHarborBackend({ evalId, evalDirectory, request, root, r
         resolvedRevision,
         runtimeDirectory,
         runtimeId,
+        preparedArtifact,
+        harnessArtifactCacheDirectory,
         localTransport,
         backendDirectory,
         jobName,
@@ -84,7 +87,7 @@ async function attachTrialResults(jobDirectory, jobResult) {
     }
     return { ...jobResult, trial_results: trialResults };
 }
-export async function buildHarborJobConfig({ evalId, request, resolvedRevision, runtimeDirectory, runtimeId, localTransport, backendDirectory, jobName = "job", env = process.env, }) {
+export async function buildHarborJobConfig({ evalId, request, resolvedRevision, runtimeDirectory, runtimeId, preparedArtifact, harnessArtifactCacheDirectory, localTransport, backendDirectory, jobName = "job", env = process.env, }) {
     const timeoutSeconds = request.timeout_ms > 0 ? Math.ceil(request.timeout_ms / 1_000) : null;
     const setupTimeoutSeconds = request.setup_timeout_ms > 0 ? Math.ceil(request.setup_timeout_ms / 1_000) : null;
     const agent = {
@@ -110,6 +113,22 @@ export async function buildHarborJobConfig({ evalId, request, resolvedRevision,
             // (spec §4.2); `runtime_id` records the exact execution payload.
             hitch_runtime_dir: runtimeDirectory,
             ...(runtimeId ? { controller_runtime_id: runtimeId } : {}),
+            ...(harnessArtifactCacheDirectory ? { harness_artifact_cache_dir: harnessArtifactCacheDirectory } : {}),
+            ...(preparedArtifact ? {
+                harness_artifact: {
+                    directory: preparedArtifact.directory,
+                    artifact_id: preparedArtifact.artifact_id,
+                    artifact_integrity: preparedArtifact.artifact_integrity,
+                    entrypoint_integrity: preparedArtifact.entrypoint_integrity,
+                    harness_id: preparedArtifact.harness_id,
+                    revision_identity: preparedArtifact.revision_identity,
+                    adapter_version: preparedArtifact.adapter_version,
+                    recipe_version: preparedArtifact.recipe_version,
+                    platform: preparedArtifact.platform,
+                    node_version: preparedArtifact.node_version,
+                    source_type: preparedArtifact.source_type,
+                },
+            } : {}),
             ...(localTransport ? {
                 local_source_transport: {
                     kind: localTransport.manifest.kind,