@potential-agents/cli 0.0.0-stage → 0.1.1

package/dist/application/apply-bundle.d.ts

@@ -0,0 +1,22 @@
+import type { BundleRepository } from './ports/bundle-repository.js';
+import type { IdempotencyKeyGenerator } from './ports/idempotency-key-generator.js';
+import type { LockRepository } from './ports/lock-repository.js';
+import type { PotentialAgentsApi, RemoteAgent } from './ports/potential-agents-api.js';
+import { PlanBundle } from './plan-bundle.js';
+export interface ApplyOptions {
+    readonly wait: boolean;
+    readonly timeoutMs: number;
+    readonly pollIntervalMs: number;
+}
+/** Applies a planned immutable revision and updates the generated lockfile. */
+export declare class ApplyBundle {
+    private readonly bundles;
+    private readonly locks;
+    private readonly planner;
+    private readonly api;
+    private readonly keys;
+    constructor(bundles: BundleRepository, locks: LockRepository, planner: PlanBundle, api: PotentialAgentsApi, keys: IdempotencyKeyGenerator);
+    execute(root: string, organizationId: string, options: ApplyOptions): Promise<RemoteAgent>;
+    /** Polls the control plane without changing state until a deployment becomes terminal. */
+    private _waitForReady;
+}

package/dist/application/apply-bundle.js

@@ -0,0 +1,78 @@
+import { configurationError, PotentialAgentsError } from '../domain/errors.js';
+import { PlanBundle } from './plan-bundle.js';
+/** Applies a planned immutable revision and updates the generated lockfile. */
+export class ApplyBundle {
+    bundles;
+    locks;
+    planner;
+    api;
+    keys;
+    constructor(bundles, locks, planner, api, keys) {
+        this.bundles = bundles;
+        this.locks = locks;
+        this.planner = planner;
+        this.api = api;
+        this.keys = keys;
+    }
+    async execute(root, organizationId, options) {
+        const planned = await this.planner.execute(root, organizationId);
+        if (planned.plan.change === 'noop') {
+            if (!planned.lock)
+                throw new PotentialAgentsError('LOCK_ERROR', 'A no-op plan requires potential.lock.');
+            return this.api.getAgent(organizationId, planned.lock.agent.remoteId);
+        }
+        const updatesExistingAgent = planned.lock?.agent.localId === planned.bundle.definition.id;
+        if (updatesExistingAgent && planned.plan.change !== 'revision') {
+            throw new PotentialAgentsError('PLAN_CONFLICT', 'The control plane attempted to create a new agent for an existing local identity.');
+        }
+        if (!updatesExistingAgent && planned.plan.change !== 'create') {
+            throw new PotentialAgentsError('PLAN_CONFLICT', 'The control plane did not return a create plan for a new local identity.');
+        }
+        const uploadedSkills = await Promise.all(planned.bundle.skills.map((skill) => {
+            const locked = planned.lock?.skills[skill.path];
+            if (locked?.sha256 === skill.sha256) {
+                return Promise.resolve({ skillId: locked.skillId, revision: locked.revision, sha256: locked.sha256 });
+            }
+            return this.api.uploadSkill(organizationId, skill);
+        }));
+        const accepted = updatesExistingAgent
+            ? await this.api.createRevision(organizationId, planned.lock.agent.remoteId, planned.bundle, uploadedSkills, this.keys.generate(organizationId, planned.bundle.definitionSha256, 'revision'))
+            : await this.api.createAgent(organizationId, planned.bundle, uploadedSkills, this.keys.generate(organizationId, planned.bundle.definitionSha256, 'create'));
+        const remote = options.wait ? await this._waitForReady(organizationId, accepted.agentId, options) : accepted;
+        const lock = {
+            format: 'potentialagents/lock/v1',
+            agent: {
+                localId: planned.bundle.definition.id,
+                remoteId: remote.agentId,
+                activeRevision: remote.activeRevision,
+                deploymentId: remote.deploymentId,
+                definitionSha256: planned.bundle.definitionSha256,
+                status: remote.status,
+            },
+            skills: Object.fromEntries(uploadedSkills.map((skill, index) => {
+                const source = planned.bundle.skills[index];
+                if (!source)
+                    throw configurationError('Skill upload response did not match bundle skill order.');
+                return [source.path, { path: source.path, skillId: skill.skillId, revision: skill.revision, sha256: skill.sha256 }];
+            })),
+        };
+        await this.locks.write(root, lock);
+        return remote;
+    }
+    /** Polls the control plane without changing state until a deployment becomes terminal. */
+    async _waitForReady(organizationId, remoteId, options) {
+        const deadline = Date.now() + options.timeoutMs;
+        while (true) {
+            const current = await this.api.getAgent(organizationId, remoteId);
+            if (current.status === 'ready')
+                return current;
+            if (['failed', 'archived'].includes(current.status)) {
+                throw new PotentialAgentsError('DEPLOYMENT_FAILED', `Deployment for ${remoteId} is ${current.status}.`);
+            }
+            if (Date.now() >= deadline)
+                throw new PotentialAgentsError('DEPLOYMENT_TIMEOUT', `Timed out waiting for ${remoteId} to become ready.`);
+            await new Promise((resolve) => setTimeout(resolve, options.pollIntervalMs));
+        }
+    }
+}
+//# sourceMappingURL=apply-bundle.js.map

