nia-opencode 0.1.0

package/README.md

@@ -0,0 +1,130 @@
+# nia-opencode
+
+OpenCode plugin that integrates [Nia Knowledge Agent](https://trynia.ai) for research, documentation, and codebase exploration.
+
+## Features
+
+- **Keyword Detection**: Automatically detects research-related queries and prompts the agent to use Nia tools
+- **MCP Integration**: Connects to Nia's MCP server for semantic search, documentation indexing, and AI research
+- **Zero Config**: Works out of the box with automatic MCP server setup
+
+## Installation
+
+```bash
+bunx nia-opencode@latest install
+```
+
+The installer will:
+1. Prompt for your Nia API key
+2. Create `~/.config/opencode/nia.json` with your config
+3. Add the plugin and MCP server to your OpenCode config
+
+### Non-Interactive Installation
+
+```bash
+bunx nia-opencode@latest install --no-tui --api-key nk_your_api_key
+```
+
+### Manual Setup
+
+1. Add to your `~/.config/opencode/opencode.json`:
+
+```json
+{
+  "plugin": ["nia-opencode@latest"],
+  "mcp": {
+    "nia": {
+      "type": "remote",
+      "url": "https://apigcp.trynia.ai/mcp",
+      "headers": {
+        "Authorization": "Bearer nk_your_api_key"
+      },
+      "oauth": false
+    }
+  }
+}
+```
+
+2. Set your API key (choose one):
+
+**Environment variable:**
+```bash
+export NIA_API_KEY="nk_your_api_key"
+```
+
+**Config file** (`~/.config/opencode/nia.json`):
+```json
+{
+  "apiKey": "nk_your_api_key"
+}
+```
+
+## Usage
+
+Once installed, the plugin automatically detects research-related queries and prompts the agent to use Nia tools.
+
+### Trigger Keywords
+
+The plugin activates when you say things like:
+- "Research how React hooks work"
+- "Look up the Next.js documentation"
+- "Search the codebase for authentication"
+- "Find docs for Prisma migrations"
+- "Grep for error handling patterns"
+- "Index this repo"
+
+### Available Nia Tools
+
+When triggered, the agent has access to:
+
+| Tool | Description |
+|------|-------------|
+| `nia.search` | Semantic search across indexed repos, docs, papers |
+| `nia.nia_research` | Web search (quick) or deep AI research (deep/oracle) |
+| `nia.index` | Index GitHub repos, docs sites, or arXiv papers |
+| `nia.nia_read` | Read files from indexed sources |
+| `nia.nia_grep` | Regex search across codebases |
+| `nia.nia_explore` | Browse file trees |
+| `nia.manage_resource` | List/manage indexed sources |
+
+## Configuration
+
+### `~/.config/opencode/nia.json`
+
+```json
+{
+  "apiKey": "nk_...",
+  "mcpUrl": "https://apigcp.trynia.ai/mcp",
+  "keywords": {
+    "enabled": true,
+    "patterns": [
+      "my custom pattern"
+    ]
+  }
+}
+```
+
+### Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `apiKey` | - | Your Nia API key |
+| `mcpUrl` | `https://apigcp.trynia.ai/mcp` | MCP server URL |
+| `keywords.enabled` | `true` | Enable/disable keyword detection |
+| `keywords.patterns` | `[]` | Additional regex patterns to trigger Nia |
+
+## Debugging
+
+Enable debug logging:
+
+```bash
+NIA_DEBUG=true opencode
+```
+
+## Get Your API Key
+
+Get your Nia API key at [trynia.ai/api-keys](https://trynia.ai/api-keys)
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { mkdirSync, writeFileSync, readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import * as readline from "node:readline";
+var OPENCODE_CONFIG_DIR = join(homedir(), ".config", "opencode");
+var NIA_CONFIG_PATH = join(OPENCODE_CONFIG_DIR, "nia.json");
+var PLUGIN_NAME = "nia-opencode@latest";
+function stripJsoncComments(content) {
+  return content.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*$/gm, "");
+}
+function createReadline() {
+  return readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+}
+async function confirm(rl, question) {
+  return new Promise((resolve) => {
+    rl.question(`${question} (y/n) `, (answer) => {
+      resolve(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+    });
+  });
+}
+async function prompt(rl, question) {
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      resolve(answer.trim());
+    });
+  });
+}
+function findOpencodeConfig() {
+  const candidates = [
+    join(OPENCODE_CONFIG_DIR, "opencode.jsonc"),
+    join(OPENCODE_CONFIG_DIR, "opencode.json")
+  ];
+  for (const path of candidates) {
+    if (existsSync(path)) {
+      return path;
+    }
+  }
+  return null;
+}
+function addPluginToConfig(configPath) {
+  try {
+    const content = readFileSync(configPath, "utf-8");
+    if (content.includes("nia-opencode")) {
+      console.log("  Plugin already registered in config");
+      return true;
+    }
+    const jsonContent = stripJsoncComments(content);
+    let config;
+    try {
+      config = JSON.parse(jsonContent);
+    } catch {
+      console.error("  Failed to parse config file");
+      return false;
+    }
+    const plugins = config.plugin || [];
+    plugins.push(PLUGIN_NAME);
+    config.plugin = plugins;
+    if (configPath.endsWith(".jsonc")) {
+      if (content.includes('"plugin"')) {
+        const newContent = content.replace(/("plugin"\s*:\s*\[)([^\]]*?)(\])/, (_match, start, middle, end) => {
+          const trimmed = middle.trim();
+          if (trimmed === "") {
+            return `${start}
+    "${PLUGIN_NAME}"
+  ${end}`;
+          }
+          return `${start}${middle.trimEnd()},
+    "${PLUGIN_NAME}"
+  ${end}`;
+        });
+        writeFileSync(configPath, newContent);
+      } else {
+        const newContent = content.replace(/^(\s*\{)/, `$1
+  "plugin": ["${PLUGIN_NAME}"],`);
+        writeFileSync(configPath, newContent);
+      }
+    } else {
+      writeFileSync(configPath, JSON.stringify(config, null, 2));
+    }
+    console.log(`  Added plugin to ${configPath}`);
+    return true;
+  } catch (err) {
+    console.error("  Failed to update config:", err);
+    return false;
+  }
+}
+function addMcpServerToConfig(configPath, apiKey) {
+  try {
+    const content = readFileSync(configPath, "utf-8");
+    const jsonContent = stripJsoncComments(content);
+    let config;
+    try {
+      config = JSON.parse(jsonContent);
+    } catch {
+      console.error("  Failed to parse config file");
+      return false;
+    }
+    const mcp = config.mcp || {};
+    if (mcp.nia) {
+      console.log("  MCP server 'nia' already configured");
+      return true;
+    }
+    mcp.nia = {
+      type: "remote",
+      url: "https://apigcp.trynia.ai/mcp",
+      headers: {
+        Authorization: `Bearer ${apiKey}`
+      },
+      oauth: false
+    };
+    config.mcp = mcp;
+    writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log("  Added MCP server 'nia' to config");
+    return true;
+  } catch (err) {
+    console.error("  Failed to add MCP server:", err);
+    return false;
+  }
+}
+function createNewConfig(apiKey) {
+  mkdirSync(OPENCODE_CONFIG_DIR, { recursive: true });
+  const configPath = join(OPENCODE_CONFIG_DIR, "opencode.json");
+  const config = {
+    plugin: [PLUGIN_NAME],
+    mcp: {
+      nia: {
+        type: "remote",
+        url: "https://apigcp.trynia.ai/mcp",
+        headers: {
+          Authorization: `Bearer ${apiKey}`
+        },
+        oauth: false
+      }
+    }
+  };
+  writeFileSync(configPath, JSON.stringify(config, null, 2));
+  console.log(`  Created ${configPath}`);
+  return true;
+}
+function createNiaConfig(apiKey) {
+  mkdirSync(OPENCODE_CONFIG_DIR, { recursive: true });
+  const config = {
+    apiKey,
+    keywords: {
+      enabled: true
+    }
+  };
+  writeFileSync(NIA_CONFIG_PATH, JSON.stringify(config, null, 2));
+  console.log(`  Created ${NIA_CONFIG_PATH}`);
+  return true;
+}
+async function install(options) {
+  console.log(`
+ Nia OpenCode Plugin Installer
+`);
+  const rl = options.tui ? createReadline() : null;
+  console.log("Step 1: Configure API Key");
+  let apiKey = options.apiKey || process.env.NIA_API_KEY || "";
+  if (!apiKey && options.tui && rl) {
+    console.log(`Get your API key from: https://trynia.ai/api-keys
+`);
+    apiKey = await prompt(rl, "Enter your Nia API key (nk_...): ");
+  }
+  if (!apiKey) {
+    console.log("  No API key provided. You can set NIA_API_KEY environment variable later.");
+    console.log(`  Get your API key at: https://trynia.ai/api-keys
+`);
+  } else if (!apiKey.startsWith("nk_")) {
+    console.log("  Warning: API key should start with 'nk_'");
+  } else {
+    console.log("  API key configured");
+  }
+  console.log(`
+Step 2: Create Nia Config`);
+  if (apiKey) {
+    createNiaConfig(apiKey);
+  } else {
+    console.log("  Skipped (no API key)");
+  }
+  console.log(`
+Step 3: Configure OpenCode`);
+  const configPath = findOpencodeConfig();
+  if (configPath) {
+    if (options.tui && rl) {
+      const shouldModify = await confirm(rl, `Modify ${configPath}?`);
+      if (shouldModify) {
+        addPluginToConfig(configPath);
+        if (apiKey) {
+          addMcpServerToConfig(configPath, apiKey);
+        }
+      } else {
+        console.log("  Skipped.");
+      }
+    } else {
+      addPluginToConfig(configPath);
+      if (apiKey) {
+        addMcpServerToConfig(configPath, apiKey);
+      }
+    }
+  } else {
+    if (options.tui && rl) {
+      const shouldCreate = await confirm(rl, "No OpenCode config found. Create one?");
+      if (shouldCreate && apiKey) {
+        createNewConfig(apiKey);
+      } else {
+        console.log("  Skipped.");
+      }
+    } else if (apiKey) {
+      createNewConfig(apiKey);
+    }
+  }
+  console.log(`
+` + "-".repeat(50));
+  console.log(`
+ Setup Complete!
+`);
+  if (!apiKey) {
+    console.log("Next steps:");
+    console.log("1. Get your API key from: https://trynia.ai/api-keys");
+    console.log("2. Set the environment variable:");
+    console.log('   export NIA_API_KEY="nk_..."');
+    console.log("   Or edit ~/.config/opencode/nia.json");
+  } else {
+    console.log("Nia is configured and ready to use!");
+  }
+  console.log(`
+Keyword triggers enabled:`);
+  console.log('  - "research...", "look up...", "find docs..."');
+  console.log('  - "search codebase...", "grep for..."');
+  console.log('  - "index this repo", "add to nia"');
+  console.log(`
+Restart OpenCode to activate the plugin.
+`);
+  if (rl)
+    rl.close();
+  return 0;
+}
+function printHelp() {
+  console.log(`
+nia-opencode - Nia Knowledge Agent plugin for OpenCode
+
+Commands:
+  install                Install and configure the plugin
+    --no-tui             Non-interactive mode
+    --api-key <key>      Provide API key directly
+
+Examples:
+  bunx nia-opencode@latest install
+  bunx nia-opencode@latest install --no-tui --api-key nk_xxx
+`);
+}
+var args = process.argv.slice(2);
+if (args.length === 0 || args[0] === "help" || args[0] === "--help" || args[0] === "-h") {
+  printHelp();
+  process.exit(0);
+}
+if (args[0] === "install") {
+  const noTui = args.includes("--no-tui");
+  const apiKeyIndex = args.indexOf("--api-key");
+  const apiKey = apiKeyIndex !== -1 ? args[apiKeyIndex + 1] : undefined;
+  install({ tui: !noTui, apiKey }).then((code) => process.exit(code));
+} else {
+  console.error(`Unknown command: ${args[0]}`);
+  printHelp();
+  process.exit(1);
+}

