ikarmic-forge 0.0.0-stage → 4.4.0

package/dist/components/ToolEvent.js

@@ -0,0 +1,54 @@
+import React from 'react';
+import { Box, Text } from 'ink';
+import { getUnifiedDiffText, summarizeResult } from '../tool-display.js';
+function diffLineColor(line) {
+    if (line.startsWith('+++') || line.startsWith('---'))
+        return 'gray';
+    if (line.startsWith('@@'))
+        return 'cyan';
+    if (line.startsWith('+'))
+        return 'green';
+    if (line.startsWith('-'))
+        return 'red';
+    return 'gray';
+}
+export const ToolEvent = React.memo(function ToolEvent(props) {
+    const { name, args, result, isError, durationMs, pending, detail = 'compact' } = props;
+    const argSummary = summarizeArgs(args);
+    const diffText = pending ? null : getUnifiedDiffText(name, args, result);
+    const resultSummary = pending || diffText ? undefined : summarizeResult(result, isError, detail);
+    return (React.createElement(Box, { flexDirection: "column", marginLeft: 2, marginTop: 1 },
+        React.createElement(Box, null,
+            React.createElement(Text, { color: isError ? 'red' : 'blue', bold: true },
+                isError ? '✗' : pending ? '◌' : '✓',
+                " ",
+                name),
+            React.createElement(Text, { color: "gray" }, argSummary),
+            durationMs !== undefined && (React.createElement(Text, { color: "gray" },
+                " \u00B7 ",
+                durationMs,
+                "ms"))),
+        diffText && (React.createElement(Box, { flexDirection: "column", marginLeft: 2 }, diffText.replace(/\n$/, '').split('\n').map((line, i) => (React.createElement(Text, { key: i, color: diffLineColor(line) }, line))))),
+        resultSummary !== undefined && (React.createElement(Box, { marginLeft: 2 },
+            React.createElement(Text, { color: isError ? 'red' : 'gray' }, resultSummary)))));
+});
+function summarizeArgs(args) {
+    if (args === undefined || args === null)
+        return '()';
+    if (typeof args !== 'object')
+        return `(${String(args)})`;
+    const obj = args;
+    const keys = Object.keys(obj);
+    if (keys.length === 0)
+        return '()';
+    const parts = keys.slice(0, 3).map((k) => {
+        const v = obj[k];
+        const vs = typeof v === 'string' ? JSON.stringify(v) : JSON.stringify(v);
+        const truncated = vs.length > 80 ? vs.slice(0, 77) + '...' : vs;
+        return `${k}=${truncated}`;
+    });
+    if (keys.length > 3)
+        parts.push(`+${keys.length - 3} more`);
+    return `(${parts.join(' ')})`;
+}
+//# sourceMappingURL=ToolEvent.js.map

package/dist/components/ToolEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolEvent.js","sourceRoot":"","sources":["../../src/components/ToolEvent.tsx"],"names":[],"mappings":"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"}

package/dist/credential-store.d.ts

@@ -0,0 +1,8 @@
+import type { CredentialStore } from '@ikarmic/forge-core';
+/**
+ * OS-keychain-backed CredentialStore for the CLI. Uses the same
+ * service/account naming as the VS Code SecretStorage implementation
+ * so a key entered on one surface is visible on the other.
+ */
+export declare function createKeyringCredentialStore(): CredentialStore;
+//# sourceMappingURL=credential-store.d.ts.map

package/dist/credential-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-store.d.ts","sourceRoot":"","sources":["../src/credential-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,4BAA4B,IAAI,eAAe,CA0B9D"}

package/dist/credential-store.js

