@almyty/agents 0.1.1 → 1.2.0

package/README.md

@@ -27,8 +27,12 @@ $ npx @almyty/agents run my-agent --input '{"text": "hello"}' --watch
 | Flag | Description |
 |------|-------------|
 | `--input '<json>'` | Input payload (object for workflow, string or object for autonomous) |
+| `--resume <conversation-id>` | Resume a previous autonomous conversation |
 | `--watch` | Stream steps as they arrive |
 | `--json` | Print raw JSON output |
+| `--max-steps <n>` | Autonomous: max steps (default 50) |
+| `--max-cost-cents <n>` | Autonomous: max cost in cents (default 100) |
+| `--max-duration-ms <ms>` | Autonomous: max wall time in ms (default 3600000) |
 
 ## Environment variables
 
@@ -41,10 +45,14 @@ $ npx @almyty/agents run my-agent --input '{"text": "hello"}' --watch
 
 Requires `npx @almyty/auth login` first. Reads credentials from `~/.almyty/credentials.json`.
 
-## Docs
+## About almyty
 
-https://almyty.com/docs
+almyty is the full-stack platform for AI agents, agnostic by design: any LLM, any
+API turned into tools, served over MCP, A2A, UTCP, and Agent Skills. Open source,
+no lock-in.
 
-## License
+- Website — https://almyty.com
+- Docs — https://docs.almyty.com
+- Source — https://github.com/almyty-inc/almyty
 
-BSL-1.1
+Apache-2.0 © Almyty Inc.

package/dist/index.js

@@ -11,8 +11,7 @@
  * Reads credentials from ~/.almyty/credentials.json (created by
  * `npx @almyty/auth login`).
  */
