@companyhelm/runner 0.1.1 → 0.2.0

package/dist/templates/system_prompts/dedicated_workspace.md.j2

@@ -0,0 +1,5 @@
+## Dedicated Workspace
+
+- This runtime is using a dedicated per-thread host workspace mounted at `/workspace`.
+- Files in `/workspace` are isolated to this thread workspace lifecycle.
+- The runner may remove the host workspace when the thread is deleted.

package/dist/templates/system_prompts/shared_workspace.md.j2

@@ -0,0 +1,6 @@
+## Shared Workspace
+
+- This runtime is using a shared host workspace mounted directly at `/workspace`.
+- Changes made in `/workspace` may be visible to multiple threads that use the same runner workspace path.
+- Do not assume `/workspace` is isolated per thread.
+- you need to use git worktrees to isolate your working directory from the shared workspace.

package/dist/testing/vitest_reporter.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VitestReporterResolver = void 0;
+class VitestReporterResolver {
+    constructor(options) {
+        this.stdoutIsTTY = options.stdoutIsTTY;
+        this.env = options.env ?? process.env;
+    }
+    resolve() {
+        const configured = this.env.COMPANYHELM_VITEST_REPORTER?.trim();
+        if (configured && configured.length > 0) {
+            return configured
+                .split(",")
+                .map((value) => value.trim())
+                .filter((value) => value.length > 0);
+        }
+        if (this.stdoutIsTTY) {
+            return ["basic"];
+        }
+        return undefined;
+    }
+}
+exports.VitestReporterResolver = VitestReporterResolver;