@@ -0,0 +1,37 @@
+import { Entry } from '@napi-rs/keyring';
+import { CREDENTIAL_SERVICE_NAME, credentialAccountKey } from '@ikarmic/forge-core';
+/**
+ * OS-keychain-backed CredentialStore for the CLI. Uses the same
+ * service/account naming as the VS Code SecretStorage implementation
+ * so a key entered on one surface is visible on the other.
+ */
+export function createKeyringCredentialStore() {
+    return {
+        async get(provider) {
+            try {
+                const entry = new Entry(CREDENTIAL_SERVICE_NAME, credentialAccountKey(provider));
+                return entry.getPassword() ?? undefined;
+            }
+            catch {
+                // OS keychain unavailable (e.g. headless Linux without libsecret): 
+                // treat as "not set" rather than surfacing a low-level error.
+                return undefined;
+            }
+        },
+        async set(provider, key) {
+            const entry = new Entry(CREDENTIAL_SERVICE_NAME, credentialAccountKey(provider));
+            entry.setPassword(key);
+        },
+        async delete(provider) {
+            try {
+                const entry = new Entry(CREDENTIAL_SERVICE_NAME, credentialAccountKey(provider));
+                entry.deletePassword();
+            }
+            catch {
+                // Already absent, or keychain unavailable: deleting a
+                // non-existent entry is a no-op either way.
+            }
+        },
+    };
+}
+//# sourceMappingURL=credential-store.js.map

package/dist/credential-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential-store.js","sourceRoot":"","sources":["../src/credential-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGpF;;;;GAIG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,QAAQ;YAChB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,uBAAuB,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACjF,OAAO,KAAK,CAAC,WAAW,EAAE,IAAI,SAAS,CAAC;YAC1C,CAAC;YAAC,MAAM,CAAC;gBACP,oEAAoE;gBACpE,8DAA8D;gBAC9D,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG;YACrB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,uBAAuB,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;YACjF,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,QAAQ;YACnB,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,uBAAuB,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACjF,KAAK,CAAC,cAAc,EAAE,CAAC;YACzB,CAAC;YAAC,MAAM,CAAC;gBACP,sDAAsD;gBACtD,4CAA4C;YAC9C,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/git-workflow.d.ts

@@ -0,0 +1,16 @@
+import type { ForgeCommit, GitCommitOptions, ModelConfig } from '@ikarmic/forge-core';
+import type { CliOptions } from './options.js';
+export interface GitWorkflow {
+    /** Call before the agent starts. Returns the commit that saved your own changes, if any. */
+    before(): Promise<ForgeCommit | null>;
+    /** Call after a completed run. Returns the commit holding the agent's changes, if any. */
+    after(task: string): Promise<ForgeCommit | null>;
+}
+export declare function gitCommitOptions(options: Pick<CliOptions, 'noAttribute' | 'gitCommitVerify'>): GitCommitOptions;
+/** Commit messages use the cheap model when one is configured, else the main model. */
+export declare function resolveCommitModel(options: Pick<CliOptions, 'cheapModel'>, model: ModelConfig): Promise<ModelConfig>;
+export declare function createGitWorkflow(options: Pick<CliOptions, 'autoCommit' | 'noDirtyCommits' | 'noAttribute' | 'gitCommitVerify' | 'cheapModel'> & {
+    dryRun?: boolean;
+}, cwd: string, model: ModelConfig): Promise<GitWorkflow | null>;
+export declare function formatCommitLine(commit: ForgeCommit): string;
+//# sourceMappingURL=git-workflow.d.ts.map

package/dist/git-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-workflow.d.ts","sourceRoot":"","sources":["../src/git-workflow.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,WAAW;IAC1B,4FAA4F;IAC5F,MAAM,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACtC,0FAA0F;IAC1F,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CAClD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,GAAG,iBAAiB,CAAC,GAAG,gBAAgB,CAE/G;AAED,uFAAuF;AACvF,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAI1H;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,YAAY,GAAG,gBAAgB,GAAG,aAAa,GAAG,iBAAiB,GAAG,YAAY,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,EACpI,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,WAAW,GACjB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAe7B;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAG5D"}

package/dist/git-workflow.js

