capacitor-mobile-claw 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-present Techxagon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,231 @@
+# Mobile Claw
+
+[![npm](https://img.shields.io/npm/v/capacitor-mobile-claw)](https://www.npmjs.com/package/capacitor-mobile-claw)
+[![CI](https://github.com/rogelioRuiz/capacitor-mobile-claw/actions/workflows/ci.yml/badge.svg)](https://github.com/rogelioRuiz/capacitor-mobile-claw/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+**On-device AI agent engine for mobile apps** — run Claude directly on your phone with file tools, code execution, git, and extensible MCP tool support.
+
+Mobile Claw is a [Capacitor](https://capacitorjs.com/) plugin that embeds a full AI agent runtime on Android and iOS via an embedded Node.js worker. No cloud relay, no proxy — the agent runs locally on the device and talks directly to the Anthropic API.
+
+> Built on [OpenClaw](https://github.com/openclaw/openclaw) and the [Pi framework](https://www.npmjs.com/package/@mariozechner/pi-ai) by [Mario Zechner](https://github.com/badlogic). Pi's philosophy of *"what you leave out matters more than what you put in"* — just 4 core tools and a system prompt under 1,000 tokens — is what makes running a capable AI agent on a phone possible at all.
+
+## Try It — Reference App
+
+The fastest way to see Mobile Claw in action is the included reference app — a complete Vue 3 chat UI with streaming, tool approval, session management, and all features wired up.
+
+<p align="center">
+  <img src="docs/screenshots/setup.png" width="240" alt="Setup screen — engine ready, auth config" />
+  &nbsp;&nbsp;
+  <img src="docs/screenshots/chat.png" width="240" alt="Chat — code execution with JavaScript and Python test results" />
+  &nbsp;&nbsp;
+  <img src="docs/screenshots/settings.png" width="240" alt="Settings — API key, workspace editor, sessions" />
+</p>
+
+### Prerequisites
+
+- [Node.js](https://nodejs.org/) >= 20
+- [Android Studio](https://developer.android.com/studio) (for Android) or [Xcode](https://developer.apple.com/xcode/) (for iOS)
+- An Anthropic API key or Claude Max subscription
+
+### Run on Android
+
+```bash
+# Clone the repo
+git clone https://github.com/rogelioRuiz/capacitor-mobile-claw.git
+cd capacitor-mobile-claw
+
+# Install plugin dependencies
+npm install
+
+# Set up the reference app
+cd examples/reference-app
+npm install
+
+# Build the web app
+npm run build
+
+# Add the Android platform (first time only)
+npx cap add android
+
+# Sync web assets → native project
+npx cap sync android
+
+# Open in Android Studio — build & run from there
+npx cap open android
+```
+
+### Run on iOS
+
+```bash
+cd examples/reference-app
+npx cap add ios
+npx cap sync ios
+npx cap open ios
+# Build & run from Xcode
+```
+
+Once the app launches, enter your Anthropic API key in settings and start chatting. The agent can read/write files, run code, use git, and call any registered MCP device tools — all on-device.
+
+## How It Works
+
+```
+┌─────────────────────────────────────────────────────┐
+│  Your App (Vue, React, Svelte, vanilla JS)          │
+│  ┌───────────────────────────────────────────────┐  │
+│  │  MobileClawEngine (framework-agnostic)        │  │
+│  │  - sendMessage() / stopTurn() / steerAgent()  │  │
+│  │  - readFile() / writeFile()                   │  │
+│  │  - listSessions() / resumeSession()           │  │
+│  │  - invokeTool()                               │  │
+│  └──────────────────┬────────────────────────────┘  │
+│                     │ Bridge Protocol (IPC)          │
+│  ┌──────────────────▼────────────────────────────┐  │
+│  │  Embedded Node.js Worker (Capacitor-NodeJS)   │  │
+│  │  ┌──────────────┐  ┌──────────────────────┐   │  │
+│  │  │ Pi Agent     │  │ MCP Server           │   │  │
+│  │  │ (@mariozechner│  │ - Bridge transport   │   │  │
+│  │  │  /pi-ai)     │  │ - STOMP transport    │   │  │
+│  │  │              │  │ - Custom tools (BYO) │   │  │
+│  │  └──────┬───────┘  └──────────────────────┘   │  │
+│  │         │                                      │  │
+│  │         ▼ Anthropic Messages API               │  │
+│  └────────────────────────────────────────────────┘  │
+└─────────────────────────────────────────────────────┘
+```
+
+## Install in Your Own App
+
+```bash
+npm install capacitor-mobile-claw
+```
+
+Peer dependencies:
+```bash
+npm install @capacitor/core @capacitor/device
+# capacitor-nodejs is distributed via GitHub Releases (not npm):
+npm install https://github.com/hampoelz/Capacitor-NodeJS/releases/download/v1.0.0-beta.9/capacitor-nodejs.tgz
+# Optional (for MCP device tools):
+npm install @modelcontextprotocol/sdk
+```
+
+### Basic Usage
+
+```typescript
+import { MobileClawEngine } from 'capacitor-mobile-claw'
+
+const engine = new MobileClawEngine()
+
+// Initialize the embedded Node.js worker
+await engine.init()
+
+// Listen for streaming text
+engine.addListener('agentEvent', (event) => {
+  if (event.eventType === 'text_delta') {
+    process.stdout.write(event.data.text)
+  }
+})
+
+// Send a message
+await engine.sendMessage('What files are in my workspace?')
+```
+
+### With Custom MCP Tools
+
+```typescript
+import { MobileClawEngine } from 'capacitor-mobile-claw'
+import type { DeviceTool } from 'capacitor-mobile-claw/mcp/tools/types'
+
+const myTools: DeviceTool[] = [
+  {
+    name: 'get_battery',
+    description: 'Get current battery level and charging state',
+    inputSchema: { type: 'object', properties: {} },
+    handler: async () => ({ level: 0.85, charging: true }),
+  },
+]
+
+const engine = new MobileClawEngine()
+
+await engine.init({
+  tools: myTools,
+  enableBridge: true,
+})
+```
+
+## Features
+
+- **Real-time streaming** — text deltas, tool use, and thinking events
+- **Multi-turn conversations** — session persistence with JSONL transcripts
+- **OAuth PKCE + API key** — sign in with Claude Max or use a direct API key
+- **File tools** — sandboxed read/write/edit/find/grep
+- **Code execution** — JavaScript (sandbox) + Python (Pyodide/WebAssembly)
+- **Git** — clone, commit, push, diff via isomorphic-git
+- **MCP device tools** — extensible via Model Context Protocol
+- **Tool approval gate** — approve/deny tool executions before they run
+- **Agent steering** — inject follow-up instructions into a running turn
+
+## API Reference
+
+### MobileClawEngine
+
+| Method | Description |
+|--------|-------------|
+| `init(options?)` | Start the Node.js worker and MCP bridge |
+| `sendMessage(prompt, agentId?)` | Send a prompt to the agent |
+| `stopTurn()` | Cancel the running agent turn |
+| `approveTool(toolCallId, approved)` | Approve/deny a tool execution |
+| `steerAgent(text)` | Inject a follow-up instruction |
+| `updateConfig(config)` | Update worker config (auth, model, etc.) |
+| `getAuthStatus()` | Get current auth profile status |
+| `getModels()` | List available models |
+| `readFile(path)` / `writeFile(path, content)` | Workspace file operations |
+| `listSessions()` / `resumeSession(key)` | Session management |
+| `invokeTool(toolName, args?)` | Call a tool directly |
+| `addListener(eventName, handler)` | Subscribe to agent events |
+
+### Events
+
+| Event | Fired When |
+|-------|-----------|
+| `agentEvent` | Text delta, tool use, tool result, or thinking update |
+| `agentCompleted` | Agent turn finished (includes token usage) |
+| `agentError` | Agent execution failed |
+| `toolApprovalRequest` | Agent wants to run a tool (approval gate) |
+| `workerReady` | Node.js worker initialized |
+
+## Documentation
+
+- [Architecture](docs/architecture.md) — system design and layer breakdown
+- [Bridge Protocol](docs/bridge-protocol.md) — UI-to-Worker message reference
+- [Creating Device Tools](docs/creating-tools.md) — how to build custom MCP tools
+
+## Related Packages
+
+- [capacitor-mobile-claw-device-tools](https://github.com/rogelioRuiz/capacitor-mobile-claw-device-tools) — 64+ pre-built device tools (camera, clipboard, sensors, SSH, etc.)
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup, workflow, and guidelines.
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|-----------|
+| Mobile framework | [Capacitor 8](https://capacitorjs.com/) |
+| Agent core | [Pi](https://www.npmjs.com/package/@mariozechner/pi-ai) by Mario Zechner |
+| Embedded runtime | [Capacitor-NodeJS](https://github.com/hampoelz/Capacitor-NodeJS) |
+| Tool protocol | [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) |
+| LLM provider | [Anthropic Claude](https://anthropic.com/) |
+| Git | [isomorphic-git](https://isomorphic-git.org/) |
+| Python | [Pyodide](https://pyodide.org/) (CPython via WebAssembly) |
+| Type system | TypeScript (strict mode) |
+| Tests | [Vitest](https://vitest.dev/) |
+
+## Acknowledgments
+
+Mobile Claw is built on [OpenClaw](https://github.com/openclaw/openclaw) and the [Pi framework](https://www.npmjs.com/package/@mariozechner/pi-ai) by [Mario Zechner](https://github.com/badlogic) (creator of [libGDX](https://libgdx.com/)). Pi demonstrated that a truly capable AI agent doesn't need a massive framework — just four well-designed tools and a focused system prompt. That minimalism is what makes on-device mobile execution feasible.
+
+## License
+
+MIT

package/dist/esm/definitions.d.ts

@@ -0,0 +1,226 @@
+/**
+ * MobileClaw Capacitor Plugin — Public API definitions.
+ *
+ * This is a headless (no-UI) plugin that embeds an AI agent engine
+ * on-device via Capacitor-NodeJS. The agent has file tools, code
+ * execution, git integration, and 64+ MCP device tools.
+ *
+ * Usage:
+ *   import { MobileClaw } from 'capacitor-mobile-claw'
+ *
+ *   await MobileClaw.init()
+ *   const key = await MobileClaw.sendMessage('Hello agent')
+ *   MobileClaw.onEvent('text_delta', (e) => console.log(e.text))
+ */
+export interface MobileClawPlugin {
+    /**
+     * Initialize the embedded Node.js worker and MCP bridge.
+     * Must be called once before any other method.
+     * Resolves when the worker sends 'worker.ready'.
+     */
+    init(options?: MobileClawInitOptions): Promise<MobileClawReadyInfo>;
+    /**
+     * Whether the plugin has been initialized and the worker is ready.
+     */
+    isReady(): Promise<{
+        ready: boolean;
+    }>;
+    /**
+     * Send a prompt to the agent. Returns the session key for this conversation.
+     * Reuses the current session key for multi-turn conversations.
+     */
+    sendMessage(options: {
+        prompt: string;
+        agentId?: string;
+    }): Promise<{
+        sessionKey: string;
+    }>;
+    /**
+     * Stop the currently running agent turn.
+     */
+    stopTurn(): Promise<void>;
+    /**
+     * Approve or deny a tool execution request from the agent.
+     */
+    approveTool(options: {
+        toolCallId: string;
+        approved: boolean;
+    }): Promise<void>;
+    /**
+     * Send a steering/follow-up message to a running agent turn.
+     */
+    steerAgent(options: {
+        text: string;
+    }): Promise<void>;
+    /**
+     * Update worker configuration (e.g. set API key, provider, model).
+     */
+    updateConfig(options: {
+        config: Record<string, unknown>;
+    }): Promise<void>;
+    /**
+     * Get auth profile status from the worker.
+     */
+    getAuthStatus(): Promise<AuthStatus>;
+    /**
+     * Read a file from the agent workspace.
+     */
+    readFile(options: {
+        path: string;
+    }): Promise<FileReadResult>;
+    /**
+     * Write a file to the agent workspace.
+     */
+    writeFile(options: {
+        path: string;
+        content: string;
+    }): Promise<void>;
+    /**
+     * List past sessions from the worker's JSONL store.
+     */
+    listSessions(options?: {
+        agentId?: string;
+    }): Promise<SessionListResult>;
+    /**
+     * Get the most recent session.
+     */
+    getLatestSession(options?: {
+        agentId?: string;
+    }): Promise<SessionInfo | null>;
+    /**
+     * Load message history for a session from JSONL transcript.
+     */
+    loadSessionHistory(options: {
+        sessionKey: string;
+        agentId?: string;
+    }): Promise<SessionHistoryResult>;
+    /**
+     * Resume a previous session (hydrate agent with saved messages).
+     */
+    resumeSession(options: {
+        sessionKey: string;
+        agentId?: string;
+    }): Promise<void>;
+    /**
+     * Clear the current conversation (local state; transcripts preserved).
+     */
+    clearConversation(): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Set the current session key (e.g. for resuming a specific session).
+     */
+    setSessionKey(options: {
+        sessionKey: string;
+    }): Promise<void>;
+    /**
+     * Get the current session key.
+     */
+    getSessionKey(): Promise<{
+        sessionKey: string | null;
+    }>;
+    /**
+     * Invoke a worker tool directly (local file tools or MCP device tools).
+     * Useful for testing or for direct tool access without running the agent.
+     */
+    invokeTool(options: {
+        toolName: string;
+        args?: Record<string, unknown>;
+    }): Promise<ToolInvokeResult>;
+    /**
+     * Register a listener for agent events.
+     * Returns an unsubscribe function.
+     */
+    addListener(eventName: MobileClawEventName, handler: (event: MobileClawEvent) => void): Promise<{
+        remove: () => Promise<void>;
+    }>;
+    /**
+     * Remove all listeners for an event type.
+     */
+    removeAllListeners(eventName?: MobileClawEventName): Promise<void>;
+}
+import type { DeviceTool } from './mcp/tools/types';
+export interface MobileClawInitOptions {
+    /** Enable bridge MCP transport (in-process device tools). Default: true. */
+    enableBridge?: boolean;
+    /** Enable STOMP MCP transport (remote access). Default: false. */
+    enableStomp?: boolean;
+    /** Custom STOMP config when enableStomp is true. */
+    stompConfig?: StompConfig;
+    /** MCP device tools to register. Pass from an external tools package. */
+    tools?: DeviceTool[];
+    /** Worker startup timeout in ms. Default: 60000. */
+    workerTimeout?: number;
+}
+export interface StompConfig {
+    brokerURL: string;
+    login: string;
+    passcode: string;
+    deviceId?: string;
+    reconnectDelay?: number;
+}
+export interface MobileClawReadyInfo {
+    nodeVersion: string;
+    openclawRoot: string;
+    mcpToolCount: number;
+}
+export interface AuthStatus {
+    hasKey: boolean;
+    masked: string;
+}
+export interface FileReadResult {
+    path: string;
+    content: string;
+    error?: string;
+}
+export interface SessionInfo {
+    sessionKey: string;
+    sessionId?: string;
+    updatedAt: number;
+    model?: string;
+    totalTokens?: number;
+}
+export interface SessionListResult {
+    agentId: string;
+    sessions: SessionInfo[];
+}
+export interface SessionHistoryResult {
+    sessionKey: string;
+    messages: unknown[];
+    error?: string;
+}
+export interface ToolInvokeResult {
+    toolName: string;
+    result?: unknown;
+    error?: string;
+}
+export type MobileClawEventName = 'agentEvent' | 'agentCompleted' | 'agentError' | 'toolApprovalRequest' | 'workerReady';
+export type MobileClawEvent = AgentEvent | AgentCompletedEvent | AgentErrorEvent | ToolApprovalRequestEvent | WorkerReadyEvent;
+export interface AgentEvent {
+    eventType: 'text_delta' | 'tool_use' | 'tool_result' | 'thinking' | 'error';
+    data: Record<string, unknown>;
+}
+export interface AgentCompletedEvent {
+    sessionKey: string;
+    usage?: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    durationMs: number;
+}
+export interface AgentErrorEvent {
+    error: string;
+    code?: string;
+}
+export interface ToolApprovalRequestEvent {
+    toolCallId: string;
+    toolName: string;
+    args: Record<string, unknown>;
+}
+export interface WorkerReadyEvent {
+    nodeVersion: string;
+    openclawRoot: string;
+    mcpToolCount?: number;
+}
+//# sourceMappingURL=definitions.d.ts.map

package/dist/esm/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"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"}

package/dist/esm/definitions.js

@@ -0,0 +1,16 @@
+/**
+ * MobileClaw Capacitor Plugin — Public API definitions.
+ *
+ * This is a headless (no-UI) plugin that embeds an AI agent engine
+ * on-device via Capacitor-NodeJS. The agent has file tools, code
+ * execution, git integration, and 64+ MCP device tools.
+ *
+ * Usage:
+ *   import { MobileClaw } from 'capacitor-mobile-claw'
+ *
+ *   await MobileClaw.init()
+ *   const key = await MobileClaw.sendMessage('Hello agent')
+ *   MobileClaw.onEvent('text_delta', (e) => console.log(e.text))
+ */
+export {};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/esm/engine.d.ts

@@ -0,0 +1,93 @@
+/**
+ * MobileClawEngine — Framework-agnostic core engine.
+ *
+ * This is the headless implementation of the MobileClaw plugin.
+ * It manages the embedded Node.js worker, bridge communication,
+ * MCP server lifecycle, and exposes all plugin API methods.
+ *
+ * No Vue, React, or any UI framework dependency.
+ */
+import type { AuthStatus, FileReadResult, MobileClawEvent, MobileClawEventName, MobileClawInitOptions, MobileClawReadyInfo, SessionHistoryResult, SessionInfo, SessionListResult, ToolInvokeResult } from './definitions';
+import { McpServerManager } from './mcp/mcp-server-manager';
+type MessageHandler = (msg: any) => void;
+export declare class MobileClawEngine {
+    private _ready;
+    private _available;
+    private _nodeVersion;
+    private _openclawRoot;
+    private _mcpToolCount;
+    private _loading;
+    private _error;
+    private _currentSessionKey;
+    private nodePlugin;
+    private listeners;
+    private initPromise;
+    private _mcpManager;
+    get ready(): boolean;
+    get available(): boolean;
+    get nodeVersion(): string | null;
+    get openclawRoot(): string | null;
+    get mcpToolCount(): number;
+    get loading(): boolean;
+    get error(): string | null;
+    get currentSessionKey(): string | null;
+    /** Access the MCP server manager for status, restart, etc. */
+    get mcpManager(): McpServerManager | null;
+    init(options?: MobileClawInitOptions): Promise<MobileClawReadyInfo>;
+    private _doInit;
+    isReady(): Promise<{
+        ready: boolean;
+    }>;
+    send(message: Record<string, unknown>): Promise<void>;
+    /** Internal message listener (returns unsubscribe fn) */
+    private _onMessage;
+    private _dispatch;
+    sendMessage(prompt: string, agentId?: string, options?: {
+        model?: string;
+    }): Promise<{
+        sessionKey: string;
+    }>;
+    getModels(): Promise<Array<{
+        id: string;
+        name: string;
+        description: string;
+        default?: boolean;
+    }>>;
+    stopTurn(): Promise<void>;
+    approveTool(toolCallId: string, approved: boolean): Promise<void>;
+    steerAgent(text: string): Promise<void>;
+    updateConfig(config: Record<string, unknown>): Promise<void>;
+    exchangeOAuthCode(tokenUrl: string, body: Record<string, string>): Promise<any>;
+    getAuthStatus(): Promise<AuthStatus>;
+    readFile(path: string): Promise<FileReadResult>;
+    writeFile(path: string, content: string): Promise<void>;
+    listSessions(agentId?: string): Promise<SessionListResult>;
+    getLatestSession(agentId?: string): Promise<SessionInfo | null>;
+    loadSessionHistory(sessionKey: string, agentId?: string): Promise<SessionHistoryResult>;
+    resumeSession(sessionKey: string, agentId?: string): Promise<void>;
+    clearConversation(): Promise<{
+        success: boolean;
+    }>;
+    setSessionKey(sessionKey: string): Promise<void>;
+    getSessionKey(): Promise<{
+        sessionKey: string | null;
+    }>;
+    invokeTool(toolName: string, args?: Record<string, unknown>): Promise<ToolInvokeResult>;
+    /**
+     * Map from Capacitor event names to bridge message types.
+     */
+    private static readonly EVENT_MAP;
+    addListener(eventName: MobileClawEventName, handler: (event: MobileClawEvent) => void): {
+        remove: () => void;
+    };
+    removeAllListeners(eventName?: MobileClawEventName): void;
+    /**
+     * Register a handler for a specific bridge message type.
+     * Useful for framework wrappers (Vue, React) that need raw bridge access.
+     */
+    onMessage(type: string, handler: MessageHandler, opts?: {
+        once?: boolean;
+    }): () => void;
+}
+export {};
+//# sourceMappingURL=engine.d.ts.map

package/dist/esm/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/engine.ts"],"names":[],"mappings":"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"}