openclaw-voice 1.0.2 → 1.0.4

package/README.md

@@ -12,7 +12,7 @@ Speak -> edit -> send -> stream response.
 
 <p align="center">
   <video
-    src="https://github.com/user-attachments/assets/65f799f3-c87b-4c13-8b5f-23491efd5ec5"
+    src="https://github.com/user-attachments/assets/17678911-a359-490c-a529-67e9b38ff4bb"
     poster="https://raw.githubusercontent.com/kyaukyuai/openclaw-voice/main/docs/screenshots/response-light.png"
     controls
     playsinline
@@ -24,14 +24,14 @@ Speak -> edit -> send -> stream response.
 </p>
 
 <p align="center">
-  <a href="https://github.com/user-attachments/assets/65f799f3-c87b-4c13-8b5f-23491efd5ec5"><strong>Watch demo video (MP4)</strong></a>
+  <a href="https://github.com/user-attachments/assets/17678911-a359-490c-a529-67e9b38ff4bb"><strong>Watch demo video (MP4)</strong></a>
 </p>
 
 ## Why OpenClaw Voice
 
 - Fast voice-to-chat workflow optimized for iOS
 - Reusable `GatewayClient` SDK on npm (`openclaw-voice`)
-- Streaming response handling with reconnect and pairing flow support
+- Streaming + recovery handling for unstable mobile networks
 - Secure device identity signing via Ed25519
 
 ## Run The App (5 Minutes)
@@ -111,35 +111,38 @@ Notes:
     <td align="center" width="25%">
       <strong>Idle</strong><br>
       <sub>Connected, waiting for input</sub><br><br>
-      <img src="https://raw.githubusercontent.com/kyaukyuai/openclaw-voice/main/docs/screenshots/idle.png" width="200" alt="Idle state" />
+      <img src="https://raw.githubusercontent.com/kyaukyuai/openclaw-voice/main/docs/screenshots/idle.png" width="230" alt="Idle state" />
     </td>
     <td align="center" width="25%">
       <strong>Ready to Send</strong><br>
       <sub>Transcript ready, tap to send</sub><br><br>
-      <img src="https://raw.githubusercontent.com/kyaukyuai/openclaw-voice/main/docs/screenshots/ready-to-send.png" width="200" alt="Ready to send state" />
+      <img src="https://raw.githubusercontent.com/kyaukyuai/openclaw-voice/main/docs/screenshots/ready-to-send.png" width="230" alt="Ready to send state" />
     </td>
     <td align="center" width="25%">
       <strong>Sending</strong><br>
       <sub>Waiting for Gateway response</sub><br><br>
-      <img src="https://raw.githubusercontent.com/kyaukyuai/openclaw-voice/main/docs/screenshots/sending.png" width="200" alt="Sending state" />
+      <img src="https://raw.githubusercontent.com/kyaukyuai/openclaw-voice/main/docs/screenshots/sending.png" width="230" alt="Sending state" />
     </td>
     <td align="center" width="25%">
-      <strong>Response (Light)</strong><br>
+      <strong>Response</strong><br>
       <sub>Streamed response displayed</sub><br><br>
-      <img src="https://raw.githubusercontent.com/kyaukyuai/openclaw-voice/main/docs/screenshots/response-light.png" width="200" alt="Response in light theme" />
+      <img src="https://raw.githubusercontent.com/kyaukyuai/openclaw-voice/main/docs/screenshots/response-light.png" width="230" alt="Response in light theme" />
     </td>
   </tr>
 </table>
 
 ## Features
 
-- Speech-to-text input using `expo-speech-recognition`
-- Editable transcript before sending
-- OpenClaw Gateway connection with URL + token/password
+- Voice input with hold-to-record (`expo-speech-recognition`)
+- Editable transcript and quick text insert buttons
+- Speech language switch (`ja-JP` / `en-US`)
+- Dedicated **Settings** screen and **Sessions** screen
+- Session management: list, switch, rename, pin/unpin, create
+- Gateway connect/reconnect flow with startup auto-connect retry
+- History sync and manual refresh with status notice
 - Streaming response rendering with per-turn states (`WAIT`, `OK`, `ERR`)
