@pellux/goodvibes-agent 0.1.59 → 0.1.61

package/.goodvibes/skills/add-provider/SKILL.md

@@ -1,199 +0,0 @@
----
-name: add-provider
-description: Adds custom LLM providers and models to GoodVibes Agent. Use when the user wants to add a provider, add a model, configure Ollama, Together AI, OpenRouter, Groq, LM Studio, Fireworks, vLLM, or any OpenAI-compatible endpoint.
-version: 1.0.0
-triggers:
-  - /add-provider
-  - add provider
-  - add a provider
-  - new provider
-  - custom provider
-  - add model
-  - add a model
-author: goodvibes
----
-
-# Add Custom Provider
-
-Interactively collect provider and model details from the user, then write a JSON config to `~/.goodvibes/agent/providers/{name}.json`.
-
-## Workflow
-
-### Step 1: Check for Existing Provider
-
-Before collecting info, check if `~/.goodvibes/agent/providers/` already has JSON files. If the user names a provider that already exists, ask:
-- **Add models** to the existing provider, or
-- **Overwrite** it entirely
-
-If adding models, read the existing JSON, append new models, and write back.
-
-### Step 2: Collect Provider Details
-
-Ask the user for each field. Apply smart defaults when the provider name matches a known service.
-
-#### Required Fields
-
-| Field | Description | Validation |
-|-------|-------------|------------|
-| `name` | Internal ID | Lowercase alphanumeric + hyphens only, 1-64 chars |
-| `displayName` | Human-readable name | Non-empty string |
-| `type` | API compatibility | `openai-compat` (recommended) or `anthropic-compat` (not yet supported — use `openai-compat`) |
-| `baseURL` | API endpoint | Must start with `http://` or `https://` |
-
-> **Note:** `anthropic-compat` is accepted in the JSON schema for forward compatibility but is not yet functional at runtime. The loader will skip configs with this type and emit a warning. Use `openai-compat` for now — most Anthropic-compatible proxies (e.g., via LiteLLM) expose an OpenAI-compatible endpoint.
-
-#### Optional Fields
-
-| Field | Description | Default |
-|-------|-------------|---------|
-| `apiKeyEnv` | Environment variable for API key | None |
-| `apiKey` | Explicit API key (not recommended) | None |
-| `defaultHeaders` | Custom HTTP headers sent with every API request (e.g., for proxy authentication or routing) | None |
-
-### Smart Defaults
-
-When the user mentions a known provider, pre-fill these values and confirm:
-
-```yaml
-ollama:
-  displayName: Ollama
-  type: openai-compat
-  baseURL: http://localhost:11434/v1
-  apiKeyEnv: null
-
-together:
-  displayName: Together AI
-  type: openai-compat
-  baseURL: https://api.together.xyz/v1
-  apiKeyEnv: TOGETHER_API_KEY
-
-openrouter:
-  displayName: OpenRouter
-  type: openai-compat
-  baseURL: https://openrouter.ai/api/v1
-  apiKeyEnv: OPENROUTER_API_KEY
-
-groq:
-  displayName: Groq
-  type: openai-compat
-  baseURL: https://api.groq.com/openai/v1
-  apiKeyEnv: GROQ_API_KEY
-
-lm-studio:
-  displayName: LM Studio
-  type: openai-compat
-  baseURL: http://localhost:1234/v1
-  apiKeyEnv: null
-
-fireworks:
-  displayName: Fireworks AI
-  type: openai-compat
-  baseURL: https://api.fireworks.ai/inference/v1
-  apiKeyEnv: FIREWORKS_API_KEY
-
-vllm:
-  displayName: vLLM
-  type: openai-compat
-  baseURL: http://localhost:8000/v1
-  apiKeyEnv: null
-```
-
-If the name does not match a known provider, ask for all fields individually.
-
-### Step 3: Collect Model Details
-
-Collect at least one model. For each model:
-
-| Field | Description | Validation |
-|-------|-------------|------------|
-| `id` | Model identifier sent to the API | Non-empty string |
-| `displayName` | Human-readable name | Non-empty string |
-| `description` | Short description | Optional, auto-generate if blank |
-| `contextWindow` | Max tokens in context | Positive integer |
-| `capabilities.toolCalling` | Supports function/tool calling | Boolean, default `true` |
-| `capabilities.codeEditing` | Good at code editing tasks | Boolean, default `true` |
-| `capabilities.reasoning` | Extended reasoning/chain-of-thought | Boolean, default `false` |
-| `capabilities.multimodal` | Supports image input | Boolean, default `false` |
-| `reasoningEffort` | Supported reasoning effort levels | Optional, e.g., `["low", "medium", "high"]` |
-
-After each model, ask: "Add another model?" Loop until done.
-
-### Step 4: Preview and Confirm
-
-Show the complete JSON to the user and ask for confirmation before writing.
-
-Example output:
-
-```json
-{
-  "name": "ollama",
-  "displayName": "Ollama",
-  "type": "openai-compat",
-  "baseURL": "http://localhost:11434/v1",
-  "models": [
-    {
-      "id": "llama3.3-70b",
-      "displayName": "Llama 3.3 70B",
-      "description": "Meta's Llama 3.3 70B parameter model",
-      "contextWindow": 131072,
-      "capabilities": {
-        "toolCalling": true,
-        "codeEditing": true,
-        "reasoning": true,
-        "multimodal": false
-      },
-      "reasoningEffort": ["low", "medium", "high"]
-    }
-  ]
-}
-```
-
-### Step 5: Write the File
-
-Write to `~/.goodvibes/agent/providers/{name}.json`. Create the directory if it does not exist.
-
-Use `precision_write` with `mode: "fail_if_exists"` for new providers. Use `mode: "overwrite"` when the user chose to overwrite an existing provider or when merging models into an existing file.
-
-If the `apiKeyEnv` field is set, include it in the JSON. If the user provided an explicit `apiKey`, include it but warn that storing keys in plain text is not recommended -- suggest using an environment variable instead.
-
-If `defaultHeaders` were provided, include them.
-
-### Step 6: Confirm
-
-Tell the user:
-- The file was written to `~/.goodvibes/agent/providers/{name}.json`
-- The provider should be available to the Agent runtime after provider reload or next Agent startup
-- If an API key is needed, remind them to set the environment variable
-
-## Validation Rules
-
-Before writing, verify:
-1. `name` matches `/^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/` and is 1-64 characters (no trailing hyphens)
-2. `baseURL` starts with `http://` or `https://`
-3. `contextWindow` is a positive integer for every model
-4. At least one model is defined
-5. Every model has a non-empty `id` and `displayName`
-
-If validation fails, tell the user which field is invalid and ask for correction.
-
-## JSON Schema Reference
-
-The provider JSON maps to the codebase types:
-
-- Provider registration uses `OpenAICompatProvider` for `openai-compat` type. The `anthropic-compat` type is parsed and accepted in the JSON but is **not yet supported at runtime** — the loader skips it with a warning. Recommend `openai-compat` for all custom providers.
-- `OpenAICompatOptions`: `{ name, baseURL, apiKey, defaultModel, models }`
-- Model entries map to `ModelDefinition`: `{ id, provider, displayName, description, contextWindow, capabilities, reasoningEffort?, selectable }`
-  - `reasoningEffort?: string[]` — optional array of supported effort levels, e.g., `["low", "medium", "high"]`
-- The `selectable` field defaults to `true` for custom models
-- The `provider` field in `ModelDefinition` is auto-set to the provider `name`
-
-## Conversational Style
-
-Be natural and helpful. Guide users step-by-step but do not be overly verbose. If the user provides multiple details at once (e.g., "add ollama with llama3.3-70b"), extract what you can and only ask for missing fields.
-
-## Edge Cases
-
-- **Unknown context window**: Suggest 4096 as a safe default, note the user can update later
-- **No API key needed**: Omit `apiKeyEnv` and `apiKey` from the JSON entirely
-- **User provides a full JSON blob**: Validate it against the schema and write directly
-- **Multiple providers in one session**: After completing one, ask if they want to add another

