@kuralle-agents/messaging 0.12.0 → 0.14.0

package/README.md

@@ -15,7 +15,7 @@ Provides the `PlatformClient` interface that every messaging vendor package impl
 - **`createMessagingRouter`** — creates a Hono router with webhook endpoints for each platform. Routes inbound messages to a `Runtime` turn, streams responses back as text or interactive messages, and handles deduplication and messaging window tracking automatically.
 - **`PlatformClient`** — interface that normalizes sending, receiving, media, webhooks, and format conversion across vendors. Implement this to add any messaging platform.
 - **`SessionResolver`** — maps inbound messages to Kuralle session IDs. Default: `{platform}:{threadId}`. Swap in `ThreadIdResolver`, `PhoneLookupResolver`, or a custom `SessionResolverChain`.
-- **`StreamMapper`** — consumes `AsyncIterable<HarnessStreamPart>`, sends typing indicators during streaming, delegates final output to a `ResponseMapper`.
+- **`StreamMapper`** — consumes `AsyncIterable<StreamPart>`, sends typing indicators during streaming, delegates final output to a `ResponseMapper`.
 - **`InboundLedger`** — async claim/append/complete ledger for tenant-scoped inbound idempotency and ordering.
 - **`WindowTracker`** / **`WindowStore`** — tracks 24-hour messaging windows per thread; used by `createMessagingRouter` to detect expired windows.
 - **`OutboundPipeline`** + **`windowGuard`** — window-safe outbound path (see below).
