@shapeshift-labs/loom 0.1.15 → 0.1.17

package/README.md

@@ -34,8 +34,11 @@ Loom gives a repository a durable semantic workspace:
 - `.loom/index.json` records the current imported source graph.
 - `.loom/refs/` and `.loom/HEAD` track semantic graph snapshots.
 - `.loom/graph/current.json` is the current machine-readable source graph.
+- `.loom/graph/runs/` stores durable swarm run graphs by run id.
 - `.loom/projections/` stores target-language projection plans.
 - `loom swarm ...` delegates to Frontier Swarm / Codex worker orchestration.
+- `loom ui ...` opens the dark Loom dashboard against a swarm run or collected
+  swarm collection for inspecting and steering workers.
 - `loom lang ...` delegates to Frontier Lang parsing, source import, slicing,
   projection, and universal AST commands.
 - `loom frontier ...` delegates to Frontier Framework app, evidence, harness,
@@ -51,6 +54,9 @@ loom scan
 loom status --json
 loom snapshot -m "initial semantic graph"
 loom diff --json
+loom run-graph status my-run --json
+loom run-graph import-swarm agent-runs/my-run/collected/run-graph.json --run-id my-run
+loom run-graph import-swarm agent-runs/my-run/live-run-graph-events.jsonl --run-id my-run
 loom project --to python
 loom capabilities
 loom version
@@ -96,13 +102,19 @@ Output: `.loom/graph/current.json`, `.loom/index.json`,
 ### `loom status`
 
 Reports whether the project has Loom config, a current graph, git dirtiness,
-semantic HEAD/ref information, installed Frontier package versions, and
-delegate command availability.
+semantic HEAD/ref information, installed Frontier package versions, delegate
+command availability, and UI launch hints for detected local swarm runs or
+collections.
 
 ```sh
 loom status [--json]
 ```
 
+`--json` includes a `uiLaunch` block with canonical `loom ui ...` and
+`loom swarm dashboard ...` commands. When Loom sees local run evidence under
+`agent-runs/` or `.loom/runs/`, it reports ready-to-copy targets with both bare
+path commands and explicit `--run` or `--collection` forms.
+
 ### `loom graph`
 
 Prints `.loom/graph/current.json`.