@@ -0,0 +1,38 @@
+/**
+ * `--auto-commit`: commit the user's dirty work before a run, then what the
+ * agent changed after it, with a message drafted by the cheap model (or the
+ * main one). Always a no-op outside a git repo.
+ */
+import { afterRun, beforeRun, isGitRepo, loadForgeConfigFile, resolveModelAlias } from '@ikarmic/forge-core';
+export function gitCommitOptions(options) {
+    return { attribute: !options.noAttribute, verify: options.gitCommitVerify };
+}
+/** Commit messages use the cheap model when one is configured, else the main model. */
+export async function resolveCommitModel(options, model) {
+    if (!options.cheapModel)
+        return model;
+    const { config } = await loadForgeConfigFile();
+    return { ...model, ...resolveModelAlias(options.cheapModel, config.aliases, model.provider) };
+}
+export async function createGitWorkflow(options, cwd, model) {
+    if (!options.autoCommit || options.dryRun || !(await isGitRepo(cwd)))
+        return null;
+    const commitModel = await resolveCommitModel(options, model);
+    const commitOptions = gitCommitOptions(options);
+    let leftDirty = [];
+    return {
+        async before() {
+            const state = await beforeRun(cwd, { ...commitOptions, dirtyCommits: !options.noDirtyCommits });
+            leftDirty = state.leftDirty;
+            return state.dirtyCommit;
+        },
+        after(task) {
+            return afterRun(cwd, { leftDirty }, { ...commitOptions, model: commitModel, task });
+        },
+    };
+}
+export function formatCommitLine(commit) {
+    const first = commit.message.split('\n')[0] ?? '';
+    return `committed ${commit.commit.slice(0, 7)} ${first} (${commit.files.length} file${commit.files.length === 1 ? '' : 's'})`;
+}
+//# sourceMappingURL=git-workflow.js.map

package/dist/git-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-workflow.js","sourceRoot":"","sources":["../src/git-workflow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAW7G,MAAM,UAAU,gBAAgB,CAAC,OAA4D;IAC3F,OAAO,EAAE,SAAS,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;AAC9E,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAuC,EAAE,KAAkB;IAClG,IAAI,CAAC,OAAO,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAC/C,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,iBAAiB,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;AAChG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAoI,EACpI,GAAW,EACX,KAAkB;IAElB,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAClF,MAAM,WAAW,GAAG,MAAM,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7D,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,SAAS,GAAa,EAAE,CAAC;IAC7B,OAAO;QACL,KAAK,CAAC,MAAM;YACV,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,GAAG,aAAa,EAAE,YAAY,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;YAChG,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;YAC5B,OAAO,KAAK,CAAC,WAAW,CAAC;QAC3B,CAAC;QACD,KAAK,CAAC,IAAI;YACR,OAAO,QAAQ,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACtF,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAmB;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,OAAO,aAAa,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,QAAQ,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAChI,CAAC"}

package/dist/mcp-loader.d.ts

@@ -0,0 +1,25 @@
+import { type ConnectedMcpServer, type ToolDefinition } from '@ikarmic/forge-core';
+/**
+ * Load MCP servers from one or more config files and return their
+ * tools plus a cleanup handle the caller MUST invoke (e.g. on shutdown
+ * / task finish).
+ *
+ * Sources are merged in priority order:
+ *
+ *   1. `configPath`: explicit `--mcp-config <path>` from the CLI. Takes
+ *      precedence when the same server name appears in multiple sources.
+ *   2. `~/.forge/mcp.json`: the user's marketplace registry. Servers
+ *      installed via `forge mcp install` live here and are loaded
+ *      automatically on every run.
+ *
+ * If both paths are the same file (or one is missing), they're handled
+ * without double-loading. If a path doesn't exist or MCP loading fails
+ * for any reason, the loader returns empty tools + a no-op cleanup and
+ * logs the error: MCP is an optional enhancement, not a hard dependency.
+ */
+export declare function loadMcpTools(configPath: string): Promise<{
+    tools: ToolDefinition[];
+    cleanup: () => Promise<void>;
+    servers: ConnectedMcpServer[];
+}>;
+//# sourceMappingURL=mcp-loader.d.ts.map

package/dist/mcp-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-loader.d.ts","sourceRoot":"","sources":["../src/mcp-loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,kBAAkB,EAEvB,KAAK,cAAc,EACpB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAAC,CAgEnG"}

package/dist/mcp-loader.js

