@lumenflow/packs-software-delivery 3.7.1

package/dist/tool-impl/agent-tools.js

@@ -0,0 +1,211 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { RUNTIME_CLI_COMMANDS, runtimeCliAdapter } from './runtime-cli-adapter.js';
+const AGENT_TOOLS = {
+    AGENT_SESSION: 'agent:session',
+    AGENT_SESSION_END: 'agent:session-end',
+    AGENT_LOG_ISSUE: 'agent:log-issue',
+    AGENT_ISSUES_QUERY: 'agent:issues-query',
+};
+const AGENT_TOOL_ERROR_CODES = {
+    'agent:session': 'AGENT_SESSION_ERROR',
+    'agent:session-end': 'AGENT_SESSION_END_ERROR',
+    'agent:log-issue': 'AGENT_LOG_ISSUE_ERROR',
+    'agent:issues-query': 'AGENT_ISSUES_QUERY_ERROR',
+};
+const AGENT_TOOL_COMMANDS = {
+    'agent:session': RUNTIME_CLI_COMMANDS.AGENT_SESSION,
+    'agent:session-end': RUNTIME_CLI_COMMANDS.AGENT_SESSION_END,
+    'agent:log-issue': RUNTIME_CLI_COMMANDS.AGENT_LOG_ISSUE,
+    'agent:issues-query': RUNTIME_CLI_COMMANDS.AGENT_ISSUES_QUERY,
+};
+const MISSING_PARAMETER_MESSAGES = {
+    WU_REQUIRED: 'wu is required',
+    TIER_REQUIRED: 'tier is required',
+    CATEGORY_REQUIRED: 'category is required',
+    SEVERITY_REQUIRED: 'severity is required',
+    TITLE_REQUIRED: 'title is required',
+    DESCRIPTION_REQUIRED: 'description is required',
+};
+function toRecord(input) {
+    if (input && typeof input === 'object') {
+        return input;
+    }
+    return {};
+}
+function toStringValue(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function toStringArray(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value
+        .map((entry) => toStringValue(entry))
+        .filter((entry) => entry !== null);
+}
+function toIntegerString(value) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return String(Math.trunc(value));
+    }
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : null;
+    }
+    return null;
+}
+async function runAgentCommand(toolName, args) {
+    return runtimeCliAdapter.run(AGENT_TOOL_COMMANDS[toolName], args);
+}
+function createMissingParameterOutput(message) {
+    return {
+        success: false,
+        error: {
+            code: 'MISSING_PARAMETER',
+            message,
+        },
+    };
+}
+function createFailureOutput(toolName, execution) {
+    const stderrMessage = execution.stderr.trim();
+    const stdoutMessage = execution.stdout.trim();
+    const message = execution.executionError ??
+        (stderrMessage.length > 0
+            ? stderrMessage
+            : stdoutMessage.length > 0
+                ? stdoutMessage
+                : `${toolName} failed`);
+    return {
+        success: false,
+        error: {
+            code: AGENT_TOOL_ERROR_CODES[toolName],
+            message,
+            details: {
+                exit_code: execution.status,
+                stdout: execution.stdout,
+                stderr: execution.stderr,
+            },
+        },
+    };
+}
+function parseJsonOutput(stdout) {
+    const trimmed = stdout.trim();
+    if (trimmed.length === 0) {
+        return null;
+    }
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+}
+function createSuccessOutput(toolName, execution) {
+    const parsedJson = parseJsonOutput(execution.stdout);
+    if (parsedJson !== null) {
+        return {
+            success: true,
+            data: parsedJson,
+        };
+    }
+    const message = execution.stdout.trim().length > 0 ? execution.stdout.trim() : `${toolName} ran`;
+    return {
+        success: true,
+        data: {
+            message,
+        },
+    };
+}
+async function executeAgentTool(toolName, args) {
+    const execution = await runAgentCommand(toolName, args);
+    if (!execution.ok) {
+        return createFailureOutput(toolName, execution);
+    }
+    return createSuccessOutput(toolName, execution);
+}
+export async function agentSessionTool(input) {
+    const parsed = toRecord(input);
+    const wu = toStringValue(parsed.wu);
+    if (!wu) {
+        return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.WU_REQUIRED);
+    }
+    const tier = toIntegerString(parsed.tier);
+    if (!tier) {
+        return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.TIER_REQUIRED);
+    }
+    const args = ['--wu', wu, '--tier', tier];
+    const agentType = toStringValue(parsed.agent_type);
+    if (agentType) {
+        args.push('--agent-type', agentType);
+    }
+    return executeAgentTool(AGENT_TOOLS.AGENT_SESSION, args);
+}
+export async function agentSessionEndTool(_input) {
+    return executeAgentTool(AGENT_TOOLS.AGENT_SESSION_END, []);
+}
+export async function agentLogIssueTool(input) {
+    const parsed = toRecord(input);
+    const category = toStringValue(parsed.category);
+    if (!category) {
+        return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.CATEGORY_REQUIRED);
+    }
+    const severity = toStringValue(parsed.severity);
+    if (!severity) {
+        return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.SEVERITY_REQUIRED);
+    }
+    const title = toStringValue(parsed.title);
+    if (!title) {
+        return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.TITLE_REQUIRED);
+    }
+    const description = toStringValue(parsed.description);
+    if (!description) {
+        return createMissingParameterOutput(MISSING_PARAMETER_MESSAGES.DESCRIPTION_REQUIRED);
+    }
+    const args = [
+        '--category',
+        category,
+        '--severity',
+        severity,
+        '--title',
+        title,
+        '--description',
+        description,
+    ];
+    const resolution = toStringValue(parsed.resolution);
+    if (resolution) {
+        args.push('--resolution', resolution);
+    }
+    for (const tag of toStringArray(parsed.tags)) {
+        args.push('--tag', tag);
+    }
+    const step = toStringValue(parsed.step);
+    if (step) {
+        args.push('--step', step);
+    }
+    for (const file of toStringArray(parsed.files)) {
+        args.push('--file', file);
+    }
+    return executeAgentTool(AGENT_TOOLS.AGENT_LOG_ISSUE, args);
+}
+export async function agentIssuesQueryTool(input) {
+    const parsed = toRecord(input);
+    const args = ['summary'];
+    const since = toIntegerString(parsed.since);
+    if (since) {
+        args.push('--since', since);
+    }
+    const category = toStringValue(parsed.category);
+    if (category) {
+        args.push('--category', category);
+    }
+    const severity = toStringValue(parsed.severity);
+    if (severity) {
+        args.push('--severity', severity);
+    }
+    return executeAgentTool(AGENT_TOOLS.AGENT_ISSUES_QUERY, args);
+}
+//# sourceMappingURL=agent-tools.js.map

