@alfe.ai/openclaw-chat 0.3.3 → 0.5.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { a as plugin, c as AlfeChannelConfig, l as AlfePluginConfig, s as createAlfeChannelPlugin, u as AlfeResolvedAccount } from "./plugin.cjs";
+import { _ as AlfeResolvedAccount, g as AlfePluginConfig, h as AlfeChannelConfig, m as createAlfeChannelPlugin, u as plugin } from "./plugin.cjs";
 
 //#region src/session-store.d.ts
 
@@ -19,6 +19,35 @@ interface ChatMessage {
   senderId?: string;
   senderName?: string;
 }
+/**
+ * Persisted form of a turn's agent activity (tool cards + thinking), so a
+ * refresh can replay what the live `chat-activity` stream showed. Terminal
+ * by construction: no `progressText` (transient streaming window) and no
+ * `running` status — a tool still running at flush time is persisted as
+ * `interrupted`. Tool text fields arrive pre-capped (activity-serialize.ts);
+ * thinking text is capped at append time (MAX_ACTIVITY_THINKING_CHARS).
+ */
+type ChatActivityRecord = {
+  kind: 'thinking';
+  text: string;
+  ts: number;
+} | {
+  kind: 'tool';
+  toolCallId: string;
+  name: string;
+  status: 'done' | 'failed' | 'interrupted';
+  summary?: string;
+  argsText?: string;
+  resultText?: string;
+  isError?: boolean;
+  durationMs?: number;
+  truncated?: {
+    args?: boolean;
+    progress?: boolean;
+    result?: boolean;
+  };
+  ts: number;
+};
 interface SessionData {
   sessionId: string;
   agentId: string;
@@ -28,6 +57,8 @@ interface SessionData {
   createdAt: string;
   updatedAt: string;
   messages: ChatMessage[];
+  /** Absent on session files written before activity persistence shipped. */
+  activity?: ChatActivityRecord[];
 }
 interface SessionSummary {
   sessionId: string;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { a as plugin, c as AlfeChannelConfig, l as AlfePluginConfig, s as createAlfeChannelPlugin, u as AlfeResolvedAccount } from "./plugin.js";
+import { _ as AlfeResolvedAccount, g as AlfePluginConfig, h as AlfeChannelConfig, m as createAlfeChannelPlugin, u as plugin } from "./plugin.js";
 
 //#region src/session-store.d.ts
 
@@ -19,6 +19,35 @@ interface ChatMessage {
   senderId?: string;
   senderName?: string;
 }
+/**
+ * Persisted form of a turn's agent activity (tool cards + thinking), so a
+ * refresh can replay what the live `chat-activity` stream showed. Terminal
+ * by construction: no `progressText` (transient streaming window) and no
+ * `running` status — a tool still running at flush time is persisted as
+ * `interrupted`. Tool text fields arrive pre-capped (activity-serialize.ts);
+ * thinking text is capped at append time (MAX_ACTIVITY_THINKING_CHARS).
+ */
+type ChatActivityRecord = {
+  kind: 'thinking';
+  text: string;
+  ts: number;
+} | {
+  kind: 'tool';
+  toolCallId: string;
+  name: string;
+  status: 'done' | 'failed' | 'interrupted';
+  summary?: string;
+  argsText?: string;
+  resultText?: string;
+  isError?: boolean;
+  durationMs?: number;
+  truncated?: {
+    args?: boolean;
+    progress?: boolean;
+    result?: boolean;
+  };
+  ts: number;
+};
 interface SessionData {
   sessionId: string;
   agentId: string;
@@ -28,6 +57,8 @@ interface SessionData {
   createdAt: string;
   updatedAt: string;
   messages: ChatMessage[];
+  /** Absent on session files written before activity persistence shipped. */
+  activity?: ChatActivityRecord[];
 }
 interface SessionSummary {
   sessionId: string;

package/dist/index.js

@@ -1,2 +1,2 @@
-import { i as plugin, o as createAlfeChannelPlugin } from "./plugin2.js";
+import { c as plugin, f as createAlfeChannelPlugin } from "./plugin2.js";
 export { createAlfeChannelPlugin, plugin as default };

package/dist/plugin.cjs

@@ -3,8 +3,14 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_plugin = require("./plugin2.cjs");
+exports.__agentTurnQueueForTest = require_plugin.__agentTurnQueueForTest;
+exports.__resetAgentTurnQueueForTest = require_plugin.__resetAgentTurnQueueForTest;
+exports.__setActiveRunForTest = require_plugin.__setActiveRunForTest;
 exports.admitAgentEvent = require_plugin.admitAgentEvent;
 exports.buildA2ACompletePayload = require_plugin.buildA2ACompletePayload;
 exports.buildToolActivity = require_plugin.buildToolActivity;
 exports.default = require_plugin.plugin;
+exports.joinAssistantText = require_plugin.joinAssistantText;
+exports.resolveAbortTargetKeys = require_plugin.resolveAbortTargetKeys;
+exports.rewriteAssistantText = require_plugin.rewriteAssistantText;
 exports.stripLeakedToolSummary = require_plugin.stripLeakedToolSummary;

package/dist/plugin.d.cts

@@ -334,6 +334,21 @@ type ChatActivity = {
   ts?: number;
   seq?: number;
 };
+/**
+ * Join the text parts of an assistant-stream event's content array.
+ * Assistant `evt.data` is a message object whose `content` is an array of
+ * typed parts; deltas are CUMULATIVE snapshots (the relay length-compares
+ * them — see adapter.ts's lastSentLength slicing). Non-array/absent content
+ * yields '' (nothing to divert).
+ */
+declare function joinAssistantText(data: Record<string, unknown>): string;
+/**
+ * Rebuild an assistant event's message with its text parts replaced by one
+ * `{type:'text', text: visible}` part. Non-text parts are preserved — the
+ * relay's consumers (adapter/inject/voice-bridge) only join text parts, so
+ * relative ordering against non-text items is not load-bearing.
+ */
+declare function rewriteAssistantText(data: Record<string, unknown>, visible: string): Record<string, unknown>;
 /**
  * Extract structured tool status from an OpenClaw `tool`-stream event.
  * We send the emoji-free raw `name` plus a lifecycle `status` and let the
@@ -387,6 +402,35 @@ interface PluginApi {
     priority?: number;
   }): void;
 }
+declare function enqueueAgentTurn(task: () => Promise<void>, opts?: {
+  coalesceKey?: string;
+  onSuperseded?: () => void;
+}): Promise<void>;
+/**
+ * Test-only: reset the agent-turn backlog between unit tests. Not used at
+ * runtime (the backlog lives for the process lifetime of one daemon).
+ */
+declare function __resetAgentTurnQueueForTest(): void;
+/** Test-only accessor for the coalescing queue (see __tests__/queue.test.ts). */
+declare const __agentTurnQueueForTest: {
+  enqueue: typeof enqueueAgentTurn;
+  backlogLength: () => number;
+};
+interface ActiveRunRef {
+  requestSessionKey: string;
+  routeSessionKey: string | null;
+}
+/** Test-only: set/clear the active-run ref for handleChatAbort unit tests. */
+declare function __setActiveRunForTest(ref: ActiveRunRef | null): void;
+/**
+ * Ordered session keys to try when aborting for `abortSessionKey`. Pure, so it
+ * unit-tests without the OpenClaw SDK. The resolved route key (what the run
+ * registered under) is preferred; the raw request key is a best-effort
+ * fallback. An abort with NO sessionKey targets the single active run. A
+ * sessionKey that does NOT match the running turn yields no candidates — we
+ * never abort another session's run on a shared daemon.
+ */
+declare function resolveAbortTargetKeys(active: ActiveRunRef | null, abortSessionKey: string | undefined): string[];
 declare const plugin: {
   id: string;
   name: string;
@@ -396,4 +440,4 @@ declare const plugin: {
   deactivate(api: PluginApi): Promise<void>;
 };
 //#endregion
-export { plugin as a, AlfeChannelConfig as c, buildToolActivity as i, AlfePluginConfig as l, admitAgentEvent as n, stripLeakedToolSummary as o, buildA2ACompletePayload as r, createAlfeChannelPlugin as s, RunEventGate as t, AlfeResolvedAccount as u };
+export { AlfeResolvedAccount as _, __setActiveRunForTest as a, buildToolActivity as c, resolveAbortTargetKeys as d, rewriteAssistantText as f, AlfePluginConfig as g, AlfeChannelConfig as h, __resetAgentTurnQueueForTest as i, joinAssistantText as l, createAlfeChannelPlugin as m, RunEventGate as n, admitAgentEvent as o, stripLeakedToolSummary as p, __agentTurnQueueForTest as r, buildA2ACompletePayload as s, ActiveRunRef as t, plugin as u };

package/dist/plugin.d.ts

@@ -334,6 +334,21 @@ type ChatActivity = {
   ts?: number;
   seq?: number;
 };
+/**
+ * Join the text parts of an assistant-stream event's content array.
+ * Assistant `evt.data` is a message object whose `content` is an array of
+ * typed parts; deltas are CUMULATIVE snapshots (the relay length-compares
+ * them — see adapter.ts's lastSentLength slicing). Non-array/absent content
+ * yields '' (nothing to divert).
+ */
+declare function joinAssistantText(data: Record<string, unknown>): string;
+/**
+ * Rebuild an assistant event's message with its text parts replaced by one
+ * `{type:'text', text: visible}` part. Non-text parts are preserved — the
+ * relay's consumers (adapter/inject/voice-bridge) only join text parts, so
+ * relative ordering against non-text items is not load-bearing.
+ */
+declare function rewriteAssistantText(data: Record<string, unknown>, visible: string): Record<string, unknown>;
 /**
  * Extract structured tool status from an OpenClaw `tool`-stream event.
  * We send the emoji-free raw `name` plus a lifecycle `status` and let the
@@ -387,6 +402,35 @@ interface PluginApi {
     priority?: number;
   }): void;
 }
+declare function enqueueAgentTurn(task: () => Promise<void>, opts?: {
+  coalesceKey?: string;
+  onSuperseded?: () => void;
+}): Promise<void>;
+/**
+ * Test-only: reset the agent-turn backlog between unit tests. Not used at
+ * runtime (the backlog lives for the process lifetime of one daemon).
+ */
+declare function __resetAgentTurnQueueForTest(): void;
+/** Test-only accessor for the coalescing queue (see __tests__/queue.test.ts). */
+declare const __agentTurnQueueForTest: {
+  enqueue: typeof enqueueAgentTurn;
+  backlogLength: () => number;
+};
+interface ActiveRunRef {
+  requestSessionKey: string;
+  routeSessionKey: string | null;
+}
+/** Test-only: set/clear the active-run ref for handleChatAbort unit tests. */
+declare function __setActiveRunForTest(ref: ActiveRunRef | null): void;
+/**
+ * Ordered session keys to try when aborting for `abortSessionKey`. Pure, so it
+ * unit-tests without the OpenClaw SDK. The resolved route key (what the run
+ * registered under) is preferred; the raw request key is a best-effort
+ * fallback. An abort with NO sessionKey targets the single active run. A
+ * sessionKey that does NOT match the running turn yields no candidates — we
+ * never abort another session's run on a shared daemon.
+ */
+declare function resolveAbortTargetKeys(active: ActiveRunRef | null, abortSessionKey: string | undefined): string[];
 declare const plugin: {
   id: string;
   name: string;
@@ -396,4 +440,4 @@ declare const plugin: {
   deactivate(api: PluginApi): Promise<void>;
 };
 //#endregion
-export { plugin as a, AlfeChannelConfig as c, buildToolActivity as i, AlfePluginConfig as l, admitAgentEvent as n, stripLeakedToolSummary as o, buildA2ACompletePayload as r, createAlfeChannelPlugin as s, RunEventGate as t, AlfeResolvedAccount as u };
+export { AlfeResolvedAccount as _, __setActiveRunForTest as a, buildToolActivity as c, resolveAbortTargetKeys as d, rewriteAssistantText as f, AlfePluginConfig as g, AlfeChannelConfig as h, __resetAgentTurnQueueForTest as i, joinAssistantText as l, createAlfeChannelPlugin as m, RunEventGate as n, admitAgentEvent as o, stripLeakedToolSummary as p, __agentTurnQueueForTest as r, buildA2ACompletePayload as s, ActiveRunRef as t, plugin as u };

package/dist/plugin.js

@@ -1,2 +1,2 @@
-import { a as stripLeakedToolSummary, i as plugin, n as buildA2ACompletePayload, r as buildToolActivity, t as admitAgentEvent } from "./plugin2.js";
-export { admitAgentEvent, buildA2ACompletePayload, buildToolActivity, plugin as default, stripLeakedToolSummary };
+import { a as buildA2ACompletePayload, c as plugin, d as stripLeakedToolSummary, i as admitAgentEvent, l as resolveAbortTargetKeys, n as __resetAgentTurnQueueForTest, o as buildToolActivity, r as __setActiveRunForTest, s as joinAssistantText, t as __agentTurnQueueForTest, u as rewriteAssistantText } from "./plugin2.js";
+export { __agentTurnQueueForTest, __resetAgentTurnQueueForTest, __setActiveRunForTest, admitAgentEvent, buildA2ACompletePayload, buildToolActivity, plugin as default, joinAssistantText, resolveAbortTargetKeys, rewriteAssistantText, stripLeakedToolSummary };