@automaton-labs/aib 0.0.7 → 0.0.9

package/dist/shared/metrics.js

@@ -1 +1,43 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.metricsNow=i,exports.recordSpan=o,exports.appendMetrics=c;const t=require("node:perf_hooks");function i(){return t.performance.now()}function o(e,r,n){e&&e.push({name:r,durationMs:Number((t.performance.now()-n).toFixed(3))})}function s(e){const r=e._metrics;if(!r||typeof r!="object"||Array.isArray(r))return[];const n=r.spans;return Array.isArray(n)?n:[]}function c(e,r){return r.length===0?e:{...e,_metrics:{spans:[...s(e),...r.map(n=>({name:n.name,durationMs:n.durationMs}))]}}}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metricsNow = metricsNow;
+exports.recordSpan = recordSpan;
+exports.appendMetrics = appendMetrics;
+const node_perf_hooks_1 = require("node:perf_hooks");
+function metricsNow() {
+    return node_perf_hooks_1.performance.now();
+}
+function recordSpan(spans, name, startedAt) {
+    if (!spans) {
+        return;
+    }
+    spans.push({
+        name,
+        durationMs: Number((node_perf_hooks_1.performance.now() - startedAt).toFixed(3))
+    });
+}
+function readExistingSpans(payload) {
+    const rawMetrics = payload._metrics;
+    if (!rawMetrics || typeof rawMetrics !== "object" || Array.isArray(rawMetrics)) {
+        return [];
+    }
+    const rawSpans = rawMetrics.spans;
+    return Array.isArray(rawSpans) ? rawSpans : [];
+}
+function appendMetrics(payload, spans) {
+    if (spans.length === 0) {
+        return payload;
+    }
+    return {
+        ...payload,
+        _metrics: {
+            spans: [
+                ...readExistingSpans(payload),
+                ...spans.map((span) => ({
+                    name: span.name,
+                    durationMs: span.durationMs
+                }))
+            ]
+        }
+    };
+}

package/dist/shared/presentation.js

@@ -1,4 +1,69 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.createCliPresentationEnvelope=l,exports.presentCliEnvelope=c;const i=require("./agent-text");function l(e){const r=(0,i.readAgentText)(e),n=r?null:f(e),s=r??n,t=s&&!r?(0,i.attachAgentText)(e,s):e,a=typeof t.code=="string"?t.code:void 0;return{ok:t.ok!==!1,payload:t,tracePayload:(0,i.stripAgentText)(t),text:s,...a?{code:a}:{}}}function c(e,r){return r==="agent"&&e.text?`${e.text.trimEnd()}
-`:`${JSON.stringify(e.tracePayload,null,2)}
-`}function f(e){if(e.ok!==!1)return null;const r=typeof e.code=="string"&&e.code.length>0?e.code:"ERROR",n=typeof e.error=="string"&&e.error.length>0?e.error:"AIB command failed.",s=[r,"",n],t=g(e.details);t.length>0&&s.push("","issues:",...t);const a=Array.isArray(e.hints)?e.hints.filter(o=>typeof o=="string"&&o.length>0):[];return a.length>0&&s.push("","hints:",...a.map(o=>`- ${o}`)),s.join(`
-`)}function g(e){if(!e||typeof e!="object"||Array.isArray(e))return[];const r=e.issues;return Array.isArray(r)?r.map(n=>{if(!n||typeof n!="object"||Array.isArray(n))return null;const s=typeof n.path=="string"&&n.path.length>0?n.path:"<root>",t=typeof n.message=="string"&&n.message.length>0?n.message:"Invalid value.";return`- ${s}: ${t}`}).filter(n=>n!==null):[]}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCliPresentationEnvelope = createCliPresentationEnvelope;
+exports.presentCliEnvelope = presentCliEnvelope;
+const agent_text_1 = require("./agent-text");
+function createCliPresentationEnvelope(output) {
+    const explicitText = (0, agent_text_1.readAgentText)(output);
+    const fallbackText = explicitText ? null : formatFallbackErrorText(output);
+    const text = explicitText ?? fallbackText;
+    const payload = text && !explicitText ? (0, agent_text_1.attachAgentText)(output, text) : output;
+    const code = typeof payload.code === "string" ? payload.code : undefined;
+    return {
+        ok: payload.ok !== false,
+        payload,
+        tracePayload: (0, agent_text_1.stripAgentText)(payload),
+        text,
+        ...(code ? { code } : {})
+    };
+}
+function presentCliEnvelope(envelope, mode) {
+    if (mode === "agent" && envelope.text) {
+        return `${envelope.text.trimEnd()}\n`;
+    }
+    return `${JSON.stringify(envelope.tracePayload, null, 2)}\n`;
+}
+function formatFallbackErrorText(output) {
+    if (output.ok !== false) {
+        return null;
+    }
+    const code = typeof output.code === "string" && output.code.length > 0 ? output.code : "ERROR";
+    const message = typeof output.error === "string" && output.error.length > 0
+        ? output.error
+        : "AIB command failed.";
+    const lines = [
+        code,
+        "",
+        message
+    ];
+    const issueLines = formatIssueLines(output.details);
+    if (issueLines.length > 0) {
+        lines.push("", "issues:", ...issueLines);
+    }
+    const hints = Array.isArray(output.hints)
+        ? output.hints.filter((hint) => typeof hint === "string" && hint.length > 0)
+        : [];
+    if (hints.length > 0) {
+        lines.push("", "hints:", ...hints.map((hint) => `- ${hint}`));
+    }
+    return lines.join("\n");
+}
+function formatIssueLines(details) {
+    if (!details || typeof details !== "object" || Array.isArray(details)) {
+        return [];
+    }
+    const issues = details.issues;
+    if (!Array.isArray(issues)) {
+        return [];
+    }
+    return issues
+        .map((issue) => {
+        if (!issue || typeof issue !== "object" || Array.isArray(issue)) {
+            return null;
+        }
+        const path = typeof issue.path === "string" && issue.path.length > 0 ? issue.path : "<root>";
+        const message = typeof issue.message === "string" && issue.message.length > 0 ? issue.message : "Invalid value.";
+        return `- ${path}: ${message}`;
+    })
+        .filter((line) => line !== null);
+}

