@openserv-labs/client 2.4.7 → 2.5.0

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "./deploy/index.js";
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,mBAAmB,CAAC"}

package/dist/cli.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("./deploy/index.js");

package/dist/deploy/api-client.d.ts

@@ -0,0 +1,46 @@
+export declare class ApiError extends Error {
+    readonly statusCode: number | undefined;
+    constructor(message: string, statusCode: number | undefined);
+}
+export interface ApiClientOptions {
+    apiKey: string;
+    agentId?: number;
+    orchestratorUrl?: string;
+}
+export interface ContainerInfo {
+    id: string;
+    appName: string;
+    machineId: string;
+    status: string;
+}
+export interface StatusInfo {
+    id: string;
+    appName: string;
+    machineId: string;
+    status: string;
+    machineState: string;
+    metadata: Record<string, unknown>;
+}
+export interface ExecResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface GoLiveResult {
+    publicUrl: string;
+}
+export declare class ApiClient {
+    private client;
+    constructor(opts: ApiClientOptions);
+    createContainer(): Promise<ContainerInfo>;
+    getStatus(id: string): Promise<StatusInfo>;
+    findContainerByAgent(agentId: number): Promise<ContainerInfo | null>;
+    upload(id: string, tarBuffer: Buffer): Promise<void>;
+    exec(id: string, command: string[], timeout?: number): Promise<ExecResult>;
+    start(id: string, entrypoint?: string): Promise<void>;
+    restart(id: string): Promise<void>;
+    goLive(id: string, mode?: string): Promise<GoLiveResult>;
+    updateEndpointUrl(agentId: number, agentApiKey: string, endpointUrl: string): Promise<void>;
+    private request;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/deploy/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/deploy/api-client.ts"],"names":[],"mappings":"AAIA,qBAAa,QAAS,SAAQ,KAAK;aAGf,UAAU,EAAE,MAAM,GAAG,SAAS;gBAD9C,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM,GAAG,SAAS;CAKjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAgB;gBAElB,IAAI,EAAE,gBAAgB;IAgB5B,eAAe,IAAI,OAAO,CAAC,aAAa,CAAC;IAIzC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI1C,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAepE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpD,IAAI,CACR,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC;IAOhB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,SAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAM7D,iBAAiB,CACrB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;YAUF,OAAO;CAyBtB"}

package/dist/deploy/api-client.js

@@ -0,0 +1,103 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiClient = exports.ApiError = void 0;
+const axios_1 = __importDefault(require("axios"));
+const DEFAULT_ORCHESTRATOR_URL = "https://agent-orchestrator.openserv.ai";
+class ApiError extends Error {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = "ApiError";
+    }
+}
+exports.ApiError = ApiError;
+class ApiClient {
+    client;
+    constructor(opts) {
+        const headers = {
+            "x-openserv-key": opts.apiKey,
+        };
+        if (opts.agentId != null) {
+            headers["x-openserv-agent-id"] = String(opts.agentId);
+        }
+        this.client = axios_1.default.create({
+            baseURL: opts.orchestratorUrl || DEFAULT_ORCHESTRATOR_URL,
+            headers,
+            maxBodyLength: 100 * 1024 * 1024,
+            maxContentLength: 100 * 1024 * 1024,
+        });
+    }
+    async createContainer() {
+        return this.request("POST", "/container/create");
+    }
+    async getStatus(id) {
+        return this.request("GET", `/container/${id}/status`);
+    }
+    async findContainerByAgent(agentId) {
+        try {
+            const status = await this.getStatus(String(agentId));
+            return {
+                id: status.id,
+                appName: status.appName,
+                machineId: status.machineId,
+                status: status.status,
+            };
+        }
+        catch (err) {
+            if (err instanceof ApiError && err.statusCode === 404)
+                return null;
+            throw err;
+        }
+    }
+    async upload(id, tarBuffer) {
+        await this.request("POST", `/container/${id}/upload`, tarBuffer, {
+            headers: { "Content-Type": "application/gzip" },
+        });
+    }
+    async exec(id, command, timeout) {
+        return this.request("POST", `/container/${id}/exec`, {
+            command,
+            timeout,
+        });
+    }
+    async start(id, entrypoint) {
+        await this.request("POST", `/container/${id}/start`, {
+            entrypoint: entrypoint || "npx tsx src/agent.ts",
+        });
+    }
+    async restart(id) {
+        await this.request("POST", `/container/${id}/restart`);
+    }
+    async goLive(id, mode = "on-demand") {
+        return this.request("POST", `/container/${id}/go-live`, {
+            mode,
+        });
+    }
+    async updateEndpointUrl(agentId, agentApiKey, endpointUrl) {
+        const platformUrl = process.env.OPENSERV_API_URL || "https://api.openserv.ai";
+        await axios_1.default.put(`${platformUrl}/agents/${agentId}/endpoint-url`, { endpoint_url: endpointUrl }, { headers: { "x-openserv-key": agentApiKey } });
+    }
+    async request(method, path, body, config) {
+        try {
+            const res = await this.client.request({
+                method,
+                url: path,
+                data: body,
+                ...config,
+            });
+            return res.data;
+        }
+        catch (err) {
+            const axiosErr = err;
+            const statusCode = axiosErr.response?.status;
+            const data = axiosErr.response?.data ?? axiosErr.message;
+            const detail = typeof data === "string" ? data : JSON.stringify(data);
+            throw new ApiError(`${method} ${path} failed (${statusCode ?? "unknown"}): ${detail}`, statusCode);
+        }
+    }
+}
+exports.ApiClient = ApiClient;

