@bbigbang/core 0.1.0

package/dist/services/workspaceToolMutationQueue.js

@@ -0,0 +1,43 @@
+export class KeyedMutationQueue {
+    pending = new Map();
+    async enqueue(key, work) {
+        const previous = this.pending.get(key) ?? Promise.resolve();
+        let releaseCurrent;
+        const current = new Promise((resolve) => {
+            releaseCurrent = resolve;
+        });
+        const stored = previous.catch(() => undefined).then(() => current);
+        this.pending.set(key, stored);
+        await previous.catch(() => undefined);
+        try {
+            return await work();
+        }
+        finally {
+            releaseCurrent();
+            if (this.pending.get(key) === stored) {
+                this.pending.delete(key);
+            }
+        }
+    }
+    pendingKeyCount() {
+        return this.pending.size;
+    }
+}
+export class WorkspaceToolMutationQueues {
+    toolQueue = new KeyedMutationQueue();
+    publishQueue = new KeyedMutationQueue();
+    panelPromotionQueue = new KeyedMutationQueue();
+    agentPersistentStartQueue = new KeyedMutationQueue();
+    enqueueTool(toolId, work) {
+        return this.toolQueue.enqueue(toolId, work);
+    }
+    enqueuePublish(publishKey, work) {
+        return this.publishQueue.enqueue(publishKey, work);
+    }
+    enqueuePanelPromotion(panelId, work) {
+        return this.panelPromotionQueue.enqueue(panelId, work);
+    }
+    enqueueAgentPersistentStart(agentId, work) {
+        return this.agentPersistentStartQueue.enqueue(agentId, work);
+    }
+}

package/dist/services/workspaceToolPanelProjection.js