package/dist/application/apply-bundle.js.map

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

package/dist/application/plan-bundle.d.ts

@@ -0,0 +1,18 @@
+import type { Bundle } from '../domain/bundle.js';
+import type { PotentialLock } from '../domain/lock.js';
+import type { BundleRepository } from './ports/bundle-repository.js';
+import type { LockRepository } from './ports/lock-repository.js';
+import type { PlanResult, PotentialAgentsApi } from './ports/potential-agents-api.js';
+export interface PlannedBundle {
+    readonly bundle: Bundle;
+    readonly lock?: PotentialLock;
+    readonly plan: PlanResult;
+}
+/** Resolves remote policy and determines whether an apply will create, revise, or do nothing. */
+export declare class PlanBundle {
+    private readonly bundles;
+    private readonly locks;
+    private readonly api;
+    constructor(bundles: BundleRepository, locks: LockRepository, api: PotentialAgentsApi);
+    execute(root: string, organizationId: string): Promise<PlannedBundle>;
+}

package/dist/application/plan-bundle.js

@@ -0,0 +1,22 @@
+/** Resolves remote policy and determines whether an apply will create, revise, or do nothing. */
+export class PlanBundle {
+    bundles;
+    locks;
+    api;
+    constructor(bundles, locks, api) {
+        this.bundles = bundles;
+        this.locks = locks;
+        this.api = api;
+    }
+    async execute(root, organizationId) {
+        const bundle = await this.bundles.read(root);
+        const lock = await this.locks.read(root);
+        const sameLocalIdentity = lock?.agent.localId === bundle.definition.id;
+        if (sameLocalIdentity && lock?.agent.definitionSha256 === bundle.definitionSha256) {
+            return { bundle, lock, plan: { change: 'noop', reason: 'The normalized definition matches potential.lock.' } };
+        }
+        const plan = await this.api.plan(organizationId, bundle, sameLocalIdentity ? lock?.agent.remoteId : undefined);
+        return lock ? { bundle, lock, plan } : { bundle, plan };
+    }
+}
+//# sourceMappingURL=plan-bundle.js.map

package/dist/application/plan-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-bundle.js","sourceRoot":"","sources":["../../src/application/plan-bundle.ts"],"names":[],"mappings":"AAYA,iGAAiG;AACjG,MAAM,OAAO,UAAU;IAEF;IACA;IACA;IAHnB,YACmB,OAAyB,EACzB,KAAqB,EACrB,GAAuB;QAFvB,YAAO,GAAP,OAAO,CAAkB;QACzB,UAAK,GAAL,KAAK,CAAgB;QACrB,QAAG,GAAH,GAAG,CAAoB;IACvC,CAAC;IAEG,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,cAAsB;QACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,iBAAiB,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;QACvE,IAAI,iBAAiB,IAAI,IAAI,EAAE,KAAK,CAAC,gBAAgB,KAAK,MAAM,CAAC,gBAAgB,EAAE,CAAC;YAClF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,mDAAmD,EAAE,EAAE,CAAC;QACjH,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC/G,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1D,CAAC;CACF"}

