@bbigbang/protocol 0.1.0

package/dist/index.js

@@ -0,0 +1,398 @@
+// ─── 服务端 → 客户端 事件 ───
+export { validatePanelTemplateProps } from './panel.js';
+export { collectDatasetAggregateNodes, collectPanelLevelActionBars, collectPanelLevelParameterInputs, collectPanelLevelUnsupportedNodes, collectPanelTemplateUnsupportedNodes, isPanelLevelActionBarNode, isPanelLevelContainerNode, isPanelLevelDatasetAggregateNode, isPanelLevelNodeEffectivelyEmpty, isPanelLevelParameterInputNode, isPanelTemplateContainerNode, mapPanelLevelNodes, matchPanelApiJsonlAllowedUrlPrefix, normalizePanelApiJsonlAuthProfileName, normalizePanelApiJsonlAuthProfileNames, normalizePanelApiJsonlAllowedUrlPrefix, normalizePanelApiJsonlAllowedUrlPrefixes, panelLevelNodeContainsEmptyLayoutContainer, panelLevelNodeHasActionBar, panelLevelNodeUsesDatasetAggregate, validatePanelApiJsonlAuthProfile, validatePanelApiJsonlUrl, validatePanelApiJsonlUrlList, walkPanelTemplateNodes, walkPanelLevelNodes, } from './panel.js';
+export { AGENT_SURFACE_MODE_ENV, AGENT_SURFACE_MODES, DEFAULT_AGENT_SURFACE_MODE, normalizeAgentSurfaceMode, } from './agentSurface.js';
+export const BUILTIN_UI_PANEL_SKILL_ROOT_SENTINEL = 'bigbang:builtin/ui-panel';
+export const BUILTIN_LIBRARY_DOCUMENTS_SKILL_ROOT_SENTINEL = 'bigbang:builtin/library-documents';
+export const BUILTIN_WORKSPACE_TOOL_SKILL_ROOT_SENTINEL = 'bigbang:builtin/workspace-tool-builder';
+export const AGENT_PERMISSION_KINDS = [
+    'read',
+    'edit',
+    'delete',
+    'move',
+    'search',
+    'execute',
+    'think',
+    'fetch',
+    'switch_mode',
+    'other',
+];
+export const AGENT_PERMISSION_DEFINITIONS = [
+    { kind: 'read', label: 'Read', description: 'Read workspace files.' },
+    { kind: 'edit', label: 'Edit', description: 'Create or modify workspace files.' },
+    { kind: 'delete', label: 'Delete', description: 'Delete files or folders.' },
+    { kind: 'move', label: 'Move', description: 'Rename or move files.' },
+    { kind: 'search', label: 'Search', description: 'Search local files and content.' },
+    { kind: 'execute', label: 'Execute', description: 'Run terminal commands.' },
+    { kind: 'think', label: 'Think', description: 'Use planning or task-helper tools.' },
+    { kind: 'fetch', label: 'Network / Web Search', description: 'Access network tools, including web search when supported.' },
+    { kind: 'switch_mode', label: 'Switch Mode', description: 'Change runtime interaction mode.' },
+    { kind: 'other', label: 'Other', description: 'Use uncategorized tools.' },
+];
+export const AGENT_RUNTIME_PERMISSION_SUPPORT = {
+    codex_app_server: {
+        read: 'enforced',
+        edit: 'enforced',
+        delete: 'limited',
+        move: 'limited',
+        search: 'enforced',
+        execute: 'enforced',
+        fetch: 'enforced',
+    },
+    claude_sdk: {
+        read: 'enforced',
+        edit: 'enforced',
+        search: 'enforced',
+        execute: 'enforced',
+        think: 'enforced',
+        fetch: 'enforced',
+        switch_mode: 'enforced',
+        other: 'enforced',
+    },
+    claude_acp: {},
+    codex_acp: {},
+};
+export function getAgentPermissionSupport(agentType, kind) {
+    return AGENT_RUNTIME_PERMISSION_SUPPORT[agentType][kind] ?? 'unsupported';
+}
+export function isAgentPermissionSupported(agentType, kind) {
+    return getAgentPermissionSupport(agentType, kind) !== 'unsupported';
+}
+export function listAgentRuntimePermissions(agentType) {
+    return AGENT_PERMISSION_DEFINITIONS.map((definition) => ({
+        ...definition,
+        support: getAgentPermissionSupport(agentType, definition.kind),
+    }));
+}
+export function parseAgentPermissionKind(value) {
+    if (typeof value !== 'string')
+        return null;
+    const normalized = value.trim().toLowerCase();
+    return AGENT_PERMISSION_KINDS.includes(normalized)
+        ? normalized
+        : null;
+}
+export function normalizeAgentDisabledToolKinds(agentType, values) {
+    if (!Array.isArray(values))
+        return undefined;
+    const enforceRuntimeSupport = agentType === 'codex_app_server' || agentType === 'claude_sdk';
+    const out = [];
+    const seen = new Set();
+    for (const value of values) {
+        const kind = parseAgentPermissionKind(value);
+        if (!kind || seen.has(kind))
+            continue;
+        if (enforceRuntimeSupport && !isAgentPermissionSupported(agentType, kind))
+            continue;
+        seen.add(kind);
+        out.push(kind);
+    }
+    return out.length > 0 ? out : undefined;
+}
+export const CLAUDE_SESSION_MODEL_OPTIONS = [
+    {
+        id: 'claude-opus-4-6[1m]',
+        label: 'Opus 4.6 1M',
+        description: 'Opus 4.6 with 1M context window',
+    },
+    {
+        id: 'claude-opus-4-6',
+        label: 'Opus 4.6',
+        description: 'Opus 4.6 · Most capable for complex work',
+        isDefault: true,
+    },
+    {
+        id: 'claude-sonnet-4-6',
+        label: 'Sonnet 4.6',
+        description: 'Sonnet 4.6 · Best for everyday tasks',
+    },
+    {
+        id: 'claude-haiku-4-5',
+        label: 'Haiku 4.5',
+        description: 'Haiku 4.5 · Fastest for quick answers',
+    },
+];
+export const AGENT_RUNTIME_CAPABILITIES = {
+    claude_acp: [],
+    claude_sdk: [],
+    codex_acp: [],
+    codex_app_server: ['activeTurnSteer', 'planApprovalLoop'],
+};
+export function listAgentRuntimeCapabilities(agentType) {
+    return [...AGENT_RUNTIME_CAPABILITIES[agentType]];
+}
+export function hasAgentRuntimeCapability(agentType, capability) {
+    return AGENT_RUNTIME_CAPABILITIES[agentType].includes(capability);
+}
+export const CODEX_ACP_DEFAULT_ARGS = [
+    '-c',
+    'sandbox_mode="danger-full-access"',
+    '-c',
+    'approval_policy="never"',
+    '-c',
+    'features.memories=false',
+    '-c',
+    'memories.use_memories=false',
+    '-c',
+    'memories.generate_memories=false',
+];
+export const RUNTIME_DRIVERS = {
+    claude_acp: {
+        agentType: 'claude_acp',
+        command: 'claude-code-acp',
+        args: [],
+        supportsResume: true,
+        supportsPushNotifications: true,
+        capabilities: [...AGENT_RUNTIME_CAPABILITIES.claude_acp],
+        nativeMemoryBackend: 'workspace',
+        defaultEnv: {
+            CLAUDE_CODE_DISABLE_AUTO_MEMORY: '1',
+        },
+    },
+    claude_sdk: {
+        agentType: 'claude_sdk',
+        command: 'claude-sdk',
+        args: [],
+        supportsResume: true,
+        supportsPushNotifications: false,
+        capabilities: ['activeTurnSteer'],
+        nativeMemoryBackend: 'workspace',
+        defaultEnv: {
+            CLAUDE_CODE_DISABLE_AUTO_MEMORY: '1',
+        },
+    },
+    codex_acp: {
+        agentType: 'codex_acp',
+        command: 'codex-acp',
+        args: [...CODEX_ACP_DEFAULT_ARGS],
+        supportsResume: true,
+        supportsPushNotifications: false,
+        capabilities: [...AGENT_RUNTIME_CAPABILITIES.codex_acp],
+        nativeMemoryBackend: 'workspace',
+    },
+    codex_app_server: {
+        agentType: 'codex_app_server',
+        command: 'codex',
+        args: ['app-server'],
+        supportsResume: true,
+        supportsPushNotifications: false,
+        capabilities: [...AGENT_RUNTIME_CAPABILITIES.codex_app_server],
+        nativeMemoryBackend: 'workspace',
+    },
+};
+export function getRuntimeDriver(agentType) {
+    return RUNTIME_DRIVERS[agentType];
+}
+export function listRuntimeDrivers() {
+    return Object.values(RUNTIME_DRIVERS);
+}
+export const BEIJING_TIME_ZONE = 'Asia/Shanghai';
+const BEIJING_DATE_TIME_FORMATTER = new Intl.DateTimeFormat('en-US', {
+    timeZone: BEIJING_TIME_ZONE,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hour12: false,
+});
+const BEIJING_DATE_TIME_NO_SECONDS_FORMATTER = new Intl.DateTimeFormat('en-US', {
+    timeZone: BEIJING_TIME_ZONE,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    hour12: false,
+});
+const BEIJING_MONTH_DAY_TIME_FORMATTER = new Intl.DateTimeFormat('en-US', {
+    timeZone: BEIJING_TIME_ZONE,
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    hour12: false,
+});
+const BEIJING_MONTH_DAY_TIME_WITH_SECONDS_FORMATTER = new Intl.DateTimeFormat('en-US', {
+    timeZone: BEIJING_TIME_ZONE,
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hour12: false,
+});
+const BEIJING_TIME_FORMATTER = new Intl.DateTimeFormat('en-US', {
+    timeZone: BEIJING_TIME_ZONE,
+    hour: '2-digit',
+    minute: '2-digit',
+    hour12: false,
+});
+const BEIJING_TIME_WITH_SECONDS_FORMATTER = new Intl.DateTimeFormat('en-US', {
+    timeZone: BEIJING_TIME_ZONE,
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hour12: false,
+});
+function normalizeTimeInput(input) {
+    const date = input instanceof Date ? input : new Date(input);
+    return Number.isFinite(date.getTime()) ? date : null;
+}
+function getDateTimeParts(formatter, input) {
+    const date = normalizeTimeInput(input);
+    if (!date)
+        return null;
+    const parts = formatter.formatToParts(date);
+    const values = {};
+    for (const part of parts) {
+        if (part.type !== 'literal')
+            values[part.type] = part.value;
+    }
+    return values;
+}
+export function formatBeijingDateTime(input, options) {
+    const parts = getDateTimeParts(options?.withSeconds === false
+        ? BEIJING_DATE_TIME_NO_SECONDS_FORMATTER
+        : BEIJING_DATE_TIME_FORMATTER, input);
+    if (!parts)
+        return '';
+    const dateText = `${parts.year}-${parts.month}-${parts.day}`;
+    const timeText = options?.withSeconds === false
+        ? `${parts.hour}:${parts.minute}`
+        : `${parts.hour}:${parts.minute}:${parts.second}`;
+    return `${dateText} ${timeText}`;
+}
+export function formatBeijingPromptTimestamp(input) {
+    const formatted = formatBeijingDateTime(input);
+    return formatted ? `${formatted} UTC+8` : '';
+}
+export function formatBeijingMonthDayTime(input, options) {
+    const parts = getDateTimeParts(options?.withSeconds
+        ? BEIJING_MONTH_DAY_TIME_WITH_SECONDS_FORMATTER
+        : BEIJING_MONTH_DAY_TIME_FORMATTER, input);
+    if (!parts)
+        return '';
+    const timeText = options?.withSeconds
+        ? `${parts.hour}:${parts.minute}:${parts.second}`
+        : `${parts.hour}:${parts.minute}`;
+    return `${parts.month}/${parts.day} ${timeText}`;
+}
+export function formatBeijingTime(input, options) {
+    const date = normalizeTimeInput(input);
+    if (!date)
+        return '';
+    return (options?.withSeconds ? BEIJING_TIME_WITH_SECONDS_FORMATTER : BEIJING_TIME_FORMATTER).format(date);
+}
+export const THREAD_SHORT_ID_LENGTH = 16;
+export function stripIgnoredMentionContexts(content) {
+    let sanitized = content;
+    sanitized = sanitized.replace(/```[\s\S]*?```/g, ' ');
+    sanitized = sanitized.replace(/~~~[\s\S]*?~~~/g, ' ');
+    sanitized = sanitized.replace(/`[^`\n]*`/g, ' ');
+    sanitized = sanitized.replace(/^\s*>.*$/gm, ' ');
+    const quotedSpanPatterns = [
+        /"[^"\n]*"/g,
+        /“[^”\n]*”/g,
+        /‘[^’\n]*’/g,
+        /「[^」\n]*」/g,
+        /『[^』\n]*』/g,
+    ];
+    for (const pattern of quotedSpanPatterns) {
+        sanitized = sanitized.replace(pattern, ' ');
+    }
+    return sanitized;
+}
+export function extractMentionedNames(content) {
+    const sanitizedContent = stripIgnoredMentionContexts(content);
+    const mentionRegex = /@([a-zA-Z0-9_-]+)/g;
+    const mentioned = new Set();
+    let match;
+    while ((match = mentionRegex.exec(sanitizedContent)) !== null) {
+        mentioned.add(match[1].toLowerCase());
+    }
+    return [...mentioned];
+}
+export function normalizeThreadShortIdInput(threadRootId) {
+    const normalized = threadRootId?.trim().toLowerCase();
+    return normalized ? normalized : null;
+}
+export function normalizeMessageIdForThreadShortId(messageId) {
+    const trimmed = messageId.trim().toLowerCase();
+    const withoutClientPrefix = trimmed.startsWith('client-') ? trimmed.slice('client-'.length) : trimmed;
+    const alnumOnly = withoutClientPrefix.replace(/[^a-z0-9]/g, '');
+    return alnumOnly || trimmed.replace(/[^a-z0-9]/g, '') || trimmed;
+}
+export function buildThreadShortId(messageId) {
+    const normalized = normalizeMessageIdForThreadShortId(messageId);
+    return normalized.slice(0, THREAD_SHORT_ID_LENGTH);
+}
+export function buildRecentMessageSourceKey(params) {
+    if (params.sourceType === 'dm') {
+        return `dm:${encodeURIComponent((params.agentId ?? '').trim())}`;
+    }
+    if (params.sourceType === 'channel') {
+        return `channel:${encodeURIComponent((params.channelId ?? '').trim())}`;
+    }
+    return `${params.sourceType}:${encodeURIComponent((params.channelId ?? '').trim())}:${encodeURIComponent((params.threadRootId ?? '').trim())}`;
+}
+export function parseRecentMessageSourceKey(sourceKey) {
+    const separatorIndex = sourceKey.indexOf(':');
+    if (separatorIndex <= 0)
+        return null;
+    const sourceType = sourceKey.slice(0, separatorIndex);
+    const rest = sourceKey.slice(separatorIndex + 1);
+    try {
+        if (sourceType === 'dm') {
+            const agentId = decodeURIComponent(rest).trim();
+            return agentId ? { sourceType: 'dm', agentId } : null;
+        }
+        if (sourceType === 'channel') {
+            const channelId = decodeURIComponent(rest).trim();
+            return channelId ? { sourceType: 'channel', channelId } : null;
+        }
+        if (sourceType === 'thread' || sourceType === 'task') {
+            const secondSeparatorIndex = rest.indexOf(':');
+            if (secondSeparatorIndex <= 0)
+                return null;
+            const channelId = decodeURIComponent(rest.slice(0, secondSeparatorIndex)).trim();
+            const threadRootId = decodeURIComponent(rest.slice(secondSeparatorIndex + 1)).trim();
+            return channelId && threadRootId
+                ? { sourceType, channelId, threadRootId }
+                : null;
+        }
+    }
+    catch {
+        return null;
+    }
+    return null;
+}
+export const WORKSPACE_TOOL_PANEL_ACTION_PARAM_NAMESPACE = 'tool_action';
+export function buildWorkspaceToolPanelActionParamKey(actionId, paramName) {
+    return `${WORKSPACE_TOOL_PANEL_ACTION_PARAM_NAMESPACE}.${actionId}.${paramName}`;
+}
+export function parseWorkspaceToolPanelActionParamKey(key) {
+    if (typeof key !== 'string' || !key.startsWith(`${WORKSPACE_TOOL_PANEL_ACTION_PARAM_NAMESPACE}.`)) {
+        return null;
+    }
+    const remainder = key.slice(WORKSPACE_TOOL_PANEL_ACTION_PARAM_NAMESPACE.length + 1);
+    const separatorIndex = remainder.lastIndexOf('.');
+    if (separatorIndex <= 0 || separatorIndex === remainder.length - 1) {
+        return null;
+    }
+    return {
+        actionId: remainder.slice(0, separatorIndex),
+        paramName: remainder.slice(separatorIndex + 1),
+    };
+}
+export function extractWorkspaceToolPanelActionParams(actionId, formValues) {
+    if (!formValues)
+        return {};
+    const prefix = `${WORKSPACE_TOOL_PANEL_ACTION_PARAM_NAMESPACE}.${actionId}.`;
+    return Object.fromEntries(Object.entries(formValues)
+        .filter(([key]) => key.startsWith(prefix))
+        .map(([key, value]) => [key.slice(prefix.length), value]));
+}
+export * from './handoff.js';
+export * from './panel.js';