@osfactory/har 1.4.0 → 1.5.0

package/dist/index.js

@@ -59049,10 +59049,12 @@ var require_run_async = __commonJS({
 // src/core/otel-hooks.ts
 var otel_hooks_exports = {};
 __export(otel_hooks_exports, {
+  HOOK_TIMEOUT_SECONDS: () => HOOK_TIMEOUT_SECONDS,
   LEGACY_CURSOR_ONLY_HOOK_EVENTS: () => LEGACY_CURSOR_ONLY_HOOK_EVENTS,
   OTEL_HOOKS_AGENTS: () => OTEL_HOOKS_AGENTS,
   OTEL_HOOKS_PACKAGE: () => OTEL_HOOKS_PACKAGE,
   OTEL_HOOKS_PROVIDERS: () => OTEL_HOOKS_PROVIDERS,
+  buildOtelHookSetupArgs: () => buildOtelHookSetupArgs,
   buildOtelHooksConfig: () => buildOtelHooksConfig,
   disableOtelHooksExport: () => disableOtelHooksExport,
   ensureOtelHooks: () => ensureOtelHooks,
@@ -59158,11 +59160,22 @@ function writeOtelHooksWrapper(otelHookCommand, hooksHome = getOtelHooksHome())
   const stateDir = getOtelHooksStateDir(hooksHome);
   const script = `#!/usr/bin/env bash
 # Managed by har telemetry \u2014 invokes @osfactory/otel-hook with HAR config.
-set -euo pipefail
-exec "${otelHookCommand}" run \\
+#
+# Two rules for this wrapper (#328):
+#   1. Bounded. Export and flush budgets keep it well inside the per-hook
+#      timeout the agent enforces, so an unreachable Mission Control costs
+#      milliseconds instead of stalling the session.
+#   2. Silent about its own failures. Dropped telemetry must never fail an
+#      agent turn, so the exit status is always 0 \u2014 a non-zero hook exit can
+#      block a tool call.
+set -uo pipefail
+"${otelHookCommand}" run \\
   --config-file "${configPath}" \\
   --state-dir "${stateDir}" \\
-  "$@"
+  --timeout-ms ${HOOK_EXPORT_TIMEOUT_MS} \\
+  --flush-timeout-ms ${HOOK_FLUSH_TIMEOUT_MS} \\
+  "$@" || true
+exit 0
 `;
   fs68.writeFileSync(wrapperPath, script, { mode: 493 });
   try {
@@ -59255,23 +59268,30 @@ function isOtelHookCommand(command2, wrapperPath) {
 function normalizeLegacyProviderFlagsInCommand(command2) {
   return command2.replace(/(^|\s)--cursor(?=\s|$)/g, "$1--provider cursor").replace(/(^|\s)--claude(?=\s|$)/g, "$1--provider claude-code").replace(/(^|\s)--codex(?=\s|$)/g, "$1--provider codex");
 }
+function buildOtelHookSetupArgs(providerId, hookCommand) {
+  return [
+    "setup",
+    "--provider",
+    providerId,
+    "--scope",
+    "global",
+    "--hook-command",
+    hookCommand,
+    "--managed-marker",
+    "otel-hook",
+    // Written into each generated hook entry so the agent bounds it (#328).
+    // Without this the agent falls back to its own default and an unreachable
+    // collector stalls the session before its first model request.
+    "--timeout-seconds",
+    String(HOOK_TIMEOUT_SECONDS)
+  ];
+}
 function runSetupProvider(providerId, otelHookCommand, wrapperPath) {
   const hookCommand = `${wrapperPath} --provider ${providerId}`;
-  const result = (0, import_child_process19.spawnSync)(
-    otelHookCommand,
-    [
-      "setup",
-      "--provider",
-      providerId,
-      "--scope",
-      "global",
-      "--hook-command",
-      hookCommand,
-      "--managed-marker",
-      "otel-hook"
-    ],
-    { encoding: "utf8", timeout: 6e4 }
-  );
+  const result = (0, import_child_process19.spawnSync)(otelHookCommand, buildOtelHookSetupArgs(providerId, hookCommand), {
+    encoding: "utf8",
+    timeout: 6e4
+  });
   if (result.status === 0) {
     return { ok: true, detail: `setup --provider ${providerId}` };
   }
@@ -59498,7 +59518,7 @@ function ensureOtelHooks(options) {
 function disableOtelHooksExport() {
   return writeOtelHooksConfig(buildOtelHooksConfig({ enabled: false }));
 }
-var import_child_process19, fs68, os22, path76, OTEL_HOOKS_PACKAGE, OTEL_HOOKS_PROVIDERS, OTEL_HOOKS_AGENTS, LEGACY_CURSOR_ONLY_HOOK_EVENTS;
+var import_child_process19, fs68, os22, path76, OTEL_HOOKS_PACKAGE, HOOK_TIMEOUT_SECONDS, HOOK_EXPORT_TIMEOUT_MS, HOOK_FLUSH_TIMEOUT_MS, OTEL_HOOKS_PROVIDERS, OTEL_HOOKS_AGENTS, LEGACY_CURSOR_ONLY_HOOK_EVENTS;
 var init_otel_hooks = __esm({
   "src/core/otel-hooks.ts"() {
     "use strict";
@@ -59509,6 +59529,9 @@ var init_otel_hooks = __esm({
     init_control_config();
     init_telemetry_config();
     OTEL_HOOKS_PACKAGE = "@osfactory/otel-hook@0.2.0";
+    HOOK_TIMEOUT_SECONDS = 10;
+    HOOK_EXPORT_TIMEOUT_MS = 1500;
+    HOOK_FLUSH_TIMEOUT_MS = 500;
     OTEL_HOOKS_PROVIDERS = [
       { id: "cursor", label: "cursor" },
       { id: "claude-code", label: "claude" },
@@ -92517,6 +92540,12 @@ async function handleStatus3(argv) {
   info(`Mission Control: ${apiUrl} (${reachable ? "reachable" : "not reachable"})`);
   info(`OTLP endpoint: ${payload.otelEndpoint}`);
   info(`Hooks home:    ${payload.otelHooksHome}`);
+  if (enabled && !reachable) {
+    warn(
+      "Agent hooks are installed but Mission Control is not reachable \u2014 each turn pays the export timeout for telemetry nobody receives."
+    );
+    info("Start it with: har control up   \u2022   or stop exporting: har telemetry off");
+  }
   printSignals();
 }
 async function handleOn(argv) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osfactory/har",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "HAR: open agent harness CLI and MCP server for coding agents, isolated worktrees, and software-factory workflows",
   "keywords": [
     "har",