package/dist/config.d.ts

@@ -0,0 +1,11 @@
+export declare const NIA_API_KEY: string | undefined;
+export declare const NIA_MCP_URL: string;
+export declare const CONFIG: {
+    mcpUrl: string;
+    keywords: {
+        enabled: boolean;
+        customPatterns: string[];
+    };
+};
+export declare function isConfigured(): boolean;
+export declare function getConfigDir(): string;

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from "@opencode-ai/plugin";
+export declare const NiaPlugin: Plugin;
+export default NiaPlugin;

package/dist/index.js

@@ -0,0 +1,171 @@
+// src/config.ts
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+var CONFIG_DIR = join(homedir(), ".config", "opencode");
+var CONFIG_FILES = [
+  join(CONFIG_DIR, "nia.jsonc"),
+  join(CONFIG_DIR, "nia.json")
+];
+var DEFAULTS = {
+  mcpUrl: "https://apigcp.trynia.ai/mcp",
+  keywords: {
+    enabled: true,
+    patterns: []
+  }
+};
+function stripJsoncComments(content) {
+  return content.replace(/\/\*[\s\S]*?\*\//g, "").replace(/\/\/.*$/gm, "");
+}
+function loadConfig() {
+  for (const path of CONFIG_FILES) {
+    if (existsSync(path)) {
+      try {
+        const content = readFileSync(path, "utf-8");
+        const json = stripJsoncComments(content);
+        return JSON.parse(json);
+      } catch {}
+    }
+  }
+  return {};
+}
+var fileConfig = loadConfig();
+var NIA_API_KEY = fileConfig.apiKey ?? process.env.NIA_API_KEY;
+var NIA_MCP_URL = fileConfig.mcpUrl ?? process.env.NIA_MCP_URL ?? DEFAULTS.mcpUrl;
+var CONFIG = {
+  mcpUrl: NIA_MCP_URL,
+  keywords: {
+    enabled: fileConfig.keywords?.enabled ?? DEFAULTS.keywords.enabled,
+    customPatterns: fileConfig.keywords?.patterns ?? []
+  }
+};
+function isConfigured() {
+  return !!NIA_API_KEY;
+}
+
+// src/keywords.ts
+var CODE_BLOCK_PATTERN = /```[\s\S]*?```/g;
+var INLINE_CODE_PATTERN = /`[^`]+`/g;
+var DEFAULT_PATTERNS = [
+  /\b(research|look\s*up|find\s*docs?)\b/i,
+  /\b(search\s+for|search\s+codebase|search\s+repo|search\s+docs?)\b/i,
+  /\b(grep\s+for|grep\s+in)\b/i,
+  /\b(index\s+(this\s+)?repo|add\s+to\s+nia)\b/i,
+  /\b(what\s+is|how\s+does|explain)\s+\w+\s+(library|package|framework|module)/i,
+  /\bcheck\s+(the\s+)?(docs?|documentation)\s+(for|about|on)\b/i,
+  /\bfind\s+(examples?|usage)\s+(of|for)\b/i
+];
+function removeCodeBlocks(text) {
+  return text.replace(CODE_BLOCK_PATTERN, "").replace(INLINE_CODE_PATTERN, "");
+}
+function compileCustomPatterns() {
+  return CONFIG.keywords.customPatterns.map((pattern) => {
+    try {
+      return new RegExp(pattern, "i");
+    } catch {
+      return null;
+    }
+  }).filter((p) => p !== null);
+}
+function detectResearchKeyword(text) {
+  if (!CONFIG.keywords.enabled) {
+    return { detected: false };
+  }
+  const textWithoutCode = removeCodeBlocks(text);
+  const allPatterns = [...DEFAULT_PATTERNS, ...compileCustomPatterns()];
+  for (const pattern of allPatterns) {
+    const match = textWithoutCode.match(pattern);
+    if (match) {
+      return { detected: true, match: match[0] };
+    }
+  }
+  return { detected: false };
+}
+var NIA_NUDGE_MESSAGE = `[NIA KNOWLEDGE TRIGGER]
+The user is asking for research, documentation, or codebase exploration. You have access to **Nia** tools via MCP.
+
+**Available Nia tools:**
+- \`nia.search\` - Semantic search across indexed repos, docs, and papers
+- \`nia.nia_research\` - Web search (quick) or deep AI research (deep/oracle modes)
+- \`nia.index\` - Index new GitHub repos, documentation sites, or arXiv papers
+- \`nia.nia_read\` - Read specific files from indexed sources
+- \`nia.nia_grep\` - Regex search across indexed codebases
+- \`nia.nia_explore\` - Browse file trees of indexed repos/docs
+- \`nia.manage_resource\` - List/check status of indexed sources
+
+**Workflow:**
+1. Check what's indexed: \`nia.manage_resource(action: "list")\`
+2. Search or research based on the user's question
+3. Read specific files if needed for deeper context
+
+Use these tools to provide accurate, up-to-date information instead of relying solely on training data.`;
+
+// src/services/logger.ts
+var DEBUG = process.env.NIA_DEBUG === "true" || process.env.NIA_DEBUG === "1";
+function log(message, data) {
+  if (!DEBUG)
+    return;
+  const timestamp = new Date().toISOString();
+  const prefix = `[nia-opencode ${timestamp}]`;
+  if (data) {
+    console.log(prefix, message, JSON.stringify(data, null, 2));
+  } else {
+    console.log(prefix, message);
+  }
+}
+
+// src/index.ts
+var NiaPlugin = async (ctx) => {
+  const { directory } = ctx;
+  const injectedSessions = new Set;
+  log("Plugin initialized", { directory, configured: isConfigured() });
+  if (!isConfigured()) {
+    log("Plugin disabled - NIA_API_KEY not set");
+  }
+  return {
+    "chat.message": async (input, output) => {
+      if (!isConfigured())
+        return;
+      const start = Date.now();
+      try {
+        const textParts = output.parts.filter((p) => p.type === "text");
+        if (textParts.length === 0) {
+          log("chat.message: no text parts found");
+          return;
+        }
+        const userMessage = textParts.map((p) => p.text).join(`
+`);
+        if (!userMessage.trim()) {
+          log("chat.message: empty message, skipping");
+          return;
+        }
+        log("chat.message: processing", {
+          messagePreview: userMessage.slice(0, 100),
+          partsCount: output.parts.length
+        });
+        const { detected, match } = detectResearchKeyword(userMessage);
+        if (detected) {
+          log("chat.message: research keyword detected", { match });
+          const nudgePart = {
+            id: `nia-nudge-${Date.now()}`,
+            sessionID: input.sessionID,
+            messageID: output.message.id,
+            type: "text",
+            text: NIA_NUDGE_MESSAGE,
+            synthetic: true
+          };
+          output.parts.push(nudgePart);
+          const duration = Date.now() - start;
+          log("chat.message: nudge injected", { duration, match });
+        }
+      } catch (error) {
+        log("chat.message: ERROR", { error: String(error) });
+      }
+    }
+  };
+};
+var src_default = NiaPlugin;
+export {
+  src_default as default,
+  NiaPlugin
+};