@@ -111,6 +123,62 @@ Prints `.loom/graph/current.json`.
 loom graph [--json]
 ```
 
+### `loom run-graph`
+
+Reads and writes durable run dependency graphs stored under
+`.loom/graph/runs/`. Run ids are sanitized into stable filenames, so a run id
+such as `agent-runs/my-run` is stored as
+`.loom/graph/runs/agent-runs_my-run.json`.
+
+```sh
+loom run-graph read [<run-id>] [--run-id <id>]
+loom run-graph status [<run-id>] [--run-id <id>] [--json]
+loom run-graph write-json <file|-> [--run-id <id>] [--json]
+loom run-graph import-swarm <json-or-jsonl|-> [--run-id <id>] [--json]
+```
+
+`read` prints the stored `loom.run-graph` JSON. `status` reports whether the
+graph file is missing, present, or present but invalid without surfacing a raw
+stack trace. `write-json` stores a JSON `loom.run-graph` document using the
+existing Loom run graph writer; pass `-` to read from stdin. `import-swarm`
+normalizes a `frontier.swarm-codex.run-graph` artifact, such as
+`agent-runs/<run>/collected/run-graph.json`, or a live
+`frontier.swarm-codex.live-run-graph-event` JSONL stream, such as
+`agent-runs/<run>/live-run-graph-events.jsonl`, into Loom's durable
+`.loom/graph/runs/` model. Imported graphs are stored as `loom.run-graph`
+documents with `source: "frontier-swarm-codex"`, `sourceKind`, and
+`sourceMetadata` pointing back to the original artifact path/run directory.
+Live JSONL imports also record `sourceMetadata.eventCount` and
+`sourceMetadata.eventTypes`. Native Loom graphs can use `source:
+"loom-native"`; `status --json` includes `sourceKind` so tools can distinguish
+native and imported graphs without parsing free-form metadata.
+
+`loom.run-graph` also accepts an optional `decisionGraph` section for typed
+durable decision graphs. The legacy `graph.nodes: string[]` and dependency
+indexes stay compatible for older job graph readers, while `decisionGraph`
+stores typed nodes, edges, events, snapshots, indexes, and records for evidence,
+gates, semantic changes, merge candidates, tournaments, panels, replays, and
+improvement loops. Built-in node kinds include `intent`, `task`, `worker`,
+`candidate`, `evidence`, `gate`, `decision`, `merge`, `replay`, and `rsi`.
+Swarm imports populate this section alongside the legacy graph.
+
+Typed summaries include `summary.typedCounts` when imported data contains
+recognizable intents, tasks, workers, candidates, gates, evidence, merges,
+panels, tournaments, RSI loops, or semantic changes. `status` prints a compact
+`typed graph:` line for non-JSON output. The JavaScript API also exports
+projection and chunk helpers so UI/read-models can be derived from graph truth
+instead of becoming separate sources of truth:
+
+```ts
+const chain = buildRunGraphChainChunk(['intent:demo', 'task:demo', 'worker:demo']);
+const mergeGate = buildRunGraphPatternChunk('merge-gate', [
+  'candidate:demo',
+  'gate:tests',
+  'merge:demo'
+]);
+const panels = createLoomRunGraphPanelRecords(runGraph.decisionGraph);
+```
+
 ### `loom diff`
 
 Compares the saved graph with the current source tree without mutating `.loom/`.
@@ -162,13 +230,18 @@ loom doctor [--json]
 ```
 
 Required packages are Frontier core, Frontier Lang, Frontier Lang CLI, Frontier
-Lang compiler, Frontier Swarm, Frontier Swarm Codex, and Frontier Framework.
+Lang compiler, Frontier Swarm, Frontier Swarm Codex, Frontier Loom UI, and
+Frontier Framework.
 
 Plain output lists missing packages and delegate availability. `--json` also
 includes `packageName`, `binName`, `required`, `available`, `version`, `cliPath`,
 `resolution`, `pathRequired`, `pathAvailable`, and resolution `error` fields.
 Delegates resolve from installed package bins, so raw `frontier-swarm` or
 `frontier-lang` binaries do not need to be on `PATH` when `loom ...` works.
+For local package development, override a delegate with
+`LOOM_DELEGATE_<COMMAND>_CLI=/path/to/dist/cli.js` or
+`LOOM_DELEGATE_<COMMAND>_PACKAGE_ROOT=/path/to/package`; hyphenated commands
+use underscores, such as `LOOM_DELEGATE_SWARM_CODEX_CLI`.
 
 ### `loom capabilities`
 
@@ -209,15 +282,51 @@ loom swarm doctor
 loom swarm plan --manifest agent-ownership.json --tasks work-queue.json --outDir agent-runs/plan
 loom swarm run --manifest agent-ownership.json --tasks work-queue.json --workspace copy --concurrency 8
 loom swarm collect --run agent-runs/my-run