package/dist/tool-impl/agent-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tools.js","sourceRoot":"","sources":["../../tool-impl/agent-tools.ts"],"names":[],"mappings":"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"}

package/dist/tool-impl/delegation-tools.d.ts

@@ -0,0 +1,13 @@
+export interface RecordDelegationInput {
+    parentWuId: string;
+    targetWuId: string;
+    lane: string;
+    registryPath: string;
+    lineage?: string[];
+}
+export interface RecordDelegationResult {
+    success: boolean;
+    delegationId: string;
+}
+export declare function recordDelegationTool(input: RecordDelegationInput): Promise<RecordDelegationResult>;
+//# sourceMappingURL=delegation-tools.d.ts.map

package/dist/tool-impl/delegation-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-tools.d.ts","sourceRoot":"","sources":["../../tool-impl/delegation-tools.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAwBD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAoBjC"}

package/dist/tool-impl/delegation-tools.js

@@ -0,0 +1,45 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/* eslint-disable security/detect-non-literal-fs-filename */
+import { appendFile, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { UTF8_ENCODING } from '../constants.js';
+function migrateLegacyStatePath(registryPath) {
+    const normalized = registryPath.replace(/\\/g, '/');
+    if (normalized.startsWith('.lumenflow/state/')) {
+        return path.join('runtime', 'state', normalized.slice('.lumenflow/state/'.length));
+    }
+    const legacySegment = '/.lumenflow/state/';
+    const segmentIndex = normalized.indexOf(legacySegment);
+    if (segmentIndex < 0) {
+        return registryPath;
+    }
+    return [
+        normalized.slice(0, segmentIndex),
+        'runtime',
+        'state',
+        normalized.slice(segmentIndex + legacySegment.length),
+    ]
+        .filter(Boolean)
+        .join('/');
+}
+export async function recordDelegationTool(input) {
+    const registryPath = migrateLegacyStatePath(input.registryPath);
+    const delegationId = `dlg-${input.parentWuId.toLowerCase()}-${input.targetWuId.toLowerCase()}`;
+    const entry = {
+        id: delegationId,
+        parentWuId: input.parentWuId,
+        targetWuId: input.targetWuId,
+        lane: input.lane,
+        lineage: input.lineage ?? [],
+        delegatedAt: new Date().toISOString(),
+        status: 'pending',
+    };
+    await mkdir(path.dirname(registryPath), { recursive: true });
+    await appendFile(registryPath, `${JSON.stringify(entry)}\n`, UTF8_ENCODING);
+    return {
+        success: true,
+        delegationId,
+    };
+}
+//# sourceMappingURL=delegation-tools.js.map

package/dist/tool-impl/delegation-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delegation-tools.js","sourceRoot":"","sources":["../../tool-impl/delegation-tools.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,4DAA4D;AAC5D,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAehD,SAAS,sBAAsB,CAAC,YAAoB;IAClD,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,MAAM,aAAa,GAAG,oBAAoB,CAAC;IAC3C,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACvD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO;QACL,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC;QACjC,SAAS;QACT,OAAO;QACP,UAAU,CAAC,KAAK,CAAC,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC;KACtD;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAA4B;IAE5B,MAAM,YAAY,GAAG,sBAAsB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,OAAO,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC;IAC/F,MAAM,KAAK,GAAG;QACZ,EAAE,EAAE,YAAY;QAChB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;QAC5B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,MAAM,EAAE,SAAS;KAClB,CAAC;IAEF,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,UAAU,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAE5E,OAAO;QACL,OAAO,EAAE,IAAI;QACb,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/tool-impl/flow-metrics-tools.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @file flow-metrics-tools.ts
+ * @description Software-delivery pack handlers for flow/metrics tools.
+ *
+ * WU-1905: Migrated from in-process resolver stubs in runtime-tool-resolver.ts
+ * to native software-delivery pack handlers.
+ */
+import type { ToolOutput } from '@lumenflow/kernel';
+/**
+ * flow:bottlenecks handler -- identifies flow bottlenecks via CLI.
+ */
+export declare function flowBottlenecksTool(input: unknown): Promise<ToolOutput>;
+/**
+ * flow:report handler -- generates flow metrics report via CLI.
+ */
+export declare function flowReportTool(input: unknown): Promise<ToolOutput>;
+/**
+ * metrics handler -- unified workflow metrics command via CLI.
+ */
+export declare function metricsTool(input: unknown): Promise<ToolOutput>;
+/**
+ * metrics:snapshot handler -- captures metrics snapshot via CLI.
+ */
+export declare function metricsSnapshotTool(_input: unknown): Promise<ToolOutput>;
+//# sourceMappingURL=flow-metrics-tools.d.ts.map

package/dist/tool-impl/flow-metrics-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-metrics-tools.d.ts","sourceRoot":"","sources":["../../tool-impl/flow-metrics-tools.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AA+HpD;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAe7E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAyBxE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAoBrE;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAE9E"}

package/dist/tool-impl/flow-metrics-tools.js

@@ -0,0 +1,152 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { RUNTIME_CLI_COMMANDS, runtimeCliAdapter } from './runtime-cli-adapter.js';
+// --- Tool name constants ---
+const FLOW_METRICS_TOOLS = {
+    FLOW_BOTTLENECKS: 'flow:bottlenecks',
+    FLOW_REPORT: 'flow:report',
+    METRICS: 'metrics',
+    METRICS_SNAPSHOT: 'metrics:snapshot',
+};
+// --- Error code mapping ---
+const FLOW_METRICS_TOOL_ERROR_CODES = {
+    'flow:bottlenecks': 'FLOW_BOTTLENECKS_ERROR',
+    'flow:report': 'FLOW_REPORT_ERROR',
+    metrics: 'METRICS_ERROR',
+    'metrics:snapshot': 'METRICS_SNAPSHOT_ERROR',
+};
+const FLOW_METRICS_TOOL_COMMANDS = {
+    'flow:bottlenecks': RUNTIME_CLI_COMMANDS.FLOW_BOTTLENECKS,
+    'flow:report': RUNTIME_CLI_COMMANDS.FLOW_REPORT,
+    metrics: RUNTIME_CLI_COMMANDS.METRICS,
+    'metrics:snapshot': RUNTIME_CLI_COMMANDS.METRICS_SNAPSHOT,
+};
+// --- Input helpers ---
+function toRecord(input) {
+    if (input && typeof input === 'object') {
+        return input;
+    }
+    return {};
+}
+function toStringValue(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function toNumberValue(value) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value;
+    }
+    return null;
+}
+async function runFlowMetricsCommand(toolName, args) {
+    return runtimeCliAdapter.run(FLOW_METRICS_TOOL_COMMANDS[toolName], args);
+}
+function createFailureOutput(toolName, execution) {
+    const stderrMessage = execution.stderr.trim();
+    const stdoutMessage = execution.stdout.trim();
+    const message = execution.executionError ??
+        (stderrMessage.length > 0
+            ? stderrMessage
+            : stdoutMessage.length > 0
+                ? stdoutMessage
+                : `${toolName} failed`);
+    return {
+        success: false,
+        error: {
+            code: FLOW_METRICS_TOOL_ERROR_CODES[toolName],
+            message,
+            details: {
+                exit_code: execution.status,
+                stdout: execution.stdout,
+                stderr: execution.stderr,
+            },
+        },
+    };
+}
+function createSuccessOutput(toolName, execution) {
+    const message = execution.stdout.trim().length > 0 ? execution.stdout.trim() : `${toolName} ran`;
+    return {
+        success: true,
+        data: {
+            message,
+        },
+    };
+}
+async function executeFlowMetricsTool(toolName, args) {
+    const execution = await runFlowMetricsCommand(toolName, args);
+    if (!execution.ok) {
+        return createFailureOutput(toolName, execution);
+    }
+    return createSuccessOutput(toolName, execution);
+}
+// --- Public tool handlers ---
+/**
+ * flow:bottlenecks handler -- identifies flow bottlenecks via CLI.
+ */
+export async function flowBottlenecksTool(input) {
+    const parsed = toRecord(input);
+    const args = [];
+    const limit = toNumberValue(parsed.limit);
+    if (limit !== null) {
+        args.push('--limit', String(limit));
+    }
+    const format = toStringValue(parsed.format);
+    if (format) {
+        args.push('--format', format);
+    }
+    return executeFlowMetricsTool(FLOW_METRICS_TOOLS.FLOW_BOTTLENECKS, args);
+}
+/**
+ * flow:report handler -- generates flow metrics report via CLI.
+ */
+export async function flowReportTool(input) {
+    const parsed = toRecord(input);
+    const args = [];
+    const start = toStringValue(parsed.start);
+    if (start) {
+        args.push('--start', start);
+    }
+    const end = toStringValue(parsed.end);
+    if (end) {
+        args.push('--end', end);
+    }
+    const days = toNumberValue(parsed.days);
+    if (days !== null) {
+        args.push('--days', String(days));
+    }
+    const format = toStringValue(parsed.format);
+    if (format) {
+        args.push('--format', format);
+    }
+    return executeFlowMetricsTool(FLOW_METRICS_TOOLS.FLOW_REPORT, args);
+}
+/**
+ * metrics handler -- unified workflow metrics command via CLI.
+ */
+export async function metricsTool(input) {
+    const parsed = toRecord(input);
+    const args = [];
+    const subcommand = toStringValue(parsed.subcommand);
+    if (subcommand) {
+        args.push(subcommand);
+    }
+    const days = toNumberValue(parsed.days);
+    if (days !== null) {
+        args.push('--days', String(days));
+    }
+    const format = toStringValue(parsed.format);
+    if (format) {
+        args.push('--format', format);
+    }
+    return executeFlowMetricsTool(FLOW_METRICS_TOOLS.METRICS, args);
+}
+/**
+ * metrics:snapshot handler -- captures metrics snapshot via CLI.
+ */
+export async function metricsSnapshotTool(_input) {
+    return executeFlowMetricsTool(FLOW_METRICS_TOOLS.METRICS_SNAPSHOT, []);
+}
+//# sourceMappingURL=flow-metrics-tools.js.map