package/dist/shared/stdin-examples.js

@@ -1 +1,77 @@
-"use strict";var _=exports&&exports.__createBinding||(Object.create?(function(e,t,r,n){n===void 0&&(n=r);var i=Object.getOwnPropertyDescriptor(t,r);(!i||("get"in i?!t.__esModule:i.writable||i.configurable))&&(i={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,n,i)}):(function(e,t,r,n){n===void 0&&(n=r),e[n]=t[r]})),p=exports&&exports.__setModuleDefault||(Object.create?(function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}):function(e,t){e.default=t}),u=exports&&exports.__importStar||(function(){var e=function(t){return e=Object.getOwnPropertyNames||function(r){var n=[];for(var i in r)Object.prototype.hasOwnProperty.call(r,i)&&(n[n.length]=i);return n},e(t)};return function(t){if(t&&t.__esModule)return t;var r={};if(t!=null)for(var n=e(t),i=0;i<n.length;i++)n[i]!=="default"&&_(r,t,n[i]);return p(r,t),r}})();Object.defineProperty(exports,"__esModule",{value:!0}),exports.resolveStdinExampleShell=f,exports.formatStdinExamples=v,exports.formatHelpToken=d;const c=u(require("node:fs")),l=u(require("node:path"));function f(){const e=process.env.AIB_HELP_SHELL?.trim().toLowerCase();return e==="bash"||e==="sh"||e==="zsh"?"bash":e==="powershell"||e==="pwsh"||e==="ps"||process.platform==="win32"?"powershell":"bash"}function v(e={}){return d(e.includeQr===!0?"stdin.examples.with-qr":"stdin.examples",e.helpRootDir)}function d(e,t){const r=e.trim();if(!/^[a-z0-9_.-]+$/i.test(r))throw new Error(`Invalid AIB help token: ${e}`);const i=f()==="powershell"?"pwsh":"bash",s=l.join("tokens",`${r}.md`),a=l.join("tokens",`${r}.${i}.md`),h=[t?l.join(t,s):null,t?l.join(t,a):null,l.resolve(__dirname,"..","help",s),l.resolve(__dirname,"..","help",a),l.resolve(__dirname,"..","..","..","..","docs","aib-help",s),l.resolve(__dirname,"..","..","..","..","docs","aib-help",a)].filter(o=>!!o);for(const o of h)if(c.existsSync(o))return c.readFileSync(o,"utf8").trim();throw new Error(`Missing AIB help token: ${s} or ${a}`)}
+"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.resolveStdinExampleShell = resolveStdinExampleShell;
+exports.formatStdinExamples = formatStdinExamples;
+exports.formatHelpToken = formatHelpToken;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+function resolveStdinExampleShell() {
+    const override = process.env.AIB_HELP_SHELL?.trim().toLowerCase();
+    if (override === "bash" || override === "sh" || override === "zsh") {
+        return "bash";
+    }
+    if (override === "powershell" || override === "pwsh" || override === "ps") {
+        return "powershell";
+    }
+    return process.platform === "win32" ? "powershell" : "bash";
+}
+function formatStdinExamples(options = {}) {
+    return formatHelpToken(options.includeQr === true ? "stdin.examples.with-qr" : "stdin.examples", options.helpRootDir);
+}
+function formatHelpToken(token, helpRootDir) {
+    const normalized = token.trim();
+    if (!/^[a-z0-9_.-]+$/i.test(normalized)) {
+        throw new Error(`Invalid AIB help token: ${token}`);
+    }
+    const shell = resolveStdinExampleShell();
+    const shellSuffix = shell === "powershell" ? "pwsh" : "bash";
+    const genericRelative = path.join("tokens", `${normalized}.md`);
+    const shellRelative = path.join("tokens", `${normalized}.${shellSuffix}.md`);
+    const candidates = [
+        helpRootDir ? path.join(helpRootDir, genericRelative) : null,
+        helpRootDir ? path.join(helpRootDir, shellRelative) : null,
+        path.resolve(__dirname, "..", "help", genericRelative),
+        path.resolve(__dirname, "..", "help", shellRelative),
+        path.resolve(__dirname, "..", "..", "..", "..", "docs", "aib-help", genericRelative),
+        path.resolve(__dirname, "..", "..", "..", "..", "docs", "aib-help", shellRelative)
+    ].filter((candidate) => Boolean(candidate));
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate)) {
+            return fs.readFileSync(candidate, "utf8").trim();
+        }
+    }
+    throw new Error(`Missing AIB help token: ${genericRelative} or ${shellRelative}`);
+}

