@openvole/paw-xai 0.1.0

package/README.md

@@ -0,0 +1,45 @@
+# @openvole/paw-xai
+
+**Brain Paw powered by xAI Grok models.**
+
+[![npm](https://img.shields.io/npm/v/@openvole/paw-xai)](https://www.npmjs.com/package/@openvole/paw-xai)
+
+Part of [OpenVole](https://github.com/openvole/openvole) — the microkernel AI agent framework.
+
+## Install
+
+```bash
+npm install @openvole/paw-xai
+```
+
+## Config
+
+```json
+{
+  "brain": "@openvole/paw-xai",
+  "paws": [
+    {
+      "name": "@openvole/paw-xai",
+      "allow": {
+        "network": ["api.x.ai"],
+        "env": ["XAI_API_KEY", "XAI_MODEL"]
+      }
+    }
+  ]
+}
+```
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `XAI_API_KEY` | Yes | xAI API key |
+| `XAI_MODEL` | No | Model name (default: `grok-3`) |
+
+## Brain
+
+Implements the Think phase using xAI's OpenAI-compatible API. Supports BRAIN.md, identity files (SOUL.md, USER.md, AGENT.md), session history, and memory injection.
+
+## License
+
+[MIT](https://github.com/openvole/pawhub/blob/main/LICENSE)

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import * as _openvole_paw_sdk from '@openvole/paw-sdk';
+
+declare const _default: _openvole_paw_sdk.PawDefinition;
+
+export { _default as default };

package/dist/index.js

@@ -0,0 +1,270 @@
+// src/index.ts
+import { definePaw } from "@openvole/paw-sdk";
+
+// src/paw.ts
+import * as fs from "fs/promises";
+import * as path from "path";
+import OpenAI from "openai";
+var client;
+var model = "grok-3";
+var identityContext;
+var customBrainPrompt;
+async function loadBrainPrompt() {
+  try {
+    const content = await fs.readFile(
+      path.resolve(process.cwd(), ".openvole", "BRAIN.md"),
+      "utf-8"
+    );
+    if (content.trim()) {
+      console.log("[paw-xai] loaded custom BRAIN.md prompt");
+      return content.trim();
+    }
+  } catch {
+  }
+  return void 0;
+}
+async function loadIdentityFiles() {
+  const openvoleDir = path.resolve(process.cwd(), ".openvole");
+  const files = [
+    { name: "SOUL.md", section: "Agent Identity" },
+    { name: "USER.md", section: "User Profile" },
+    { name: "AGENT.md", section: "Agent Rules" }
+  ];
+  const parts = [];
+  for (const file of files) {
+    try {
+      const content = await fs.readFile(path.join(openvoleDir, file.name), "utf-8");
+      if (content.trim()) {
+        parts.push(`## ${file.section}
+${content.trim()}`);
+      }
+    } catch {
+    }
+  }
+  return parts.join("\n\n");
+}
+function getClient() {
+  if (!client) {
+    const apiKey = process.env.XAI_API_KEY;
+    model = process.env.XAI_MODEL || "grok-3";
+    client = new OpenAI({ apiKey, baseURL: "https://api.x.ai/v1" });
+  }
+  return client;
+}
+function buildSystemPrompt(activeSkills, availableTools, metadata, identityCtx, customBrain) {
+  const now = /* @__PURE__ */ new Date();
+  const runtimeContext = `## Current Context
+- Date: ${now.toLocaleDateString("en-US", { weekday: "long", year: "numeric", month: "long", day: "numeric" })}
+- Time: ${now.toLocaleTimeString("en-US", { hour12: true })}
+- Platform: ${process.platform}
+- Model: ${model}`;
+  const basePrompt = customBrain ?? `You are an AI agent powered by OpenVole. You accomplish tasks by using tools step by step.
+
+## How to Work
+1. Read the conversation history first \u2014 short user messages like an email or "yes" are answers to your previous questions
+2. Break complex tasks into clear steps and execute them one at a time
+3. After each tool call, examine the result carefully before deciding the next action
+4. Never repeat the same tool call if it already succeeded \u2014 move to the next step
+5. If a tool returns an error, try a different approach or different parameters
+6. When you read important information (API docs, instructions, credentials), save it to workspace or memory immediately
+7. When you have enough information to respond, do so directly \u2014 don't keep searching
+8. If you cannot complete a task (missing credentials, access denied), explain exactly what you need and stop
+
+## Data Management
+- **Vault** (vault_store/get): ALL sensitive data \u2014 emails, passwords, API keys, tokens, credentials, usernames, handles, personal identifiers. ALWAYS use vault for these, NEVER memory or workspace.
+- **Memory** (memory_write/read): General knowledge, non-sensitive facts, preferences, summaries
+- **Workspace** (workspace_write/read): Files, documents, downloaded content, API docs, drafts
+- **Session history**: Recent conversation \u2014 automatically available, review it before each response
+
+## Recurring Tasks
+When the user asks you to do something regularly, repeatedly, or on a schedule:
+- **schedule_task**: Use this for tasks with a specific interval (e.g. "post every 6 hours", "check every 30 minutes"). Creates an automatic timer \u2014 no heartbeat needed.
+- **heartbeat_write**: Use this ONLY for open-ended checks with no specific interval (e.g. "keep an eye on server status"). These run on the global heartbeat timer.
+- Use ONE or the OTHER \u2014 never both for the same task. If you use schedule_task, do NOT also add it to HEARTBEAT.md.
+- Do NOT just save recurring task requests to memory \u2014 that won't make them happen.
+
+## Safety
+- Never attempt to bypass access controls or escalate permissions
+- Always ask for confirmation before performing destructive or irreversible actions
+- Store credentials and personal identifiers ONLY in the vault \u2014 never in memory or workspace`;
+  const parts = [basePrompt, "", runtimeContext];
+  if (identityCtx) {
+    parts.push("");
+    parts.push(identityCtx);
+  }
+  if (metadata?.sessionHistory && typeof metadata.sessionHistory === "string") {
+    parts.push("");
+    parts.push("## Conversation History");
+    parts.push("Previous messages in this session. Use this to understand the current context and follow-up messages:");
+    parts.push(metadata.sessionHistory);
+  }
+  if (metadata?.memory && typeof metadata.memory === "string") {
+    parts.push("");
+    parts.push("## Agent Memory");
+    parts.push(metadata.memory);
+  }
+  if (activeSkills.length > 0) {
+    parts.push("");
+    parts.push("## Available Skills");
+    parts.push(
+      "The following skills are available. Use the skill_read tool to load full instructions when a skill is relevant to the current task."
+    );
+    for (const skill of activeSkills) {
+      parts.push(`- **${skill.name}**: ${skill.description}`);
+    }
+  }
+  if (availableTools.length > 0) {
+    parts.push("");
+    parts.push("## Available Tools");
+    parts.push(
+      "You have access to the following tools. Use function calling to invoke them when needed."
+    );
+    for (const tool of availableTools) {
+      parts.push(`- **${tool.name}** (from ${tool.pawName}): ${tool.description}`);
+    }
+  }
+  return parts.join("\n");
+}
+function convertMessages(systemPrompt, messages) {
+  const result = [
+    { role: "system", content: systemPrompt }
+  ];
+  for (const msg of messages) {
+    switch (msg.role) {
+      case "user":
+        result.push({ role: "user", content: msg.content });
+        break;
+      case "brain":
+        result.push({ role: "assistant", content: msg.content });
+        break;
+      case "tool_result":
+        result.push({
+          role: "tool",
+          content: msg.content,
+          tool_call_id: msg.toolCallId || "unknown"
+        });
+        break;
+      case "error":
+        result.push({
+          role: "tool",
+          content: `Error: ${msg.content}`,
+          tool_call_id: msg.toolCallId || "unknown"
+        });
+        break;
+    }
+  }
+  return result;
+}
+function convertTools(tools) {
+  return tools.map((tool) => ({
+    type: "function",
+    function: {
+      name: tool.name,
+      description: tool.description,
+      parameters: {
+        type: "object",
+        properties: {}
+      }
+    }
+  }));
+}
+function parseToolCalls(message) {
+  if (!message.tool_calls || message.tool_calls.length === 0) {
+    return [];
+  }
+  return message.tool_calls.map((call) => {
+    let params = {};
+    try {
+      params = JSON.parse(call.function.arguments);
+    } catch {
+    }
+    return {
+      tool: call.function.name,
+      params
+    };
+  });
+}
+var paw = {
+  name: "@openvole/paw-xai",
+  version: "0.1.0",
+  description: "Brain Paw powered by OpenAI",
+  brain: true,
+  async think(context) {
+    const openai = getClient();
+    const start = Date.now();
+    try {
+      const systemPrompt = buildSystemPrompt(
+        context.activeSkills,
+        context.availableTools,
+        context.metadata,
+        identityContext,
+        customBrainPrompt
+      );
+      const openaiMessages = convertMessages(systemPrompt, context.messages);
+      const openaiTools = convertTools(context.availableTools);
+      const response = await openai.chat.completions.create({
+        model,
+        messages: openaiMessages,
+        ...openaiTools.length > 0 ? { tools: openaiTools } : {}
+      });
+      const durationMs = Date.now() - start;
+      console.log(
+        `[paw-xai] think completed in ${durationMs}ms (model: ${model})`
+      );
+      const choice = response.choices[0];
+      if (!choice) {
+        return {
+          actions: [],
+          response: "No response from OpenAI.",
+          done: true
+        };
+      }
+      const actions = parseToolCalls(choice.message);
+      if (actions.length > 0) {
+        return {
+          actions,
+          execution: "sequential"
+        };
+      }
+      const text = choice.message.content || "";
+      return {
+        actions: [],
+        response: text,
+        done: choice.finish_reason === "stop"
+      };
+    } catch (error) {
+      const durationMs = Date.now() - start;
+      const message = error instanceof Error ? error.message : String(error);
+      console.error(
+        `[paw-xai] think failed after ${durationMs}ms: ${message}`
+      );
+      return {
+        actions: [],
+        response: `Error communicating with OpenAI API: ${message}`,
+        done: true
+      };
+    }
+  },
+  async onLoad() {
+    getClient();
+    customBrainPrompt = await loadBrainPrompt();
+    identityContext = await loadIdentityFiles();
+    if (identityContext) {
+      console.log("[paw-xai] loaded identity files (SOUL.md, USER.md, AGENT.md)");
+    }
+    console.log(
+      `[paw-xai] loaded \u2014 model: ${model}`
+    );
+  },
+  async onUnload() {
+    client = void 0;
+    console.log("[paw-xai] unloaded");
+  }
+};
+
+// src/index.ts
+var index_default = definePaw(paw);
+export {
+  index_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/paw.ts"],"sourcesContent":["import { definePaw } from '@openvole/paw-sdk'\nimport { paw } from './paw.js'\n\nexport default definePaw(paw)\n","import * as fs from 'node:fs/promises'\nimport * as path from 'node:path'\nimport OpenAI from 'openai'\nimport type {\n\tPawDefinition,\n\tAgentContext,\n\tAgentPlan,\n\tAgentMessage,\n\tActiveSkill,\n\tPlannedAction,\n\tToolSummary,\n} from '@openvole/paw-sdk'\n\nlet client: OpenAI | undefined\nlet model: string = 'grok-3'\n\n/** Cached identity files — loaded once on startup */\nlet identityContext: string | undefined\n\n/** Custom brain prompt from BRAIN.md — overrides default system prompt if present */\nlet customBrainPrompt: string | undefined\n\n/** Load BRAIN.md from .openvole/ — if it exists, it replaces the default system prompt */\nasync function loadBrainPrompt(): Promise<string | undefined> {\n\ttry {\n\t\tconst content = await fs.readFile(\n\t\t\tpath.resolve(process.cwd(), '.openvole', 'BRAIN.md'),\n\t\t\t'utf-8',\n\t\t)\n\t\tif (content.trim()) {\n\t\t\tconsole.log('[paw-xai] loaded custom BRAIN.md prompt')\n\t\t\treturn content.trim()\n\t\t}\n\t} catch {\n\t\t// No BRAIN.md — use default\n\t}\n\treturn undefined\n}\n\n/** Load identity files from .openvole/ (AGENT.md, USER.md, SOUL.md) */\nasync function loadIdentityFiles(): Promise<string> {\n\tconst openvoleDir = path.resolve(process.cwd(), '.openvole')\n\tconst files = [\n\t\t{ name: 'SOUL.md', section: 'Agent Identity' },\n\t\t{ name: 'USER.md', section: 'User Profile' },\n\t\t{ name: 'AGENT.md', section: 'Agent Rules' },\n\t]\n\n\tconst parts: string[] = []\n\tfor (const file of files) {\n\t\ttry {\n\t\t\tconst content = await fs.readFile(path.join(openvoleDir, file.name), 'utf-8')\n\t\t\tif (content.trim()) {\n\t\t\t\tparts.push(`## ${file.section}\\n${content.trim()}`)\n\t\t\t}\n\t\t} catch {\n\t\t\t// File doesn't exist — skip\n\t\t}\n\t}\n\n\treturn parts.join('\\n\\n')\n}\n\nfunction getClient(): OpenAI {\n\tif (!client) {\n\t\tconst apiKey = process.env.XAI_API_KEY\n\t\tmodel = process.env.XAI_MODEL || 'grok-3'\n\t\tclient = new OpenAI({ apiKey, baseURL: 'https://api.x.ai/v1' })\n\t}\n\treturn client\n}\n\nfunction buildSystemPrompt(\n\tactiveSkills: ActiveSkill[],\n\tavailableTools: ToolSummary[],\n\tmetadata?: Record<string, unknown>,\n\tidentityCtx?: string,\n\tcustomBrain?: string,\n): string {\n\tconst now = new Date()\n\tconst runtimeContext = `## Current Context\n- Date: ${now.toLocaleDateString('en-US', { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' })}\n- Time: ${now.toLocaleTimeString('en-US', { hour12: true })}\n- Platform: ${process.platform}\n- Model: ${model}`\n\n\t// Use custom BRAIN.md if provided, otherwise use default prompt\n\tconst basePrompt = customBrain ?? `You are an AI agent powered by OpenVole. You accomplish tasks by using tools step by step.\n\n## How to Work\n1. Read the conversation history first — short user messages like an email or \"yes\" are answers to your previous questions\n2. Break complex tasks into clear steps and execute them one at a time\n3. After each tool call, examine the result carefully before deciding the next action\n4. Never repeat the same tool call if it already succeeded — move to the next step\n5. If a tool returns an error, try a different approach or different parameters\n6. When you read important information (API docs, instructions, credentials), save it to workspace or memory immediately\n7. When you have enough information to respond, do so directly — don't keep searching\n8. If you cannot complete a task (missing credentials, access denied), explain exactly what you need and stop\n\n## Data Management\n- **Vault** (vault_store/get): ALL sensitive data — emails, passwords, API keys, tokens, credentials, usernames, handles, personal identifiers. ALWAYS use vault for these, NEVER memory or workspace.\n- **Memory** (memory_write/read): General knowledge, non-sensitive facts, preferences, summaries\n- **Workspace** (workspace_write/read): Files, documents, downloaded content, API docs, drafts\n- **Session history**: Recent conversation — automatically available, review it before each response\n\n## Recurring Tasks\nWhen the user asks you to do something regularly, repeatedly, or on a schedule:\n- **schedule_task**: Use this for tasks with a specific interval (e.g. \"post every 6 hours\", \"check every 30 minutes\"). Creates an automatic timer — no heartbeat needed.\n- **heartbeat_write**: Use this ONLY for open-ended checks with no specific interval (e.g. \"keep an eye on server status\"). These run on the global heartbeat timer.\n- Use ONE or the OTHER — never both for the same task. If you use schedule_task, do NOT also add it to HEARTBEAT.md.\n- Do NOT just save recurring task requests to memory — that won't make them happen.\n\n## Safety\n- Never attempt to bypass access controls or escalate permissions\n- Always ask for confirmation before performing destructive or irreversible actions\n- Store credentials and personal identifiers ONLY in the vault — never in memory or workspace`\n\n\tconst parts: string[] = [basePrompt, '', runtimeContext]\n\n\t// Inject identity context (SOUL.md, USER.md, AGENT.md) if available\n\tif (identityCtx) {\n\t\tparts.push('')\n\t\tparts.push(identityCtx)\n\t}\n\n\t// Inject session history if available — this is critical for conversation continuity\n\tif (metadata?.sessionHistory && typeof metadata.sessionHistory === 'string') {\n\t\tparts.push('')\n\t\tparts.push('## Conversation History')\n\t\tparts.push('Previous messages in this session. Use this to understand the current context and follow-up messages:')\n\t\tparts.push(metadata.sessionHistory)\n\t}\n\n\t// Inject memory if available\n\tif (metadata?.memory && typeof metadata.memory === 'string') {\n\t\tparts.push('')\n\t\tparts.push('## Agent Memory')\n\t\tparts.push(metadata.memory)\n\t}\n\n\tif (activeSkills.length > 0) {\n\t\tparts.push('')\n\t\tparts.push('## Available Skills')\n\t\tparts.push(\n\t\t\t'The following skills are available. Use the skill_read tool to load full instructions when a skill is relevant to the current task.',\n\t\t)\n\t\tfor (const skill of activeSkills) {\n\t\t\tparts.push(`- **${skill.name}**: ${skill.description}`)\n\t\t}\n\t}\n\n\tif (availableTools.length > 0) {\n\t\tparts.push('')\n\t\tparts.push('## Available Tools')\n\t\tparts.push(\n\t\t\t'You have access to the following tools. Use function calling to invoke them when needed.',\n\t\t)\n\t\tfor (const tool of availableTools) {\n\t\t\tparts.push(`- **${tool.name}** (from ${tool.pawName}): ${tool.description}`)\n\t\t}\n\t}\n\n\treturn parts.join('\\n')\n}\n\nfunction convertMessages(\n\tsystemPrompt: string,\n\tmessages: AgentMessage[],\n): OpenAI.ChatCompletionMessageParam[] {\n\tconst result: OpenAI.ChatCompletionMessageParam[] = [\n\t\t{ role: 'system', content: systemPrompt },\n\t]\n\n\tfor (const msg of messages) {\n\t\tswitch (msg.role) {\n\t\t\tcase 'user':\n\t\t\t\tresult.push({ role: 'user', content: msg.content })\n\t\t\t\tbreak\n\t\t\tcase 'brain':\n\t\t\t\tresult.push({ role: 'assistant', content: msg.content })\n\t\t\t\tbreak\n\t\t\tcase 'tool_result':\n\t\t\t\tresult.push({\n\t\t\t\t\trole: 'tool',\n\t\t\t\t\tcontent: msg.content,\n\t\t\t\t\ttool_call_id: (msg as any).toolCallId || 'unknown',\n\t\t\t\t})\n\t\t\t\tbreak\n\t\t\tcase 'error':\n\t\t\t\tresult.push({\n\t\t\t\t\trole: 'tool',\n\t\t\t\t\tcontent: `Error: ${msg.content}`,\n\t\t\t\t\ttool_call_id: (msg as any).toolCallId || 'unknown',\n\t\t\t\t})\n\t\t\t\tbreak\n\t\t}\n\t}\n\n\treturn result\n}\n\nfunction convertTools(\n\ttools: ToolSummary[],\n): OpenAI.ChatCompletionTool[] {\n\treturn tools.map((tool) => ({\n\t\ttype: 'function' as const,\n\t\tfunction: {\n\t\t\tname: tool.name,\n\t\t\tdescription: tool.description,\n\t\t\tparameters: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {},\n\t\t\t},\n\t\t},\n\t}))\n}\n\nfunction parseToolCalls(\n\tmessage: OpenAI.ChatCompletionMessage,\n): PlannedAction[] {\n\tif (!message.tool_calls || message.tool_calls.length === 0) {\n\t\treturn []\n\t}\n\n\treturn message.tool_calls.map((call) => {\n\t\tlet params: Record<string, unknown> = {}\n\t\ttry {\n\t\t\tparams = JSON.parse(call.function.arguments)\n\t\t} catch {\n\t\t\t// If arguments can't be parsed, use empty params\n\t\t}\n\t\treturn {\n\t\t\ttool: call.function.name,\n\t\t\tparams,\n\t\t}\n\t})\n}\n\nexport const paw: PawDefinition = {\n\tname: '@openvole/paw-xai',\n\tversion: '0.1.0',\n\tdescription: 'Brain Paw powered by OpenAI',\n\tbrain: true,\n\n\tasync think(context: AgentContext): Promise<AgentPlan> {\n\t\tconst openai = getClient()\n\t\tconst start = Date.now()\n\n\t\ttry {\n\t\t\tconst systemPrompt = buildSystemPrompt(\n\t\t\t\tcontext.activeSkills,\n\t\t\t\tcontext.availableTools,\n\t\t\t\tcontext.metadata,\n\t\t\t\tidentityContext,\n\t\t\t\tcustomBrainPrompt,\n\t\t\t)\n\n\t\t\tconst openaiMessages = convertMessages(systemPrompt, context.messages)\n\t\t\tconst openaiTools = convertTools(context.availableTools)\n\n\t\t\tconst response = await openai.chat.completions.create({\n\t\t\t\tmodel,\n\t\t\t\tmessages: openaiMessages,\n\t\t\t\t...(openaiTools.length > 0 ? { tools: openaiTools } : {}),\n\t\t\t})\n\n\t\t\tconst durationMs = Date.now() - start\n\t\t\tconsole.log(\n\t\t\t\t`[paw-xai] think completed in ${durationMs}ms (model: ${model})`,\n\t\t\t)\n\n\t\t\tconst choice = response.choices[0]\n\t\t\tif (!choice) {\n\t\t\t\treturn {\n\t\t\t\t\tactions: [],\n\t\t\t\t\tresponse: 'No response from OpenAI.',\n\t\t\t\t\tdone: true,\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst actions = parseToolCalls(choice.message)\n\n\t\t\tif (actions.length > 0) {\n\t\t\t\treturn {\n\t\t\t\t\tactions,\n\t\t\t\t\texecution: 'sequential',\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst text = choice.message.content || ''\n\n\t\t\treturn {\n\t\t\t\tactions: [],\n\t\t\t\tresponse: text,\n\t\t\t\tdone: choice.finish_reason === 'stop',\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconst durationMs = Date.now() - start\n\t\t\tconst message =\n\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\tconsole.error(\n\t\t\t\t`[paw-xai] think failed after ${durationMs}ms: ${message}`,\n\t\t\t)\n\n\t\t\treturn {\n\t\t\t\tactions: [],\n\t\t\t\tresponse: `Error communicating with OpenAI API: ${message}`,\n\t\t\t\tdone: true,\n\t\t\t}\n\t\t}\n\t},\n\n\tasync onLoad() {\n\t\tgetClient()\n\t\tcustomBrainPrompt = await loadBrainPrompt()\n\t\tidentityContext = await loadIdentityFiles()\n\t\tif (identityContext) {\n\t\t\tconsole.log('[paw-xai] loaded identity files (SOUL.md, USER.md, AGENT.md)')\n\t\t}\n\t\tconsole.log(\n\t\t\t`[paw-xai] loaded — model: ${model}`,\n\t\t)\n\t},\n\n\tasync onUnload() {\n\t\tclient = undefined\n\t\tconsole.log('[paw-xai] unloaded')\n\t},\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@openvole/paw-xai",
+  "version": "0.1.0",
+  "description": "Brain Paw powered by xAI Grok models",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "openai": "^4.73.0"
+  },
+  "peerDependencies": {
+    "@openvole/paw-sdk": "^0.3.0"
+  },
+  "devDependencies": {
+    "@openvole/paw-sdk": "^0.3.0",
+    "@types/node": "^22.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist",
+    "vole-paw.json",
+    "README.md"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openvole/pawhub",
+    "directory": "paws/paw-xai"
+  },
+  "keywords": [
+    "openvole",
+    "paw",
+    "xai",
+    "grok",
+    "brain",
+    "llm"
+  ]
+}

package/vole-paw.json

@@ -0,0 +1,16 @@
+{
+  "name": "@openvole/paw-xai",
+  "version": "0.1.0",
+  "description": "Brain Paw powered by xAI Grok models",
+  "entry": "./dist/index.js",
+  "brain": true,
+  "inProcess": false,
+  "transport": "ipc",
+  "tools": [],
+  "permissions": {
+    "network": ["api.x.ai"],
+    "listen": [],
+    "filesystem": [],
+    "env": ["XAI_API_KEY", "XAI_MODEL"]
+  }
+}