@@ -0,0 +1,460 @@
+import { buildWorkspaceToolPanelActionParamKey, mapPanelLevelNodes, panelLevelNodeHasActionBar, } from '@bbigbang/protocol';
+const TOOL_SNAPSHOT_RUNTIME_FIELD_LIMIT = 4;
+const TOOL_RUNTIME_SUMMARY_MARKER = 'bigbang:tool-runtime-summary';
+const TOOL_ACTION_PARAMETER_FORM_MARKER = 'bigbang:tool-action-parameter-form';
+export function buildToolSnapshotPanelProjection(spec) {
+    const actions = spec.manifest.actions.map((action) => ({
+        id: action.actionId,
+        label: action.label,
+        ...(action.description ? { description: action.description } : {}),
+        ...(action.kind === 'stop' ? { variant: 'danger' } : {}),
+    }));
+    const sourceProps = spec.sourceProps ?? null;
+    const sourcePageSize = typeof sourceProps?.pageSize === 'number' && Number.isFinite(sourceProps.pageSize)
+        ? Math.min(50, Math.max(1, Math.trunc(sourceProps.pageSize)))
+        : null;
+    const props = {
+        title: spec.manifest.view.title ?? spec.manifest.name,
+        pageSize: sourceProps ? (sourcePageSize ?? 10) : 1,
+        fields: spec.manifest.view.fields,
+        mediaSlots: spec.manifest.view.mediaSlots ?? [],
+        template: spec.manifest.view.template,
+    };
+    const summary = buildToolSnapshotSummaryNode(spec.manifest.view.summary ?? null, sourceProps?.summary, spec.latestState, {
+        manifest: spec.manifest,
+        allowSharedExec: spec.allowSharedExec,
+        status: spec.status,
+    });
+    if (summary)
+        props.summary = summary;
+    const parameterForm = buildToolSnapshotParameterFormNode(spec.manifest.view.parameterForm ?? null, sourceProps?.parameterForm, spec.manifest, {
+        includeActionBar: true,
+        stripSourceInteractiveControls: Boolean(spec.sourcePanelId),
+    });
+    if (parameterForm)
+        props.parameterForm = parameterForm;
+    const latestStateRow = spec.latestState ? {
+        rowId: 'tool-state',
+        fields: spec.latestState.fields,
+        media: spec.latestState.media ?? {},
+        nodeId: spec.nodeId,
+    } : null;
+    const sourceRows = spec.sourceRows && spec.sourceRows.length > 0
+        ? spec.sourceRows
+        : spec.preservedRows ?? [];
+    const rows = sourceRows.length > 0
+        ? sourceRows
+        : latestStateRow
+            ? [latestStateRow]
+            : [];
+    const result = buildToolSnapshotPanelResult(spec.latestState, spec.status);
+    return {
+        props,
+        actions,
+        rows,
+        rowCount: rows.length,
+        result,
+        schemaFingerprint: buildToolSnapshotSchemaFingerprint(props),
+    };
+}
+export function buildToolSnapshotSchemaFingerprint(props) {
+    return stableStringify({
+        fields: props.fields ?? [],
+        mediaSlots: props.mediaSlots ?? [],
+        summary: props.summary ?? null,
+        template: props.template ?? null,
+        parameterForm: props.parameterForm ?? null,
+    });
+}
+export function deriveWorkspaceToolBusinessState(latestState) {
+    const value = latestState?.fields?.status;
+    if (typeof value === 'string' && value.trim().length > 0)
+        return value.trim();
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    return null;
+}
+export function deriveWorkspaceToolRuntimeState(params) {
+    if (params.activeTerminalId)
+        return 'running';
+    if (params.lastRunStatus === 'failed')
+        return 'failed';
+    if (params.lastRunStatus === 'completed')
+        return 'completed';
+    return 'idle';
+}
+export function workspaceToolRuntimeStateToPanelStatus(runtimeState) {
+    if (runtimeState === 'running')
+        return 'running';
+    if (runtimeState === 'failed')
+        return 'failed';
+    if (runtimeState === 'completed')
+        return 'completed';
+    return 'idle';
+}
+export function buildToolActionParameterFormSectionForActions(actions, options) {
+    const children = [];
+    for (const action of actions) {
+        for (const field of action.paramsSchema ?? []) {
+            const props = {
+                name: buildWorkspaceToolPanelActionParamKey(action.actionId, field.name),
+                label: field.label ? `${action.label} · ${field.label}` : `${action.label} · ${field.name}`,
+                __bigbangBuiltin: TOOL_ACTION_PARAMETER_FORM_MARKER,
+            };
+            if (field.placeholder)
+                props.placeholder = field.placeholder;
+            if (field.defaultValue !== undefined)
+                props.defaultValue = field.defaultValue;
+            if (field.required === true)
+                props.required = true;
+            if (field.min !== undefined)
+                props.min = field.min;
+            if (field.max !== undefined)
+                props.max = field.max;
+            if (field.accept !== undefined)
+                props.accept = field.accept;
+            if (field.multiple === true)
+                props.multiple = true;
+            if (field.maxBytes !== undefined)
+                props.maxBytes = field.maxBytes;
+            if (field.options?.length) {
+                props.options = field.options.map((option) => ({
+                    label: option.label,
+                    value: option.value,
+                }));
+            }
+            const input = field.input ?? 'text';
+            if (input === 'number') {
+                children.push({ type: 'NumberInput', props });
+            }
+            else if (input === 'checkbox') {
+                children.push({ type: 'Checkbox', props });
+            }
+            else if (input === 'select') {
+                children.push({ type: 'Select', props });
+            }
+            else if (input === 'multiselect') {
+                children.push({ type: 'MultiSelect', props });
+            }
+            else if (input === 'tags') {
+                children.push({ type: 'TagInput', props });
+            }
+            else if (input === 'date') {
+                children.push({ type: 'DatePicker', props });
+            }
+            else if (input === 'file') {
+                children.push({ type: 'FileUpload', props });
+            }
+            else if (input === 'textarea') {
+                children.push({ type: 'TextArea', props });
+            }
+            else {
+                children.push({ type: 'TextInput', props });
+            }
+        }
+    }
+    const actionBar = buildToolGeneratedActionBarNode(actions, options);
+    if (actionBar)
+        children.push(actionBar);
+    return children.length > 0
+        ? {
+            type: 'ParameterFormSection',
+            children,
+        }
+        : null;
+}
+function stableStringify(value) {
+    if (value === undefined)
+        return 'undefined';
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value) ?? 'undefined';
+    if (Array.isArray(value))
+        return `[${value.map((item) => stableStringify(item)).join(',')}]`;
+    const entries = Object.entries(value)
+        .sort(([a], [b]) => a.localeCompare(b));
+    return `{${entries.map(([key, entryValue]) => `${JSON.stringify(key)}:${stableStringify(entryValue)}`).join(',')}}`;
+}
+function buildToolSnapshotPanelResult(latestState, status) {
+    if (!latestState)
+        return null;
+    const summary = formatToolSnapshotLatestStateSummary(latestState.fields);
+    return {
+        summary,
+        status: status ?? null,
+        latestState: {
+            fields: latestState.fields,
+            media: latestState.media ?? {},
+        },
+    };
+}
+function buildToolSnapshotSummaryNode(manifestSummary, sourceSummary, latestState, options) {
+    const baseSummary = stripToolSummaryNode(manifestSummary ?? sourceSummary);
+    const staticSummary = buildToolStaticSummaryNode(options.manifest, latestState, options);
+    const runtimeSummary = buildToolRuntimeSummaryNode(latestState);
+    const children = [baseSummary, staticSummary, runtimeSummary].filter((node) => node !== null);
+    if (children.length === 0)
+        return null;
+    if (children.length === 1)
+        return children[0] ?? null;
+    return {
+        type: 'Section',
+        children,
+    };
+}
+function buildToolStaticSummaryNode(manifest, latestState, options) {
+    const hasNotifyAgentActions = manifest.actions.some((action) => (action.mode ?? 'platform_exec') === 'notify_agent');
+    const children = [
+        buildToolStaticSummaryMetricCard('State', formatToolSnapshotBusinessState(latestState)),
+        buildToolStaticSummaryMetricCard('Runtime', formatToolSnapshotRuntimeStatus(options.status)),
+        buildToolStaticSummaryMetricCard('Shared execution', options.allowSharedExec ? 'Enabled' : 'Owner only'),
+    ];
+    if (hasNotifyAgentActions) {
+        children.push(buildToolStaticSummaryMetricCard('Notify-agent actions', 'Owner only'));
+    }
+    if (!latestState) {
+        children.push(buildToolStaticSummaryMetricCard('Runtime data', 'Pending'));
+    }
+    return buildCompactToolSummaryColumns(children);
+}
+function buildToolStaticSummaryMetricCard(label, value) {
+    return {
+        type: 'MetricCard',
+        props: {
+            label,
+            value,
+            __bigbangBuiltin: TOOL_RUNTIME_SUMMARY_MARKER,
+        },
+    };
+}
+function panelStatusToWorkspaceToolRuntimeState(status) {
+    if (status === 'running')
+        return 'running';
+    if (status === 'failed')
+        return 'failed';
+    if (status === 'completed')
+        return 'completed';
+    return 'idle';
+}
+function formatWorkspaceToolRuntimeStateLabel(runtimeState) {
+    if (runtimeState === 'running')
+        return 'Running';
+    if (runtimeState === 'failed')
+        return 'Failed';
+    if (runtimeState === 'completed')
+        return 'Completed';
+    return 'Idle';
+}
+function formatToolSnapshotBusinessState(latestState) {
+    return deriveWorkspaceToolBusinessState(latestState) ?? 'No runtime data yet';
+}
+function formatToolSnapshotRuntimeStatus(status) {
+    return formatWorkspaceToolRuntimeStateLabel(panelStatusToWorkspaceToolRuntimeState(status));
+}
+function buildToolSnapshotParameterFormNode(manifestParameterForm, sourceParameterForm, manifest, options) {
+    const baseParameterForm = manifestParameterForm
+        ? canonicalizeToolActionParameterFormNode(manifestParameterForm, manifest)
+        : stripToolActionParameterFormNode(sourceParameterForm, {
+            stripGeneratedActionBar: options?.includeActionBar !== false,
+            stripSourceInteractiveControls: options?.stripSourceInteractiveControls === true,
+        });
+    const generatedParameterForm = manifestParameterForm
+        ? (panelLevelNodeHasActionBar(manifestParameterForm)
+            ? null
+            : buildToolGeneratedActionBarNode(manifest.actions, options))
+        : buildToolActionParameterFormSectionForActions(manifest.actions, options);
+    if (baseParameterForm && generatedParameterForm) {
+        return {
+            type: 'Section',
+            children: [baseParameterForm, generatedParameterForm],
+        };
+    }
+    return baseParameterForm ?? generatedParameterForm;
+}
+function canonicalizeToolActionParameterFormNode(node, manifest) {
+    const fieldByKey = new Map();
+    for (const action of manifest.actions) {
+        for (const field of action.paramsSchema ?? []) {
+            fieldByKey.set(buildWorkspaceToolPanelActionParamKey(action.actionId, field.name), { action, field });
+        }
+    }
+    return mapPanelLevelNodes(node, (candidate) => {
+        const props = candidate.props;
+        if (!isPlainRecord(props))
+            return undefined;
+        const name = props.name;
+        if (typeof name !== 'string')
+            return undefined;
+        const binding = fieldByKey.get(name);
+        if (!binding)
+            return undefined;
+        const propsWithoutAuthoredContract = stripAuthoredToolParameterControlProps(props);
+        return {
+            ...candidate,
+            props: {
+                ...propsWithoutAuthoredContract,
+                ...buildCanonicalToolParameterControlProps(binding.action, binding.field),
+            },
+        };
+    }) ?? node;
+}
+function stripAuthoredToolParameterControlProps(props) {
+    const next = { ...props };
+    for (const key of ['label', 'placeholder', 'defaultValue', 'value', 'checked', 'required', 'min', 'max', 'accept', 'multiple', 'maxBytes', 'options']) {
+        delete next[key];
+    }
+    return next;
+}
+function buildCanonicalToolParameterControlProps(action, field) {
+    const props = {
+        label: field.label ? `${action.label} · ${field.label}` : `${action.label} · ${field.name}`,
+    };
+    if (field.placeholder)
+        props.placeholder = field.placeholder;
+    if (field.defaultValue !== undefined)
+        props.defaultValue = field.defaultValue;
+    if (field.required === true)
+        props.required = true;
+    if (field.min !== undefined)
+        props.min = field.min;
+    if (field.max !== undefined)
+        props.max = field.max;
+    if (field.accept !== undefined)
+        props.accept = field.accept;
+    if (field.multiple === true)
+        props.multiple = true;
+    if (field.maxBytes !== undefined)
+        props.maxBytes = field.maxBytes;
+    if (field.options?.length) {
+        props.options = field.options.map((option) => ({
+            label: option.label,
+            value: option.value,
+        }));
+    }
+    return props;
+}
+function buildToolGeneratedActionBarNode(actions, options) {
+    if (options?.includeActionBar === false || actions.length === 0)
+        return null;
+    return {
+        type: 'ActionBar',
+        actionIds: actions.map((action) => action.actionId),
+        title: 'Actions',
+        layout: 'wrap',
+    };
+}
+function buildToolRuntimeSummaryNode(latestState) {
+    if (!latestState)
+        return null;
+    const children = [
+        {
+            type: 'MetricCard',
+            props: {
+                label: 'Latest tool state',
+                source: { kind: 'panel_result', path: ['summary'] },
+                __bigbangBuiltin: TOOL_RUNTIME_SUMMARY_MARKER,
+            },
+        },
+    ];
+    const fieldEntries = Object.entries(latestState.fields)
+        .filter(([, value]) => (value === null
+        || typeof value === 'string'
+        || typeof value === 'number'
+        || typeof value === 'boolean'))
+        .slice(0, TOOL_SNAPSHOT_RUNTIME_FIELD_LIMIT);
+    for (const [field] of fieldEntries) {
+        children.push({
+            type: 'MetricCard',
+            props: {
+                label: field,
+                source: { kind: 'panel_result', path: ['latestState', 'fields', field] },
+                __bigbangBuiltin: TOOL_RUNTIME_SUMMARY_MARKER,
+            },
+        });
+    }
+    return buildCompactToolSummaryColumns(children);
+}
+function buildCompactToolSummaryColumns(children) {
+    if (children.length === 0)
+        return null;
+    return {
+        type: 'Columns',
+        columns: children.map((child) => ({ children: [child] })),
+    };
+}
+function stripToolSummaryNode(node) {
+    if (!isPlainRecord(node))
+        return null;
+    return stripPanelLevelNodes(node, (candidate) => (isToolRuntimeSummaryNode(candidate)
+        || isSourcePromotedToolInteractiveParameterNode(candidate)));
+}
+function stripToolActionParameterFormNode(node, options) {
+    if (!isPlainRecord(node))
+        return null;
+    return stripPanelLevelNodes(node, (candidate) => ((options?.stripSourceInteractiveControls === true
+        && isSourcePromotedToolInteractiveParameterNode(candidate))
+        || isToolActionParameterFormNode(candidate, options)));
+}
+function stripPanelLevelNodes(node, shouldStrip) {
+    return mapPanelLevelNodes(node, (candidate) => shouldStrip(candidate) ? null : undefined, {
+        pruneEmptyContainers: true,
+        pruneEmptyColumns: true,
+        collapseSingleChildContainers: true,
+    });
+}
+function isToolRuntimeSummaryNode(node) {
+    if (node.type === 'MetricCard') {
+        const props = node.props;
+        return isPlainRecord(props) && props.__bigbangBuiltin === TOOL_RUNTIME_SUMMARY_MARKER;
+    }
+    if (node.type === 'Section' && Array.isArray(node.children) && node.children.length > 0) {
+        return node.children.every((child) => isPlainRecord(child) && isToolRuntimeSummaryNode(child));
+    }
+    if (node.type === 'Columns' && Array.isArray(node.columns) && node.columns.length > 0) {
+        return node.columns.every((column) => (isPlainRecord(column)
+            && Array.isArray(column.children)
+            && column.children.length > 0
+            && column.children.every((child) => isPlainRecord(child) && isToolRuntimeSummaryNode(child))));
+    }
+    return false;
+}
+function isToolActionParameterFormNode(node, options) {
+    if (options?.stripGeneratedActionBar === true
+        && node.type === 'ActionBar'
+        && Array.isArray(node.actionIds)
+        && node.actionIds.every((actionId) => typeof actionId === 'string')
+        && (node.layout === undefined || node.layout === 'wrap')
+        && node.title === 'Actions') {
+        return true;
+    }
+    const props = node.props;
+    return isPlainRecord(props) && props.__bigbangBuiltin === TOOL_ACTION_PARAMETER_FORM_MARKER;
+}
+function isSourcePromotedToolInteractiveParameterNode(node) {
+    return node.type === 'ActionBar'
+        || node.type === 'TextInput'
+        || node.type === 'TextArea'
+        || node.type === 'NumberInput'
+        || node.type === 'Checkbox'
+        || node.type === 'Select'
+        || node.type === 'MultiSelect'
+        || node.type === 'TagInput'
+        || node.type === 'Slider'
+        || node.type === 'DatePicker'
+        || node.type === 'FileUpload'
+        || node.type === 'Button';
+}
+function formatToolSnapshotLatestStateSummary(fields) {
+    const entries = Object.entries(fields)
+        .filter(([, value]) => (value === null
+        || typeof value === 'string'
+        || typeof value === 'number'
+        || typeof value === 'boolean'))
+        .slice(0, TOOL_SNAPSHOT_RUNTIME_FIELD_LIMIT)
+        .map(([key, value]) => `${key}=${String(value)}`);
+    return entries.length > 0
+        ? `Latest tool state: ${entries.join(', ')}`
+        : 'Latest tool state updated.';
+}
+function isPlainRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}