@forgeax/interface 0.4.1

package/dist/package/browser/appHostBootstrap.d.ts

@@ -0,0 +1,16 @@
+import { type AppHost, type AppHostControl, type AppExtension } from './core/app-shell';
+
+
+
+export interface AppHostBootstrapOverrides {
+    /** Studio injects dashboard / settings / surfaces / slots / detached /
+     *  editor concrete plugins here. Appended AFTER the built-in list so they
+     *  can depend on foundation capabilities. */
+    readonly extensions?: readonly AppExtension[];
+}
+export interface AppHostBootstrapResult {
+    host: AppHost;
+    control: AppHostControl;
+    dispose: () => Promise<void>;
+}
+export declare function bootstrapAppHost(overrides?: AppHostBootstrapOverrides): Promise<AppHostBootstrapResult>;

package/dist/package/browser/appHostBootstrap.js

@@ -0,0 +1,145 @@
+// packages/interface/src/appHostBootstrap.ts
+//
+// The single place that builds an AppHost + wires the built-in extension list.
+// Studio (which injects Dashboard / Settings / StatusFeeds / surfaces / slots /
+// detached / editor concrete extensions) calls this and passes them via
+// `overrides.extensions`. Interface-alone callers pass no overrides — no overlays,
+// no detached windows, and no editor-specific panels show up (only the interface foundation +
+// chat remain).
+//
+// Each manifest's setup is wrapped in a control.beginSetup(m) / try / finally
+// endSetup() bracket so host.extend(capability, api) — which requires an
+// active setup — always sees the right owner during synchronous extension boot.
+// The wrap is also where declarative `contributes` lands (ADR 0025 M2): panels
+// contributions are registered before setup() runs and removed together with
+// the extension's cleanup, so a pure-UI extension needs no setup at all.
+import { createAppHost, } from './core/app-shell';
+import { createExtensionLoader } from './core/extension-foundation/loader';
+import { foundationCommandsExtension } from './core/extensions/foundation-commands';
+import { foundationBusExtension } from './core/extensions/foundation-bus';
+import { foundationStorageExtension } from './core/extensions/foundation-storage';
+import { builtinCommandsExtension } from './core/extensions/builtin-commands';
+import { hostCommandsExtension } from './core/extensions/host-commands';
+import { builtinMenusExtension } from './core/extensions/builtin-menus';
+import { editorCommandsExtension } from './core/extensions/editor-commands';
+import { panelsViewportExtension } from './core/extensions/panels-viewport';
+import { panelsChatExtension } from './core/extensions/panels-chat';
+import { chromeStatusBarExtension } from './core/extensions/chrome-statusbar';
+import { chromeDrawerExtension } from './core/extensions/chrome-drawer';
+
+import { sessionClientExtension } from './core/extensions/session-client';
+
+import { studioDomainClientsExtension } from './core/extensions/studio-domain-clients';
+
+import { observabilityExtension } from './core/extensions/observability';
+import { trajectoryExtension } from './core/extensions/trajectory';
+import { consoleLogger } from './core/app-shell/logger';
+import { createCatalogPageExtensionRuntime } from './core/app-shell/catalog-page-extensions';
+export async function bootstrapAppHost(overrides = {}) {
+    const { host, control } = createAppHost();
+    const contextFactory = (m) => ({
+        host,
+        bus: host.bus,
+        storage: host.storage,
+        log: consoleLogger,
+        registerCommand: (cmd) => host.commands.register(cmd),
+        contributePanels: (patch) => control.contributePanels(m.id, patch),
+        contributePanelActions: (actions) => control.contributePanelActions(m.id, actions),
+        contributePanelControls: (controls) => control.contributePanelControls(m.id, controls),
+        contributePagePlatform: (contribution) => control.contributePagePlatform(m.id, contribution),
+    });
+    const loader = createExtensionLoader({
+        capabilities: control.capabilities,
+        contextFactory,
+        onError: (err, m, phase) => consoleLogger.error(`extension "${m.id}" ${phase} error`, err),
+    });
+    // Wrap each manifest so control.beginSetup / endSetup brackets its sync
+    // setup frame — host.extend(cap, api) inside setup() needs an active owner.
+    // The wrap also applies declarative `contributes.panels` BEFORE setup() and
+    // composes its removal into the extension's cleanup (reverse order), and
+    // supplies the loader-required setup shim for contributes-only extensions.
+    const wrap = (m) => ({
+        ...m,
+        async setup(ctx) {
+            control.beginSetup(m);
+            try {
+                const cleanups = [];
+                let pageCleanup;
+                if (m.contributes?.panels) {
+                    cleanups.push(control.contributePanels(m.id, m.contributes.panels));
+                }
+                if (m.contributes?.panelActions) {
+                    cleanups.push(control.contributePanelActions(m.id, m.contributes.panelActions));
+                }
+                if (m.contributes?.panelControls) {
+                    cleanups.push(control.contributePanelControls(m.id, m.contributes.panelControls));
+                }
+                if (m.contributes?.pages || m.contributes?.panelTypes || m.contributes?.activities || m.contributes?.resourceEditors) {
+                    pageCleanup = control.contributePagePlatform(m.id, {
+                        pageTypes: m.contributes.pages,
+                        panelTypes: m.contributes.panelTypes,
+                        activities: m.contributes.activities,
+                        resourceEditors: m.contributes.resourceEditors,
+                    });
+                }
+                const r = await m.setup?.(ctx);
+                if (typeof r === 'function')
+                    cleanups.push(r);
+                if (cleanups.length === 0 && !pageCleanup)
+                    return undefined;
+                return async () => {
+                    // Controllers get the first say. If one vetoes/needs a user decision,
+                    // no declarative or imperative contribution is torn down underneath it.
+                    await pageCleanup?.();
+                    for (const c of cleanups.slice().reverse())
+                        await c();
+                };
+            }
+            finally {
+                control.endSetup();
+            }
+        },
+    });
+    const overrideIds = new Set((overrides.extensions ?? []).map((extension) => extension.id));
+    const manifests = [
+        foundationCommandsExtension,
+        foundationBusExtension,
+        foundationStorageExtension,
+        builtinCommandsExtension,
+        hostCommandsExtension,
+        builtinMenusExtension,
+        editorCommandsExtension,
+        panelsViewportExtension,
+        panelsChatExtension,
+        chromeStatusBarExtension,
+        chromeDrawerExtension,
+        sessionClientExtension,
+        studioDomainClientsExtension,
+        observabilityExtension,
+        trajectoryExtension,
+        ...(overrides.extensions ?? []),
+    ].map(wrap);
+    // Fail-fast(架构原则 §5):loader 按 id 去重是「先声明者胜」的静默行为,
+    // override 扩展若与内置清单撞 id 会被无声跳过(2026-07-21 studio
+    // 'panels.chat' 撞 panelsChatExtension,面板 Panel not mounted 的根因)。
+    // 这里显式告警,让撞车当场现形。
+    {
+        const seen = new Set();
+        for (const m of manifests) {
+            if (seen.has(m.id)) {
+                consoleLogger.warn(`[appHostBootstrap] duplicate extension id "${m.id}" — later declaration is silently SKIPPED by the loader; rename one side`);
+            }
+            seen.add(m.id);
+        }
+    }
+    await loader.load(manifests);
+    await loader.flush();
+    const catalogRuntime = createCatalogPageExtensionRuntime({ control, overriddenIds: overrideIds });
+    await catalogRuntime.start();
+    const dispose = async () => {
+        await catalogRuntime.dispose();
+        await loader.unload();
+        await control.dispose();
+    };
+    return { host, control, dispose };
+}