package/dist/tool-impl/flow-metrics-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-metrics-tools.js","sourceRoot":"","sources":["../../tool-impl/flow-metrics-tools.ts"],"names":[],"mappings":"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"}

package/dist/tool-impl/git-runner.d.ts

@@ -0,0 +1,13 @@
+export interface GitCommandResult {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+    status: number;
+}
+export declare function resolveGitBinary(): string;
+export declare const GIT_BINARY: string;
+export declare function runGit(args: string[], options?: {
+    cwd?: string;
+    gitBinary?: string;
+}): GitCommandResult;
+//# sourceMappingURL=git-runner.d.ts.map

package/dist/tool-impl/git-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-runner.d.ts","sourceRoot":"","sources":["../../tool-impl/git-runner.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAwBD,wBAAgB,gBAAgB,IAAI,MAAM,CAUzC;AAED,eAAO,MAAM,UAAU,QAAqB,CAAC;AAE7C,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACjD,gBAAgB,CAQlB"}

package/dist/tool-impl/git-runner.js

@@ -0,0 +1,89 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { execFileSync } from 'node:child_process';
+import { UTF8_ENCODING } from '../constants.js';
+const GIT_BINARY_ENV_VAR = 'LUMENFLOW_GIT_BINARY';
+const POSIX_GIT_BINARY = 'git';
+const WINDOWS_GIT_BINARY = 'git.exe';
+function firstNonEmptyLine(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const line = value
+        .split(/\r?\n/)
+        .map((entry) => entry.trim())
+        .find((entry) => entry.length > 0);
+    return line ?? null;
+}
+function resolveGitBinaryFromPath() {
+    const lookupCommand = process.platform === 'win32' ? 'where' : 'which';
+    const lookupTarget = process.platform === 'win32' ? WINDOWS_GIT_BINARY : POSIX_GIT_BINARY;
+    const lookupResult = runCommand(lookupCommand, [lookupTarget], {});
+    if (!lookupResult || lookupResult.status !== 0) {
+        return null;
+    }
+    return firstNonEmptyLine(lookupResult.stdout);
+}
+export function resolveGitBinary() {
+    const configured = process.env[GIT_BINARY_ENV_VAR]?.trim();
+    if (configured && configured.length > 0) {
+        return configured;
+    }
+    const resolved = resolveGitBinaryFromPath();
+    if (resolved) {
+        return resolved;
+    }
+    return process.platform === 'win32' ? WINDOWS_GIT_BINARY : POSIX_GIT_BINARY;
+}
+export const GIT_BINARY = resolveGitBinary();
+export function runGit(args, options = {}) {
+    const result = runCommand(options.gitBinary ?? GIT_BINARY, args, { cwd: options.cwd });
+    return {
+        ok: result.status === 0,
+        stdout: result.stdout,
+        stderr: result.stderr,
+        status: result.status ?? 1,
+    };
+}
+function runCommand(command, args, options) {
+    try {
+        const stdout = execFileSync(command, args, {
+            cwd: options.cwd,
+            encoding: UTF8_ENCODING,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        return {
+            ok: true,
+            stdout,
+            stderr: '',
+            status: 0,
+        };
+    }
+    catch (error) {
+        if (error && typeof error === 'object') {
+            const typedError = error;
+            return {
+                ok: false,
+                stdout: toCommandOutput(typedError.stdout),
+                stderr: toCommandOutput(typedError.stderr) || (typedError.message ?? ''),
+                status: typeof typedError.status === 'number' ? typedError.status : 1,
+            };
+        }
+        return {
+            ok: false,
+            stdout: '',
+            stderr: String(error),
+            status: 1,
+        };
+    }
+}
+function toCommandOutput(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (value instanceof Buffer) {
+        return value.toString(UTF8_ENCODING);
+    }
+    return '';
+}
+//# sourceMappingURL=git-runner.js.map

package/dist/tool-impl/git-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-runner.js","sourceRoot":"","sources":["../../tool-impl/git-runner.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAClD,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAC/B,MAAM,kBAAkB,GAAG,SAAS,CAAC;AASrC,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,KAAK;SACf,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC;AAED,SAAS,wBAAwB;IAC/B,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IACvE,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC1F,MAAM,YAAY,GAAG,UAAU,CAAC,aAAa,EAAE,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC,CAAC;IAEnE,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,iBAAiB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC;IAC3D,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,MAAM,QAAQ,GAAG,wBAAwB,EAAE,CAAC;IAC5C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,gBAAgB,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;AAE7C,MAAM,UAAU,MAAM,CACpB,IAAc,EACd,UAAgD,EAAE;IAElD,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,IAAI,UAAU,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACvF,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,OAAe,EAAE,IAAc,EAAE,OAAyB;IAC5E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE;YACzC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM;YACN,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,CAAC;SACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvC,MAAM,UAAU,GAAG,KAKlB,CAAC;YACF,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC;gBAC1C,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,EAAE,CAAC;gBACxE,MAAM,EAAE,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;aACtE,CAAC;QACJ,CAAC;QAED,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC;YACrB,MAAM,EAAE,CAAC;SACV,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAkC;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,YAAY,MAAM,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/tool-impl/git-tools.d.ts

@@ -0,0 +1,46 @@
+export type GitToolName = 'git:add' | 'git:status' | 'git:commit';
+export interface GitToolContext {
+    run_id: string;
+    task_id: string;
+    session_id: string;
+    cwd: string;
+}
+export interface GitToolOutput {
+    success: boolean;
+    data?: Record<string, unknown>;
+    error?: {
+        code: string;
+        message: string;
+    };
+    metadata?: {
+        artifacts_written?: string[];
+    };
+}
+export interface ToolCallStartedReceipt {
+    schema_version: 1;
+    kind: 'tool_call_started';
+    run_id: string;
+    task_id: string;
+    session_id: string;
+    tool_name: GitToolName;
+}
+export interface ToolCallFinishedReceipt {
+    schema_version: 1;
+    kind: 'tool_call_finished';
+    result: 'success' | 'failure';
+    artifacts_written: string[];
+}
+export interface GitToolHostReceipt {
+    started: ToolCallStartedReceipt;
+    finished: ToolCallFinishedReceipt;
+    output: GitToolOutput;
+}
+export declare function gitStatusTool(input: Record<string, unknown>, cwd: string): Promise<GitToolOutput>;
+export declare function gitAddTool(input: Record<string, unknown>, cwd: string): Promise<GitToolOutput>;
+export declare function gitCommitTool(input: Record<string, unknown>, cwd: string): Promise<GitToolOutput>;
+export declare function runGitToolThroughToolHost(input: {
+    toolName: GitToolName;
+    input: Record<string, unknown>;
+    context: GitToolContext;
+}): Promise<GitToolHostReceipt>;
+//# sourceMappingURL=git-tools.d.ts.map

package/dist/tool-impl/git-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-tools.d.ts","sourceRoot":"","sources":["../../tool-impl/git-tools.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,YAAY,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,CAAC,CAAC;IAClB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,WAAW,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,CAAC,CAAC;IAClB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,uBAAuB,CAAC;IAClC,MAAM,EAAE,aAAa,CAAC;CACvB;AA0CD,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,aAAa,CAAC,CAgGxB;AAED,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,aAAa,CAAC,CAwBxB;AAED,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,aAAa,CAAC,CAsDxB;AAED,wBAAsB,yBAAyB,CAAC,KAAK,EAAE;IACrD,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,EAAE,cAAc,CAAC;CACzB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkC9B"}