@adhdev/daemon-core 0.9.76-rc.60 → 0.9.76-rc.62

package/dist/providers/chat-message-normalization.d.ts

@@ -2,6 +2,31 @@ import type { ChatMessage } from '../types.js';
 export declare const BUILTIN_CHAT_MESSAGE_KINDS: readonly ["standard", "thought", "tool", "terminal", "system"];
 export type BuiltinChatMessageKind = typeof BUILTIN_CHAT_MESSAGE_KINDS[number];
 export type ChatMessageKind = BuiltinChatMessageKind | (string & {});
+export declare const CHAT_MESSAGE_VISIBILITIES: readonly ["user", "debug", "internal", "hidden"];
+export declare const CHAT_MESSAGE_TRANSCRIPT_VISIBILITIES: readonly ["visible", "chat", "user", "debug", "internal", "hidden"];
+export declare const CHAT_MESSAGE_AUDIENCES: readonly ["chat", "debug", "trace", "internal"];
+export declare const CHAT_MESSAGE_SOURCES: readonly ["assistant_text", "tool_call", "terminal_command", "runtime_activity", "runtime_status", "provider_chrome", "control"];
+export declare const CHAT_MESSAGE_ACTIVITY_SOURCES: readonly ["tool_call", "terminal_command", "runtime_activity"];
+export declare const CHAT_MESSAGE_INTERNAL_SOURCES: readonly ["runtime_status", "provider_chrome", "control"];
+export type ChatMessageVisibility = typeof CHAT_MESSAGE_VISIBILITIES[number] | (string & {});
+export type ChatMessageTranscriptVisibility = typeof CHAT_MESSAGE_TRANSCRIPT_VISIBILITIES[number] | (string & {});
+export type ChatMessageAudience = typeof CHAT_MESSAGE_AUDIENCES[number] | (string & {});
+export type ChatMessageSource = typeof CHAT_MESSAGE_SOURCES[number] | (string & {});
+export type ChatMessageTranscriptSurface = 'chat' | 'activity' | 'internal';
+export interface ChatMessageVisibilityClassification {
+    surface: ChatMessageTranscriptSurface;
+    isUserFacing: boolean;
+    isActivityFacing: boolean;
+    isInternal: boolean;
+    explicitUserFacing: boolean;
+    explicitHidden: boolean;
+    role: string;
+    kind: ChatMessageKind;
+    visibility: string;
+    transcriptVisibility: string;
+    audience: string;
+    source: string;
+}
 export declare function isBuiltinChatMessageKind(kind: unknown): kind is BuiltinChatMessageKind;
 export declare function normalizeChatMessageKind(kind: unknown, role: unknown): ChatMessageKind;
 export declare function resolveChatMessageKind<T extends ChatMessage>(message: T): ChatMessageKind;
@@ -64,13 +89,17 @@ export declare function buildUserChatMessage<T extends Omit<ChatMessage, 'role'
 export declare function normalizeChatMessage<T extends ChatMessage>(message: T): T;
 export declare function normalizeChatMessages<T extends ChatMessage>(messages: T[] | null | undefined): T[];
 /**
- * Product chat transcript visibility contract.
+ * Shared transcript visibility protocol for all ADHDev provider chat messages.
  *
- * read_chat/debug paths may preserve every normalized message, including tool,
- * terminal, thought, status, and control rows. The default user-facing chat UX
- * should only render meaningful conversation turns unless a producer explicitly
- * marks a non-standard row as user-facing. This keeps internal tool/status/control
- * plumbing out of the ordinary transcript without matching provider-specific text.
+ * Producers can stamp visibility/audience/source/userFacing/internal/debug either
+ * at the top level or under `meta`. Consumers should use this classifier instead
+ * of matching command text, icons, provider names, or terminal UI fragments.
  */
+export declare function classifyChatMessageVisibility(message: ChatMessage | null | undefined): ChatMessageVisibilityClassification;
 export declare function isUserFacingChatMessage(message: ChatMessage | null | undefined): boolean;
+export declare function isActivityChatMessage(message: ChatMessage | null | undefined): boolean;
+export declare function isInternalChatMessage(message: ChatMessage | null | undefined): boolean;
 export declare function filterUserFacingChatMessages<T extends ChatMessage>(messages: T[] | null | undefined): T[];
