@potential-agents/cli 0.0.0-stage → 0.1.1

package/dist/domain/agent-definition.js

@@ -0,0 +1,94 @@
+import { createHash } from 'node:crypto';
+import { validationError } from './errors.js';
+export const ALLOWED_TOOLS = ['Read', 'Write', 'Edit', 'Bash', 'Glob', 'Grep'];
+/** Immutable, validated user intent for one Potential Agent revision. */
+export class AgentDefinition {
+    apiVersion;
+    id;
+    name;
+    description;
+    engine;
+    model;
+    tools;
+    browser;
+    skillPaths;
+    limits;
+    instructions;
+    constructor(input) {
+        this.apiVersion = 'potentialagents/v1alpha1';
+        this.id = input.id;
+        this.name = input.name;
+        this.description = input.description;
+        this.engine = 'claude';
+        this.model = input.model;
+        this.tools = Object.freeze([...input.tools]);
+        this.browser = input.browser;
+        this.skillPaths = Object.freeze([...input.skillPaths]);
+        this.limits = Object.freeze({ ...input.limits });
+        this.instructions = input.instructions;
+        Object.freeze(this);
+    }
+    /** Validates raw parsed content and constructs one immutable definition. */
+    static create(input) {
+        if (input.apiVersion !== 'potentialagents/v1alpha1') {
+            throw validationError('apiVersion must be exactly "potentialagents/v1alpha1".');
+        }
+        if (!/^[a-z][a-z0-9-]{1,62}$/u.test(input.id)) {
+            throw validationError('id must match [a-z][a-z0-9-]{1,62}.');
+        }
+        if (!input.name.trim() || input.name.length > 120) {
+            throw validationError('name must be a non-blank string of at most 120 characters.');
+        }
+        if (input.description !== undefined && input.description.length > 500) {
+            throw validationError('description must contain at most 500 characters.');
+        }
+        if (input.engine !== 'claude') {
+            throw validationError('engine must currently be "claude".');
+        }
+        if (!input.model.trim()) {
+            throw validationError('model must be a non-blank identifier.');
+        }
+        if (!input.instructions.trim()) {
+            throw validationError('The Markdown body must contain non-blank system instructions.');
+        }
+        const tools = input.tools ?? [];
+        if (new Set(tools).size !== tools.length || tools.some((tool) => !ALLOWED_TOOLS.includes(tool))) {
+            throw validationError(`tools must be unique values from: ${ALLOWED_TOOLS.join(', ')}.`);
+        }
+        const skillPaths = input.skillPaths ?? [];
+        if (new Set(skillPaths).size !== skillPaths.length) {
+            throw validationError('skills must not contain duplicate paths.');
+        }
+        const limits = input.limits ?? {};
+        if (limits.durationSeconds !== undefined && (!Number.isInteger(limits.durationSeconds) || limits.durationSeconds < 1 || limits.durationSeconds > 28_800)) {
+            throw validationError('limits.duration_seconds must be an integer from 1 through 28800.');
+        }
+        if (limits.maxBudgetUsd !== undefined && (!Number.isFinite(limits.maxBudgetUsd) || limits.maxBudgetUsd <= 0 || limits.maxBudgetUsd > 10)) {
+            throw validationError('limits.max_budget_usd must be greater than 0 and at most 10.');
+        }
+        return new AgentDefinition({
+            ...input,
+            name: input.name.trim(),
+            description: input.description?.trim() || undefined,
+            model: input.model.trim(),
+            tools,
+            browser: input.browser ?? false,
+            skillPaths,
+            limits,
+            instructions: input.instructions.trim(),
+        });
+    }
+}
+/** Returns deterministic JSON by sorting object keys recursively. */
+export const stableJson = (value) => {
+    if (Array.isArray(value))
+        return `[${value.map(stableJson).join(',')}]`;
+    if (value !== null && typeof value === 'object') {
+        const record = value;
+        return `{${Object.keys(record).sort().map((key) => `${JSON.stringify(key)}:${stableJson(record[key])}`).join(',')}}`;
+    }
+    return JSON.stringify(value);
+};
+/** Calculates the version-independent SHA-256 representation of an agent intent. */
+export const sha256 = (value) => `sha256:${createHash('sha256').update(stableJson(value)).digest('hex')}`;
+//# sourceMappingURL=agent-definition.js.map

package/dist/domain/agent-definition.js.map

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

package/dist/domain/bundle.d.ts

@@ -0,0 +1,16 @@
+import type { AgentDefinition } from './agent-definition.js';
+export interface SkillSource {
+    readonly path: string;
+    readonly name: string;
+    readonly sha256: string;
+    /** Local resolved directory; never serialized into a lockfile or API request. */
+    readonly sourceDirectory: string;
+}
+/** A fully resolved local bundle with skills pinned by their deterministic content hashes. */
+export declare class Bundle {
+    readonly root: string;
+    readonly definition: AgentDefinition;
+    readonly skills: readonly SkillSource[];
+    readonly definitionSha256: string;
+    constructor(root: string, definition: AgentDefinition, skills: readonly SkillSource[]);
+}

