@kb-labs/agent-entry 2.119.0-canary.e120bc0ee → 2.119.0

package/dist/manifest.json

@@ -1,685 +0,0 @@
-{
-  "schema": "kb.plugin/3",
-  "id": "@kb-labs/agent",
-  "version": "0.1.0",
-  "display": {
-    "name": "Agent System",
-    "description": "Autonomous agents, tool calling, and task orchestration",
-    "tags": [
-      "agent",
-      "autonomous",
-      "llm",
-      "orchestration"
-    ]
-  },
-  "configSection": "agents",
-  "platform": {
-    "requires": [
-      "llm"
-    ],
-    "optional": [
-      "cache",
-      "analytics",
-      "logger"
-    ]
-  },
-  "cli": {
-    "groupMeta": [
-      {
-        "path": "agent",
-        "describe": "Autonomous agent commands"
-      },
-      {
-        "path": "agent trace",
-        "describe": "Agent trace debugging commands"
-      },
-      {
-        "path": "agent quality",
-        "describe": "Agent quality control commands"
-      }
-    ],
-    "commands": [
-      {
-        "path": "agent run",
-        "category": "Run",
-        "describe": "Run agent task (execute, plan, edit, or debug)",
-        "operationType": "execute",
-        "longDescription": "Unified agent command with multiple modes: execute (default) - run task immediately, plan - generate execution plan without running, edit - modify existing files, debug - analyze errors with trace context. Supports filesystem, search, shell, memory, and user interaction tools.",
-        "handler": "./cli/commands/run.js#default",
-        "flags": [
-          {
-            "name": "task",
-            "type": "string",
-            "description": "Task description"
-          },
-          {
-            "name": "mode",
-            "type": "string",
-            "default": "execute",
-            "description": "Agent mode: execute (default), plan, edit, debug"
-          },
-          {
-            "name": "session-id",
-            "type": "string",
-            "description": "Session ID (auto-generated if not provided)"
-          },
-          {
-            "name": "complexity",
-            "type": "string",
-            "description": "Task complexity (for plan mode): simple, medium, complex"
-          },
-          {
-            "name": "approve",
-            "type": "boolean",
-            "default": false,
-            "description": "Auto-approve generated plan (supported with --mode=plan)"
-          },
-          {
-            "name": "execute",
-            "type": "boolean",
-            "default": false,
-            "description": "After plan is approved, immediately execute it (use with --mode=plan --approve)"
-          },
-          {
-            "name": "files",
-            "type": "array",
-            "description": "Target files (for edit mode)"
-          },
-          {
-            "name": "trace",
-            "type": "string",
-            "description": "Trace file path (for debug mode)"
-          },
-          {
-            "name": "dry-run",
-            "type": "boolean",
-            "default": false,
-            "description": "Preview changes without applying (for edit mode)"
-          },
-          {
-            "name": "verbose",
-            "type": "boolean",
-            "default": false,
-            "description": "Verbose output"
-          },
-          {
-            "name": "debug",
-            "type": "boolean",
-            "default": false,
-            "description": "Enable debug mode: emit full prompts and responses as llm:debug events"
-          },
-          {
-            "name": "timeout",
-            "type": "number",
-            "description": "Abort agent execution after this many seconds (exit code 124). No timeout by default."
-          },
-          {
-            "name": "budget",
-            "type": "number",
-            "description": "Override token budget (e.g. 300000 for heavy tasks). Overrides config value."
-          },
-          {
-            "name": "json",
-            "type": "boolean",
-            "description": "Output structured JSON result instead of human-readable output."
-          }
-        ],
-        "examples": [
-          "kb agent run --task=\"Create analytics system\"",
-          "kb agent run --mode=plan --task=\"Add auth\" --complexity=complex",
-          "kb agent run --mode=plan --task=\"Add auth\" --approve",
-          "kb agent run --mode=plan --task=\"Add auth\" --approve --execute",
-          "kb agent run --mode=edit --task=\"Fix bug\" --files src/auth.ts",
-          "kb agent run --mode=debug --task=\"Why crash?\" --trace .kb/traces/trace-123.json",
-          "kb agent run --task=\"Refactor auth module\" --timeout=120"
-        ]
-      },
-      {
-        "path": "agent trace stats",
-        "category": "Trace",
-        "describe": "Show trace statistics: tokens, cost, timing",
-        "operationType": "read",
-        "longDescription": "Analyze trace file to show comprehensive statistics: iterations, LLM calls, token usage, tool usage, timing, and cost. Supports --json flag for AI agent consumption.",
-        "handler": "./cli/commands/trace-stats.js#default",
-        "flags": [
-          {
-            "name": "task-id",
-            "type": "string",
-            "description": "Task ID or trace filename"
-          },
-          {
-            "name": "json",
-            "type": "boolean",
-            "default": false,
-            "description": "Output JSON for AI agents"
-          }
-        ],
-        "examples": [
-          "kb agent trace stats --task-id=task-2026-01-29",
-          "kb agent trace stats --task-id=task-123 --json"
-        ]
-      },
-      {
-        "path": "agent trace filter",
-        "category": "Trace",
-        "describe": "Filter trace events by type for debugging",
-        "operationType": "read",
-        "longDescription": "Filter trace events by type (llm:call, tool:execution, error:captured, etc.). Use this to debug specific aspects of agent execution. Supports --json flag for programmatic access.",
-        "handler": "./cli/commands/trace-filter.js#default",
-        "flags": [
-          {
-            "name": "task-id",
-            "type": "string",
-            "description": "Task ID or trace filename"
-          },
-          {
-            "name": "type",
-            "type": "string",
-            "description": "Event type to filter (llm:call, tool:execution, etc.)"
-          },
-          {
-            "name": "json",
-            "type": "boolean",
-            "default": false,
-            "description": "Output JSON for AI agents"
-          }
-        ],
-        "examples": [
-          "kb agent trace filter --task-id=task-123 --type=llm:call",
-          "kb agent trace filter --task-id=task-123 --type=error:captured --json"
-        ]
-      },
-      {
-        "path": "agent trace iteration",
-        "category": "Trace",
-        "describe": "View all events for a specific iteration",
-        "operationType": "read",
-        "longDescription": "Show all trace events for a specific iteration number. Useful for debugging what happened in a particular loop iteration. Includes summary statistics and event timeline.",
-        "handler": "./cli/commands/trace-iteration.js#default",
-        "flags": [
-          {
-            "name": "task-id",
-            "type": "string",
-            "description": "Task ID or trace filename"
-          },
-          {
-            "name": "iteration",
-            "type": "number",
-            "description": "Iteration number (1-based)"
-          },
-          {
-            "name": "json",
-            "type": "boolean",
-            "default": false,
-            "description": "Output JSON for AI agents"
-          }
-        ],
-        "examples": [
-          "kb agent trace iteration --task-id=task-123 --iteration=3",
-          "kb agent trace iteration --task-id=task-123 --iteration=5 --json"
-        ]
-      },
-      {
-        "path": "agent trace context",
-        "category": "Trace",
-        "describe": "Inspect context window and truncations per iteration",
-        "operationType": "read",
-        "longDescription": "Shows the full context timeline for debugging agent behavior. For each LLM call: what messages are in the sliding window, what was truncated/dropped, and what the LLM responded with.",
-        "handler": "./cli/commands/trace-context.js#default",
-        "flags": [
-          {
-            "name": "task-id",
-            "type": "string",
-            "description": "Task ID or trace filename"
-          },
-          {
-            "name": "iteration",
-            "type": "number",
-            "description": "Filter to specific iteration"
-          },
-          {
-            "name": "json",
-            "type": "boolean",
-            "default": false,
-            "description": "Output JSON for AI agents"
-          }
-        ],
-        "examples": [
-          "kb agent trace context --task-id=task-123",
-          "kb agent trace context --task-id=task-123 --iteration=3",
-          "kb agent trace context --task-id=task-123 --json"
-        ]
-      },
-      {
-        "path": "agent trace diagnose",
-        "category": "Trace",
-        "describe": "Diagnose what went wrong in an agent run",
-        "operationType": "analyze",
-        "longDescription": "Comprehensive diagnostic report for agent execution. Analyzes errors, context window health (drops, truncations), tool failures, LLM reasoning text, loop detection, and quality indicators. One command to understand any agent issue.",
-        "handler": "./cli/commands/trace-diagnose.js#default",
-        "flags": [
-          {
-            "name": "task-id",
-            "type": "string",
-            "description": "Task ID or trace filename"
-          },
-          {
-            "name": "json",
-            "type": "boolean",
-            "default": false,
-            "description": "Output JSON for AI agents"
-          }
-        ],
-        "examples": [
-          "kb agent trace diagnose --task-id=task-123",
-          "kb agent trace diagnose --task-id=task-123 --json"
-        ]
-      },
-      {
-        "path": "agent quality report",
-        "category": "Quality",
-        "describe": "Show quality control report for recent agent runs",
-        "operationType": "analyze",
-        "longDescription": "Aggregates agent KPI telemetry from analytics buffer and shows quality, token usage, tool efficiency, drift, and regression alerts. Useful for continuous quality control and cost/performance monitoring.",
-        "handler": "./cli/commands/quality-report.js#default",
-        "flags": [
-          {
-            "name": "days",
-            "type": "number",
-            "default": 1,
-            "description": "Lookback period in days"
-          },
-          {
-            "name": "limit",
-            "type": "number",
-            "default": 200,
-            "description": "Max KPI runs to analyze"
-          },
-          {
-            "name": "session-id",
-            "type": "string",
-            "description": "Filter by session ID"
-          },
-          {
-            "name": "json",
-            "type": "boolean",
-            "default": false,
-            "description": "Output JSON for automation"
-          }
-        ],
-        "examples": [
-          "kb agent quality report",
-          "kb agent quality report --days=7",
-          "kb agent quality report --session-id=session-123",
-          "kb agent quality report --days=3 --json"
-        ]
-      },
-      {
-        "path": "agent history",
-        "category": "History",
-        "describe": "Show file change history for agent sessions",
-        "operationType": "read",
-        "longDescription": "View file changes made by agents during execution. Filter by session, file, or agent. Shows timestamps, operations, and change metadata.",
-        "handler": "./cli/commands/history.js#default",
-        "flags": [
-          {
-            "name": "session-id",
-            "type": "string",
-            "description": "Session ID to filter by"
-          },
-          {
-            "name": "file",
-            "type": "string",
-            "description": "File path to filter by"
-          },
-          {
-            "name": "agent-id",
-            "type": "string",
-            "description": "Agent ID to filter by"
-          },
-          {
-            "name": "json",
-            "type": "boolean",
-            "default": false,
-            "description": "Output JSON for AI agents"
-          }
-        ],
-        "examples": [
-          "kb agent history",
-          "kb agent history --session-id=session-123",
-          "kb agent history --file=src/index.ts",
-          "kb agent history --agent-id=agent-abc --json"
-        ]
-      },
-      {
-        "path": "agent diff",
-        "category": "History",
-        "describe": "Show diff for specific file change",
-        "operationType": "read",
-        "longDescription": "Display line-by-line diff for a specific file change. Shows additions, deletions, and modifications with context.",
-        "handler": "./cli/commands/diff.js#default",
-        "flags": [
-          {
-            "name": "change-id",
-            "type": "string",
-            "description": "Change ID to show diff for"
-          },
-          {
-            "name": "json",
-            "type": "boolean",
-            "default": false,
-            "description": "Output JSON for AI agents"
-          }
-        ],
-        "examples": [
-          "kb agent diff --change-id=change-abc123",
-          "kb agent diff --change-id=change-abc123 --json"
-        ]
-      },
-      {
-        "path": "agent rollback",
-        "category": "History",
-        "describe": "Rollback file changes made by agents",
-        "operationType": "mutate",
-        "longDescription": "Rollback file changes made by agents. Supports rollback by change ID, file path, agent ID, session, or timestamp. Use --dry-run to preview changes before applying.",
-        "handler": "./cli/commands/rollback.js#default",
-        "flags": [
-          {
-            "name": "change-id",
-            "type": "string",
-            "description": "Change ID to rollback"
-          },
-          {
-            "name": "file",
-            "type": "string",
-            "description": "File path to rollback all changes for"
-          },
-          {
-            "name": "agent-id",
-            "type": "string",
-            "description": "Agent ID to rollback all changes by"
-          },
-          {
-            "name": "session-id",
-            "type": "string",
-            "description": "Session ID to rollback all changes in"
-          },
-          {
-            "name": "after",
-            "type": "string",
-            "description": "Rollback all changes after timestamp (ISO 8601)"
-          },
-          {
-            "name": "force",
-            "type": "boolean",
-            "default": false,
-            "description": "Force rollback even with conflicts"
-          },
-          {
-            "name": "dry-run",
-            "type": "boolean",
-            "default": false,
-            "description": "Preview rollback without applying"
-          },
-          {
-            "name": "json",
-            "type": "boolean",
-            "default": false,
-            "description": "Output JSON for AI agents"
-          }
-        ],
-        "examples": [
-          "kb agent rollback --change-id=change-abc123",
-          "kb agent rollback --file=src/index.ts --dry-run",
-          "kb agent rollback --agent-id=agent-abc",
-          "kb agent rollback --session-id=session-123",
-          "kb agent rollback --after=\"2026-02-16T10:00:00Z\" --json"
-        ]
-      }
-    ]
-  },
-  "capabilities": [],
-  "permissions": {
-    "fs": {
-      "read": [
-        ".kb/**",
-        ".agent-memory/**",
-        "**/*"
-      ],
-      "write": [
-        ".kb/**",
-        ".agent-memory/**",
-        "**/*"
-      ]
-    },
-    "env": {
-      "read": [
-        "HOME",
-        "USER",
-        "PATH",
-        "TMPDIR",
-        "NODE_ENV",
-        "KB_*"
-      ]
-    },
-    "platform": {
-      "llm": true,
-      "analytics": true,
-      "cache": {
-        "namespaces": [
-          "agent:"
-        ]
-      }
-    },
-    "quotas": {
-      "timeoutMs": 1800000,
-      "memoryMb": 1024
-    }
-  },
-  "rest": {
-    "basePath": "/v1/plugins/agents",
-    "defaults": {
-      "timeoutMs": 1800000
-    },
-    "routes": [
-      {
-        "method": "POST",
-        "path": "/run",
-        "description": "Start a new agent run",
-        "handler": "./rest/handlers/run-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "GET",
-        "path": "/run/:runId",
-        "description": "Get status of a run",
-        "handler": "./rest/handlers/status-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "POST",
-        "path": "/run/:runId/correct",
-        "description": "Send correction to running agent(s)",
-        "handler": "./rest/handlers/correct-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "POST",
-        "path": "/run/:runId/stop",
-        "description": "Stop a running agent",
-        "handler": "./rest/handlers/stop-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "GET",
-        "path": "/sessions",
-        "description": "List all sessions",
-        "handler": "./rest/handlers/list-sessions-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "GET",
-        "path": "/sessions/:sessionId",
-        "description": "Get session details",
-        "handler": "./rest/handlers/get-session-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "POST",
-        "path": "/sessions",
-        "description": "Create a new session",
-        "handler": "./rest/handlers/create-session-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "GET",
-        "path": "/sessions/:sessionId/turns",
-        "description": "Get session turns (turn-based UI)",
-        "handler": "./rest/handlers/get-session-turns-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "GET",
-        "path": "/sessions/:sessionId/plan",
-        "description": "Get current session plan",
-        "handler": "./rest/handlers/get-session-plan-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "POST",
-        "path": "/sessions/:sessionId/plan/approve",
-        "description": "Approve current session plan",
-        "handler": "./rest/handlers/approve-session-plan-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "POST",
-        "path": "/sessions/:sessionId/plan/execute",
-        "description": "Execute approved session plan",
-        "handler": "./rest/handlers/execute-session-plan-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "POST",
-        "path": "/sessions/:sessionId/plan/spec",
-        "description": "Generate detailed spec from approved plan",
-        "handler": "./rest/handlers/generate-spec-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "GET",
-        "path": "/sessions/:sessionId/spec",
-        "description": "Get current session spec",
-        "handler": "./rest/handlers/get-spec-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "GET",
-        "path": "/sessions/:sessionId/changes",
-        "description": "List file changes for session (optionally filtered by runId)",
-        "handler": "./rest/handlers/list-file-changes-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "GET",
-        "path": "/sessions/:sessionId/changes/:changeId/diff",
-        "description": "Get unified diff for a specific file change",
-        "handler": "./rest/handlers/get-file-diff-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "POST",
-        "path": "/sessions/:sessionId/rollback",
-        "description": "Rollback file changes for a session/run",
-        "handler": "./rest/handlers/rollback-handler.js",
-        "security": [
-          "none"
-        ]
-      },
-      {
-        "method": "POST",
-        "path": "/sessions/:sessionId/approve",
-        "description": "Approve file changes for a session/run",
-        "handler": "./rest/handlers/approve-handler.js",
-        "security": [
-          "none"
-        ]
-      }
-    ]
-  },
-  "ws": {
-    "basePath": "/v1/ws/plugins/agents",
-    "defaults": {
-      "auth": "none",
-      "idleTimeoutMs": 3600000
-    },
-    "channels": [
-      {
-        "path": "/session/:sessionId",
-        "description": "Persistent session stream (all runs in session)",
-        "handler": "./ws/session-stream-handler.js",
-        "auth": "none"
-      }
-    ]
-  },
-  "artifacts": [
-    {
-      "id": "agent.memory.json",
-      "pathTemplate": ".agent-memory/memory.json",
-      "description": "Persistent agent memory (facts, sessions, project context)."
-    }
-  ],
-  "studio": {
-    "version": 2,
-    "remoteName": "agentPlugin",
-    "pages": [
-      {
-        "id": "agent.overview",
-        "title": "Agent",
-        "icon": "RobotOutlined",
-        "route": "/p/agent",
-        "entry": "./AgentsPage",
-        "order": 1
-      }
-    ],
-    "menus": [
-      {
-        "id": "agent",
-        "label": "Agent",
-        "icon": "RobotOutlined",
-        "target": "agent.overview",
-        "order": 30
-      }
-    ]
-  }
-}