@cjhyy/code-shell-pet 0.8.1 → 0.8.2

package/dist/capability.js

@@ -23,7 +23,7 @@ import { controlLongTaskAvailability, controlLongTaskTool, controlLongTaskToolDe
 import { PET_BEHAVIOR_PROFILE } from "./profile.js";
 import { createPetProjectionObserver, PET_HIDDEN_SESSION_KINDS } from "./projection-extension.js";
 import { PET_REPORT_TO_MIMI_METHOD } from "./protocol.js";
-import { reportToMimiAvailability, reportToMimiTool, reportToMimiToolDef, } from "./report-to-mimi.js";
+import { requestMimiDeliveryAvailability, requestMimiDeliveryTool, requestMimiDeliveryToolDef, reportToMimiAvailability, reportToMimiTool, reportToMimiToolDef, } from "./report-to-mimi.js";
 import { validatePetRunParams } from "./run-params.js";
 export function createPetCapability() {
     let reportToMimi;
@@ -45,6 +45,20 @@ export function createPetCapability() {
         validateRunParams: validatePetRunParams,
         hiddenSessionKinds: PET_HIDDEN_SESSION_KINDS,
         catalogTools: [
+            {
+                definition: {
+                    ...requestMimiDeliveryToolDef,
+                    source: "builtin",
+                    permissionDefault: "ask",
+                    isReadOnly: false,
+                    isConcurrencySafe: false,
+                },
+                execute: (args, ctx) => requestMimiDeliveryTool(args, ctx, reportToMimi),
+                exposure: {
+                    presetTags: ["harness-min", "general"],
+                    availability: requestMimiDeliveryAvailability,
+                },
+            },
             {
                 definition: {
                     ...reportToMimiToolDef,

package/dist/index.d.ts

@@ -11,7 +11,7 @@ export * from "./types.js";
 export * from "./delegation.js";
 export * from "./team.js";
 export * from "./protocol.js";
-export { REPORT_TO_MIMI_TOOL_NAME, reportToMimiToolDef, reportToMimiTool, reportToMimiAvailability, type PetReportToMimiSink, } from "./report-to-mimi.js";
+export { REPORT_TO_MIMI_TOOL_NAME, REQUEST_MIMI_DELIVERY_TOOL_NAME, reportToMimiToolDef, reportToMimiTool, reportToMimiAvailability, requestMimiDeliveryToolDef, requestMimiDeliveryTool, requestMimiDeliveryAvailability, type PetReportToMimiSink, } from "./report-to-mimi.js";
 export { petRunOptionsFrom, validatePetRunParams, type PetRunOptions } from "./run-params.js";
 export { SessionIndex } from "./session-index.js";
 export { PendingDecisionIndex, safePendingTitle } from "./pending-decision-index.js";

package/dist/index.js

@@ -11,7 +11,7 @@ export * from "./types.js";
 export * from "./delegation.js";
 export * from "./team.js";
 export * from "./protocol.js";
-export { REPORT_TO_MIMI_TOOL_NAME, reportToMimiToolDef, reportToMimiTool, reportToMimiAvailability, } from "./report-to-mimi.js";
+export { REPORT_TO_MIMI_TOOL_NAME, REQUEST_MIMI_DELIVERY_TOOL_NAME, reportToMimiToolDef, reportToMimiTool, reportToMimiAvailability, requestMimiDeliveryToolDef, requestMimiDeliveryTool, requestMimiDeliveryAvailability, } from "./report-to-mimi.js";
 export { petRunOptionsFrom, validatePetRunParams } from "./run-params.js";
 export { SessionIndex } from "./session-index.js";
 export { PendingDecisionIndex, safePendingTitle } from "./pending-decision-index.js";

package/dist/protocol.d.ts

@@ -46,6 +46,10 @@ export interface PetReportToMimiEvent {
     sessionId: string;
     message: string;
     attachmentPaths?: string[];
+    /** Permission-gated owner request for Mimi to use one authorized outbound route. */
+    deliveryRequest?: {
+        channel: string;
+    };
     createdAt: number;
 }
 /**

package/dist/report-to-mimi.d.ts

@@ -1,7 +1,11 @@
 import type { ToolContext, ToolDefinition, ToolVisibilityContext } from "@cjhyy/code-shell-core/extension";
 import type { PetReportToMimiEvent } from "./protocol.js";
 export declare const REPORT_TO_MIMI_TOOL_NAME = "ReportToMimi";
+export declare const REQUEST_MIMI_DELIVERY_TOOL_NAME = "RequestMimiDelivery";
 export declare const reportToMimiToolDef: ToolDefinition;
+export declare const requestMimiDeliveryToolDef: ToolDefinition;
 export type PetReportToMimiSink = (event: PetReportToMimiEvent) => void;
 export declare function reportToMimiAvailability(ctx: ToolVisibilityContext): boolean;
+export declare function requestMimiDeliveryAvailability(ctx: ToolVisibilityContext): boolean;
 export declare function reportToMimiTool(args: Record<string, unknown>, ctx?: ToolContext, report?: PetReportToMimiSink): Promise<string>;
+export declare function requestMimiDeliveryTool(args: Record<string, unknown>, ctx?: ToolContext, report?: PetReportToMimiSink): Promise<string>;

package/dist/report-to-mimi.js

@@ -2,11 +2,26 @@ import { createHash } from "node:crypto";
 import { isAbsolute } from "node:path";
 import { hasOnlyDeclaredToolArguments } from "./tool-arguments.js";
 export const REPORT_TO_MIMI_TOOL_NAME = "ReportToMimi";
+export const REQUEST_MIMI_DELIVERY_TOOL_NAME = "RequestMimiDelivery";
+const ATTACHMENT_PATHS_SCHEMA = {
+    type: "array",
+    minItems: 1,
+    maxItems: 4,
+    uniqueItems: true,
+    items: {
+        type: "string",
+        minLength: 1,
+        maxLength: 4_096,
+    },
+    description: "Optional absolute local artifact paths for Mimi. The host independently decides whether any route may send them.",
+};
 export const reportToMimiToolDef = {
     name: REPORT_TO_MIMI_TOOL_NAME,
     description: "Report a result, status update, artifact, or question from the current Session to Mimi. " +
         "This works from any Session; Mimi decides how to present or act on the report. " +
-        "Do not search for Mimi's hidden Session id and do not provide a channel or recipient.",
+        "This does not request external delivery. When the owner explicitly asks this Session to send " +
+        "something to WeChat, use RequestMimiDelivery once instead. Do not search for Mimi's hidden " +
+        "Session id and do not provide a channel or recipient here.",
     inputSchema: {
         type: "object",
         additionalProperties: false,
@@ -17,25 +32,44 @@ export const reportToMimiToolDef = {
                 maxLength: 8_000,
                 description: "Complete concise report for Mimi, including outcome, evidence, and any user decision needed.",
             },
-            attachment_paths: {
-                type: "array",
-                minItems: 1,
-                maxItems: 4,
-                uniqueItems: true,
-                items: {
-                    type: "string",
-                    minLength: 1,
-                    maxLength: 4_096,
-                },
-                description: "Optional absolute local artifact paths for Mimi. The host independently decides whether any route may send them.",
-            },
+            attachment_paths: ATTACHMENT_PATHS_SCHEMA,
         },
         required: ["message"],
     },
 };
+export const requestMimiDeliveryToolDef = {
+    name: REQUEST_MIMI_DELIVERY_TOOL_NAME,
+    description: "Ask Mimi's trusted host to deliver text and optional existing local artifacts through an " +
+        "owner-authorized outbound channel. Use only when the user explicitly asks the current Session " +
+        "to send or push something externally. For personal WeChat use channel=wechat. Call this tool " +
+        "exactly once; do not search for SendMessage, target ids, or Mimi's Session id. Acceptance means " +
+        "Mimi will validate and attempt the request; it is not proof that a platform or device received it.",
+    inputSchema: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+            channel: {
+                type: "string",
+                enum: ["wechat"],
+                description: "Semantic outbound channel requested by the owner; personal WeChat is wechat.",
+            },
+            text: {
+                type: "string",
+                minLength: 1,
+                maxLength: 8_000,
+                description: "Exact concise message the owner asked to deliver.",
+            },
+            attachment_paths: ATTACHMENT_PATHS_SCHEMA,
+        },
+        required: ["channel", "text"],
+    },
+};
 export function reportToMimiAvailability(ctx) {
     return isReportableSessionId(ctx.sessionId);
 }
+export function requestMimiDeliveryAvailability(ctx) {
+    return (isReportableSessionId(ctx.sessionId) && ctx.isSubAgent !== true && ctx.behaviorProfile !== "pet");
+}
 export async function reportToMimiTool(args, ctx, report) {
     if (!isReportableSessionId(ctx?.sessionId)) {
         return "Error: ReportToMimi requires a valid current Session.";
@@ -66,6 +100,44 @@ export async function reportToMimiTool(args, ctx, report) {
     });
     return "Report accepted by Mimi's host. Delivery is asynchronous; do not search for Mimi's Session id or claim that an IM message was delivered.";
 }
+export async function requestMimiDeliveryTool(args, ctx, report) {
+    if (!isReportableSessionId(ctx?.sessionId)) {
+        return "Error: RequestMimiDelivery requires a valid current Session.";
+    }
+    if (!report)
+        return "Error: the Mimi host delivery channel is unavailable.";
+    if (!hasOnlyDeclaredToolArguments(args, ["channel", "text", "attachment_paths"])) {
+        return "Error: RequestMimiDelivery accepts only channel, text, and attachment_paths.";
+    }
+    const channel = typeof args.channel === "string" ? args.channel.trim().toLowerCase() : "";
+    if (channel !== "wechat") {
+        return "Error: channel must be one supported semantic channel (currently: wechat).";
+    }
+    const message = typeof args.text === "string" ? args.text.trim() : "";
+    if (!message || message.length > 8_000) {
+        return "Error: RequestMimiDelivery text must be 1 to 8000 characters.";
+    }
+    const attachmentPaths = parseAttachmentPaths(args.attachment_paths);
+    if (attachmentPaths === null) {
+        return "Error: attachment_paths must contain 1 to 4 unique absolute paths.";
+    }
+    const reportId = createReportId(ctx.sessionId, ctx.originClientMessageId, message, attachmentPaths, channel);
+    report({
+        reportId,
+        sessionId: ctx.sessionId,
+        message,
+        ...(attachmentPaths ? { attachmentPaths } : {}),
+        deliveryRequest: { channel },
+        createdAt: Date.now(),
+    });
+    return "Delivery request accepted for Mimi host validation. Stop here: do not search for target ids, retry, or claim that the message was delivered.";
+}
+function createReportId(sessionId, originClientMessageId, message, attachmentPaths, channel = "") {
+    return createHash("sha256")
+        .update([sessionId, originClientMessageId ?? "", channel, message, ...(attachmentPaths ?? [])].join("\0"))
+        .digest("hex")
+        .slice(0, 32);
+}
 function parseAttachmentPaths(value) {
     if (value === undefined)
         return undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cjhyy/code-shell-pet",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "description": "Pet (top-level personal assistant) capability for CodeShell — projection state machine, DelegateWork contract, Mimi behavior profile.",
   "type": "module",
   "main": "./dist/index.js",
@@ -35,7 +35,7 @@
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\""
   },
   "dependencies": {
-    "@cjhyy/code-shell-core": "0.8.1"
+    "@cjhyy/code-shell-core": "0.8.2"
   },
   "engines": {
     "node": ">=20.10"