@ai-outfitter/outfitter 0.11.0 → 1.0.2

package/code/pi-extension/src/outfitter-runtime-extension.js

@@ -0,0 +1,160 @@
+import { Key, matchesKey, truncateToWidth, visibleWidth, wrapTextWithAnsi } from '@earendil-works/pi-tui';
+
+// Outfitter runtime extension. Unlike the setup walkthrough extension
+// (outfitter-extension.js), this file is loaded into the real profile pi session. Its only job is
+// to restore Outfitter's original "no provider connected yet" sign-in prompt: when pi starts with
+// no models available, it offers to connect one and delegates to pi's native /login command, which
+// persists credentials in pi's own agent directory and selects a default model in-session.
+//
+// The setup pi stays deliberately model-free and MUST NOT open /login (OFTR-010.1.4); that is why
+// the auto-login lives here instead. This file needs no stamped launch-time values, so the CLI
+// loads it directly by absolute path via --extension.
+
+export default function outfitterRuntime(pi) {
+  let loginSubmitted = false;
+
+  const submitSlashCommand = async (ctx, command) => {
+    if (ctx.mode !== 'tui') return false;
+    ctx.ui.setEditorText(command);
+    await ctx.ui.custom(
+      (tui, _theme, _keybindings, done) => {
+        setTimeout(() => {
+          tui.focusedComponent?.handleInput?.('\r');
+          done(true);
+        }, 25);
+        return { render: () => [], invalidate: () => undefined };
+      },
+      { overlay: true, overlayOptions: { nonCapturing: true, visible: () => false } },
+    );
+    return true;
+  };
+
+  const getAvailableModelCount = async (ctx) => {
+    if (ctx.modelRegistry === undefined || typeof ctx.modelRegistry.getAvailable !== 'function') {
+      return ctx.model === undefined ? 0 : 1;
+    }
+    try {
+      const available = await ctx.modelRegistry.getAvailable();
+      return Array.isArray(available) ? available.length : 0;
+    } catch {
+      return ctx.model === undefined ? 0 : 1;
+    }
+  };
+
+  const confirmModelProviderConnection = async (ctx) => {
+    if (typeof ctx.ui.custom !== 'function') return true;
+    const selected = await selectDescribedOption(
+      ctx,
+      [
+        'Pi does not have a model provider connected yet.',
+        'Connect one now so Outfitter can use Pi.',
+        'Credentials stay inside Pi.',
+      ],
+      [
+        {
+          value: 'connect',
+          label: 'Connect a model provider',
+          description: 'Open Pi /login to sign in via OAuth or an API key.',
+        },
+      ],
+      'connect',
+    );
+    return selected === 'connect';
+  };
+
+  const openLoginIfNoModels = async (ctx) => {
+    if (loginSubmitted || ctx.mode !== 'tui') return;
+    const availableModelCount = await getAvailableModelCount(ctx);
+    if (availableModelCount > 0) return;
+    if (!(await confirmModelProviderConnection(ctx))) return;
+    loginSubmitted = await submitSlashCommand(ctx, '/login');
+  };
+
+  pi.on('session_start', async (event, ctx) => {
+    if (ctx.mode !== 'tui') return;
+    if (event.reason === 'startup') await openLoginIfNoModels(ctx);
+  });
+}
+
+// Renders a described-option picker identical to the setup walkthrough's, so the runtime sign-in
+// prompt matches the rest of the Outfitter UI. Falls back to a plain label list when pi does not
+// support custom UI, then resolves the chosen label back to its item value.
+const selectDescribedOption = (ctx, titleLines, items, initialValue) =>
+  ctx.ui.custom((tui, theme, _keybindings, done) => {
+    let selectedIndex = Math.max(
+      0,
+      items.findIndex((item) => item.value === initialValue),
+    );
+    const labelWidth = Math.max(...items.map((item) => item.label.length));
+    let cachedWidth;
+    let cachedLines;
+
+    const finish = (value) => done(value);
+    const refresh = () => {
+      cachedWidth = undefined;
+      cachedLines = undefined;
+      tui.requestRender?.();
+    };
+    const move = (delta) => {
+      selectedIndex = Math.max(0, Math.min(items.length - 1, selectedIndex + delta));
+      refresh();
+    };
+    const render = (width) => {
+      const maxWidth = typeof width === 'number' && width > 0 ? width : 120;
+      if (cachedLines && cachedWidth === maxWidth) return cachedLines;
+      const lines = [];
+      const add = (line) => lines.push(visibleWidth(line) > maxWidth ? truncateToWidth(line, maxWidth) : line);
+      const addWrapped = (line, widthForWrap = maxWidth, prefix = '') => {
+        for (const wrappedLine of wrapTextWithAnsi(line, Math.max(1, widthForWrap))) add(prefix + wrappedLine);
+      };
+      const renderSelectedItem = (prefix, label, description) => {
+        const baseLine = prefix + label;
+        if (!description) {
+          add(baseLine);
+          return;
+        }
+        const inlineDescriptionWidth = maxWidth - visibleWidth(baseLine) - 2;
+        const descriptionText = theme.fg('muted', description);
+        if (inlineDescriptionWidth >= 30) {
+          const [firstLine = '', ...remainingLines] = wrapTextWithAnsi(descriptionText, inlineDescriptionWidth);
+          add(baseLine + '  ' + firstLine);
+          const continuationPrefix = ' '.repeat(Math.min(maxWidth, visibleWidth(baseLine) + 2));
+          for (const line of remainingLines) add(continuationPrefix + line);
+          return;
+        }
+        add(baseLine);
+        addWrapped(descriptionText, maxWidth - 2, '  ');
+      };
+
+      add(theme.fg('accent', '─'.repeat(maxWidth)));
+      titleLines.forEach((line, index) =>
+        addWrapped(index === 0 ? theme.fg('text', ' ' + line) : theme.fg('dim', ' ' + line)),
+      );
+      lines.push('');
+      items.forEach((item, index) => {
+        const selected = index === selectedIndex;
+        const prefix = selected ? theme.fg('accent', '→ ') : '  ';
+        const paddedLabel = item.label.padEnd(labelWidth);
+        const label = selected ? theme.fg('accent', paddedLabel) : paddedLabel;
+        renderSelectedItem(prefix, label, selected ? item.description : undefined);
+      });
+      lines.push('');
+      add(theme.fg('dim', '↑↓ navigate  enter select  escape/ctrl+c cancel'));
+      add(theme.fg('accent', '─'.repeat(maxWidth)));
+      cachedWidth = maxWidth;
+      cachedLines = lines;
+      return lines;
+    };
+
+    return {
+      outfitterOptions: items.map((item) => item.label),
+      render,
+      invalidate: refresh,
+      handleInput: (data) => {
+        if (matchesKey(data, Key.up)) move(-1);
+        else if (matchesKey(data, Key.down)) move(1);
+        else if (matchesKey(data, Key.enter)) finish(items[selectedIndex]?.value);
+        else if (matchesKey(data, Key.escape) || matchesKey(data, Key.ctrl('c'))) finish(undefined);
+      },
+    };
+  });