package/src/input/commands/intelligence-runtime.ts

@@ -1,223 +0,0 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { resolve } from 'node:path';
-import type { CommandContext, CommandRegistry } from '../command-registry.ts';
-import { CodeIntelligence } from '@pellux/goodvibes-sdk/platform/intelligence';
-import type { DocumentSymbol } from '@pellux/goodvibes-sdk/platform/intelligence';
-import type { SymbolInfo } from '@pellux/goodvibes-sdk/platform/intelligence';
-import { openCommandPanel, requireReadModels, requireShellPaths } from './runtime-services.ts';
-
-function resolveTargetPath(pathArg: string, ctx: CommandContext): string {
-  return requireShellPaths(ctx).resolveWorkspacePath(pathArg);
-}
-
-function parsePosition(lineArg: string | undefined, columnArg: string | undefined): { line: number; column: number } | null {
-  const line = Number.parseInt(lineArg ?? '', 10);
-  const column = Number.parseInt(columnArg ?? '', 10);
-  if (!Number.isFinite(line) || line < 1 || !Number.isFinite(column) || column < 1) return null;
-  return { line: line - 1, column: column - 1 };
-}
-
-function formatSymbolKind(kind: number | string | undefined): string {
-  if (typeof kind === 'number') return `kind=${kind}`;
-  if (typeof kind === 'string' && kind.trim().length > 0) return kind;
-  return 'symbol';
-}
-
-function formatDocumentSymbol(symbol: DocumentSymbol): string {
-  const line = (symbol.selectionRange?.start.line ?? symbol.range.start.line) + 1;
-  const column = (symbol.selectionRange?.start.character ?? symbol.range.start.character) + 1;
-  return `  ${symbol.name}  ${formatSymbolKind(symbol.kind)}  ${line}:${column}`;
-}
-
-function formatTreeSitterSymbol(symbol: SymbolInfo): string {
-  return `  ${symbol.name}  ${formatSymbolKind(symbol.kind)}  ${symbol.line + 1}:${symbol.column + 1}`;
-}
-
-function ensureExistingFile(pathArg: string | undefined, ctx: CommandContext): string | null {
-  if (!pathArg) {
-    ctx.print('Intelligence Review\n  Missing file path.');
-    return null;
-  }
-  const targetPath = resolveTargetPath(pathArg, ctx);
-  if (!existsSync(targetPath)) {
-    ctx.print(`Intelligence Review\n  File not found: ${targetPath}`);
-    return null;
-  }
-  return targetPath;
-}
-
-export function registerIntelligenceRuntimeCommands(registry: CommandRegistry): void {
-  registry.register({
-    name: 'intelligence',
-    aliases: ['intel'],
-    description: 'Review workspace intelligence readiness, diagnostics posture, and symbol search availability',
-    usage: '[review|panel|diagnostics [file]|symbols <file>|outline <file>|definition <file> <line> <column>|references <file> <line> <column>|hover <file> <line> <column>|repair]',
-    async handler(args, ctx) {
-      const sub = (args[0] ?? 'review').toLowerCase();
-      if (sub === 'panel' || sub === 'open') {
-        openCommandPanel(ctx, 'intelligence');
-        return;
-      }
-
-      const intelligence = new CodeIntelligence();
-      const state = requireReadModels(ctx).intelligence.getSnapshot();
-
-      if (sub === 'symbols' || sub === 'outline') {
-        const targetPath = ensureExistingFile(args[1], ctx);
-        if (!targetPath) return;
-        const content = readFileSync(targetPath, 'utf-8');
-        if (sub === 'symbols') {
-          const symbols = await intelligence.getDocumentSymbols(targetPath, content);
-          const entries = symbols.slice(0, 12).map((symbol) => ('selectionRange' in symbol ? formatDocumentSymbol(symbol) : formatTreeSitterSymbol(symbol)));
-          ctx.print([
-            `Intelligence Symbols: ${targetPath}`,
-            `  source: ${state.symbolSearchStatus === 'ready' ? 'LSP/tree-sitter' : 'best-effort tree-sitter/LSP fallback'}`,
-            `  status: ${state.symbolSearchStatus}`,
-            `  results: ${symbols.length}`,
-            ...(entries.length > 0 ? entries : ['  No symbols available for this file.']),
-            '  next: /health intelligence',
-          ].join('\n'));
-          return;
-        }
-
-        const outline = await intelligence.getOutline(targetPath, content);
-        ctx.print([
-          `Intelligence Outline: ${targetPath}`,
-          `  source: tree-sitter outline extraction`,
-          `  language ready: ${intelligence.hasTreeSitter(targetPath) ? 'yes' : 'no'}`,
-          `  results: ${outline.length}`,
-          ...(outline.slice(0, 12).map((entry) => `  ${entry.signature || entry.name}  line ${entry.line}`)),
-          ...(outline.length === 0 ? ['  No outline entries available for this file.'] : []),
-          '  next: /intelligence symbols ' + targetPath,
-        ].join('\n'));
-        return;
-      }
-
-      if (sub === 'definition' || sub === 'references' || sub === 'hover') {
-        const targetPath = ensureExistingFile(args[1], ctx);
-        if (!targetPath) return;
-        const position = parsePosition(args[2], args[3]);
-        if (!position) {
-          ctx.print(`Intelligence ${sub[0]!.toUpperCase()}${sub.slice(1)}\n  Usage: /intelligence ${sub} <file> <line> <column>`);
-          return;
-        }
-
-        if (sub === 'definition') {
-          const definition = await intelligence.getDefinition(targetPath, position.line, position.column);
-          ctx.print([
-            `Intelligence Definition: ${targetPath}:${position.line + 1}:${position.column + 1}`,
-            `  status: ${state.hoverStatus === 'ready' || state.symbolSearchStatus === 'ready' ? 'available' : 'best-effort'}`,
-            ...(definition
-              ? [
-                  `  target: ${definition.uri}`,
-                  `  line: ${definition.range.start.line + 1}`,
-                  `  column: ${definition.range.start.character + 1}`,
-                  '  next: open the target file or use /intelligence references on the same symbol',
-                ]
-              : ['  No definition was returned for that position.', '  next: /health intelligence']),
-          ].join('\n'));
-          return;
-        }
-
-        if (sub === 'references') {
-          const references = await intelligence.getReferences(targetPath, position.line, position.column);
-          ctx.print([
-            `Intelligence References: ${targetPath}:${position.line + 1}:${position.column + 1}`,
-            `  status: ${state.symbolSearchStatus}`,
-            `  results: ${references.length}`,
-            ...(references.slice(0, 12).map((reference) => `  ${reference.uri}  ${reference.range.start.line + 1}:${reference.range.start.character + 1}`)),
-            ...(references.length === 0 ? ['  No references were returned for that position.'] : []),
-            '  next: /intelligence definition ' + `${targetPath} ${position.line + 1} ${position.column + 1}`,
-          ].join('\n'));
-          return;
-        }
-
-        const hover = await intelligence.getHover(targetPath, position.line, position.column);
-        const hoverLines = typeof hover?.contents === 'string'
-          ? hover.contents.split('\n')
-          : Array.isArray(hover?.contents)
-            ? hover.contents.flatMap((entry) => typeof entry === 'string' ? entry : entry.value.split('\n'))
-            : hover?.contents && 'value' in hover.contents
-              ? hover.contents.value.split('\n')
-              : [];
-        ctx.print([
-          `Intelligence Hover: ${targetPath}:${position.line + 1}:${position.column + 1}`,
-          `  status: ${state.hoverStatus}`,
-          ...(hoverLines.length > 0 ? hoverLines.slice(0, 8).map((line) => `  ${line}`) : ['  No hover information was returned for that position.']),
-          '  next: /health intelligence',
-        ].join('\n'));
-        return;
-      }
-
-      if (sub === 'diagnostics') {
-        const file = args[1];
-        const entries = [...state.diagnostics.entries()]
-          .map(([filePath, diagnostics]) => ({
-            filePath,
-            diagnostics,
-            errors: diagnostics.filter((entry) => entry.severity === 'error').length,
-            warnings: diagnostics.filter((entry) => entry.severity === 'warning').length,
-          }))
-          .sort((a, b) => (b.errors - a.errors) || (b.warnings - a.warnings) || a.filePath.localeCompare(b.filePath));
-        const selected = file
-          ? entries.find((entry) => entry.filePath === file)
-          : entries[0];
-        if (!selected) {
-          ctx.print('Intelligence Diagnostics\n  No diagnostics are currently tracked.');
-          return;
-        }
-        ctx.print([
-          `Intelligence Diagnostics: ${selected.filePath}`,
-          `  errors: ${selected.errors}`,
-          `  warnings: ${selected.warnings}`,
-          ...selected.diagnostics.slice(0, 8).map((diagnostic) => (
-            `  [${diagnostic.severity}] ${diagnostic.line + 1}:${diagnostic.column + 1} ${diagnostic.message}`
-          )),
-          ...(entries.length > 1 ? [`  next: /intelligence diagnostics ${entries[1]!.filePath}`] : []),
-        ].join('\n'));
-        return;
-      }
-
-      if (sub === 'repair') {
-        const lines = [
-          'Intelligence Repair',
-          '  verify: /health intelligence',
-          ...(state.diagnosticsStatus !== 'ready' ? ['  /setup review', '  /health intelligence'] : []),
-          ...(state.symbolSearchStatus !== 'ready' ? ['  /symbols', '  /intelligence symbols <file>', '  /health intelligence'] : []),
-          ...(state.completionsStatus !== 'ready' || state.hoverStatus !== 'ready'
-            ? ['  /intelligence review', '  /intelligence hover <file> <line> <column>', '  /setup onboarding']
-            : []),
-        ];
-        ctx.print(lines.length > 1 ? lines.join('\n') : 'Intelligence Repair\n  No active repair actions suggested.');
-        return;
-      }
-
-      const issues: string[] = [];
-      if (state.diagnosticsStatus !== 'ready') issues.push(`diagnostics=${state.diagnosticsStatus}`);
-      if (state.symbolSearchStatus !== 'ready') issues.push(`symbols=${state.symbolSearchStatus}`);
-      if (state.completionsStatus !== 'ready') issues.push(`completions=${state.completionsStatus}`);
-      if (state.hoverStatus !== 'ready') issues.push(`hover=${state.hoverStatus}`);
-
-      ctx.print([
-        'Intelligence Review',
-        `  diagnostics: ${state.diagnosticsStatus}`,
-        `  symbols: ${state.symbolSearchStatus}`,
-        `  completions: ${state.completionsStatus}`,
-        `  hover: ${state.hoverStatus}`,
-        `  errors: ${state.errorCount}`,
-        `  warnings: ${state.warningCount}`,
-        `  requests: ${state.totalRequests}`,
-        `  avg latency: ${Math.round(state.avgLatencyMs)}ms`,
-        ...(issues.length > 0 ? [`  issues: ${issues.join(', ')}`] : ['  issues: none']),
-        `  diagnostic files: ${state.diagnostics.size}`,
-        ...(state.diagnostics.size > 0 ? ['  next: /intelligence diagnostics'] : []),
-        '  next: /intelligence symbols <file>',
-        '  next: /intelligence outline <file>',
-        '  next: /intelligence references <file> <line> <column>',
-        '  next: /intelligence definition <file> <line> <column>',
-        '  next: /intelligence hover <file> <line> <column>',
-        '  next: /intelligence repair',
-      ].join('\n'));
-    },
-  });
-}