package/dist/application/ports/bundle-repository.d.ts

@@ -0,0 +1,6 @@
+import type { Bundle } from '../../domain/bundle.js';
+/** Loads and resolves a Potential Agents bundle from the local filesystem. */
+export interface BundleRepository {
+    read(root: string): Promise<Bundle>;
+    initialize(root: string, overwrite: boolean): Promise<string>;
+}

package/dist/application/ports/bundle-repository.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bundle-repository.js.map

package/dist/application/ports/bundle-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-repository.js","sourceRoot":"","sources":["../../../src/application/ports/bundle-repository.ts"],"names":[],"mappings":""}

package/dist/application/ports/idempotency-key-generator.d.ts

@@ -0,0 +1,4 @@
+/** Produces an idempotency key from stable, non-secret apply input. */
+export interface IdempotencyKeyGenerator {
+    generate(organizationId: string, definitionSha256: string, operation: 'create' | 'revision' | 'run'): string;
+}

package/dist/application/ports/idempotency-key-generator.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=idempotency-key-generator.js.map

package/dist/application/ports/idempotency-key-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency-key-generator.js","sourceRoot":"","sources":["../../../src/application/ports/idempotency-key-generator.ts"],"names":[],"mappings":""}

package/dist/application/ports/lock-repository.d.ts

@@ -0,0 +1,6 @@
+import type { PotentialLock } from '../../domain/lock.js';
+/** Persists the generated remote identity separately from authored bundle intent. */
+export interface LockRepository {
+    read(root: string): Promise<PotentialLock | undefined>;
+    write(root: string, lock: PotentialLock): Promise<void>;
+}

package/dist/application/ports/lock-repository.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lock-repository.js.map

package/dist/application/ports/lock-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-repository.js","sourceRoot":"","sources":["../../../src/application/ports/lock-repository.ts"],"names":[],"mappings":""}

package/dist/application/ports/potential-agents-api.d.ts

@@ -0,0 +1,35 @@
+import type { Bundle, SkillSource } from '../../domain/bundle.js';
+export interface ApiSkillRevision {
+    readonly skillId: string;
+    readonly revision: string;
+    readonly sha256: string;
+}
+export interface RemoteAgent {
+    readonly agentId: string;
+    readonly activeRevision: string;
+    readonly deploymentId: string;
+    readonly status: string;
+}
+export interface ApplyAccepted extends RemoteAgent {
+}
+export type PlanChange = 'create' | 'revision' | 'noop';
+export interface PlanResult {
+    readonly change: PlanChange;
+    readonly reason: string;
+}
+/** Outbound port for the public Potential Agents API, never a cloud-provider SDK. */
+export interface PotentialAgentsApi {
+    plan(organizationId: string, bundle: Bundle, remoteId?: string): Promise<PlanResult>;
+    uploadSkill(organizationId: string, skill: SkillSource): Promise<ApiSkillRevision>;
+    createAgent(organizationId: string, bundle: Bundle, skills: readonly ApiSkillRevision[], idempotencyKey: string): Promise<ApplyAccepted>;
+    createRevision(organizationId: string, remoteId: string, bundle: Bundle, skills: readonly ApiSkillRevision[], idempotencyKey: string): Promise<ApplyAccepted>;
+    getAgent(organizationId: string, remoteId: string): Promise<RemoteAgent>;
+    createSession(organizationId: string, remoteId: string): Promise<{
+        readonly sessionId: string;
+    }>;
+    createRun(sessionId: string, message: string, idempotencyKey: string): Promise<{
+        readonly runId: string;
+        readonly status: string;
+    }>;
+    archiveAgent(organizationId: string, remoteId: string): Promise<void>;
+}

package/dist/application/ports/potential-agents-api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=potential-agents-api.js.map

package/dist/application/ports/potential-agents-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"potential-agents-api.js","sourceRoot":"","sources":["../../../src/application/ports/potential-agents-api.ts"],"names":[],"mappings":""}