package/dist/deploy/deploy.d.ts

@@ -0,0 +1,2 @@
+export declare function deploy(targetPath: string): Promise<void>;
+//# sourceMappingURL=deploy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/deploy/deploy.ts"],"names":[],"mappings":"AA8CA,wBAAsB,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgH9D"}

package/dist/deploy/deploy.js

@@ -0,0 +1,128 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deploy = deploy;
+const node_path_1 = __importDefault(require("node:path"));
+const api_client_js_1 = require("./api-client.js");
+const env_js_1 = require("./env.js");
+const logger_js_1 = require("./logger.js");
+const openserv_json_js_1 = require("./openserv-json.js");
+const tar_js_1 = require("./tar.js");
+async function resolveContainer(client, dir, containerId, agentId) {
+    if (containerId) {
+        logger_js_1.logger.info(`Using existing container: ${containerId}`);
+        return { id: containerId, isFirstDeploy: false };
+    }
+    if (agentId) {
+        logger_js_1.logger.info(`Agent ID found: ${agentId}. Checking for existing container...`);
+        const existing = await client.findContainerByAgent(agentId);
+        if (existing) {
+            (0, env_js_1.writeContainerId)(dir, existing.id);
+            logger_js_1.logger.info(`  Found container: ${existing.id}`);
+            logger_js_1.logger.info("  Saved to .env\n");
+            return { id: existing.id, isFirstDeploy: false };
+        }
+        logger_js_1.logger.info("  No container found. Creating new container...");
+    }
+    else {
+        logger_js_1.logger.info("Creating new container...");
+    }
+    const container = await client.createContainer();
+    (0, env_js_1.writeContainerId)(dir, container.id);
+    logger_js_1.logger.info(`  Container ID: ${container.id}`);
+    logger_js_1.logger.info("  Written to .env\n");
+    return { id: container.id, isFirstDeploy: true };
+}
+async function deploy(targetPath) {
+    const dir = node_path_1.default.resolve(targetPath);
+    logger_js_1.logger.info(`Deploying from ${dir}\n`);
+    const env = (0, env_js_1.readEnv)(dir);
+    const agentConfig = (0, openserv_json_js_1.readAgentConfig)(dir);
+    const agentId = agentConfig?.id;
+    if (!env.apiKey) {
+        throw new Error("OPENSERV_USER_API_KEY not found. Set it in your .env file or as an environment variable.");
+    }
+    const client = new api_client_js_1.ApiClient({
+        apiKey: env.apiKey,
+        agentId,
+        orchestratorUrl: env.orchestratorUrl,
+    });
+    const { id: targetId, isFirstDeploy } = await resolveContainer(client, dir, env.containerId, agentId);
+    let currentStatus;
+    let appName;
+    if (!isFirstDeploy) {
+        try {
+            const status = await client.getStatus(targetId);
+            currentStatus = status.status;
+            appName = status.appName;
+            logger_js_1.logger.info(`  Current status: ${currentStatus}`);
+        }
+        catch {
+            // Container might not be reachable yet
+        }
+    }
+    logger_js_1.logger.info("\nCreating archive...");
+    const { buffer: tarBuffer, files } = await (0, tar_js_1.createTarBuffer)(dir);
+    for (const file of files) {
+        logger_js_1.logger.info(`  ${file}`);
+    }
+    logger_js_1.logger.info(`  ${files.length} files, ${(tarBuffer.length / 1024).toFixed(1)} KB`);
+    logger_js_1.logger.info("\nUploading files...");
+    await client.upload(targetId, tarBuffer);
+    logger_js_1.logger.info("  Done.");
+    const verify = await client.exec(targetId, ["ls", "-la", "/app"], 30);
+    if (verify.exitCode === 0) {
+        logger_js_1.logger.info("  Verified /app contents:");
+        for (const line of verify.stdout.split("\n").filter(Boolean)) {
+            logger_js_1.logger.info(`    ${line}`);
+        }
+    }
+    else {
+        logger_js_1.logger.error("  Warning: could not verify upload");
+        if (verify.stderr)
+            logger_js_1.logger.error(`    ${verify.stderr}`);
+    }
+    logger_js_1.logger.info("\nInstalling dependencies...");
+    const installResult = await client.exec(targetId, ["npm", "install"], 600);
+    if (installResult.exitCode !== 0) {
+        const parts = [`npm install failed (exit code ${installResult.exitCode})`];
+        if (installResult.stdout)
+            parts.push(`stdout: ${installResult.stdout.slice(0, 500)}`);
+        if (installResult.stderr)
+            parts.push(`stderr: ${installResult.stderr.slice(0, 500)}`);
+        throw new Error(parts.join("\n"));
+    }
+    logger_js_1.logger.info("  Done.");
+    const needsStart = isFirstDeploy || !currentStatus || currentStatus === "ready";
+    if (needsStart) {
+        logger_js_1.logger.info("\nStarting agent...");
+        await client.start(targetId);
+        logger_js_1.logger.info("  Agent started.");
+    }
+    else {
+        logger_js_1.logger.info("\nRestarting container...");
+        await client.restart(targetId);
+        logger_js_1.logger.info("  Container restarted.");
+    }
+    let publicUrl;
+    if (currentStatus !== "live") {
+        logger_js_1.logger.info("\nGoing live...");
+        const result = await client.goLive(targetId, "continuous");
+        publicUrl = result.publicUrl;
+        logger_js_1.logger.info(`  Public URL: ${publicUrl}`);
+    }
+    else {
+        if (appName) {
+            publicUrl = `https://${appName}.fly.dev`;
+        }
+        logger_js_1.logger.info("\nAlready live.");
+    }
+    if (agentConfig?.apiKey && agentConfig.id && publicUrl) {
+        logger_js_1.logger.info("\nUpdating agent endpoint URL...");
+        await client.updateEndpointUrl(agentConfig.id, agentConfig.apiKey, publicUrl);
+        logger_js_1.logger.info(`  Agent endpoint set to ${publicUrl}`);
+    }
+    logger_js_1.logger.info("\nDeploy complete!");
+}

