@neta-art/cohub-protocol 1.2.2 → 1.2.3

package/dist/gateway/index.d.ts

@@ -1,6 +1,272 @@
+import { z } from "zod";
 import type { ContentBlock } from "../core/content.js";
 import type { MessageRecord } from "../model/session.js";
 export type ChannelProvider = "web" | "websocket" | "discord" | "feishu" | "telegram" | "slack";
+export declare const GATEWAY_CHANNEL_COMMAND_SPECS: readonly [{
+    readonly name: "new";
+    readonly slash: "/new";
+    readonly description: "Start a new Cohub session for this conversation.";
+}, {
+    readonly name: "status";
+    readonly slash: "/status";
+    readonly description: "Show the current Cohub session status.";
+}];
+export type GatewayChannelCommandName = typeof GATEWAY_CHANNEL_COMMAND_SPECS[number]["name"];
+export interface GatewayChannelCommand {
+    name: GatewayChannelCommandName;
+    rawText?: string;
+    args?: string;
+}
+export type GatewayInboundBinding = {
+    key: string;
+    parentKey?: string | null;
+};
+export declare const gatewayChannelCommandNameSchema: z.ZodEnum<{
+    status: "status";
+    new: "new";
+}>;
+export declare const gatewayChannelCommandSchema: z.ZodObject<{
+    name: z.ZodEnum<{
+        status: "status";
+        new: "new";
+    }>;
+    rawText: z.ZodOptional<z.ZodString>;
+    args: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const gatewayMessageCreateEventSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    timestamp: z.ZodNumber;
+    channelId: z.ZodString;
+    provider: z.ZodEnum<{
+        web: "web";
+        websocket: "websocket";
+        discord: "discord";
+        feishu: "feishu";
+        telegram: "telegram";
+        slack: "slack";
+    }>;
+    externalChatId: z.ZodString;
+    externalMessageId: z.ZodString;
+    bindingKey: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        parentKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    conversation: z.ZodObject<{
+        id: z.ZodString;
+        parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>;
+    message: z.ZodOptional<z.ZodObject<{
+        parentMessageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>>;
+    sender: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    content: z.ZodArray<z.ZodType<ContentBlock, unknown, z.core.$ZodTypeInternals<ContentBlock, unknown>>>;
+    meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    eventType: z.ZodLiteral<"message_create">;
+    command: z.ZodOptional<z.ZodNever>;
+}, z.core.$loose>;
+export declare const gatewayConversationCreateEventSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    timestamp: z.ZodNumber;
+    channelId: z.ZodString;
+    provider: z.ZodEnum<{
+        web: "web";
+        websocket: "websocket";
+        discord: "discord";
+        feishu: "feishu";
+        telegram: "telegram";
+        slack: "slack";
+    }>;
+    externalChatId: z.ZodString;
+    externalMessageId: z.ZodString;
+    bindingKey: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        parentKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    conversation: z.ZodObject<{
+        id: z.ZodString;
+        parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>;
+    message: z.ZodOptional<z.ZodObject<{
+        parentMessageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>>;
+    sender: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    content: z.ZodArray<z.ZodType<ContentBlock, unknown, z.core.$ZodTypeInternals<ContentBlock, unknown>>>;
+    meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    eventType: z.ZodLiteral<"conversation_create">;
+    command: z.ZodOptional<z.ZodNever>;
+}, z.core.$loose>;
+export declare const gatewayChannelCommandEventSchema: z.ZodObject<{
+    eventId: z.ZodString;
+    timestamp: z.ZodNumber;
+    channelId: z.ZodString;
+    provider: z.ZodEnum<{
+        web: "web";
+        websocket: "websocket";
+        discord: "discord";
+        feishu: "feishu";
+        telegram: "telegram";
+        slack: "slack";
+    }>;
+    externalChatId: z.ZodString;
+    externalMessageId: z.ZodString;
+    bindingKey: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        parentKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    conversation: z.ZodObject<{
+        id: z.ZodString;
+        parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>;
+    message: z.ZodOptional<z.ZodObject<{
+        parentMessageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>>;
+    sender: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    content: z.ZodArray<z.ZodType<ContentBlock, unknown, z.core.$ZodTypeInternals<ContentBlock, unknown>>>;
+    meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    eventType: z.ZodLiteral<"channel_command">;
+    command: z.ZodObject<{
+        name: z.ZodEnum<{
+            status: "status";
+            new: "new";
+        }>;
+        rawText: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$loose>;
+export declare const gatewayInboundEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    eventId: z.ZodString;
+    timestamp: z.ZodNumber;
+    channelId: z.ZodString;
+    provider: z.ZodEnum<{
+        web: "web";
+        websocket: "websocket";
+        discord: "discord";
+        feishu: "feishu";
+        telegram: "telegram";
+        slack: "slack";
+    }>;
+    externalChatId: z.ZodString;
+    externalMessageId: z.ZodString;
+    bindingKey: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        parentKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    conversation: z.ZodObject<{
+        id: z.ZodString;
+        parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>;
+    message: z.ZodOptional<z.ZodObject<{
+        parentMessageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>>;
+    sender: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    content: z.ZodArray<z.ZodType<ContentBlock, unknown, z.core.$ZodTypeInternals<ContentBlock, unknown>>>;
+    meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    eventType: z.ZodLiteral<"message_create">;
+    command: z.ZodOptional<z.ZodNever>;
+}, z.core.$loose>, z.ZodObject<{
+    eventId: z.ZodString;
+    timestamp: z.ZodNumber;
+    channelId: z.ZodString;
+    provider: z.ZodEnum<{
+        web: "web";
+        websocket: "websocket";
+        discord: "discord";
+        feishu: "feishu";
+        telegram: "telegram";
+        slack: "slack";
+    }>;
+    externalChatId: z.ZodString;
+    externalMessageId: z.ZodString;
+    bindingKey: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        parentKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    conversation: z.ZodObject<{
+        id: z.ZodString;
+        parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>;
+    message: z.ZodOptional<z.ZodObject<{
+        parentMessageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>>;
+    sender: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    content: z.ZodArray<z.ZodType<ContentBlock, unknown, z.core.$ZodTypeInternals<ContentBlock, unknown>>>;
+    meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    eventType: z.ZodLiteral<"conversation_create">;
+    command: z.ZodOptional<z.ZodNever>;
+}, z.core.$loose>, z.ZodObject<{
+    eventId: z.ZodString;
+    timestamp: z.ZodNumber;
+    channelId: z.ZodString;
+    provider: z.ZodEnum<{
+        web: "web";
+        websocket: "websocket";
+        discord: "discord";
+        feishu: "feishu";
+        telegram: "telegram";
+        slack: "slack";
+    }>;
+    externalChatId: z.ZodString;
+    externalMessageId: z.ZodString;
+    bindingKey: z.ZodOptional<z.ZodString>;
+    binding: z.ZodOptional<z.ZodObject<{
+        key: z.ZodString;
+        parentKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    conversation: z.ZodObject<{
+        id: z.ZodString;
+        parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>;
+    message: z.ZodOptional<z.ZodObject<{
+        parentMessageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>>;
+    sender: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    content: z.ZodArray<z.ZodType<ContentBlock, unknown, z.core.$ZodTypeInternals<ContentBlock, unknown>>>;
+    meta: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    eventType: z.ZodLiteral<"channel_command">;
+    command: z.ZodObject<{
+        name: z.ZodEnum<{
+            status: "status";
+            new: "new";
+        }>;
+        rawText: z.ZodOptional<z.ZodString>;
+        args: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$loose>], "eventType">;
 export interface DiscordChannelConfig {
     inbound?: {
         requireMentionInGuild?: boolean;
@@ -22,15 +288,15 @@ export interface FeishuChannelConfig {
     };
 }
 export type ChannelConfig = DiscordChannelConfig | FeishuChannelConfig | Record<string, unknown>;
-export interface GatewayInboundEvent {
+export interface GatewayInboundEventBase {
     eventId: string;
     timestamp: number;
-    eventType?: "message_create" | "conversation_create";
     channelId: string;
     provider: ChannelProvider;
     externalChatId: string;
     externalMessageId: string;
     bindingKey?: string;
+    binding?: GatewayInboundBinding;
     conversation: {
         id: string;
         parentId?: string | null;
@@ -47,6 +313,19 @@ export interface GatewayInboundEvent {
     content: ContentBlock[];
     meta?: Record<string, unknown> | null;
 }
+export interface GatewayMessageCreateEvent extends GatewayInboundEventBase {
+    eventType: "message_create";
+    command?: never;
+}
+export interface GatewayConversationCreateEvent extends GatewayInboundEventBase {
+    eventType: "conversation_create";
+    command?: never;
+}
+export interface GatewayChannelCommandEvent extends GatewayInboundEventBase {
+    eventType: "channel_command";
+    command: GatewayChannelCommand;
+}
+export type GatewayInboundEvent = GatewayMessageCreateEvent | GatewayConversationCreateEvent | GatewayChannelCommandEvent;
 export interface GatewaySessionOutputBase {
     type: "session.turn.patch" | "session.turn.error" | "session.message.persisted";
     spaceId: string;
@@ -80,6 +359,7 @@ export interface GatewaySessionTurnPatchOutput extends GatewaySessionOutputBase
     type: "session.turn.patch";
     turnId: string | null;
     messageId: string | null;
+    messageOrdinal?: number | null;
     anchorUserMessageId: string | null;
     seq: number;
     baseSeq: number;

package/dist/gateway/index.js

@@ -1 +1,113 @@
-export {};
+import { z } from "zod";
+export const GATEWAY_CHANNEL_COMMAND_SPECS = [
+    {
+        name: "new",
+        slash: "/new",
+        description: "Start a new Cohub session for this conversation.",
+    },
+    {
+        name: "status",
+        slash: "/status",
+        description: "Show the current Cohub session status.",
+    },
+];
+const GATEWAY_CHANNEL_COMMAND_NAMES = GATEWAY_CHANNEL_COMMAND_SPECS.map((spec) => spec.name);
+const recordSchema = z.record(z.string(), z.unknown());
+const contentBlockMetaSchema = recordSchema;
+const contentBlockSchema = z.lazy(() => z.discriminatedUnion("type", [
+    z.object({
+        type: z.literal("text"),
+        text: z.string(),
+        _meta: contentBlockMetaSchema.optional(),
+    }),
+    z.object({
+        type: z.literal("thinking"),
+        thinking: z.string(),
+        signature: z.string().optional(),
+        _meta: contentBlockMetaSchema.optional(),
+    }),
+    z.object({
+        type: z.literal("image"),
+        source: z.union([
+            z.object({ type: z.literal("url"), url: z.string() }),
+            z.object({ type: z.literal("base64"), media_type: z.string(), data: z.string() }),
+        ]),
+        _meta: contentBlockMetaSchema.optional(),
+    }),
+    z.object({
+        type: z.literal("tool_use"),
+        id: z.string(),
+        name: z.string(),
+        input: recordSchema,
+        _meta: contentBlockMetaSchema.optional(),
+    }),
+    z.object({
+        type: z.literal("tool_result"),
+        tool_use_id: z.string(),
+        content: z.union([z.string(), z.array(contentBlockSchema)]),
+        is_error: z.boolean().optional(),
+        _meta: contentBlockMetaSchema.optional(),
+    }),
+    z.object({
+        type: z.literal("system_note"),
+        note_type: z.enum(["session_created", "forked", "compacted", "info"]),
+        text: z.string(),
+        _meta: contentBlockMetaSchema.optional(),
+    }),
+]));
+export const gatewayChannelCommandNameSchema = z.enum(GATEWAY_CHANNEL_COMMAND_NAMES);
+export const gatewayChannelCommandSchema = z.object({
+    name: gatewayChannelCommandNameSchema,
+    rawText: z.string().optional(),
+    args: z.string().optional(),
+});
+const channelProviderSchema = z.enum(["web", "websocket", "discord", "feishu", "telegram", "slack"]);
+const gatewayInboundBindingSchema = z.object({
+    key: z.string().min(1),
+    parentKey: z.string().min(1).nullable().optional(),
+});
+const gatewayInboundConversationSchema = z.object({
+    id: z.string(),
+    parentId: z.string().nullable().optional(),
+    meta: recordSchema.nullable().optional(),
+});
+const gatewayInboundMessageSchema = z.object({
+    parentMessageId: z.string().nullable().optional(),
+    meta: recordSchema.nullable().optional(),
+});
+const gatewayInboundSenderSchema = z.object({
+    id: z.string(),
+    name: z.string().optional(),
+});
+const gatewayInboundEventBaseSchema = z.object({
+    eventId: z.string(),
+    timestamp: z.number(),
+    channelId: z.string(),
+    provider: channelProviderSchema,
+    externalChatId: z.string(),
+    externalMessageId: z.string(),
+    bindingKey: z.string().optional(),
+    binding: gatewayInboundBindingSchema.optional(),
+    conversation: gatewayInboundConversationSchema,
+    message: gatewayInboundMessageSchema.optional(),
+    sender: gatewayInboundSenderSchema,
+    content: z.array(contentBlockSchema),
+    meta: recordSchema.nullable().optional(),
+});
+export const gatewayMessageCreateEventSchema = gatewayInboundEventBaseSchema.extend({
+    eventType: z.literal("message_create"),
+    command: z.never().optional(),
+}).passthrough();
+export const gatewayConversationCreateEventSchema = gatewayInboundEventBaseSchema.extend({
+    eventType: z.literal("conversation_create"),
+    command: z.never().optional(),
+}).passthrough();
+export const gatewayChannelCommandEventSchema = gatewayInboundEventBaseSchema.extend({
+    eventType: z.literal("channel_command"),
+    command: gatewayChannelCommandSchema,
+}).passthrough();
+export const gatewayInboundEventSchema = z.discriminatedUnion("eventType", [
+    gatewayMessageCreateEventSchema,
+    gatewayConversationCreateEventSchema,
+    gatewayChannelCommandEventSchema,
+]);

package/dist/gateway.d.ts

@@ -0,0 +1,136 @@
+export type ChannelProvider = "web" | "websocket" | "discord" | "feishu" | "telegram" | "slack";
+export declare function buildSessionSourceChannel(event: GatewayInboundEvent): string;
+export interface DiscordChannelConfig {
+    inbound?: {
+        requireMentionInGuild?: boolean;
+    };
+    outbound?: {
+        showThinking?: boolean;
+        showToolCalls?: boolean;
+    };
+}
+export type ChannelConfig = DiscordChannelConfig | FeishuChannelConfig | Record<string, unknown>;
+export interface FeishuChannelConfig {
+    brand?: "feishu" | "lark";
+    inbound?: {
+        requireMentionInGroup?: boolean;
+    };
+    outbound?: {
+        renderMode?: "card" | "post";
+        showThinking?: boolean;
+        showToolCalls?: boolean;
+    };
+}
+export interface GatewayInboundEvent {
+    eventId: string;
+    timestamp: number;
+    eventType?: "message_create" | "conversation_create";
+    channelId: string;
+    provider: ChannelProvider;
+    externalChatId: string;
+    externalMessageId: string;
+    bindingKey?: string;
+    conversation: {
+        id: string;
+        parentId?: string | null;
+        meta?: Record<string, unknown> | null;
+    };
+    message?: {
+        parentMessageId?: string | null;
+        meta?: Record<string, unknown> | null;
+    };
+    sender: {
+        id: string;
+        name?: string;
+    };
+    content: import("./session-ingestion.js").ContentBlock[];
+    meta?: Record<string, unknown> | null;
+}
+export interface GatewaySessionOutputBase {
+    type: "session.turn.progress" | "session.turn.final" | "session.turn.error" | "session.message.persisted";
+    spaceId: string;
+    sessionId: string;
+}
+export interface GatewaySessionTurnProgressOutput extends GatewaySessionOutputBase {
+    type: "session.turn.progress";
+    anchorUserMessageId: string | null;
+    content: import("./session-ingestion.js").ContentBlock[];
+}
+export interface GatewaySessionTurnFinalOutput extends GatewaySessionOutputBase {
+    type: "session.turn.final";
+    sessionMessageId: string | null;
+    anchorUserMessageId: string | null;
+    content: import("./session-ingestion.js").ContentBlock[];
+}
+export interface GatewaySessionTurnErrorOutput extends GatewaySessionOutputBase {
+    type: "session.turn.error";
+    anchorUserMessageId: string | null;
+    error: string;
+}
+export interface GatewaySessionMessagePersistedOutput extends GatewaySessionOutputBase {
+    type: "session.message.persisted";
+    message: import("./session-ingestion.js").MessageRecord;
+}
+export type GatewaySessionOutput = GatewaySessionTurnProgressOutput | GatewaySessionTurnFinalOutput | GatewaySessionTurnErrorOutput | GatewaySessionMessagePersistedOutput;
+export interface DiscordDeliveryPlan {
+    adapter: "discord";
+    mode: "send" | "upsert";
+    primaryText: string;
+    continuationChunks: string[];
+    files: string[];
+    replyToExternalMessageId?: string;
+    turnAnchorMessageId?: string | null;
+    preferredEditExternalMessageId?: string | null;
+}
+export interface FeishuDeliveryPlan {
+    adapter: "feishu";
+    mode: "create_or_update";
+    renderMode: "card" | "post";
+    msgType: "interactive" | "post";
+    content: string;
+    imageKeys: string[];
+    replyToExternalMessageId?: string;
+    turnAnchorMessageId?: string | null;
+    preferredEditExternalMessageId?: string | null;
+}
+export type GatewayDeliveryPlan = DiscordDeliveryPlan | FeishuDeliveryPlan;
+export interface GatewayOutboundCommand {
+    commandId: string;
+    timestamp: number;
+    channelId: string;
+    provider: ChannelProvider;
+    externalChatId: string;
+    content: import("./session-ingestion.js").ContentBlock[];
+    replyToExternalMessageId?: string;
+    spaceId?: string;
+    spaceSessionId?: string;
+    sessionMessageId?: string;
+    deliveryPlan?: GatewayDeliveryPlan | null;
+    meta?: (Record<string, unknown> & {
+        sessionOutput?: GatewaySessionOutput | null;
+    }) | null;
+}
+export interface GatewayControlCommand {
+    action: "connect" | "disconnect" | "reload";
+    configs: {
+        channelId: string;
+        provider: ChannelProvider;
+        credentials: Record<string, unknown>;
+    }[];
+}
+export type GatewayLogDirection = "inbound" | "outbound";
+export type GatewayLogStatus = "pending" | "success" | "failed";
+export interface GatewayLogEvent {
+    logId: string;
+    timestamp: number;
+    direction: GatewayLogDirection;
+    provider: ChannelProvider;
+    channelId: string;
+    externalChatId: string;
+    externalMessageId?: string;
+    rawPayload: Record<string, unknown>;
+    normalizedPayload?: Record<string, unknown>;
+    status: GatewayLogStatus;
+    errorMessage?: string;
+    correlationId?: string;
+}

package/dist/gateway.js

@@ -0,0 +1,48 @@
+export function buildSessionSourceChannel(event) {
+    const provider = event.provider;
+    const meta = (event.conversation?.meta ?? event.meta ?? {});
+    switch (provider) {
+        case "discord":
+            return buildDiscordSourceChannel(event, meta);
+        case "feishu":
+            return buildFeishuSourceChannel(event, meta);
+        case "web":
+            return "web";
+        default:
+            return `${provider}:${event.conversation?.id?.trim() || event.externalChatId}`;
+    }
+}
+function buildDiscordSourceChannel(event, meta) {
+    const isDm = meta.isDm === true;
+    const guildName = typeof meta.guildName === "string" ? meta.guildName : null;
+    const channelName = typeof meta.channelName === "string" ? meta.channelName : null;
+    const parentChannelName = typeof meta.parentChannelName === "string" ? meta.parentChannelName : null;
+    const threadName = typeof meta.threadName === "string" ? meta.threadName : null;
+    const senderName = event.sender?.name ?? null;
+    if (isDm) {
+        return `discord:dm:${senderName ?? event.sender.id}`;
+    }
+    if (threadName && parentChannelName && guildName) {
+        return `discord:${guildName}:#${parentChannelName}>${threadName}`;
+    }
+    if (channelName && guildName) {
+        return `discord:${guildName}:#${channelName}`;
+    }
+    if (guildName) {
+        return `discord:${guildName}`;
+    }
+    return `discord:${event.conversation?.id?.trim() || event.externalChatId}`;
+}
+function buildFeishuSourceChannel(event, meta) {
+    const chatType = meta.chatType;
+    const chatName = typeof meta.chatName === "string" ? meta.chatName : null;
+    const senderName = event.sender?.name ?? null;
+    const isDm = chatType === "p2p";
+    if (isDm) {
+        return `feishu:dm:${senderName ?? event.sender.id}`;
+    }
+    if (chatName) {
+        return `feishu:group:${chatName}`;
+    }
+    return `feishu:${event.conversation?.id?.trim() || event.externalChatId}`;
+}

package/dist/index.d.ts

@@ -7,3 +7,4 @@ export * from "./realtime/websocket.js";
 export * from "./gateway/index.js";
 export * from "./task/index.js";
 export * from "./fs/index.js";
+export * from "./ports/index.js";

package/dist/index.js

@@ -7,3 +7,4 @@ export * from "./realtime/websocket.js";
 export * from "./gateway/index.js";
 export * from "./task/index.js";
 export * from "./fs/index.js";
+export * from "./ports/index.js";

package/dist/model/session.d.ts

@@ -1,6 +1,6 @@
 import type { ContentBlock } from "../core/content.js";
 import type { Usage } from "../core/usage.js";
-export type { MessageToolCallsFile, SessionTurnIntent, SessionTurnIntermediateIndex, SessionTurnIntermediateSummary, SessionTurnRecord, SessionTurnStatus, SessionTurnSummary, StoredIntermediateMessage, StoredIntermediateMessageToolCallSummary, StoredToolCall, TurnIntermediateMessagesFile, } from "./turn.js";
+export type { MessageToolCallsFile, SessionTurnIntent, SessionTurnIntermediateIndex, SessionTurnIntermediateSummary, SessionTurnIndexItem, SessionTurnRecord, SessionTurnStatus, SessionTurnSummary, StoredIntermediateMessage, StoredToolCall, TurnIntermediateMessagesFile, } from "./turn.js";
 export type SessionPromptInput = {
     spaceId: string;
     sessionId: string;