package/dist/application/run-agent.d.ts

@@ -0,0 +1,14 @@
+import type { IdempotencyKeyGenerator } from './ports/idempotency-key-generator.js';
+import type { LockRepository } from './ports/lock-repository.js';
+import type { PotentialAgentsApi } from './ports/potential-agents-api.js';
+/** Opens a session against the locked active revision and starts one run. */
+export declare class RunAgent {
+    private readonly locks;
+    private readonly api;
+    private readonly keys;
+    constructor(locks: LockRepository, api: PotentialAgentsApi, keys: IdempotencyKeyGenerator);
+    execute(root: string, organizationId: string, message: string): Promise<{
+        readonly runId: string;
+        readonly status: string;
+    }>;
+}

package/dist/application/run-agent.js

@@ -0,0 +1,20 @@
+import { configurationError } from '../domain/errors.js';
+/** Opens a session against the locked active revision and starts one run. */
+export class RunAgent {
+    locks;
+    api;
+    keys;
+    constructor(locks, api, keys) {
+        this.locks = locks;
+        this.api = api;
+        this.keys = keys;
+    }
+    async execute(root, organizationId, message) {
+        const lock = await this.locks.read(root);
+        if (!lock)
+            throw configurationError('potential.lock is required before p-agents run.');
+        const session = await this.api.createSession(organizationId, lock.agent.remoteId);
+        return this.api.createRun(session.sessionId, message, this.keys.generate(organizationId, lock.agent.definitionSha256, 'run'));
+    }
+}
+//# sourceMappingURL=run-agent.js.map

package/dist/application/run-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-agent.js","sourceRoot":"","sources":["../../src/application/run-agent.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,6EAA6E;AAC7E,MAAM,OAAO,QAAQ;IAEA;IACA;IACA;IAHnB,YACmB,KAAqB,EACrB,GAAuB,EACvB,IAA6B;QAF7B,UAAK,GAAL,KAAK,CAAgB;QACrB,QAAG,GAAH,GAAG,CAAoB;QACvB,SAAI,GAAJ,IAAI,CAAyB;IAC7C,CAAC;IAEG,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,cAAsB,EAAE,OAAe;QACxE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI;YAAE,MAAM,kBAAkB,CAAC,iDAAiD,CAAC,CAAC;QACvF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClF,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC,CAAC;IAChI,CAAC;CACF"}

package/dist/application/validate-bundle.d.ts

@@ -0,0 +1,8 @@
+import type { Bundle } from '../domain/bundle.js';
+import type { BundleRepository } from './ports/bundle-repository.js';
+/** Validates a local bundle without network access. */
+export declare class ValidateBundle {
+    private readonly bundles;
+    constructor(bundles: BundleRepository);
+    execute(root: string): Promise<Bundle>;
+}

package/dist/application/validate-bundle.js

@@ -0,0 +1,11 @@
+/** Validates a local bundle without network access. */
+export class ValidateBundle {
+    bundles;
+    constructor(bundles) {
+        this.bundles = bundles;
+    }
+    async execute(root) {
+        return this.bundles.read(root);
+    }
+}
+//# sourceMappingURL=validate-bundle.js.map

package/dist/application/validate-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-bundle.js","sourceRoot":"","sources":["../../src/application/validate-bundle.ts"],"names":[],"mappings":"AAGA,uDAAuD;AACvD,MAAM,OAAO,cAAc;IACW;IAApC,YAAoC,OAAyB;QAAzB,YAAO,GAAP,OAAO,CAAkB;IAAG,CAAC;IAE1D,KAAK,CAAC,OAAO,CAAC,IAAY;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF"}

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+/** Builds the process-facing CLI while keeping workflow logic in application use cases. */
+export declare const createProgram: () => Command;

