@adhdev/daemon-core 0.8.22 → 0.8.24

package/dist/providers/cli-provider-instance.d.ts

@@ -24,6 +24,8 @@ export declare class CliProviderInstance implements ProviderInstance {
     private generatingDebounceTimer;
     private generatingDebouncePending;
     private lastApprovalEventAt;
+    private controlValues;
+    private appliedEffectKeys;
     private historyWriter;
     private runtimeMessages;
     readonly instanceId: string;
@@ -54,6 +56,7 @@ export declare class CliProviderInstance implements ProviderInstance {
     getState(): ProviderState;
     setPresentationMode(mode: 'terminal' | 'chat'): void;
     getPresentationMode(): 'terminal' | 'chat';
+    updateSettings(newSettings: Record<string, any>): void;
     onEvent(event: string, data?: any): void;
     dispose(): void;
     private completedDebounceTimer;
@@ -61,6 +64,9 @@ export declare class CliProviderInstance implements ProviderInstance {
     private detectStatusTransition;
     private pushEvent;
     private flushEvents;
+    private applyProviderResponse;
+    private getEffectDedupKey;
+    private getPersistedEffectContent;
     getAdapter(): ProviderCliAdapter;
     get cliType(): string;
     get cliName(): string;

package/dist/providers/contracts.d.ts

@@ -23,6 +23,10 @@ export interface ReadChatResult {
     inputContent?: string;
     model?: string;
     autoApprove?: string;
+    /** Explicit dynamic control values returned by the provider */
+    controlValues?: Record<string, string | number | boolean>;
+    /** Provider-driven UI effects derived from chat state */
+    effects?: ProviderEffect[];
 }
 import type { ChatMessage } from '../types.js';
 export type { ChatMessage };
@@ -33,6 +37,38 @@ export interface ModalInfo {
     width?: number;
     height?: number;
 }
+export interface ProviderEffectMessage {
+    role?: 'system' | 'assistant' | 'user';
+    content: string | ContentBlock[];
+    kind?: string;
+    senderName?: string;
+}
+export interface ProviderEffectToast {
+    level?: 'info' | 'success' | 'warning';
+    message: string;
+}
+export type ProviderNotificationPreferenceKey = 'disconnect' | 'completion' | 'approval' | 'browser';
+export type ProviderNotificationChannel = 'bubble' | 'toast' | 'browser';
+export interface ProviderEffectNotification {
+    title?: string;
+    body: string;
+    level?: 'info' | 'success' | 'warning';
+    channels?: ProviderNotificationChannel[];
+    preferenceKey?: ProviderNotificationPreferenceKey;
+    bubbleContent?: string | ContentBlock[];
+}
+export interface ProviderEffect {
+    type: 'message' | 'toast' | 'notification';
+    /** Stable dedup key; falls back to a content hash when omitted */
+    id?: string;
+    /** Default immediate. turn_completed fires only on generating/waiting -> idle transitions. */
+    when?: 'immediate' | 'turn_completed';
+    /** Default true. False keeps the effect UI-only. */
+    persist?: boolean;
+    message?: ProviderEffectMessage;
+    toast?: ProviderEffectToast;
+    notification?: ProviderEffectNotification;
+}
 /**
  * ContentBlock — ACP ContentBlock union type
  * Represents displayable content in messages, tool call results, etc.
@@ -229,6 +265,28 @@ export interface ProviderModule {
         linux?: string[];
         [key: string]: string | string[] | undefined;
     };
+    /**
+     * IDE launch preferences.
+     * Lets each provider choose how its GUI app should be started per platform.
+     */
+    launch?: {
+        /**
+         * Preferred launch method by platform.
+         * - 'cli': use the IDE CLI wrapper/binary
+         * - 'app': use platform app launcher (e.g. `open -a` on macOS)
+         * - 'auto': let core choose a sensible default
+         */
+        prefer?: {
+            darwin?: 'auto' | 'cli' | 'app';
+            win32?: 'auto' | 'cli' | 'app';
+            linux?: 'auto' | 'cli' | 'app';
+            [key: string]: 'auto' | 'cli' | 'app' | undefined;
+        };
+        /**
+         * Override how long core waits for CDP to come up after launch.
+         */
+        cdpStartupTimeoutMs?: number;
+    };
     /** Per-OS install paths — used by detector.ts to detect IDE installation */
     paths?: {
         darwin?: string[];
@@ -465,7 +523,7 @@ export interface ProviderSettingSchema extends ProviderSettingDef {
  * - 'slider'  — numeric range (temperature: 0–2)
  * - 'action'  — one-shot button (show usage, restart, clear context)
  */
-export type ProviderControlType = 'select' | 'toggle' | 'cycle' | 'slider' | 'action';
+export type ProviderControlType = 'select' | 'toggle' | 'cycle' | 'slider' | 'action' | 'display';
 /**
  * Where the control appears in the chat UI:
  * - 'bar'    — thin strip below/above the chat input (always visible)

package/dist/providers/control-effects.d.ts

@@ -0,0 +1,4 @@
+import type { ProviderControlDef, ProviderEffect } from './contracts.js';
+export type ProviderControlValue = string | number | boolean;
+export declare function extractProviderControlValues(controls: ProviderControlDef[] | undefined, data: any): Record<string, ProviderControlValue> | undefined;
+export declare function normalizeProviderEffects(data: any): ProviderEffect[];

package/dist/providers/extension-provider-instance.d.ts

@@ -20,9 +20,12 @@ export declare class ExtensionProviderInstance implements ProviderInstance {
     private currentModel;
     private currentMode;
     private controlValues;
+    private appliedEffectKeys;
+    private runtimeMessages;
     private lastAgentStatus;
     private generatingStartedAt;
     private monitor;
+    private historyWriter;
     private instanceId;
     private ideType;
     private chatId;
@@ -35,10 +38,16 @@ export declare class ExtensionProviderInstance implements ProviderInstance {
     getState(): ProviderState;
     onEvent(event: string, data?: any): void;
     dispose(): void;
+    updateSettings(newSettings: Record<string, any>): void;
     /** Query UUID instanceId */
     getInstanceId(): string;
     private detectTransition;
     private pushEvent;
+    private applyProviderResponse;
+    private appendRuntimeSystemMessage;
+    private mergeConversationMessages;
+    private getPersistedEffectContent;
+    private getEffectDedupKey;
     private flushEvents;
     private resolveChatTitle;
     private resetStreamState;

package/dist/providers/ide-provider-instance.d.ts

@@ -27,6 +27,8 @@ export declare class IdeProviderInstance implements ProviderInstance {
     private monitor;
     private historyWriter;
     private autoApproveBusy;
+    private appliedEffectKeys;
+    private runtimeMessages;
     private ideVersion;
     private instanceId;
     private workspace;
@@ -37,6 +39,7 @@ export declare class IdeProviderInstance implements ProviderInstance {
     getState(): ProviderState;
     onEvent(event: string, data?: any): void;
     dispose(): void;
+    updateSettings(newSettings: Record<string, any>): void;
     /** Extension Instance add */
     addExtension(provider: ProviderModule, settings?: Record<string, any>): Promise<void>;
     /** Extension Instance remove */
@@ -55,6 +58,11 @@ export declare class IdeProviderInstance implements ProviderInstance {
     private getReadChatScript;
     private detectAgentTransitions;
     private pushEvent;
+    private applyProviderResponse;
+    private appendRuntimeSystemMessage;
+    private mergeConversationMessages;
+    private getPersistedEffectContent;
+    private getEffectDedupKey;
     private flushEvents;
     updateCdp(cdp: InstanceContext['cdp']): void;
     private autoApproveViaScript;

package/dist/shared-types.d.ts

@@ -106,7 +106,7 @@ export interface AcpMode {
 /** Provider control schema transmitted to frontend */
 export interface ProviderControlSchema {
     id: string;
-    type: 'select' | 'toggle' | 'cycle' | 'slider' | 'action';
+    type: 'select' | 'toggle' | 'cycle' | 'slider' | 'action' | 'display';
     label: string;
     icon?: string;
     placement: 'bar' | 'header' | 'menu';
@@ -202,6 +202,7 @@ export interface StatusReportPayload {
     workspaces?: WorkspaceEntry[];
     defaultWorkspaceId?: string | null;
     defaultWorkspacePath?: string | null;
+    terminalSizingMode?: 'measured' | 'fit';
     recentLaunches?: RecentLaunchEntry[];
     terminalBackend?: TerminalBackendStatus;
     /** Available providers (present in StatusSnapshot, optional in raw payload) */

package/node_modules/@adhdev/session-host-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/session-host-core",
-  "version": "0.8.22",
+  "version": "0.8.24",
   "description": "ADHDev local session host core — session registry, protocol, buffers",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/daemon-core",
-  "version": "0.8.22",
+  "version": "0.8.24",
   "description": "ADHDev daemon core — CDP, IDE detection, providers, command execution",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -57,7 +57,8 @@
     "@types/node": "^22.0.0",
     "@types/ws": "^8.18.1",
     "tsup": "^8.2.0",
-    "typescript": "^5.5.0"
+    "typescript": "^5.5.0",
+    "vitest": "^4.1.3"
   },
   "repository": {
     "type": "git",

package/src/agent-stream/forward.ts

@@ -32,6 +32,8 @@ export function forwardAgentStreamsToIdeInstance(
             activeModal: stream.activeModal || null,
             model: stream.model || undefined,
             mode: stream.mode || undefined,
+            controlValues: stream.controlValues || undefined,
+            effects: stream.effects || undefined,
             sessionId: stream.sessionId || stream.instanceId || undefined,
             title: stream.title || stream.agentName || undefined,
             agentType: stream.agentType || undefined,

package/src/agent-stream/provider-adapter.ts

@@ -12,6 +12,7 @@ import type {
     AgentEvaluateFn,
 } from './types.js';
 import type { ProviderModule } from '../providers/contracts.js';
+import { extractProviderControlValues, normalizeProviderEffects } from '../providers/control-effects.js';
 
 export class ProviderStreamAdapter implements IAgentStreamAdapter {
     readonly agentType: string;
@@ -86,21 +87,10 @@ export class ProviderStreamAdapter implements IAgentStreamAdapter {
                 mode: data.mode,
                 activeModal: data.activeModal,
             };
-            // Build controlValues from provider controls schema
-            if (this.provider.controls?.length) {
-                const cv: Record<string, string | number | boolean> = {};
-                for (const ctrl of this.provider.controls) {
-                    if (!ctrl.readFrom) continue; // action type — no value
-                    const val = data[ctrl.readFrom];
-                    if (val !== undefined && val !== null) {
-                        cv[ctrl.id] = typeof val === 'object' ? (val.name || val.id || String(val)) : val;
-                    }
-                }
-                // Also include model/mode as fallback controls
-                if (data.model && !cv['model']) cv['model'] = data.model;
-                if (data.mode && !cv['mode']) cv['mode'] = data.mode;
-                if (Object.keys(cv).length > 0) state.controlValues = cv;
-            }
+            const controlValues = extractProviderControlValues(this.provider.controls, data);
+            if (controlValues) state.controlValues = controlValues;
+            const effects = normalizeProviderEffects(data);
+            if (effects.length > 0) state.effects = effects;
             if (state.messages.length > 0) {
                 this.lastSuccessState = state;
             }

package/src/agent-stream/types.ts

@@ -5,6 +5,8 @@
  * No vscode dependency — can be used as-is.
  */
 
+import type { ProviderEffect } from '../providers/contracts.js';
+
 /** Agent chat message */
 export interface AgentChatMessage {
     role: 'user' | 'assistant' | 'system';
@@ -36,6 +38,8 @@ export interface AgentStreamState {
     activeModal?: { message: string; buttons: string[] };
     /** Dynamic control current values (populated from readChat + provider controls schema) */
     controlValues?: Record<string, string | number | boolean>;
+    /** Provider-driven UI effects from readChat */
+    effects?: ProviderEffect[];
 }
 
 /** Agent webview target info */

package/src/cli-adapter-types.ts

@@ -11,6 +11,8 @@ export interface CliAdapter {
     spawn(): Promise<void>;
     sendMessage(text: string): Promise<void>;
     getStatus(): any;
+    getScriptParsedStatus?(): any;
+    invokeScript?(scriptName: string, args?: any): Promise<any>;
     getPartialResponse(): string;
     saveAndStop?(): Promise<void>;
     shutdown(): void;
@@ -19,6 +21,7 @@ export interface CliAdapter {
     isProcessing(): boolean;
     isReady(): boolean;
     setOnStatusChange(callback: () => void): void;
+    updateRuntimeSettings?(settings: Record<string, any>): void;
     setServerConn?(serverConn: any): void;
  // Raw PTY I/O (for terminal view)
     setOnPtyData?(callback: (data: string) => void): void;