package/dist/shared/stdout.js

@@ -1,2 +1,6 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.printJson=e;function e(t){process.stdout.write(`${JSON.stringify(t,null,2)}
-`)}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printJson = printJson;
+function printJson(value) {
+    process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+}

package/dist/shared/types.js

@@ -1 +1,23 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.ENTITY_KIND_IDS=exports.CANONICAL_METHOD_IDS=void 0,exports.CANONICAL_METHOD_IDS=["ping","runtimeInfo","printConfig","listInstances","initSkillUsage","help","inspect","imports","move","rename","refactor","execution","modulePlan"],exports.ENTITY_KIND_IDS=["class","interface","type","function","variable","enum","namespace","method","property"];
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENTITY_KIND_IDS = exports.CANONICAL_METHOD_IDS = void 0;
+exports.CANONICAL_METHOD_IDS = [
+    "printConfig",
+    "initSkillUsage",
+    "help",
+    "inspect",
+    "imports",
+    "mutate",
+    "execution"
+];
+exports.ENTITY_KIND_IDS = [
+    "class",
+    "interface",
+    "type",
+    "function",
+    "variable",
+    "enum",
+    "namespace",
+    "method",
+    "property"
+];

package/dist/tool-runtime/runtime-tools.js

@@ -1 +1,120 @@
-"use strict";var f=exports&&exports.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.resolveToolRuntime=b,exports.currentPlatformKey=h,exports.packagedToolsRoot=s,exports.toolCacheRoot=l,exports.defaultExecutableName=c,exports.toolRuntimeEnvVar=x,exports.shouldUseShellForTool=g;const d=f(require("node:fs")),n=f(require("node:path")),v=require("../config/env-vars"),_=require("../config/product-storage");function b(e){const r={...process.env,...e.env},o=h(),t=r[e.envVar]?.trim();if(t)return{executable:n.default.resolve(t),source:"env",platformKey:o};const u=P(e.tool,o);if(u)return u;const a=k(e.tool,o);return a||{executable:c(e.tool),source:"path",platformKey:o}}function h(){const e=(process.arch==="x64"||process.arch==="arm64",process.arch);return`${process.platform}-${e}`}function s(){return n.default.resolve(__dirname,"..","..","runtimes","tools")}function l(e=(0,_.productStorageRoot)()){return n.default.join(e,"tool-packs")}function c(e){return e==="rg"?process.platform==="win32"?"rg.exe":"rg":process.platform==="win32"?"rtk.exe":"rtk"}function x(e){return e==="rg"?v.CLI_ENV.rgPath:v.CLI_ENV.rtkPath}function g(e){return process.platform==="win32"&&/\.(?:cmd|bat)$/i.test(e)}function P(e,r){const o=n.default.join(l(),e,"active.json"),t=p(o);if(!t||t.tool!==e||t.platform!==r||!t.version)return null;const u=t.executablePath?n.default.resolve(t.executablePath):n.default.join(l(),e,t.version,r,t.executable||c(e));return m(u)?{executable:u,source:"cache",platformKey:r,version:t.version}:null}function k(e,r){const o=n.default.join(s(),e,"manifest.json"),t=p(o);if(!t||t.tool!==e||!t.version)return null;const a=t.platforms?.[r]?.executable||c(e),i=n.default.join(s(),e,r,a);return m(i)?{executable:i,source:"packaged",platformKey:r,version:t.version}:null}function m(e){try{return d.default.statSync(e).isFile()}catch{return!1}}function p(e){try{return JSON.parse(d.default.readFileSync(e,"utf8"))}catch{return null}}
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveToolRuntime = resolveToolRuntime;
+exports.currentPlatformKey = currentPlatformKey;
+exports.packagedToolsRoot = packagedToolsRoot;
+exports.toolCacheRoot = toolCacheRoot;
+exports.defaultExecutableName = defaultExecutableName;
+exports.toolRuntimeEnvVar = toolRuntimeEnvVar;
+exports.shouldUseShellForTool = shouldUseShellForTool;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const env_vars_1 = require("../config/env-vars");
+const product_storage_1 = require("../config/product-storage");
+function resolveToolRuntime(options) {
+    const env = {
+        ...process.env,
+        ...options.env
+    };
+    const platformKey = currentPlatformKey();
+    const override = env[options.envVar]?.trim();
+    if (override) {
+        return {
+            executable: node_path_1.default.resolve(override),
+            source: "env",
+            platformKey
+        };
+    }
+    const cached = resolveCachedTool(options.tool, platformKey);
+    if (cached) {
+        return cached;
+    }
+    const packaged = resolvePackagedTool(options.tool, platformKey);
+    if (packaged) {
+        return packaged;
+    }
+    return {
+        executable: defaultExecutableName(options.tool),
+        source: "path",
+        platformKey
+    };
+}
+function currentPlatformKey() {
+    const arch = process.arch === "x64" || process.arch === "arm64" ? process.arch : process.arch;
+    return `${process.platform}-${arch}`;
+}
+function packagedToolsRoot() {
+    return node_path_1.default.resolve(__dirname, "..", "..", "runtimes", "tools");
+}
+function toolCacheRoot(root = (0, product_storage_1.productStorageRoot)()) {
+    return node_path_1.default.join(root, "tool-packs");
+}
+function defaultExecutableName(tool) {
+    if (tool === "rg") {
+        return process.platform === "win32" ? "rg.exe" : "rg";
+    }
+    return process.platform === "win32" ? "rtk.exe" : "rtk";
+}
+function toolRuntimeEnvVar(tool) {
+    return tool === "rg" ? env_vars_1.CLI_ENV.rgPath : env_vars_1.CLI_ENV.rtkPath;
+}
+function shouldUseShellForTool(executable) {
+    return process.platform === "win32" && /\.(?:cmd|bat)$/i.test(executable);
+}
+function resolveCachedTool(tool, platformKey) {
+    const activePath = node_path_1.default.join(toolCacheRoot(), tool, "active.json");
+    const active = readJsonFile(activePath);
+    if (!active || active.tool !== tool || active.platform !== platformKey || !active.version) {
+        return null;
+    }
+    const executable = active.executablePath
+        ? node_path_1.default.resolve(active.executablePath)
+        : node_path_1.default.join(toolCacheRoot(), tool, active.version, platformKey, active.executable || defaultExecutableName(tool));
+    if (!fileExists(executable)) {
+        return null;
+    }
+    return {
+        executable,
+        source: "cache",
+        platformKey,
+        version: active.version
+    };
+}
+function resolvePackagedTool(tool, platformKey) {
+    const manifestPath = node_path_1.default.join(packagedToolsRoot(), tool, "manifest.json");
+    const manifest = readJsonFile(manifestPath);
+    if (!manifest || manifest.tool !== tool || !manifest.version) {
+        return null;
+    }
+    const platform = manifest.platforms?.[platformKey];
+    const executableName = platform?.executable || defaultExecutableName(tool);
+    const executable = node_path_1.default.join(packagedToolsRoot(), tool, platformKey, executableName);
+    if (!fileExists(executable)) {
+        return null;
+    }
+    return {
+        executable,
+        source: "packaged",
+        platformKey,
+        version: manifest.version
+    };
+}
+function fileExists(filePath) {
+    try {
+        return node_fs_1.default.statSync(filePath).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+function readJsonFile(filePath) {
+    try {
+        return JSON.parse(node_fs_1.default.readFileSync(filePath, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}