package/dist/package/browser/application.d.ts

@@ -0,0 +1,35 @@
+import type { AppHost as ApplicationHost } from '@forgeax/app-shell/application';
+import { type AppHostBootstrapOverrides, type AppHostBootstrapResult } from './appHostBootstrap';
+import { type Locale } from './i18n';
+import { type KeyboardRouterDeps } from './lib/global-shortcuts';
+export type InterfaceApplicationRuntime = AppHostBootstrapResult & {
+    readonly host: AppHostBootstrapResult['host'] & ApplicationHost;
+};
+export interface InterfaceApplicationStartupOptions {
+    /** Product-selected initial locale. Persisted locale remains authoritative when omitted. */
+    readonly locale?: Locale;
+}
+/**
+ * Lets a product replace one shell overlay with its own destination. Interface
+ * owns observation, clearing and synchronous reentry; the product owns routing.
+ * Installation does not reconcile current state; subsequent store notifications
+ * are observed. Product errors still propagate.
+ */
+export declare function installApplicationOverlayRedirect(overlayId: string, onRedirect: () => void): () => void;
+/**
+ * Configures product-owned editor callbacks consumed by Interface's single
+ * keyboard router. Product assemblies use this public application boundary;
+ * the router implementation remains private to Interface.
+ */
+export declare function configureInterfaceKeyboardRouter(deps: KeyboardRouterDeps | null): void;
+/**
+ * Starts the shared Interface application runtime without selecting a product
+ * entry or product extensions. IDE and compatibility callers supply their own
+ * assembly overrides and render the resulting shell themselves.
+ */
+export declare function startInterfaceApplication(overrides?: AppHostBootstrapOverrides, options?: InterfaceApplicationStartupOptions): Promise<InterfaceApplicationRuntime>;
+export type { AppHostBootstrapOverrides } from './appHostBootstrap';
+export type { KeyboardRouterDeps } from './lib/global-shortcuts';
+export { configureStudioDomainClients, type StudioDomainClients, } from './store-parts/domain-clients';
+export { dispatchAction, registerAction } from './lib/action-registry';
+export type { JsonSchemaObject, UiActionDef, UiActionResult, UiCapability, } from './lib/action-registry';

package/dist/package/browser/application.js

@@ -0,0 +1,64 @@
+import { bootstrapAppHost, } from './appHostBootstrap';
+import { bootStageAppMounted } from './boot/driver';
+import { changeLanguage, initI18n } from './i18n';
+import { useShellStore } from './store';
+import { registerKeyboardRouterDeps, } from './lib/global-shortcuts';
+/**
+ * Lets a product replace one shell overlay with its own destination. Interface
+ * owns observation, clearing and synchronous reentry; the product owns routing.
+ * Installation does not reconcile current state; subsequent store notifications
+ * are observed. Product errors still propagate.
+ */
+export function installApplicationOverlayRedirect(overlayId, onRedirect) {
+    let redirecting = false;
+    return useShellStore.subscribe((state) => {
+        if (redirecting || state.activeOverlay !== overlayId)
+            return;
+        redirecting = true;
+        try {
+            useShellStore.getState().closeOverlay();
+            onRedirect();
+        }
+        finally {
+            redirecting = false;
+        }
+    });
+}
+/**
+ * Configures product-owned editor callbacks consumed by Interface's single
+ * keyboard router. Product assemblies use this public application boundary;
+ * the router implementation remains private to Interface.
+ */
+export function configureInterfaceKeyboardRouter(deps) {
+    registerKeyboardRouterDeps(deps);
+}
+/**
+ * Starts the shared Interface application runtime without selecting a product
+ * entry or product extensions. IDE and compatibility callers supply their own
+ * assembly overrides and render the resulting shell themselves.
+ */
+export async function startInterfaceApplication(overrides = {}, options = {}) {
+    // Locale is application-startup state: finish it synchronously before any
+    // extension setup or shell render can observe a mixed-language first frame.
+    initI18n();
+    if (options.locale !== undefined)
+        changeLanguage(options.locale);
+    const runtime = await bootstrapAppHost(overrides);
+    try {
+        bootStageAppMounted();
+        return runtime;
+    }
+    catch (error) {
+        try {
+            await runtime.dispose();
+        }
+        catch {
+            // Startup failure stays authoritative when rollback also fails.
+        }
+        throw error;
+    }
+}
+// Product boot injects the existing domain authority without importing store
+// internals. This is the same configuration function, not another client registry.
+export { configureStudioDomainClients, } from './store-parts/domain-clients';
+export { dispatchAction, registerAction } from './lib/action-registry';

