@meetquinn/animactl 0.1.21 → 0.1.22-canary.564.1.e778c46

package/dist/server/inbox/observed-conversation.d.ts

@@ -0,0 +1,24 @@
+import { type SlackRawFile } from '../slack/slack.helper.js';
+import { type ObservedFileDescriptor, type ObserveSlackMessageResult } from '../storage/schema/observed-conversation.store.js';
+import { type ObservableSlackMessage, type SlackMessageEnvelope, type SlackRawMessageEvent } from './slack-events.js';
+export declare function observeObservableSlackMessage(input: {
+    agentId: string;
+    envelope?: SlackMessageEnvelope;
+    event: ObservableSlackMessage;
+    /** When true, rethrow store failures after marking continuity degraded. Default: mark degraded and continue. */
+    throwOnError?: boolean;
+}): Promise<ObserveSlackMessageResult | undefined>;
+/**
+ * Ingress entry: if the raw event is observable, journal it (fail-soft by
+ * default). Returns whether observation was attempted.
+ */
+export declare function observeSlackEventAtIngress(input: {
+    agentId: string;
+    envelope?: SlackMessageEnvelope;
+    event: SlackRawMessageEvent;
+    throwOnError?: boolean;
+}): Promise<ObserveSlackMessageResult | undefined>;
+/** @deprecated Use observeObservableSlackMessage / observeSlackEventAtIngress. */
+export declare const observeRoutableSlackMessage: typeof observeObservableSlackMessage;
+export declare function observedFilesFromSlack(files: SlackRawFile[] | undefined): ObservedFileDescriptor[];
+//# sourceMappingURL=observed-conversation.d.ts.map

package/dist/server/inbox/observed-conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observed-conversation.d.ts","sourceRoot":"","sources":["../../../server/inbox/observed-conversation.ts"],"names":[],"mappings":"AAOA,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,yBAAyB,EAC/B,MAAM,kDAAkD,CAAC;AAC1D,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,wBAAsB,6BAA6B,CAAC,KAAK,EAAE;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,gHAAgH;IAChH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC,CAwBjD;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,KAAK,EAAE;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC,CAQjD;AAED,kFAAkF;AAClF,eAAO,MAAM,2BAA2B,sCAAgC,CAAC;AAEzE,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EAAE,GAAG,SAAS,GAChC,sBAAsB,EAAE,CAc1B"}

package/dist/server/inbox/observed-conversation.js

@@ -0,0 +1,69 @@
+// Slack ingress helper: record an observable message into the agent-scoped
+// observed-conversation journal before wake/subscription filtering.
+//
+// Observation uses a broader predicate than runtime routability: userless
+// bot_message and file-only posts are journaled without changing wake routing.
+import { errorMessage } from '../ids.js';
+import { slackTsToIso } from '../slack/slack.helper.js';
+import { observedConversationStoreForAgent, } from '../storage/schema/observed-conversation.store.js';
+import { isObservableSlackMessage, slackEventTeamId, } from './slack-events.js';
+export async function observeObservableSlackMessage(input) {
+    const teamId = slackEventTeamId(input.envelope, input.event);
+    const store = observedConversationStoreForAgent(input.agentId);
+    const files = observedFilesFromSlack(input.event.files);
+    try {
+        return await store.observe({
+            ...(input.event.bot_id ? { botId: input.event.bot_id } : {}),
+            channelId: input.event.channel,
+            ...(files.length > 0 ? { files } : {}),
+            messageTs: input.event.ts,
+            ...(slackTsToIso(input.event.ts) ? { receivedAt: slackTsToIso(input.event.ts) } : {}),
+            teamId,
+            text: input.event.text ?? '',
+            ...(input.event.thread_ts ? { threadTs: input.event.thread_ts } : {}),
+            ...(input.event.user ? { userId: input.event.user } : {}),
+        });
+    }
+    catch (error) {
+        // store.observe already marks continuity degraded; helper only controls throw.
+        if (input.throwOnError)
+            throw error;
+        console.warn(`observed-conversation journal write failed for agent=${input.agentId} channel=${input.event.channel} ts=${input.event.ts}: ${errorMessage(error)}`);
+        return undefined;
+    }
+}
+/**
+ * Ingress entry: if the raw event is observable, journal it (fail-soft by
+ * default). Returns whether observation was attempted.
+ */
+export async function observeSlackEventAtIngress(input) {
+    if (!isObservableSlackMessage(input.event))
+        return undefined;
+    return observeObservableSlackMessage({
+        agentId: input.agentId,
+        envelope: input.envelope,
+        event: input.event,
+        ...(input.throwOnError ? { throwOnError: true } : {}),
+    });
+}
+/** @deprecated Use observeObservableSlackMessage / observeSlackEventAtIngress. */
+export const observeRoutableSlackMessage = observeObservableSlackMessage;
+export function observedFilesFromSlack(files) {
+    if (!Array.isArray(files) || files.length === 0)
+        return [];
+    const out = [];
+    for (const file of files) {
+        if (!file || typeof file.id !== 'string' || file.id.trim().length === 0)
+            continue;
+        const descriptor = { id: file.id };
+        if (typeof file.name === 'string' && file.name.length > 0)
+            descriptor.name = file.name;
+        else if (typeof file.title === 'string' && file.title.length > 0)
+            descriptor.name = file.title;
+        if (typeof file.mimetype === 'string' && file.mimetype.length > 0) {
+            descriptor.mimetype = file.mimetype;
+        }
+        out.push(descriptor);
+    }
+    return out;
+}

