@ai-outfitter/outfitter 0.11.0 → 1.0.2

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

@@ -0,0 +1,46 @@
+import type { PiInstallSpawner } from '../../extensions/PiExtensionCache.js';
+import type { AgentLaunchPlan } from '../../projection/Projection.js';
+import type { SetupResult } from '../../setup/Setup.js';
+import type { CommandObject } from './CommandObject.js';
+export type AgentProcessLauncher = (plan: AgentLaunchPlan) => Promise<number>;
+/**
+ * Runs first-run onboarding when `run` finds nothing configured. Returns the setup result, or
+ * `undefined` when setup was not performed (e.g. non-interactive), so the caller falls back to the
+ * normal "no agent selected" error.
+ */
+export type SetupRunner = (input: {
+    homeDirectory: string;
+    projectDirectory: string;
+}) => Promise<SetupResult | undefined>;
+export interface RunAgentInput {
+    readonly homeDirectory: string;
+    readonly projectDirectory: string;
+    readonly agent?: string;
+    readonly harness?: string;
+    readonly strict?: boolean;
+    readonly passThroughArgs?: readonly string[];
+    readonly launcher: AgentProcessLauncher;
+    /** Onboarding to run once when no agent is selected and settings define no `default_agent`. */
+    readonly setup?: SetupRunner;
+    /** Keep the runtime projection directory after the run (debugging). */
+    readonly retainProjection?: boolean;
+    /** Sink for setup notices and warnings; emitted before launch so they precede the pi session. */
+    readonly writeLine?: (message: string) => void;
+    /** Test seam for the `pi install` boundary used to cache pi extensions. */
+    readonly extensionInstallSpawner?: PiInstallSpawner;
+}
+export interface RunAgentResult {
+    readonly launchPlan?: AgentLaunchPlan;
+    readonly exitCode: number;
+    readonly messages: readonly string[];
+}
+export interface RunAgentDependencies {
+    readonly homeDirectory?: string;
+    readonly projectDirectory?: string;
+    readonly launcher?: AgentProcessLauncher;
+    readonly setup?: SetupRunner;
+    readonly writeLine?: (message: string) => void;
+}
+export declare const executeRunAgentCommand: (input: RunAgentInput) => Promise<RunAgentResult>;
+export { launchThroughSpawn } from '../../agents/AgentLaunch.js';
+export declare const createRunAgentCommand: (dependencies?: RunAgentDependencies) => CommandObject;

package/dist/cli/commands/RunAgentCommand.js