package/dist/package/browser/assets/icons/at.svg

@@ -0,0 +1,3 @@
+<svg width="14" height="14" viewBox="0 0 14 14" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M7.19679 0C9.12093 0 10.6515 0.578616 11.7885 1.73585C12.863 2.81761 13.4003 4.19497 13.4003 5.86792C13.4003 7.20126 12.9817 8.41509 12.1446 9.50943C11.3324 10.5157 10.4641 11.0189 9.53949 11.0189C8.77733 11.0189 8.36502 10.5849 8.30254 9.71698C7.60286 10.6101 6.77822 11.0566 5.82865 11.0566C5.05399 11.0566 4.44177 10.7987 3.99197 10.283C3.52967 9.7673 3.29853 9.11321 3.29853 8.32076C3.29853 6.83648 3.73583 5.5912 4.61044 4.58491C5.43507 3.5912 6.40339 3.09434 7.5154 3.09434C8.43998 3.09434 9.05221 3.5912 9.35208 4.58491L9.67068 3.45283H10.6078L9.25837 8.58491C9.12093 9 9.05221 9.35849 9.05221 9.66038C9.05221 10 9.24587 10.1698 9.6332 10.1698C10.2454 10.1698 10.8639 9.78616 11.4886 9.01887C12.2008 8.11321 12.5569 7.06289 12.5569 5.86792C12.5569 4.45912 12.0821 3.27673 11.1325 2.32076C10.1205 1.33962 8.78983 0.849057 7.14056 0.849057C5.37885 0.849057 3.917 1.44025 2.75502 2.62264C1.58054 3.79245 0.993307 5.27673 0.993307 7.07547C0.993307 9 1.5618 10.5094 2.6988 11.6038C3.82329 12.6604 5.29763 13.1887 7.12182 13.1887C8.5087 13.1887 9.72691 12.9245 10.7764 12.3962C11.6885 11.9182 12.4195 11.2893 12.9692 10.5094H14C13.3378 11.6038 12.4132 12.4528 11.2262 13.0566C10.0018 13.6855 8.63365 14 7.12182 14C4.99777 14 3.27979 13.3711 1.96787 12.1132C0.655957 10.8302 0 9.13836 0 7.03774C0 5.06289 0.674699 3.40881 2.0241 2.07547C3.38599 0.691824 5.11022 0 7.19679 0ZM7.64659 4.01887C6.77198 4.01887 6.00982 4.42138 5.36011 5.22642C4.66042 6.0566 4.31058 7.09434 4.31058 8.33962C4.31058 8.90566 4.44801 9.34591 4.72289 9.66038C5.01026 10.0126 5.39759 10.1887 5.88487 10.1887C6.42213 10.1887 6.95315 9.96227 7.47791 9.50943C7.96519 9.09434 8.2838 8.62264 8.43373 8.09434L8.86479 6.45283C8.98974 5.94969 9.05221 5.66038 9.05221 5.58491C9.05221 5.22013 8.93351 4.8805 8.69612 4.56604C8.44623 4.20126 8.09639 4.01887 7.64659 4.01887Z" fill="white"/>
+</svg>

package/dist/package/browser/assets/icons/chevron-collapse.svg

@@ -0,0 +1,3 @@
+<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M12 10L8 6L4 10" stroke="white" stroke-opacity="0.6" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/dist/package/browser/assets/icons/chevron-expand.svg

@@ -0,0 +1,3 @@
+<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M12 6L8 10L4 6" stroke="white" stroke-opacity="0.6" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/dist/package/browser/assets/icons/chevron-up.svg

@@ -0,0 +1,3 @@
+<svg width="6" height="4" viewBox="0 0 6 4" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M0.180576 3.57538C0.144898 3.55915 0.112505 3.53539 0.0852559 3.50545L0.0858447 3.50513C-0.0277785 3.381 -0.0292503 3.17584 0.0852559 3.05075L2.79041 0.0958597L2.79161 0.0945529C2.81888 0.0645874 2.85131 0.0408074 2.88702 0.0245806C2.92274 0.0083537 2.96104 0 2.99972 0C3.0384 0 3.0767 0.0083537 3.11242 0.0245806C3.14813 0.0408074 3.18056 0.0645874 3.20783 0.0945529C3.21036 0.0973195 3.21283 0.100126 3.21524 0.102972L5.9136 3.05107C5.94098 3.08086 5.96271 3.11626 5.97754 3.15525C5.99237 3.19424 6 3.23604 6 3.27826C6 3.32048 5.99237 3.36228 5.97754 3.40127C5.96271 3.44025 5.94098 3.47566 5.9136 3.50545C5.80027 3.62957 5.61217 3.63118 5.49766 3.50577L2.99943 0.776603L0.501187 3.50577C0.4739 3.53566 0.441476 3.55938 0.405777 3.57555C0.370078 3.59172 0.331807 3.60003 0.293161 3.6C0.254514 3.59997 0.216254 3.5916 0.180576 3.57538Z" fill="white"/>
+</svg>

