@automaton-labs/aib 0.0.7 → 0.0.8

package/dist/tracing/config.js

@@ -1,2 +1,192 @@
-"use strict";var D=exports&&exports.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.resolveTraceConfig=d,exports.runTraceCommand=I;const i=D(require("node:fs")),o=D(require("node:path")),p=require("node:crypto"),s=require("../config/env-vars"),E=require("../config/product-storage"),v=require("../config/workspace-root"),T=require("../observability/config"),u=require("../shared/errors"),y="trace.json",h="trace";function d(e,r={}){const a=C(e),t=f(r.flagTraceDir);if(t)return g(e,a,"flag",t,"cwd");const n=process.env[s.CLI_ENV.trace]?.trim().toLowerCase();if(n&&["0","false","off","disabled","no"].includes(n))return{enabled:!1,source:"disabled",configPath:a,envVar:s.CLI_ENV.trace};const c=f(r.envTraceDir);if(c)return g(e,a,"env",c,"cwd");const l=f(A(a)?.traceDir);if(l)return g(e,a,"user",l,"product");if((0,T.resolveObservabilityConfig)().trace!=="off"){const b=(0,T.defaultTraceWorkspaceDir)(e);return{enabled:!0,source:"default",traceDir:b,absoluteTraceDir:b,configPath:a,envVar:s.CLI_ENV.trace}}return{enabled:!1,source:"none",configPath:a,envVar:s.CLI_ENV.traceDir}}function I(e,r,a){const t=r[0]??"status";if(t==="status")return{ok:!0,command:"trace",action:"status",trace:_(a)};if(t==="set"){const n=f(r[1]);if(!n)throw new u.CliError("TRACE_DIR_REQUIRED","Expected a trace directory after: aib trace set <dir>.",{examples:["aib trace set traces","aib --cwd D:\\dev\\project trace set traces"]});const c=N(e,n),l=d(e);return{ok:!0,command:"trace",action:"set",trace:_(l),configPath:c}}if(t==="clear"){const n=S(e),c=d(e);return{ok:!0,command:"trace",action:"clear",trace:_(c),configPath:n,note:"Cleared the persistent trace setting only. Existing trace files were not deleted."}}throw new u.CliError("UNKNOWN_TRACE_COMMAND",`Unknown aib trace command: ${t}`,{availableCommands:["status","set","clear"]})}function _(e){const r={enabled:e.enabled,source:e.source,configPath:e.configPath,envVar:e.envVar};return e.traceDir!==void 0&&(r.traceDir=e.traceDir),e.absoluteTraceDir!==void 0&&(r.absoluteTraceDir=e.absoluteTraceDir),r}function N(e,r){const a=C(e);i.default.mkdirSync(o.default.dirname(a),{recursive:!0});const t={traceDir:r,updatedAt:new Date().toISOString()};return i.default.writeFileSync(a,`${JSON.stringify(t,null,2)}
-`,"utf8"),a}function S(e){const r=C(e);return i.default.existsSync(r)&&i.default.unlinkSync(r),r}function A(e){if(!i.default.existsSync(e))return null;let r;try{r=JSON.parse(i.default.readFileSync(e,"utf8"))}catch(n){throw new u.CliError("TRACE_CONFIG_INVALID","Project trace config is invalid JSON.",{configPath:e,reason:n instanceof Error?n.message:String(n)})}if(!r||typeof r!="object"||Array.isArray(r))throw new u.CliError("TRACE_CONFIG_INVALID","Project trace config must be a JSON object.",{configPath:e});const t=f(r.traceDir);return t?{traceDir:t}:{}}function g(e,r,a,t,n){const c=o.default.resolve(o.default.isAbsolute(t)?t:n==="product"?o.default.join(m(e),t):o.default.join(e,t));return{enabled:!0,source:a,traceDir:t,absoluteTraceDir:c,configPath:r,envVar:s.CLI_ENV.traceDir}}function C(e){return o.default.join(m(e),y)}function m(e){let r=o.default.resolve(e);try{r=(0,v.resolveWorkspaceRoot)(e)?.root??r}catch(n){if(!(n instanceof u.CliError&&n.code==="AIB_CONFIG_INVALID"))throw n}const a=o.default.basename(r).replace(/[^A-Za-z0-9._-]/g,"-")||"workspace",t=(0,p.createHash)("sha1").update(o.default.resolve(r).toLowerCase()).digest("hex").slice(0,12);return o.default.join((0,E.productStorageRoot)(),h,"workspaces",`${a}-${t}`)}function f(e){return typeof e=="string"&&e.trim()!==""?e.trim():null}
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTraceConfig = resolveTraceConfig;
+exports.runTraceCommand = runTraceCommand;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const env_vars_1 = require("../config/env-vars");
+const product_storage_1 = require("../config/product-storage");
+const workspace_root_1 = require("../config/workspace-root");
+const config_1 = require("../observability/config");
+const errors_1 = require("../shared/errors");
+const TRACE_CONFIG_FILE = "trace.json";
+const TRACE_STORAGE_DIR = "trace";
+function resolveTraceConfig(cwd, options = {}) {
+    const configPath = getTraceConfigPath(cwd);
+    const flagTraceDir = readNonEmptyString(options.flagTraceDir);
+    if (flagTraceDir) {
+        return buildEnabledResolution(cwd, configPath, "flag", flagTraceDir, "cwd");
+    }
+    const traceToggle = process.env[env_vars_1.CLI_ENV.trace]?.trim().toLowerCase();
+    if (traceToggle && ["0", "false", "off", "disabled", "no"].includes(traceToggle)) {
+        return {
+            enabled: false,
+            source: "disabled",
+            configPath,
+            envVar: env_vars_1.CLI_ENV.trace
+        };
+    }
+    const envTraceDir = readNonEmptyString(options.envTraceDir);
+    if (envTraceDir) {
+        return buildEnabledResolution(cwd, configPath, "env", envTraceDir, "cwd");
+    }
+    const storedTraceDir = readNonEmptyString(readStoredTraceConfig(configPath)?.traceDir);
+    if (storedTraceDir) {
+        return buildEnabledResolution(cwd, configPath, "user", storedTraceDir, "product");
+    }
+    if ((0, config_1.resolveObservabilityConfig)().trace !== "off") {
+        const absoluteTraceDir = (0, config_1.defaultTraceWorkspaceDir)(cwd);
+        return {
+            enabled: true,
+            source: "default",
+            traceDir: absoluteTraceDir,
+            absoluteTraceDir,
+            configPath,
+            envVar: env_vars_1.CLI_ENV.trace
+        };
+    }
+    return {
+        enabled: false,
+        source: "none",
+        configPath,
+        envVar: env_vars_1.CLI_ENV.traceDir
+    };
+}
+function runTraceCommand(cwd, args, resolution) {
+    const subcommand = args[0] ?? "status";
+    if (subcommand === "status") {
+        return {
+            ok: true,
+            command: "trace",
+            action: "status",
+            trace: traceStatusPayload(resolution)
+        };
+    }
+    if (subcommand === "set") {
+        const traceDir = readNonEmptyString(args[1]);
+        if (!traceDir) {
+            throw new errors_1.CliError("TRACE_DIR_REQUIRED", "Expected a trace directory after: aib trace set <dir>.", {
+                examples: [
+                    "aib trace set traces",
+                    "aib --cwd D:\\dev\\project trace set traces"
+                ]
+            });
+        }
+        const configPath = writeTraceConfig(cwd, traceDir);
+        const nextResolution = resolveTraceConfig(cwd);
+        return {
+            ok: true,
+            command: "trace",
+            action: "set",
+            trace: traceStatusPayload(nextResolution),
+            configPath
+        };
+    }
+    if (subcommand === "clear") {
+        const configPath = clearTraceConfig(cwd);
+        const nextResolution = resolveTraceConfig(cwd);
+        return {
+            ok: true,
+            command: "trace",
+            action: "clear",
+            trace: traceStatusPayload(nextResolution),
+            configPath,
+            note: "Cleared the persistent trace setting only. Existing trace files were not deleted."
+        };
+    }
+    throw new errors_1.CliError("UNKNOWN_TRACE_COMMAND", `Unknown aib trace command: ${subcommand}`, {
+        availableCommands: ["status", "set", "clear"]
+    });
+}
+function traceStatusPayload(resolution) {
+    const payload = {
+        enabled: resolution.enabled,
+        source: resolution.source,
+        configPath: resolution.configPath,
+        envVar: resolution.envVar
+    };
+    if (resolution.traceDir !== undefined) {
+        payload.traceDir = resolution.traceDir;
+    }
+    if (resolution.absoluteTraceDir !== undefined) {
+        payload.absoluteTraceDir = resolution.absoluteTraceDir;
+    }
+    return payload;
+}
+function writeTraceConfig(cwd, traceDir) {
+    const configPath = getTraceConfigPath(cwd);
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(configPath), { recursive: true });
+    const config = {
+        traceDir,
+        updatedAt: new Date().toISOString()
+    };
+    node_fs_1.default.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+    return configPath;
+}
+function clearTraceConfig(cwd) {
+    const configPath = getTraceConfigPath(cwd);
+    if (node_fs_1.default.existsSync(configPath)) {
+        node_fs_1.default.unlinkSync(configPath);
+    }
+    return configPath;
+}
+function readStoredTraceConfig(configPath) {
+    if (!node_fs_1.default.existsSync(configPath)) {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(node_fs_1.default.readFileSync(configPath, "utf8"));
+    }
+    catch (error) {
+        throw new errors_1.CliError("TRACE_CONFIG_INVALID", "Project trace config is invalid JSON.", {
+            configPath,
+            reason: error instanceof Error ? error.message : String(error)
+        });
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new errors_1.CliError("TRACE_CONFIG_INVALID", "Project trace config must be a JSON object.", { configPath });
+    }
+    const config = parsed;
+    const traceDir = readNonEmptyString(config.traceDir);
+    return traceDir ? { traceDir } : {};
+}
+function buildEnabledResolution(cwd, configPath, source, traceDir, relativeBase) {
+    const absoluteTraceDir = node_path_1.default.resolve(node_path_1.default.isAbsolute(traceDir)
+        ? traceDir
+        : relativeBase === "product"
+            ? node_path_1.default.join(getTraceWorkspaceDir(cwd), traceDir)
+            : node_path_1.default.join(cwd, traceDir));
+    return {
+        enabled: true,
+        source,
+        traceDir,
+        absoluteTraceDir,
+        configPath,
+        envVar: env_vars_1.CLI_ENV.traceDir
+    };
+}
+function getTraceConfigPath(cwd) {
+    return node_path_1.default.join(getTraceWorkspaceDir(cwd), TRACE_CONFIG_FILE);
+}
+function getTraceWorkspaceDir(cwd) {
+    let identity = node_path_1.default.resolve(cwd);
+    try {
+        identity = (0, workspace_root_1.resolveWorkspaceRoot)(cwd)?.root ?? identity;
+    }
+    catch (error) {
+        if (!(error instanceof errors_1.CliError && error.code === "AIB_CONFIG_INVALID")) {
+            throw error;
+        }
+    }
+    const name = node_path_1.default.basename(identity).replace(/[^A-Za-z0-9._-]/g, "-") || "workspace";
+    const hash = (0, node_crypto_1.createHash)("sha1").update(node_path_1.default.resolve(identity).toLowerCase()).digest("hex").slice(0, 12);
+    return node_path_1.default.join((0, product_storage_1.productStorageRoot)(), TRACE_STORAGE_DIR, "workspaces", `${name}-${hash}`);
+}
+function readNonEmptyString(value) {
+    return typeof value === "string" && value.trim() !== "" ? value.trim() : null;
+}