@@ -97,5 +97,5 @@ try {
 
 ## Related
 
-- [`@kuralle-agents/messaging-meta`](../kuralle-messaging-meta) — WhatsApp, Messenger, and Instagram clients
-- [`@kuralle-agents/core`](../kuralle-core) — runtime, agents, flows
+- [`@kuralle-agents/messaging-meta`](../messaging-meta) — WhatsApp, Messenger, and Instagram clients
+- [`@kuralle-agents/core`](../core) — runtime, agents, flows

package/dist/adapter/createMessagingRouter.js

@@ -210,12 +210,12 @@ function turnResult(parts) {
     return {
         parts,
         suspended: suspendedPart(parts),
-        handoffToHuman: parts.some((part) => part.type === 'handoff' && part.targetAgent === 'human'),
+        handoffToHuman: parts.some((part) => part.type === 'handoff' && part.payload.targetAgent === 'human'),
     };
 }
 function suspendedPart(parts) {
     const paused = parts.find((part) => part.type === 'paused');
-    return paused ? { signalId: paused.waitingFor } : undefined;
+    return paused ? { signalId: paused.payload.waitingFor } : undefined;
 }
 async function sendFallback(args) {
     const resolved = await (args.config.sessionResolver ?? defaultSessionResolver).resolve(args.message);

package/dist/adapter/stream-mapper.d.ts

@@ -1,8 +1,8 @@
-import type { HarnessStreamPart } from '@kuralle-agents/core';
+import type { StreamPart } from '@kuralle-agents/core';
 import type { PlatformClient, StreamMapperOptions } from '../types.js';
 export declare class StreamMapper {
-    mapStream(stream: AsyncIterable<HarnessStreamPart>, platform: PlatformClient, threadId: string, options: StreamMapperOptions): Promise<HarnessStreamPart[]>;
-    mapParts(parts: HarnessStreamPart[], platform: PlatformClient, threadId: string, options: StreamMapperOptions, textOverride?: string): Promise<void>;
+    mapStream(stream: AsyncIterable<StreamPart>, platform: PlatformClient, threadId: string, options: StreamMapperOptions): Promise<StreamPart[]>;
+    mapParts(parts: StreamPart[], platform: PlatformClient, threadId: string, options: StreamMapperOptions, textOverride?: string): Promise<void>;
     private buildMeta;
     private sendFreeform;
     private defaultMapResponse;

package/dist/adapter/stream-mapper.js

@@ -33,7 +33,7 @@ export class StreamMapper {
             for await (const part of stream) {
                 parts.push(part);
                 if (part.type === 'text-delta') {
-                    textBuffer += part.delta;
+                    textBuffer += part.payload.delta;
                 }
             }
             typingActive = false;
@@ -50,7 +50,7 @@ export class StreamMapper {
         const text = textOverride ??
             parts
                 .filter((part) => part.type === 'text-delta')
-                .map((part) => part.delta)
+                .map((part) => part.payload.delta)
                 .join('');
         const meta = await this.buildMeta(options.windowStore, threadId, parts, options.sessionId, options.userId);
         if (options.responseMapper) {
@@ -93,7 +93,7 @@ export class StreamMapper {
             .find((part) => part.type === 'interactive');
         if (interactivePart) {
             const trimmed = text.trim();
-            if (trimmed.length > 0 && trimmed !== interactivePart.prompt.trim()) {
+            if (trimmed.length > 0 && trimmed !== interactivePart.payload.prompt.trim()) {
                 await pipeline.send({
                     threadId,
                     platform: platform.platform,
@@ -106,7 +106,7 @@ export class StreamMapper {
                 platform: platform.platform,
                 payload: {
                     kind: 'interactive',
-                    interactive: renderChoices(interactivePart.options, interactivePart.prompt),
+                    interactive: renderChoices(interactivePart.payload.options, interactivePart.payload.prompt),
                 },
                 meta,
             });

package/dist/inbound/types.d.ts

@@ -1,4 +1,4 @@
-import type { HarnessStreamPart, ResolvedSelection, SignalDelivery, UserInputContent } from '@kuralle-agents/core';
+import type { StreamPart, ResolvedSelection, SignalDelivery, UserInputContent } from '@kuralle-agents/core';
 import type { ConsentStore } from '../adapter/consent-store.js';
 import type { MediaResolver } from './ports.js';
 import type { OwnershipStore } from '../adapter/ownership-store.js';
@@ -43,7 +43,7 @@ export type InboundEvent = {
     };
 };
 export interface TurnResult {
-    parts: HarnessStreamPart[];
+    parts: StreamPart[];
     suspended?: {
         signalId: string;
     };
@@ -88,7 +88,7 @@ export interface InboundRuntime {
 }
 export type InboundOutcome = {
     kind: 'ran';
-    parts: HarnessStreamPart[];
+    parts: StreamPart[];
 } | {
     kind: 'suspended';
     signalId: string;

package/dist/stream-filter.d.ts

@@ -1,22 +1,22 @@
-import type { HarnessStreamPart } from '@kuralle-agents/core';
-type Part<T extends HarnessStreamPart['type']> = Extract<HarnessStreamPart, {
+import type { StreamPart } from '@kuralle-agents/core';
+type Part<T extends StreamPart['type']> = Extract<StreamPart, {
     type: T;
 }>;
 export declare const filterStreamParts: {
-    readonly textDelta: (p: HarnessStreamPart) => p is Part<"text-delta">;
-    readonly toolCall: (p: HarnessStreamPart) => p is Part<"tool-call">;
-    readonly toolResult: (p: HarnessStreamPart) => p is Part<"tool-result">;
-    readonly handoff: (p: HarnessStreamPart) => p is Part<"handoff">;
-    readonly nodeEnter: (p: HarnessStreamPart) => p is Part<"node-enter">;
-    readonly nodeExit: (p: HarnessStreamPart) => p is Part<"node-exit">;
-    readonly flowEnter: (p: HarnessStreamPart) => p is Part<"flow-enter">;
-    readonly flowTransition: (p: HarnessStreamPart) => p is Part<"flow-transition">;
-    readonly flowEnd: (p: HarnessStreamPart) => p is Part<"flow-end">;
-    readonly turnEnd: (p: HarnessStreamPart) => p is Part<"turn-end">;
-    readonly done: (p: HarnessStreamPart) => p is Part<"done">;
-    readonly errorEvent: (p: HarnessStreamPart) => p is Part<"error">;
-    readonly interrupted: (p: HarnessStreamPart) => p is Part<"interrupted">;
-    readonly paused: (p: HarnessStreamPart) => p is Part<"paused">;
-    readonly conversationOutcome: (p: HarnessStreamPart) => p is Part<"conversation-outcome">;
+    readonly textDelta: (p: StreamPart) => p is Part<"text-delta">;
+    readonly toolCall: (p: StreamPart) => p is Part<"tool-call">;
+    readonly toolResult: (p: StreamPart) => p is Part<"tool-result">;
+    readonly handoff: (p: StreamPart) => p is Part<"handoff">;
+    readonly nodeEnter: (p: StreamPart) => p is Part<"node-enter">;
+    readonly nodeExit: (p: StreamPart) => p is Part<"node-exit">;
+    readonly flowEnter: (p: StreamPart) => p is Part<"flow-enter">;
+    readonly flowTransition: (p: StreamPart) => p is Part<"flow-transition">;
+    readonly flowEnd: (p: StreamPart) => p is Part<"flow-end">;
+    readonly turnEnd: (p: StreamPart) => p is Part<"turn-end">;
+    readonly done: (p: StreamPart) => p is Part<"done">;
+    readonly errorEvent: (p: StreamPart) => p is Part<"error">;
+    readonly interrupted: (p: StreamPart) => p is Part<"interrupted">;
+    readonly paused: (p: StreamPart) => p is Part<"paused">;
+    readonly conversationOutcome: (p: StreamPart) => p is Part<"conversation-outcome">;
 };
 export {};

package/dist/types/adapter.d.ts

@@ -4,7 +4,7 @@
  * Adapter types: session resolution, response mapping, error context,
  * router config, and stream mapper options.
  */
-import type { RuntimeLike, HarnessStreamPart, ResolvedSelection, UserInputContent, InjectableTimer } from '@kuralle-agents/core';
+import type { RuntimeLike, StreamPart, ResolvedSelection, UserInputContent, InjectableTimer } from '@kuralle-agents/core';
 import type { OutboundPipeline } from '../adapter/outbound-pipeline.js';
 import type { WindowStore } from '../adapter/window-store.js';
 import type { ConsentStore } from '../adapter/consent-store.js';
@@ -37,7 +37,7 @@ export interface ResponseContext {
  * Custom mapper that controls how Kuralle stream output is sent to the platform.
  */
 export interface ResponseMapper {
-    mapResponse(parts: HarnessStreamPart[], context: ResponseContext): Promise<void>;
+    mapResponse(parts: StreamPart[], context: ResponseContext): Promise<void>;
 }
 /** Error context provided to the onError callback. */
 export interface ErrorContext {

package/dist/types/outbound.d.ts

@@ -1,4 +1,4 @@
-import type { HarnessStreamPart } from '@kuralle-agents/core';
+import type { StreamPart } from '@kuralle-agents/core';
 import type { WindowState } from '../adapter/window-store.js';
 import type { InteractiveMessage, MediaPayload } from './messages.js';
 import type { SendResult } from './responses.js';
@@ -50,7 +50,7 @@ export type OutboundPayload = {
 };
 export interface OutboundMeta {
     window: WindowState;
-    parts: HarnessStreamPart[];
+    parts: StreamPart[];
     sessionId: string;
     userId?: string;
 }

package/package.json

@@ -4,9 +4,9 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kuralle/kuralle-agents.git",
-    "directory": "packages/kuralle-messaging"
+    "directory": "packages/messaging"
   },
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Core interfaces and Kuralle adapter for messaging platforms",
   "type": "module",
   "main": "dist/index.js",
@@ -26,7 +26,7 @@
   ],
   "dependencies": {
     "hono": "^4.7.4",
-    "@kuralle-agents/core": "0.12.0"
+    "@kuralle-agents/core": "0.14.0"
   },
   "devDependencies": {
     "typescript": "^5.8.2",