@almyty/skills 1.0.1 → 1.0.3

package/README.md

@@ -1,55 +1,38 @@
 # @almyty/skills
 
-Install and manage AI skills from [almyty](https://almyty.com) in 30+ coding agents.
+Install and manage almyty skills in 30+ AI coding agents (Claude Code, Cursor, Windsurf, Copilot, Codex, and more).
 
-## Quick Start
+## Quick start
 
 ```bash
-# Install skills from a gateway
-npx @almyty/skills install @your-org/your-gateway
-
-# Keep skills synced (daemon mode)
-npx @almyty/skills daemon
-
-# Run a skill directly
-npx @almyty/skills run @your-org/your-gateway/tool-name --param value
+$ npx @almyty/auth login
+$ npx @almyty/skills gateways
+$ npx @almyty/skills install @org/gateway
 ```
 
-## What It Does
-
-almyty turns any API into AI-ready tools. This CLI installs those tools as **SKILL.md files** into your project, where they're automatically picked up by supported agents.
-
-## Supported Agents
-
-| Category | Agents |
-|----------|--------|
-| **IDE** | Claude Code, Cursor, Windsurf, VS Code Copilot, JetBrains |
-| **AI Assistants** | Claude Desktop, ChatGPT, Gemini |
-| **Dev Tools** | Aider, Continue, Cody, GitHub Copilot CLI |
-| **Frameworks** | LangChain, LlamaIndex, CrewAI, AutoGPT |
-
 ## Commands
 
-```
-npx @almyty/skills login              Authenticate with almyty
-npx @almyty/skills logout             Remove stored credentials
-npx @almyty/skills daemon             Start skill daemon (syncs all skills)
-npx @almyty/skills install <ref>      Install skills from a gateway
-npx @almyty/skills list [ref]         List available skills
-npx @almyty/skills search <query>     Search for skills
-npx @almyty/skills run <ref>          Execute a skill
-npx @almyty/skills installed          Show locally installed skills
-npx @almyty/skills remove             Remove all installed skills
-npx @almyty/skills gateways           List your gateways
-```
+| Command | Description |
+|---------|-------------|
+| `gateways` | List your gateways |
+| `list` | List all available skills |
+| `list @org/gateway` | List skills from one gateway |
+| `search <query>` | Search skills by keyword |
+| `install @org/gateway` | Install all skills from a gateway |
+| `install @org/gateway/skill` | Install a single skill |
+| `installed` | Show locally installed skills |
+| `remove` | Remove all installed skills |
+| `run @org/gateway/skill [--key value]` | Execute a skill |
+| `daemon [--interval 60]` | Sync all skills on a schedule |
+| `watch @org/gateway [--interval 60]` | Watch a specific gateway for changes |
 
 ## References
 
 Skills are referenced as `@org/gateway` or `@org/gateway/skill`:
 
 ```bash
-npx @almyty/skills install @acme/petstore        # All skills from a gateway
-npx @almyty/skills run @acme/petstore/get-pet     # Run a specific skill
+$ npx @almyty/skills install @acme/petstore
+$ npx @almyty/skills run @acme/petstore/get-pet --id 123
 ```
 
 ## Configuration
@@ -63,7 +46,21 @@ Create `.almytyrc` in your project or home directory:
 }
 ```
 
-Or use environment variables: `ALMYTY_URL`, `ALMYTY_TOKEN`.
+## Environment variables
+
+| Variable | Description |
+|----------|-------------|
+| `ALMYTY_TOKEN` | Auth token override |
+| `ALMYTY_URL` | API URL override |
+| `ALMYTY_SKILLS_DIR` | Custom directory for installed skill files |
+
+## Authentication
+
+Requires `npx @almyty/auth login` first. Reads credentials from `~/.almyty/credentials.json`.
+
+## Docs
+
+https://almyty.com/docs
 
 ## License
 

package/dist/__tests__/client.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/client.test.js

@@ -0,0 +1,145 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { parseRef } from '../client.js';
+import { generateMetaSkill } from '../meta-skill.js';
+import { loadConfig } from '../config.js';
+// ---------------------------------------------------------------------------
+// parseRef()
+// ---------------------------------------------------------------------------
+describe('parseRef', () => {
+    it('parses @org/gateway as a gateway ref', () => {
+        const result = parseRef('@org/gateway');
+        expect(result).toEqual({
+            type: 'gateway',
+            orgSlug: 'org',
+            gatewaySlug: 'gateway',
+            raw: '@org/gateway',
+        });
+    });
+    it('parses @org/gateway/skill as a skill ref', () => {
+        const result = parseRef('@org/gateway/skill');
+        expect(result).toEqual({
+            type: 'skill',
+            orgSlug: 'org',
+            gatewaySlug: 'gateway',
+            skillName: 'skill',
+            raw: '@org/gateway/skill',
+        });
+    });
+    it('parses a UUID string as a uuid ref', () => {
+        const uuid = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890';
+        const result = parseRef(uuid);
+        expect(result).toEqual({
+            type: 'uuid',
+            uuid,
+            raw: uuid,
+        });
+    });
+    it('parses uppercase UUID correctly', () => {
+        const uuid = 'A1B2C3D4-E5F6-7890-ABCD-EF1234567890';
+        const result = parseRef(uuid);
+        expect(result.type).toBe('uuid');
+        expect(result.uuid).toBe(uuid);
+    });
+    it('returns search for a random string', () => {
+        const result = parseRef('some-random-query');
+        expect(result).toEqual({
+            type: 'search',
+            raw: 'some-random-query',
+        });
+    });
+    it('returns search for an empty string', () => {
+        const result = parseRef('');
+        expect(result).toEqual({
+            type: 'search',
+            raw: '',
+        });
+    });
+    it('returns search for @ with only one segment', () => {
+        const result = parseRef('@org');
+        expect(result).toEqual({
+            type: 'search',
+            raw: '@org',
+        });
+    });
+    it('returns search for @ with more than three segments', () => {
+        const result = parseRef('@org/gw/skill/extra');
+        expect(result).toEqual({
+            type: 'search',
+            raw: '@org/gw/skill/extra',
+        });
+    });
+});
+// ---------------------------------------------------------------------------
+// generateMetaSkill()
+// ---------------------------------------------------------------------------
+describe('generateMetaSkill', () => {
+    it('returns a SkillFile with name "skills" and fileName "almyty-skills"', () => {
+        const skill = generateMetaSkill();
+        expect(skill.name).toBe('skills');
+        expect(skill.fileName).toBe('almyty-skills');
+    });
+    it('content includes npx @almyty/skills commands', () => {
+        const { content } = generateMetaSkill();
+        expect(content).toContain('npx @almyty/skills');
+    });
+    it('content references daemon command', () => {
+        const { content } = generateMetaSkill();
+        expect(content).toContain('daemon');
+    });
+    it('content references search command', () => {
+        const { content } = generateMetaSkill();
+        expect(content).toContain('search');
+    });
+    it('content references install command', () => {
+        const { content } = generateMetaSkill();
+        expect(content).toContain('install');
+    });
+    it('content references run command', () => {
+        const { content } = generateMetaSkill();
+        expect(content).toContain('run');
+    });
+    it('content includes SKILL.md front-matter', () => {
+        const { content } = generateMetaSkill();
+        expect(content).toContain('---');
+        expect(content).toContain('name: almyty-skills');
+        expect(content).toContain('description:');
+    });
+});
+// ---------------------------------------------------------------------------
+// loadConfig()
+// ---------------------------------------------------------------------------
+describe('loadConfig', () => {
+    const originalEnv = process.env;
+    beforeEach(() => {
+        // Reset env between tests
+        process.env = { ...originalEnv };
+        delete process.env.APIFAI_SKILLS_DIR;
+    });
+    afterEach(() => {
+        process.env = originalEnv;
+        vi.restoreAllMocks();
+    });
+    it('returns empty config when no .almytyrc exists and no env var', () => {
+        // Use a temp directory that definitely has no .almytyrc
+        const config = loadConfig('/tmp/nonexistent-dir-' + Date.now());
+        expect(config).toEqual({});
+    });
+    it('uses APIFAI_SKILLS_DIR env var when set', () => {
+        process.env.APIFAI_SKILLS_DIR = '/custom/skills/dir';
+        const config = loadConfig();
+        expect(config).toEqual({ skillsDir: '/custom/skills/dir' });
+    });
+    it('env var takes precedence over .almytyrc files', () => {
+        process.env.APIFAI_SKILLS_DIR = '/env/override';
+        // Even if we pass a projectDir, env should take priority
+        const config = loadConfig('/some/project');
+        expect(config.skillsDir).toBe('/env/override');
+    });
+    it('returns empty config for a directory with no rc file and no home rc', () => {
+        // Use a deeply nested temp path that certainly has no .almytyrc anywhere
+        // and also won't match ~/.almytyrc (already handled by the missing file)
+        const fakePath = `/tmp/almyty-test-${Date.now()}/deeply/nested/project`;
+        const config = loadConfig(fakePath);
+        expect(config).toEqual({});
+    });
+});

package/dist/auth.d.ts

@@ -1,41 +1,20 @@
 /**
- * Authentication helpers for the almyty skills CLI.
+ * Credential resolver for @almyty/skills.
  *
- * Shares credentials with @almyty/mcp-server via ~/.almyty/credentials.json.
+ * Authentication itself lives in the dedicated @almyty/auth package
+ * (`npx @almyty/auth login`). This module just READS the shared
+ * credentials store and surfaces them to the rest of the skills CLI.
  *
- * Supports:
- * 1. Environment variable (APIFAI_TOKEN) — for CI/scripts
- * 2. Stored credentials (~/.almyty/credentials.json) — for interactive use
- * 3. Interactive login (npx @almyty/skills login) — stores credentials
+ * Lookup order:
+ *   1. ALMYTY_TOKEN environment variable      (CI / scripts)
+ *   2. ~/.almyty/credentials.json              (interactive use, written
+ *                                               by `npx @almyty/auth login`)
  */
-interface StoredCredentials {
-    url: string;
-    token: string;
-    email?: string;
-    expiresAt?: string;
-}
-/**
- * Load stored credentials from ~/.almyty/credentials.json
- */
-export declare function loadCredentials(): StoredCredentials | null;
-/**
- * Save credentials to ~/.almyty/credentials.json
- */
-export declare function saveCredentials(creds: StoredCredentials): void;
-/**
- * Remove stored credentials
- */
-export declare function logout(): void;
 /**
- * Resolve token: env var > stored credentials
+ * Resolve token: env var > stored credentials. Exits with a clear hint
+ * if no credentials are available.
  */
 export declare function resolveAuth(): {
     url: string;
     token: string;
 };
-/**
- * Interactive login: prompts for email/password, authenticates against
- * the almyty backend, and stores the JWT token.
- */
-export declare function login(baseUrl: string): Promise<void>;
-export {};

package/dist/auth.js

@@ -1,63 +1,36 @@
 /**
- * Authentication helpers for the almyty skills CLI.
+ * Credential resolver for @almyty/skills.
  *
- * Shares credentials with @almyty/mcp-server via ~/.almyty/credentials.json.
+ * Authentication itself lives in the dedicated @almyty/auth package
+ * (`npx @almyty/auth login`). This module just READS the shared
+ * credentials store and surfaces them to the rest of the skills CLI.
  *
- * Supports:
- * 1. Environment variable (APIFAI_TOKEN) — for CI/scripts
- * 2. Stored credentials (~/.almyty/credentials.json) — for interactive use
- * 3. Interactive login (npx @almyty/skills login) — stores credentials
+ * Lookup order:
+ *   1. ALMYTY_TOKEN environment variable      (CI / scripts)
+ *   2. ~/.almyty/credentials.json              (interactive use, written
+ *                                               by `npx @almyty/auth login`)
  */
-import { readFileSync, writeFileSync, mkdirSync, unlinkSync, existsSync } from 'fs';
+import { readFileSync, existsSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
-import { createInterface } from 'readline';
-const CREDENTIALS_DIR = join(homedir(), '.almyty');
-const CREDENTIALS_FILE = join(CREDENTIALS_DIR, 'credentials.json');
-/**
- * Load stored credentials from ~/.almyty/credentials.json
- */
-export function loadCredentials() {
+const CREDENTIALS_FILE = join(homedir(), '.almyty', 'credentials.json');
+function loadCredentials() {
     try {
         if (!existsSync(CREDENTIALS_FILE))
             return null;
-        const data = readFileSync(CREDENTIALS_FILE, 'utf-8');
-        return JSON.parse(data);
+        return JSON.parse(readFileSync(CREDENTIALS_FILE, 'utf-8'));
     }
     catch {
         return null;
     }
 }
 /**
- * Save credentials to ~/.almyty/credentials.json
- */
-export function saveCredentials(creds) {
-    mkdirSync(CREDENTIALS_DIR, { recursive: true });
-    writeFileSync(CREDENTIALS_FILE, JSON.stringify(creds, null, 2), { mode: 0o600 });
-}
-/**
- * Remove stored credentials
- */
-export function logout() {
-    try {
-        if (existsSync(CREDENTIALS_FILE)) {
-            unlinkSync(CREDENTIALS_FILE);
-            console.log('Logged out. Credentials removed.');
-        }
-        else {
-            console.log('No stored credentials found.');
-        }
-    }
-    catch {
-        console.error('Failed to remove credentials.');
-    }
-}
-/**
- * Resolve token: env var > stored credentials
+ * Resolve token: env var > stored credentials. Exits with a clear hint
+ * if no credentials are available.
  */
 export function resolveAuth() {
-    const envToken = process.env.APIFAI_TOKEN;
-    const envUrl = process.env.APIFAI_URL || 'https://api.almyty.com';
+    const envToken = process.env.ALMYTY_TOKEN;
+    const envUrl = process.env.ALMYTY_URL || 'https://api.almyty.com';
     if (envToken) {
         return { url: envUrl, token: envToken };
     }
@@ -66,52 +39,7 @@ export function resolveAuth() {
         return { url: creds.url, token: creds.token };
     }
     console.error('Not authenticated. Run one of:');
-    console.error('  npx @almyty/skills login');
-    console.error('  export APIFAI_TOKEN=<your-token>');
+    console.error('  npx @almyty/auth login        # browser-based login');
+    console.error('  export ALMYTY_TOKEN=<token>   # for CI');
     process.exit(1);
 }
-/**
- * Interactive login: prompts for email/password, authenticates against
- * the almyty backend, and stores the JWT token.
- */
-export async function login(baseUrl) {
-    const rl = createInterface({
-        input: process.stdin,
-        output: process.stderr,
-    });
-    const ask = (question) => new Promise((resolve) => rl.question(question, resolve));
-    try {
-        console.error(`Logging in to ${baseUrl}...\n`);
-        const email = await ask('Email: ');
-        const password = await ask('Password: ');
-        console.error('\nAuthenticating...');
-        const response = await fetch(`${baseUrl}/api/auth/login`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ email, password }),
-        });
-        if (!response.ok) {
-            const errBody = await response.json().catch(() => ({ message: 'Authentication failed' }));
-            console.error(`Error: ${errBody.message || 'Authentication failed'}`);
-            process.exit(1);
-        }
-        const data = await response.json();
-        const token = data.accessToken || data.token;
-        if (!token) {
-            console.error('Error: No token received from server');
-            process.exit(1);
-        }
-        saveCredentials({
-            url: baseUrl,
-            token,
-            email,
-        });
-        console.error(`\n✓ Logged in as ${email}`);
-        console.error(`  Credentials saved to ${CREDENTIALS_FILE}`);
-        console.error('\nYou can now install skills:');
-        console.error('  npx @almyty/skills install --gateway <id>');
-    }
-    finally {
-        rl.close();
-    }
-}

package/dist/client.js

@@ -23,7 +23,7 @@ export class AlmytyClient {
         this.token = token;
     }
     async request(path) {
-        const url = `${this.baseUrl}/api${path}`;
+        const url = `${this.baseUrl}${path}`;
         const response = await fetch(url, {
             headers: {
                 'Authorization': `Bearer ${this.token}`,
@@ -32,7 +32,7 @@ export class AlmytyClient {
         });
         if (!response.ok) {
             if (response.status === 401) {
-                throw new Error('Authentication failed. Run: npx @almyty/skills login');
+                throw new Error('Authentication failed. Run: npx @almyty/auth login');
             }
             const text = await response.text();
             throw new Error(`API error (${response.status}): ${text}`);
@@ -40,7 +40,7 @@ export class AlmytyClient {
         return response.json();
     }
     async post(path, body) {
-        const url = `${this.baseUrl}/api${path}`;
+        const url = `${this.baseUrl}${path}`;
         const resp = await fetch(url, {
             method: 'POST',
             headers: {
@@ -86,8 +86,8 @@ export class AlmytyClient {
     }
     async listGateways() {
         const data = await this.request('/gateways');
-        const gateways = data?.data?.data?.gateways || data?.data?.data || data?.data || [];
-        return gateways.map((gw) => ({
+        const gateways = data?.data?.gateways || data?.data?.data || data?.data || [];
+        return (Array.isArray(gateways) ? gateways : []).map((gw) => ({
             id: gw.id,
             name: gw.name,
             type: gw.type,
@@ -113,7 +113,24 @@ export class AlmytyClient {
         return skills;
     }
     async executeSkill(gatewayId, toolId, parameters) {
-        return this.post(`/gateways/${gatewayId}/skills/${toolId}/execute`, { parameters });
+        // The execute endpoint expects a UUID. If toolId is a name slug,
+        // resolve it by listing the gateway's tools and matching.
+        const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+        let resolvedId = toolId;
+        if (!uuidRegex.test(toolId)) {
+            const tools = await this.request(`/gateways/${gatewayId}/tools`);
+            const list = tools?.data?.gatewayTools || tools?.data?.data || tools?.data || [];
+            const match = (Array.isArray(list) ? list : []).find((gt) => {
+                const t = gt.tool || gt;
+                const slug = t.name?.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+                return slug === toolId || t.name === toolId;
+            });
+            if (!match) {
+                throw new Error(`Tool "${toolId}" not found in gateway ${gatewayId}`);
+            }
+            resolvedId = (match.tool || match).id;
+        }
+        return this.post(`/gateways/${gatewayId}/skills/${resolvedId}/execute`, { parameters });
     }
     async resolveRef(ref) {
         if (ref.startsWith('@')) {

package/dist/config.js

@@ -3,7 +3,7 @@ import { homedir } from 'os';
 import { join, resolve } from 'path';
 import { detectAgents, getDefaultTargets, filterAgents } from './agents.js';
 export function loadConfig(projectDir) {
-    const envDir = process.env.APIFAI_SKILLS_DIR;
+    const envDir = process.env.ALMYTY_SKILLS_DIR;
     if (envDir) {
         return { skillsDir: envDir };
     }

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { login, logout, resolveAuth } from './auth.js';
+import { resolveAuth } from './auth.js';
 import { AlmytyClient, parseRef } from './client.js';
 import { getAllTargets } from './agents.js';
 import { installSkills, removeSkills, listInstalledSkills } from './installer.js';
@@ -14,8 +14,6 @@ Usage:
   npx @almyty/skills <command> [options]
 
 Commands:
-  login                          Authenticate with almyty
-  logout                         Remove stored credentials
   daemon                         Start skill daemon (syncs all skills)
   install <ref>                  Install skills
   list [ref]                     List available skills
@@ -25,6 +23,10 @@ Commands:
   remove                         Remove all installed skills
   gateways                       List your gateways
 
+Authentication:
+  Run \`npx @almyty/auth login\` once. Credentials at ~/.almyty/credentials.json
+  are shared across every almyty CLI.
+
 References:
   @org/gateway                   All skills from a gateway
   @org/gateway/skill             A specific skill
@@ -33,9 +35,9 @@ References:
 
 Config:
   .almytyrc                      JSON config file (project or home dir)
-  APIFAI_SKILLS_DIR              Override skill installation directory
-  APIFAI_URL                     Override API URL
-  APIFAI_TOKEN                   Override auth token
+  ALMYTY_SKILLS_DIR              Override skill installation directory
+  ALMYTY_URL                     Override API URL
+  ALMYTY_TOKEN                   Override auth token
 
 Options:
   --interval, -i <seconds>       Daemon poll interval in seconds (default: 60)
@@ -142,14 +144,15 @@ async function main() {
     const config = loadConfig(projectDir);
     const urlOverride = args.flags.url || config.url;
     switch (command) {
-        case 'login': {
-            const url = urlOverride || process.env.APIFAI_URL || 'https://api.almyty.com';
-            await login(url);
-            break;
-        }
-        case 'logout': {
-            logout();
-            break;
+        case 'login':
+        case 'logout':
+        case 'whoami': {
+            // Auth has moved to its own dedicated package. Redirect rather
+            // than silently doing nothing — users typing the old commands
+            // should see the new entry point.
+            console.error(`Authentication moved to @almyty/auth.`);
+            console.error(`  npx @almyty/auth ${command}`);
+            process.exit(1);
         }
         case 'gateways': {
             const { url, token } = resolveAuth();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almyty/skills",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Install API skills into AI coding agents — Claude Code, Cursor, Windsurf, Copilot, Codex",
   "type": "module",
   "main": "dist/index.js",