package/dist/agents/AgentLaunch.d.ts

@@ -1,6 +1,14 @@
-import type { AgentLaunchPlan } from './AgentAdapter.js';
+import type { AgentLaunchPlan } from '../projection/Projection.js';
 export interface AgentProcessLauncher {
     launch(plan: AgentLaunchPlan): Promise<number>;
 }
 export declare const launchAgentProcess: (launcher: AgentProcessLauncher, launchPlan: AgentLaunchPlan, agentId: string) => Promise<number>;
 export declare const resolveAgentLaunchExecutable: (launchPlan: AgentLaunchPlan) => AgentLaunchPlan;
+export declare const spawnLauncher: AgentProcessLauncher;
+/**
+ * Launches a resolved plan through the given spawn boundary. The install-hint agentId is derived
+ * from the logical launch command ('pi' | 'claude') so a missing-CLI failure always names the
+ * harness actually being launched, regardless of how the harness was selected (flag, settings
+ * default, or built-in fallback).
+ */
+export declare const launchThroughSpawn: (spawn: AgentProcessLauncher, plan: AgentLaunchPlan) => Promise<number>;

package/dist/agents/AgentLaunch.js

@@ -39,6 +39,25 @@ export const resolveAgentLaunchExecutable = (launchPlan) => {
         env: { PI_SKIP_VERSION_CHECK: '1', ...launchPlan.env },
     };
 };