-- Auto reconnect support
-- Persistent settings for gateway URL, token/password, and theme
-- Local device identity generation/signing for gateway auth
+- Markdown response rendering with URL linkification
+- Persistent local settings and secure local device identity reuse
 
 ## Environment Variables
 
@@ -151,9 +154,10 @@ cp .env.example .env
 
 - `EXPO_PUBLIC_DEFAULT_GATEWAY_URL`
 - `EXPO_PUBLIC_DEFAULT_THEME` (`light` or `dark`)
+- `EXPO_PUBLIC_DEFAULT_SESSION_KEY` (default: `main`)
 - `EXPO_PUBLIC_GATEWAY_CLIENT_ID` (default: `openclaw-ios`)
 - `EXPO_PUBLIC_GATEWAY_DISPLAY_NAME` (default: `OpenClawVoice`)
-- `EXPO_PUBLIC_DEBUG_MODE` (`true` to show warnings in dev, default: `false`)
+- `EXPO_PUBLIC_DEBUG_MODE` (`true` to show dev warnings and runtime debug panel, default: `false`)
 
 ## Connection Defaults
 
@@ -172,8 +176,28 @@ Device identity is generated locally and reused when persistent storage is avail
 - `npm run android` - Build and run Android app
 - `npm run web` - Run web target
 - `npm run typecheck` - Run TypeScript checks
+- `npm run lint` - Run repository lint checks
+- `npm test` - Run regression tests (runtime logic + manifest switch)
+- `npm run smoke:pack-install` - Pack tarball and verify install/import from a clean temp app
 - `npm run build:package` - Build npm package files to `dist/`
 
+## Local Quality Checks
+
+Run before opening a PR:
+
+```bash
+npm run typecheck
+npm run lint
+npm test
+npm run smoke:pack-install
+```
+
+If your environment cannot access npm network during smoke test:
+
+```bash
+OPENCLAW_SMOKE_SKIP_INSTALL=1 npm run smoke:pack-install
+```
+
 ## Security Notes
 
 - Do not commit private gateway tokens.
@@ -182,6 +206,12 @@ Device identity is generated locally and reused when persistent storage is avail
 - Do not expose raw Gateway ports publicly.
 - Rotate credentials and keep TLS/server packages up to date.
 
+## Funding
+
+If this project helps your workflow, you can support maintenance on GitHub Sponsors:
+
+- [@kyaukyuai](https://github.com/sponsors/kyaukyuai)
+
 ## Troubleshooting
 
 See [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md).
@@ -195,16 +225,36 @@ See [CONTRIBUTING.md](CONTRIBUTING.md).
 GitHub Actions runs on push/PR:
 
 - Type check (`npm run typecheck`)
-- Lint (`npm run lint --if-present`)
-- Tests (`npm test --if-present`)
+- Package dry-run (`npm pack --dry-run`)
+- Manifest restore check after pack (`package.json.main` stays `index.ts`)
+- Lint (`npm run lint`)
+- Tests (`npm test`)
+- Tarball install smoke test (`npm run smoke:pack-install`)
 
 Issue/PR templates are in `.github/`.
 
 ## Publish to npm
 
+This repo uses two entry contexts:
+
+- App runtime: `package.json.main = index.ts`
+- npm package tarball: `main = ./dist/package.js` (switched automatically during pack/publish)
+
+Release steps:
+
 ```bash
-npm run build:package
+npm version patch --no-git-tag-version
+git add package.json package-lock.json
+git commit -m "chore(release): bump version to x.y.z"
+
+# Runs prepack/postpack hooks automatically:
+# - prepack: build + switch manifest for package publish
+# - postpack: restore app manifest
 npm publish --access public
+
+git tag vX.Y.Z
+git push -u origin main
+git push origin vX.Y.Z
 ```
 
 ## Acknowledgements

package/dist/openclaw/client.d.ts

@@ -53,6 +53,17 @@ export interface ModelsListResponse {
     count: number;
     models: ModelEntry[];
 }
+export interface SessionPatchInput {
+    label?: string;
+    displayName?: string;
+    subject?: string;
+    room?: string;
+    [key: string]: unknown;
+}
+export interface SessionDeleteTarget {
+    key: string;
+    sessionId?: string;
+}
 export declare class GatewayError extends Error {
     readonly code: string;
     readonly details?: unknown;
@@ -165,6 +176,21 @@ export declare class GatewayClient {
         limit?: number;
         includeGlobal?: boolean;
     }): Promise<SessionsListResponse>;
+    /**
+     * Patch session metadata (e.g. label/displayName).
+     * Uses a few payload shapes for compatibility with gateway variants.
+     */
+    sessionsPatch(sessionKey: string, patch: SessionPatchInput): Promise<void>;
+    /**
+     * Delete a session by key.
+     * Uses a few payload shapes for compatibility with gateway variants.
+     */
+    sessionsDelete(target: string | SessionDeleteTarget): Promise<void>;
+    /**
+     * Reset a session by key.
+     * Some gateway builds expose reset semantics where delete is unavailable.
+     */
+    sessionsReset(target: string | SessionDeleteTarget): Promise<void>;
     /**
      * Health check — returns true if gateway responds.
      */

package/dist/openclaw/client.js

@@ -268,6 +268,108 @@ class GatewayClient {
             limit: options === null || options === void 0 ? void 0 : options.limit,
         }, 15000);
     }