-import { AlmytyClient } from './client.js';
-import { resolveCredentialsOrExit } from './credentials.js';
+import { AlmytyClient, resolveCredentialsOrExit } from '@almyty/client';
 const VERSION = '0.1.0';
 function printHelp() {
     console.log(`
@@ -31,6 +30,7 @@ Commands:
 
 Run options:
   --input '<json>'              Input payload (workflow: object; autonomous: string or object)
+  --resume <conversation-id>    Resume a previous conversation
   --max-steps <n>               Autonomous: max steps (default 50)
   --max-cost-cents <n>          Autonomous: max cost in cents (default 100)
   --max-duration-ms <ms>        Autonomous: max wall time in ms (default 3600000)
@@ -188,7 +188,9 @@ async function cmdRun(args) {
             limits.maxCostCents = Number(args.flags['max-cost-cents']);
         if (args.flags['max-duration-ms'])
             limits.maxDurationMs = Number(args.flags['max-duration-ms']);
-        const runStub = await client.startAgentRun(agent.id, rawInput ?? '', limits);
+        if (typeof args.flags.resume === 'string')
+            limits.conversationId = args.flags.resume;
+        const runStub = await client.startRun(agent.id, rawInput ?? '', limits);
         if (!args.flags.watch) {
             if (args.flags.json) {
                 console.log(JSON.stringify(runStub, null, 2));

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@almyty/agents",
-  "version": "0.1.1",
-  "description": "List, run, and manage almyty agents from the command line",
+  "version": "1.2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Run and manage almyty agents from your terminal \u2014 list, invoke workflow or autonomous runs, stream steps, and inspect run history.",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -11,7 +14,7 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && chmod +x dist/index.js",
     "dev": "tsx src/index.ts",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -23,11 +26,23 @@
     "cli"
   ],
   "author": "almyty",
-  "license": "BSL-1.1",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@almyty/client": "^1.2.0"
+  },
   "devDependencies": {
     "@types/node": "^25.4.0",
     "tsx": "^4.7.0",
     "typescript": "^5.3.0",
     "vitest": "^4.1.0"
+  },
+  "homepage": "https://almyty.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/almyty-inc/almyty.git",
+    "directory": "packages/agents-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/almyty-inc/almyty/issues"
   }
 }

package/dist/client.d.ts

@@ -1,50 +0,0 @@
-/**
- * Tiny HTTP client for the almyty REST API, scoped to the surface
- * needed by @almyty/agents (list / get / invoke / runs).
- */
-export interface AgentInfo {
-    id: string;
-    name: string;
-    description?: string;
-    mode?: 'workflow' | 'autonomous';
-    status?: string;
-}
-export interface AgentRun {
-    id: string;
-    status: string;
-    output?: any;
-    error?: string;
-    steps?: any[];
-    totalCost?: number;
-    totalTokens?: number;
-}
-export declare class AlmytyClient {
-    private readonly baseUrl;
-    private readonly token;
-    constructor(baseUrl: string, token: string);
-    private request;
-    listAgents(): Promise<AgentInfo[]>;
-    findAgentByNameOrId(nameOrId: string): Promise<AgentInfo | null>;
-    invokeAgent(agentId: string, input: Record<string, any>): Promise<any>;
-    startAgentRun(agentId: string, input: any, limits?: {
-        maxSteps?: number;
-        maxCostCents?: number;
-        maxDurationMs?: number;
-    }): Promise<AgentRun>;
-    getRun(agentId: string, runId: string): Promise<AgentRun>;
-    listRuns(agentId: string, page?: number, limit?: number): Promise<{
-        data: AgentRun[];
-        total: number;
-    }>;
-    sendRunInput(agentId: string, runId: string, input: string): Promise<void>;
-    cancelRun(agentId: string, runId: string): Promise<void>;
-    /**
-     * Poll a run until it reaches a terminal status (or waiting_input).
-     * Calls onStep whenever new steps appear so callers can stream output.
-     */
-    pollRun(agentId: string, runId: string, options?: {
-        intervalMs?: number;
-        timeoutMs?: number;
-        onStep?: (run: AgentRun) => void;
-    }): Promise<AgentRun>;
-}

package/dist/client.js

@@ -1,121 +0,0 @@
-/**
- * Tiny HTTP client for the almyty REST API, scoped to the surface
- * needed by @almyty/agents (list / get / invoke / runs).
- */
-const TERMINAL_STATUSES = new Set(['completed', 'failed', 'cancelled', 'timeout']);
-export class AlmytyClient {
-    baseUrl;
-    token;
-    constructor(baseUrl, token) {
-        this.baseUrl = baseUrl.replace(/\/$/, '');
-        this.token = token;
-    }
-    async request(path, init = {}) {
-        const url = `${this.baseUrl}${path}`;
-        const headers = {
-            Authorization: `Bearer ${this.token}`,
-            'Content-Type': 'application/json',
-            ...(init.headers || {}),
-        };
-        const res = await fetch(url, { ...init, headers });
-        if (!res.ok) {
-            if (res.status === 401) {
-                throw new Error('Authentication failed. Run: npx @almyty/auth login');
-            }
-            const text = await res.text().catch(() => '');
-            throw new Error(`API error ${res.status}: ${text}`);
-        }
-        if (res.status === 204)
-            return null;
-        return res.json();
-    }
-    async listAgents() {
-        const data = await this.request('/agents');
-        const agents = data?.data?.data || data?.data || data || [];
-        return agents.map((a) => ({
-            id: a.id,
-            name: a.name,
-            description: a.description,
-            mode: a.mode,
-            status: a.status,
-        }));
-    }
-    async findAgentByNameOrId(nameOrId) {
-        const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-        if (uuidRegex.test(nameOrId)) {
-            try {
-                const data = await this.request(`/agents/${nameOrId}`);
-                const a = data?.data ?? data;
-                if (a?.id) {
-                    return { id: a.id, name: a.name, description: a.description, mode: a.mode, status: a.status };
-                }
-            }
-            catch {
-                // fall through to name search
-            }
-        }
-        const all = await this.listAgents();
-        const lower = nameOrId.toLowerCase();
-        return (all.find((a) => a.name === nameOrId) ||
-            all.find((a) => a.name.toLowerCase() === lower) ||
-            all.find((a) => a.name.toLowerCase().replace(/\s+/g, '-') === lower) ||
-            null);
-    }
-    async invokeAgent(agentId, input) {
-        const data = await this.request(`/agents/${agentId}/invoke`, {
-            method: 'POST',
-            body: JSON.stringify({ input }),
-        });
-        return data?.data ?? data;
-    }
-    async startAgentRun(agentId, input, limits) {
-        const data = await this.request(`/agents/${agentId}/runs`, {
-            method: 'POST',
-            body: JSON.stringify({ input, ...(limits || {}) }),
-        });
-        const run = data?.data ?? data;
-        return { id: run.id, status: run.status };
-    }
-    async getRun(agentId, runId) {
-        const data = await this.request(`/agents/${agentId}/runs/${runId}`);
-        return (data?.data ?? data);
-    }
-    async listRuns(agentId, page = 1, limit = 20) {
-        const data = await this.request(`/agents/${agentId}/runs?page=${page}&limit=${limit}`);
-        return {
-            data: data?.data ?? [],
-            total: data?.pagination?.total ?? 0,
-        };
-    }
-    async sendRunInput(agentId, runId, input) {
-        await this.request(`/agents/${agentId}/runs/${runId}/input`, {
-            method: 'POST',
-            body: JSON.stringify({ input }),
-        });
-    }
-    async cancelRun(agentId, runId) {
-        await this.request(`/agents/${agentId}/runs/${runId}/cancel`, { method: 'POST' });
-    }
-    /**
-     * Poll a run until it reaches a terminal status (or waiting_input).
-     * Calls onStep whenever new steps appear so callers can stream output.
-     */
-    async pollRun(agentId, runId, options = {}) {
-        const intervalMs = options.intervalMs ?? 1500;
-        const timeoutMs = options.timeoutMs ?? 5 * 60_000;
-        const deadline = Date.now() + timeoutMs;
-        let lastStepCount = -1;
-        while (Date.now() < deadline) {
-            const run = await this.getRun(agentId, runId);
-            if (Array.isArray(run.steps) && run.steps.length !== lastStepCount) {
-                lastStepCount = run.steps.length;
-                options.onStep?.(run);
-            }
-            if (run.status && (TERMINAL_STATUSES.has(run.status) || run.status === 'waiting_input')) {
-                return run;
-            }
-            await new Promise((r) => setTimeout(r, intervalMs));
-        }
-        throw new Error(`Run ${runId} did not finish within ${Math.round(timeoutMs / 1000)}s`);
-    }
-}

package/dist/credentials.d.ts

@@ -1,16 +0,0 @@
-/**
- * Read shared almyty credentials from ~/.almyty/credentials.json.
- *
- * Identical to packages/auth-cli/src/credentials.ts (intentional copy
- * to keep each CLI package self-contained — these few helpers don't
- * justify a workspace dependency).
- */
-export declare const CREDENTIALS_FILE: string;
-export interface StoredCredentials {
-    url: string;
-    token: string;
-    email?: string;
-    frontendUrl?: string;
-}
-export declare function loadCredentials(): StoredCredentials | null;
-export declare function resolveCredentialsOrExit(): StoredCredentials;

package/dist/credentials.js

@@ -1,34 +0,0 @@
-/**
- * Read shared almyty credentials from ~/.almyty/credentials.json.
- *
- * Identical to packages/auth-cli/src/credentials.ts (intentional copy
- * to keep each CLI package self-contained — these few helpers don't
- * justify a workspace dependency).
- */
-import { readFileSync, existsSync } from 'fs';
-import { homedir } from 'os';
-import { join } from 'path';
-export const CREDENTIALS_FILE = join(homedir(), '.almyty', 'credentials.json');
-export function loadCredentials() {
-    try {
-        if (!existsSync(CREDENTIALS_FILE))
-            return null;
-        return JSON.parse(readFileSync(CREDENTIALS_FILE, 'utf-8'));
-    }
-    catch {
-        return null;
-    }
-}
-export function resolveCredentialsOrExit() {
-    const envToken = process.env.ALMYTY_TOKEN;
-    const envUrl = process.env.ALMYTY_URL || 'https://api.almyty.com';
-    if (envToken)
-        return { url: envUrl, token: envToken };
-    const stored = loadCredentials();
-    if (stored?.token)
-        return stored;
-    console.error('Not authenticated. Run one of:');
-    console.error('  npx @almyty/auth login');
-    console.error('  export ALMYTY_TOKEN=<your-token>');
-    process.exit(1);
-}