@@ -1,9 +1,12 @@
11 from __future__ import annotations
22
3+import json
34 import shlex
5+import shutil
46 import subprocess
57 from pathlib import Path
68 from tempfile import TemporaryDirectory
9+from typing import Any
710
811 from harbor.agents.installed.base import BaseInstalledAgent, with_prompt_template
912 from harbor.environments.base import BaseEnvironment
@@ -14,6 +17,11 @@ from harbor.models.trial.paths import EnvironmentPaths
1417 class LocalMiniCoderAgent(BaseInstalledAgent):
1518 """Harbor installed-agent wrapper for this local mini-coder checkout."""
1619
20+ _JSON_LOG_FILENAME = "mini-coder.json"
21+ _STDERR_LOG_FILENAME = "mini-coder.stderr.txt"
22+ _PACKAGE_PATHS = ("bin/mc.ts", "src")
23+ _PACKAGE_MANIFEST_KEYS = ("name", "version", "type", "bin", "dependencies")
24+
1725 def __init__(self, *args, version: str = "local", **kwargs):
1826 super().__init__(*args, version=version, **kwargs)
1927 self._host_repo_root = Path(__file__).resolve().parents[1]
@@ -35,7 +43,112 @@ class LocalMiniCoderAgent(BaseInstalledAgent):
3543 await self._install_global_package(environment, container_tarball_path)
3644
3745 def populate_context_post_run(self, context: AgentContext) -> None:
38- del context
46+ output_path = self.logs_dir / self._JSON_LOG_FILENAME
47+ stderr_path = self.logs_dir / self._STDERR_LOG_FILENAME
48+ metadata: dict[str, Any] = {
49+ "json_log_path": str(output_path),
50+ "stderr_log_path": str(stderr_path),
51+ }
52+
53+ if stderr_path.is_file():
54+ stderr_text = stderr_path.read_text(
55+ encoding="utf-8", errors="replace"
56+ ).strip()
57+ if stderr_text:
58+ metadata["stderr_excerpt"] = self._truncate_metadata_text(stderr_text)
59+
60+ try:
61+ with output_path.open(encoding="utf-8") as handle:
62+ result = json.load(handle)
63+ except FileNotFoundError:
64+ metadata["parse_error"] = f"Missing mini-coder JSON log: {output_path}"
65+ self._merge_context_metadata(context, metadata)
66+ return
67+ except json.JSONDecodeError as exc:
68+ metadata["parse_error"] = f"Invalid mini-coder JSON log: {exc}"
69+ metadata["stdout_excerpt"] = self._read_text_excerpt(output_path)
70+ self._merge_context_metadata(context, metadata)
71+ return
72+ except OSError as exc:
73+ metadata["parse_error"] = f"Failed to read mini-coder JSON log: {exc}"
74+ self._merge_context_metadata(context, metadata)
75+ return
76+
77+ if not isinstance(result, dict):
78+ metadata["parse_error"] = "mini-coder JSON log was not an object"
79+ self._merge_context_metadata(context, metadata)
80+ return
81+
82+ usage = result.get("usage")
83+ usage_data = usage if isinstance(usage, dict) else {}
84+
85+ context.n_input_tokens = self._optional_int(usage_data.get("input"))
86+ context.n_output_tokens = self._optional_int(usage_data.get("output"))
87+
88+ cache_read = self._optional_int(usage_data.get("cacheRead"))
89+ cache_write = self._optional_int(usage_data.get("cacheWrite"))
90+ if cache_read is not None or cache_write is not None:
91+ context.n_cache_tokens = (cache_read or 0) + (cache_write or 0)
92+
93+ cost = usage_data.get("cost")
94+ if isinstance(cost, dict):
95+ context.cost_usd = self._optional_float(cost.get("total"))
96+
97+ for source_key, metadata_key in (
98+ ("api", "api"),
99+ ("provider", "provider"),
100+ ("model", "model"),
101+ ("responseId", "response_id"),
102+ ("stopReason", "stop_reason"),
103+ ("errorMessage", "error_message"),
104+ ):
105+ value = result.get(source_key)
106+ if isinstance(value, str) and value:
107+ metadata[metadata_key] = value
108+
109+ if usage:
110+ metadata["usage"] = usage
111+
112+ self._merge_context_metadata(context, metadata)
113+
114+ @staticmethod
115+ def _optional_int(value: Any) -> int | None:
116+ if isinstance(value, bool):
117+ return None
118+ if isinstance(value, int):
119+ return value
120+ if isinstance(value, float) and value.is_integer():
121+ return int(value)
122+ return None
123+
124+ @staticmethod
125+ def _optional_float(value: Any) -> float | None:
126+ if isinstance(value, bool):
127+ return None
128+ if isinstance(value, (int, float)):
129+ return float(value)
130+ return None
131+
132+ @staticmethod
133+ def _truncate_metadata_text(text: str, max_chars: int = 4000) -> str:
134+ if len(text) <= max_chars:
135+ return text
136+ return text[:max_chars] + " ... [truncated]"
137+
138+ def _read_text_excerpt(self, path: Path) -> str:
139+ try:
140+ return self._truncate_metadata_text(
141+ path.read_text(encoding="utf-8", errors="replace").strip()
142+ )
143+ except OSError as exc:
144+ return f"<failed to read {path}: {exc}>"
145+
146+ @staticmethod
147+ def _merge_context_metadata(
148+ context: AgentContext, metadata: dict[str, Any]
149+ ) -> None:
150+ existing = context.metadata or {}
151+ context.metadata = {**existing, **metadata}
39152
40153 def _require_host_checkout(self) -> None:
41154 missing = [
@@ -61,7 +174,9 @@ class LocalMiniCoderAgent(BaseInstalledAgent):
61174
62175 def _package_local_checkout(self, target_dir: Path) -> Path:
63176 target_dir.mkdir(parents=True, exist_ok=True)
177+ package_root = target_dir / "mini-coder-package"
64178 tarball_path = target_dir / "mini-coder-local.tgz"
179+ self._stage_minimal_package(package_root)
65180
66181 try:
67182 result = subprocess.run(
@@ -73,7 +188,7 @@ class LocalMiniCoderAgent(BaseInstalledAgent):
73188 "--filename",
74189 str(tarball_path),
75190 ],
76- cwd=self._host_repo_root,
191+ cwd=package_root,
77192 capture_output=True,
78193 text=True,
79194 check=False,
@@ -89,6 +204,48 @@ class LocalMiniCoderAgent(BaseInstalledAgent):
89204
90205 return tarball_path
91206
207+ def _stage_minimal_package(self, package_root: Path) -> None:
208+ if package_root.exists():
209+ shutil.rmtree(package_root)
210+ package_root.mkdir(parents=True)
211+
212+ package_manifest = self._minimal_package_manifest()
213+ (package_root / "package.json").write_text(
214+ json.dumps(package_manifest, indent=2) + "\n", encoding="utf-8"
215+ )
216+
217+ for relative_path in self._PACKAGE_PATHS:
218+ source_path = self._host_repo_root / relative_path
219+ target_path = package_root / relative_path
220+ if source_path.is_dir():
221+ shutil.copytree(source_path, target_path)
222+ else:
223+ target_path.parent.mkdir(parents=True, exist_ok=True)
224+ shutil.copy2(source_path, target_path)
225+
226+ def _minimal_package_manifest(self) -> dict[str, Any]:
227+ manifest_path = self._host_repo_root / "package.json"
228+ source_manifest = json.loads(manifest_path.read_text(encoding="utf-8"))
229+ if not isinstance(source_manifest, dict):
230+ raise RuntimeError(f"Invalid package manifest at {manifest_path}")
231+
232+ package_manifest = {
233+ key: source_manifest[key]
234+ for key in self._PACKAGE_MANIFEST_KEYS
235+ if key in source_manifest
236+ }
237+ missing = [
238+ key
239+ for key in ("name", "version", "type", "bin")
240+ if key not in package_manifest
241+ ]
242+ if missing:
243+ raise RuntimeError(
244+ f"Missing required package manifest keys: {', '.join(missing)}"
245+ )
246+
247+ return package_manifest
248+
92249 async def _install_system_dependencies(self, environment: BaseEnvironment) -> None:
93250 await self.exec_as_root(
94251 environment,
@@ -122,8 +279,8 @@ class LocalMiniCoderAgent(BaseInstalledAgent):
122279 environment,
123280 command=(
124281 "export PATH=\"$HOME/.bun/bin:$PATH\"; "
125- f"bun add -g --ignore-scripts {shlex.quote(package_spec)}; "
126- "test -x ~/.bun/bin/mc || command -v mc >/dev/null"
282+ f"bun add -g --ignore-scripts {shlex.quote(package_spec)} && "
283+ "test -x ~/.bun/bin/mc"
127284 ),
128285 )
129286
@@ -134,7 +291,9 @@ class LocalMiniCoderAgent(BaseInstalledAgent):
134291 raise RuntimeError("Failed to determine the agent home directory")
135292
136293 config_dir = f"{home_dir}/.config/mini-coder"
137- await self.exec_as_agent(environment, command=f"mkdir -p {shlex.quote(config_dir)}")
294+ await self.exec_as_agent(
295+ environment, command=f"mkdir -p {shlex.quote(config_dir)}"
296+ )
138297 return config_dir
139298
140299 async def _upload_host_auth(
@@ -164,8 +323,12 @@ class LocalMiniCoderAgent(BaseInstalledAgent):
164323 config_dir = await self._container_config_dir(environment)
165324 await self._upload_host_auth(environment, config_dir)
166325
167- stdout_path = (EnvironmentPaths.agent_dir / "mini-coder.json").as_posix()
168- stderr_path = (EnvironmentPaths.agent_dir / "mini-coder.stderr.txt").as_posix()
326+ stdout_path = (
327+ EnvironmentPaths.agent_dir / self._JSON_LOG_FILENAME
328+ ).as_posix()
329+ stderr_path = (
330+ EnvironmentPaths.agent_dir / self._STDERR_LOG_FILENAME
331+ ).as_posix()
169332 await self.exec_as_agent(
170333 environment,
171334 command=(