+    /**
+     * Patch session metadata (e.g. label/displayName).
+     * Uses a few payload shapes for compatibility with gateway variants.
+     */
+    async sessionsPatch(sessionKey, patch) {
+        const payloads = [
+            { sessionKey, patch },
+            { key: sessionKey, patch },
+            { sessionKey, ...patch },
+            { key: sessionKey, ...patch },
+        ];
+        let lastError;
+        for (const payload of payloads) {
+            try {
+                await this.request(protocol_1.GatewayMethods.SESSIONS_PATCH, payload, 10000);
+                return;
+            }
+            catch (error) {
+                lastError = error;
+                if (!(error instanceof GatewayError) || error.code !== "INVALID_REQUEST") {
+                    throw error;
+                }
+            }
+        }
+        throw lastError instanceof Error
+            ? lastError
+            : new Error("sessions.patch failed");
+    }
+    /**
+     * Delete a session by key.
+     * Uses a few payload shapes for compatibility with gateway variants.
+     */
+    async sessionsDelete(target) {
+        var _a;
+        const sessionKey = typeof target === "string" ? target.trim() : target.key.trim();
+        const sessionId = typeof target === "string" ? "" : ((_a = target.sessionId) !== null && _a !== void 0 ? _a : "").trim();
+        if (!sessionKey) {
+            throw new Error("sessions.delete requires a non-empty session key");
+        }
+        const payloads = [
+            { sessionKey },
+            { key: sessionKey },
+            { sessionKeys: [sessionKey] },
+            { keys: [sessionKey] },
+        ];
+        if (sessionId) {
+            payloads.unshift({ sessionKey, sessionId }, { key: sessionKey, sessionId }, { key: sessionKey, id: sessionId }, { sessionId }, { id: sessionId }, { sessionIds: [sessionId] }, { ids: [sessionId] });
+        }
+        let lastError;
+        for (const payload of payloads) {
+            try {
+                await this.request(protocol_1.GatewayMethods.SESSIONS_DELETE, payload, 10000);
+                return;
+            }
+            catch (error) {
+                lastError = error;
+                if (!(error instanceof GatewayError) || error.code !== "INVALID_REQUEST") {
+                    throw error;
+                }
+            }
+        }
+        throw lastError instanceof Error
+            ? lastError
+            : new Error("sessions.delete failed");
+    }
+    /**
+     * Reset a session by key.
+     * Some gateway builds expose reset semantics where delete is unavailable.
+     */
+    async sessionsReset(target) {
+        var _a;
+        const sessionKey = typeof target === "string" ? target.trim() : target.key.trim();
+        const sessionId = typeof target === "string" ? "" : ((_a = target.sessionId) !== null && _a !== void 0 ? _a : "").trim();
+        if (!sessionKey) {
+            throw new Error("sessions.reset requires a non-empty session key");
+        }
+        const payloads = [
+            { sessionKey },
+            { key: sessionKey },
+            { sessionKeys: [sessionKey] },
+            { keys: [sessionKey] },
+        ];
+        if (sessionId) {
+            payloads.unshift({ sessionKey, sessionId }, { key: sessionKey, sessionId }, { sessionId }, { id: sessionId }, { sessionIds: [sessionId] }, { ids: [sessionId] });
+        }
+        let lastError;
+        for (const payload of payloads) {
+            try {
+                await this.request(protocol_1.GatewayMethods.SESSIONS_RESET, payload, 10000);
+                return;
+            }
+            catch (error) {
+                lastError = error;
+                if (!(error instanceof GatewayError) || error.code !== "INVALID_REQUEST") {
+                    throw error;
+                }
+            }
+        }
+        throw lastError instanceof Error
+            ? lastError
+            : new Error("sessions.reset failed");
+    }
     /**
      * Health check — returns true if gateway responds.
      */