package/dist/utils/daemon_startup_watchdog.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DaemonStartupWatchdog = void 0;
+class DaemonStartupWatchdog {
+    constructor(timeoutMs, onTimeout) {
+        this.timeoutMs = timeoutMs;
+        this.onTimeout = onTimeout;
+        this.bump();
+    }
+    bump() {
+        if (this.timer) {
+            clearTimeout(this.timer);
+        }
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            this.onTimeout();
+        }, this.timeoutMs);
+    }
+    finish() {
+        if (!this.timer) {
+            return;
+        }
+        clearTimeout(this.timer);
+        this.timer = undefined;
+    }
+}
+exports.DaemonStartupWatchdog = DaemonStartupWatchdog;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@companyhelm/runner",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Run the CompanyHelm runner in fully isolated Docker sandboxes.",
   "license": "MIT",
   "repository": {
@@ -32,7 +32,7 @@
   "dependencies": {
     "@bufbuild/protobuf": "^2.11.0",
     "@clack/prompts": "^1.0.1",
-    "@companyhelm/protos": "^0.5.20",
+    "@companyhelm/protos": "^0.5.26",
     "@grpc/grpc-js": "^1.14.3",
     "@libsql/client": "^0.17.0",
     "commander": "^14.0.0",

package/dist/service/workspace_agents.js

@@ -1,82 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderRuntimeAgentsMd = renderRuntimeAgentsMd;
-exports.ensureWorkspaceAgentsMd = ensureWorkspaceAgentsMd;
-const node_fs_1 = require("node:fs");
-const node_path_1 = require("node:path");
-const RUNTIME_AGENTS_TEMPLATE_PATH = "templates/runtime_agents.md.j2";
-const DEFAULT_HOME_DIRECTORY = "/home/agent";
-function renderJinjaTemplate(template, context) {
-    return template.replace(/{{\s*([a-zA-Z0-9_]+)\s*}}/g, (_match, key) => {
-        const value = context[key];
-        if (value === undefined) {
-            throw new Error(`Missing template value for key '${key}'`);
-        }
-        return value;
-    });
-}
-function resolveTemplatePath() {
-    const distRelativePath = (0, node_path_1.join)(__dirname, "..", RUNTIME_AGENTS_TEMPLATE_PATH);
-    if ((0, node_fs_1.existsSync)(distRelativePath)) {
-        return distRelativePath;
-    }
-    const sourceRelativePath = (0, node_path_1.join)(__dirname, "..", "..", "src", RUNTIME_AGENTS_TEMPLATE_PATH);
-    if ((0, node_fs_1.existsSync)(sourceRelativePath)) {
-        return sourceRelativePath;
-    }
-    throw new Error(`Runtime AGENTS template was not found at ${distRelativePath} or ${sourceRelativePath}`);
-}
-function extractTopLevelSections(markdown) {
-    const sections = [];
-    const headingRegex = /^## .+$/gm;
-    const matches = [...markdown.matchAll(headingRegex)];
-    for (let index = 0; index < matches.length; index += 1) {
-        const match = matches[index];
-        const marker = match[0].trim();
-        const start = match.index ?? 0;
-        const end = index + 1 < matches.length ? (matches[index + 1].index ?? markdown.length) : markdown.length;
-        const content = markdown.slice(start, end).trimEnd();
-        sections.push({ marker, content });
-    }
-    return sections;
-}
-function renderRuntimeAgentsMd(homeDirectory = DEFAULT_HOME_DIRECTORY) {
-    const template = (0, node_fs_1.readFileSync)(resolveTemplatePath(), "utf8");
-    return renderJinjaTemplate(template, {
-        home_directory: homeDirectory,
-    }).trim() + "\n";
-}
-function ensureWorkspaceAgentsMd(workspaceDirectory, homeDirectory = DEFAULT_HOME_DIRECTORY) {
-    (0, node_fs_1.mkdirSync)(workspaceDirectory, { recursive: true });
-    const agentsPath = (0, node_path_1.join)(workspaceDirectory, "AGENTS.md");
-    let existing = "";
-    try {
-        existing = (0, node_fs_1.readFileSync)(agentsPath, "utf8");
-    }
-    catch {
-        existing = "";
-    }
-    let rendered = "";
-    try {
-        rendered = renderRuntimeAgentsMd(homeDirectory);
-    }
-    catch {
-        return;
-    }
-    const templateSections = extractTopLevelSections(rendered);
-    const pendingSections = templateSections
-        .filter((section) => !existing.includes(section.marker))
-        .map((section) => section.content);
-    if (pendingSections.length === 0) {
-        return;
-    }
-    const updated = existing.trim()
-        ? `${existing.trimEnd()}\n\n${pendingSections.join("\n\n")}\n`
-        : rendered;
-    try {
-        (0, node_fs_1.writeFileSync)(agentsPath, updated, "utf8");
-    }
-    catch {
-        // Best-effort workspace instruction file.
-    }
-}

package/dist/templates/runtime_agents.md.j2

@@ -1,50 +0,0 @@
-# Agent Instructions
-
-## Workspace Structure
-
-- You are running in a thread-specific container and workspace
-- This workspace is not initialized as a Git repository by default. Repositories should live in a subdirectory of the workspace.
-
-## Docker
-
-Docker is available, the docker host runs in a separate container. The network is shared with container.
-- only the `/workspace` is shared with the docker host
-- `{{home_directory}}/.codex/auth.json` is also shared with the docker host
-- Nested DinD is not supported in this environment because the outer runtime already uses rootless DinD.
-- If you need to use Docker in Docker you can mount the docker socket in the container and use this environment DinD to run containers within containers.
-
-## GitHub Installations
-
-- Synced GitHub installation credentials are written to `/workspace/.companyhelm/installations.json`.
-- Use `list-installations` to inspect installation IDs, repository scopes, tokens, and expiration timestamps.
-- Use `gh-use-installation <installation-id>` to configure `gh` authentication for a specific installation.
-
-```bash
-# Inspect synced installation credentials
-list-installations
-
-# Configure gh to use installation 112331765
-gh-use-installation 112331765
-
-# Verify gh is authenticated for github.com
-gh auth status --hostname github.com
-```
-
-## Available CLI Tools
-
-- `list-installations`: list synced GitHub installations with repositories, access tokens, and expirations.
-- `gh-use-installation <installation-id>`: configure `gh` authentication for a selected GitHub installation token.
-- `aws`: AWS CLI is pre-installed and available in `PATH`.
-- For scripted PR creation/updates, always use `gh pr create --body-file <path>` and `gh pr edit --body-file <path>` instead of inline `--body` to avoid shell interpolation of markdown backticks.
-- DO NOT INSTALL PLAYWRIGHT IN THE RUNTIME IMAGE. Playwright CLI is already installed and available for browser automation tasks with Chromium pre-installed: `playwright open --browser=chromium ...`
-
-## CompanyHelm Agent CLI
-
-- `companyhelm-agent` is pre-installed in the runtime image.
-- Thread bootstrap writes `{{home_directory}}/.config/companyhelm-agent-cli/config.json` with:
-  - `agent_api_url`: localhost targets are rewritten to `host.docker.internal` (for example `http://host.docker.internal:<port>`) for Docker-to-host access.
-  - `token`: sourced from the thread secret.
-- Example commands:
-  - `companyhelm-agent task get --task-id <id>`
-  - `companyhelm-agent task dependencies --task-id <id>`
-  - `companyhelm-agent task update-status --task-id <id> --status <draft|pending|in_progress|completed>`