@openvole/paw-gemini 0.1.0

package/README.md

@@ -0,0 +1,40 @@
+# @openvole/paw-gemini
+
+**Brain Paw powered by Google Gemini.**
+
+[![npm](https://img.shields.io/npm/v/@openvole/paw-gemini)](https://www.npmjs.com/package/@openvole/paw-gemini)
+
+Part of [OpenVole](https://github.com/openvole/openvole) — the microkernel AI agent framework.
+
+## Install
+
+```bash
+npm install @openvole/paw-gemini
+```
+
+## Config
+
+```json
+{
+  "name": "@openvole/paw-gemini",
+  "allow": {
+    "network": ["generativelanguage.googleapis.com"],
+    "env": ["GEMINI_API_KEY", "GEMINI_MODEL"]
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `GEMINI_API_KEY` | Google Gemini API key |
+| `GEMINI_MODEL` | Model to use (e.g. `gemini-pro`) |
+
+## Brain
+
+Implements the Think phase — receives the conversation context and registered tools, returns the next assistant message and any tool calls. Connects to the Google Gemini API.
+
+## 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,293 @@
+// src/index.ts
+import { definePaw } from "@openvole/paw-sdk";
+
+// src/paw.ts
+import * as fs from "fs/promises";
+import * as path from "path";
+import {
+  GoogleGenerativeAI,
+  SchemaType
+} from "@google/generative-ai";
+var genAI;
+var generativeModel;
+var model = "gemini-2.0-flash";
+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-gemini] 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 getModel() {
+  if (!generativeModel) {
+    const apiKey = process.env.GEMINI_API_KEY;
+    if (!apiKey) {
+      throw new Error("GEMINI_API_KEY environment variable is required");
+    }
+    model = process.env.GEMINI_MODEL || "gemini-2.0-flash";
+    genAI = new GoogleGenerativeAI(apiKey);
+    generativeModel = genAI.getGenerativeModel({ model });
+  }
+  return generativeModel;
+}
+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(messages) {
+  const result = [];
+  for (const msg of messages) {
+    switch (msg.role) {
+      case "user":
+        result.push({
+          role: "user",
+          parts: [{ text: msg.content }]
+        });
+        break;
+      case "brain":
+        result.push({
+          role: "model",
+          parts: [{ text: msg.content }]
+        });
+        break;
+      case "tool_result":
+        result.push({
+          role: "function",
+          parts: [
+            {
+              functionResponse: {
+                name: msg.toolName || "unknown",
+                response: { result: msg.content }
+              }
+            }
+          ]
+        });
+        break;
+      case "error":
+        result.push({
+          role: "function",
+          parts: [
+            {
+              functionResponse: {
+                name: msg.toolName || "unknown",
+                response: { error: msg.content }
+              }
+            }
+          ]
+        });
+        break;
+    }
+  }
+  return result;
+}
+function convertTools(tools) {
+  if (tools.length === 0) return [];
+  const functionDeclarations = tools.map((tool) => ({
+    name: tool.name,
+    description: tool.description,
+    parameters: {
+      type: SchemaType.OBJECT,
+      properties: {}
+    }
+  }));
+  return [{ functionDeclarations }];
+}
+function parseToolCalls(parts) {
+  const actions = [];
+  for (const part of parts) {
+    if ("functionCall" in part && part.functionCall) {
+      actions.push({
+        tool: part.functionCall.name,
+        params: part.functionCall.args || {}
+      });
+    }
+  }
+  return actions;
+}
+var paw = {
+  name: "@openvole/paw-gemini",
+  version: "0.1.0",
+  description: "Brain Paw powered by Google Gemini",
+  brain: true,
+  async think(context) {
+    const geminiModel = getModel();
+    const start = Date.now();
+    try {
+      const systemPrompt = buildSystemPrompt(
+        context.activeSkills,
+        context.availableTools,
+        context.metadata,
+        identityContext,
+        customBrainPrompt
+      );
+      const geminiContents = convertMessages(context.messages);
+      const geminiTools = convertTools(context.availableTools);
+      const chat = geminiModel.startChat({
+        history: geminiContents.slice(0, -1),
+        systemInstruction: { role: "user", parts: [{ text: systemPrompt }] },
+        tools: geminiTools.length > 0 ? geminiTools : void 0
+      });
+      const lastContent = geminiContents[geminiContents.length - 1];
+      const lastParts = lastContent?.parts || [{ text: "" }];
+      const response = await chat.sendMessage(lastParts);
+      const durationMs = Date.now() - start;
+      console.log(
+        `[paw-gemini] think completed in ${durationMs}ms (model: ${model})`
+      );
+      const candidate = response.response.candidates?.[0];
+      if (!candidate) {
+        return {
+          actions: [],
+          response: "No response from Gemini.",
+          done: true
+        };
+      }
+      const actions = parseToolCalls(candidate.content.parts);
+      if (actions.length > 0) {
+        return {
+          actions,
+          execution: "sequential"
+        };
+      }
+      const text = candidate.content.parts.filter((part) => "text" in part).map((part) => part.text).join("");
+      return {
+        actions: [],
+        response: text,
+        done: true
+      };
+    } catch (error) {
+      const durationMs = Date.now() - start;
+      const message = error instanceof Error ? error.message : String(error);
+      console.error(
+        `[paw-gemini] think failed after ${durationMs}ms: ${message}`
+      );
+      return {
+        actions: [],
+        response: `Error communicating with Gemini API: ${message}`,
+        done: true
+      };
+    }
+  },
+  async onLoad() {
+    getModel();
+    customBrainPrompt = await loadBrainPrompt();
+    identityContext = await loadIdentityFiles();
+    if (identityContext) {
+      console.log("[paw-gemini] loaded identity files (SOUL.md, USER.md, AGENT.md)");
+    }
+    console.log(
+      `[paw-gemini] loaded \u2014 model: ${model}`
+    );
+  },
+  async onUnload() {
+    generativeModel = void 0;
+    genAI = void 0;
+    console.log("[paw-gemini] 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 {\n\tGoogleGenerativeAI,\n\ttype GenerativeModel,\n\ttype Content,\n\ttype Part,\n\ttype FunctionDeclaration,\n\ttype Tool as GeminiTool,\n\tSchemaType,\n} from '@google/generative-ai'\nimport type {\n\tPawDefinition,\n\tAgentContext,\n\tAgentPlan,\n\tAgentMessage,\n\tActiveSkill,\n\tPlannedAction,\n\tToolSummary,\n} from '@openvole/paw-sdk'\n\nlet genAI: GoogleGenerativeAI | undefined\nlet generativeModel: GenerativeModel | undefined\nlet model: string = 'gemini-2.0-flash'\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-gemini] 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 getModel(): GenerativeModel {\n\tif (!generativeModel) {\n\t\tconst apiKey = process.env.GEMINI_API_KEY\n\t\tif (!apiKey) {\n\t\t\tthrow new Error('GEMINI_API_KEY environment variable is required')\n\t\t}\n\t\tmodel = process.env.GEMINI_MODEL || 'gemini-2.0-flash'\n\t\tgenAI = new GoogleGenerativeAI(apiKey)\n\t\tgenerativeModel = genAI.getGenerativeModel({ model })\n\t}\n\treturn generativeModel\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\tmessages: AgentMessage[],\n): Content[] {\n\tconst result: Content[] = []\n\n\tfor (const msg of messages) {\n\t\tswitch (msg.role) {\n\t\t\tcase 'user':\n\t\t\t\tresult.push({\n\t\t\t\t\trole: 'user',\n\t\t\t\t\tparts: [{ text: msg.content }],\n\t\t\t\t})\n\t\t\t\tbreak\n\t\t\tcase 'brain':\n\t\t\t\tresult.push({\n\t\t\t\t\trole: 'model',\n\t\t\t\t\tparts: [{ text: msg.content }],\n\t\t\t\t})\n\t\t\t\tbreak\n\t\t\tcase 'tool_result':\n\t\t\t\tresult.push({\n\t\t\t\t\trole: 'function',\n\t\t\t\t\tparts: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tfunctionResponse: {\n\t\t\t\t\t\t\t\tname: (msg as any).toolName || 'unknown',\n\t\t\t\t\t\t\t\tresponse: { result: msg.content },\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t},\n\t\t\t\t\t],\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: 'function',\n\t\t\t\t\tparts: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tfunctionResponse: {\n\t\t\t\t\t\t\t\tname: (msg as any).toolName || 'unknown',\n\t\t\t\t\t\t\t\tresponse: { error: msg.content },\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t},\n\t\t\t\t\t],\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): GeminiTool[] {\n\tif (tools.length === 0) return []\n\n\tconst functionDeclarations: FunctionDeclaration[] = tools.map((tool) => ({\n\t\tname: tool.name,\n\t\tdescription: tool.description,\n\t\tparameters: {\n\t\t\ttype: SchemaType.OBJECT,\n\t\t\tproperties: {},\n\t\t},\n\t}))\n\n\treturn [{ functionDeclarations }]\n}\n\nfunction parseToolCalls(\n\tparts: Part[],\n): PlannedAction[] {\n\tconst actions: PlannedAction[] = []\n\n\tfor (const part of parts) {\n\t\tif ('functionCall' in part && part.functionCall) {\n\t\t\tactions.push({\n\t\t\t\ttool: part.functionCall.name,\n\t\t\t\tparams: (part.functionCall.args as Record<string, unknown>) || {},\n\t\t\t})\n\t\t}\n\t}\n\n\treturn actions\n}\n\nexport const paw: PawDefinition = {\n\tname: '@openvole/paw-gemini',\n\tversion: '0.1.0',\n\tdescription: 'Brain Paw powered by Google Gemini',\n\tbrain: true,\n\n\tasync think(context: AgentContext): Promise<AgentPlan> {\n\t\tconst geminiModel = getModel()\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 geminiContents = convertMessages(context.messages)\n\t\t\tconst geminiTools = convertTools(context.availableTools)\n\n\t\t\tconst chat = geminiModel.startChat({\n\t\t\t\thistory: geminiContents.slice(0, -1),\n\t\t\t\tsystemInstruction: { role: 'user', parts: [{ text: systemPrompt }] },\n\t\t\t\ttools: geminiTools.length > 0 ? geminiTools : undefined,\n\t\t\t})\n\n\t\t\t// Send the last message (or a default if empty)\n\t\t\tconst lastContent = geminiContents[geminiContents.length - 1]\n\t\t\tconst lastParts = lastContent?.parts || [{ text: '' }]\n\n\t\t\tconst response = await chat.sendMessage(lastParts)\n\n\t\t\tconst durationMs = Date.now() - start\n\t\t\tconsole.log(\n\t\t\t\t`[paw-gemini] think completed in ${durationMs}ms (model: ${model})`,\n\t\t\t)\n\n\t\t\tconst candidate = response.response.candidates?.[0]\n\t\t\tif (!candidate) {\n\t\t\t\treturn {\n\t\t\t\t\tactions: [],\n\t\t\t\t\tresponse: 'No response from Gemini.',\n\t\t\t\t\tdone: true,\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tconst actions = parseToolCalls(candidate.content.parts)\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 = candidate.content.parts\n\t\t\t\t.filter((part): part is Part & { text: string } => 'text' in part)\n\t\t\t\t.map((part) => part.text)\n\t\t\t\t.join('')\n\n\t\t\treturn {\n\t\t\t\tactions: [],\n\t\t\t\tresponse: text,\n\t\t\t\tdone: true,\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-gemini] 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 Gemini API: ${message}`,\n\t\t\t\tdone: true,\n\t\t\t}\n\t\t}\n\t},\n\n\tasync onLoad() {\n\t\tgetModel()\n\t\tcustomBrainPrompt = await loadBrainPrompt()\n\t\tidentityContext = await loadIdentityFiles()\n\t\tif (identityContext) {\n\t\t\tconsole.log('[paw-gemini] loaded identity files (SOUL.md, USER.md, AGENT.md)')\n\t\t}\n\t\tconsole.log(\n\t\t\t`[paw-gemini] loaded — model: ${model}`,\n\t\t)\n\t},\n\n\tasync onUnload() {\n\t\tgenerativeModel = undefined\n\t\tgenAI = undefined\n\t\tconsole.log('[paw-gemini] unloaded')\n\t},\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@openvole/paw-gemini",
+  "version": "0.1.0",
+  "description": "Brain Paw powered by Google Gemini",
+  "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": {
+    "@google/generative-ai": "^0.21.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "@openvole/paw-sdk": "^0.1.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-gemini"
+  },
+  "keywords": [
+    "openvole",
+    "paw",
+    "gemini",
+    "google",
+    "brain",
+    "llm"
+  ],
+  "peerDependencies": {
+    "@openvole/paw-sdk": "^0.1.0"
+  }
+}

package/vole-paw.json

@@ -0,0 +1,16 @@
+{
+  "name": "@openvole/paw-gemini",
+  "version": "0.1.0",
+  "description": "Brain Paw powered by Google Gemini",
+  "entry": "./dist/index.js",
+  "brain": true,
+  "inProcess": false,
+  "transport": "ipc",
+  "tools": [],
+  "permissions": {
+    "network": ["generativelanguage.googleapis.com"],
+    "listen": [],
+    "filesystem": [],
+    "env": ["GEMINI_API_KEY", "GEMINI_MODEL"]
+  }
+}