package/dist/tracing/failure-summary.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTraceFailureSummary = buildTraceFailureSummary;
+const NESTED_FAILURE_KEYS = [
+    "firstFailure",
+    "resultModel",
+    "details",
+    "guidance",
+    "blocking",
+    "rows",
+    "segments",
+    "results",
+    "failed",
+    "errors",
+    "failures",
+    "operations",
+    "response",
+    "result",
+    "failure",
+    "cause",
+    "aggregate",
+];
+const MAX_FAILURE_DEPTH = 8;
+const MAX_VISITED_NODES = 256;
+function buildTraceFailureSummary(output, traceCallId) {
+    if (output.ok !== false && !readToken(output.code) && !containsFailedResponse(output)) {
+        return null;
+    }
+    const response = objectValue(output.response);
+    const result = objectValue(output.result);
+    const wrapperCode = firstToken(output.code, response?.code, result?.code);
+    const candidates = [];
+    const visited = { count: 0 };
+    collectFailureCandidates(output, 0, readToken(output.phase), readToken(output.stage), candidates, visited);
+    const leaf = selectLeafCandidate(candidates, wrapperCode);
+    return {
+        wrapperCode: wrapperCode ?? leaf?.code ?? null,
+        leafCode: leaf?.code ?? wrapperCode ?? null,
+        phase: leaf?.phase ?? readToken(output.phase),
+        stage: leaf?.stage ?? readToken(output.stage),
+        executionId: firstToken(output.executionId, response?.executionId, result?.executionId),
+        traceCallId: compactToken(traceCallId, 160) ?? "unknown-trace-call",
+    };
+}
+function collectFailureCandidates(value, depth, inheritedPhase, inheritedStage, output, visited) {
+    if (depth > MAX_FAILURE_DEPTH || visited.count >= MAX_VISITED_NODES) {
+        return;
+    }
+    visited.count += 1;
+    const phase = readToken(value.phase) ?? inheritedPhase;
+    const stage = readToken(value.stage) ?? inheritedStage;
+    const code = readToken(value.code);
+    if (code && (value.ok === false || value.error !== undefined || value.message !== undefined || depth === 0)) {
+        output.push({ code, phase, stage, depth });
+    }
+    for (const key of NESTED_FAILURE_KEYS) {
+        const nested = value[key];
+        if (Array.isArray(nested)) {
+            for (const item of nested) {
+                const child = objectValue(item);
+                if (child)
+                    collectFailureCandidates(child, depth + 1, phase, stage, output, visited);
+            }
+            continue;
+        }
+        const child = objectValue(nested);
+        if (child)
+            collectFailureCandidates(child, depth + 1, phase, stage, output, visited);
+    }
+}
+function selectLeafCandidate(candidates, wrapperCode) {
+    const concrete = wrapperCode ? candidates.filter((item) => item.code !== wrapperCode) : candidates;
+    const pool = concrete.length > 0 ? concrete : candidates;
+    return [...pool].sort((a, b) => b.depth - a.depth)[0] ?? null;
+}
+function containsFailedResponse(output) {
+    const response = objectValue(output.response);
+    const result = objectValue(output.result);
+    return response?.ok === false || result?.ok === false || output.batchOk === false;
+}
+function firstToken(...values) {
+    for (const value of values) {
+        const token = readToken(value);
+        if (token)
+            return token;
+    }
+    return null;
+}
+function readToken(value) {
+    return typeof value === "string" ? compactToken(value, 160) : null;
+}
+function compactToken(value, limit) {
+    const compact = value.replace(/[\u0000-\u001f\u007f]+/g, " ").replace(/\s+/g, " ").trim();
+    if (!compact)
+        return null;
+    return compact.length <= limit ? compact : `${compact.slice(0, Math.max(1, limit - 1))}…`;
+}
+function objectValue(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}