package/dist/keywords.d.ts

@@ -0,0 +1,5 @@
+export declare function detectResearchKeyword(text: string): {
+    detected: boolean;
+    match?: string;
+};
+export declare const NIA_NUDGE_MESSAGE = "[NIA KNOWLEDGE TRIGGER]\nThe user is asking for research, documentation, or codebase exploration. You have access to **Nia** tools via MCP.\n\n**Available Nia tools:**\n- `nia.search` - Semantic search across indexed repos, docs, and papers\n- `nia.nia_research` - Web search (quick) or deep AI research (deep/oracle modes)\n- `nia.index` - Index new GitHub repos, documentation sites, or arXiv papers\n- `nia.nia_read` - Read specific files from indexed sources\n- `nia.nia_grep` - Regex search across indexed codebases\n- `nia.nia_explore` - Browse file trees of indexed repos/docs\n- `nia.manage_resource` - List/check status of indexed sources\n\n**Workflow:**\n1. Check what's indexed: `nia.manage_resource(action: \"list\")`\n2. Search or research based on the user's question\n3. Read specific files if needed for deeper context\n\nUse these tools to provide accurate, up-to-date information instead of relying solely on training data.";

package/dist/services/logger.d.ts

@@ -0,0 +1 @@
+export declare function log(message: string, data?: Record<string, unknown>): void;

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "nia-opencode",
+  "version": "0.1.0",
+  "description": "OpenCode plugin that integrates Nia Knowledge Agent for research and documentation",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "nia-opencode": "./dist/cli.js"
+  },
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target node && bun build ./src/cli.ts --outfile ./dist/cli.js --target node && tsc --emitDeclarationOnly",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "nia",
+    "knowledge",
+    "research",
+    "documentation",
+    "ai",
+    "coding-agent"
+  ],
+  "author": "Nia",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nozomio-labs/nia-opencode"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.0.162"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.3"
+  },
+  "opencode": {
+    "type": "plugin",
+    "hooks": [
+      "chat.message"
+    ]
+  },
+  "files": [
+    "dist"
+  ]
+}