package/dist/package/browser/assets/icons/close-x.svg

@@ -0,0 +1,3 @@
+<svg width="10" height="10" viewBox="0 0 10 10" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M5 0C2.23888 0 0 2.23888 0 5.00001C0 7.76113 2.23888 10 5 10C7.76112 10 10 7.76113 10 5.00001C10 2.23888 7.76112 0 5 0ZM7.36985 6.97671C7.47112 7.07776 7.47112 7.24334 7.36985 7.34441L7.34438 7.36999C7.24333 7.47115 7.07773 7.47115 6.97669 7.36999L5 5.3934L3.0233 7.36998C2.92225 7.47113 2.75666 7.47113 2.65561 7.36998L2.62992 7.3444C2.52886 7.24333 2.52886 7.07774 2.62992 6.9767L4.60789 4.99999L2.62992 3.0233C2.52886 2.92224 2.52886 2.75666 2.62992 2.6556L2.65561 2.62991C2.75666 2.52887 2.92225 2.52887 3.0233 2.62991L5 4.60778L6.9767 2.63109C7.07775 2.52994 7.24334 2.52994 7.34439 2.63109L7.36987 2.65667C7.47114 2.75773 7.47114 2.92331 7.36987 3.02437L5.39338 5.00001L7.36985 6.97671Z" fill="white" fill-opacity="0.6"/>
+</svg>

package/dist/package/browser/assets/icons/close.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="10" height="10" viewBox="0 0 10 10" fill="none">
+  <path d="M5 0C2.23888 0 0 2.23888 0 5.00001C0 7.76113 2.23888 10 5 10C7.76112 10 10 7.76113 10 5.00001C10 2.23888 7.76112 0 5 0ZM7.36985 6.97671C7.47112 7.07776 7.47112 7.24334 7.36985 7.34441L7.34438 7.36999C7.24333 7.47115 7.07773 7.47115 6.97669 7.36999L5 5.3934L3.0233 7.36998C2.92225 7.47113 2.75666 7.47113 2.65561 7.36998L2.62992 7.3444C2.52886 7.24333 2.52886 7.07774 2.62992 6.9767L4.60789 4.99999L2.62992 3.0233C2.52886 2.92224 2.52886 2.75666 2.62992 2.6556L2.65561 2.62991C2.75666 2.52887 2.92225 2.52887 3.0233 2.62991L5 4.60778L6.9767 2.63109C7.07775 2.52994 7.24334 2.52994 7.34439 2.63109L7.36987 2.65667C7.47114 2.75773 7.47114 2.92331 7.36987 3.02437L5.39338 5.00001L7.36985 6.97671Z" fill="#BEBEBE"/>
+</svg>

package/dist/package/browser/assets/icons/copy.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 12 12" fill="none">
+  <path d="M3.68359 1.50098H7.89421L9.99951 3.54658V8.86514H3.68359V1.50098ZM7.47315 2.31922V3.9557H9.15739L7.47315 2.31922Z" fill="white" fill-opacity="0.6"/>
+  <path d="M2.84212 3.13672V9.68264H7.4738V10.5009H2V3.13672H2.84212Z" fill="white" fill-opacity="0.6"/>
+</svg>

package/dist/package/browser/assets/icons/edit.svg

@@ -0,0 +1,3 @@
+<svg preserveAspectRatio="none" width="100%" height="100%" overflow="visible" style="display: block;" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path id="Vector" d="M2.91456 12.8C2.95444 12.7995 2.99423 12.7961 3.0336 12.7898L6.39744 12.201C6.43788 12.1938 6.47505 12.1741 6.50368 12.1446L14.9824 3.66593C15.0592 3.58913 15.0592 3.46113 14.9824 3.38433L11.6582 0.0576131C11.6396 0.0390675 11.6174 0.0244239 11.593 0.014535C11.5686 0.00464606 11.5425 -0.000290418 11.5162 1.32011e-05C11.4898 -0.000290418 11.4637 0.00464606 11.4393 0.014535C11.4149 0.0244239 11.3928 0.0390675 11.3741 0.0576131L2.89664 8.53761C2.86759 8.56654 2.84796 8.60357 2.84032 8.64385L2.25024 12.0077C2.23351 12.1047 2.23812 12.2043 2.26374 12.2994C2.28936 12.3945 2.33537 12.4828 2.39859 12.5584C2.4618 12.6339 2.5407 12.6947 2.62981 12.7367C2.71891 12.7786 2.81608 12.8007 2.91456 12.8013V12.8ZM4.2624 9.312L11.5162 2.05953L12.9818 3.52641L5.728 10.7776L3.9488 11.0925L4.2624 9.312ZM15.36 14.4794H0.64C0.470261 14.4794 0.307475 14.5468 0.187452 14.6668C0.0674285 14.7868 0 14.9496 0 15.1194V15.84C0 15.9283 0.07168 16 0.16 16H15.84C15.8824 16 15.9231 15.9831 15.9531 15.9531C15.9831 15.9231 16 15.8824 16 15.84V15.1194C16 14.9496 15.9326 14.7868 15.8125 14.6668C15.6925 14.5468 15.5297 14.4794 15.36 14.4794Z" fill="var(--fill-0, #999999)"/>
+</svg>

package/dist/package/browser/assets/icons/fullscreen.svg