package/dist/tracing/trace.js

@@ -1,5 +1,318 @@
-"use strict";var O=exports&&exports.__createBinding||(Object.create?(function(e,t,r,a){a===void 0&&(a=r);var n=Object.getOwnPropertyDescriptor(t,r);(!n||("get"in n?!t.__esModule:n.writable||n.configurable))&&(n={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,a,n)}):(function(e,t,r,a){a===void 0&&(a=r),e[a]=t[r]})),_=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),I=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(r){var a=[];for(var n in r)Object.prototype.hasOwnProperty.call(r,n)&&(a[a.length]=n);return a},e(t)};return function(t){if(t&&t.__esModule)return t;var r={};if(t!=null)for(var a=e(t),n=0;n<a.length;n++)a[n]!=="default"&&O(r,t,a[n]);return _(r,t),r}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.startTrace=J;const i=I(require("node:fs")),s=I(require("node:path")),A=require("node:crypto"),C=require("../observability/context"),x=require("../observability/failure-snapshot"),q=require("../observability/recent"),P=2;function J(e){if(!e.traceDir||e.traceDir.trim()==="")return j();let t,r,a,n,l,f,c;try{t=M(e.cwd,e.traceDir.trim()),r=$(e.startedAtMs),a=new Date(e.startedAtMs).toISOString(),n=T(e.command,e.startedAtMs),l=s.join(t,"calls",n),f=(0,C.buildCorrelationContext)(e.cwd),c=v(l),h(l),o(c.argvPath,{schemaVersion:P,callId:n,traceCallId:n,traceRunId:r,startedAt:a,cwd:s.resolve(e.cwd),...f,argv:e.argv,command:e.command,restArgs:e.restArgs,inputSource:e.stdinSource?.format??(e.stdinPayload!==void 0?"payload":"none"),hasStdinPayload:e.stdinPayload!==void 0,hasRawStdin:typeof e.stdinSource?.text=="string"}),typeof e.stdinSource?.text=="string"&&w(c.stdinPath,e.stdinSource.text),e.stdinPayload!==void 0&&o(c.inputJsonPath,g(e.stdinPayload)),o(c.legacyRequestPath,{schemaVersion:P,callId:n,traceCallId:n,traceRunId:r,startedAt:a,cwd:s.resolve(e.cwd),...f,argv:e.argv,command:e.command,restArgs:e.restArgs,inputSource:e.stdinSource??null,hasStdinPayload:e.stdinPayload!==void 0,stdinPayload:E(e.stdinPayload),files:{argvPath:c.argvPath,...typeof e.stdinSource?.text=="string"?{stdinPath:c.stdinPath}:{},...e.stdinPayload!==void 0?{inputJsonPath:c.inputJsonPath}:{}}})}catch(u){return j(U(u))}return{enabled:!0,traceDir:t,callId:n,callDir:l,complete(u){try{const S=new Date(e.startedAtMs+u.durationMs).toISOString();o(c.responseJsonPath,u.output),typeof u.stdoutText=="string"&&w(c.responseStdoutPath,u.stdoutText);const p=V(u),b=(0,x.captureFailureSnapshot)({cwd:e.cwd,command:e.command,restArgs:e.restArgs,...e.stdinPayload!==void 0?{stdinPayload:e.stdinPayload}:{},output:u.output,traceCallId:n,traceRunId:r}),y={schemaVersion:P,callId:n,traceCallId:n,traceRunId:r,startedAt:a,finishedAt:S,durationMs:u.durationMs,exitCode:u.exitCode,ok:p,command:e.command,cwd:s.resolve(e.cwd),...f,selectedInstance:N(u.output),responseSummary:R(u.output),transport:u.transport??F(u.output)??null,executionId:L(u.output),...b?{failureSnapshot:b}:{},requestPath:c.legacyRequestPath,requestArgvPath:c.argvPath,...typeof e.stdinSource?.text=="string"?{requestStdinPath:c.stdinPath}:{},...e.stdinPayload!==void 0?{requestInputJsonPath:c.inputJsonPath}:{},responsePath:c.responseJsonPath,responseJsonPath:c.responseJsonPath,...typeof u.stdoutText=="string"?{responseStdoutPath:c.responseStdoutPath}:{},metaPath:c.metaPath};o(c.metaPath,y),k(s.join(t,"trace.jsonl"),y),(0,q.recordRecentTraceCall)(e.cwd,{traceCallId:n,traceRunId:r,traceDir:t,command:e.command,cwd:s.resolve(e.cwd),startedAt:a,finishedAt:S,ok:p,...typeof y.executionId=="string"?{executionId:y.executionId}:{}})}catch{}}}}function v(e){return{argvPath:s.join(e,"request.argv.json"),stdinPath:s.join(e,"request.stdin.txt"),inputJsonPath:s.join(e,"request.input.json"),legacyRequestPath:s.join(e,"request.json"),responseStdoutPath:s.join(e,"response.stdout.txt"),responseJsonPath:s.join(e,"response.json"),metaPath:s.join(e,"meta.json")}}function j(e){return{enabled:!1,traceDir:null,callId:null,callDir:null,...e?{disabledReason:e}:{},complete(){}}}function M(e,t){return s.resolve(s.isAbsolute(t)?t:s.join(e,t))}function T(e,t){return`${new Date(t).toISOString().replace(/[:.]/g,"-")}-${D(e)}-${process.pid}-${(0,A.randomUUID)().slice(0,8)}`}function $(e){return`run_${new Date(e).toISOString().replace(/[:.]/g,"-")}_${process.pid}`}function D(e){return e.replace(/[^a-z0-9]+/gi,"-").replace(/^-|-$/g,"").toLowerCase()||"command"}function o(e,t){h(s.dirname(e)),i.writeFileSync(e,`${JSON.stringify(t,null,2)}
-`)}function w(e,t){h(s.dirname(e)),i.writeFileSync(e,t.endsWith(`
-`)?t:`${t}
-`,"utf8")}function k(e,t){h(s.dirname(e)),i.appendFileSync(e,`${JSON.stringify(t)}
-`)}function h(e){try{i.mkdirSync(e,{recursive:!0});return}catch(t){if((typeof t=="object"&&t!==null&&"code"in t?String(t.code):"")!=="ENOENT")throw t}i.mkdirSync(s.dirname(e),{recursive:!0}),i.mkdirSync(e,{recursive:!0})}function E(e){return e===void 0?null:g(e)}function g(e){return e===null||typeof e=="string"||typeof e=="number"||typeof e=="boolean"?e:Array.isArray(e)?e.map(t=>g(t)):e&&typeof e=="object"?Object.fromEntries(Object.entries(e).map(([t,r])=>[t,g(r)])):String(e)}function N(e){const t=e.selectedInstance;if(!t||typeof t!="object"||Array.isArray(t))return null;const r=t;return{instanceId:d(r.instanceId),reason:d(r.reason),matchedWorkspace:d(r.matchedWorkspace),port:typeof r.port=="number"?r.port:null}}function R(e){return{ok:typeof e.ok=="boolean"?e.ok:null,code:d(e.code),error:d(e.error),command:d(e.command),responseOk:W(e),responseCode:B(e),batchOk:typeof e.batchOk=="boolean"?e.batchOk:null,result:m(e.result)}}function V(e){return e.output.ok===!1?!1:e.exitCode===0}function F(e){const t=e.selectedInstance;!t||typeof t!="object"||Array.isArray(t)}function W(e){const t=m(e.response);return typeof t?.ok=="boolean"?t.ok:null}function B(e){const t=m(e.response);return t?d(t.code):null}function m(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:null}function d(e){return typeof e=="string"?e:null}function L(e){if(typeof e.executionId=="string")return e.executionId;const t=m(e.response);return typeof t?.executionId=="string"?t.executionId:null}function U(e){return e instanceof Error?e.message:String(e)}
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startTrace = startTrace;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_crypto_1 = require("node:crypto");
+const context_1 = require("../observability/context");
+const failure_snapshot_1 = require("../observability/failure-snapshot");
+const recent_1 = require("../observability/recent");
+const central_metrics_1 = require("../metrics/central-metrics");
+const failure_summary_1 = require("./failure-summary");
+const TRACE_SCHEMA_VERSION = 2;
+function startTrace(options) {
+    if (!options.traceDir || options.traceDir.trim() === "") {
+        return disabledTrace();
+    }
+    let traceDir;
+    let traceRunId;
+    let startedAt;
+    let callId;
+    let callDir;
+    let correlation;
+    let paths;
+    try {
+        traceDir = resolveTraceDir(options.cwd, options.traceDir.trim());
+        traceRunId = buildRunId(options.startedAtMs);
+        startedAt = new Date(options.startedAtMs).toISOString();
+        callId = buildCallId(options.command, options.startedAtMs);
+        callDir = path.join(traceDir, "calls", callId);
+        correlation = (0, context_1.buildCorrelationContext)(options.cwd);
+        paths = buildTraceCallPaths(callDir);
+        ensureTraceDirectory(callDir);
+        writeJson(paths.argvPath, {
+            schemaVersion: TRACE_SCHEMA_VERSION,
+            callId,
+            traceCallId: callId,
+            traceRunId,
+            startedAt,
+            cwd: path.resolve(options.cwd),
+            ...correlation,
+            argv: options.argv,
+            command: options.command,
+            restArgs: options.restArgs,
+            inputSource: options.stdinSource?.format ?? (options.stdinPayload !== undefined ? "payload" : "none"),
+            hasStdinPayload: options.stdinPayload !== undefined,
+            hasRawStdin: typeof options.stdinSource?.text === "string"
+        });
+        if (typeof options.stdinSource?.text === "string") {
+            writeText(paths.stdinPath, options.stdinSource.text);
+        }
+        if (options.stdinPayload !== undefined) {
+            writeJson(paths.inputJsonPath, toJsonValue(options.stdinPayload));
+        }
+        writeJson(paths.legacyRequestPath, {
+            schemaVersion: TRACE_SCHEMA_VERSION,
+            callId,
+            traceCallId: callId,
+            traceRunId,
+            startedAt,
+            cwd: path.resolve(options.cwd),
+            ...correlation,
+            argv: options.argv,
+            command: options.command,
+            restArgs: options.restArgs,
+            inputSource: options.stdinSource ?? null,
+            hasStdinPayload: options.stdinPayload !== undefined,
+            stdinPayload: toJsonValueOrNull(options.stdinPayload),
+            files: {
+                argvPath: paths.argvPath,
+                ...(typeof options.stdinSource?.text === "string" ? { stdinPath: paths.stdinPath } : {}),
+                ...(options.stdinPayload !== undefined ? { inputJsonPath: paths.inputJsonPath } : {})
+            }
+        });
+    }
+    catch (error) {
+        return disabledTrace(errorMessage(error));
+    }
+    return {
+        enabled: true,
+        traceDir,
+        callId,
+        callDir,
+        complete(completion) {
+            try {
+                const finishedAt = new Date(options.startedAtMs + completion.durationMs).toISOString();
+                writeJson(paths.responseJsonPath, completion.output);
+                if (typeof completion.stdoutText === "string") {
+                    writeText(paths.responseStdoutPath, completion.stdoutText);
+                }
+                const ok = traceCompletionOk(completion);
+                const failureSummary = (0, failure_summary_1.buildTraceFailureSummary)(completion.output, callId);
+                const snapshot = (0, failure_snapshot_1.captureFailureSnapshot)({
+                    cwd: options.cwd,
+                    command: options.command,
+                    restArgs: options.restArgs,
+                    ...(options.stdinPayload !== undefined ? { stdinPayload: options.stdinPayload } : {}),
+                    output: completion.output,
+                    traceCallId: callId,
+                    traceRunId
+                });
+                const meta = {
+                    schemaVersion: TRACE_SCHEMA_VERSION,
+                    callId,
+                    traceCallId: callId,
+                    traceRunId,
+                    startedAt,
+                    finishedAt,
+                    durationMs: completion.durationMs,
+                    exitCode: completion.exitCode,
+                    ok,
+                    command: options.command,
+                    cwd: path.resolve(options.cwd),
+                    ...correlation,
+                    responseSummary: responseSummary(completion.output),
+                    ...(failureSummary ? { failureSummary } : {}),
+                    executionId: extractExecutionId(completion.output),
+                    ...(snapshot ? { failureSnapshot: snapshot } : {}),
+                    requestPath: paths.legacyRequestPath,
+                    requestArgvPath: paths.argvPath,
+                    ...(typeof options.stdinSource?.text === "string" ? { requestStdinPath: paths.stdinPath } : {}),
+                    ...(options.stdinPayload !== undefined ? { requestInputJsonPath: paths.inputJsonPath } : {}),
+                    responsePath: paths.responseJsonPath,
+                    responseJsonPath: paths.responseJsonPath,
+                    ...(typeof completion.stdoutText === "string" ? { responseStdoutPath: paths.responseStdoutPath } : {}),
+                    metaPath: paths.metaPath
+                };
+                writeJson(paths.metaPath, meta);
+                appendJsonLine(path.join(traceDir, "trace.jsonl"), meta);
+                (0, central_metrics_1.recordCentralMetric)({
+                    kind: "trace.call",
+                    operation: options.command,
+                    cwd: path.resolve(options.cwd),
+                    ok,
+                    traceCallId: callId,
+                    traceRunId,
+                    executionId: meta.executionId,
+                    wrapperCode: failureSummary?.wrapperCode ?? null,
+                    leafCode: failureSummary?.leafCode ?? null,
+                    phase: failureSummary?.phase ?? null,
+                    stage: failureSummary?.stage ?? null,
+                    durationMs: completion.durationMs,
+                });
+                (0, recent_1.recordRecentTraceCall)(options.cwd, {
+                    traceCallId: callId,
+                    traceRunId,
+                    traceDir,
+                    command: options.command,
+                    cwd: path.resolve(options.cwd),
+                    startedAt,
+                    finishedAt,
+                    ok,
+                    ...(typeof meta.executionId === "string" ? { executionId: meta.executionId } : {})
+                });
+            }
+            catch {
+                // Trace is diagnostic only. It must never change command behavior.
+            }
+        }
+    };
+}
+function buildTraceCallPaths(callDir) {
+    return {
+        argvPath: path.join(callDir, "request.argv.json"),
+        stdinPath: path.join(callDir, "request.stdin.txt"),
+        inputJsonPath: path.join(callDir, "request.input.json"),
+        legacyRequestPath: path.join(callDir, "request.json"),
+        responseStdoutPath: path.join(callDir, "response.stdout.txt"),
+        responseJsonPath: path.join(callDir, "response.json"),
+        metaPath: path.join(callDir, "meta.json")
+    };
+}
+function disabledTrace(disabledReason) {
+    return {
+        enabled: false,
+        traceDir: null,
+        callId: null,
+        callDir: null,
+        ...(disabledReason ? { disabledReason } : {}),
+        complete() {
+            // no-op
+        }
+    };
+}
+function resolveTraceDir(cwd, traceDir) {
+    return path.resolve(path.isAbsolute(traceDir) ? traceDir : path.join(cwd, traceDir));
+}
+function buildCallId(command, startedAtMs) {
+    const timestamp = new Date(startedAtMs).toISOString().replace(/[:.]/g, "-");
+    return `${timestamp}-${slug(command)}-${process.pid}-${(0, node_crypto_1.randomUUID)().slice(0, 8)}`;
+}
+function buildRunId(startedAtMs) {
+    const timestamp = new Date(startedAtMs).toISOString().replace(/[:.]/g, "-");
+    return `run_${timestamp}_${process.pid}`;
+}
+function slug(value) {
+    const slugged = value.replace(/[^a-z0-9]+/gi, "-").replace(/^-|-$/g, "").toLowerCase();
+    return slugged || "command";
+}
+function writeJson(filePath, payload) {
+    ensureTraceDirectory(path.dirname(filePath));
+    fs.writeFileSync(filePath, `${JSON.stringify(payload, null, 2)}\n`);
+}
+function writeText(filePath, text) {
+    ensureTraceDirectory(path.dirname(filePath));
+    fs.writeFileSync(filePath, text.endsWith("\n") ? text : `${text}\n`, "utf8");
+}
+function appendJsonLine(filePath, payload) {
+    ensureTraceDirectory(path.dirname(filePath));
+    fs.appendFileSync(filePath, `${JSON.stringify(payload)}\n`);
+}
+function ensureTraceDirectory(dir) {
+    try {
+        fs.mkdirSync(dir, { recursive: true });
+        return;
+    }
+    catch (error) {
+        const code = typeof error === "object" && error !== null && "code" in error ? String(error.code) : "";
+        if (code !== "ENOENT") {
+            throw error;
+        }
+    }
+    fs.mkdirSync(path.dirname(dir), { recursive: true });
+    fs.mkdirSync(dir, { recursive: true });
+}
+function toJsonValueOrNull(value) {
+    if (value === undefined) {
+        return null;
+    }
+    return toJsonValue(value);
+}
+function toJsonValue(value) {
+    if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => toJsonValue(item));
+    }
+    if (value && typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, toJsonValue(item)]));
+    }
+    return String(value);
+}
+function responseSummary(output) {
+    return {
+        ok: typeof output.ok === "boolean" ? output.ok : null,
+        code: stringOrNull(output.code),
+        command: stringOrNull(output.command),
+        responseOk: responseOk(output),
+        responseCode: responseCode(output),
+        batchOk: typeof output.batchOk === "boolean" ? output.batchOk : null
+    };
+}
+function traceCompletionOk(completion) {
+    if (completion.output.ok === false) {
+        return false;
+    }
+    return completion.exitCode === 0;
+}
+function responseOk(output) {
+    const response = objectValue(output.response);
+    return typeof response?.ok === "boolean" ? response.ok : null;
+}
+function responseCode(output) {
+    const response = objectValue(output.response);
+    return response ? stringOrNull(response.code) : null;
+}
+function objectValue(value) {
+    return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function stringOrNull(value) {
+    return typeof value === "string" ? value : null;
+}
+function extractExecutionId(output) {
+    if (typeof output.executionId === "string") {
+        return output.executionId;
+    }
+    const response = objectValue(output.response);
+    if (typeof response?.executionId === "string") {
+        return response.executionId;
+    }
+    return null;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}