@agentworkforce/deploy 0.0.0

package/dist/deploy.js

@@ -0,0 +1,172 @@
+import path from 'node:path';
+import { mkdir } from 'node:fs/promises';
+import { bundleStager } from './bundle.js';
+import { connectIntegrations, envIntegrationResolver } from './connect.js';
+import { createTerminalIO } from './io.js';
+import { envWorkspaceAuth } from './login.js';
+import { devLauncher } from './modes/dev.js';
+import { sandboxLauncher } from './modes/sandbox.js';
+import { cloudLauncher } from './modes/cloud.js';
+import { preflightPersona } from './preflight.js';
+/**
+ * Pick the run mode for this deploy. Per the deploy-v1 spec:
+ *   - Explicit `--mode` always wins.
+ *   - Otherwise `--mode sandbox` is the default when Daytona creds resolve
+ *     (BYO env or workforce-managed both count as "resolved" here; the
+ *     sandbox launcher itself decides which auth path to use).
+ *   - Otherwise fall back to `--mode dev`.
+ *
+ * The orchestrator doesn't probe the cloud endpoint here — `--mode cloud`
+ * stays opt-in until the M4 endpoint is live.
+ */
+export function pickMode(opts) {
+    if (opts.mode)
+        return opts.mode;
+    // Daytona credential probe: BYO env var, or assume workforce-managed via
+    // the active workspace (the sandbox launcher gates on its own auth).
+    if (process.env.DAYTONA_API_KEY || process.env.WORKFORCE_WORKSPACE_TOKEN) {
+        return 'sandbox';
+    }
+    return 'dev';
+}
+/**
+ * Top-level entry. The CLI dispatch case calls this with parsed options
+ * and resolvers. Returns a `DeployResult` summarizing the deploy; on
+ * failure, throws with an actionable message (no half-deploys).
+ *
+ * Step ordering — see `docs/plans/deploy-v1.md` §5:
+ *   1. Preflight persona (parse, lint, onEvent on disk).
+ *   2. Resolve workspace + token.
+ *   3. Connect integrations (prompt per provider).
+ *   4. Stage bundle to `.workforce/build/<id>/`.
+ *   5. Launch in the resolved mode.
+ *   6. Return the handle + summary.
+ *
+ * `dryRun: true` exits cleanly after step 1, returning a minimal result
+ * with the warnings collected so far.
+ *
+ * `bundleOut: <dir>` runs steps 1-4 then exits, skipping launch.
+ */
+export async function deploy(opts, resolvers = {}) {
+    const io = opts.io ?? createTerminalIO();
+    const warnings = [];
+    io.info(`workforce deploy → ${opts.personaPath}`);
+    const preflight = await preflightPersona(opts.personaPath);
+    warnings.push(...preflight.warnings);
+    for (const w of preflight.warnings)
+        io.warn(w);
+    io.info(`persona ${preflight.persona.id}: ${preflight.integrations.length} integration(s), ${preflight.schedules.length} schedule(s)`);
+    if (opts.dryRun) {
+        io.info('--dry-run: persona validated; exiting before any side effects');
+        return {
+            deploymentId: preflight.persona.id,
+            mode: opts.mode ?? pickMode(opts),
+            workspace: opts.workspace ?? '(dry-run)',
+            bundleDir: '(dry-run)',
+            connectedIntegrations: [],
+            schedules: preflight.schedules,
+            warnings
+        };
+    }
+    // `--bundle-out` produces a workspace-agnostic artifact, so skip the
+    // workspace/integration handshakes entirely. Anyone bundling for CI
+    // or inspection shouldn't need credentials they don't yet have.
+    if (opts.bundleOut) {
+        const bundleDir = path.resolve(opts.bundleOut);
+        await mkdir(bundleDir, { recursive: true });
+        const stager = resolvers.bundle ?? bundleStager;
+        const bundle = await stager.stage({
+            personaPath: preflight.personaPath,
+            persona: preflight.persona,
+            outDir: bundleDir
+        });
+        io.info(`bundle: staged to ${bundle.runnerPath} (${formatBytes(bundle.sizeBytes)})`);
+        io.info(`--bundle-out: bundle ready at ${bundleDir}; skipping launch`);
+        return {
+            deploymentId: preflight.persona.id,
+            mode: opts.mode ?? pickMode(opts),
+            workspace: opts.workspace ?? '(bundle-only)',
+            bundleDir,
+            connectedIntegrations: [],
+            schedules: preflight.schedules,
+            warnings
+        };
+    }
+    const workspaceAuth = resolvers.workspaceAuth ?? envWorkspaceAuth();
+    const { workspace } = await workspaceAuth.resolveWorkspace({
+        override: opts.workspace,
+        io
+    });
+    io.info(`workspace: ${workspace}`);
+    const connectResult = await connectIntegrations({
+        persona: preflight.persona,
+        workspace,
+        noConnect: opts.noConnect === true,
+        io,
+        integrations: resolvers.integrations ?? envIntegrationResolver(),
+        ...(resolvers.subscription ? { subscription: resolvers.subscription } : {})
+    });
+    const failed = connectResult.outcomes.filter((o) => o.status === 'failed');
+    if (failed.length > 0) {
+        throw new Error(`deploy aborted: ${failed.length} integration(s) failed to connect: ${failed.map((f) => f.provider).join(', ')}`);
+    }
+    const skipped = connectResult.outcomes.filter((o) => o.status === 'skipped');
+    if (skipped.length > 0) {
+        throw new Error(`deploy aborted: ${skipped.length} integration(s) skipped: ${skipped.map((s) => s.provider).join(', ')}`);
+    }
+    const connectedIntegrations = connectResult.outcomes
+        .filter((o) => o.status === 'already-connected' || o.status === 'connected-now')
+        .map((o) => o.provider);
+    const bundleDir = path.resolve(path.join(preflight.personaDir, '.workforce', 'build', preflight.persona.id));
+    await mkdir(bundleDir, { recursive: true });
+    const stager = resolvers.bundle ?? bundleStager;
+    const bundle = await stager.stage({
+        personaPath: preflight.personaPath,
+        persona: preflight.persona,
+        outDir: bundleDir
+    });
+    io.info(`bundle: staged to ${bundle.runnerPath} (${formatBytes(bundle.sizeBytes)})`);
+    const mode = opts.mode ?? pickMode(opts);
+    io.info(`mode: ${mode}`);
+    const launcher = resolveLauncher(mode, resolvers);
+    const handle = await launcher.launch({
+        persona: preflight.persona,
+        bundle,
+        workspace,
+        io,
+        ...(opts.detach ? { detach: true } : {}),
+        ...(opts.byoSandbox ? { byoSandbox: true } : {})
+    });
+    io.info(`launched: ${mode}/${handle.id}`);
+    return {
+        deploymentId: preflight.persona.id,
+        mode,
+        workspace,
+        bundleDir,
+        connectedIntegrations,
+        schedules: preflight.schedules,
+        runHandle: handle,
+        warnings
+    };
+}
+function resolveLauncher(mode, resolvers) {
+    const supplied = resolvers.modes?.[mode];
+    if (supplied)
+        return supplied;
+    switch (mode) {
+        case 'dev':
+            return devLauncher;
+        case 'sandbox':
+            return sandboxLauncher;
+        case 'cloud':
+            return cloudLauncher;
+    }
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+//# sourceMappingURL=deploy.js.map

package/dist/deploy.js.map

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

package/dist/deploy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deploy.test.d.ts.map

package/dist/deploy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.test.d.ts","sourceRoot":"","sources":["../src/deploy.test.ts"],"names":[],"mappings":""}

package/dist/deploy.test.js

@@ -0,0 +1,293 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { mkdtemp, rm, writeFile, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import { deploy } from './deploy.js';
+import { createBufferedIO } from './io.js';
+import { preflightPersona } from './preflight.js';
+function basePersonaJson(overrides = {}) {
+    return {
+        id: 'demo',
+        intent: 'documentation',
+        tags: ['documentation'],
+        description: 'test persona',
+        harness: 'claude',
+        model: 'anthropic/claude-3-5-sonnet',
+        systemPrompt: 'be helpful',
+        harnessSettings: { reasoning: 'medium', timeoutSeconds: 300 },
+        cloud: true,
+        schedules: [{ name: 'weekly', cron: '0 9 * * 6' }],
+        onEvent: './agent.ts',
+        ...overrides
+    };
+}
+async function withTempPersona(persona, agentSource = 'export default async () => {};') {
+    const dir = await mkdtemp(path.join(os.tmpdir(), 'wf-deploy-test-'));
+    const personaPath = path.join(dir, 'persona.json');
+    await writeFile(personaPath, JSON.stringify(persona, null, 2), 'utf8');
+    await writeFile(path.join(dir, 'agent.ts'), agentSource, 'utf8');
+    return {
+        dir,
+        personaPath,
+        cleanup: () => rm(dir, { recursive: true, force: true })
+    };
+}
+test('preflightPersona accepts a valid deploy-shaped persona', async () => {
+    const { personaPath, cleanup } = await withTempPersona(basePersonaJson());
+    try {
+        const pre = await preflightPersona(personaPath);
+        assert.equal(pre.persona.id, 'demo');
+        assert.deepEqual(pre.schedules, ['weekly']);
+        assert.deepEqual(pre.integrations, []);
+        assert.equal(pre.warnings.length, 0);
+    }
+    finally {
+        await cleanup();
+    }
+});
+test('preflightPersona refuses when cloud is not true', async () => {
+    const { personaPath, cleanup } = await withTempPersona(basePersonaJson({ cloud: false }));
+    try {
+        await assert.rejects(preflightPersona(personaPath), /not opted into deploy/);
+    }
+    finally {
+        await cleanup();
+    }
+});
+test('preflightPersona refuses when no triggers are declared', async () => {
+    const { personaPath, cleanup } = await withTempPersona(basePersonaJson({ schedules: undefined, integrations: undefined }));
+    try {
+        await assert.rejects(preflightPersona(personaPath), /has no triggers/);
+    }
+    finally {
+        await cleanup();
+    }
+});
+test('preflightPersona refuses when onEvent file is missing', async () => {
+    const { personaPath, cleanup } = await withTempPersona(basePersonaJson({ onEvent: './does-not-exist.ts' }));
+    try {
+        await assert.rejects(preflightPersona(personaPath), /onEvent file not found/);
+    }
+    finally {
+        await cleanup();
+    }
+});
+test('preflightPersona warns on unknown triggers but does not fail', async () => {
+    const { personaPath, cleanup } = await withTempPersona(basePersonaJson({
+        schedules: undefined,
+        integrations: {
+            github: { triggers: [{ on: 'pull_request.imagined_event' }] }
+        }
+    }));
+    try {
+        const pre = await preflightPersona(personaPath);
+        assert.equal(pre.warnings.length, 1);
+        assert.match(pre.warnings[0], /pull_request\.imagined_event/);
+    }
+    finally {
+        await cleanup();
+    }
+});
+test('deploy --dry-run validates persona and exits before side effects', async () => {
+    const { personaPath, cleanup } = await withTempPersona(basePersonaJson());
+    const io = createBufferedIO();
+    try {
+        const result = await deploy({ personaPath, dryRun: true, io });
+        assert.equal(result.deploymentId, 'demo');
+        assert.deepEqual(result.schedules, ['weekly']);
+        assert.ok(io.messages.find((m) => m.message.includes('--dry-run')));
+        // No workspace resolution happened.
+        assert.ok(!io.messages.find((m) => m.message.startsWith('workspace:')));
+    }
+    finally {
+        await cleanup();
+    }
+});
+test('deploy fails clearly when integration is not connected and --no-connect is set', async () => {
+    const { personaPath, cleanup } = await withTempPersona(basePersonaJson({ integrations: { github: { triggers: [{ on: 'pull_request.opened' }] } } }));
+    const io = createBufferedIO();
+    const workspaceAuth = {
+        async resolveWorkspace() {
+            return { workspace: 'ws-test', token: 'tok' };
+        }
+    };
+    const integrations = {
+        async isConnected() {
+            return false;
+        },
+        async connect() {
+            throw new Error('should not be called when --no-connect is set');
+        }
+    };
+    try {
+        await assert.rejects(deploy({ personaPath, mode: 'dev', noConnect: true, io }, { workspaceAuth, integrations }), /failed to connect/);
+        assert.ok(io.messages.find((m) => m.level === 'error' && m.message.includes('--no-connect was passed')));
+    }
+    finally {
+        await cleanup();
+    }
+});
+test('deploy stages a bundle and hands off to the resolved launcher', async () => {
+    const { personaPath, dir, cleanup } = await withTempPersona(basePersonaJson());
+    const io = createBufferedIO();
+    let stagedTo = '';
+    const bundleStager = {
+        async stage(input) {
+            stagedTo = input.outDir;
+            await mkdir(input.outDir, { recursive: true });
+            const runner = path.join(input.outDir, 'runner.mjs');
+            const bundle = path.join(input.outDir, 'agent.bundle.mjs');
+            const personaCopy = path.join(input.outDir, 'persona.json');
+            const pkg = path.join(input.outDir, 'package.json');
+            await Promise.all([
+                writeFile(runner, '', 'utf8'),
+                writeFile(bundle, '', 'utf8'),
+                writeFile(personaCopy, '{}', 'utf8'),
+                writeFile(pkg, '{}', 'utf8')
+            ]);
+            return {
+                runnerPath: runner,
+                bundlePath: bundle,
+                personaCopyPath: personaCopy,
+                packageJsonPath: pkg,
+                sizeBytes: 2
+            };
+        }
+    };
+    let launched = 0;
+    const devLauncher = {
+        async launch(input) {
+            launched += 1;
+            assert.equal(input.persona.id, 'demo');
+            return {
+                id: 'pid-1',
+                async stop() {
+                    /* no-op */
+                },
+                done: Promise.resolve({ code: 0 })
+            };
+        }
+    };
+    const workspaceAuth = {
+        async resolveWorkspace() {
+            return { workspace: 'ws-test', token: 'tok' };
+        }
+    };
+    const integrations = {
+        async isConnected() {
+            return true;
+        },
+        async connect() {
+            throw new Error('connect should not be called when everything is already connected');
+        }
+    };
+    try {
+        const result = await deploy({ personaPath, mode: 'dev', io }, { workspaceAuth, integrations, bundle: bundleStager, modes: { dev: devLauncher } });
+        assert.equal(launched, 1);
+        assert.equal(result.mode, 'dev');
+        assert.equal(result.workspace, 'ws-test');
+        assert.ok(result.bundleDir.startsWith(dir));
+        assert.equal(stagedTo, result.bundleDir);
+        assert.ok(io.messages.find((m) => m.message.includes('launched: dev/pid-1')));
+    }
+    finally {
+        await cleanup();
+    }
+});
+test('deploy --bundle-out emits to the supplied dir and skips launch', async () => {
+    const { personaPath, cleanup } = await withTempPersona(basePersonaJson());
+    const outDir = await mkdtemp(path.join(os.tmpdir(), 'wf-deploy-out-'));
+    const io = createBufferedIO();
+    let launched = false;
+    const devLauncher = {
+        async launch() {
+            launched = true;
+            throw new Error('launch should not run with --bundle-out');
+        }
+    };
+    const bundleStager = {
+        async stage(input) {
+            await mkdir(input.outDir, { recursive: true });
+            const runner = path.join(input.outDir, 'runner.mjs');
+            const bundle = path.join(input.outDir, 'agent.bundle.mjs');
+            const personaCopy = path.join(input.outDir, 'persona.json');
+            const pkg = path.join(input.outDir, 'package.json');
+            await Promise.all([
+                writeFile(runner, '', 'utf8'),
+                writeFile(bundle, '', 'utf8'),
+                writeFile(personaCopy, '{}', 'utf8'),
+                writeFile(pkg, '{}', 'utf8')
+            ]);
+            return {
+                runnerPath: runner,
+                bundlePath: bundle,
+                personaCopyPath: personaCopy,
+                packageJsonPath: pkg,
+                sizeBytes: 1
+            };
+        }
+    };
+    try {
+        const result = await deploy({ personaPath, mode: 'dev', io, bundleOut: outDir }, {
+            workspaceAuth: {
+                async resolveWorkspace() {
+                    return { workspace: 'w', token: 't' };
+                }
+            },
+            integrations: {
+                async isConnected() {
+                    return true;
+                },
+                async connect() {
+                    throw new Error('unreachable');
+                }
+            },
+            bundle: bundleStager,
+            modes: { dev: devLauncher }
+        });
+        assert.equal(launched, false);
+        assert.equal(result.bundleDir, path.resolve(outDir));
+        assert.ok(io.messages.find((m) => m.message.includes('skipping launch')));
+    }
+    finally {
+        await cleanup();
+        await rm(outDir, { recursive: true, force: true });
+    }
+});
+test('--mode cloud throws a clear "not yet available" error', async () => {
+    const { personaPath, cleanup } = await withTempPersona(basePersonaJson());
+    const io = createBufferedIO();
+    try {
+        await assert.rejects(deploy({ personaPath, mode: 'cloud', io }, {
+            workspaceAuth: {
+                async resolveWorkspace() {
+                    return { workspace: 'w', token: 't' };
+                }
+            },
+            integrations: {
+                async isConnected() {
+                    return true;
+                },
+                async connect() {
+                    throw new Error('unreachable');
+                }
+            },
+            bundle: {
+                async stage() {
+                    return {
+                        runnerPath: '/tmp/r',
+                        bundlePath: '/tmp/b',
+                        personaCopyPath: '/tmp/p',
+                        packageJsonPath: '/tmp/k',
+                        sizeBytes: 0
+                    };
+                }
+            }
+        }), /--mode cloud is not yet available/);
+    }
+    finally {
+        await cleanup();
+    }
+});
+//# sourceMappingURL=deploy.test.js.map

package/dist/deploy.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { deploy, pickMode, type DeployResolvers } from './deploy.js';
+export { preflightPersona } from './preflight.js';
+export { connectIntegrations, envIntegrationResolver, type ConnectAllInput, type ConnectAllResult, type IntegrationConnectResolver, type ProviderSubscriptionResolver } from './connect.js';
+export { envWorkspaceAuth, type WorkspaceAuth } from './login.js';
+export { createTerminalIO, createBufferedIO, type BufferedIO } from './io.js';
+export { bundleStager } from './bundle.js';
+export { devLauncher } from './modes/dev.js';
+export { sandboxLauncher, resolveSandboxAuth, type SandboxAuth } from './modes/sandbox.js';
+export { cloudLauncher } from './modes/cloud.js';
+export type { BundleResult, BundleStageInput, BundleStager, DeployIO, DeployMode, DeployOptions, DeployPreflight, DeployResult, IntegrationConnectOutcome, ModeLaunchHandle, ModeLaunchInput, ModeLauncher } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EAClC,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,aAAa,EACb,eAAe,EACf,YAAY,EACZ,yBAAyB,EACzB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACb,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { deploy, pickMode } from './deploy.js';
+export { preflightPersona } from './preflight.js';
+export { connectIntegrations, envIntegrationResolver } from './connect.js';
+export { envWorkspaceAuth } from './login.js';
+export { createTerminalIO, createBufferedIO } from './io.js';
+export { bundleStager } from './bundle.js';
+export { devLauncher } from './modes/dev.js';
+export { sandboxLauncher, resolveSandboxAuth } from './modes/sandbox.js';
+export { cloudLauncher } from './modes/cloud.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAwB,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EAKvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAsB,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAmB,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAoB,MAAM,oBAAoB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,22 @@
+import type { DeployIO } from './types.js';
+/**
+ * Default IO implementation backed by the terminal. Writes status to
+ * stdout/stderr and uses node:readline for interactive prompts. Tests
+ * supply a deterministic in-memory IO via `DeployOptions.io`.
+ */
+export declare function createTerminalIO(): DeployIO;
+/**
+ * Buffered IO collected for assertions. Used by tests to verify the
+ * orchestrator's message flow without touching the terminal.
+ */
+export interface BufferedIO extends DeployIO {
+    messages: Array<{
+        level: 'info' | 'warn' | 'error';
+        message: string;
+    }>;
+    /** Queue answers for upcoming prompts; FIFO. */
+    scriptAnswers(values: string[]): void;
+    scriptConfirmations(values: boolean[]): void;
+}
+export declare function createBufferedIO(): BufferedIO;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,CAqC3C;AAED;;;GAGG;AACH,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,gDAAgD;IAChD,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtC,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAC9C;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CA6B7C"}

package/dist/io.js

@@ -0,0 +1,76 @@
+import readline from 'node:readline/promises';
+/**
+ * Default IO implementation backed by the terminal. Writes status to
+ * stdout/stderr and uses node:readline for interactive prompts. Tests
+ * supply a deterministic in-memory IO via `DeployOptions.io`.
+ */
+export function createTerminalIO() {
+    // One short-lived readline interface per question. Holding a long-
+    // lived interface keeps stdin in raw mode and pins the event loop
+    // open, so non-interactive callers (`workforce deploy --no-connect`
+    // in CI) see `process.exit(0)` hang or get phantom keystrokes.
+    async function ask(question) {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        try {
+            return await rl.question(question);
+        }
+        finally {
+            rl.close();
+        }
+    }
+    return {
+        info(message) {
+            process.stdout.write(`${message}\n`);
+        },
+        warn(message) {
+            process.stderr.write(`! ${message}\n`);
+        },
+        error(message) {
+            process.stderr.write(`x ${message}\n`);
+        },
+        async prompt(question, opts = {}) {
+            const suffix = opts.defaultValue !== undefined ? ` [${opts.defaultValue}]` : '';
+            const answer = (await ask(`${question}${suffix} `)).trim();
+            return answer.length > 0 ? answer : opts.defaultValue ?? '';
+        },
+        async confirm(question, opts = {}) {
+            const def = opts.defaultValue ?? false;
+            const suffix = def ? ' [Y/n]' : ' [y/N]';
+            const answer = (await ask(`${question}${suffix} `)).trim().toLowerCase();
+            if (answer === '')
+                return def;
+            return answer === 'y' || answer === 'yes';
+        }
+    };
+}
+export function createBufferedIO() {
+    const messages = [];
+    const answerQueue = [];
+    const confirmQueue = [];
+    return {
+        messages,
+        info(message) {
+            messages.push({ level: 'info', message });
+        },
+        warn(message) {
+            messages.push({ level: 'warn', message });
+        },
+        error(message) {
+            messages.push({ level: 'error', message });
+        },
+        async prompt(_question, opts) {
+            return answerQueue.shift() ?? opts?.defaultValue ?? '';
+        },
+        async confirm(_question, opts) {
+            const next = confirmQueue.shift();
+            return next ?? opts?.defaultValue ?? false;
+        },
+        scriptAnswers(values) {
+            answerQueue.push(...values);
+        },
+        scriptConfirmations(values) {
+            confirmQueue.push(...values);
+        }
+    };
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

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