@@ -460,7 +562,7 @@ class GatewayClient {
         this.awaitingPairing = false;
         if (payload.decision === "approved") {
             // Retry connect now that we're approved
-            console.log("[GatewayClient] Device approved, retrying connect...");
+            console.info("[GatewayClient] Device approved, retrying connect...");
             this.sendConnectFrame();
         }
         else {

package/dist/openclaw/index.d.ts

@@ -1,4 +1,4 @@
-export { GatewayClient, GatewayError, generateIdempotencyKey, type ConnectionState, type GatewayClientOptions, type ModelEntry, type ModelsListResponse, } from './client';
+export { GatewayClient, GatewayError, generateIdempotencyKey, type ConnectionState, type GatewayClientOptions, type ModelEntry, type ModelsListResponse, type SessionPatchInput, } from './client';
 export { loadOrCreateIdentity, signPayload, publicKeyBase64Url, buildSignaturePayload, type StoredDeviceIdentity, } from './device-identity';
 export { type Storage, storage, setStorage } from './storage';
 export { GATEWAY_PROTOCOL_VERSION, GatewayEvents, GatewayMethods, ErrorCode, type GatewayEventName, type RequestFrame, type ResponseFrame, type EventFrame, type GatewayFrame, type ErrorShape, type ConnectChallenge, type ClientInfo, type DeviceIdentity, type ConnectAuth, type ConnectParams, type HelloOk, type HelloOkAuth, type HelloOkPolicy, type TickPayload, type HealthPayload, type ChatEventPayload, type AgentEventPayload, type SeqGapPayload, type ShutdownPayload, type ChatMessageContentType, type ChatMessageContent, type ChatUsage, type ChatUsageCost, type ChatMessage, type ChatAttachmentPayload, type ChatHistoryPayload, type ChatSendResponse, type SessionEntry, type SessionsListResponse, type SessionsDefaults, type SessionPreviewItem, type SessionPreviewEntry, type SessionsPreviewPayload, type StateVersion, type Snapshot, type PresenceEntry, } from './protocol';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-voice",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "main": "./dist/package.js",
   "types": "./dist/package.d.ts",
   "exports": {
@@ -23,7 +23,10 @@
     "ios": "expo run:ios",
     "web": "expo start --web",
     "typecheck": "tsc --noEmit",
+    "lint": "node scripts/lint.mjs",
+    "test": "node --test tests/*.test.mjs",
     "build:package": "tsc -p tsconfig.package.json",
+    "smoke:pack-install": "node scripts/smoke-pack-install.mjs",
     "prepare:publish-manifest": "node scripts/switch-package-manifest.mjs prepare",
     "restore:publish-manifest": "node scripts/switch-package-manifest.mjs restore",
     "prepack": "npm run build:package && npm run prepare:publish-manifest",
@@ -36,6 +39,7 @@
     "base-64": "^1.0.0",
     "expo": "~54.0.33",
     "expo-crypto": "^15.0.8",
+    "expo-haptics": "^15.0.8",
     "expo-secure-store": "^15.0.8",
     "expo-speech-recognition": "^3.1.0",
     "expo-status-bar": "~3.0.9",