@open-pets/dsh 4.0.0 → 4.1.0

package/README.md

@@ -0,0 +1,55 @@
+# @open-pets/dsh
+
+Cordis plugin connecting the [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness) agent runtime directly to the [OpenPets](https://openpets.dev) desktop companion.
+
+## Features
+
+- **Lifecycle Reactions**: Synchronizes DSH agent status (`running` ⇄ `idle`), errors, and approval requests with companion emotions.
+- **Status Stream Awareness**: Extracts `⏵` status lines from assistant stream chunks and displays them in companion speech bubbles.
+- **Tool Operation Reactions**: Maps `bash` executions (`running`), `edit`/`write` operations (`editing`), and `read` operations (`working`).
+- **Toggleable Configuration**: Enable or disable per profile or dynamically via Cordis plugin configuration.
+- **Safe & Fail-safe**: Automatically sanitizes paths and messages, strips URLs/secrets, throttles speech rate, and isolates IPC failures so the agent loop never stalls.
+
+## Installation
+
+Add to your DSH profile or user configuration (`~/.dsh/cordis.patch.yml`):
+
+```yaml
+- insert:
+    - id: plugin-openpets-dsh
+      name: '@open-pets/dsh'
+      disabled: false
+      config:
+        enabled: true
+        minSpeechIntervalMs: 1200
+        enableStatusLineStream: true
+        enableToolEvents: true
+        enableApprovalEvents: true
+```
+
+## Configuration Options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `enabled` | `boolean` | `true` | Master switch to enable or disable listener registration. |
+| `minSpeechIntervalMs` | `number` | `1200` | Minimum interval (in ms) between speech bubble notifications. |
+| `enableStatusLineStream` | `boolean` | `true` | Forward `⏵` status lines from assistant stream chunks. |
+| `enableToolEvents` | `boolean` | `true` | React to tool executions (`bash`, `edit`, `write`, `read`). |
+| `enableApprovalEvents` | `boolean` | `true` | Announce when an approval request is waiting for human permission. |
+
+## Event Mappings
+
+| DSH Event | OpenPets Reaction | Speech Behavior |
+|---|---|---|
+| `agent/status: running` | `thinking` | Curated thinking speech |
+| `agent/status: idle` | `success` | Curated success speech (suppressed for 5s after errors) |
+| `agent/error` | `error` | Curated error speech |
+| `approval/request` | `waiting` | Curated permission speech |
+| `agent/assistant-stream` | `working` | Sanitized `⏵` status line |
+| `tools/result (bash)` | `running` | Sanitized tool description |
+| `tools/result (edit/write)` | `editing` | Sanitized file action |
+| `tools/result (read)` | `working` | Sanitized read action |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -2,6 +2,11 @@ import type { Context } from "@deepseek-ai/cordis";
 export { classifyDshEvent, createOpenPetsDshClient, createOpenPetsDshRuntime, registerDshListeners, type DshCordisApi, type DshAgentStatus, type DshEventName, type DshEventDecision, type OpenPetsDshOptions, type OpenPetsDshRuntime, } from "./runtime.js";
 import { type OpenPetsDshOptions } from "./runtime.js";
 export declare const name = "@open-pets/dsh";
+/** Configuration options for the OpenPets DSH plugin. */
+export interface Config extends OpenPetsDshOptions {
+    /** Master switch to enable or disable OpenPets notifications. Default: true. */
+    enabled?: boolean;
+}
 /** Install the OpenPets listeners into the DSH Cordis context. */
-export declare function apply(ctx: Context, options?: OpenPetsDshOptions): void;
+export declare function apply(ctx: Context, config?: Config): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -2,7 +2,9 @@ export { classifyDshEvent, createOpenPetsDshClient, createOpenPetsDshRuntime, re
 import { registerDshListeners } from "./runtime.js";
 export const name = "@open-pets/dsh";
 /** Install the OpenPets listeners into the DSH Cordis context. */
-export function apply(ctx, options = {}) {
-    registerDshListeners(ctx, options);
+export function apply(ctx, config = {}) {
+    if (config.enabled === false)
+        return;
+    registerDshListeners(ctx, config);
 }
 //# sourceMappingURL=index.js.map

package/dist/runtime.d.ts

@@ -1,24 +1,37 @@
 import { type HookSpeechCategory } from "@open-pets/agent-events";
 import { type OpenPetsClient, type OpenPetsReaction } from "@open-pets/client";
 import type { Context } from "@deepseek-ai/cordis";
-export type DshEventName = "agent/status" | "agent/error" | "approval/request";
+export type DshEventName = "agent/status" | "agent/error" | "approval/request" | "agent/assistant-stream" | "tools/result";
 export type DshAgentStatus = "running" | "idle";
 export interface DshEventDecision {
     readonly reaction: OpenPetsReaction;
     readonly speechCategory: HookSpeechCategory;
 }
 export interface OpenPetsDshOptions {
+    /** Master toggle to enable or disable OpenPets integration. Default: true. */
+    readonly enabled?: boolean;
     readonly clientFactory?: () => OpenPetsClient;
     readonly schedule?: (work: () => Promise<void>) => void | Promise<void>;
     readonly random?: () => number;
     readonly now?: () => number;
+    /** Minimum time between speech messages in milliseconds. Default: 1200. */
+    readonly minSpeechIntervalMs?: number;
+    /** Forward ⏵ status lines from assistant stream. Default: true. */
+    readonly enableStatusLineStream?: boolean;
+    /** Forward tool events. Default: true. */
+    readonly enableToolEvents?: boolean;
+    /** Announce when an approval request is waiting. Default: true. */
+    readonly enableApprovalEvents?: boolean;
 }
 export interface OpenPetsDshRuntime {
     readonly handleStatus: (event: unknown) => void;
     readonly handleEvent: (eventName: DshEventName, event?: unknown) => void;
     readonly handleApproval: () => void;
+    readonly handleStream: (payload: unknown) => void;
+    readonly handleToolResult: (exec: unknown, result?: unknown) => void;
 }
 export type DshCordisApi = Pick<Context, "on">;
+export declare function sanitizeStatusLine(text: string): string | null;
 /**
  * Map only the categorical values defined by DSH. Event payloads are
  * deliberately not inspected or forwarded. For agent/status, only the
@@ -27,6 +40,6 @@ export type DshCordisApi = Pick<Context, "on">;
 export declare function classifyDshEvent(eventName: DshEventName | string, event?: unknown): DshEventDecision | undefined;
 export declare function createOpenPetsDshRuntime(options?: OpenPetsDshOptions): OpenPetsDshRuntime;
 export declare function createOpenPetsDshClient(): OpenPetsClient;
-/** Register the three DSH listeners without taking ownership of their flow. */
+/** Register the DSH listeners without taking ownership of their flow. */
 export declare function registerDshListeners(cordis: DshCordisApi, options?: OpenPetsDshOptions): OpenPetsDshRuntime;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.js

@@ -2,6 +2,26 @@ import { pickHookSpeech, validateHookSpeech } from "@open-pets/agent-events";
 import { createOpenPetsClient } from "@open-pets/client";
 const automaticTimeoutMs = 500;
 const errorSuccessSuppressionMs = 5_000;
+const minSpeechIntervalMs = 1_200;
+export function sanitizeStatusLine(text) {
+    if (!text || typeof text !== "string")
+        return null;
+    let s = text.replace(/[\r\n]+/g, " ").trim();
+    s = s.replace(/https?:\/\/\S+/gi, "");
+    s = s.replace(/[`{};]/g, "");
+    s = s.replace(/(?:^|\s)(?:~|\.{1,2}|[A-Za-z]:)?[\\/]\S+\/([^\s/]+)/g, " $1");
+    if (s.length > 100)
+        s = s.slice(0, 97) + "...";
+    s = s.trim();
+    if (s.length === 0)
+        return null;
+    try {
+        return validateHookSpeech(s);
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Map only the categorical values defined by DSH. Event payloads are
  * deliberately not inspected or forwarded. For agent/status, only the
@@ -25,8 +45,15 @@ export function classifyDshEvent(eventName, event) {
 export function createOpenPetsDshRuntime(options = {}) {
     const clientFactory = options.clientFactory ?? createOpenPetsDshClient;
     const schedule = options.schedule ?? defaultSchedule;
+    const minSpeech = options.minSpeechIntervalMs ?? minSpeechIntervalMs;
+    const enableStatusLineStream = options.enableStatusLineStream !== false;
+    const enableToolEvents = options.enableToolEvents !== false;
+    const enableApprovalEvents = options.enableApprovalEvents !== false;
     let client;
     let recentErrorAt = Number.NEGATIVE_INFINITY;
+    let lastCustomSpeechAt = Number.NEGATIVE_INFINITY;
+    let streamBuffer = "";
+    let statusExtractedForTurn = false;
     const getClient = () => {
         client ??= clientFactory();
         return client;
@@ -59,16 +86,109 @@ export function createOpenPetsDshRuntime(options = {}) {
             // A scheduler supplied by the host is optional infrastructure.
         }
     };
+    const dispatchCustom = (message, reaction) => {
+        const now = options.now?.() ?? Date.now();
+        if (now - lastCustomSpeechAt < minSpeech)
+            return;
+        lastCustomSpeechAt = now;
+        const work = async () => {
+            try {
+                const validated = validateHookSpeech(message);
+                await getClient().say(validated, { reaction });
+            }
+            catch {
+                // Automatic agent listeners must never affect the DSH operation.
+            }
+        };
+        try {
+            const scheduled = schedule(work);
+            if (isPromiseLike(scheduled))
+                void scheduled.catch(() => undefined);
+        }
+        catch {
+            // Ignored
+        }
+    };
     return {
         handleStatus(event) {
+            const status = typeof event === "string" ? event : getStatusCategory(event);
+            if (status === "running") {
+                streamBuffer = "";
+                statusExtractedForTurn = false;
+            }
             dispatch(classifyDshEvent("agent/status", event));
         },
         handleEvent(eventName, event) {
             dispatch(classifyDshEvent(eventName, event));
         },
         handleApproval() {
+            if (!enableApprovalEvents)
+                return;
             dispatch(classifyDshEvent("approval/request"));
         },
+        handleStream(payload) {
+            if (!enableStatusLineStream)
+                return;
+            if (!payload || typeof payload !== "object")
+                return;
+            const frame = payload.frame;
+            if (!frame)
+                return;
+            if (frame.type === "start") {
+                streamBuffer = "";
+                statusExtractedForTurn = false;
+                return;
+            }
+            if (frame.type === "end") {
+                streamBuffer = "";
+                return;
+            }
+            if (frame.type === "chunk" && frame.chunk?.type === "text-delta" && typeof frame.chunk.text === "string") {
+                if (statusExtractedForTurn)
+                    return;
+                streamBuffer += frame.chunk.text;
+                const arrowIndex = streamBuffer.search(/[⏵▶]/);
+                if (arrowIndex !== -1) {
+                    const newlineIndex = streamBuffer.indexOf("\n", arrowIndex);
+                    if (newlineIndex !== -1) {
+                        statusExtractedForTurn = true;
+                        const rawStatus = streamBuffer.slice(arrowIndex + 1, newlineIndex).trim();
+                        const clean = sanitizeStatusLine(rawStatus);
+                        if (clean) {
+                            dispatchCustom(clean, "working");
+                        }
+                    }
+                }
+            }
+        },
+        handleToolResult(exec) {
+            if (!enableToolEvents)
+                return;
+            if (!exec || typeof exec !== "object")
+                return;
+            const e = exec;
+            if (!e.name)
+                return;
+            const args = e.arguments ?? e.params;
+            if (e.name === "bash" && args?.description) {
+                const clean = sanitizeStatusLine(String(args.description));
+                if (clean)
+                    dispatchCustom(clean, "running");
+            }
+            else if (e.name === "edit" || e.name === "write") {
+                const filePath = args?.file_path ? String(args.file_path).split(/[\\/]/).pop() : "";
+                const action = e.name === "edit" ? "Chỉnh sửa" : "Ghi file";
+                const clean = sanitizeStatusLine(filePath ? `${action} ${filePath}` : action);
+                if (clean)
+                    dispatchCustom(clean, "editing");
+            }
+            else if (e.name === "read") {
+                const filePath = args?.file_path ? String(args.file_path).split(/[\\/]/).pop() : "";
+                const clean = sanitizeStatusLine(filePath ? `Đọc ${filePath}` : "Đang đọc file");
+                if (clean)
+                    dispatchCustom(clean, "working");
+            }
+        },
     };
 }
 export function createOpenPetsDshClient() {
@@ -78,9 +198,11 @@ export function createOpenPetsDshClient() {
         responseTimeoutMs: automaticTimeoutMs,
     });
 }
-/** Register the three DSH listeners without taking ownership of their flow. */
+/** Register the DSH listeners without taking ownership of their flow. */
 export function registerDshListeners(cordis, options = {}) {
     const runtime = createOpenPetsDshRuntime(options);
+    if (options.enabled === false)
+        return runtime;
     const on = cordis.on;
     on("agent/status", (event) => runtime.handleStatus(event));
     on("agent/error", () => runtime.handleEvent("agent/error"));
@@ -88,6 +210,8 @@ export function registerDshListeners(cordis, options = {}) {
         runtime.handleApproval();
         return typeof next === "function" ? next() : undefined;
     });
+    on("agent/assistant-stream", (payload) => runtime.handleStream(payload));
+    on("tools/result", (exec, result) => runtime.handleToolResult(exec, result));
     return runtime;
 }
 function defaultSchedule(work) {

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@open-pets/dsh",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/alvinunreal/openpets.git",
+    "url": "git+https://github.com/OpenPetsHQ/openpets.git",
     "directory": "packages/dsh"
   },
   "type": "module",
@@ -40,8 +40,8 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@open-pets/agent-events": "4.0.0",
-    "@open-pets/client": "4.0.0"
+    "@open-pets/agent-events": "4.1.0",
+    "@open-pets/client": "4.1.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1"