@@ -0,0 +1,99 @@
+import process from 'node:process';
+import { closeAll, connectAll, defaultUserMcpPath, loadPluginMcpServers, loadMcpConfig, } from '@ikarmic/forge-core';
+/**
+ * Load MCP servers from one or more config files and return their
+ * tools plus a cleanup handle the caller MUST invoke (e.g. on shutdown
+ * / task finish).
+ *
+ * Sources are merged in priority order:
+ *
+ *   1. `configPath`: explicit `--mcp-config <path>` from the CLI. Takes
+ *      precedence when the same server name appears in multiple sources.
+ *   2. `~/.forge/mcp.json`: the user's marketplace registry. Servers
+ *      installed via `forge mcp install` live here and are loaded
+ *      automatically on every run.
+ *
+ * If both paths are the same file (or one is missing), they're handled
+ * without double-loading. If a path doesn't exist or MCP loading fails
+ * for any reason, the loader returns empty tools + a no-op cleanup and
+ * logs the error: MCP is an optional enhancement, not a hard dependency.
+ */
+export async function loadMcpTools(configPath) {
+    const userMcpPath = defaultUserMcpPath();
+    // Merge the two sources. Explicit config wins on name conflicts.
+    let merged = { mcpServers: {} };
+    const sourcesLoaded = [];
+    // 0. Servers shipped by global plugins (lowest priority).
+    const pluginServers = await loadPluginMcpServers(process.cwd()).catch(() => ({}));
+    if (Object.keys(pluginServers).length > 0) {
+        merged = mergeMcpConfigs(merged, { mcpServers: pluginServers });
+        sourcesLoaded.push('plugins');
+    }
+    // 1. User-level registry (overrides plugins).
+    if (userMcpPath !== configPath) {
+        try {
+            const userConfig = await loadMcpConfig(userMcpPath);
+            merged = mergeMcpConfigs(merged, userConfig);
+            sourcesLoaded.push(userMcpPath);
+        }
+        catch (err) {
+            if (!isMissingFile(err)) {
+                process.stderr.write(`forge: MCP loader (user registry) failed: ${err.message}\n`);
+            }
+        }
+    }
+    // 2. Explicit config wins on conflicts.
+    try {
+        const config = await loadMcpConfig(configPath);
+        merged = mergeMcpConfigs(merged, config);
+        sourcesLoaded.push(configPath);
+    }
+    catch (err) {
+        if (isMissingFile(err)) {
+            // When the only source is the missing explicit config AND the user
+            // registry was also missing, fall through to the "no MCP" branch.
+            if (sourcesLoaded.length === 0) {
+                return { tools: [], cleanup: async () => { }, servers: [] };
+            }
+        }
+        else {
+            process.stderr.write(`forge: MCP loader failed: ${err.message}\n`);
+            return { tools: [], cleanup: async () => { }, servers: [] };
+        }
+    }
+    let connected = [];
+    try {
+        connected = await connectAll(merged);
+    }
+    catch (err) {
+        process.stderr.write(`forge: MCP connect failed: ${err.message}\n`);
+        return { tools: [], cleanup: async () => { }, servers: [] };
+    }
+    const tools = connected.flatMap((s) => s.tools);
+    const cleanup = async () => {
+        await closeAll(connected);
+    };
+    // Brief startup announcement so the user knows MCP is active.
+    if (connected.length > 0 && process.env.FORGE_VERBOSE_MCP === '1') {
+        process.stderr.write(`forge: connected to ${connected.length} MCP server${connected.length === 1 ? '' : 's'} from ${sourcesLoaded.length} source${sourcesLoaded.length === 1 ? '' : 's'}; ${tools.length} tool${tools.length === 1 ? '' : 's'} available\n`);
+    }
+    return { tools, cleanup, servers: connected };
+}
+/**
+ * Merge two MCP configs. Entries from `override` win on name conflicts;
+ * entries from `base` are kept otherwise. The function is pure: both
+ * inputs are read-only.
+ */
+function mergeMcpConfigs(base, override) {
+    return {
+        mcpServers: {
+            ...base.mcpServers,
+            ...override.mcpServers,
+        },
+    };
+}
+function isMissingFile(err) {
+    return Boolean(err && typeof err === 'object' && 'code' in err &&
+        err.code === 'ENOENT');
+}
+//# sourceMappingURL=mcp-loader.js.map

