@llmtune/cli 0.1.5 → 0.1.7

package/dist/marketplace/client.js

@@ -7,6 +7,10 @@ exports.publishSkill = publishSkill;
 function getApiBase(config) {
     return String(config.apiBase ?? "https://api.llmtune.io/api/agent/v1").replace(/\/$/, "");
 }
+/** Skills API lives at /api/agent/skills (not under /v1). */
+function getAgentRoot(config) {
+    return getApiBase(config).replace(/\/v1$/, "");
+}
 function getHeaders(config) {
     return {
         "Content-Type": "application/json",
@@ -17,7 +21,7 @@ function getHeaders(config) {
  * List all skills in the marketplace.
  */
 async function listSkills(config, options) {
-    const base = getApiBase(config);
+    const base = getAgentRoot(config);
     const params = new URLSearchParams();
     if (options?.search)
         params.set("search", options.search);
@@ -32,13 +36,21 @@ async function listSkills(config, options) {
     if (!response.ok) {
         throw new Error(`Failed to list skills: HTTP ${response.status}`);
     }
-    return (await response.json());
+    const json = (await response.json());
+    if (Array.isArray(json.data)) {
+        return {
+            skills: json.data,
+            total: json.total ?? json.data.length,
+            page: options?.page ?? 1,
+        };
+    }
+    return json;
 }
 /**
  * Get details for a specific skill.
  */
 async function getSkillDetails(config, name) {
-    const base = getApiBase(config);
+    const base = getAgentRoot(config);
     const url = `${base}/skills/${encodeURIComponent(name)}`;
     const response = await fetch(url, { headers: getHeaders(config) });
     if (!response.ok) {
@@ -52,12 +64,12 @@ async function getSkillDetails(config, name) {
  * Install a skill from the marketplace to the local skills directory.
  */
 async function installSkill(config, name) {
-    const base = getApiBase(config);
+    const base = getAgentRoot(config);
     const url = `${base}/skills/install`;
     const response = await fetch(url, {
         method: "POST",
         headers: getHeaders(config),
-        body: JSON.stringify({ skillName: name }),
+        body: JSON.stringify({ name, content: "" }),
     });
     if (!response.ok) {
         const body = await response.text();
@@ -70,7 +82,7 @@ async function installSkill(config, name) {
  * Publish a local skill to the marketplace.
  */
 async function publishSkill(config, skill) {
-    const base = getApiBase(config);
+    const base = getAgentRoot(config);
     const url = `${base}/skills`;
     const response = await fetch(url, {
         method: "POST",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmtune/cli",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "LLMTune CLI -AI CLI Agent powered by llmtune.io",
   "main": "dist/index.js",
   "bin": {

package/docs/SKILL_AUTHORING.md

@@ -1,175 +0,0 @@
-# Skill Authoring Guide
-
-Skills are reusable AI workflows that extend the LLMTune CLI. Each skill is defined by a `SKILL.md` file inside a named directory.
-
-## Quick Start
-
-Create a skill in `~/.llmtune/skills/` or `.llmtune/skills/` in your project:
-
-```
-~/.llmtune/skills/
-  my-skill/
-    SKILL.md
-```
-
-## SKILL.md Format
-
-A skill file has two parts: **YAML frontmatter** (optional) and **Markdown body** (the prompt template).
-
-```markdown
----
-description: "Fix ESLint errors in a file"
-user-invocable: true
-allowed-tools: [read, edit, glob, grep]
-arguments: file_path
-trust: local
----
-
-You are a linting expert. Fix all ESLint errors in the file at `{{file_path}}`.
-
-1. Read the file
-2. Identify lint errors
-3. Fix each error while preserving the original intent
-4. Report what you changed
-```
-
-## Frontmatter Fields
-
-| Field | Type | Default | Description |
-|-------|------|---------|-------------|
-| `description` | string | (required) | Short description shown in `/skills` list |
-| `user-invocable` | boolean | `true` | Whether users can invoke with `/<skill-name>` |
-| `allowed-tools` | string[] | all tools | Restrict which tools the skill can use |
-| `arguments` | string or string[] | none | Argument names for substitution |
-| `trust` | string | `local` | Trust level: `local`, `community`, `verified`, `signed` |
-| `when-to-use` | string | none | Hint for when the agent should auto-invoke this skill |
-
-## Argument Substitution
-
-Arguments are referenced in the body using `{{arg_name}}` syntax:
-
-```markdown
----
-arguments: file_path, style
----
-
-Refactor the file at `{{file_path}}` to use `{{style}}` coding style.
-```
-
-When invoked: `/my-skill src/auth.ts functional`
-
-- `{{file_path}}` becomes `src/auth.ts`
-- `{{style}}` becomes `functional`
-
-## Trust Levels
-
-Skills have four trust levels that determine what tools they can access:
-
-| Level | Tools Allowed | Use Case |
-|-------|--------------|----------|
-| **local** | All | Skills you create yourself in `~/.llmtune/skills/` |
-| **community** | read, glob, grep only | Skills installed from marketplace |
-| **verified** | All | Skills reviewed by the LLMTune team |
-| **signed** | All | Cryptographically signed skills with verified authors |
-
-## Invoking Skills
-
-### From the CLI REPL
-
-```
-> /explain-code src/auth.ts
-> /fix-lint src/utils/helpers.ts
-> /generate-test src/services/user.ts
-```
-
-### From Commander (non-interactive)
-
-```bash
-llmtune skills run explain-code --args "src/auth.ts"
-```
-
-## Built-in Skills
-
-The LLMTune CLI includes these built-in skills:
-
-| Skill | Description | Arguments |
-|-------|-------------|-----------|
-| `explain-code` | Explain code with a clear breakdown | `file_path` |
-| `fix-lint` | Auto-fix linting errors | `file_path` |
-| `generate-test` | Generate unit tests for a file | `file_path` |
-| `security-review` | Review code for security issues | `file_path` |
-
-## Publishing to the Marketplace
-
-```bash
-# Sign your skill
-llmtune skills sign my-skill
-
-# Publish to marketplace
-llmtune skills publish my-skill
-
-# Install from marketplace
-llmtune skills install security-review
-```
-
-## Examples
-
-### Code Review Skill
-
-```markdown
----
-description: "Review code for best practices and potential issues"
-allowed-tools: [read, glob, grep]
-arguments: file_path
----
-
-Review the code at `{{file_path}}` for:
-
-1. **Security vulnerabilities** - XSS, injection, auth issues
-2. **Performance problems** - N+1 queries, unnecessary re-renders, memory leaks
-3. **Code quality** - Naming, structure, DRY violations
-4. **Error handling** - Missing error cases, swallowed errors
-5. **Type safety** - Any `any` types, missing null checks
-
-Provide specific, actionable feedback with line numbers.
-```
-
-### Database Migration Skill
-
-```markdown
----
-description: "Generate a Prisma migration for schema changes"
-allowed-tools: [read, write, edit, bash]
-arguments: description
----
-
-The user wants to make this database change: {{description}}
-
-1. Read the current prisma/schema.prisma
-2. Make the necessary schema changes
-3. Generate the migration using `npx prisma migrate dev --name <descriptive-name>`
-4. Report what changed
-```
-
-### API Endpoint Skill
-
-```markdown
----
-description: "Scaffold a new REST API endpoint"
-allowed-tools: [read, write, edit, glob, grep]
-arguments: method, path
----
-
-Create a new API endpoint:
-
-- Method: `{{method}}`
-- Path: `{{path}}`
-
-1. Find existing route files to understand the pattern
-2. Create the route handler
-3. Add input validation
-4. Add error handling
-5. Register the route
-
-Follow the existing code patterns in the project.
-```

package/scripts/smoke-test.js

@@ -1,142 +0,0 @@
-#!/usr/bin/env node
-/**
- * CLI smoke tests — run: npm test
- * Set LLMTUNE_API_KEY or configure ~/.llmtune/config.json for live API tests.
- */
-const fs = require("fs")
-const path = require("path")
-const os = require("os")
-
-let passed = 0
-let failed = 0
-let skipped = 0
-
-function ok(name) {
-  passed++
-  console.log(`  ✓ ${name}`)
-}
-
-function fail(name, err) {
-  failed++
-  console.log(`  ✗ ${name}: ${err}`)
-}
-
-function skip(name, reason) {
-  skipped++
-  console.log(`  ⊘ ${name} (${reason})`)
-}
-
-function test(name, fn) {
-  try {
-    fn()
-    ok(name)
-  } catch (e) {
-    fail(name, e.message)
-  }
-}
-
-async function testAsync(name, fn) {
-  try {
-    await fn()
-    ok(name)
-  } catch (e) {
-    fail(name, e.message)
-  }
-}
-
-async function main() {
-  console.log("=== LLMTune CLI Smoke Tests ===\n")
-
-  test("dist/index.js exists", () => {
-    const p = path.join(__dirname, "..", "dist", "index.js")
-    if (!fs.existsSync(p)) throw new Error("run npm run build first")
-  })
-
-  test("agent identity module", () => {
-    const { buildAgentIdentitySection } = require("../dist/context/agent-identity")
-    const text = buildAgentIdentitySection("z-ai/GLM-5.1")
-    if (!text.includes("LLMTune Agent")) throw new Error("missing identity")
-    if (text.toLowerCase().includes("you are claude")) throw new Error("should not identify as Claude")
-  })
-
-  test("git context (Windows-safe)", () => {
-    const { collectGitContext } = require("../dist/context/git-context")
-    collectGitContext(process.cwd())
-  })
-
-  test("microcompact", () => {
-    const { microcompactMessages } = require("../dist/compact/microcompact")
-    const { compacted } = microcompactMessages([
-      { role: "tool", content: "x".repeat(5000) },
-    ])
-    if (compacted[0].content.length >= 5000) throw new Error("not compressed")
-  })
-
-  test("context analyzer", () => {
-    const { analyzeContextUsage } = require("../dist/context/analyzer")
-    const a = analyzeContextUsage({
-      systemPrompt: "test",
-      toolSpecs: [],
-      messages: [{ role: "user", content: "hi" }],
-      model: "z-ai/GLM-5.1",
-    })
-    if (a.totalTokens <= 0) throw new Error("expected tokens > 0")
-  })
-
-  test("permission manager trust", () => {
-    const { PermissionManager } = require("../dist/tools/permissions")
-    const pm = new PermissionManager()
-    pm.trustTool("bash")
-    if (!pm.isTrusted("bash")) throw new Error("trust failed")
-  })
-
-  await testAsync("registry dispatchAsync", async () => {
-    const { ToolRegistry } = require("../dist/tools/registry")
-    const { bashTool } = require("../dist/tools/tools/bash")
-    const reg = new ToolRegistry()
-    reg.register(bashTool)
-    await reg.dispatchAsync("bash", { command: "echo SMOKE_OK" }, {
-      workspaceRoot: process.cwd(),
-      cwd: process.cwd(),
-    })
-  })
-
-  const configPath = path.join(os.homedir(), ".llmtune", "config.json")
-  const hasApi = Boolean(process.env.LLMTUNE_API_KEY) || fs.existsSync(configPath)
-
-  if (hasApi) {
-    await testAsync("API agent loop + bash tool", async () => {
-      const { createClient } = require("../dist/auth/client")
-      const { Conversation } = require("../dist/agent/conversation")
-      const { ToolRegistry } = require("../dist/tools/registry")
-      const { bashTool } = require("../dist/tools/tools/bash")
-      const { runAgentLoop } = require("../dist/agent/loop")
-
-      const client = createClient()
-      const registry = new ToolRegistry()
-      registry.register(bashTool)
-      const conversation = new Conversation("z-ai/GLM-5.1")
-      const cwd = process.cwd()
-
-      const result = await runAgentLoop(
-        client,
-        conversation,
-        registry,
-        "Run bash command: echo AGENT_SMOKE_OK. Use bash tool only.",
-        { model: "z-ai/GLM-5.1", maxTurns: 3, stream: false, cwd, workspaceRoot: cwd },
-      )
-
-      if (result.totalToolCalls === 0) throw new Error("expected at least one tool call")
-    })
-  } else {
-    skip("API agent loop + bash tool", "no API key")
-  }
-
-  console.log(`\n=== Results: ${passed} passed, ${failed} failed, ${skipped} skipped ===`)
-  process.exit(failed > 0 ? 1 : 0)
-}
-
-main().catch((err) => {
-  console.error(err)
-  process.exit(1)
-})