package/dist/cli.js

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { resolve } from 'node:path';
+import { CliCompositionRoot } from './composition-root.js';
+import { PotentialAgentsError } from './domain/errors.js';
+const root = new CliCompositionRoot();
+/** Builds the process-facing CLI while keeping workflow logic in application use cases. */
+export const createProgram = () => {
+    const program = new Command();
+    program
+        .name('p-agents')
+        .description('Declarative GitOps CLI for Potential Agents')
+        .version('0.1.0')
+        .option('--api-url <url>', 'Potential Agents public API URL', process.env.POTENTIAL_AGENTS_API_URL)
+        .option('--organization <id>', 'Potential Agents organization ID', process.env.POTENTIAL_AGENTS_ORGANIZATION)
+        .option('--token <token>', 'short-lived Potential Agents access token', process.env.POTENTIAL_AGENTS_TOKEN)
+        .option('--json', 'print machine-readable JSON');
+    program.command('init [path]')
+        .option('--force', 'overwrite an existing potential.md')
+        .description('create a commented potential.md template')
+        .action(async (path, options) => {
+        const services = root.createOfflineServices();
+        const destination = await services.bundles.initialize(resolve(path ?? '.'), options.force ?? false);
+        output(program, { potential_md: destination }, `Created ${destination}`);
+    });
+    program.command('validate [path]')
+        .description('validate potential.md and local skills without network access')
+        .action(async (path) => {
+        const bundle = await root.createOfflineServices().validate.execute(resolve(path ?? '.'));
+        output(program, { id: bundle.definition.id, definition_sha256: bundle.definitionSha256, skills: bundle.skills.map((skill) => ({ path: skill.path, sha256: skill.sha256 })) }, `Valid: ${bundle.definition.id} (${bundle.definitionSha256})`);
+    });
+    program.command('plan [path]')
+        .description('show create, revision, or no-op after policy resolution')
+        .action(async (path) => {
+        const options = connectionOptions(program);
+        const services = root.createConnectedServices(options);
+        const planned = await services.planner.execute(resolve(path ?? '.'), requiredOrganization(options));
+        output(program, { change: planned.plan.change, reason: planned.plan.reason, definition_sha256: planned.bundle.definitionSha256 }, `${planned.plan.change}: ${planned.plan.reason}`);
+    });
+    program.command('apply [path]')
+        .option('--no-wait', 'return after the control plane accepts deployment')
+        .option('--wait-timeout-seconds <seconds>', 'maximum readiness wait', '300')
+        .description('create or revise an agent and write potential.lock')
+        .action(async (path, options) => {
+        const connection = connectionOptions(program);
+        const services = root.createConnectedServices(connection);
+        const timeoutSeconds = Number(options.waitTimeoutSeconds);
+        if (!Number.isInteger(timeoutSeconds) || timeoutSeconds < 1 || timeoutSeconds > 28_800)
+            throw new PotentialAgentsError('VALIDATION_ERROR', '--wait-timeout-seconds must be an integer from 1 through 28800.');
+        const agent = await services.apply.execute(resolve(path ?? '.'), requiredOrganization(connection), {
+            wait: options.wait !== false,
+            timeoutMs: timeoutSeconds * 1000,
+            pollIntervalMs: 1_000,
+        });
+        output(program, agent, `${agent.status}: ${agent.agentId} revision ${agent.activeRevision}`);
+    });
+    program.command('status [path]')
+        .description('show live status for the lockfile agent')
+        .action(async (path) => {
+        const connection = connectionOptions(program);
+        const services = root.createConnectedServices(connection);
+        const bundlePath = resolve(path ?? '.');
+        const lock = await services.locks.read(bundlePath);
+        if (!lock)
+            throw new PotentialAgentsError('LOCK_ERROR', 'potential.lock is required before p-agents status.');
+        const agent = await services.api.getAgent(requiredOrganization(connection), lock.agent.remoteId);
+        output(program, agent, `${agent.status}: ${agent.agentId} revision ${agent.activeRevision}`);
+    });
+    program.command('run <message>')
+        .option('--path <path>', 'bundle directory', '.')
+        .description('start one run against the locked active revision')
+        .action(async (message, options) => {
+        const connection = connectionOptions(program);
+        const services = root.createConnectedServices(connection);
+        const run = await services.run.execute(resolve(options.path), requiredOrganization(connection), message);
+        output(program, run, `${run.status}: ${run.runId}`);
+    });
+    program.command('archive [path]')
+        .option('--yes', 'confirm the archive operation')
+        .description('archive the remote agent in potential.lock')
+        .action(async (path, options) => {
+        if (!options.yes)
+            throw new PotentialAgentsError('CONFIRMATION_REQUIRED', 'Pass --yes to archive the remote agent.');
+        const connection = connectionOptions(program);
+        const services = root.createConnectedServices(connection);
+        const lock = await services.locks.read(resolve(path ?? '.'));
+        if (!lock)
+            throw new PotentialAgentsError('LOCK_ERROR', 'potential.lock is required before p-agents archive.');
+        await services.api.archiveAgent(requiredOrganization(connection), lock.agent.remoteId);
+        output(program, { agent_id: lock.agent.remoteId, status: 'archived' }, `archived: ${lock.agent.remoteId}`);
+    });
+    return program;
+};
+/** Reads connection inputs outside bundle content so Git stays free of credentials. */
+const connectionOptions = (program) => program.opts();
+const requiredOrganization = (options) => {
+    if (!options.organization)
+        throw new PotentialAgentsError('CONFIGURATION_ERROR', 'POTENTIAL_AGENTS_ORGANIZATION or --organization is required.');
+    return options.organization;
+};
+/** Renders either human output or a stable JSON object for CI. */
+const output = (program, value, human) => {
+    if (program.opts().json)
+        console.log(JSON.stringify(value));
+    else
+        console.log(human);
+};
+const main = async () => {
+    try {
+        await createProgram().parseAsync(process.argv);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unexpected error.';
+        const code = error instanceof PotentialAgentsError ? error.code : 'UNEXPECTED_ERROR';
+        console.error(`${code}: ${message}`);
+        process.exitCode = code === 'VALIDATION_ERROR' || code === 'CONFIGURATION_ERROR' || code === 'CONFIRMATION_REQUIRED' ? 2 : 1;
+    }
+};
+void main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/composition-root.d.ts