package/dist/mcp-loader.js.map

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

package/dist/notify.d.ts

@@ -0,0 +1,12 @@
+export interface NotifyOptions {
+    command?: string | null;
+}
+export type Notifier = (message: string) => void;
+/** The OS-specific command line, or null when there is no known backend. */
+export declare function defaultNotifyCommand(platform?: NodeJS.Platform): {
+    cmd: string;
+    args: string[];
+} | null;
+/** Fire-and-forget; a missing backend or a failing command never affects the run. */
+export declare function createNotifier(opts: NotifyOptions): Notifier;
+//# sourceMappingURL=notify.d.ts.map

package/dist/notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAIjD,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAczH;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,QAAQ,CAmB5D"}

package/dist/notify.js

@@ -0,0 +1,47 @@
+/**
+ * Desktop notification when Forge finishes and waits on you (`--notifications`).
+ * `--notifications-command <cmd>` replaces the OS default; the message is passed
+ * in the FORGE_NOTIFY_MESSAGE environment variable (and FORGE_NOTIFY_TITLE).
+ */
+import { spawn } from 'node:child_process';
+const TITLE = 'IKarmic AI Forge';
+/** The OS-specific command line, or null when there is no known backend. */
+export function defaultNotifyCommand(platform = process.platform) {
+    if (platform === 'darwin') {
+        return { cmd: 'osascript', args: ['-e', 'display notification (system attribute "FORGE_NOTIFY_MESSAGE") with title (system attribute "FORGE_NOTIFY_TITLE")'] };
+    }
+    if (platform === 'linux') {
+        return { cmd: 'notify-send', args: [TITLE, '--', ''] };
+    }
+    if (platform === 'win32') {
+        return {
+            cmd: 'powershell',
+            args: ['-NoProfile', '-Command', 'Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.MessageBox]::Show($env:FORGE_NOTIFY_MESSAGE, $env:FORGE_NOTIFY_TITLE) | Out-Null'],
+        };
+    }
+    return null;
+}
+/** Fire-and-forget; a missing backend or a failing command never affects the run. */
+export function createNotifier(opts) {
+    return (message) => {
+        const env = { ...process.env, FORGE_NOTIFY_MESSAGE: message, FORGE_NOTIFY_TITLE: TITLE };
+        try {
+            const child = opts.command
+                ? spawn(opts.command, { shell: true, env, stdio: 'ignore' })
+                : (() => {
+                    const d = defaultNotifyCommand();
+                    if (!d)
+                        return null;
+                    // notify-send takes the body as an argument rather than from the environment.
+                    const args = d.cmd === 'notify-send' ? [TITLE, message] : d.args;
+                    return spawn(d.cmd, args, { env, stdio: 'ignore' });
+                })();
+            child?.on('error', () => { });
+            child?.unref();
+        }
+        catch {
+            // Notifications are best effort.
+        }
+    };
+}
+//# sourceMappingURL=notify.js.map

package/dist/notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAQ3C,MAAM,KAAK,GAAG,kBAAkB,CAAC;AAEjC,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,WAA4B,OAAO,CAAC,QAAQ;IAC/E,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,mHAAmH,CAAC,EAAE,CAAC;IACjK,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO;YACL,GAAG,EAAE,YAAY;YACjB,IAAI,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,qJAAqJ,CAAC;SACxL,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,cAAc,CAAC,IAAmB;IAChD,OAAO,CAAC,OAAe,EAAQ,EAAE;QAC/B,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,oBAAoB,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC;QACzF,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO;gBACxB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;gBAC5D,CAAC,CAAC,CAAC,GAAG,EAAE;oBACJ,MAAM,CAAC,GAAG,oBAAoB,EAAE,CAAC;oBACjC,IAAI,CAAC,CAAC;wBAAE,OAAO,IAAI,CAAC;oBACpB,8EAA8E;oBAC9E,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;oBACjE,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACtD,CAAC,CAAC,EAAE,CAAC;YACT,KAAK,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC7B,KAAK,EAAE,KAAK,EAAE,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,iCAAiC;QACnC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}