+export declare function filterActivityChatMessages<T extends ChatMessage>(messages: T[] | null | undefined): T[];
+export declare function filterInternalChatMessages<T extends ChatMessage>(messages: T[] | null | undefined): T[];
+export declare function filterChatMessagesByVisibility<T extends ChatMessage>(messages: T[] | null | undefined, surface: ChatMessageTranscriptSurface): T[];

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

@@ -4,7 +4,7 @@
  * Lifecycle layer on top of ProviderCliAdapter.
  * collectCliData() + status transition logic from daemon-status.ts moved here.
  */
-import { type ProviderModule } from './contracts.js';
+import { type ProviderModule, type InputEnvelope } from './contracts.js';
 import type { ProviderInstance, ProviderState, InstanceContext, HotChatSessionState, SessionModalState } from './provider-instance.js';
 import { ProviderCliAdapter } from '../cli-adapters/provider-cli-adapter.js';
 import type { PtyTransportFactory } from '../cli-adapters/pty-transport.js';
@@ -16,6 +16,9 @@ type PersistableCliHistoryMessage = {
     senderName?: string;
     receivedAt?: number;
 };
+export declare function buildCliStructuredInputPrompt(input: InputEnvelope, options?: {
+    materializeDir?: string;
+}): string;
 export declare function buildIncrementalHistoryAppendMessages(previousMessages: PersistableCliHistoryMessage[], currentMessages: PersistableCliHistoryMessage[]): PersistableCliHistoryMessage[];
 export declare function getForcedNewSessionScriptName(provider: ProviderModule | undefined, launchMode: 'new' | 'resume' | 'manual'): string | null;
 export declare function waitForCliAdapterReady(adapter: {

package/dist/providers/contracts.d.ts

@@ -87,7 +87,7 @@ export interface ProviderEffect {
  * ContentBlock — ACP ContentBlock union type
  * Represents displayable content in messages, tool call results, etc.
  */
-export type ContentBlock = TextBlock | ImageBlock | AudioBlock | ResourceLinkBlock | ResourceBlock;
+export type ContentBlock = TextBlock | ImageBlock | AudioBlock | VideoBlock | ResourceLinkBlock | ResourceBlock;
 /** Text content — ACP TextContent */
 export interface TextBlock {
     type: 'text';
@@ -100,6 +100,7 @@ export interface ImageBlock {
     data: string;
     mimeType: string;
     uri?: string;
+    alt?: string;
     annotations?: ContentAnnotations;
 }
 /** Audio content — ACP AudioContent */
@@ -107,6 +108,18 @@ export interface AudioBlock {
     type: 'audio';
     data: string;
     mimeType: string;
+    uri?: string;
+    transcript?: string;
+    annotations?: ContentAnnotations;
+}
+/** Video content — ADHDev canonical display block. ACP prompt input degrades video to resource_link/text. */
+export interface VideoBlock {
+    type: 'video';
+    data?: string;
+    mimeType: string;
+    uri?: string;
+    transcript?: string;
+    posterUri?: string;
     annotations?: ContentAnnotations;
 }
 /** Resource link (file reference) — ACP ResourceLink */
@@ -487,6 +500,12 @@ export interface ProviderModule {
         input?: {
             multipart?: boolean;
             mediaTypes?: Array<'text' | 'image' | 'audio' | 'video' | 'resource'>;
+            strategies?: Array<{
+                mediaType: 'text' | 'image' | 'audio' | 'video' | 'resource';
+                strategies?: Array<'native' | 'native_acp' | 'resource_link' | 'text_fallback' | 'paste' | 'upload'>;
+                native?: boolean;
+                degradation?: Array<'native' | 'native_acp' | 'resource_link' | 'text_fallback' | 'paste' | 'upload'>;
+            }>;
         };
         output?: {
             richContent?: boolean;

package/dist/providers/io-contracts.d.ts

@@ -1,5 +1,5 @@
 import type { ContentAnnotations } from './contracts.js';
-export type InputPart = TextInputPart | ImageInputPart | AudioInputPart | VideoInputPart | ResourceInputPart;
+export type InputPart = TextInputPart | ImageInputPart | AudioInputPart | VideoInputPart | ResourceLinkInputPart | ResourceInputPart;
 export interface TextInputPart {
     type: 'text';
     text: string;
@@ -23,6 +23,7 @@ export interface VideoInputPart {
     mimeType: string;
     uri?: string;
     data?: string;
+    transcript?: string;
     posterUri?: string;
 }
 export interface ResourceInputPart {
@@ -33,6 +34,16 @@ export interface ResourceInputPart {
     text?: string;
     data?: string;
 }
+export interface ResourceLinkInputPart {
+    type: 'resource_link';
+    uri: string;
+    name: string;
+    title?: string;
+    description?: string;
+    mimeType?: string;
+    size?: number;
+    annotations?: ContentAnnotations;
+}
 export interface InputEnvelope {
     parts: InputPart[];
     textFallback: string;
@@ -52,6 +63,7 @@ export interface ImageMessagePart {
     mimeType: string;
     uri?: string;
     data?: string;
+    alt?: string;
     annotations?: ContentAnnotations;
 }
 export interface AudioMessagePart {
@@ -67,6 +79,7 @@ export interface VideoMessagePart {
     mimeType: string;
     uri?: string;
     data?: string;
+    transcript?: string;
     posterUri?: string;
     annotations?: ContentAnnotations;
 }
@@ -74,8 +87,11 @@ export interface ResourceLinkMessagePart {
     type: 'resource_link';
     uri: string;
     name: string;
+    title?: string;
+    description?: string;
     mimeType?: string;
     size?: number;
+    annotations?: ContentAnnotations;
 }
 export interface ResourceMessagePart {
     type: 'resource';

package/dist/providers/provider-input-support.d.ts

@@ -1,9 +1,25 @@
 import type { InputEnvelope, ProviderModule } from './contracts.js';
-type InputMediaType = 'text' | 'image' | 'audio' | 'video' | 'resource';
+export type InputMediaType = 'text' | 'image' | 'audio' | 'video' | 'resource';
+export type InputAttachmentStrategy = 'native' | 'native_acp' | 'resource_link' | 'text_fallback' | 'paste' | 'upload';
+export interface InputMediaStrategyDescriptor {
+    mediaType: InputMediaType;
+    strategies: InputAttachmentStrategy[];
+    native?: boolean;
+    degradation?: InputAttachmentStrategy[];
+}
+export interface MessageInputSupport {
+    text: boolean;
+    multipart: boolean;
+    mediaTypes: InputMediaType[];
+    strategies: InputMediaStrategyDescriptor[];
+}
+export declare const TEXT_ONLY_MESSAGE_INPUT_SUPPORT: MessageInputSupport;
 export declare function assertTextOnlyInput(provider: Pick<ProviderModule, 'name' | 'type'> | null | undefined, input: InputEnvelope): void;
 export declare function getDeclaredProviderInputSupport(provider?: Pick<ProviderModule, 'capabilities'> | null): {
     multipart: boolean;
     mediaTypes: Set<InputMediaType>;
+    strategies: InputMediaStrategyDescriptor[];
 };
+export declare function normalizeInputStrategyDescriptors(raw: unknown): InputMediaStrategyDescriptor[];
+export declare function getEffectiveMessageInputSupport(provider?: Pick<ProviderModule, 'category' | 'capabilities'> | null, runtimeCapabilities?: Record<string, any> | null): MessageInputSupport;
 export declare function assertProviderSupportsDeclaredInput(provider: Pick<ProviderModule, 'name' | 'type' | 'capabilities'> | null | undefined, input: InputEnvelope): void;
-export {};

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

@@ -9,6 +9,7 @@
  */
 import type { ProviderModule, ProviderResumeCapability } from './contracts.js';
 import type { AcpConfigOption, AcpMode, ProviderControlSchema, ProviderSummaryMetadata, SessionCapability } from '../shared-types.js';
+import type { MessageInputSupport } from './provider-input-support.js';
 import type { ChatMessage } from '../types.js';
 export type ProviderStatus = 'idle' | 'generating' | 'waiting_approval' | 'error' | 'stopped' | 'starting';
 export interface ProviderRuntimeWriteOwner {
@@ -71,6 +72,7 @@ interface ProviderStateBase {
     runtime?: ProviderRuntimeInfo;
     resume?: ProviderResumeCapability;
     sessionCapabilities?: SessionCapability[];
+    messageInput?: MessageInputSupport;
     /** Dynamic control current values */
     controlValues?: Record<string, string | number | boolean>;
     /** Provider-declared controls schema (from provider.controls) */

package/dist/shared-types.d.ts

@@ -240,7 +240,9 @@ export type SessionTransport = 'cdp-page' | 'cdp-webview' | 'pty' | 'acp';
 export type SessionKind = 'workspace' | 'agent';
 export type SessionCapability = 'read_chat' | 'send_message' | 'new_session' | 'list_sessions' | 'switch_session' | 'resolve_action' | 'open_panel' | 'terminal_io' | 'resize_terminal' | 'change_model' | 'set_mode' | 'set_thought_level' | 'delete_notification' | 'mark_notification_unread';
 import type { RuntimeWriteOwner, RuntimeAttachedClient, SessionStatus } from './shared-types-extra.js';
+import type { MessageInputSupport } from './providers/provider-input-support.js';
 export type { RuntimeWriteOwner, RuntimeAttachedClient, SessionStatus } from './shared-types-extra.js';
+export type { MessageInputSupport, InputMediaStrategyDescriptor, InputAttachmentStrategy, InputMediaType } from './providers/provider-input-support.js';
 export interface SessionEntry {
     id: string;
     parentId: string | null;
@@ -267,6 +269,8 @@ export interface SessionEntry {
     resume?: ProviderResumeCapability;
     activeChat: SessionActiveChatData | null;
     capabilities?: SessionCapability[];
+    /** Effective message input/media support for this session. Defaults fail-closed to text-only. */
+    messageInput?: MessageInputSupport;
     cdpConnected?: boolean;
     /** Dynamic control current values (generic key-value) */
     controlValues?: Record<string, string | number | boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/daemon-core",
-  "version": "0.9.76-rc.60",
+  "version": "0.9.76-rc.62",
   "description": "ADHDev daemon core — CDP, IDE detection, providers, command execution",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/chat/subscription-updates.ts

@@ -8,6 +8,7 @@ import {
   buildSessionModalDeliverySignature,
 } from './chat-signatures.js'
 import { normalizeManagedStatus } from '../status/normalize.js'
+import { filterUserFacingChatMessages, normalizeChatMessages } from '../providers/chat-message-normalization.js'
 
 export interface ChatTailSubscriptionCursor {
   tailLimit: number
@@ -101,7 +102,8 @@ export function prepareSessionChatTailUpdate(
     }
   }
 
-  const messages = Array.isArray(result.messages) ? result.messages : []
+  const fullMessages = normalizeChatMessages(Array.isArray(result.messages) ? result.messages as any[] : [])
+  const messages = filterUserFacingChatMessages(fullMessages)
   const title = typeof result.title === 'string' ? result.title : undefined
   const activeModal = normalizeChatTailActiveModal(result.activeModal)
   const status = typeof result.status === 'string' ? result.status : 'idle'

package/src/commands/chat-commands.ts

@@ -16,7 +16,7 @@ import type { ProviderInstance } from '../providers/provider-instance.js';
 import { readProviderChatHistory } from '../config/chat-history.js';
 import { LOG, getRecentLogs } from '../logging/logger.js';
 import { getRecentDebugTrace, recordDebugTrace } from '../logging/debug-trace.js';
-import { buildChatMessageSignature } from '../chat/chat-signatures.js';
+import { buildChatMessageSignature, hashSignatureParts } from '../chat/chat-signatures.js';
 import type { ChatMessage } from '../types.js';
 import type { SessionTransport } from '../shared-types.js';
 import { filterUserFacingChatMessages, normalizeChatMessages } from '../providers/chat-message-normalization.js';
@@ -93,10 +93,32 @@ function buildRecentSendKey(h: CommandHelpers, args: any, provider: ProviderModu
     return `${transport}:${target}:${signature.trim()}`;
 }
 
-function buildSendInputSignature(input: InputEnvelope): string {
+function summarizeSendInputPart(part: any): string {
+    if (!part || typeof part !== 'object') return String(part ?? '');
+    if (part.type === 'text') return `text:${String(part.text || '').trim()}`;
+    const fields = [
+        `type=${String(part.type || '')}`,
+        `mime=${String(part.mimeType || '')}`,
+        `uri=${String(part.uri || '')}`,
+        `name=${String(part.name || '')}`,
+    ];
+    const data = typeof part.data === 'string'
+        ? part.data
+        : typeof part.resource?.blob === 'string'
+            ? part.resource.blob
+            : '';
+    if (data) fields.push(`dataLen=${data.length}`, `dataHash=${hashSignatureParts([data]).slice(0, 12)}`);
+    const textish = [part.alt, part.transcript, part.description, part.title, part.resource?.uri]
+        .filter((value) => typeof value === 'string' && value.trim())
+        .join('\u001f');
+    if (textish) fields.push(`meta=${hashSignatureParts([textish]).slice(0, 12)}`);
+    return fields.join(';');
+}
+
+export function buildSendInputSignature(input: InputEnvelope): string {
     const text = typeof input.textFallback === 'string' ? input.textFallback.trim() : '';
-    if (text) return text;
-    return JSON.stringify(input.parts || []);
+    const partSummaries = (input.parts || []).map(summarizeSendInputPart);
+    return hashSignatureParts([text, ...partSummaries]);
 }
 
 function getSendChatInputEnvelope(args: any): InputEnvelope {
@@ -1140,12 +1162,25 @@ export async function handleSendChat(h: CommandHelpers, args: any): Promise<Comm
         }
     }
 
-    // PTY transport: text-only send via adapter
+    // PTY transport: route structured input through the provider instance so
+    // provider-specific CLI attachment strategies (for example Hermes file-path
+    // image prompts) are applied instead of collapsing everything to text.
     if (transport === 'pty') {
         const adapter = getTargetedCliAdapter(h, args, provider?.type);
         if (adapter) {
             _log(`${transport} adapter: ${adapter.cliType}`);
             try {
+                const hasStructuredParts = input.parts.some((part) => part.type !== 'text');
+                if (hasStructuredParts) {
+                    const target = getTargetInstance(h, args);
+                    if (!target || target.category !== 'cli') {
+                        return { success: false, error: `CLI instance not found for ${provider?.type || args?.agentType || 'unknown'}` };
+                    }
+                    assertProviderSupportsDeclaredInput(provider, input);
+                    await waitOnceForFreshHermesCliStart(adapter, _log);
+                    target.onEvent('send_message', { input });
+                    return _logSendSuccess(`${transport}-instance`, target.type);
+                }
                 assertTextOnlyInput(provider, input);
                 if (!text) return { success: false, error: 'text required for PTY send' };
                 await waitOnceForFreshHermesCliStart(adapter, _log);

package/src/commands/mesh-coordinator.ts

@@ -1,4 +1,5 @@
 import { execFileSync } from 'node:child_process'
+import { createHash } from 'node:crypto'
 import { existsSync, readdirSync, realpathSync } from 'node:fs'
 import { createRequire } from 'node:module'
 import * as os from 'node:os'
@@ -64,7 +65,7 @@ function resolveHermesMeshCoordinatorSetup(options: ResolveMeshCoordinatorSetupO
       reason: 'Could not resolve the ADHDev MCP server entrypoint and a Node runtime with WebSocket support for daemon IPC mode',
     }
   }
-  const configPath = resolveMcpConfigPath(HERMES_MCP_CONFIG_PATH, options.workspace)
+  const configPath = join(resolveHermesCoordinatorHome(options.meshId, options.workspace), 'config.yaml')
   if (!configPath.trim()) {
     return createHermesManualMeshCoordinatorSetup(options.meshId, options.workspace)
   }
@@ -177,6 +178,12 @@ function renderMeshCoordinatorTemplate(template: string, values: Record<string,
   return template.replace(/\{\{\s*(meshId|workspace|serverName|adhdevMcpCommand)\s*\}\}/g, (_, key: string) => values[key] || '')
 }
 
+function resolveHermesCoordinatorHome(meshId: string, workspace: string): string {
+  const key = `${meshId || 'mesh'}\n${resolve(workspace || os.tmpdir())}`
+  const hash = createHash('sha256').update(key).digest('hex').slice(0, 16)
+  return join(os.tmpdir(), `adhdev-hermes-mesh-coordinator-${hash}`)
+}
+
 function resolveMcpConfigPath(configPath: string, workspace: string): string {
   const trimmed = configPath.trim()
   if (trimmed === '~') return os.homedir()

package/src/commands/router.ts

@@ -1672,6 +1672,10 @@ export class DaemonCommandRouter {
 
                     const cliArgs: string[] = [];
                     const launchEnv: Record<string, string> = {};
+                    if (configFormat === 'hermes_config_yaml') {
+                        launchEnv.HERMES_HOME = dirname(mcpConfigPath);
+                        launchEnv.HERMES_IGNORE_USER_CONFIG = '';
+                    }
                     if (systemPrompt) {
                         if (configFormat === 'hermes_config_yaml') {
                             launchEnv.HERMES_EPHEMERAL_SYSTEM_PROMPT = systemPrompt;

package/src/index.ts

@@ -312,10 +312,22 @@ export {
   buildUserChatMessage,
   normalizeChatMessage,
   normalizeChatMessages,
+  CHAT_MESSAGE_VISIBILITIES,
+  CHAT_MESSAGE_TRANSCRIPT_VISIBILITIES,
+  CHAT_MESSAGE_AUDIENCES,
+  CHAT_MESSAGE_SOURCES,
+  CHAT_MESSAGE_ACTIVITY_SOURCES,
+  CHAT_MESSAGE_INTERNAL_SOURCES,
+  classifyChatMessageVisibility,
   isUserFacingChatMessage,
+  isActivityChatMessage,
+  isInternalChatMessage,
   filterUserFacingChatMessages,
+  filterActivityChatMessages,
+  filterInternalChatMessages,
+  filterChatMessagesByVisibility,
 } from './providers/chat-message-normalization.js';
-export type { BuiltinChatMessageKind, ChatMessageKind } from './providers/chat-message-normalization.js';
+export type { BuiltinChatMessageKind, ChatMessageKind, ChatMessageVisibility, ChatMessageTranscriptVisibility, ChatMessageAudience, ChatMessageSource, ChatMessageTranscriptSurface, ChatMessageVisibilityClassification } from './providers/chat-message-normalization.js';
 export { VersionArchive, detectAllVersions } from './providers/version-archive.js';
 export type { ProviderVersionInfo, VersionHistory } from './providers/version-archive.js';
 

package/src/mesh/coordinator-prompt.ts

@@ -52,6 +52,9 @@ Repository: \`${mesh.repoIdentity}\`${mesh.defaultBranch ? `\nDefault branch: \`
     // ── Tools ──
     sections.push(TOOLS_SECTION);
 
+    // ── Tool Exposure Preflight ──
+    sections.push(TOOL_EXPOSURE_PREFLIGHT_SECTION);
+
     // ── Workflow ──
     sections.push(WORKFLOW_SECTION);
 
@@ -136,6 +139,10 @@ const TOOLS_SECTION = `## Available Tools
 | \`mesh_clone_node\` | Create a worktree node for isolated parallel branch work |
 | \`mesh_remove_node\` | Remove a node (cleans up worktree if applicable) |`;
 
+const TOOL_EXPOSURE_PREFLIGHT_SECTION = `## Tool Exposure Preflight
+
+Before doing any coordinator work, confirm that the actual callable tool list includes \`mesh_status\` and the other \`mesh_*\` tools from the table above. If this Repo Mesh coordinator prompt is present but the callable \`mesh_*\` tools are missing, the MCP server/tool manifest is stale or not injected yet. Do not substitute terminal/file/git tools, do not inspect or edit the repository directly, and do not continue as a non-mesh local coding agent. Stop immediately and tell the user to run \`/reload-mcp\` or start a fresh coordinator session so ADHDev can reconnect \`adhdev-mesh\`.`;
+
 const WORKFLOW_SECTION = `## Orchestration Workflow
 
 1. **Assess** — Call \`mesh_status\` to see which nodes are healthy and available.