@@ -0,0 +1,29 @@
+import { ApplyBundle } from './application/apply-bundle.js';
+import { PlanBundle } from './application/plan-bundle.js';
+import { RunAgent } from './application/run-agent.js';
+import { ValidateBundle } from './application/validate-bundle.js';
+import { FilesystemBundleRepository } from './adapters/outbound/filesystem/bundle-filesystem-repository.js';
+import { YamlLockRepository } from './adapters/outbound/filesystem/yaml-lock-repository.js';
+import { HttpPotentialAgentsApi } from './adapters/outbound/http/http-potential-agents-api.js';
+export interface RuntimeConfiguration {
+    readonly apiUrl?: string;
+    readonly organization?: string;
+    readonly token?: string;
+}
+/** Composition root: the sole place that binds hexagonal ports to concrete adapters. */
+export declare class CliCompositionRoot {
+    private readonly bundles;
+    private readonly locks;
+    private readonly keys;
+    createOfflineServices(): {
+        readonly validate: ValidateBundle;
+        readonly bundles: FilesystemBundleRepository;
+    };
+    createConnectedServices(configuration: RuntimeConfiguration): {
+        readonly planner: PlanBundle;
+        readonly apply: ApplyBundle;
+        readonly run: RunAgent;
+        readonly locks: YamlLockRepository;
+        readonly api: HttpPotentialAgentsApi;
+    };
+}

package/dist/composition-root.js