package/dist/deploy/env.d.ts

@@ -0,0 +1,8 @@
+export interface EnvValues {
+    apiKey?: string;
+    containerId?: string;
+    orchestratorUrl?: string;
+}
+export declare function readEnv(dir: string): EnvValues;
+export declare function writeContainerId(dir: string, containerId: string): void;
+//# sourceMappingURL=env.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/deploy/env.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAY9C;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAoBvE"}

package/dist/deploy/env.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readEnv = readEnv;
+exports.writeContainerId = writeContainerId;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const dotenv_1 = require("dotenv");
+function readEnv(dir) {
+    const envPath = node_path_1.default.join(dir, ".env");
+    const parsed = (0, dotenv_1.config)({ path: envPath });
+    const env = parsed.parsed ?? {};
+    return {
+        apiKey: env.OPENSERV_USER_API_KEY || process.env.OPENSERV_USER_API_KEY,
+        containerId: env.OPENSERV_CONTAINER_ID || process.env.OPENSERV_CONTAINER_ID,
+        orchestratorUrl: env.OPENSERV_ORCHESTRATOR_URL || process.env.OPENSERV_ORCHESTRATOR_URL,
+    };
+}
+function writeContainerId(dir, containerId) {
+    const envPath = node_path_1.default.join(dir, ".env");
+    let content = "";
+    if (node_fs_1.default.existsSync(envPath)) {
+        content = node_fs_1.default.readFileSync(envPath, "utf8");
+    }
+    const key = "OPENSERV_CONTAINER_ID";
+    const line = `${key}=${containerId}`;
+    const regex = new RegExp(`^${key}=.*$`, "m");
+    if (regex.test(content)) {
+        content = content.replace(regex, line);
+    }
+    else {
+        const separator = content.length > 0 && !content.endsWith("\n") ? "\n" : "";
+        content = `${content}${separator}${line}\n`;
+    }
+    node_fs_1.default.writeFileSync(envPath, content, "utf8");
+}

