@open-pets/dsh 3.3.0

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: openpets-dsh
+      name: '@open-pets/dsh'

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+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";
+/** Install the OpenPets listeners into the DSH Cordis context. */
+export declare function apply(ctx: Context, options?: OpenPetsDshOptions): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,8 @@
+export { classifyDshEvent, createOpenPetsDshClient, createOpenPetsDshRuntime, registerDshListeners, } from "./runtime.js";
+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);
+}
+//# sourceMappingURL=index.js.map

package/dist/runtime.d.ts

@@ -0,0 +1,32 @@
+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 DshAgentStatus = "running" | "idle";
+export interface DshEventDecision {
+    readonly reaction: OpenPetsReaction;
+    readonly speechCategory: HookSpeechCategory;
+}
+export interface OpenPetsDshOptions {
+    readonly clientFactory?: () => OpenPetsClient;
+    readonly schedule?: (work: () => Promise<void>) => void | Promise<void>;
+    readonly random?: () => number;
+    readonly now?: () => number;
+}
+export interface OpenPetsDshRuntime {
+    readonly handleStatus: (event: unknown) => void;
+    readonly handleEvent: (eventName: DshEventName, event?: unknown) => void;
+    readonly handleApproval: () => void;
+}
+export type DshCordisApi = Pick<Context, "on">;
+/**
+ * Map only the categorical values defined by DSH. Event payloads are
+ * deliberately not inspected or forwarded. For agent/status, only the
+ * categorical `status` property is read from the event envelope.
+ */
+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. */
+export declare function registerDshListeners(cordis: DshCordisApi, options?: OpenPetsDshOptions): OpenPetsDshRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.js

@@ -0,0 +1,104 @@
+import { pickHookSpeech, validateHookSpeech } from "@open-pets/agent-events";
+import { createOpenPetsClient } from "@open-pets/client";
+const automaticTimeoutMs = 500;
+const errorSuccessSuppressionMs = 5_000;
+/**
+ * Map only the categorical values defined by DSH. Event payloads are
+ * deliberately not inspected or forwarded. For agent/status, only the
+ * categorical `status` property is read from the event envelope.
+ */
+export function classifyDshEvent(eventName, event) {
+    if (eventName === "agent/status") {
+        const status = typeof event === "string" ? event : getStatusCategory(event);
+        if (status === "running")
+            return { reaction: "thinking", speechCategory: "thinking" };
+        if (status === "idle")
+            return { reaction: "success", speechCategory: "success" };
+        return undefined;
+    }
+    if (eventName === "agent/error")
+        return { reaction: "error", speechCategory: "error" };
+    if (eventName === "approval/request")
+        return { reaction: "waiting", speechCategory: "permission" };
+    return undefined;
+}
+export function createOpenPetsDshRuntime(options = {}) {
+    const clientFactory = options.clientFactory ?? createOpenPetsDshClient;
+    const schedule = options.schedule ?? defaultSchedule;
+    let client;
+    let recentErrorAt = Number.NEGATIVE_INFINITY;
+    const getClient = () => {
+        client ??= clientFactory();
+        return client;
+    };
+    const dispatch = (decision) => {
+        if (!decision)
+            return;
+        const now = options.now?.() ?? Date.now();
+        if (decision.reaction === "error") {
+            recentErrorAt = now;
+        }
+        else if (decision.reaction === "success" && now - recentErrorAt < errorSuccessSuppressionMs) {
+            return;
+        }
+        const work = async () => {
+            try {
+                const speech = validateHookSpeech(pickHookSpeech(decision.speechCategory, options.random));
+                await getClient().say(speech, { reaction: decision.reaction });
+            }
+            catch {
+                // Automatic agent listeners must never affect the DSH operation.
+            }
+        };
+        try {
+            const scheduled = schedule(work);
+            if (isPromiseLike(scheduled))
+                void scheduled.catch(() => undefined);
+        }
+        catch {
+            // A scheduler supplied by the host is optional infrastructure.
+        }
+    };
+    return {
+        handleStatus(event) {
+            dispatch(classifyDshEvent("agent/status", event));
+        },
+        handleEvent(eventName, event) {
+            dispatch(classifyDshEvent(eventName, event));
+        },
+        handleApproval() {
+            dispatch(classifyDshEvent("approval/request"));
+        },
+    };
+}
+export function createOpenPetsDshClient() {
+    return createOpenPetsClient({
+        remote: false,
+        connectTimeoutMs: automaticTimeoutMs,
+        responseTimeoutMs: automaticTimeoutMs,
+    });
+}
+/** Register the three DSH listeners without taking ownership of their flow. */
+export function registerDshListeners(cordis, options = {}) {
+    const runtime = createOpenPetsDshRuntime(options);
+    const on = cordis.on;
+    on("agent/status", (event) => runtime.handleStatus(event));
+    on("agent/error", () => runtime.handleEvent("agent/error"));
+    on("approval/request", (_request, next) => {
+        runtime.handleApproval();
+        return typeof next === "function" ? next() : undefined;
+    });
+    return runtime;
+}
+function defaultSchedule(work) {
+    void Promise.resolve().then(work).catch(() => undefined);
+}
+function isPromiseLike(value) {
+    return typeof value === "object" && value !== null && typeof value.then === "function";
+}
+function getStatusCategory(event) {
+    if (typeof event !== "object" || event === null)
+        return undefined;
+    return event.status;
+}
+//# sourceMappingURL=runtime.js.map

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@open-pets/dsh",
+  "version": "3.3.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alvinunreal/openpets.git",
+    "directory": "packages/dsh"
+  },
+  "type": "module",
+  "keywords": [
+    "dsh",
+    "cordis",
+    "openpets",
+    "coding-agent"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/index.d.ts",
+    "dist/index.js",
+    "dist/runtime.d.ts",
+    "dist/runtime.js",
+    "cordis.patch.yml"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "test": "node dist/runtime.test.js && node dist/check-dsh.js",
+    "check": "pnpm typecheck && pnpm build && pnpm test",
+    "typecheck": "tsc --noEmit",
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@open-pets/agent-events": "workspace:*",
+    "@open-pets/client": "workspace:*"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@types/node": "^25.6.2",
+    "typescript": "^6.0.3"
+  }
+}