+loom swarm dashboard agent-runs/my-run/collected
+loom swarm ui agent-runs/my-run --open
+loom ui agent-runs/my-run
+loom swarm continue --collection agent-runs/my-run/collected --backlog swarm-backlog.json --routing-policy model-routing-policy.json
+LOOM_DELEGATE_SWARM_CODEX_CLI=../frontier-swarm-codex/dist/cli.js loom swarm-codex continue --collection agent-runs/my-run/collected
 loom swarm query --run agent-runs/my-run --semantic --readiness ready
 loom swarm tournament show --run agent-runs/my-run
 ```
 
 This exposes swarm planning, run/resume/stop, collect/query, merge admission,
-semantic sidecar inspection, adaptive/tournament scheduling, scoring, cleanup,
-repair-links, and verification commands provided by
+semantic sidecar inspection, adaptive/tournament scheduling, continuation from
+collected child backlogs/model-routing feedback, scoring, cleanup, repair-links,
+and verification commands provided by
 `@shapeshift-labs/frontier-swarm-codex`.
 
+### `loom ui`
+
+Delegates to the installed Frontier Loom UI package. `loom swarm dashboard` and
+`loom swarm ui` are aliases that keep the dashboard discoverable from swarm
+workflows. A bare path is treated as `--run` unless it looks like a collected
+swarm collection directory or `collection.json`, in which case Loom forwards it
+as `--collection`.
+
+```sh
+loom ui [<run-or-collection>] [frontier-loom-ui options...]
+loom swarm dashboard [<run-or-collection>] [frontier-loom-ui options...]
+loom swarm ui [<run-or-collection>] [frontier-loom-ui options...]
+```
+
+Examples:
+
+```sh
+loom ui agent-runs/my-run
+loom swarm dashboard agent-runs/my-run --open
+loom swarm ui agent-runs/my-run --port 4173
+loom swarm dashboard agent-runs/my-run/collected
+loom ui --collection agent-runs/my-run/collected --continuation agent-runs/my-run/continuation
+```
+
+The UI reads dashboard snapshots from `@shapeshift-labs/frontier-swarm-codex`
+and writes steering intent files for the coordinator to consume. The snapshot
+schema and steering API stay in the swarm packages rather than inside the UI.
+Run `loom status --json` to discover local `uiLaunch.detected` run and
+collection commands before opening a dashboard.
+
 ### `loom lang`
 
 Delegates to the published Frontier Lang CLI.
@@ -313,8 +422,17 @@ import {
   snapshotLoomProject,
   diffLoomProject,
   createLoomProjectionPlan,
+  importSwarmCodexRunGraph,
+  normalizeSwarmCodexLiveRunGraphEvents,
+  normalizeSwarmCodexRunGraph,
+  parseSwarmCodexRunGraphInput,
+  buildRunGraphChainChunk,
+  buildRunGraphPatternChunk,
+  createLoomRunGraphPanelRecords,
+  readLoomRunGraph,
   readLoomCapabilities,
-  runDelegateCommand
+  runDelegateCommand,
+  writeLoomRunGraph
 } from '@shapeshift-labs/loom';
 
 await initLoomProject({ name: 'demo', include: ['src/**/*.ts'] });
@@ -322,6 +440,38 @@ const scan = await scanLoomProject();
 const snapshot = await snapshotLoomProject({ message: 'semantic checkpoint' });
 const diff = await diffLoomProject();
 const projection = await createLoomProjectionPlan({ target: 'python' });
+await writeLoomRunGraph({
+  kind: 'loom.run-graph',
+  version: 1,
+  generatedAt: new Date().toISOString(),
+  root: process.cwd(),
+  runId: 'demo',
+  summary: { nodes: 1, edges: 0, roots: 1, leaves: 1, issues: 0 },
+  graph: {
+    nodes: ['task-1'],
+    edges: [],
+    dependentsByJobId: { 'task-1': [] },
+    dependenciesByJobId: { 'task-1': [] },
+    roots: ['task-1'],
+    leaves: ['task-1'],
+    issues: []
+  }
+});
+const runGraph = await readLoomRunGraph({ runId: 'demo' });
+const imported = await importSwarmCodexRunGraph(swarmCodexRunGraphJson, {
+  runId: 'agent-runs/demo',
+  sourcePath: 'agent-runs/demo/collected/run-graph.json'
+});
+const normalized = normalizeSwarmCodexRunGraph(swarmCodexRunGraphJson, {
+  runId: 'agent-runs/demo'
+});
+const liveEvents = parseSwarmCodexRunGraphInput(liveRunGraphJsonl);
+const liveGraph = Array.isArray(liveEvents)
+  ? normalizeSwarmCodexLiveRunGraphEvents(liveEvents, {
+      runId: 'agent-runs/demo',
+      sourcePath: 'agent-runs/demo/live-run-graph-events.jsonl'
+    })
+  : normalizeSwarmCodexRunGraph(liveEvents);
 const capabilities = await readLoomCapabilities();
 await runDelegateCommand('lang', ['import', 'src/app.ts', '--sidecar']);
 ```