@@ -0,0 +1,176 @@
+// `outfitter run [agent]` — resolve → compose → project → launch on the .agents model.
+import { mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { Option } from 'commander';
+import { launchThroughSpawn, spawnLauncher } from '../../agents/AgentLaunch.js';
+import { persistPiCredentials, resolvePiUserAgentDirectory, seedPiCredentials, } from '../../agents/PiCredentialPersistence.js';
+import { compose } from '../../composer/Composer.js';
+import { ensurePiExtensions } from '../../extensions/PiExtensionCache.js';
+import { resolveOutfitterCacheDir } from '../../paths/OutfitterCache.js';
+import { projectComposition } from '../../projection/ProjectHarness.js';
+import { findResource } from '../../resolver/Resource.js';
+import { resolveEffectiveSet } from '../../resolver/ResolverContext.js';
+import { HARNESSES } from '../../settings/Settings.js';
+import { attachPiRuntimeExtension } from './PiRuntimeLaunch.js';
+import { resolveHomeDirectory, resolveProjectDirectory } from './ProcessDefaults.js';
+import { runSetup } from './SetupCommand.js';
+/* v8 ignore start -- real-TTY onboarding wiring; the setup state machine is tested via an injected runner. */
+// Onboard only when attached to a real terminal; scripted/CI runs get the normal "no agent" error.
+const interactiveSetupRunner = async ({ homeDirectory, projectDirectory }) => runSetup({ homeDirectory, projectDirectory });
+/* v8 ignore stop */
+const resolveAgentSlug = (settingsDefault, requested) => {
+    const slug = requested ?? settingsDefault;
+    if (slug === undefined) {
+        throw new Error("No agent selected and no 'default_agent' in settings. Pass an agent: outfitter run <agent>.");
+    }
+    return slug;
+};
+const resolveHarness = (settingsDefault, requested) => {
+    const harness = requested ?? settingsDefault ?? 'pi';
+    if (!HARNESSES.includes(harness)) {
+        throw new Error(`Unknown harness '${harness}'. Use --harness pi or --harness claude.`);
+    }
+    return harness;
+};
+const assertNoSettingsIssues = (issues) => {
+    if (issues.length > 0) {
+        throw new Error(`Cannot run with invalid settings: ${issues.map((issue) => issue.message).join('; ')}`);
+    }
+};
+// pi stores credentials under PI_CODING_AGENT_DIR (the ephemeral projection root), so seed them from
+// pi's durable agent dir before launch and copy any /login changes back afterward. Non-pi harnesses
+// launch unchanged.
+const launchWithCredentialPersistence = async (input, harness, rootDirectory, launch) => {
+    const piUserAgentDirectory = harness === 'pi' ? resolvePiUserAgentDirectory(input.homeDirectory) : undefined;
+    if (piUserAgentDirectory !== undefined)
+        seedPiCredentials(rootDirectory, piUserAgentDirectory);
+    const exitCode = await input.launcher(launch);
+    if (piUserAgentDirectory !== undefined)
+        persistPiCredentials(rootDirectory, piUserAgentDirectory);
+    return exitCode;
+};
+// Installs/caches the pi extensions for the composed agent (pi only) so they load at launch.
+const resolvePiExtensions = async (input, harness, extensionSpecs) => {
+    if (harness !== 'pi')
+        return { loadDirs: [], warnings: [] };
+    return ensurePiExtensions(extensionSpecs, {
+        cacheAgentDir: join(resolveOutfitterCacheDir(process.env, input.homeDirectory), 'pi-extensions'),
+        offline: process.env.PI_OFFLINE === '1' || process.env.PI_OFFLINE === 'true',
+        spawn: input.extensionInstallSpawner,
+    });
+};
+export const executeRunAgentCommand = async (input) => {
+    // Flush messages to the terminal (before launch); they are also returned so callers can inspect them.
+    const emit = (messages) => {
+        for (const message of messages)
+            input.writeLine?.(message);
+    };
+    let resolved = resolveEffectiveSet(input);
+    assertNoSettingsIssues(resolved.settingsIssues);
+    // First run: nothing selected and no default configured — onboard, then resolve again.
+    const setupMessages = [];
+    if (input.agent === undefined && resolved.settings.defaultAgent === undefined && input.setup !== undefined) {
+        const setupResult = await input.setup({
+            homeDirectory: input.homeDirectory,
+            projectDirectory: input.projectDirectory,
+        });
+        if (setupResult !== undefined) {
+            setupMessages.push(...setupResult.messages);
+            resolved = resolveEffectiveSet(input);
+            assertNoSettingsIssues(resolved.settingsIssues);
+        }
+    }
+    const { set, settings } = resolved;
+    const agentSlug = resolveAgentSlug(settings.defaultAgent, input.agent);
+    const harness = resolveHarness(settings.defaultHarness, input.harness);
+    const composed = compose(set, agentSlug);
+    if (composed.plan === undefined) {
+        const messages = [...setupMessages, ...composed.errors];
+        emit(messages);
+        return { exitCode: 1, messages };
+    }
+    // Install/cache the pi extensions into a shared XDG cache and load them at launch (pi only).
+    const extensions = await resolvePiExtensions(input, harness, composed.plan.loadout.extensions);
+    const selectedAgent = findResource(set, 'agent', agentSlug);
+    const rootDirectory = mkdtempSync(join(tmpdir(), `outfitter-${agentSlug}-${harness}-`));
+    try {
+        const projection = projectComposition(composed.plan, {
+            harness,
+            rootDirectory,
+            homeDirectory: input.homeDirectory,
+            passThroughArgs: input.passThroughArgs,
+            extensionLoadDirs: harness === 'pi' ? extensions.loadDirs : undefined,
+            // ProjectHarness only overlays these for the pi harness, so pass them through unconditionally.
+            configurationOverlayDirectories: selectedAgent.piConfigDirectories,
+        });
+        // Composition warnings, unsupported harness elements, and extension-install failures are all
+        // advisory; --strict makes the combined set fatal before launch.
+        const warnings = [
+            ...composed.plan.warnings,
+            ...projection.unsupported.map((element) => `harness '${harness}' cannot project loadout element '${element}'.`),
+            ...extensions.warnings,
+        ];
+        if (input.strict === true && warnings.length > 0) {
+            const messages = [
+                ...setupMessages,
+                ...warnings,
+                'Strict mode: composition warnings and unsupported elements are fatal.',
+            ];
+            emit(messages);
+            return { exitCode: 1, messages };
+        }
+        // Emit setup notices and warnings before launch so they precede the pi session on the terminal.
+        const messages = [...setupMessages, ...warnings];
+        emit(messages);
+        // Attach the Outfitter runtime extension so interactive pi sessions restore the "connect a
+        // model provider" sign-in prompt when no models are available, instead of pi's raw warning.
+        const launch = attachPiRuntimeExtension(projection.launch);
+        const exitCode = await launchWithCredentialPersistence(input, harness, rootDirectory, launch);
+        return { launchPlan: launch, exitCode, messages };
+    }
+    finally {
+        if (input.retainProjection !== true) {
+            rmSync(rootDirectory, { recursive: true, force: true });
+        }
+    }
+};
+// Re-exported for tests and sibling commands; the shared launcher lives in AgentLaunch.
+export { launchThroughSpawn } from '../../agents/AgentLaunch.js';
+/* v8 ignore next -- wiring to the real spawn boundary; launchThroughSpawn itself is unit-tested. */
+const defaultLauncher = (plan) => launchThroughSpawn(spawnLauncher, plan);
+export const createRunAgentCommand = (dependencies = {}) => ({
+    name: 'run',
+    description: 'Resolve, compose, and launch an agent in the selected harness.',
+    register(program) {
+        program
+            .command('run', { isDefault: true })
+            .description('Resolve, compose, and launch an agent in the selected harness.')
+            .argument('[agent]', 'Agent slug to run (default: settings default_agent).')
+            .argument('[args...]', 'Arguments passed through to the harness after --.')
+            .addOption(new Option('--harness <harness>', 'Harness to launch.').choices([...HARNESSES]))
+            .option('--strict', 'Treat composition warnings and unsupported loadout elements as fatal.')
+            .allowUnknownOption(true)
+            .action(async (agent, passThroughArgs, options) => {
+            /* v8 ignore next 3 -- process/launcher defaults are exercised by the CLI entrypoint, not unit tests. */
+            const homeDirectory = resolveHomeDirectory(dependencies.homeDirectory);
+            const projectDirectory = resolveProjectDirectory(dependencies.projectDirectory);
+            const launcher = dependencies.launcher ?? defaultLauncher;
+            const result = await executeRunAgentCommand({
+                homeDirectory,
+                projectDirectory,
+                agent,
+                harness: options.harness,
+                strict: options.strict,
+                passThroughArgs,
+                launcher,
+                setup: dependencies.setup ?? interactiveSetupRunner,
+                // executeRunAgentCommand emits messages (before launch) through this sink.
+                /* v8 ignore next -- console.error fallback is direct CLI behavior; tests inject a writer. */
+                writeLine: dependencies.writeLine ?? console.error,
+            });
+            process.exitCode = result.exitCode;
+        });
+    },
+});
+//# sourceMappingURL=RunAgentCommand.js.map

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

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

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

@@ -1,8 +1,40 @@
+import type { AgentLaunchPlan } from '../../projection/Projection.js';
+import type { SetupAgentChoice, SetupResult } from '../../setup/Setup.js';
 import type { CommandObject } from './CommandObject.js';
-import { updateSettingsDefaultProfile } from './FirstRunWelcomeProfile.js';
-import type { SetupCommandDependencies, SetupCommandInput, SetupCommandResult } from './setup/SetupTypes.js';
-export type { SetupCommandDependencies, SetupCommandInput, SetupCommandResult, SetupPiOnboardingLaunchInput, SetupProfileChoice, SetupSourceImportMode, SetupSourceImportModeChoice, SetupSourceImportTarget, SetupSourceImportTargetChoice, SetupSourceLaunchInput, SetupSourcePostImportAction, SetupSourcePostImportLaunchTarget, SetupSourceSynchronizer, } from './setup/SetupTypes.js';
-export { createDefaultSettingsContent } from './setup/SetupStarterSource.js';
-export { updateSettingsDefaultProfile };
-export declare const executeSetupCommand: (input: SetupCommandInput, dependencies?: SetupCommandDependencies) => Promise<SetupCommandResult>;
+export type SetupProcessLauncher = (plan: AgentLaunchPlan) => Promise<number>;
+export interface SetupCommandDependencies {
+    readonly homeDirectory?: string;
+    readonly projectDirectory?: string;
+    readonly defaultCatalogBootstrap?: (homeDirectory: string) => string;
+    readonly setupSourceUri?: string;
+    readonly interactive?: boolean;
+    readonly launcher?: SetupProcessLauncher;
+    /** Launcher for the profile pi started after setup; defaults to the real spawn boundary. */
+    readonly runLauncher?: SetupProcessLauncher;
+    readonly writeLine?: (message: string) => void;
+}
+export interface PiSetupLaunch {
+    readonly plan: AgentLaunchPlan;
+    readonly resultPath: string;
+}
+interface PreparePiSetupLaunchInput {
+    readonly homeDirectory: string;
+    readonly projectDirectory: string;
+    readonly setupDirectory: string;
+    readonly availableAgents: readonly SetupAgentChoice[];
+    readonly setupSourceUri?: string;
+}
+export declare const createPiSetupExtensionContent: (input: {
+    readonly homeDirectory: string;
+    readonly projectDirectory: string;
+    readonly resultPath: string;
+    readonly availableAgents: readonly SetupAgentChoice[];
+    readonly currentDefault?: string;
+    readonly setupSourceUri?: string;
+}) => string;
+/** Creates an isolated, model-free Pi setup launch using the bundled extension. */
+export declare const preparePiSetupLaunch: (input: PreparePiSetupLaunchInput) => PiSetupLaunch;
+/** Launches the walkthrough, then applies its result through the shared setup state machine. */
+export declare const runSetup: (dependencies?: SetupCommandDependencies) => Promise<SetupResult | undefined>;
 export declare const createSetupCommand: (dependencies?: SetupCommandDependencies) => CommandObject;
+export {};