@xopcai/xopc 0.0.103 → 0.0.104

package/dist/src/extensions/types/tui.d.ts

@@ -2,7 +2,7 @@
  * TUI extension host contract — minimal surface for `api.registerTui()`.
  * Implementations live under `src/tui/extension-host/` (pi-tui types stay there).
  */
-export type TuiNotifyLevel = 'info' | 'warn' | 'error';
+export type TuiNotifyLevel = 'info' | 'warn' | 'warning' | 'error';
 export interface TuiAutocompleteSuggestion {
     name: string;
     description?: string;
@@ -11,27 +11,436 @@ export type TuiAutocompleteProvider = (query: string, context: {
     cwd: string;
     sessionKey: string;
 }) => TuiAutocompleteSuggestion[] | Promise<TuiAutocompleteSuggestion[]>;
+export interface TuiAutocompleteItem {
+    value: string;
+    label: string;
+    description?: string;
+}
+export interface TuiAutocompleteSuggestions {
+    items: TuiAutocompleteItem[];
+    prefix: string;
+}
+export interface TuiAutocompleteProviderApi {
+    getSuggestions(lines: string[], cursorLine: number, cursorCol: number, options: {
+        signal: AbortSignal;
+        force?: boolean;
+    }): Promise<TuiAutocompleteSuggestions | null>;
+    applyCompletion(lines: string[], cursorLine: number, cursorCol: number, item: TuiAutocompleteItem, prefix: string): {
+        lines: string[];
+        cursorLine: number;
+        cursorCol: number;
+    };
+    shouldTriggerFileCompletion?(lines: string[], cursorLine: number, cursorCol: number): boolean;
+    triggerCharacters?: string[];
+}
+export type TuiAutocompleteProviderFactory = (current: TuiAutocompleteProviderApi) => TuiAutocompleteProviderApi;
 export interface TuiToolRenderContext {
     toolName: string;
+    toolCallId: string;
     args: unknown;
     resultText: string;
+    content?: Array<{
+        type: string;
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    details?: unknown;
+    invalidate: () => void;
+    lastComponent: unknown;
+    state: Record<string, unknown>;
+    cwd: string;
+    executionStarted: boolean;
+    argsComplete: boolean;
     isError: boolean;
+    isPartial?: boolean;
+    expanded: boolean;
+    showImages: boolean;
+}
+export type TuiToolRendererResult = string[] | TuiRenderableComponent | null | undefined;
+export type TuiToolRenderer = (ctx: TuiToolRenderContext) => TuiToolRendererResult;
+export interface TuiToolRenderResultOptions {
     expanded: boolean;
+    isPartial: boolean;
+}
+export interface TuiToolRendererDefinition {
+    renderShell?: 'default' | 'self';
+    render?: TuiToolRenderer;
+    renderCall?: (args: unknown, theme: TuiTheme, context: TuiToolRenderContext) => TuiToolRendererResult;
+    renderResult?: (result: {
+        content?: TuiToolRenderContext['content'];
+        details?: unknown;
+        text: string;
+    }, options: TuiToolRenderResultOptions, theme: TuiTheme, context: TuiToolRenderContext) => TuiToolRendererResult;
+}
+export type TuiToolRendererRegistration = TuiToolRenderer | TuiToolRendererDefinition;
+export interface TuiCommandInfo {
+    name: string;
+    description?: string;
+    source: 'builtin' | 'extension';
+}
+export interface TuiContextUsage {
+    /** xopc-native token estimate field. */
+    estimatedTokens: number | null;
+    /** pi-compatible token estimate field. */
+    tokens: number | null;
+    contextWindow: number | null;
+    /** xopc-native context usage percent field. */
+    usagePercent: number | null;
+    /** pi-compatible context usage percent field. */
+    percent: number | null;
+}
+export interface TuiModelInfo {
+    provider?: string;
+    id: string;
+    ref: string;
+    contextWindow?: number | null;
+}
+export type TuiModelRegistryModel = {
+    provider: string;
+    id: string;
+    ref?: string;
+    contextWindow?: number | null;
+} & Record<string, unknown>;
+export type TuiModelAuthResult = {
+    ok: true;
+    apiKey?: string;
+    headers?: Record<string, string>;
+} | {
+    ok: false;
+    error: string;
+};
+export interface TuiModelRegistry {
+    find(provider: string, modelId: string): TuiModelRegistryModel | undefined;
+    getApiKeyAndHeaders(model: TuiModelRegistryModel): Promise<TuiModelAuthResult>;
+}
+export type TuiThinkingLevel = 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'adaptive';
+export type TuiReasoningLevel = 'off' | 'on' | 'stream';
+export type TuiVerboseLevel = 'off' | 'on' | 'full';
+export interface TuiDialogOptions {
+    signal?: AbortSignal;
+    timeout?: number;
+}
+export type TuiTheme = Record<string, unknown>;
+export interface TuiThemeInfo {
+    name: string;
+    path: string | undefined;
+}
+export interface TuiSetThemeResult {
+    success: boolean;
+    error?: string;
+}
+export interface TuiCustomMessage<T = unknown> {
+    customType: string;
+    content: string | unknown[];
+    display?: boolean;
+    details?: T;
+}
+export interface TuiMessageRenderOptions {
+    expanded: boolean;
+}
+export type TuiMessageRenderer<T = unknown> = (message: TuiCustomMessage<T>, options: TuiMessageRenderOptions, theme: TuiTheme) => TuiRenderableComponent | undefined;
+export type TuiWidgetPlacement = 'aboveEditor' | 'belowEditor';
+export interface TuiWidgetOptions {
+    placement?: TuiWidgetPlacement;
+}
+export type TuiRenderableComponent = {
+    render(width: number): string[];
+    invalidate?(): void;
+    dispose?(): void;
+};
+export type TuiWidgetFactory = (tui: unknown, theme: unknown) => TuiRenderableComponent;
+export type TuiHeaderFactory = (tui: unknown, theme: unknown) => TuiRenderableComponent;
+export interface TuiFooterDataProvider {
+    getGitBranch(): string | null;
+    getExtensionStatuses(): ReadonlyMap<string, string>;
+    getAvailableProviderCount(): number;
+    onBranchChange(callback: () => void): () => void;
+}
+export type TuiFooterFactory = (tui: unknown, theme: unknown, footerData: TuiFooterDataProvider) => TuiRenderableComponent;
+export type TuiEditorComponent = TuiRenderableComponent & {
+    getText(): string;
+    setText(text: string): void;
+    handleInput(data: string): void;
+    onSubmit?: (text: string) => void;
+    onChange?: (text: string) => void;
+    addToHistory?(text: string): void;
+    insertTextAtCursor?(text: string): void;
+    getExpandedText?(): string;
+    setAutocompleteProvider?(provider: TuiAutocompleteProviderApi): void;
+    borderColor?: (text: string) => string;
+    setPaddingX?(padding: number): void;
+    setAutocompleteMaxVisible?(maxVisible: number): void;
+};
+export type TuiEditorFactory = (tui: unknown, theme: unknown, keybindings: unknown) => TuiEditorComponent;
+export type TuiCustomComponent = unknown & {
+    dispose?(): void;
+};
+export type TuiOverlayAnchor = 'center' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'top-center' | 'bottom-center' | 'left-center' | 'right-center';
+export interface TuiOverlayMargin {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+export type TuiOverlaySizeValue = number | `${number}%`;
+export interface TuiOverlayOptions {
+    width?: TuiOverlaySizeValue;
+    minWidth?: number;
+    maxHeight?: TuiOverlaySizeValue;
+    anchor?: TuiOverlayAnchor;
+    offsetX?: number;
+    offsetY?: number;
+    row?: TuiOverlaySizeValue;
+    col?: TuiOverlaySizeValue;
+    margin?: TuiOverlayMargin | number;
+    visible?: (termWidth: number, termHeight: number) => boolean;
+    nonCapturing?: boolean;
+}
+export interface TuiOverlayHandle {
+    hide(): void;
+    setHidden(hidden: boolean): void;
+    isHidden(): boolean;
+    focus(): void;
+    unfocus(options?: {
+        target: unknown | null;
+    }): void;
+    isFocused(): boolean;
+}
+export type TuiCustomFactoryResult = TuiCustomComponent | Promise<TuiCustomComponent>;
+export type TuiCustomLegacyFactory<T> = (done: (result: T) => void) => TuiCustomFactoryResult;
+export type TuiCustomFullFactory<T> = (tui: unknown, theme: unknown, keybindings: unknown, done: (result: T) => void) => TuiCustomFactoryResult;
+export type TuiCustomFactory<T> = TuiCustomLegacyFactory<T> | TuiCustomFullFactory<T>;
+export interface TuiCustomOptions {
+    /** xopc currently renders custom components as overlays. */
+    overlay?: boolean;
+    overlayOptions?: TuiOverlayOptions | (() => TuiOverlayOptions | undefined);
+    onHandle?: (handle: TuiOverlayHandle) => void;
+}
+export type TuiTerminalInputHandler = (data: string) => {
+    consume?: boolean;
+    data?: string;
+} | undefined;
+export interface TuiCompactOptions {
+    customInstructions?: string;
+    onComplete?: (result: TuiCompactResult) => void;
+    onError?: (error: Error) => void;
+}
+export interface TuiCompactResult {
+    compacted: boolean;
+    summary?: string;
+    tokensBefore?: number;
+    tokensAfter?: number;
+    transcriptSummary?: string;
+}
+export interface TuiSystemPromptOptions {
+    cwd: string;
+    sessionKey?: string;
+    model?: TuiModelInfo;
+}
+export interface TuiReplacementResult {
+    cancelled: boolean;
+}
+export interface TuiReplacedSessionContext extends TuiActionContext {
+    sendMessage<T = unknown>(message: TuiCustomMessage<T>, options?: {
+        triggerTurn?: boolean;
+        deliverAs?: 'steer' | 'followUp' | 'nextTurn';
+    }): Promise<void>;
+    sendUserMessage(content: string | Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>, options?: {
+        deliverAs?: 'steer' | 'followUp';
+    }): Promise<void>;
+}
+export interface TuiNewSessionOptions {
+    parentSession?: string;
+    setup?: (sessionManager: TuiReadonlySessionManager) => Promise<void>;
+    withSession?: (ctx: TuiReplacedSessionContext) => Promise<void>;
+}
+export interface TuiForkOptions {
+    position?: 'before' | 'at';
+    withSession?: (ctx: TuiReplacedSessionContext) => Promise<void>;
+}
+export interface TuiNavigateTreeOptions {
+    summarize?: boolean;
+    customInstructions?: string;
+    replaceInstructions?: boolean;
+    label?: string;
+}
+export interface TuiSwitchSessionOptions {
+    withSession?: (ctx: TuiReplacedSessionContext) => Promise<void>;
+}
+export interface TuiSessionSnapshotEntry {
+    id: string;
+    type: string;
+    parentId: string | null;
+    userLabel?: string;
+    labelTimestamp?: string;
+    role?: 'user' | 'assistant' | 'system';
+    message?: {
+        role: 'user' | 'assistant' | 'system';
+        content: string;
+        usage?: {
+            input: number;
+            output: number;
+            cost: {
+                total: number;
+            };
+        };
+    };
+    content: string;
+    timestamp?: number;
+    raw?: unknown;
+}
+export interface TuiSessionSnapshotHeader {
+    type: 'session';
+    version?: number;
+    id: string;
+    timestamp: string;
+    cwd: string;
+    parentSession?: string;
+}
+export interface TuiSessionSnapshotTreeNode {
+    entry: TuiSessionSnapshotEntry;
+    children: TuiSessionSnapshotTreeNode[];
+    label?: string;
+    labelTimestamp?: string;
+}
+export interface TuiReadonlySessionManager {
+    getEntries(): TuiSessionSnapshotEntry[];
+    getBranch(): TuiSessionSnapshotEntry[];
+    getLeafEntry(): TuiSessionSnapshotEntry | undefined;
+    getLeafId(): string | null;
+    getEntry(entryId: string): TuiSessionSnapshotEntry | undefined;
+    getLabel(entryId: string): string | undefined;
+    getHeader(): TuiSessionSnapshotHeader | null;
+    getTree(): TuiSessionSnapshotTreeNode[];
+    getSessionId(): string;
+    getSessionFile(): string | undefined;
+    getSessionDir(): string | undefined;
+    getSessionName(): string | undefined;
+    getCwd(): string;
+}
+export interface TuiActionUiContext {
+    select(title: string, options: string[], opts?: TuiDialogOptions): Promise<string | undefined>;
+    confirm(title: string, message: string, opts?: TuiDialogOptions): Promise<boolean>;
+    input(title: string, placeholder?: string, opts?: TuiDialogOptions): Promise<string | undefined>;
+    notify(message: string, level?: TuiNotifyLevel): void;
+    onTerminalInput(handler: TuiTerminalInputHandler): () => void;
+    setStatus(key: string, text: string | null | undefined): void;
+    setWorkingMessage(message?: string | null): void;
+    setWorkingVisible(visible: boolean): void;
+    setWorkingIndicator(options?: TuiWorkingIndicatorOptions | null): void;
+    setHiddenThinkingLabel(label?: string | null): void;
+    setWidget(key: string, lines: string[] | null | undefined, options?: TuiWidgetOptions): void;
+    setWidget(key: string, factory: TuiWidgetFactory | undefined, options?: TuiWidgetOptions): void;
+    setFooter(factory: TuiFooterFactory | undefined): void;
+    setHeader(factory: TuiHeaderFactory | undefined): void;
+    custom<T>(factory: TuiCustomFactory<T>, options?: TuiCustomOptions): Promise<T>;
+    setTitle(title: string): void;
+    pasteToEditor(text: string): void;
+    setEditorText(text: string): void;
+    getEditorText(): string;
+    editor(title: string, prefill?: string): Promise<string | undefined>;
+    addAutocompleteProvider(factory: TuiAutocompleteProviderFactory): () => void;
+    setEditorComponent(factory: TuiEditorFactory | undefined): void;
+    getEditorComponent(): TuiEditorFactory | undefined;
+    readonly theme: TuiTheme;
+    getAllThemes(): TuiThemeInfo[];
+    getTheme(name: string): TuiTheme | undefined;
+    setTheme(theme: string): TuiSetThemeResult;
+    getToolsExpanded(): boolean;
+    setToolsExpanded(expanded: boolean): void;
+}
+export interface TuiActionContext {
+    readonly mode: 'tui';
+    readonly hasUI: true;
+    readonly signal?: AbortSignal;
+    readonly ui: TuiActionUiContext;
+    readonly sessionManager: TuiReadonlySessionManager;
+    readonly modelRegistry: TuiModelRegistry;
+    readonly model: TuiModelInfo | undefined;
+    cwd: string;
+    sessionKey: string;
+    isProjectTrusted(): boolean;
+    isIdle(): boolean;
+    hasPendingMessages(): boolean;
+    abort(): void | Promise<void>;
+    shutdown(): void;
+    compact(options?: TuiCompactOptions): void | Promise<void | TuiCompactResult>;
+    getSystemPrompt(): string;
+    getSystemPromptOptions(): TuiSystemPromptOptions;
+    waitForIdle(): Promise<void>;
+    newSession(options?: TuiNewSessionOptions): Promise<TuiReplacementResult>;
+    fork(entryId: string, options?: TuiForkOptions): Promise<TuiReplacementResult>;
+    navigateTree(targetId: string, options?: TuiNavigateTreeOptions): Promise<TuiReplacementResult>;
+    switchSession(sessionPath: string, options?: TuiSwitchSessionOptions): Promise<TuiReplacementResult>;
+    reload(): Promise<void>;
+    getModel(): TuiModelInfo | undefined;
+    setModel(modelRef: string): void | Promise<void>;
+    getThinkingLevel(): TuiThinkingLevel | undefined;
+    setThinkingLevel(level: TuiThinkingLevel): void | Promise<void>;
+    getReasoningLevel(): TuiReasoningLevel | undefined;
+    setReasoningLevel(level: TuiReasoningLevel): void | Promise<void>;
+    getVerboseLevel(): TuiVerboseLevel | undefined;
+    setVerboseLevel(level: TuiVerboseLevel): void | Promise<void>;
+    getCommands(): TuiCommandInfo[];
+    getContextUsage(): TuiContextUsage | undefined;
+    notify(message: string, level?: TuiNotifyLevel): void;
+}
+export type TuiSlashCommandContext = TuiActionContext;
+export type TuiSlashCommandHandler = (args: string, context?: TuiSlashCommandContext) => void | Promise<void>;
+export type TuiShortcutContext = TuiActionContext;
+export type TuiShortcutHandler = (context: TuiShortcutContext) => void | Promise<void>;
+export interface TuiWorkingIndicatorOptions {
+    /** Animation frames. Use an empty array to hide the indicator. */
+    frames?: string[];
+    /** Frame interval in milliseconds for animated indicators. */
+    intervalMs?: number;
 }
-export type TuiToolRenderer = (ctx: TuiToolRenderContext) => string[] | null;
-export type TuiSlashCommandHandler = (args: string) => void | Promise<void>;
 /** Host passed to extension `registerTui` callbacks when `xopc tui` starts. */
 export interface TuiExtensionHostContract {
     readonly extensionId: string;
     setFooterWidget(key: string, lines: string[] | null): void;
     setHeaderWidget(key: string, lines: string[] | null): void;
+    setWidget(key: string, lines: string[] | null | undefined, options?: TuiWidgetOptions): void;
+    setWidget(key: string, factory: TuiWidgetFactory | undefined, options?: TuiWidgetOptions): void;
+    setFooter(factory: TuiFooterFactory | undefined): void;
+    setHeader(factory: TuiHeaderFactory | undefined): void;
     addAutocompleteProvider(provider: TuiAutocompleteProvider): () => void;
-    registerToolRenderer(toolName: string, renderer: TuiToolRenderer): () => void;
+    addAutocompleteProvider(factory: TuiAutocompleteProviderFactory): () => void;
+    registerToolRenderer(toolName: string, renderer: TuiToolRendererRegistration): () => void;
+    registerMessageRenderer<T = unknown>(customType: string, renderer: TuiMessageRenderer<T>): () => void;
     registerSlashCommand(name: string, description: string, handler: TuiSlashCommandHandler): () => void;
+    registerShortcut(key: string, description: string, handler: TuiShortcutHandler): () => void;
     notify(message: string, level?: TuiNotifyLevel): void;
+    onTerminalInput(handler: TuiTerminalInputHandler): () => void;
     showOverlay(component: unknown): void;
     hideOverlay(): void;
-    setStatus(key: string, text: string | null): void;
+    custom<T>(factory: TuiCustomFactory<T>, options?: TuiCustomOptions): Promise<T>;
+    setTitle(title: string): void;
+    pasteToEditor(text: string): void;
+    setEditorText(text: string): void;
+    getEditorText(): string;
+    editor(title: string, prefill?: string): Promise<string | undefined>;
+    setEditorComponent(factory: TuiEditorFactory | undefined): void;
+    getEditorComponent(): TuiEditorFactory | undefined;
+    readonly theme: TuiTheme;
+    getAllThemes(): TuiThemeInfo[];
+    getTheme(name: string): TuiTheme | undefined;
+    setTheme(theme: string): TuiSetThemeResult;
+    getToolsExpanded(): boolean;
+    setToolsExpanded(expanded: boolean): void;
+    select(title: string, options: string[], opts?: TuiDialogOptions): Promise<string | undefined>;
+    confirm(title: string, message: string, opts?: TuiDialogOptions): Promise<boolean>;
+    input(title: string, placeholder?: string, opts?: TuiDialogOptions): Promise<string | undefined>;
+    setStatus(key: string, text: string | null | undefined): void;
+    setWorkingMessage(message?: string | null): void;
+    setWorkingVisible(visible: boolean): void;
+    setWorkingIndicator(options?: TuiWorkingIndicatorOptions | null): void;
+    setHiddenThinkingLabel(label?: string | null): void;
 }
 export type TuiExtensionRegistrar = (host: TuiExtensionHostContract) => void | Promise<void>;
 export interface TuiExtensionRegistration {

package/dist/src/gateway/agent-builtin-tools.d.ts

@@ -2,5 +2,5 @@
  * Built-in agent tool `name` values for gateway admin UI (disable toggles).
  * Extension tools are not listed; users can still add arbitrary strings in config.
  */
-export declare const GATEWAY_BUILTIN_TOOL_IDS: readonly ["read_file", "write_file", "edit_file", "list_dir", "grep", "find", "shell", "web_search", "web_fetch", "send_message", "send_media", "memory_search", "memory_get", "curated_memory", "session_search", "image", "image_generate", "browser_use", "extensions", "bundle-mcp"];
+export declare const GATEWAY_BUILTIN_TOOL_IDS: readonly ["read_file", "write_file", "edit_file", "list_dir", "grep", "find", "shell", "session_status", "dreaming", "tool_manual", "clarify", "todo", "skills_list", "skill_view", "skill_manage", "web_search", "web_fetch", "web_extract", "send_message", "send_media", "read_media", "create_share", "text_to_speech", "memory_search", "memory_get", "curated_memory", "session_search", "cronjob", "workflow", "delegate_task", "execute_code", "image", "image_generate", "browser_use", "extensions", "bundle-mcp"];
 export type GatewayBuiltinToolId = (typeof GATEWAY_BUILTIN_TOOL_IDS)[number];

package/dist/src/gateway/agent-builtin-tools.js

@@ -11,14 +11,30 @@ const GATEWAY_BUILTIN_TOOL_IDS = [
 	"grep",
 	"find",
 	"shell",
+	"session_status",
+	"dreaming",
+	"tool_manual",
+	"clarify",
+	"todo",
+	"skills_list",
+	"skill_view",
+	"skill_manage",
 	"web_search",
 	"web_fetch",
+	"web_extract",
 	"send_message",
 	"send_media",
+	"read_media",
+	"create_share",
+	"text_to_speech",
 	"memory_search",
 	"memory_get",
 	"curated_memory",
 	"session_search",
+	"cronjob",
+	"workflow",
+	"delegate_task",
+	"execute_code",
 	"image",
 	"image_generate",
 	"browser_use",

package/dist/src/gateway/agent-builtin-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-builtin-tools.js","names":[],"sources":["../../../src/gateway/agent-builtin-tools.ts"],"sourcesContent":["/**\n * Built-in agent tool `name` values for gateway admin UI (disable toggles).\n * Extension tools are not listed; users can still add arbitrary strings in config.\n */\nexport const GATEWAY_BUILTIN_TOOL_IDS = [\n  'read_file',\n  'write_file',\n  'edit_file',\n  'list_dir',\n  'grep',\n  'find',\n  'shell',\n  'web_search',\n  'web_fetch',\n  'send_message',\n  'send_media',\n  'memory_search',\n  'memory_get',\n  'curated_memory',\n  'session_search',\n  'image',\n  'image_generate',\n  'browser_use',\n  'extensions',\n  'bundle-mcp',\n] as const;\n\nexport type GatewayBuiltinToolId = (typeof GATEWAY_BUILTIN_TOOL_IDS)[number];\n"],"mappings":";;;;;AAIA,MAAa,2BAA2B;CACtC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"agent-builtin-tools.js","names":[],"sources":["../../../src/gateway/agent-builtin-tools.ts"],"sourcesContent":["/**\n * Built-in agent tool `name` values for gateway admin UI (disable toggles).\n * Extension tools are not listed; users can still add arbitrary strings in config.\n */\nexport const GATEWAY_BUILTIN_TOOL_IDS = [\n  'read_file',\n  'write_file',\n  'edit_file',\n  'list_dir',\n  'grep',\n  'find',\n  'shell',\n  'session_status',\n  'dreaming',\n  'tool_manual',\n  'clarify',\n  'todo',\n  'skills_list',\n  'skill_view',\n  'skill_manage',\n  'web_search',\n  'web_fetch',\n  'web_extract',\n  'send_message',\n  'send_media',\n  'read_media',\n  'create_share',\n  'text_to_speech',\n  'memory_search',\n  'memory_get',\n  'curated_memory',\n  'session_search',\n  'cronjob',\n  'workflow',\n  'delegate_task',\n  'execute_code',\n  'image',\n  'image_generate',\n  'browser_use',\n  'extensions',\n  'bundle-mcp',\n] as const;\n\nexport type GatewayBuiltinToolId = (typeof GATEWAY_BUILTIN_TOOL_IDS)[number];\n"],"mappings":";;;;;AAIA,MAAa,2BAA2B;CACtC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}

package/dist/src/gateway/agent-run-relay.d.ts

@@ -5,14 +5,13 @@
  */
 export type RelayEvent = {
     type: string;
-    [key: string]: unknown;
-};
+} & Record<string, unknown>;
 export declare class AgentRunRelay {
     private runs;
     ensureRun(runId: string, sessionKey: string): void;
     getSessionKey(runId: string): string | undefined;
     hasRun(runId: string): boolean;
-    publish(runId: string, event: RelayEvent): void;
+    publish(runId: string, event: RelayEvent): RelayEvent | undefined;
     complete(runId: string): void;
     subscribe(runId: string): AsyncGenerator<RelayEvent>;
 }

package/dist/src/gateway/agent-run-relay.js

@@ -12,6 +12,7 @@ var AgentRunRelay = class {
 		this.runs.set(runId, {
 			sessionKey,
 			events: [],
+			nextSeq: 1,
 			done: false,
 			waiters: []
 		});
@@ -24,15 +25,21 @@ var AgentRunRelay = class {
 	}
 	publish(runId, event) {
 		const state = this.runs.get(runId);
-		if (!state) return;
+		if (!state) return void 0;
+		const relayed = {
+			...event,
+			runId,
+			seq: state.nextSeq++
+		};
 		if (state.events.length >= MAX_EVENTS) log.warn({
 			runId,
 			max: MAX_EVENTS,
-			droppedType: event.type
+			droppedType: relayed.type
 		}, "Relay buffer full; dropping event (resume may miss tool_end/tokens)");
-		else state.events.push(event);
+		else state.events.push(relayed);
 		const waiters = state.waiters.splice(0);
 		for (const w of waiters) w();
+		return relayed;
 	}
 	complete(runId) {
 		const state = this.runs.get(runId);

package/dist/src/gateway/agent-run-relay.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-run-relay.js","names":[],"sources":["../../../src/gateway/agent-run-relay.ts"],"sourcesContent":["/**\n * Multicast buffer for a single web agent run so multiple HTTP SSE consumers can\n * attach (initial POST /api/agent and later POST /api/agent/resume) while one\n * background pump drains processDirectStreaming.\n */\n\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('Gateway:AgentRunRelay');\n\nexport type RelayEvent = { type: string; [key: string]: unknown };\n\ntype RunState = {\n  sessionKey: string;\n  events: RelayEvent[];\n  done: boolean;\n  waiters: Array<() => void>;\n  cleanupTimer?: ReturnType<typeof setTimeout>;\n};\n\nconst COMPLETE_TTL_MS = 5 * 60_000;\nconst MAX_EVENTS = 8000;\n\nexport class AgentRunRelay {\n  private runs = new Map<string, RunState>();\n\n  ensureRun(runId: string, sessionKey: string): void {\n    if (this.runs.has(runId)) return;\n    this.runs.set(runId, { sessionKey, events: [], done: false, waiters: [] });\n  }\n\n  getSessionKey(runId: string): string | undefined {\n    return this.runs.get(runId)?.sessionKey;\n  }\n\n  hasRun(runId: string): boolean {\n    return this.runs.has(runId);\n  }\n\n  publish(runId: string, event: RelayEvent): void {\n    const state = this.runs.get(runId);\n    if (!state) return;\n    if (state.events.length >= MAX_EVENTS) {\n      log.warn(\n        { runId, max: MAX_EVENTS, droppedType: event.type },\n        'Relay buffer full; dropping event (resume may miss tool_end/tokens)',\n      );\n    } else {\n      state.events.push(event);\n    }\n    const waiters = state.waiters.splice(0);\n    for (const w of waiters) w();\n  }\n\n  complete(runId: string): void {\n    const state = this.runs.get(runId);\n    if (!state) return;\n    state.done = true;\n    const waiters = state.waiters.splice(0);\n    for (const w of waiters) w();\n    if (state.cleanupTimer) clearTimeout(state.cleanupTimer);\n    state.cleanupTimer = setTimeout(() => {\n      this.runs.delete(runId);\n    }, COMPLETE_TTL_MS);\n  }\n\n  async *subscribe(runId: string): AsyncGenerator<RelayEvent> {\n    const state = this.runs.get(runId);\n    if (!state) {\n      throw new Error('UNKNOWN_RUN');\n    }\n    let cursor = 0;\n    while (true) {\n      while (cursor < state.events.length) {\n        yield state.events[cursor++];\n      }\n      if (state.done) break;\n      await new Promise<void>((resolve) => {\n        state.waiters.push(resolve);\n      });\n    }\n  }\n}\n"],"mappings":";;;aAMkD;AAElD,MAAM,MAAM,aAAa,wBAAwB;AAYjD,MAAM,kBAAkB,IAAI;AAC5B,MAAM,aAAa;AAEnB,IAAa,gBAAb,MAA2B;CACzB,uBAAe,IAAI,KAAuB;CAE1C,UAAU,OAAe,YAA0B;AACjD,MAAI,KAAK,KAAK,IAAI,MAAM,CAAE;AAC1B,OAAK,KAAK,IAAI,OAAO;GAAE;GAAY,QAAQ,EAAE;GAAE,MAAM;GAAO,SAAS,EAAE;GAAE,CAAC;;CAG5E,cAAc,OAAmC;AAC/C,SAAO,KAAK,KAAK,IAAI,MAAM,EAAE;;CAG/B,OAAO,OAAwB;AAC7B,SAAO,KAAK,KAAK,IAAI,MAAM;;CAG7B,QAAQ,OAAe,OAAyB;EAC9C,MAAM,QAAQ,KAAK,KAAK,IAAI,MAAM;AAClC,MAAI,CAAC,MAAO;AACZ,MAAI,MAAM,OAAO,UAAU,WACzB,KAAI,KACF;GAAE;GAAO,KAAK;GAAY,aAAa,MAAM;GAAM,EACnD,sEACD;MAED,OAAM,OAAO,KAAK,MAAM;EAE1B,MAAM,UAAU,MAAM,QAAQ,OAAO,EAAE;AACvC,OAAK,MAAM,KAAK,QAAS,IAAG;;CAG9B,SAAS,OAAqB;EAC5B,MAAM,QAAQ,KAAK,KAAK,IAAI,MAAM;AAClC,MAAI,CAAC,MAAO;AACZ,QAAM,OAAO;EACb,MAAM,UAAU,MAAM,QAAQ,OAAO,EAAE;AACvC,OAAK,MAAM,KAAK,QAAS,IAAG;AAC5B,MAAI,MAAM,aAAc,cAAa,MAAM,aAAa;AACxD,QAAM,eAAe,iBAAiB;AACpC,QAAK,KAAK,OAAO,MAAM;KACtB,gBAAgB;;CAGrB,OAAO,UAAU,OAA2C;EAC1D,MAAM,QAAQ,KAAK,KAAK,IAAI,MAAM;AAClC,MAAI,CAAC,MACH,OAAM,IAAI,MAAM,cAAc;EAEhC,IAAI,SAAS;AACb,SAAO,MAAM;AACX,UAAO,SAAS,MAAM,OAAO,OAC3B,OAAM,MAAM,OAAO;AAErB,OAAI,MAAM,KAAM;AAChB,SAAM,IAAI,SAAe,YAAY;AACnC,UAAM,QAAQ,KAAK,QAAQ;KAC3B"}
+{"version":3,"file":"agent-run-relay.js","names":[],"sources":["../../../src/gateway/agent-run-relay.ts"],"sourcesContent":["/**\n * Multicast buffer for a single web agent run so multiple HTTP SSE consumers can\n * attach (initial POST /api/agent and later POST /api/agent/resume) while one\n * background pump drains processDirectStreaming.\n */\n\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('Gateway:AgentRunRelay');\n\nexport type RelayEvent = { type: string } & Record<string, unknown>;\n\ntype RunState = {\n  sessionKey: string;\n  events: RelayEvent[];\n  nextSeq: number;\n  done: boolean;\n  waiters: Array<() => void>;\n  cleanupTimer?: ReturnType<typeof setTimeout>;\n};\n\nconst COMPLETE_TTL_MS = 5 * 60_000;\nconst MAX_EVENTS = 8000;\n\nexport class AgentRunRelay {\n  private runs = new Map<string, RunState>();\n\n  ensureRun(runId: string, sessionKey: string): void {\n    if (this.runs.has(runId)) return;\n    this.runs.set(runId, { sessionKey, events: [], nextSeq: 1, done: false, waiters: [] });\n  }\n\n  getSessionKey(runId: string): string | undefined {\n    return this.runs.get(runId)?.sessionKey;\n  }\n\n  hasRun(runId: string): boolean {\n    return this.runs.has(runId);\n  }\n\n  publish(runId: string, event: RelayEvent): RelayEvent | undefined {\n    const state = this.runs.get(runId);\n    if (!state) return undefined;\n    const relayed = {\n      ...event,\n      runId,\n      seq: state.nextSeq++,\n    };\n    if (state.events.length >= MAX_EVENTS) {\n      log.warn(\n        { runId, max: MAX_EVENTS, droppedType: relayed.type },\n        'Relay buffer full; dropping event (resume may miss tool_end/tokens)',\n      );\n    } else {\n      state.events.push(relayed);\n    }\n    const waiters = state.waiters.splice(0);\n    for (const w of waiters) w();\n    return relayed;\n  }\n\n  complete(runId: string): void {\n    const state = this.runs.get(runId);\n    if (!state) return;\n    state.done = true;\n    const waiters = state.waiters.splice(0);\n    for (const w of waiters) w();\n    if (state.cleanupTimer) clearTimeout(state.cleanupTimer);\n    state.cleanupTimer = setTimeout(() => {\n      this.runs.delete(runId);\n    }, COMPLETE_TTL_MS);\n  }\n\n  async *subscribe(runId: string): AsyncGenerator<RelayEvent> {\n    const state = this.runs.get(runId);\n    if (!state) {\n      throw new Error('UNKNOWN_RUN');\n    }\n    let cursor = 0;\n    while (true) {\n      while (cursor < state.events.length) {\n        yield state.events[cursor++];\n      }\n      if (state.done) break;\n      await new Promise<void>((resolve) => {\n        state.waiters.push(resolve);\n      });\n    }\n  }\n}\n"],"mappings":";;;aAMkD;AAElD,MAAM,MAAM,aAAa,wBAAwB;AAajD,MAAM,kBAAkB,IAAI;AAC5B,MAAM,aAAa;AAEnB,IAAa,gBAAb,MAA2B;CACzB,uBAAe,IAAI,KAAuB;CAE1C,UAAU,OAAe,YAA0B;AACjD,MAAI,KAAK,KAAK,IAAI,MAAM,CAAE;AAC1B,OAAK,KAAK,IAAI,OAAO;GAAE;GAAY,QAAQ,EAAE;GAAE,SAAS;GAAG,MAAM;GAAO,SAAS,EAAE;GAAE,CAAC;;CAGxF,cAAc,OAAmC;AAC/C,SAAO,KAAK,KAAK,IAAI,MAAM,EAAE;;CAG/B,OAAO,OAAwB;AAC7B,SAAO,KAAK,KAAK,IAAI,MAAM;;CAG7B,QAAQ,OAAe,OAA2C;EAChE,MAAM,QAAQ,KAAK,KAAK,IAAI,MAAM;AAClC,MAAI,CAAC,MAAO,QAAO,KAAA;EACnB,MAAM,UAAU;GACd,GAAG;GACH;GACA,KAAK,MAAM;GACZ;AACD,MAAI,MAAM,OAAO,UAAU,WACzB,KAAI,KACF;GAAE;GAAO,KAAK;GAAY,aAAa,QAAQ;GAAM,EACrD,sEACD;MAED,OAAM,OAAO,KAAK,QAAQ;EAE5B,MAAM,UAAU,MAAM,QAAQ,OAAO,EAAE;AACvC,OAAK,MAAM,KAAK,QAAS,IAAG;AAC5B,SAAO;;CAGT,SAAS,OAAqB;EAC5B,MAAM,QAAQ,KAAK,KAAK,IAAI,MAAM;AAClC,MAAI,CAAC,MAAO;AACZ,QAAM,OAAO;EACb,MAAM,UAAU,MAAM,QAAQ,OAAO,EAAE;AACvC,OAAK,MAAM,KAAK,QAAS,IAAG;AAC5B,MAAI,MAAM,aAAc,cAAa,MAAM,aAAa;AACxD,QAAM,eAAe,iBAAiB;AACpC,QAAK,KAAK,OAAO,MAAM;KACtB,gBAAgB;;CAGrB,OAAO,UAAU,OAA2C;EAC1D,MAAM,QAAQ,KAAK,KAAK,IAAI,MAAM;AAClC,MAAI,CAAC,MACH,OAAM,IAAI,MAAM,cAAc;EAEhC,IAAI,SAAS;AACb,SAAO,MAAM;AACX,UAAO,SAAS,MAAM,OAAO,OAC3B,OAAM,MAAM,OAAO;AAErB,OAAI,MAAM,KAAM;AAChB,SAAM,IAAI,SAAe,YAAY;AACnC,UAAM,QAAQ,KAAK,QAAQ;KAC3B"}

package/dist/src/gateway/agents-admin.d.ts

@@ -1,21 +1,18 @@
 /**
  * Gateway REST helpers for multi-agent management.
  */
-import type { Config } from '../config/schema.js';
-import type { LocalizedText } from '../config/localized-text.js';
+import type { AgentModelsConfig, Config } from '../config/schema.js';
 import type { AgentTypedModel } from '../config/schema.js';
 export type GatewayAgentTypedModelsInfo = {
     defaults: AgentTypedModel[];
+    entry?: AgentTypedModel[];
     effective: AgentTypedModel[];
 };
 export type GatewayAgentRow = {
     id: string;
     name?: string;
     description?: string;
-    localized?: {
-        name?: LocalizedText;
-        description?: LocalizedText;
-    };
+    language?: string;
     /** Value from `IDENTITY.md` **Avatar:** line when present (may be URL, `xopc:…`, etc.). */
     avatar?: string;
     workspace: string;
@@ -45,20 +42,27 @@ export type GatewayAgentsListResponse = {
 };
 /** Extract `**Avatar:**` value from profile IDENTITY.md (same line shape as the gateway console parser). */
 export declare function extractAvatarFromIdentityMarkdown(content: string): string | undefined;
-export declare function listGatewayAgents(cfg: Config, options?: {
+export declare function parseIdentityMarkdown(content: string): {
+    name?: string;
+    description?: string;
+    language?: string;
+    avatar?: string;
+};
+export declare function listGatewayAgents(cfg: Config, _options?: {
     locale?: string;
 }): Promise<GatewayAgentsListResponse>;
 export type CreateAgentBody = {
-    /** Display name stored on the agent entry. */
-    name: LocalizedText;
-    /** Optional id seed; normalized agent id defaults from `name` when omitted. */
+    /** Optional id seed; normalized agent id defaults from `profileFiles["IDENTITY.md"]` name when omitted. */
     id?: string;
     workspace: string;
-    model?: string;
+    models?: AgentModelsConfig;
     agentDir?: string;
-    description?: LocalizedText;
-    /** Initial `agents.list[].tools.disable` for the new entry. */
-    toolsDisable?: string[];
+    /** Initial `agents.list[].skills` for the new entry. */
+    skills?: string[];
+    /** Initial `agents.list[].tools` for the new entry. */
+    tools?: {
+        disable?: string[];
+    };
     /** Profile markdown files to write after seeding (e.g. `IDENTITY.md`, `SOUL.md`). */
     profileFiles?: Record<string, string>;
     /** Clone from an existing agent id — copies config entry fields and profile directory. */
@@ -91,16 +95,25 @@ export declare function finalizeCreateAgentDirs(cfg: Config, agentId: string, op
     cloneFrom?: string;
 }): Promise<AgentAdminResult<void>>;
 export type UpdateAgentBody = {
-    name?: LocalizedText;
-    description?: LocalizedText | null;
     workspace?: string;
-    model?: string | null;
+    models?: {
+        chat?: {
+            primary: string;
+            fallbacks?: string[];
+        } | null;
+        roles?: Record<string, {
+            model: string;
+            description?: string;
+        }> | null;
+    } | null;
     agentDir?: string | null;
     setDefault?: boolean;
     /** Replace `agents.list[].skills`; `null` removes the key (inherit defaults). */
     skills?: string[] | null;
-    /** Replace `agents.list[].tools.disable`; `null` clears entry-level disables. */
-    toolsDisable?: string[] | null;
+    /** Replace `agents.list[].tools`; `null` removes the key (inherit defaults). */
+    tools?: {
+        disable?: string[] | null;
+    } | null;
 };
 export declare function prepareUpdateAgent(cfg: Config, agentIdRaw: string, body: UpdateAgentBody): AgentAdminResult<{
     nextConfig: Config;