package/dist/deploy/index.d.ts

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

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

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

package/dist/deploy/index.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const deploy_js_1 = require("./deploy.js");
+const HELP = `
+Usage: serv <command> [path]
+
+Commands:
+  deploy [path]   Deploy an agent to OpenServ (default path: .)
+
+Options:
+  --help, -h      Show this help message
+
+Environment variables (set in .env or shell):
+  OPENSERV_USER_API_KEY       Your OpenServ API key (required)
+  OPENSERV_CONTAINER_ID       Container ID for redeployment (auto-set after first deploy)
+  OPENSERV_ORCHESTRATOR_URL   Custom orchestrator URL (optional)
+`.trim();
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+        console.log(HELP);
+        process.exit(0);
+    }
+    const command = args[0];
+    switch (command) {
+        case "deploy": {
+            const targetPath = args[1] || ".";
+            await (0, deploy_js_1.deploy)(targetPath);
+            break;
+        }
+        default:
+            console.error(`Unknown command: ${command}\n`);
+            console.log(HELP);
+            process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error("\nFailed:", err instanceof Error ? err.message : err);
+    process.exit(1);
+});

package/dist/deploy/logger.d.ts

@@ -0,0 +1,6 @@
+export declare const logger: {
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/deploy/logger.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;oBACD,OAAO,EAAE;oBACT,OAAO,EAAE;qBACR,OAAO,EAAE;CAC3B,CAAC"}

package/dist/deploy/logger.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.logger = {
+    info: (...args) => console.log(...args),
+    warn: (...args) => console.warn(...args),
+    error: (...args) => console.error(...args),
+};

package/dist/deploy/openserv-json.d.ts

@@ -0,0 +1,6 @@
+export interface AgentConfig {
+    id: number;
+    apiKey?: string;
+}
+export declare function readAgentConfig(dir: string): AgentConfig | undefined;
+//# sourceMappingURL=openserv-json.d.ts.map

package/dist/deploy/openserv-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openserv-json.d.ts","sourceRoot":"","sources":["../../src/deploy/openserv-json.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAmBpE"}

package/dist/deploy/openserv-json.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readAgentConfig = readAgentConfig;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+function readAgentConfig(dir) {
+    const filePath = node_path_1.default.join(dir, ".openserv.json");
+    if (!node_fs_1.default.existsSync(filePath)) {
+        return undefined;
+    }
+    try {
+        const raw = node_fs_1.default.readFileSync(filePath, "utf8");
+        const data = JSON.parse(raw);
+        if (!data.agents)
+            return undefined;
+        const firstAgent = Object.values(data.agents)[0];
+        if (!firstAgent)
+            return undefined;
+        return { id: firstAgent.id, apiKey: firstAgent.apiKey };
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/deploy/tar.d.ts

@@ -0,0 +1,6 @@
+export interface TarResult {
+    buffer: Buffer;
+    files: string[];
+}
+export declare function createTarBuffer(dir: string): Promise<TarResult>;
+//# sourceMappingURL=tar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tar.d.ts","sourceRoot":"","sources":["../../src/deploy/tar.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAerE"}

package/dist/deploy/tar.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTarBuffer = createTarBuffer;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const ignore_1 = __importDefault(require("ignore"));
+const nanotar_1 = require("nanotar");
+const ALWAYS_EXCLUDE = [
+    "node_modules",
+    ".git",
+    "dist",
+    ".next",
+    ".turbo",
+    ".env",
+    ".env.example",
+    ".env.local",
+    ".env.*.local",
+];
+const ALWAYS_EXCLUDE_EXTENSIONS = [".tsbuildinfo"];
+async function createTarBuffer(dir) {
+    const ig = (0, ignore_1.default)();
+    ig.add(ALWAYS_EXCLUDE);
+    const gitignorePath = node_path_1.default.join(dir, ".gitignore");
+    if (node_fs_1.default.existsSync(gitignorePath)) {
+        const content = node_fs_1.default.readFileSync(gitignorePath, "utf8");
+        ig.add(content);
+    }
+    const entries = collectEntries(dir, dir, ig);
+    const files = entries.map((e) => e.name);
+    const gzipped = await (0, nanotar_1.createTarGzip)(entries);
+    return { buffer: Buffer.from(gzipped), files };
+}
+function collectEntries(baseDir, currentDir, ig) {
+    const entries = [];
+    const items = node_fs_1.default.readdirSync(currentDir, { withFileTypes: true });
+    for (const item of items) {
+        const fullPath = node_path_1.default.join(currentDir, item.name);
+        const relativePath = node_path_1.default.relative(baseDir, fullPath);
+        if (ALWAYS_EXCLUDE_EXTENSIONS.some((ext) => item.name.endsWith(ext))) {
+            continue;
+        }
+        const testPath = item.isDirectory() ? `${relativePath}/` : relativePath;
+        if (ig.ignores(testPath)) {
+            continue;
+        }
+        if (item.isDirectory()) {
+            entries.push(...collectEntries(baseDir, fullPath, ig));
+        }
+        else {
+            entries.push({
+                name: relativePath,
+                data: new Uint8Array(node_fs_1.default.readFileSync(fullPath)),
+            });
+        }
+    }
+    return entries;
+}

package/dist/provision.d.ts

@@ -47,7 +47,7 @@ export interface AgentInstance {
  * };
  * ```
  */
-export interface ProvisionConfig {
+interface ProvisionConfigBase {
     /** Agent configuration */
     agent: {
         /**
@@ -114,6 +114,16 @@ export interface ProvisionConfig {
         agentIds?: number[];
     };
 }
+/**
+ * Pre-created user API key to skip SIWE authentication.
+ * When the workflow trigger is x402, walletAddress is also required
+ * so the platform knows which wallet to use for payments.
+ */
+interface ProvisionConfigWithCredentials extends ProvisionConfigBase {
+    userApiKey: string;
+    walletAddress?: string;
+}
+export type ProvisionConfig = ProvisionConfigWithCredentials | ProvisionConfigBase;
 /**
  * Result from provisioning an agent and workflow.
  */
@@ -268,4 +278,5 @@ export declare function getProvisionedInfo(agentName: string, workflowName?: str
  * ```
  */
 export declare function clearProvisionedState(): void;
+export {};
 //# sourceMappingURL=provision.d.ts.map

package/dist/provision.d.ts.map

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

package/dist/provision.js

@@ -155,6 +155,32 @@ function writeWalletToEnv(privateKey) {
     writeEnvVar("WALLET_PRIVATE_KEY", privateKey);
 }
 // ============================================================================
+// State Initialization
+// ============================================================================
+/**
+ * Initialize the state file if it doesn't exist yet.
+ *
+ * Reads `OPENSERV_USER_API_KEY` from the environment and seeds
+ * `.openserv.json` with the key plus empty `agents` and `workflows` maps.
+ * If the state file already exists, this is a no-op.
+ */
+function initState() {
+    const statePath = path.resolve(process.cwd(), STATE_FILE);
+    if (fs.existsSync(statePath)) {
+        return;
+    }
+    const userApiKey = process.env.OPENSERV_USER_API_KEY;
+    const state = {
+        agents: {},
+        workflows: {},
+    };
+    if (userApiKey) {
+        state.userApiKey = userApiKey;
+    }
+    writeState(state);
+    logger.info("Initialized state file");
+}
+// ============================================================================
 // Wallet Management
 // ============================================================================
 /**
@@ -483,6 +509,33 @@ async function provisionWorkflow(client, agentId, agentName, config) {
 // ============================================================================
 // Main Provision Function
 // ============================================================================
+function validateProvisionCredentials(config) {
+    const hasApiKey = "userApiKey" in config && !!config.userApiKey;
+    const hasWallet = "walletAddress" in config && !!config.walletAddress;
+    if (hasWallet && !hasApiKey) {
+        throw new Error("walletAddress requires userApiKey to be provided");
+    }
+    if (hasApiKey && !hasWallet && config.workflow.trigger.type === "x402") {
+        throw new Error("walletAddress is required when using an x402 trigger with userApiKey");
+    }
+}
+async function initializePlatformClient(config) {
+    const hasApiKey = "userApiKey" in config && !!config.userApiKey;
+    if (hasApiKey) {
+        const { userApiKey, walletAddress } = config;
+        const client = new client_1.PlatformClient({ apiKey: userApiKey });
+        if (walletAddress) {
+            client.walletAddress = walletAddress;
+        }
+        const state = readState();
+        writeState({ ...state, userApiKey });
+        return client;
+    }
+    initState();
+    const { privateKey } = await getOrCreateWallet();
+    const { client } = await createAuthenticatedClient(privateKey);
+    return client;
+}
 /**
  * Provision an agent and workflow on the OpenServ platform.
  *
@@ -524,11 +577,8 @@ async function provisionWorkflow(client, agentId, agentName, config) {
  * ```
  */
 async function provision(config) {
-    // Get or create wallet
-    const { privateKey } = await getOrCreateWallet();
-    // Create authenticated client (reuses saved API key for session continuity)
-    // walletAddress is set on client.walletAddress for x402 resolution
-    const { client } = await createAuthenticatedClient(privateKey);
+    validateProvisionCredentials(config);
+    const client = await initializePlatformClient(config);
     // Provision agent (returns agentId, apiKey, and authToken)
     const { agentId, apiKey, authToken } = await provisionAgent(client, config.agent);
     // Bind credentials to the agent

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@openserv-labs/client",
-  "version": "2.4.7",
+  "version": "2.5.0",
   "description": "OpenServ Platform Client - Manage agents, workflows, tasks, and triggers via the OpenServ API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "serv": "./dist/cli.js"
+  },
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
@@ -15,7 +18,8 @@
     "format": "prettier --write \"**/*.{ts,json,md}\"",
     "format:check": "prettier --check \"**/*.{ts,json,md}\"",
     "test": "node --import tsx --test test/**/*.test.ts",
-    "test:unit": "node --import tsx --test test/unit/**/*.test.ts"
+    "test:unit": "node --import tsx --test test/unit/**/*.test.ts",
+    "deploy": "tsx src/cli.ts deploy"
   },
   "repository": {
     "type": "git",
@@ -38,6 +42,9 @@
   "license": "MIT",
   "dependencies": {
     "axios": "^1.6.8",
+    "dotenv": "^16.4.5",
+    "ignore": "^7.0.3",
+    "nanotar": "^0.2.0",
     "pinata": "^2.5.1",
     "viem": "^2.45.1"
   },
@@ -45,7 +52,6 @@
     "@eslint/js": "^9.39.2",
     "@tsconfig/strictest": "^2.0.3",
     "@types/node": "^22.10.2",
-    "dotenv": "^16.4.5",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^9.1.0",
     "eslint-plugin-prettier": "^5.1.3",