@cjhyy/code-shell-pet 0.9.2 → 0.9.3

package/dist/long-task.d.ts

@@ -30,7 +30,7 @@ export interface PetLongTaskCompletionTarget {
     replyAttachmentKinds?: PetReplyAttachmentKind[];
 }
 export type PetReplyAttachmentKind = "image" | "file" | "audio" | "video";
-export type PetLongTaskEventKind = "created" | "started" | "progress" | "waiting" | "paused" | "resumed" | "retrying" | "artifact" | "checkpoint" | "verification-changed" | "completion-target-set" | "interrupted" | "completed" | "failed" | "cancelled" | "closure-decided" | "continuation-started" | "closure-recorded";
+export type PetLongTaskEventKind = "created" | "started" | "progress" | "waiting" | "paused" | "resumed" | "retrying" | "artifact" | "checkpoint" | "verification-changed" | "completion-target-set" | "interrupted" | "completed" | "failed" | "cancelled" | "closure-decided" | "continuation-started" | "closure-recorded" | "work-memory-recorded";
 export interface PetLongTaskEvent {
     id: string;
     sequence: number;
@@ -64,8 +64,10 @@ export interface PetLongTask {
     updatedAt: number;
     startedAt?: number;
     completedAt?: number;
-    /** The current attempt's terminal outcome reached durable Pet work memory. */
+    /** User-visible closure effects finished and are safe to deduplicate on replay. */
     closureRecordedAt?: number;
+    /** The current attempt's terminal outcome reached durable Pet work memory. */
+    workMemoryRecordedAt?: number;
     /** Durable Mimi closure decision, persisted before any continuation side effect. */
     closureDecision?: PetLongTaskClosureDecision;
     /** Latest assistant-authored result/checkpoint, kept separate from UI progress text. */
@@ -222,8 +224,11 @@ export type PetLongTaskTransition = {
     sessionId: string;
     taskId?: string;
 } | {
-    kind: "closure-recorded";
+    kind: "closure-recorded" | "work-memory-recorded";
     at: number;
+    /** Optional optimistic fence for async closure side effects. */
+    attempt?: number;
+    status?: PetLongTaskStatus;
 };
 export declare function createPetLongTask(input: CreatePetLongTaskInput): PetLongTask;
 /**

package/dist/long-task.js

@@ -204,14 +204,23 @@ export function transitionPetLongTask(current, transition) {
         transition.kind !== "background-wait-recovered" &&
         transition.kind !== "closure-decided" &&
         transition.kind !== "continuation-started" &&
-        transition.kind !== "closure-recorded") {
+        transition.kind !== "closure-recorded" &&
+        transition.kind !== "work-memory-recorded") {
         return current;
     }
     if (current.status === "cancelled" &&
         transition.kind !== "retrying" &&
         transition.kind !== "closure-decided" &&
         transition.kind !== "continuation-started" &&
-        transition.kind !== "closure-recorded") {
+        transition.kind !== "closure-recorded" &&
+        transition.kind !== "work-memory-recorded") {
+        return current;
+    }
+    if ((transition.kind === "closure-recorded" || transition.kind === "work-memory-recorded") &&
+        (!TERMINAL.has(current.status) ||
+            (transition.attempt !== undefined && transition.attempt !== current.attempt) ||
+            (transition.status !== undefined && transition.status !== current.status) ||
+            (transition.kind === "work-memory-recorded" && current.closureRecordedAt === undefined))) {
         return current;
     }
     const next = {
@@ -331,6 +340,7 @@ export function transitionPetLongTask(current, transition) {
                 startedAt: undefined,
                 completedAt: undefined,
                 closureRecordedAt: undefined,
+                workMemoryRecordedAt: undefined,
                 closureDecision: undefined,
                 waitingFor: undefined,
                 nextAction: "Retry from the existing work session and checkpoint",
@@ -405,6 +415,7 @@ export function transitionPetLongTask(current, transition) {
                 startedAt: Math.max(current.createdAt, transition.attemptStartedAt),
                 completedAt: undefined,
                 closureRecordedAt: undefined,
+                workMemoryRecordedAt: undefined,
                 closureDecision: undefined,
                 waitingFor: bounded(transition.reason, 500),
                 nextAction: "Resume from the durable work session",
@@ -565,6 +576,15 @@ export function transitionPetLongTask(current, transition) {
         }
         case "closure-recorded":
             Object.assign(next, { closureRecordedAt: transition.at });
+            event = {
+                kind: transition.kind,
+                at: transition.at,
+                phase: current.phase,
+                message: "Terminal closure delivered",
+            };
+            break;
+        case "work-memory-recorded":
+            Object.assign(next, { workMemoryRecordedAt: transition.at });
             event = {
                 kind: transition.kind,
                 at: transition.at,
@@ -614,6 +634,7 @@ function isEventKind(value) {
             "closure-decided",
             "continuation-started",
             "closure-recorded",
+            "work-memory-recorded",
         ].includes(value));
 }
 function parseEvent(value) {
@@ -781,6 +802,9 @@ export function parsePetLongTask(value) {
         ...(typeof record.closureRecordedAt === "number"
             ? { closureRecordedAt: record.closureRecordedAt }
             : {}),
+        ...(typeof record.workMemoryRecordedAt === "number"
+            ? { workMemoryRecordedAt: record.workMemoryRecordedAt }
+            : {}),
         ...(closureDecision ? { closureDecision } : {}),
         ...(typeof record.resultSummary === "string"
             ? { resultSummary: record.resultSummary.slice(0, MAX_PET_LONG_TASK_SUMMARY_LENGTH) }

package/package.json

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