package/dist/domain/bundle.js

@@ -0,0 +1,29 @@
+import { sha256 } from './agent-definition.js';
+/** A fully resolved local bundle with skills pinned by their deterministic content hashes. */
+export class Bundle {
+    root;
+    definition;
+    skills;
+    definitionSha256;
+    constructor(root, definition, skills) {
+        this.root = root;
+        this.definition = definition;
+        this.skills = skills;
+        this.definitionSha256 = sha256({
+            apiVersion: definition.apiVersion,
+            id: definition.id,
+            name: definition.name,
+            description: definition.description,
+            engine: definition.engine,
+            model: definition.model,
+            tools: definition.tools,
+            browser: definition.browser,
+            limits: definition.limits,
+            instructions: definition.instructions,
+            skills: skills.map((skill) => ({ path: skill.path, name: skill.name, sha256: skill.sha256 })),
+        });
+        Object.freeze(this.skills);
+        Object.freeze(this);
+    }
+}
+//# sourceMappingURL=bundle.js.map

package/dist/domain/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../src/domain/bundle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAU/C,8FAA8F;AAC9F,MAAM,OAAO,MAAM;IAIC;IACA;IACA;IALF,gBAAgB,CAAS;IAEzC,YACkB,IAAY,EACZ,UAA2B,EAC3B,MAA8B;QAF9B,SAAI,GAAJ,IAAI,CAAQ;QACZ,eAAU,GAAV,UAAU,CAAiB;QAC3B,WAAM,GAAN,MAAM,CAAwB;QAE9C,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC;YAC7B,UAAU,EAAE,UAAU,CAAC,UAAU;YACjC,EAAE,EAAE,UAAU,CAAC,EAAE;YACjB,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,WAAW,EAAE,UAAU,CAAC,WAAW;YACnC,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,OAAO,EAAE,UAAU,CAAC,OAAO;YAC3B,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,YAAY,EAAE,UAAU,CAAC,YAAY;YACrC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;SAC9F,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;CACF"}

package/dist/domain/errors.d.ts

@@ -0,0 +1,10 @@
+/** Error with a stable category suitable for CLI diagnostics and exit mapping. */
+export declare class PotentialAgentsError extends Error {
+    readonly code: string;
+    readonly cause?: unknown | undefined;
+    constructor(code: string, message: string, cause?: unknown | undefined);
+}
+/** Creates an input-validation error without exposing adapter details. */
+export declare const validationError: (message: string) => PotentialAgentsError;
+/** Creates an error for a required execution setting that was not configured. */
+export declare const configurationError: (message: string) => PotentialAgentsError;

package/dist/domain/errors.js

@@ -0,0 +1,16 @@
+/** Error with a stable category suitable for CLI diagnostics and exit mapping. */
+export class PotentialAgentsError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'PotentialAgentsError';
+    }
+}
+/** Creates an input-validation error without exposing adapter details. */
+export const validationError = (message) => new PotentialAgentsError('VALIDATION_ERROR', message);
+/** Creates an error for a required execution setting that was not configured. */
+export const configurationError = (message) => new PotentialAgentsError('CONFIGURATION_ERROR', message);
+//# sourceMappingURL=errors.js.map

package/dist/domain/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/domain/errors.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAE3B;IAES;IAH3B,YACkB,IAAY,EAC5B,OAAe,EACU,KAAe;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QAEH,UAAK,GAAL,KAAK,CAAU;QAGxC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAe,EAAwB,EAAE,CACvE,IAAI,oBAAoB,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;AAExD,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,OAAe,EAAwB,EAAE,CAC1E,IAAI,oBAAoB,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC"}

package/dist/domain/lock.d.ts

@@ -0,0 +1,18 @@
+export interface LockSkill {
+    readonly path: string;
+    readonly skillId: string;
+    readonly revision: string;
+    readonly sha256: string;
+}
+export interface PotentialLock {
+    readonly format: 'potentialagents/lock/v1';
+    readonly agent: {
+        readonly localId: string;
+        readonly remoteId: string;
+        readonly activeRevision: string;
+        readonly deploymentId: string;
+        readonly definitionSha256: string;
+        readonly status: string;
+    };
+    readonly skills: Readonly<Record<string, LockSkill>>;
+}

package/dist/domain/lock.js

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

package/dist/domain/lock.js.map

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

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@potential-agents/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Declarative GitOps CLI for Potential Agents",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "bin": {
+    "p-agents": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "clean": "node --input-type=module -e \"import { rm } from 'node:fs/promises'; await rm('dist', { recursive: true, force: true });\"",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepack": "npm run clean && npm run build && npm run typecheck"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shinsekai-dev/potential-agents-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/shinsekai-dev/potential-agents-cli/issues"
+  },
+  "homepage": "https://github.com/shinsekai-dev/potential-agents-cli#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "14.0.0",
+    "yaml": "2.9.1"
+  },
+  "devDependencies": {
+    "@types/node": "22.18.0",
+    "typescript": "5.9.3",
+    "vitest": "5.0.3"
+  }
+}