package/dist/server/inbox/slack-events.d.ts

@@ -35,6 +35,20 @@ export interface RoutableSlackMessage extends SlackRawMessageEvent {
     type: 'app_mention' | 'message';
     user: string;
 }
+/**
+ * Observable for the local observed-conversation journal — broader than runtime
+ * routability. Captures userless `bot_message` (bot_id only) and file-only posts
+ * without requiring a human `user`. Wake routing still uses isRoutableSlackMessage.
+ */
+export interface ObservableSlackMessage extends SlackRawMessageEvent {
+    channel: string;
+    ts: string;
+    type: 'app_mention' | 'message';
+    /** At least one of user / bot_id is present (enforced by the predicate). */
+    bot_id?: string;
+    user?: string;
+}
+export declare function isObservableSlackMessage(event: SlackRawMessageEvent): event is ObservableSlackMessage;
 export declare function isRoutableSlackMessage(event: SlackRawMessageEvent): event is RoutableSlackMessage;
 export declare function slackEventTeamId(envelope: SlackMessageEnvelope | undefined, event: SlackRawMessageEvent): string;
 export declare function normalizeSlackMessage(input: {

package/dist/server/inbox/slack-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slack-events.d.ts","sourceRoot":"","sources":["../../../server/inbox/slack-events.ts"],"names":[],"mappings":"AACA,OAAO,EAA0C,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGrG,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,QAAQ,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,GAAG,KAAK,IAAI,oBAAoB,CAUjG;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,oBAAoB,GAAG,SAAS,EAC1C,KAAK,EAAE,oBAAoB,GAC1B,MAAM,CAER;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC,GAAG,cAAc,CA2BjB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAEpE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAEpE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CAcxE"}
+{"version":3,"file":"slack-events.d.ts","sourceRoot":"","sources":["../../../server/inbox/slack-events.ts"],"names":[],"mappings":"AACA,OAAO,EAA0C,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGrG,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,QAAQ,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,oBAAoB,GAAG,KAAK,IAAI,sBAAsB,CAcrG;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,GAAG,KAAK,IAAI,oBAAoB,CAUjG;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,oBAAoB,GAAG,SAAS,EAC1C,KAAK,EAAE,oBAAoB,GAC1B,MAAM,CAER;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC,GAAG,cAAc,CA2BjB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAEpE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAEpE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CAcxE"}

package/dist/server/inbox/slack-events.js

@@ -2,6 +2,24 @@ import { nowIso, slackMessageEventId, slackSurfaceId } from '../ids.js';
 import { normalizeSlackEventFiles, slackTsToIso } from '../slack/slack.helper.js';
 import { slackMessagePreviewsFromAttachments } from '../slack/message-previews.js';
 import { slackVisibleMessageText } from '../slack/message-text.js';
+export function isObservableSlackMessage(event) {
+    if (event.type !== 'message' && event.type !== 'app_mention')
+        return false;
+    if (typeof event.channel !== 'string' || typeof event.ts !== 'string')
+        return false;
+    if (event.subtype !== undefined && event.subtype !== 'bot_message' && event.subtype !== 'file_share') {
+        return false;
+    }
+    const hasUser = typeof event.user === 'string' && event.user.length > 0;
+    const hasBot = typeof event.bot_id === 'string' && event.bot_id.length > 0;
+    if (!hasUser && !hasBot)
+        return false;
+    // text may be missing on bot_message; empty + files still counts.
+    const text = typeof event.text === 'string' ? event.text : '';
+    const hasText = text.trim().length > 0;
+    const hasFiles = Array.isArray(event.files) && event.files.length > 0;
+    return hasText || hasFiles;
+}
 export function isRoutableSlackMessage(event) {
     return ((event.type === 'message' || event.type === 'app_mention') &&
         typeof event.channel === 'string' &&

package/dist/server/inbox/slack-subscriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slack-subscriber.d.ts","sourceRoot":"","sources":["../../../server/inbox/slack-subscriber.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAmC5D,OAAO,EAAE,gBAAgB,EAA+B,MAAM,yBAAyB,CAAC;AAExF,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,uGAAuG;IACvG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,qBAAa,oBAAoB;IAQnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAG5D,OAAO,CAAC,0BAA0B,CAAS;gBAEd,OAAO,EAAE,2BAA2B;IAO3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,CAAC,SAAS;YAgFH,oBAAoB;YASpB,qBAAqB;YAOrB,0BAA0B;YA2C1B,kCAAkC;YAYlC,gBAAgB;IAgE9B,OAAO,CAAC,uBAAuB;CAYhC;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAC3E,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;CACpD,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhB"}
+{"version":3,"file":"slack-subscriber.d.ts","sourceRoot":"","sources":["../../../server/inbox/slack-subscriber.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAoC5D,OAAO,EAAE,gBAAgB,EAA+B,MAAM,yBAAyB,CAAC;AAExF,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,uGAAuG;IACvG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,qBAAa,oBAAoB;IAQnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;IACvD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8B;IAG5D,OAAO,CAAC,0BAA0B,CAAS;gBAEd,OAAO,EAAE,2BAA2B;IAO3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,CAAC,SAAS;YAgFH,oBAAoB;YASpB,qBAAqB;YAOrB,0BAA0B;YA2C1B,kCAAkC;YAYlC,gBAAgB;IA2E9B,OAAO,CAAC,uBAAuB;CAYhC;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAC3E,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;CACpD,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhB"}

package/dist/server/inbox/slack-subscriber.js

@@ -13,6 +13,7 @@ import { withCanonicalSlackVisibleText } from '../slack/message-text.js';
 import { isSlackEvent, isRoutableSlackMessage, slackEventTeamId, slackSurfaceForEvent, } from './slack-events.js';
 import { slackAttentionSuggestionPayload, } from './attention-suggestion-activity.js';
 import { runIngestPipeline } from './ingest-pipeline.js';
+import { observeSlackEventAtIngress } from './observed-conversation.js';
 import { buildSlackInboxItemWithLatePreview } from './slack-ingest.js';
 import { slackShortcutHandoffServiceForAgent } from './slack-shortcut-handoff.service.js';
 import { slackRuntimeDecision } from './slack-subscription.service.js';
@@ -192,9 +193,18 @@ export class SlackInboxSubscriber {
         // `text` can truncate before a trailing user mention; enrichment after an
         // ignore never runs, so mention detection must see the full body first.
         const rawEvent = withCanonicalSlackVisibleText(event);
+        const envelope = body;
+        // Observed-conversation journal (send-hold cut a): record every observable
+        // Slack message this agent process sees — including userless bot_message —
+        // BEFORE wake/subscription filtering and BEFORE isRoutableSlackMessage.
+        // Failures mark continuity degraded and never block routing.
+        await observeSlackEventAtIngress({
+            agentId: this.options.queue.agentId,
+            envelope,
+            event: rawEvent,
+        });
         if (!isRoutableSlackMessage(rawEvent))
             return;
-        const envelope = body;
         const teamId = slackEventTeamId(envelope, rawEvent);
         let latePreview;
         await runIngestPipeline({

package/dist/server/inbox/wake-queue.service.d.ts

@@ -51,6 +51,12 @@ export declare class WakeQueueService {
      * Remove a still-queued (unclaimed) item and mark it seen (true settle/dedupe).
      */
     withdrawQueued(itemId: string): Promise<InboxItem | undefined>;
+    /**
+     * Atomically settle multiple still-claimable queued items to seen (one store
+     * update). Cursor-delivery coalescing uses this so the selected same-surface
+     * set cannot partially land.
+     */
+    withdrawQueuedBatch(itemIds: string[]): Promise<InboxItem[]>;
     /**
      * Drop an uncommitted staged wake without a seen tombstone so the same fire
      * id remains reusable after cancel/snooze CAS miss.
@@ -75,6 +81,14 @@ export declare class WakeQueueService {
     requeue(itemId: string, options?: {
         resumeReason?: 'runtime_restart';
     }): Promise<void>;
+    /**
+     * Requeue without signalWake. Used when cursor-delivery prepare fails closed
+     * mid-drain: a wake would set pendingWake and immediately reclaim the same
+     * item in a hot loop. The regular poll timer retries later.
+     */
+    requeueQuiet(itemId: string, options?: {
+        resumeReason?: 'runtime_restart';
+    }): Promise<void>;
     requeueBatch(itemIds: string[]): Promise<InboxItem[]>;
     requeueAppendedTo(parentItemId: string, options?: {
         resumeReason?: 'runtime_restart';

package/dist/server/inbox/wake-queue.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wake-queue.service.d.ts","sourceRoot":"","sources":["../../../server/inbox/wake-queue.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wake-queue.service.d.ts","sourceRoot":"","sources":["../../../server/inbox/wake-queue.service.ts"],"names":[],"mappings":"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"}

package/dist/server/inbox/wake-queue.service.js

@@ -89,6 +89,14 @@ export class WakeQueueService {
     async withdrawQueued(itemId) {
         return this.store.withdrawQueued(itemId);
     }
+    /**
+     * Atomically settle multiple still-claimable queued items to seen (one store
+     * update). Cursor-delivery coalescing uses this so the selected same-surface
+     * set cannot partially land.
+     */
+    async withdrawQueuedBatch(itemIds) {
+        return this.store.withdrawQueuedBatch(itemIds);
+    }
     /**
      * Drop an uncommitted staged wake without a seen tombstone so the same fire
      * id remains reusable after cancel/snooze CAS miss.
@@ -156,6 +164,14 @@ export class WakeQueueService {
         await this.store.requeue(itemId, options);
         signalWake(this.agentId);
     }
+    /**
+     * Requeue without signalWake. Used when cursor-delivery prepare fails closed
+     * mid-drain: a wake would set pendingWake and immediately reclaim the same
+     * item in a hot loop. The regular poll timer retries later.
+     */
+    async requeueQuiet(itemId, options = {}) {
+        await this.store.requeue(itemId, options);
+    }
     async requeueBatch(itemIds) {
         const items = await this.store.requeueBatch(itemIds);
         if (items.length > 0)

package/dist/server/runtime/cursor-delivery.d.ts

@@ -0,0 +1,222 @@
+import type { WakeQueueService } from '../inbox/wake-queue.service.js';
+import { type AdvanceCursorExpected, type ObservedConversationEntry, type ObservedConversationStore } from '../storage/schema/observed-conversation.store.js';
+import type { InboxItem, SlackInboxItem } from '../../shared/inbox.js';
+/** Newest-fitting bound: max messages in the final provider-facing envelope. */
+export declare const CURSOR_DELIVERY_MAX_MESSAGES = 20;
+/**
+ * Max UTF-8 bytes of the final provider-facing rendered envelope (PRD / Iris):
+ * snapshot rows + Latest wake + previews + file metadata — everything the
+ * agent turn receives from the cursor view.
+ */
+export declare const CURSOR_DELIVERY_MAX_BYTES: number;
+/** Soft per-message clip so one row cannot consume the whole budget alone. */
+export declare const CURSOR_DELIVERY_MAX_MESSAGE_CHARS = 2000;
+export type CursorDeliveryFailureReason = 'continuity_degraded' | 'missing_trigger_observation' | 'store_error' | 'cas_failure';
+export declare class CursorDeliveryError extends Error {
+    readonly reason: CursorDeliveryFailureReason;
+    constructor(reason: CursorDeliveryFailureReason, message: string);
+}
+export interface SurfaceDeliveryPlan {
+    surfaceId: string;
+    /** What getCursor must match for CAS (absent or present@N). */
+    cursorExpected: AdvanceCursorExpected;
+    /** Inclusive ordinal to advance to (0 allowed for empty child-thread establish). */
+    nextDeliveredOrdinal: number;
+    lastDeliveredEventId?: string;
+    lastDeliveredMessageTs?: string;
+    /** Bounded journal rows delivered for this surface (chronological). */
+    entries: ObservedConversationEntry[];
+    /**
+     * Exact after-cursor population from the reconciled ordinal index
+     * (`tailOrdinal − deliveredOrdinal`), not the capped retained journal-read
+     * length. Used for “N earlier messages not shown” and merge union so archive
+     * retention / read limits cannot under-count the true conversation.
+     */
+    candidateCount: number;
+    /** Count of this surface's candidates not included due to the bound. */
+    omittedCount: number;
+    /** True when establishing present@0 with no journal rows. */
+    establishOnly: boolean;
+}
+export interface CursorDeliveryPlan {
+    agentId: string;
+    triggerItemId: string;
+    triggerEventId: string;
+    surfaces: SurfaceDeliveryPlan[];
+    /** Prompt body for the Slack wake (includes bounded context + latest wake). */
+    promptBody: string;
+    committed: boolean;
+}
+export type PrepareCursorDeliveryResult = {
+    kind: 'disabled';
+} | {
+    kind: 'already_delivered';
+    settledItemIds: string[];
+} | {
+    kind: 'prepared';
+    plan: CursorDeliveryPlan;
+} | {
+    kind: 'failed';
+    error: CursorDeliveryError;
+};
+export declare function setCursorDeliveryEnabledForTests(enabled: boolean | undefined): void;
+/**
+ * Resolve whether cursor delivery is on. Settings/read failures are errors
+ * (fail-closed), not silent disable — "enabled but unreadable" must not look
+ * like intentional off.
+ */
+export declare function resolveCursorDeliveryEnabled(): Promise<{
+    kind: 'enabled';
+} | {
+    kind: 'disabled';
+} | {
+    kind: 'error';
+    error: CursorDeliveryError;
+}>;
+/** Convenience: true only when explicitly enabled (throws on settings error). */
+export declare function isCursorDeliveryEnabled(): Promise<boolean>;
+/**
+ * Surfaces to snapshot for a Slack wake.
+ * - Top-level channel: channel surface + response-thread surface (thread:messageTs).
+ * - Thread reply: thread surface only.
+ * - DM: DM surface only.
+ */
+export declare function surfacesForSlackWake(item: SlackInboxItem): string[];
+export declare function triggerEventId(item: SlackInboxItem): string;
+/**
+ * Prepare at claim/start. Does not advance cursors or settle queue.
+ * When the trigger is already covered by the primary surface cursor, returns
+ * already_delivered so the worker can settle without a provider turn.
+ */
+export declare function prepareCursorDelivery(input: {
+    agentId: string;
+    item: InboxItem;
+    store?: ObservedConversationStore;
+}): Promise<PrepareCursorDeliveryResult>;
+/**
+ * Commit at runtime.started (or after follow-up accept).
+ *
+ * Idempotent only when live cursor is already at/past the plan target
+ * (`current >= target`). Any other expectation mismatch is fail-closed —
+ * never rewrite the prepared CAS expectation to the live cursor.
+ */
+export declare function commitCursorDelivery(input: {
+    plan: CursorDeliveryPlan;
+    queue: WakeQueueService;
+    /** Active/trigger item must not be settled by coalesce. */
+    excludeItemIds?: Iterable<string>;
+    store?: ObservedConversationStore;
+}): Promise<{
+    advanced: string[];
+    coalescedItemIds: string[];
+}>;
+/**
+ * Settle still-queued Slack wakes on the same exact surface whose observed
+ * ordinals are within the captured tail. Never touches the active item, other
+ * surfaces, later-than-tail rows, staged rows, or non-Slack items.
+ *
+ * Candidate selection is read-side; the settle is one atomic queue-store batch
+ * so the selected set moves to seen together.
+ */
+export declare function coalesceCoveredWakes(input: {
+    agentId: string;
+    queue: WakeQueueService;
+    surfaces: SurfaceDeliveryPlan[];
+    excludeItemIds: Set<string>;
+    store?: ObservedConversationStore;
+}): Promise<string[]>;
+/**
+ * Exact after-cursor count from a captured reconciled ordinal tail, not
+ * retained-window length. Fail-closed when the index cannot support the claim
+ * (missing index with retained rows, tail behind retained max, retained longer
+ * than the ordinal span, or captured tail row absent from the journal window).
+ *
+ * `candidates` must already be filtered through the same captured tail
+ * (`afterOrdinal < ordinal <= tail`).
+ */
+export declare function exactCandidateCountFromIndex(input: {
+    afterOrdinal: number;
+    candidates: ObservedConversationEntry[];
+    /** Captured reconciled journal-tail index; undefined when empty / unknown. */
+    index: {
+        tailOrdinal: number;
+        lastEventId?: string;
+    } | undefined;
+    isResponseThreadEstablish: boolean;
+    surfaceId: string;
+}): number;
+/** Conversation-time order for cross-surface selection (messageTs primary). */
+export declare function compareByConversationTime(a: {
+    messageTs: string;
+    receivedAt?: string;
+    ordinal?: number;
+}, b: {
+    messageTs: string;
+    receivedAt?: string;
+    ordinal?: number;
+}): number;
+/**
+ * Pure union of plans by exact surface id (no re-window). Entries deduped by
+ * eventId; cursorExpected prefers the more conservative (lower) present ordinal.
+ *
+ * Per-surface candidateCount is max(candidateCount_i) across plans (exact journal
+ * population after the same cursor). omitted = candidateCount − unique(entries).
+ * Never sum plan-local omitted aggregates across overlapping windows.
+ */
+export declare function mergeSurfacePlans(plans: CursorDeliveryPlan[]): SurfaceDeliveryPlan[];
+/**
+ * Merge plans and rebuild the full provider-facing envelope.
+ * Single-plan merge preserves surfaces/omitted; multi-plan unions then
+ * envelope-aware re-windows under 20/16KiB with prior omissions retained.
+ */
+export declare function mergeCursorDeliveryPlans(plans: CursorDeliveryPlan[], triggerItem: SlackInboxItem): CursorDeliveryPlan;
+/**
+ * Newest-fitting by conversation time using only line bytes (unit tests /
+ * internal). Prefer selectNewestFittingForEnvelope when advancing cursors.
+ */
+export declare function selectNewestFitting(candidates: ObservedConversationEntry[], options: {
+    maxMessages: number;
+    maxBytes: number;
+    mustIncludeEventId?: string;
+}): {
+    entries: ObservedConversationEntry[];
+    omittedCount: number;
+};
+/**
+ * Newest-fitting selection measured against the final provider-facing envelope
+ * (rows + Latest wake + previews + files). Only rows that fit are returned;
+ * nextDeliveredOrdinal must be derived from this set alone.
+ */
+export declare function selectNewestFittingForEnvelope(candidates: ObservedConversationEntry[], options: {
+    maxMessages: number;
+    maxBytes: number;
+    mustIncludeEventId?: string;
+    triggerItem?: SlackInboxItem;
+    totalCandidates?: number;
+}): {
+    entries: ObservedConversationEntry[];
+    omittedCount: number;
+};
+export declare function formatObservedLine(entry: ObservedConversationEntry): string;
+/** @deprecated Use renderCursorDeliveryEnvelope — same output, full envelope. */
+export declare function renderCursorDeliveryPrompt(trigger: SlackInboxItem, surfaces: SurfaceDeliveryPlan[]): string;
+/**
+ * Final provider-facing cursor envelope: chronological rows + Latest wake +
+ * previews/files. Must not post-truncate after nextDeliveredOrdinal is chosen;
+ * callers select rows so this string is already ≤ 16 KiB.
+ */
+export declare function renderCursorDeliveryEnvelope(trigger: SlackInboxItem, surfaces: SurfaceDeliveryPlan[]): string;
+export declare function renderCursorDeliveryEnvelopeFromEntries(trigger: SlackInboxItem, entries: ObservedConversationEntry[], omitted: number): string;
+/**
+ * Truncate to maxBytes UTF-8 without splitting code points / surrogate pairs.
+ * Used for per-message clip and extras clipping — not for post-plan row mutation.
+ */
+export declare function truncateUtf8(text: string, maxBytes: number): string;
+/**
+ * Clip previews/files so chrome + Latest wake + extras fit in the envelope
+ * budget even with zero snapshot rows. Never leave an over-cap prepared plan.
+ */
+export declare function clipTriggerExtrasForEnvelope(trigger: SlackInboxItem): SlackInboxItem;
+/** Primary surface id for a plan (grouping key for follow-up batching). */
+export declare function primarySurfaceId(plan: CursorDeliveryPlan): string;
+//# sourceMappingURL=cursor-delivery.d.ts.map

package/dist/server/runtime/cursor-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-delivery.d.ts","sourceRoot":"","sources":["../../../server/runtime/cursor-delivery.ts"],"names":[],"mappings":"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"}