package/dist/capabilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAepD,wBAAsB,oBAAoB,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAQtG;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAwBhF"}
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAepD,wBAAsB,oBAAoB,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAQtG;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CA8BhF"}

package/dist/capabilities.js

@@ -28,9 +28,14 @@ export async function inspectDelegates() {
     for (const target of listDelegateTargets()) {
         let available = false;
         let cliPath;
+        let packageRoot;
+        let resolution;
         let error;
         try {
-            cliPath = resolveDelegateTarget(target.command).cliPath;
+            const resolved = resolveDelegateTarget(target.command);
+            cliPath = resolved.cliPath;
+            packageRoot = resolved.packageRoot;
+            resolution = resolved.resolution;
             available = true;
         }
         catch (caught) {
@@ -39,9 +44,10 @@ export async function inspectDelegates() {
         rows.push({
             ...target,
             available,
-            version: await packageVersion(target.packageName) ?? null,
+            version: await readDelegateVersion(packageRoot, target.packageName),
             cliPath,
-            resolution: available ? 'package-bin' : null,
+            packageRoot,
+            resolution: resolution ?? null,
             pathRequired: false,
             pathAvailable: isOnPath(target.binName),
             error
@@ -49,6 +55,18 @@ export async function inspectDelegates() {
     }
     return rows;
 }
+async function readDelegateVersion(packageRoot, packageName) {
+    if (packageRoot) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf8'));
+            return pkg.version ?? null;
+        }
+        catch {
+            // Fall through to package resolution.
+        }
+    }
+    return await packageVersion(packageName) ?? null;
+}
 function isOnPath(binName) {
     const paths = process.env.PATH?.split(path.delimiter).filter(Boolean) ?? [];
     const candidates = process.platform === 'win32' ? [binName, `${binName}.cmd`, `${binName}.exe`] : [binName];

package/dist/capabilities.js.map

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

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAmBA,wBAAsB,UAAU,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAqD9E"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AA6BA,wBAAsB,UAAU,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAuD9E"}

package/dist/cli.js

@@ -2,14 +2,15 @@
 import fs from 'node:fs';
 import { pathToFileURL } from 'node:url';
 import { parseArgs, boolArg, listArg, stringArg } from './args.js';
-import { packageVersion } from './common.js';
+import { abs, packageVersion, pathExists, readJson, resolveRoot } from './common.js';
 import { readLoomCapabilities } from './capabilities.js';
+import { readLoomConfig } from './config.js';
 import { helpText } from './help.js';
 import { printResult } from './output.js';
 import { initLoomProject } from './init.js';
 import { scanLoomProject } from './scan.js';
 import { readLoomStatus, doctorLoomProject } from './status.js';
-import { readLoomGraph } from './graph.js';
+import { importFrontierRunEvents, importSwarmCodexRunGraph, loomRunGraphSourceKind, parseFrontierRunEventsInput, parseSwarmCodexRunGraphInput, readLoomGraph, readLoomRunGraph, writeLoomRunGraph } from './graph.js';
 import { diffLoomProject } from './diff.js';
 import { createLoomProjectionPlan } from './project.js';
 import { catLoomObject, snapshotLoomProject } from './snapshot.js';
@@ -49,6 +50,9 @@ export async function runLoomCli(argv = process.argv.slice(2)) {
         else if (command === 'graph') {
             printResult(await readLoomGraph(), json);
         }
+        else if (command === 'run-graph') {
+            return await runLoomRunGraphCommand(args, json);
+        }
         else if (command === 'diff') {
             printResult(await diffLoomProject(), json);
         }
@@ -87,6 +91,160 @@ export async function runLoomCli(argv = process.argv.slice(2)) {
         return 1;
     }
 }
+async function runLoomRunGraphCommand(args, json) {
+    const subcommand = args._[0] ?? 'status';
+    if (subcommand === 'help' || subcommand === '--help' || subcommand === '-h') {
+        process.stdout.write(runGraphHelpText());
+        return 0;
+    }
+    if (subcommand === 'read') {
+        const runId = runGraphRunId(args, 1);
+        printResult(await readLoomRunGraph({ root: stringArg(args.root), runId }), true);
+        return 0;
+    }
+    if (subcommand === 'status') {
+        printResult(await readLoomRunGraphStatus({ root: stringArg(args.root), runId: runGraphRunId(args, 1) }), json);
+        return 0;
+    }
+    if (subcommand === 'write-json') {
+        const input = args._[1] ?? stringArg(args.input);
+        if (!input)
+            throw new Error('run-graph write-json requires <file|->');
+        const graph = await readRunGraphJson(input);
+        const targetRunId = runGraphRunId(args, 2) ?? graph.runId ?? 'current';
+        const path = await writeLoomRunGraph(graph, { root: stringArg(args.root), runId: targetRunId });
+        printResult({
+            ok: true,
+            message: `wrote loom run graph ${targetRunId}`,
+            path,
+            runId: targetRunId,
+            present: true,
+            graphSummary: graph.summary
+        }, json);
+        return 0;
+    }
+    if (subcommand === 'import-swarm' || subcommand === 'import-swarm-codex') {
+        const input = args._[1] ?? stringArg(args.input);
+        if (!input)
+            throw new Error('run-graph import-swarm requires <file|->');
+        const graph = parseSwarmCodexRunGraphInput(readTextInput(input));
+        const targetRunId = runGraphRunId(args, 2);
+        printResult(await importSwarmCodexRunGraph(graph, {
+            root: stringArg(args.root),
+            runId: targetRunId,
+            sourcePath: input === '-' ? 'stdin' : input
+        }), json);
+        return 0;
+    }
+    if (subcommand === 'import-frontier-run' || subcommand === 'import-run') {
+        const input = args._[1] ?? stringArg(args.input);
+        if (!input)
+            throw new Error('run-graph import-frontier-run requires <run-events.jsonl|->');
+        const events = parseFrontierRunEventsInput(readTextInput(input));
+        const targetRunId = runGraphRunId(args, 2);
+        printResult(await importFrontierRunEvents(events, {
+            root: stringArg(args.root),
+            runId: targetRunId,
+            sourcePath: input === '-' ? 'stdin' : input
+        }), json);
+        return 0;
+    }
+    throw new Error(`unknown run-graph command: ${subcommand}`);
+}
+async function readLoomRunGraphStatus(options) {
+    const root = resolveRoot(options.root);
+    const runId = options.runId ?? 'current';
+    const label = options.runId ?? 'current';
+    let path;
+    try {
+        const config = await readLoomConfig(root);
+        path = abs(root, `${config.generated.graph}/runs/${loomRunGraphFileName(options.runId)}.json`);
+    }
+    catch (error) {
+        return {
+            ok: false,
+            message: errorMessage(error),
+            runId: label,
+            present: false
+        };
+    }
+    if (!(await pathExists(path))) {
+        return {
+            ok: false,
+            message: `missing loom run graph for ${label}`,
+            path,
+            runId: label,
+            present: false
+        };
+    }
+    try {
+        const graph = await readLoomRunGraph(options);
+        const sourceKind = loomRunGraphSourceKind(graph);
+        return {
+            ok: true,
+            message: `found loom run graph ${graph.runId ?? runId}`,
+            path,
+            runId: graph.runId ?? runId,
+            present: true,
+            planId: graph.planId,
+            source: graph.source ?? sourceKind,
+            sourceKind,
+            sourceMetadata: graph.sourceMetadata,
+            graphSummary: graph.summary
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            message: `invalid loom run graph for ${label}: ${errorMessage(error)}`,
+            path,
+            runId: label,
+            present: true
+        };
+    }
+}
+function runGraphRunId(args, positionalIndex) {
+    return stringArg(args['run-id'] ?? args.runId ?? args.run ?? args.id) ?? args._[positionalIndex];
+}
+async function readRunGraphJson(input) {
+    return readJsonInput(input);
+}
+async function readJsonInput(input) {
+    if (input === '-')
+        return JSON.parse(readTextInput(input));
+    return readJson(input);
+}
+function readTextInput(input) {
+    if (input === '-')
+        return fs.readFileSync(0, 'utf8');
+    return fs.readFileSync(input, 'utf8');
+}
+function loomRunGraphFileName(runId = 'current') {
+    const cleaned = runId.trim().replace(/[^A-Za-z0-9._-]+/g, '_').replace(/^_+|_+$/g, '');
+    return cleaned || 'current';
+}
+function runGraphHelpText() {
+    return `loom run-graph - durable swarm run dependency graph helpers
+
+Usage:
+  loom run-graph read [<run-id>] [--run-id <id>]
+  loom run-graph status [<run-id>] [--run-id <id>] [--json]
+  loom run-graph write-json <file|-> [--run-id <id>] [--json]
+  loom run-graph import-swarm <json-or-jsonl|-> [--run-id <id>] [--json]
+  loom run-graph import-frontier-run <run-events.jsonl|-> [--run-id <id>] [--json]
+
+Examples:
+  loom run-graph status agent-run-2026 --json
+  loom run-graph read agent-run-2026
+  loom run-graph write-json run-graph.json --run-id agent-run-2026
+  loom run-graph import-swarm agent-runs/my-run/collected/run-graph.json --run-id agent-runs/my-run
+  loom run-graph import-swarm agent-runs/my-run/live-run-graph-events.jsonl --run-id agent-runs/my-run
+  loom run-graph import-frontier-run agent-runs/my-run/run-events.jsonl --run-id agent-runs/my-run
+`;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
 function isCliEntrypoint() {
     if (!process.argv[1])
         return false;

package/dist/cli.js.map

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

package/dist/delegate.d.ts

@@ -4,14 +4,19 @@ export interface DelegateTarget {
     required: boolean;
     description: string;
 }
+export type DelegateResolution = 'env-cli' | 'env-package-root' | 'package-bin';
+export interface ResolvedDelegateTarget {
+    target: DelegateTarget;
+    cliPath: string;
+    packageRoot?: string;
+    resolution: DelegateResolution;
+}
 export declare const delegateTargets: Record<string, DelegateTarget>;
 export declare function isDelegateCommand(command: string): boolean;
 export declare function listDelegateTargets(): Array<{
     command: string;
 } & DelegateTarget>;
-export declare function resolveDelegateTarget(command: string): {
-    target: DelegateTarget;
-    cliPath: string;
-};
+export declare function resolveDelegateTarget(command: string): ResolvedDelegateTarget;
 export declare function runDelegateCommand(command: string, args: string[]): Promise<number>;
+export declare function normalizeLoomUiArgs(args: string[]): string[];
 //# sourceMappingURL=delegate.d.ts.map

package/dist/delegate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../src/delegate.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAqC1D,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,mBAAmB,IAAI,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CAAC,CAEjF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAUlG;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAazF"}
+{"version":3,"file":"delegate.d.ts","sourceRoot":"","sources":["../src/delegate.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,kBAAkB,GAAG,aAAa,CAAC;AAEhF,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CA2C1D,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,mBAAmB,IAAI,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CAAC,CAEjF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,CAsB7E;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAczF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAa5D"}