+/* v8 ignore start -- real process spawn is covered by end-to-end smoke usage, not unit tests. */
+export const spawnLauncher = {
+    async launch(plan) {
+        const { default: spawn } = await import('cross-spawn');
+        return await new Promise((resolve, reject) => {
+            const child = spawn(plan.command, [...plan.args], { stdio: 'inherit', env: { ...process.env, ...plan.env } });
+            child.on('error', reject); // ENOENT surfaces as an actionable install message
+            child.on('close', (code, signal) => resolve(code ?? (signal ? 1 : 0)));
+        });
+    },
+};
+/* v8 ignore stop */
+/**
+ * Launches a resolved plan through the given spawn boundary. The install-hint agentId is derived
+ * from the logical launch command ('pi' | 'claude') so a missing-CLI failure always names the
+ * harness actually being launched, regardless of how the harness was selected (flag, settings
+ * default, or built-in fallback).
+ */
+export const launchThroughSpawn = (spawn, plan) => launchAgentProcess(spawn, resolveAgentLaunchExecutable(plan), plan.command);
 const isCommandNotFoundError = (error) => error !== null && typeof error === 'object' && 'code' in error && error.code === 'ENOENT';
 const agentCliInstallHints = {
     pi: 'Install Pi with `npm install -g @earendil-works/pi-coding-agent` (see https://pi.dev).',

package/dist/agents/AgentLaunch.js.map

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

package/dist/agents/PiCredentialPersistence.d.ts

@@ -0,0 +1,6 @@
+/** pi's persistent agent directory (`~/.pi/agent`), the durable home for credentials. */
+export declare const resolvePiUserAgentDirectory: (homeDirectory: string) => string;
+/** Seeds the projection root with the user's existing pi credentials so pi sees them at startup. */
+export declare const seedPiCredentials: (projectionRoot: string, piUserAgentDirectory: string) => void;
+/** Copies credentials created or changed during the pi session back to the durable agent dir. */
+export declare const persistPiCredentials: (projectionRoot: string, piUserAgentDirectory: string) => void;

package/dist/agents/PiCredentialPersistence.js

@@ -0,0 +1,33 @@
+// Persists pi credential/provider state across runs. Outfitter launches pi with PI_CODING_AGENT_DIR
+// pointed at an ephemeral, profile-scoped projection root (OFTR-006.3.1/006.4), which pi also uses
+// as the home for auth.json/models.json (pi-coding-agent config.js: getAgentDir()). Left alone, a
+// /login inside that session would be discarded when the projection root is deleted after the run,
+// so the auto sign-in prompt could never converge. To keep provider credentials durable — matching
+// standalone pi and pre-#165 Outfitter — we seed the projection root from pi's persistent agent dir
+// before launch and copy any changes back afterward.
+import { copyFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+// Files that carry pi credentials and provider/model definitions. Both live in getAgentDir() and
+// must survive across the ephemeral projection root.
+const persistentPiStateFiles = ['auth.json', 'models.json'];
+/** pi's persistent agent directory (`~/.pi/agent`), the durable home for credentials. */
+export const resolvePiUserAgentDirectory = (homeDirectory) => join(homeDirectory, '.pi', 'agent');
+const copyIfPresent = (sourcePath, destinationPath) => {
+    if (!existsSync(sourcePath))
+        return;
+    mkdirSync(join(destinationPath, '..'), { recursive: true });
+    copyFileSync(sourcePath, destinationPath);
+};
+/** Seeds the projection root with the user's existing pi credentials so pi sees them at startup. */
+export const seedPiCredentials = (projectionRoot, piUserAgentDirectory) => {
+    for (const file of persistentPiStateFiles) {
+        copyIfPresent(join(piUserAgentDirectory, file), join(projectionRoot, file));
+    }
+};
+/** Copies credentials created or changed during the pi session back to the durable agent dir. */
+export const persistPiCredentials = (projectionRoot, piUserAgentDirectory) => {
+    for (const file of persistentPiStateFiles) {
+        copyIfPresent(join(projectionRoot, file), join(piUserAgentDirectory, file));
+    }
+};
+//# sourceMappingURL=PiCredentialPersistence.js.map

package/dist/agents/PiCredentialPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PiCredentialPersistence.js","sourceRoot":"","sources":["../../src/agents/PiCredentialPersistence.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,mGAAmG;AACnG,kGAAkG;AAClG,mGAAmG;AACnG,mGAAmG;AACnG,oGAAoG;AACpG,qDAAqD;AACrD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,iGAAiG;AACjG,qDAAqD;AACrD,MAAM,sBAAsB,GAAG,CAAC,WAAW,EAAE,aAAa,CAAU,CAAC;AAErE,yFAAyF;AACzF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,aAAqB,EAAU,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAElH,MAAM,aAAa,GAAG,CAAC,UAAkB,EAAE,eAAuB,EAAQ,EAAE;IAC1E,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO;IACpC,SAAS,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,YAAY,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF,oGAAoG;AACpG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,cAAsB,EAAE,oBAA4B,EAAQ,EAAE;IAC9F,KAAK,MAAM,IAAI,IAAI,sBAAsB,EAAE,CAAC;QAC1C,aAAa,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC,CAAC;AAEF,iGAAiG;AACjG,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,cAAsB,EAAE,oBAA4B,EAAQ,EAAE;IACjG,KAAK,MAAM,IAAI,IAAI,sBAAsB,EAAE,CAAC;QAC1C,aAAa,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC,CAAC"}

package/dist/cli/OutfitterCli.js

@@ -1,31 +1,23 @@
 // Assembles the top-level Outfitter Commander program from command objects.
 import { readFileSync } from 'node:fs';
 import { Command } from 'commander';
-import { createProfileCommands } from './commands/profile/Command.js';
-import { createRunCommand, executeRunCommand } from './commands/RunCommand.js';
+import { createDumpCommand } from './commands/DumpCommand.js';
+import { createListCommand } from './commands/ListCommand.js';
+import { createRunAgentCommand } from './commands/RunAgentCommand.js';
 import { createSetupCommand } from './commands/SetupCommand.js';
-import { createSyncCommand } from './commands/SyncCommand.js';
-import { createWelcomeCommand } from './commands/WelcomeCommand.js';
+import { createValidateCommand } from './commands/ValidateCommand.js';
 export const createDefaultCommands = () => [
-    createRunCommand(),
-    createSetupCommand({
-        /* v8 ignore next 2 -- covered by end-to-end CLI smoke usage; unit tests inject this dependency. */
-        async launchSetupSourceProfile(input) {
-            await executeRunCommand({
-                ...input,
-                profileId: input.profileId,
-            });
-        },
-    }),
-    createSyncCommand(),
-    createWelcomeCommand(),
-    ...createProfileCommands(),
+    createRunAgentCommand(),
+    createSetupCommand(),
+    createListCommand(),
+    createValidateCommand(),
+    createDumpCommand(),
 ];
 export const createOutfitterProgram = (commands = createDefaultCommands()) => {
     const program = new Command();
     program
         .name('outfitter')
-        .description('Profile-oriented wrapper for launching pi, Claude Code, and future agent CLIs.')
+        .description('Resolve, compose, and launch .agents agents in pi, Claude Code, and future harnesses.')
         .version(readPackageVersion());
     for (const command of commands) {
         command.register(program);

package/dist/cli/OutfitterCli.js.map

@@ -1 +1 @@
-{"version":3,"file":"OutfitterCli.js","sourceRoot":"","sources":["../../src/cli/OutfitterCli.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEpE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAoB,EAAE,CAAC;IAC1D,gBAAgB,EAAE;IAClB,kBAAkB,CAAC;QACjB,mGAAmG;QACnG,KAAK,CAAC,wBAAwB,CAAC,KAAK;YAClC,MAAM,iBAAiB,CAAC;gBACtB,GAAG,KAAK;gBACR,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IACF,iBAAiB,EAAE;IACnB,oBAAoB,EAAE;IACtB,GAAG,qBAAqB,EAAE;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,WAAqC,qBAAqB,EAAE,EAAW,EAAE;IAC9G,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,WAAW,CAAC;SACjB,WAAW,CAAC,gFAAgF,CAAC;SAC7F,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEjC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,GAAW,EAAE;IACtC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAwB,CAAC;IAE7F,OAAO,WAAW,CAAC,OAAO,CAAC;AAC7B,CAAC,CAAC"}
+{"version":3,"file":"OutfitterCli.js","sourceRoot":"","sources":["../../src/cli/OutfitterCli.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAoB,EAAE,CAAC;IAC1D,qBAAqB,EAAE;IACvB,kBAAkB,EAAE;IACpB,iBAAiB,EAAE;IACnB,qBAAqB,EAAE;IACvB,iBAAiB,EAAE;CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,WAAqC,qBAAqB,EAAE,EAAW,EAAE;IAC9G,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,WAAW,CAAC;SACjB,WAAW,CAAC,uFAAuF,CAAC;SACpG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEjC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAG,GAAW,EAAE;IACtC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAAwB,CAAC;IAE7F,OAAO,WAAW,CAAC,OAAO,CAAC;AAC7B,CAAC,CAAC"}

package/dist/cli/commands/CommandObject.d.ts

@@ -4,8 +4,3 @@ export interface CommandObject {
     readonly description: string;
     register(program: Command): void;
 }
-export interface CommandDescriptor {
-    readonly name: string;
-    readonly description: string;
-}
-export declare const describeCommandObject: (command: CommandObject) => CommandDescriptor;

package/dist/cli/commands/CommandObject.js

@@ -1,5 +1,2 @@
-export const describeCommandObject = (command) => ({
-    name: command.name,
-    description: command.description,
-});
+export {};
 //# sourceMappingURL=CommandObject.js.map

package/dist/cli/commands/CommandObject.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommandObject.js","sourceRoot":"","sources":["../../../src/cli/commands/CommandObject.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,OAAsB,EAAqB,EAAE,CAAC,CAAC;IACnF,IAAI,EAAE,OAAO,CAAC,IAAI;IAClB,WAAW,EAAE,OAAO,CAAC,WAAW;CACjC,CAAC,CAAC"}
+{"version":3,"file":"CommandObject.js","sourceRoot":"","sources":["../../../src/cli/commands/CommandObject.ts"],"names":[],"mappings":""}

package/dist/cli/commands/DumpCommand.d.ts

@@ -0,0 +1,19 @@
+import type { CommandObject } from './CommandObject.js';
+export interface DumpInput {
+    readonly homeDirectory: string;
+    readonly projectDirectory: string;
+    readonly agent?: string;
+    readonly out: string;
+}
+export interface DumpCommandResult {
+    readonly writtenPaths: readonly string[];
+    readonly messages: readonly string[];
+    readonly ok: boolean;
+}
+export interface DumpCommandDependencies {
+    readonly homeDirectory?: string;
+    readonly projectDirectory?: string;
+    readonly writeLine?: (message: string) => void;
+}
+export declare const executeDumpCommand: (input: DumpInput) => DumpCommandResult;
+export declare const createDumpCommand: (dependencies?: DumpCommandDependencies) => CommandObject;

package/dist/cli/commands/DumpCommand.js

@@ -0,0 +1,54 @@
+// Provides `outfitter dump --agent <id> --out <dir>` over the effective resource set.
+import { Command } from 'commander';
+import { dumpAgent } from '../../dump/Dump.js';
+import { resolveEffectiveSet } from '../../resolver/ResolverContext.js';
+import { resolveHomeDirectory, resolveProjectDirectory } from './ProcessDefaults.js';
+const resolveAgentSlug = (settings, requested) => {
+    if (requested !== undefined) {
+        return requested;
+    }
+    if (settings.defaultAgent === undefined) {
+        throw new Error("No agent selected and no 'default_agent' in settings. Pass --agent <id>.");
+    }
+    return settings.defaultAgent;
+};
+export const executeDumpCommand = (input) => {
+    const { set, settings, settingsIssues } = resolveEffectiveSet(input);
+    if (settingsIssues.length > 0) {
+        throw new Error(`Cannot dump with invalid settings: ${settingsIssues.map((issue) => issue.message).join('; ')}`);
+    }
+    const agentSlug = resolveAgentSlug(settings, input.agent);
+    const result = dumpAgent(set, agentSlug, input.out);
+    const ok = result.errors.length === 0;
+    const messages = ok
+        ? [`Dumped '${agentSlug}' to ${input.out} (${result.writtenPaths.length} files).`, ...result.warnings]
+        : [...result.errors, ...result.warnings];
+    return { writtenPaths: result.writtenPaths, messages, ok };
+};
+export const createDumpCommand = (dependencies = {}) => ({
+    name: 'dump',
+    description: 'Write the composed .agents tree for an agent to a directory.',
+    register(program) {
+        program.addCommand(new Command('dump')
+            .description('Write the composed .agents tree for an agent to a directory.')
+            .option('--agent <id>', 'Agent slug to dump (default: settings default_agent).')
+            .option('--out <dir>', 'Output directory.', './outfitter-dump')
+            .action((options) => {
+            const result = executeDumpCommand({
+                /* v8 ignore next 2 -- process defaults are exercised by the CLI entrypoint, not unit tests. */
+                homeDirectory: resolveHomeDirectory(dependencies.homeDirectory),
+                projectDirectory: resolveProjectDirectory(dependencies.projectDirectory),
+                agent: options.agent,
+                out: options.out,
+            });
+            for (const message of result.messages) {
+                /* v8 ignore next -- console fallback is direct CLI behavior; tests inject a writer. */
+                (dependencies.writeLine ?? console.log)(message);
+            }
+            if (!result.ok) {
+                process.exitCode = 1;
+            }
+        }));
+    },
+});
+//# sourceMappingURL=DumpCommand.js.map

package/dist/cli/commands/DumpCommand.js.map

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

package/dist/cli/commands/ListCommand.d.ts

@@ -0,0 +1,17 @@
+import type { CommandObject } from './CommandObject.js';
+export interface ListInput {
+    readonly homeDirectory: string;
+    readonly projectDirectory: string;
+    readonly kind?: string;
+    readonly agent?: string;
+}
+export interface ListResult {
+    readonly messages: readonly string[];
+}
+export interface ListCommandDependencies {
+    readonly homeDirectory?: string;
+    readonly projectDirectory?: string;
+    readonly writeLine?: (message: string) => void;
+}
+export declare const executeListCommand: (input: ListInput) => ListResult;
+export declare const createListCommand: (dependencies?: ListCommandDependencies) => CommandObject;

package/dist/cli/commands/ListCommand.js

@@ -0,0 +1,77 @@
+// Provides `outfitter list [kind]` over the effective resource set.
+import { Command } from 'commander';
+import { agentLocalKinds, compareSlugs, findResource, listAgentResources, listResources, resourceKinds, } from '../../resolver/Resource.js';
+import { resolveEffectiveSet } from '../../resolver/ResolverContext.js';
+import { resolveHomeDirectory, resolveProjectDirectory } from './ProcessDefaults.js';
+const kindByPlural = new Map([
+    ['agents', 'agent'],
+    ['skills', 'skill'],
+    ['knowledge', 'knowledge'],
+    ['commands', 'command'],
+]);
+const pluralByKind = new Map([
+    ['agent', 'agents'],
+    ['skill', 'skills'],
+    ['knowledge', 'knowledge'],
+    ['command', 'commands'],
+]);
+const resolveKindFilter = (kind) => {
+    if (kind === undefined) {
+        return resourceKinds;
+    }
+    const resolved = kindByPlural.get(kind);
+    if (resolved === undefined) {
+        throw new Error(`Unknown resource kind '${kind}'. Expected one of: ${[...kindByPlural.keys()].join(', ')}.`);
+    }
+    return [resolved];
+};
+export const executeListCommand = (input) => {
+    const { set, settingsIssues } = resolveEffectiveSet(input);
+    if (settingsIssues.length > 0) {
+        const detail = settingsIssues.map((issue) => `${issue.filePath}#${issue.path} ${issue.message}`).join('; ');
+        throw new Error(`Cannot list resources with invalid settings: ${detail}`);
+    }
+    const messages = [];
+    if (input.agent !== undefined && findResource(set, 'agent', input.agent) === undefined) {
+        throw new Error(`Unknown agent '${input.agent}'. Run 'outfitter list agents' to see resolvable agents.`);
+    }
+    for (const kind of resolveKindFilter(input.kind)) {
+        const hasAgentContext = input.agent !== undefined && agentLocalKinds.includes(kind);
+        const globalResources = listResources(set, kind);
+        const localResources = hasAgentContext ? listAgentResources(set, input.agent, kind) : [];
+        const resources = new Map(globalResources.map((resource) => [resource.slug, resource]));
+        for (const resource of localResources)
+            resources.set(resource.slug, resource);
+        messages.push(`${pluralByKind.get(kind)}${hasAgentContext ? ` (agent ${input.agent})` : ''}:`);
+        messages.push(...(resources.size === 0
+            ? ['  (none)']
+            : [...resources.values()]
+                .sort((left, right) => compareSlugs(left.slug, right.slug))
+                .map((resource) => `  ${resource.slug}  [${resource.winner.layer.label}${resource.winner.ownerAgent === undefined ? '' : '; agent-local'}]`)));
+    }
+    return { messages };
+};
+export const createListCommand = (dependencies = {}) => ({
+    name: 'list',
+    description: 'List resolvable resources (agents, skills, knowledge, commands).',
+    register(program) {
+        program.addCommand(new Command('list')
+            .description('List resolvable resources (agents, skills, knowledge, commands).')
+            .argument('[kind]', 'Restrict to one kind: agents, skills, knowledge, or commands.')
+            .option('--agent <id>', 'Resolve resources in an agent context, including its agent-local skills/knowledge/commands.')
+            .action((kind, options) => {
+            const result = executeListCommand({
+                /* v8 ignore next 2 -- process defaults are exercised by the CLI entrypoint, not unit tests. */
+                homeDirectory: resolveHomeDirectory(dependencies.homeDirectory),
+                projectDirectory: resolveProjectDirectory(dependencies.projectDirectory),
+                kind,
+                agent: options.agent,
+            });
+            for (const message of result.messages) {
+                /* v8 ignore next -- console fallback is direct CLI behavior; tests inject a writer. */
+                (dependencies.writeLine ?? console.log)(message);
+            }
+        }));
+    },
+});
+//# sourceMappingURL=ListCommand.js.map

package/dist/cli/commands/ListCommand.js.map

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

package/dist/cli/commands/PiRuntimeLaunch.d.ts

@@ -0,0 +1,8 @@
+import type { AgentLaunchPlan } from '../../projection/Projection.js';
+export declare const isNonInteractivePiLaunch: (args: readonly string[]) => boolean;
+/**
+ * Prepends `--extension <runtime>` to a pi launch so the auto sign-in prompt loads. The extension is
+ * a no-op whenever a model is already available, so it is safe to attach to every interactive pi
+ * run. Non-pi and non-interactive launches are returned unchanged.
+ */
+export declare const attachPiRuntimeExtension: (plan: AgentLaunchPlan) => AgentLaunchPlan;

package/dist/cli/commands/PiRuntimeLaunch.js

@@ -0,0 +1,47 @@
+// Attaches the Outfitter runtime pi extension to interactive profile launches. The extension
+// restores Outfitter's original "connect a model provider" sign-in prompt: when pi starts with no
+// models available it offers to connect one and opens pi's native /login. Non-interactive pi
+// launches (--print, --export, --mode json|print|rpc, …) are left untouched so scripted runs never
+// prompt, and non-pi harnesses pass through unchanged.
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+const nonInteractivePiLaunchFlags = new Set(['--print', '-p', '--export', '--list-models']);
+const nonInteractivePiModes = new Set(['json', 'print', 'rpc']);
+const runtimeExtensionAsset = 'pi-extension/src/outfitter-runtime-extension.js';
+export const isNonInteractivePiLaunch = (args) => args.some((arg, index) => {
+    if (nonInteractivePiLaunchFlags.has(arg))
+        return true;
+    if (arg === '--mode')
+        return nonInteractivePiModes.has(args[index + 1] ?? '');
+    if (arg.startsWith('--mode='))
+        return nonInteractivePiModes.has(arg.slice('--mode='.length));
+    return false;
+});
+// Resolves the runtime extension in either the repository layout (code/<asset>) or the packaged npm
+// layout (code/cli/code/<asset>), mirroring SetupCommand's asset resolver.
+const resolveRuntimeExtensionPath = () => {
+    const sourcePath = fileURLToPath(new URL(`../../../../${runtimeExtensionAsset}`, import.meta.url));
+    const packagePath = fileURLToPath(new URL(`../../../code/${runtimeExtensionAsset}`, import.meta.url));
+    /* v8 ignore else -- packaged layout is exercised by the npm package smoke test. */
+    if (existsSync(sourcePath))
+        return sourcePath;
+    /* v8 ignore next 2 -- packaged layout is covered by the package smoke test. */
+    if (existsSync(packagePath))
+        return packagePath;
+    return undefined;
+};
+/**
+ * Prepends `--extension <runtime>` to a pi launch so the auto sign-in prompt loads. The extension is
+ * a no-op whenever a model is already available, so it is safe to attach to every interactive pi
+ * run. Non-pi and non-interactive launches are returned unchanged.
+ */
+export const attachPiRuntimeExtension = (plan) => {
+    if (plan.command !== 'pi' || isNonInteractivePiLaunch(plan.args))
+        return plan;
+    const extensionPath = resolveRuntimeExtensionPath();
+    /* v8 ignore next -- defensive: the runtime extension ships with the package, so it resolves in practice. */
+    if (extensionPath === undefined)
+        return plan;
+    return { ...plan, args: ['--extension', extensionPath, ...plan.args] };
+};
+//# sourceMappingURL=PiRuntimeLaunch.js.map

package/dist/cli/commands/PiRuntimeLaunch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PiRuntimeLaunch.js","sourceRoot":"","sources":["../../../src/cli/commands/PiRuntimeLaunch.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,kGAAkG;AAClG,6FAA6F;AAC7F,mGAAmG;AACnG,uDAAuD;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC;AAC5F,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAEhE,MAAM,qBAAqB,GAAG,iDAAiD,CAAC;AAEhF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,IAAuB,EAAW,EAAE,CAC3E,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;IACvB,IAAI,2BAA2B,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,GAAG,KAAK,QAAQ;QAAE,OAAO,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9E,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7F,OAAO,KAAK,CAAC;AACf,CAAC,CAAC,CAAC;AAEL,oGAAoG;AACpG,2EAA2E;AAC3E,MAAM,2BAA2B,GAAG,GAAuB,EAAE;IAC3D,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,eAAe,qBAAqB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACnG,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,iBAAiB,qBAAqB,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACtG,mFAAmF;IACnF,IAAI,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAC9C,+EAA+E;IAC/E,IAAI,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,WAAW,CAAC;IAChD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,IAAqB,EAAmB,EAAE;IACjF,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE9E,MAAM,aAAa,GAAG,2BAA2B,EAAE,CAAC;IACpD,4GAA4G;IAC5G,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAE7C,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACzE,CAAC,CAAC"}

package/dist/cli/commands/ProcessDefaults.d.ts

@@ -0,0 +1,2 @@
+export declare const resolveHomeDirectory: (provided?: string) => string;
+export declare const resolveProjectDirectory: (provided?: string) => string;

package/dist/cli/commands/ProcessDefaults.js

@@ -0,0 +1,5 @@
+// Resolves process-derived command defaults (home/project directories) in one tested place.
+import { homedir } from 'node:os';
+export const resolveHomeDirectory = (provided) => provided ?? homedir();
+export const resolveProjectDirectory = (provided) => provided ?? process.cwd();
+//# sourceMappingURL=ProcessDefaults.js.map

package/dist/cli/commands/ProcessDefaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessDefaults.js","sourceRoot":"","sources":["../../../src/cli/commands/ProcessDefaults.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAAiB,EAAU,EAAE,CAAC,QAAQ,IAAI,OAAO,EAAE,CAAC;AAEzF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,QAAiB,EAAU,EAAE,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC"}