@@ -0,0 +1,3 @@
+<svg width="20" height="20" viewBox="0 0 20 20" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M10.8333 2.5V4.1666H15.8334V9.16667H17.5V2.5H10.8333ZM4.1666 10.8333H2.5V17.5H9.16667V15.8334H4.1666V10.8333Z" fill="white"/>
+</svg>

package/dist/package/browser/assets/icons/pause.svg

@@ -0,0 +1,4 @@
+<svg width="14" height="14" viewBox="0 0 14 14" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M9.91797 2.33301H8.7513C8.42914 2.33301 8.16797 2.59418 8.16797 2.91634V11.083C8.16797 11.4052 8.42914 11.6663 8.7513 11.6663H9.91797C10.2401 11.6663 10.5013 11.4052 10.5013 11.083V2.91634C10.5013 2.59418 10.2401 2.33301 9.91797 2.33301Z" fill="black" stroke="black" stroke-width="1.16667" stroke-linecap="round" stroke-linejoin="round"/>
+<path d="M5.25 2.33301H4.08333C3.76117 2.33301 3.5 2.59418 3.5 2.91634V11.083C3.5 11.4052 3.76117 11.6663 4.08333 11.6663H5.25C5.57217 11.6663 5.83333 11.4052 5.83333 11.083V2.91634C5.83333 2.59418 5.57217 2.33301 5.25 2.33301Z" fill="black" stroke="black" stroke-width="1.16667" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/dist/package/browser/assets/icons/play.svg

@@ -0,0 +1,3 @@
+<svg width="14" height="14" viewBox="0 0 14 14" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M3.5 1.75L11.6667 7L3.5 12.25V1.75Z" fill="black" stroke="black" stroke-width="1.16667" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/dist/package/browser/assets/icons/select.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="6" height="9" viewBox="0 0 6 9" fill="none">
+  <path d="M0.353516 0.353516L4.35352 4.35352L0.353516 8.35352" stroke="#999999"/>
+</svg>

package/dist/package/browser/assets/icons/sendMessage-enable.svg

@@ -0,0 +1,4 @@
+<svg width="28" height="28" viewBox="0 0 28 28" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="28" height="28" rx="14" fill="#D4FF48"/>
+<path d="M22.8272 14.2994L7.46332 6.03451C7.24088 5.9226 6.97079 6.09845 7.00256 6.33824L8.19417 20.614C8.21006 20.8378 8.4325 20.9657 8.63904 20.8858L13.5961 18.7916L16.313 21.8929C16.4878 22.0847 16.7897 22.0048 16.8532 21.765L18.156 16.8572L22.8272 14.8749C23.0496 14.763 23.0655 14.4273 22.8272 14.2994ZM16.313 20.4062L14.8831 17.8484L7.57454 6.49811L17.2663 16.5695L16.313 20.4062Z" fill="#000000"/>
+</svg>

package/dist/package/browser/assets/icons/sendMessage.svg

@@ -0,0 +1,4 @@
+<svg width="28" height="28" viewBox="0 0 28 28" fill="none" xmlns="http://www.w3.org/2000/svg">
+<rect width="28" height="28" rx="14" fill="#999999" fill-opacity="0.2"/>
+<path d="M22.8272 14.2994L7.46332 6.03451C7.24088 5.9226 6.97079 6.09845 7.00256 6.33824L8.19417 20.614C8.21006 20.8378 8.4325 20.9657 8.63904 20.8858L13.5961 18.7916L16.313 21.8929C16.4878 22.0847 16.7897 22.0048 16.8532 21.765L18.156 16.8572L22.8272 14.8749C23.0496 14.763 23.0655 14.4273 22.8272 14.2994ZM16.313 20.4062L14.8831 17.8484L7.57454 6.49811L17.2663 16.5695L16.313 20.4062Z" fill="white" fill-opacity="0.2"/>
+</svg>

package/dist/package/browser/assets/icons/status-done.svg

@@ -0,0 +1,11 @@
+<svg width="12" height="12" viewBox="0 0 12 12" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_8243_96262)">
+<path d="M6 11C8.76142 11 11 8.76142 11 6C11 3.23858 8.76142 1 6 1C3.23858 1 1 3.23858 1 6C1 8.76142 3.23858 11 6 11Z" stroke="white" stroke-opacity="0.4" stroke-linecap="round" stroke-linejoin="round"/>
+<path d="M4.5 6L5.5 7L7.5 5" stroke="white" stroke-opacity="0.4" stroke-linecap="round" stroke-linejoin="round"/>
+</g>
+<defs>
+<clipPath id="clip0_8243_96262">
+<rect width="12" height="12" fill="white"/>
+</clipPath>
+</defs>
+</svg>

package/dist/package/browser/assets/icons/status-running.svg

@@ -0,0 +1,10 @@
+<svg width="12" height="12" viewBox="0 0 12 12" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_8243_96260)">
+<path d="M11 6.00025C10.9999 7.05613 10.6656 8.08489 10.045 8.93909C9.4243 9.79329 8.54915 10.4291 7.54493 10.7553C6.54072 11.0816 5.459 11.0816 4.4548 10.7552C3.45061 10.4289 2.57549 9.7931 1.95487 8.93886C1.33425 8.08463 0.999992 7.05585 1 5.99996C1.00001 4.94408 1.33428 3.91531 1.95491 3.06108C2.57554 2.20685 3.45067 1.57103 4.45487 1.24473C5.45907 0.918437 6.54079 0.918422 7.545 1.24469" stroke="#D4FF48" stroke-width="1.11111" stroke-linecap="round" stroke-linejoin="round"/>
+</g>
+<defs>
+<clipPath id="clip0_8243_96260">
+<rect width="12" height="12" fill="white"/>
+</clipPath>
+</defs>
+</svg>