@@ -0,0 +1,35 @@
+import { ApplyBundle } from './application/apply-bundle.js';
+import { PlanBundle } from './application/plan-bundle.js';
+import { RunAgent } from './application/run-agent.js';
+import { ValidateBundle } from './application/validate-bundle.js';
+import { FilesystemBundleRepository } from './adapters/outbound/filesystem/bundle-filesystem-repository.js';
+import { YamlLockRepository } from './adapters/outbound/filesystem/yaml-lock-repository.js';
+import { HttpPotentialAgentsApi } from './adapters/outbound/http/http-potential-agents-api.js';
+import { Sha256IdempotencyKeyGenerator } from './adapters/outbound/runtime/sha256-idempotency-key-generator.js';
+/** Composition root: the sole place that binds hexagonal ports to concrete adapters. */
+export class CliCompositionRoot {
+    bundles = new FilesystemBundleRepository();
+    locks = new YamlLockRepository();
+    keys = new Sha256IdempotencyKeyGenerator();
+    createOfflineServices() {
+        return { validate: new ValidateBundle(this.bundles), bundles: this.bundles };
+    }
+    createConnectedServices(configuration) {
+        if (!configuration.apiUrl)
+            throw new Error('POTENTIAL_AGENTS_API_URL or --api-url is required.');
+        if (!configuration.organization)
+            throw new Error('POTENTIAL_AGENTS_ORGANIZATION or --organization is required.');
+        if (!configuration.token)
+            throw new Error('POTENTIAL_AGENTS_TOKEN or --token is required.');
+        const api = new HttpPotentialAgentsApi({ baseUrl: configuration.apiUrl, accessToken: configuration.token });
+        const planner = new PlanBundle(this.bundles, this.locks, api);
+        return {
+            planner,
+            apply: new ApplyBundle(this.bundles, this.locks, planner, api, this.keys),
+            run: new RunAgent(this.locks, api, this.keys),
+            locks: this.locks,
+            api,
+        };
+    }
+}
+//# sourceMappingURL=composition-root.js.map

package/dist/composition-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition-root.js","sourceRoot":"","sources":["../src/composition-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,gEAAgE,CAAC;AAC5G,OAAO,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,MAAM,uDAAuD,CAAC;AAC/F,OAAO,EAAE,6BAA6B,EAAE,MAAM,iEAAiE,CAAC;AAQhH,wFAAwF;AACxF,MAAM,OAAO,kBAAkB;IACZ,OAAO,GAAG,IAAI,0BAA0B,EAAE,CAAC;IAC3C,KAAK,GAAG,IAAI,kBAAkB,EAAE,CAAC;IACjC,IAAI,GAAG,IAAI,6BAA6B,EAAE,CAAC;IAErD,qBAAqB;QAC1B,OAAO,EAAE,QAAQ,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IAC/E,CAAC;IAEM,uBAAuB,CAAC,aAAmC;QAOhE,IAAI,CAAC,aAAa,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACjG,IAAI,CAAC,aAAa,CAAC,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QACjH,IAAI,CAAC,aAAa,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAC5F,MAAM,GAAG,GAAG,IAAI,sBAAsB,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC;QAC5G,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC9D,OAAO;YACL,OAAO;YACP,KAAK,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;YACzE,GAAG,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;YAC7C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG;SACJ,CAAC;IACJ,CAAC;CACF"}

package/dist/domain/agent-definition.d.ts

@@ -0,0 +1,40 @@
+export declare const ALLOWED_TOOLS: readonly ["Read", "Write", "Edit", "Bash", "Glob", "Grep"];
+export type Tool = (typeof ALLOWED_TOOLS)[number];
+export interface Limits {
+    readonly durationSeconds?: number;
+    readonly maxBudgetUsd?: number;
+}
+export interface AgentDefinitionInput {
+    readonly apiVersion: string;
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    readonly engine: string;
+    readonly model: string;
+    readonly tools?: readonly Tool[];
+    readonly browser?: boolean;
+    readonly skillPaths?: readonly string[];
+    readonly limits?: Limits;
+    readonly instructions: string;
+}
+/** Immutable, validated user intent for one Potential Agent revision. */
+export declare class AgentDefinition {
+    readonly apiVersion: 'potentialagents/v1alpha1';
+    readonly id: string;
+    readonly name: string;
+    readonly description: string | undefined;
+    readonly engine: 'claude';
+    readonly model: string;
+    readonly tools: readonly Tool[];
+    readonly browser: boolean;
+    readonly skillPaths: readonly string[];
+    readonly limits: Limits;
+    readonly instructions: string;
+    private constructor();
+    /** Validates raw parsed content and constructs one immutable definition. */
+    static create(input: AgentDefinitionInput): AgentDefinition;
+}
+/** Returns deterministic JSON by sorting object keys recursively. */
+export declare const stableJson: (value: unknown) => string;
+/** Calculates the version-independent SHA-256 representation of an agent intent. */
+export declare const sha256: (value: unknown) => string;