@bbigbang/protocol 0.1.0

package/dist/agentSurface.d.ts

@@ -0,0 +1,5 @@
+export declare const AGENT_SURFACE_MODES: readonly ["bigbang", "mcp"];
+export type AgentSurfaceMode = (typeof AGENT_SURFACE_MODES)[number];
+export declare const DEFAULT_AGENT_SURFACE_MODE: AgentSurfaceMode;
+export declare const AGENT_SURFACE_MODE_ENV = "BIGBANG_AGENT_SURFACE";
+export declare function normalizeAgentSurfaceMode(value: string | null | undefined): AgentSurfaceMode;

package/dist/agentSurface.js

@@ -0,0 +1,11 @@
+export const AGENT_SURFACE_MODES = ['bigbang', 'mcp'];
+export const DEFAULT_AGENT_SURFACE_MODE = 'bigbang';
+export const AGENT_SURFACE_MODE_ENV = 'BIGBANG_AGENT_SURFACE';
+export function normalizeAgentSurfaceMode(value) {
+    const normalized = value?.trim().toLowerCase();
+    if (!normalized)
+        return DEFAULT_AGENT_SURFACE_MODE;
+    if (normalized === 'bigbang' || normalized === 'mcp')
+        return normalized;
+    throw new Error(`Invalid ${AGENT_SURFACE_MODE_ENV} value "${value}". Expected one of: ${AGENT_SURFACE_MODES.join(', ')}.`);
+}

package/dist/handoff.d.ts

@@ -0,0 +1,45 @@
+export type ConversationHandoffMode = 'delegate_only' | 'continue_there' | 'collab';
+export type ConversationHandoffStatus = 'started' | 'accepted' | 'completed' | 'cancelled' | 'failed';
+export type ConversationHandoffWorkflowKind = 'generic' | 'dm_task_thread' | 'channel_task_thread';
+export type ConversationHandoffSourceDisposition = 'keep_running' | 'cancel_current_run';
+export type ConversationHandoffPayload = {
+    goal: string;
+    whyNow: string | null;
+    constraints: string[];
+    alreadyDone: string[];
+    expectedOutput: string | null;
+    sourceTarget: string | null;
+    relatedTaskRef: string | null;
+    optionalRefs: string[];
+    sourceSummary: string | null;
+    sourceRollingSummary: string | null;
+    targetRunId: string | null;
+    cancelRunId: string | null;
+    completionMessageId: string | null;
+    error: string | null;
+    sourceContext: {
+        lastUserMessage: string | null;
+        lastAgentMessage: string | null;
+        boundTaskRef: string | null;
+        boundTaskTitle: string | null;
+        ownerName: string | null;
+        participants: string[];
+        myRole: string | null;
+    } | null;
+};
+export type ConversationHandoffRecord = {
+    handoffId: string;
+    agentId: string;
+    sourceConversationId: string;
+    targetConversationId: string | null;
+    targetReplyTarget: string;
+    workflowKind: ConversationHandoffWorkflowKind;
+    sourceDisposition: ConversationHandoffSourceDisposition;
+    taskId: string | null;
+    taskNumber: number | null;
+    mode: ConversationHandoffMode;
+    status: ConversationHandoffStatus;
+    payload: ConversationHandoffPayload;
+    createdAt: string;
+    updatedAt: string;
+};

package/dist/handoff.js

@@ -0,0 +1,6 @@
+// ─── Conversation handoff types ───
+//
+// These types are shared between core and channel-bridge.
+// The runtime functions (createConversationHandoff, etc.) remain in core
+// because they depend on the DB layer (@bbigbang/runtime-acp).
+export {};