package/dist/package/browser/assets/icons/status-waiting.svg

@@ -0,0 +1,10 @@
+<svg width="12" height="12" viewBox="0 0 12 12" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_8243_96258)">
+<path d="M6 11C8.76142 11 11 8.76142 11 6C11 3.23858 8.76142 1 6 1C3.23858 1 1 3.23858 1 6C1 8.76142 3.23858 11 6 11Z" stroke="white" stroke-opacity="0.4" stroke-linecap="round" stroke-linejoin="round"/>
+</g>
+<defs>
+<clipPath id="clip0_8243_96258">
+<rect width="12" height="12" fill="white"/>
+</clipPath>
+</defs>
+</svg>

package/dist/package/browser/assets/icons/tool-execute-script.svg

@@ -0,0 +1,3 @@
+<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M12.1667 3H3.83328C3.61228 3 3.40033 3.08779 3.24406 3.24406C3.08779 3.40033 3 3.61228 3 3.83328V12.1667C3 12.3877 3.08779 12.5997 3.24406 12.7559C3.40033 12.9122 3.61228 13 3.83328 13H12.1667C12.3877 13 12.5997 12.9122 12.7559 12.7559C12.9122 12.5997 13 12.3877 13 12.1667V3.83328C13 3.61228 12.9122 3.40033 12.7559 3.24406C12.5997 3.08779 12.3877 3 12.1667 3ZM6.48492 9.49416L5.89589 10.0832L3.83328 8.02058L4.42231 7.43155L5.89522 5.95864L6.48425 6.54767L5.01134 8.02058L6.48492 9.49416ZM7.58336 11.3334H6.75008L8.41664 4.66655H9.24992L7.58336 11.3334ZM10.1041 10.0832L9.51508 9.49416L10.988 8.02125L9.51508 6.54834L10.1041 5.95931L11.5777 7.43222L12.1667 8.02125L10.1041 10.0832Z" fill="#D4FF48"/>
+</svg>

package/dist/package/browser/assets/icons/tool-other.svg

@@ -0,0 +1,10 @@
+<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_8243_96221)">
+<path d="M8 3C5.23857 3 3 5.23858 3 8C3 10.7614 5.23858 13 8 13C10.7614 13 13 10.7614 13 8C13 5.23857 10.7614 3 8 3ZM5.73839 8.6185C5.3968 8.6185 5.11989 8.34159 5.11989 8C5.11989 7.65841 5.3968 7.3815 5.73839 7.3815C6.07999 7.3815 6.3569 7.65841 6.3569 8C6.3569 8.34159 6.07999 8.6185 5.73839 8.6185ZM8 8.6185C7.65841 8.6185 7.3815 8.34159 7.3815 8C7.3815 7.65841 7.65841 7.3815 8 7.3815C8.34159 7.3815 8.6185 7.65841 8.6185 8C8.6185 8.34159 8.34159 8.6185 8 8.6185ZM10.2616 8.6185C9.92001 8.6185 9.64311 8.34159 9.64311 8C9.64311 7.65841 9.92001 7.3815 10.2616 7.3815C10.6032 7.3815 10.8801 7.65841 10.8801 8C10.8801 8.34159 10.6032 8.6185 10.2616 8.6185Z" fill="#D4FF48"/>
+</g>
+<defs>
+<clipPath id="clip0_8243_96221">
+<rect width="16" height="16" fill="white"/>
+</clipPath>
+</defs>
+</svg>

package/dist/package/browser/assets/icons/tool-read-file.svg

@@ -0,0 +1,3 @@
+<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M4 3H9.51742L12 5.539V13H4V3ZM9.11111 3.90909V5.95455H11.1111L9.11111 3.90909Z" fill="#D4FF48"/>
+</svg>

package/dist/package/browser/assets/icons/tool-resource-search.svg

@@ -0,0 +1,3 @@
+<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M9.8215 10.5557C8.08733 11.9259 5.56316 11.8105 3.96206 10.2094C2.2366 8.48402 2.2366 5.68651 3.96206 3.96107C5.68753 2.23563 8.48508 2.23563 10.2105 3.96107C11.8117 5.56218 11.927 8.08643 10.5567 9.82057L13.3346 12.5986L12.5995 13.3337L9.8215 10.5557Z" fill="#D4FF48"/>
+</svg>

package/dist/package/browser/assets/icons/tool-task-todo.svg

@@ -0,0 +1,4 @@
+<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M9.86123 3H6.14374V4.85874H9.86123V3Z" fill="#D4FF48"/>
+<path d="M3.82031 3.92937H5.21437V5.78812H10.7906V3.92937H12.1847V13.2231H3.82031V3.92937ZM9.39654 8.57623V7.64686H6.60843V8.57623H9.39654ZM9.39654 10.435V9.5056H6.60843V10.435H9.39654Z" fill="#D4FF48"/>
+</svg>

package/dist/package/browser/assets/icons/tool-write-file.svg

@@ -0,0 +1,3 @@
+<svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M11.377 3.31061C10.9629 2.89646 10.2915 2.89646 9.87728 3.31061L9.00518 4.1827L11.8173 6.99478L12.6894 6.1227C13.1035 5.70854 13.1035 5.03707 12.6894 4.62292L11.377 3.31061ZM11.0673 7.74497L8.25519 4.9329L3.57078 9.61787L3 13.0007L6.38287 12.43L11.0673 7.74497Z" fill="#D4FF48"/>
+</svg>

package/dist/package/browser/boot/SettingsSection.d.ts

