@alignfirst/service-openclaw-plugin 0.4.0 → 0.4.2

package/README.md

@@ -73,7 +73,7 @@ The plugin commits a pending record before dispatching `Take over this thread.`
 
 The message body is static: it carries no starter copy, routing fields, or handoff ID. The playbook routes by thread metadata, claims the current session, and reads the visible starter and human replies through thread history. The nudge supplies no missing input or approval. A takeover turn with nothing to report ends with `HEARTBEAT_OK`; the deterministic gateway probe confirmed that `NO_REPLY` still triggers isolated finalization on this path.
 
-The plugin starts the thread session and does nothing after that. Alcode completion uses OpenClaw's own completion path.
+The plugin starts the thread session and does nothing after that. `aligndev code` completion uses OpenClaw's own completion path.
 
 Each takeover turn gets the regular agent budget from `agents.defaults.timeoutSeconds`, including the 48-hour OpenClaw default and the unlimited `0` value.
 
@@ -111,7 +111,7 @@ npm run lint --workspace @alignfirst/service-openclaw-plugin
 ```
 
 The ordinary test command excludes the real-gateway suite. To exercise the package as an external
-plugin against the pinned OpenClaw 2026.9.4 runtime, including Slack/Discord delivery, concurrent human messages, duplicate starts, same-session continuation, and abrupt restart recovery:
+plugin against the OpenClaw runtime pinned in the root lockfile, including Slack/Discord delivery, concurrent human messages, duplicate starts, same-session continuation, and abrupt restart recovery:
 
 ```bash
 KEEP_THREAD_HANDOFF_ARTIFACTS=1 npm run test:integration --workspace @alignfirst/service-openclaw-plugin

package/dist/thread-handoff/index.js

@@ -1,5 +1,6 @@
 import { registerThreadHandoffCli } from "./cli.js";
-import { createReceiptCoordinator } from "./receipts.js";
+import { processShared } from "./process-shared.js";
+import { createReceiptCache, createReceiptCoordinator } from "./receipts.js";
 import { createRunIdCache } from "./run-ids.js";
 import { createHandoffService } from "./service.js";
 import { createHandoffStore, resolveDatabasePath } from "./state.js";
@@ -16,8 +17,13 @@ export function registerThreadHandoff(api) {
         store ??= createHandoffStore(api.runtime.state.resolveStateDir());
         return store;
     };
-    const receipts = createReceiptCoordinator({ configuration, getStore, logger: api.logger });
-    const runIds = createRunIdCache();
+    const receipts = createReceiptCoordinator({
+        configuration,
+        getStore,
+        logger: api.logger,
+        cache: processShared("receipt-cache/v1", createReceiptCache),
+    });
+    const runIds = processShared("run-ids/v1", () => createRunIdCache());
     const service = createHandoffService({
         runtime: api.runtime,
         configuration,

package/dist/thread-handoff/process-shared.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Returns the value stored under `name` for the whole gateway process, created on first use.
+ *
+ * Since 2026.9.8, OpenClaw evaluates this plugin more than once in one gateway process: a turn
+ * takes its tools from the gateway's registration and runs its tool hooks in its own. State that
+ * both a tool and a hook read must outlive a single registration.
+ */
+export declare function processShared<T>(name: string, create: () => T): T;

package/dist/thread-handoff/process-shared.js

@@ -0,0 +1,15 @@
+/**
+ * Returns the value stored under `name` for the whole gateway process, created on first use.
+ *
+ * Since 2026.9.8, OpenClaw evaluates this plugin more than once in one gateway process: a turn
+ * takes its tools from the gateway's registration and runs its tool hooks in its own. State that
+ * both a tool and a hook read must outlive a single registration.
+ */
+export function processShared(name, create) {
+    const slots = globalThis;
+    const key = Symbol.for(`@alignfirst/service-openclaw-plugin/${name}`);
+    if (!(key in slots))
+        slots[key] = create();
+    // The slot holds what `create` returned under this versioned name.
+    return slots[key];
+}

package/dist/thread-handoff/receipts.d.ts

@@ -1,6 +1,6 @@
 import type { OpenClawPluginToolContext, PluginLogger } from "openclaw/plugin-sdk/plugin-entry";
 import type { HandoffStore } from "./state.js";
-import type { DeliveryReceipt, PluginConfiguration, ReceiptIdentity } from "./types.js";
+import type { DeliveryReceipt, PluginConfiguration, ReceiptIdentity, SourceContext } from "./types.js";
 export interface ReceiptCoordinator {
     captureContext(context: OpenClawPluginToolContext): void;
     observe(event: ToolObservation, context: HookContext): void;
@@ -17,10 +17,21 @@ interface HookContext {
     sessionKey?: string;
     sessionId?: string;
 }
+/** Captured contexts and observation errors, shared by every registration of the plugin. */
+export interface ReceiptCache {
+    contexts: Map<string, CachedContext>;
+    observationErrors: Map<string, Error>;
+}
+export interface CachedContext {
+    source: SourceContext;
+    capturedAt: number;
+}
 export declare function createReceiptCoordinator(params: {
     configuration: PluginConfiguration;
     getStore: () => HandoffStore;
     logger: PluginLogger;
+    cache?: ReceiptCache;
     now?: () => number;
 }): ReceiptCoordinator;
+export declare function createReceiptCache(): ReceiptCache;
 export {};

package/dist/thread-handoff/receipts.js

@@ -7,8 +7,7 @@ const RECEIPT_WAIT_MS = 1_000;
 const RECEIPT_POLL_MS = 25;
 export function createReceiptCoordinator(params) {
     const now = params.now ?? Date.now;
-    const contexts = new Map();
-    const observationErrors = new Map();
+    const { contexts, observationErrors } = params.cache ?? createReceiptCache();
     return {
         captureContext(context) {
             const source = readSourceContext(context, params.configuration);
@@ -61,6 +60,9 @@ export function createReceiptCoordinator(params) {
         },
     };
 }
+export function createReceiptCache() {
+    return { contexts: new Map(), observationErrors: new Map() };
+}
 function readCachedSource(contexts, context, now) {
     const sessionKey = nonempty(context.sessionKey);
     const sessionId = nonempty(context.sessionId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alignfirst/service-openclaw-plugin",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "OpenClaw capabilities for the AlignFirst Dev Kit.",
   "keywords": [
     "alignfirst",
@@ -43,11 +43,11 @@
     "typebox": "~1.3.23"
   },
   "devDependencies": {
-    "@alignfirst/openclaw-channel-mock-core": "0.10.0",
+    "@alignfirst/openclaw-channel-mock-core": "0.10.3",
     "@types/node": "~26.5.0",
-    "openclaw": "~2026.9.3",
+    "openclaw": "~2026.9.8",
     "rimraf": "~6.1.3",
     "typescript": "~7.0.2",
-    "vitest": "~4.1.11"
+    "vitest": "~5.0.1"
   }
 }