@@ -0,0 +1,14 @@
+import { type ReactNode } from 'react';
+/**
+ * SettingsPanel section node for the boot splash.
+ *
+ * The boot splash itself is rendered by `index.html` BEFORE React mounts —
+ * this section only writes the persisted config. A "应用并刷新预览" button
+ * triggers a full reload so the player can actually see the splash they
+ * just configured (the inline script reads localStorage on page-load).
+ *
+ * AI / external clients can also POST /api/boot-splash to mutate this same
+ * config — the store reconciles server → client on mount and writes back
+ * on every save.
+ */
+export declare function BootSplashSection(): ReactNode;

package/dist/package/browser/boot/SettingsSection.js

@@ -0,0 +1,82 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { Sparkles, RefreshCw } from 'lucide-react';
+import { useTranslation } from '../i18n';
+import { Section } from '../components/SettingsPrimitives';
+import { SPLASH_THEMES, themeById } from './themes';
+import { useSplashConfig } from './store';
+import { DEFAULT_SPLASH } from './types';
+/**
+ * SettingsPanel section node for the boot splash.
+ *
+ * The boot splash itself is rendered by `index.html` BEFORE React mounts —
+ * this section only writes the persisted config. A "应用并刷新预览" button
+ * triggers a full reload so the player can actually see the splash they
+ * just configured (the inline script reads localStorage on page-load).
+ *
+ * AI / external clients can also POST /api/boot-splash to mutate this same
+ * config — the store reconciles server → client on mount and writes back
+ * on every save.
+ */
+export function BootSplashSection() {
+    const { t } = useTranslation();
+    const [cfg, setCfg] = useSplashConfig();
+    const update = (patch) => {
+        setCfg({ ...cfg, ...patch });
+    };
+    const active = themeById(cfg.theme);
+    const preview = useMemo(() => (_jsxs("div", { style: {
+            marginTop: 8,
+            padding: '10px 12px',
+            borderRadius: 8,
+            border: `1px solid ${active.swatch}44`,
+            background: `linear-gradient(135deg, ${active.swatch}10, transparent 70%), rgba(20,24,28,0.6)`,
+            display: 'flex',
+            alignItems: 'center',
+            gap: 10,
+        }, "aria-label": "splash preview swatch", children: [_jsx("span", { style: {
+                    width: 9,
+                    height: 9,
+                    borderRadius: '50%',
+                    background: active.swatch,
+                    boxShadow: `0 0 8px ${active.swatch}88`,
+                    flexShrink: 0,
+                } }), _jsx("span", { style: { color: active.swatch, fontWeight: 600, fontSize: 13 }, children: cfg.title }), _jsx("span", { style: { marginLeft: 'auto', fontSize: 11, opacity: 0.55 }, children: cfg.subtitle })] })), [active, cfg.title, cfg.subtitle]);
+    return (_jsxs(_Fragment, { children: [_jsxs(Section, { icon: _jsx(Sparkles, { size: 14 }), title: t('boot.theme.title'), hint: t('boot.theme.hint'), children: [_jsx("div", { style: { display: 'flex', flexDirection: 'column', gap: 8 }, children: SPLASH_THEMES.map((theme) => {
+                            const checked = theme.id === cfg.theme;
+                            return (_jsxs("label", { style: {
+                                    display: 'flex',
+                                    alignItems: 'flex-start',
+                                    gap: 10,
+                                    padding: '8px 10px',
+                                    borderRadius: 6,
+                                    border: `1px solid ${checked ? theme.swatch + '55' : 'rgba(255,255,255,0.06)'}`,
+                                    background: checked ? `${theme.swatch}0d` : 'transparent',
+                                    cursor: 'pointer',
+                                }, children: [_jsx("input", { type: "radio", name: "splash-theme", checked: checked, onChange: () => update({ theme: theme.id }), style: { marginTop: 3, accentColor: theme.swatch } }), _jsx("span", { "aria-hidden": true, style: {
+                                            width: 10, height: 10, borderRadius: '50%',
+                                            background: theme.swatch,
+                                            boxShadow: `0 0 6px ${theme.swatch}88`,
+                                            flexShrink: 0,
+                                            marginTop: 5,
+                                        } }), _jsxs("span", { style: { display: 'flex', flexDirection: 'column' }, children: [_jsx("span", { style: { fontSize: 13, fontWeight: 600, color: checked ? theme.swatch : 'var(--text-secondary)' }, children: t(theme.labelKey) }), _jsx("span", { style: { fontSize: 11, opacity: 0.6, marginTop: 2 }, children: t(theme.descKey) })] })] }, theme.id));
+                        }) }), preview] }), _jsx(Section, { icon: _jsx(Sparkles, { size: 14 }), title: t('boot.copy.title'), hint: t('boot.copy.hint'), children: _jsxs("div", { style: { display: 'grid', gridTemplateColumns: '90px 1fr', gap: 8, alignItems: 'center' }, children: [_jsx("label", { htmlFor: "splash-title", style: { fontSize: 12, opacity: 0.75 }, children: t('boot.copy.titleLabel') }), _jsx("input", { id: "splash-title", type: "text", value: cfg.title, onChange: (e) => update({ title: e.target.value }), placeholder: DEFAULT_SPLASH.title, style: inputStyle }), _jsx("label", { htmlFor: "splash-sub", style: { fontSize: 12, opacity: 0.75 }, children: t('boot.copy.subtitleLabel') }), _jsx("input", { id: "splash-sub", type: "text", value: cfg.subtitle, onChange: (e) => update({ subtitle: e.target.value }), placeholder: DEFAULT_SPLASH.subtitle, style: inputStyle })] }) }), _jsxs(Section, { icon: _jsx(Sparkles, { size: 14 }), title: t('boot.components.title'), hint: t('boot.components.hint'), children: [_jsxs("label", { style: toggleStyle, children: [_jsx("input", { type: "checkbox", checked: cfg.showProgressBar, onChange: (e) => update({ showProgressBar: e.target.checked }) }), _jsx("span", { children: t('boot.components.showProgressBar') }), _jsx("span", { style: { opacity: 0.5, fontSize: 11, marginLeft: 8 }, children: t('boot.components.showProgressBarHint') })] }), _jsxs("label", { style: toggleStyle, children: [_jsx("input", { type: "checkbox", checked: cfg.showBusInventory, onChange: (e) => update({ showBusInventory: e.target.checked }) }), _jsx("span", { children: t('boot.components.showBusInventory') }), _jsx("span", { style: { opacity: 0.5, fontSize: 11, marginLeft: 8 }, children: t('boot.components.showBusInventoryHint') })] })] }), _jsx(Section, { icon: _jsx(RefreshCw, { size: 14 }), title: t('boot.apply.title'), children: _jsxs("div", { style: { display: 'flex', gap: 8, alignItems: 'center', flexWrap: 'wrap' }, children: [_jsxs("button", { type: "button", className: "settings-edit-btn", onClick: () => window.location.reload(), title: t('boot.apply.reloadTooltip'), children: [_jsx(RefreshCw, { size: 12 }), " ", t('boot.apply.reloadButton')] }), _jsx("button", { type: "button", className: "settings-edit-btn", onClick: () => setCfg({ ...DEFAULT_SPLASH }), title: t('boot.apply.resetTooltip'), children: t('boot.apply.resetButton') }), _jsxs("span", { style: { fontSize: 11, opacity: 0.5, marginLeft: 'auto' }, children: [t('boot.apply.apiHintBefore'), " ", _jsx("code", { style: { background: 'rgba(255,255,255,0.04)', padding: '1px 4px', borderRadius: 3 }, children: "/api/boot-splash" }), " ", t('boot.apply.apiHintAfter')] })] }) })] }));
+}
+const inputStyle = {
+    background: 'rgba(0,0,0,0.4)',
+    border: '1px solid rgba(255,255,255,0.08)',
+    borderRadius: 5,
+    padding: '6px 9px',
+    color: 'var(--text-primary)',
+    fontSize: 12,
+    fontFamily: 'inherit',
+    outline: 'none',
+};
+const toggleStyle = {
+    display: 'flex',
+    alignItems: 'center',
+    gap: 8,
+    padding: '6px 0',
+    fontSize: 12,
+    cursor: 'pointer',
+};

package/dist/package/browser/boot/broadcast.d.ts

@@ -0,0 +1,2 @@
+/** 幂等：多个 boot 路径/HMR 重复调只接线一次；connect 本身也幂等。 */
+export declare function bootBroadcast(): void;

package/dist/package/browser/boot/broadcast.js

@@ -0,0 +1,32 @@
+// interface 广播流 boot 接线 —— 每页 boot 调一次 `bootBroadcast()`，拉起唯一公共 `/ws`
+// 广播连接，并挂上 app-agnostic 的两类帧处理：
+//   - `telemetry`         → 喂 telemetry slice（观测；P3 会随观测面下沉到 app）
+//   - `telemetry` → 喂 telemetry slice
+//
+// daemon-tick-* 帧不在这里处理 —— 那是 chat 的事，chat boot 调 subscribeDaemonTick()
+// 自行订阅同一条广播流（见 packages/chat/src/session-store/daemon-tick.ts）。
+//
+// 取代了原 store.ts 里 module-load 自动 connectDaemonWs 的反模式：现在「建 socket」
+// 由 boot 显式发起、全页单例，import store 不再有开 socket 的副作用。
+import { connect, subscribeBroadcast } from '../lib/broadcast-stream';
+import { useShellStore } from '../store';
+const _BOOT_FLAG = '__FORGEAX_BOOT_BROADCAST__';
+/** 幂等：多个 boot 路径/HMR 重复调只接线一次；connect 本身也幂等。 */
+export function bootBroadcast() {
+    if (typeof window === 'undefined')
+        return;
+    const gt = globalThis;
+    if (!gt[_BOOT_FLAG]) {
+        gt[_BOOT_FLAG] = true;
+        // Telemetry (trace+log) 主信道：node sidecar → server → WS `{type:'telemetry', records}`。
+        subscribeBroadcast('telemetry', (m) => {
+            const records = Array.isArray(m.records)
+                ? (m.records)
+                : [];
+            if (records.length)
+                useShellStore.getState().pushTelemetry(records);
+        });
+    }
+    // 每次都确保连接活着（幂等）。
+    connect();
+}

package/dist/package/browser/boot/driver.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Boot driver — the React-side half of the boot splash handshake.
+ *
+ * The inline bootstrap in index.html exposes `window.__forgeaxBoot` with two
+ * methods: `progress({pct, label})` and `done()`. While React is mounting we
+ * call these to drive the visible progress bar; after the first paint we
+ * fire `done()` so the splash fades out and the studio takes over.
+ *
+ * The contract is one-way and lossy: missing window.__forgeaxBoot (e.g. user
+ * loaded a stripped index.html) is silently ignored — the studio still works,
+ * just without splash control.
+ */
+/**
+ * Called at the top of main.tsx (before createRoot.render) to mark "JS is
+ * executing, React is about to mount".
+ */
+export declare function bootStageEntry(): void;
+/**
+ * Called from <App/>'s first useEffect to mark "React tree is wired and
+ * client-side effects are firing". One rAF later we declare done().
+ */
+export declare function bootStageAppMounted(): void;