comisai 1.0.36 → 1.0.37

package/node_modules/@comis/core/dist/domain/model-compat.d.ts

@@ -43,19 +43,15 @@ export type ToolCallArgumentsEncoding = z.infer<typeof ToolCallArgumentsEncoding
  * Strict object: unknown fields are rejected to catch typos early.
  */
 export declare const ModelCompatConfigSchema: z.ZodObject<{
-    /** Whether this model supports tool use. Undefined = assume yes. */
     supportsTools: z.ZodOptional<z.ZodBoolean>;
-    /** Tool schema transformation profile. Undefined = "default". */
     toolSchemaProfile: z.ZodOptional<z.ZodEnum<{
         default: "default";
         xai: "xai";
     }>>;
-    /** How the model encodes tool call arguments. Undefined = "json". */
     toolCallArgumentsEncoding: z.ZodOptional<z.ZodEnum<{
         json: "json";
         "html-entities": "html-entities";
     }>>;
-    /** Whether the model has a native web search tool (e.g., Perplexity). Undefined = false. */
     nativeWebSearchTool: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type ModelCompatConfig = z.infer<typeof ModelCompatConfigSchema>;

package/node_modules/@comis/core/dist/domain/normalized-message.d.ts

@@ -4,9 +4,7 @@ import { z } from "zod";
  * Voice-specific metadata for voice notes and audio messages.
  */
 export declare const VoiceMetaSchema: z.ZodObject<{
-    /** Base64-encoded waveform amplitude data (256 samples, 0-255) */
     waveform: z.ZodOptional<z.ZodString>;
-    /** Audio codec name (e.g., "opus", "vorbis", "aac") */
     codec: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type VoiceMeta = z.infer<typeof VoiceMetaSchema>;
@@ -25,18 +23,12 @@ export declare const AttachmentSchema: z.ZodObject<{
     mimeType: z.ZodOptional<z.ZodString>;
     fileName: z.ZodOptional<z.ZodString>;
     sizeBytes: z.ZodOptional<z.ZodNumber>;
-    /** Audio/video duration in milliseconds */
     durationMs: z.ZodOptional<z.ZodNumber>;
-    /** Whether this is a voice note (not regular audio) */
     isVoiceNote: z.ZodOptional<z.ZodBoolean>;
-    /** Voice-specific metadata (waveform, codec) */
     voiceMeta: z.ZodOptional<z.ZodObject<{
-        /** Base64-encoded waveform amplitude data (256 samples, 0-255) */
         waveform: z.ZodOptional<z.ZodString>;
-        /** Audio codec name (e.g., "opus", "vorbis", "aac") */
         codec: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
-    /** Transcription text (filled by STT pipeline) */
     transcription: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type Attachment = z.infer<typeof AttachmentSchema>;
@@ -66,22 +58,15 @@ export declare const NormalizedMessageSchema: z.ZodObject<{
         mimeType: z.ZodOptional<z.ZodString>;
         fileName: z.ZodOptional<z.ZodString>;
         sizeBytes: z.ZodOptional<z.ZodNumber>;
-        /** Audio/video duration in milliseconds */
         durationMs: z.ZodOptional<z.ZodNumber>;
-        /** Whether this is a voice note (not regular audio) */
         isVoiceNote: z.ZodOptional<z.ZodBoolean>;
-        /** Voice-specific metadata (waveform, codec) */
         voiceMeta: z.ZodOptional<z.ZodObject<{
-            /** Base64-encoded waveform amplitude data (256 samples, 0-255) */
             waveform: z.ZodOptional<z.ZodString>;
-            /** Audio codec name (e.g., "opus", "vorbis", "aac") */
             codec: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>;
-        /** Transcription text (filled by STT pipeline) */
         transcription: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>>;
     replyTo: z.ZodOptional<z.ZodGUID>;
-    /** Normalized chat type derived from platform metadata. */
     chatType: z.ZodOptional<z.ZodEnum<{
         channel: "channel";
         dm: "dm";

package/node_modules/@comis/core/dist/domain/provider-capabilities.d.ts

@@ -47,23 +47,17 @@ export type TranscriptToolCallIdMode = z.infer<typeof TranscriptToolCallIdModeSc
  * Strict object: unknown fields are rejected.
  */
 export declare const ProviderCapabilitiesSchema: z.ZodObject<{
-    /** Provider family for SDK dispatch. Default: "default". */
     providerFamily: z.ZodDefault<z.ZodEnum<{
         default: "default";
         openai: "openai";
         anthropic: "anthropic";
         google: "google";
     }>>;
-    /** Model name substrings that should have thinking blocks dropped from context.
-     *  Empty array = no special handling. */
     dropThinkingBlockModelHints: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    /** How tool_call_id values are formatted in transcripts. Default: "default". */
     transcriptToolCallIdMode: z.ZodDefault<z.ZodEnum<{
         default: "default";
         strict9: "strict9";
     }>>;
-    /** Model name substrings that should use strict9 tool_call_id mode.
-     *  Empty array = no special handling. */
     transcriptToolCallIdModelHints: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 export type ProviderCapabilities = z.infer<typeof ProviderCapabilitiesSchema>;

package/node_modules/@comis/core/dist/domain/rich-message.d.ts

@@ -11,13 +11,9 @@
 import type { Result } from "@comis/shared";
 import { z } from "zod";
 export declare const RichButtonSchema: z.ZodObject<{
-    /** Button label text */
     text: z.ZodString;
-    /** Callback identifier for interactive buttons (64-byte Telegram limit) */
     callback_data: z.ZodOptional<z.ZodString>;
-    /** URL for link buttons (mutually exclusive with callback_data) */
     url: z.ZodOptional<z.ZodString>;
-    /** Visual style hint for platform rendering */
     style: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
         link: "link";
         primary: "primary";
@@ -32,29 +28,19 @@ export declare const RichCardFieldSchema: z.ZodObject<{
     inline: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export declare const RichCardSchema: z.ZodObject<{
-    /** Card title */
     title: z.ZodOptional<z.ZodString>;
-    /** Card description/body text */
     description: z.ZodOptional<z.ZodString>;
-    /** Image URL for card thumbnail/image */
     image_url: z.ZodOptional<z.ZodString>;
-    /** Color as integer (e.g. 0x0099FF) for embed accent */
     color: z.ZodOptional<z.ZodNumber>;
-    /** Structured key-value fields */
     fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         value: z.ZodString;
         inline: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>>;
-    /** Card-level button rows (for Discord embed + button combos) */
     buttons: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodObject<{
-        /** Button label text */
         text: z.ZodString;
-        /** Callback identifier for interactive buttons (64-byte Telegram limit) */
         callback_data: z.ZodOptional<z.ZodString>;
-        /** URL for link buttons (mutually exclusive with callback_data) */
         url: z.ZodOptional<z.ZodString>;
-        /** Visual style hint for platform rendering */
         style: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
             link: "link";
             primary: "primary";

package/node_modules/@comis/core/dist/domain/subagent-context-config.d.ts

@@ -10,53 +10,31 @@ import { z } from "zod";
  * `config/schema-security.ts`.
  */
 export declare const SubagentContextConfigSchema: z.ZodObject<{
-    /** Maximum spawn depth (parent -> child -> grandchild). 1 = no nesting. */
     maxSpawnDepth: z.ZodDefault<z.ZodNumber>;
-    /** Maximum concurrent active children per parent agent */
     maxChildrenPerAgent: z.ZodDefault<z.ZodNumber>;
-    /** Token threshold: below = passthrough (L1), above = LLM condensation (L2) */
     maxResultTokens: z.ZodDefault<z.ZodNumber>;
-    /** Result file retention in ms (auto-sweep after this) */
     resultRetentionMs: z.ZodDefault<z.ZodNumber>;
-    /** Condensation strategy: "auto" selects level based on token count */
     condensationStrategy: z.ZodDefault<z.ZodEnum<{
         never: "never";
         always: "always";
         auto: "auto";
     }>>;
-    /** Parent history mode: "none" = no parent context, "summary" = LLM summary */
     includeParentHistory: z.ZodDefault<z.ZodEnum<{
         none: "none";
         summary: "summary";
     }>>;
-    /** Inject objective statement that survives compaction */
     objectiveReinforcement: z.ZodDefault<z.ZodBoolean>;
-    /** Pass artifact references to subagent (file paths, not inline content) */
     artifactPassthrough: z.ZodDefault<z.ZodBoolean>;
-    /** Context fill ratio that triggers auto-compaction (0-1) */
     autoCompactThreshold: z.ZodDefault<z.ZodNumber>;
-    /** Preserve error details in condensed results */
     errorPreservation: z.ZodDefault<z.ZodBoolean>;
-    /** Apply narrative casting tags to subagent results */
     narrativeCasting: z.ZodDefault<z.ZodBoolean>;
-    /** Tag prefix for narrative casting of subagent results */
     resultTagPrefix: z.ZodDefault<z.ZodString>;
-    /** Maximum tokens for parent context summary (when includeParentHistory = "summary") */
     parentSummaryMaxTokens: z.ZodDefault<z.ZodNumber>;
-    /** Maximum queued spawns per caller before true backpressure rejection. 0 disables queuing (preserves old throw behavior). */
     maxQueuedPerAgent: z.ZodDefault<z.ZodNumber>;
-    /** How long a queued spawn waits before failing with timeout (ms). */
     queueTimeoutMs: z.ZodDefault<z.ZodNumber>;
-    /** Maximum wall-clock time for a single sub-agent run before watchdog force-fail (ms). */
     maxRunTimeoutMs: z.ZodDefault<z.ZodNumber>;
-    /** Per-step timeout used to compute dynamic watchdog: min(max_steps * perStepTimeoutMs, maxRunTimeoutMs). */
     perStepTimeoutMs: z.ZodDefault<z.ZodNumber>;
-    /** Health-tick stuck kill threshold for graph sub-agents (ms). Graph spawns do multi-step
-     *  analytical work that routinely exceeds the regular threshold. Falls back to
-     *  stuckKillThresholdMs if unset. Set to 0 to disable for graph runs. */
     graphStuckKillThresholdMs: z.ZodDefault<z.ZodNumber>;
-    /** Health-tick stuck kill threshold for regular (non-graph) sub-agents (ms).
-     *  Set to 0 to disable. */
     stuckKillThresholdMs: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export type SubagentContextConfig = z.infer<typeof SubagentContextConfigSchema>;

package/node_modules/@comis/core/dist/domain/subagent-context-types.d.ts

@@ -8,21 +8,13 @@ import { z } from "zod";
  * Validated at runtime because the result is parsed from LLM output.
  */
 export declare const SubagentResultSchema: z.ZodObject<{
-    /** Whether the subagent completed its task successfully */
     taskComplete: z.ZodBoolean;
-    /** Human-readable summary of what was accomplished */
     summary: z.ZodString;
-    /** Key conclusions or findings */
     conclusions: z.ZodArray<z.ZodString>;
-    /** File paths created or modified */
     filePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    /** Next steps the parent should consider */
     actionableItems: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    /** Error descriptions encountered */
     errors: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    /** Arbitrary structured data for parent consumption */
     keyData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    /** Confidence score (0-1) for the conclusions */
     confidence: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export type SubagentResult = z.infer<typeof SubagentResultSchema>;

package/node_modules/@comis/core/dist/event-bus/events-agent.d.ts

@@ -118,6 +118,37 @@ export interface AgentEvents {
         }>;
         timestamp: number;
     };
+    /**
+     * v1.1 capability layer -- install detour detected by exec/process tool.
+     * Emission lives in the skills package; this is the type-only declaration.
+     *
+     * Privacy invariants:
+     * - NO raw command text, shell fragments, URLs, VCS specs, local paths,
+     *   registry credentials, stdout, or stderr.
+     * - `commandDigest` is a stable, non-reversible hash (SHA-256).
+     * - `packages[].normalizedName` is a registry-safe identifier only.
+     */
+    "tool:install_detour_detected": {
+        readonly agentId?: string;
+        readonly sessionKey?: string;
+        readonly traceId?: string;
+        readonly packageManager: "pip" | "npm" | "pnpm" | "yarn";
+        /** Stable, non-reversible hash of normalized command shape. NEVER raw command. */
+        readonly commandDigest: string;
+        readonly packages: ReadonlyArray<{
+            readonly normalizedName: string;
+            readonly ecosystem: "python" | "node";
+        }>;
+        readonly overlaps: ReadonlyArray<{
+            readonly packageName: string;
+            readonly sourceType: "mcp" | "skill";
+            readonly sourceName: string;
+            readonly reason: "direct-server-name" | "mcp-operator-alias" | "skill-comis-alias" | "skill-operator-alias";
+        }>;
+        readonly mode: "observe" | "advise" | "soft-stop";
+        readonly action: "observed" | "hinted" | "soft_stopped" | "override_requested" | "overridden" | "override_denied";
+        readonly timestamp: number;
+    };
     /** Audit log event for compliance and security monitoring */
     "audit:event": {
         timestamp: number;

package/node_modules/@comis/core/dist/event-bus/events-infra.d.ts

@@ -433,6 +433,11 @@ export interface InfraEvents {
         agentId: string;
         sessionKey: string;
         hopCount: number;
+        /** traceId from task.origin for operator log continuity.
+         *  null when no trace was active at promote() time. Carried through so
+         *  subscribers (and operator log lines) preserve the originating trace
+         *  across the background_task:completed → :reentered boundary. */
+        traceId: string | null;
         timestamp: number;
     };
     /** Background task cancelled by user or system */

package/node_modules/@comis/core/dist/exports/config.d.ts

@@ -1,2 +1,2 @@
-export { AppConfigSchema, AgentConfigSchema, AgentsMapSchema, BudgetConfigSchema, CircuitBreakerConfigSchema, DmScopeConfigSchema, ElevatedReplyConfigSchema, ModelRoutesSchema, HeartbeatConfigSchema, HeartbeatTargetSchema, PerAgentConfigSchema, PerAgentCronConfigSchema, PerAgentHeartbeatConfigSchema, PerAgentSchedulerConfigSchema, PruningConfigSchema, RagConfigSchema, ResetPolicyOverrideSchema, RoutingBindingSchema, RoutingConfigSchema, SessionResetPolicySchema, TracingConfigSchema, ChannelConfigSchema, ChannelEntrySchema, ChannelHealthCheckSchema, MemoryConfigSchema, CompactionConfigSchema, RetentionConfigSchema, SecurityConfigSchema, PermissionConfigSchema, ActionConfirmationConfigSchema, AgentToAgentConfigSchema, SkillsConfigSchema, DaemonConfigSchema, LoggingConfigSchema, TracingDefaultsSchema, ConfigWebhookSchema, SchedulerConfigSchema, GatewayConfigSchema, GatewayTlsConfigSchema, GatewayTokenSchema, GatewayRateLimitSchema, IntegrationsConfigSchema, BraveSearchConfigSchema, McpServerEntrySchema, McpConfigSchema, TranscriptionConfigSchema, TtsConfigSchema, TtsAutoModeSchema, ElevenLabsVoiceSettingsSchema, TtsOutputFormatSchema, ImageAnalysisConfigSchema, VisionScopeRuleSchema, VisionConfigSchema, LinkUnderstandingConfigSchema, MediaConfigSchema, DOCUMENT_MIME_WHITELIST, FileExtractionConfigSchema, AutoReplyRuleSchema, AutoReplyConfigSchema, MonitoringConfigSchema, PluginsConfigSchema, PluginEntrySchema, QueueConfigSchema, QueueModeSchema, OverflowPolicySchema, PerChannelQueueConfigSchema, OverflowConfigSchema, DebounceBufferConfigSchema, FollowupConfigSchema, PriorityLaneConfigSchema, LaneAssignmentConfigSchema, StreamingConfigSchema, PerChannelStreamingConfigSchema, TypingModeSchema, ChunkModeSchema, DeliveryMirrorConfigSchema, DeliveryQueueConfigSchema, DeliveryTimingConfigSchema, DeliveryTimingModeSchema, CoalescerConfigSchema, AutoReplyEngineConfigSchema, GroupActivationModeSchema, SendPolicyConfigSchema, SendPolicyRuleSchema, SendActionSchema, EnvelopeConfigSchema, RetryConfigSchema, WebhooksConfigSchema, WebhookMappingConfigSchema, WebhookMappingMatchSchema, AgentSecretsConfigSchema, SecretsConfigSchema, DocumentationConfigSchema, DocumentationLinkSchema, ImageGenerationConfigSchema, NotificationConfigSchema, VerbosityConfigSchema, VerbosityLevelSchema, VerbosityOverrideSchema, ContextEngineConfigSchema, BackgroundTasksConfigSchema, MemoryReviewConfigSchema, ProviderEntrySchema, ProvidersConfigSchema, UserModelSchema, ModelCostSchema, OperationModelEntrySchema, OperationModelsSchema, OAuthConfigSchema, substituteEnvVars, warnSuspiciousEnvValues, findUnresolvedEnvRefs, formatMissingEnvRefError, loadConfigFile, validateConfig, deepMerge, mergeLayered, loadLayered, IMMUTABLE_CONFIG_PREFIXES, MUTABLE_CONFIG_OVERRIDES, isImmutableConfigPath, matchesOverridePattern, getMutableOverridesForSection, MANAGED_SECTIONS, getManagedSectionRedirect, formatRedirectHint, getConfigSchema, getConfigSections, getFieldMetadata, validatePartial, createConfigGitManager, checkApprovalsConfig, } from "../config/index.js";
-export type { AppConfig, AgentConfig, BudgetConfig, CircuitBreakerConfig, DmScopeConfig, ElevatedReplyConfig, ModelRoutes, PruningConfig, HeartbeatConfig, HeartbeatTarget, PerAgentConfig, PerAgentCronConfig, PerAgentHeartbeatConfig, PerAgentSchedulerConfig, RagConfig, ResetPolicyOverride, RoutingBinding, RoutingConfig, SessionResetPolicyConfig, TracingConfig, ChannelConfig, ChannelEntry, ChannelHealthCheckConfig, AckReactionConfig, MemoryConfig, CompactionConfig, RetentionConfig, SecurityConfig, PermissionConfig, ActionConfirmationConfig, AgentToAgentConfig, SkillsConfig, DaemonConfig, LoggingConfig, TracingDefaults, ConfigWebhook, SchedulerConfig, GatewayConfig, GatewayTlsConfig, GatewayToken, GatewayRateLimit, IntegrationsConfig, BraveSearchConfig, McpServerEntry, McpConfig, TranscriptionConfig, TtsConfig, TtsAutoMode, ElevenLabsVoiceSettings, TtsOutputFormat, ImageAnalysisConfig, VisionScopeRule, VisionConfig, LinkUnderstandingConfig, MediaConfig, FileExtractionConfig, AutoReplyRule, AutoReplyConfig, MonitoringConfig, DiskMonitorConfig, ResourceMonitorConfig, SystemdMonitorConfig, SecurityUpdateMonitorConfig, GitMonitorConfig, PluginsConfig, PluginEntry, QueueConfig, PerChannelQueueConfig, QueueMode, OverflowPolicy, OverflowConfig, DebounceBufferConfig, FollowupConfig, PriorityLaneConfig, LaneAssignmentConfig, StreamingConfig, PerChannelStreamingConfig, TypingMode, ChunkMode, DeliveryMirrorConfig, DeliveryQueueConfig, DeliveryTimingConfig, DeliveryTimingMode, CoalescerConfig, AutoReplyEngineConfig, GroupActivationMode, SendPolicyConfig, SendPolicyRule, SendAction, EnvelopeConfig, RetryConfig, WebhooksConfig, WebhookMappingConfig, AgentSecretsConfig, SecretsConfig, ConfigError, ConfigErrorCode, FieldMetadata, PartialValidationResult, ConfigGitManager, GitCommitMetadata, HistoryEntry, GitManagerDeps, ExecGitFn, EnvValueWarning, UnresolvedEnvRef, LifecycleReactionsConfig, LifecycleReactionsTimingConfig, SenderTrustDisplayConfig, DocumentationConfig, DocumentationLink, ImageGenerationConfig, NotificationConfig, VerbosityConfig, VerbosityLevel, VerbosityOverride, ContextEngineConfig, BackgroundTasksConfig, MemoryReviewConfig, ProviderEntry, ProvidersConfig, UserModel, ModelCost, OperationModelEntry, OperationModels, ModelOperationType, OAuthConfig, } from "../config/index.js";
+export { AppConfigSchema, AgentConfigSchema, AgentsMapSchema, BudgetConfigSchema, CircuitBreakerConfigSchema, DmScopeConfigSchema, ElevatedReplyConfigSchema, ModelRoutesSchema, HeartbeatConfigSchema, HeartbeatTargetSchema, PerAgentConfigSchema, PerAgentCronConfigSchema, PerAgentHeartbeatConfigSchema, PerAgentSchedulerConfigSchema, PruningConfigSchema, RagConfigSchema, ResetPolicyOverrideSchema, RoutingBindingSchema, RoutingConfigSchema, SessionResetPolicySchema, TracingConfigSchema, ChannelConfigSchema, ChannelEntrySchema, ChannelHealthCheckSchema, MemoryConfigSchema, CompactionConfigSchema, RetentionConfigSchema, SecurityConfigSchema, PermissionConfigSchema, ActionConfirmationConfigSchema, AgentToAgentConfigSchema, SkillsConfigSchema, DaemonConfigSchema, LoggingConfigSchema, TracingDefaultsSchema, ConfigWebhookSchema, SchedulerConfigSchema, GatewayConfigSchema, GatewayTlsConfigSchema, GatewayTokenSchema, GatewayRateLimitSchema, IntegrationsConfigSchema, BraveSearchConfigSchema, McpServerEntrySchema, McpConfigSchema, TranscriptionConfigSchema, TtsConfigSchema, TtsAutoModeSchema, ElevenLabsVoiceSettingsSchema, TtsOutputFormatSchema, ImageAnalysisConfigSchema, VisionScopeRuleSchema, VisionConfigSchema, LinkUnderstandingConfigSchema, MediaConfigSchema, DOCUMENT_MIME_WHITELIST, FileExtractionConfigSchema, AutoReplyRuleSchema, AutoReplyConfigSchema, MonitoringConfigSchema, PluginsConfigSchema, PluginEntrySchema, QueueConfigSchema, QueueModeSchema, OverflowPolicySchema, PerChannelQueueConfigSchema, OverflowConfigSchema, DebounceBufferConfigSchema, FollowupConfigSchema, PriorityLaneConfigSchema, LaneAssignmentConfigSchema, StreamingConfigSchema, PerChannelStreamingConfigSchema, TypingModeSchema, ChunkModeSchema, DeliveryMirrorConfigSchema, DeliveryQueueConfigSchema, DeliveryTimingConfigSchema, DeliveryTimingModeSchema, CoalescerConfigSchema, AutoReplyEngineConfigSchema, GroupActivationModeSchema, SendPolicyConfigSchema, SendPolicyRuleSchema, SendActionSchema, EnvelopeConfigSchema, RetryConfigSchema, WebhooksConfigSchema, WebhookMappingConfigSchema, WebhookMappingMatchSchema, AgentSecretsConfigSchema, SecretsConfigSchema, DocumentationConfigSchema, DocumentationLinkSchema, ImageGenerationConfigSchema, NotificationConfigSchema, VerbosityConfigSchema, VerbosityLevelSchema, VerbosityOverrideSchema, ContextEngineConfigSchema, BackgroundTasksConfigSchema, OutputRetentionConfigSchema, MemoryReviewConfigSchema, ProviderEntrySchema, ProvidersConfigSchema, UserModelSchema, ModelCostSchema, OperationModelEntrySchema, OperationModelsSchema, OAuthConfigSchema, substituteEnvVars, warnSuspiciousEnvValues, findUnresolvedEnvRefs, formatMissingEnvRefError, loadConfigFile, validateConfig, deepMerge, mergeLayered, loadLayered, IMMUTABLE_CONFIG_PREFIXES, MUTABLE_CONFIG_OVERRIDES, isImmutableConfigPath, matchesOverridePattern, getMutableOverridesForSection, MANAGED_SECTIONS, getManagedSectionRedirect, formatRedirectHint, getConfigSchema, getConfigSections, getFieldMetadata, validatePartial, createConfigGitManager, ToolingConfigSchema, DEFAULT_CLUSTER_CONFIG, DEFAULT_BUILTIN_ASSIGNMENTS, checkApprovalsConfig, } from "../config/index.js";
+export type { AppConfig, AgentConfig, BudgetConfig, CircuitBreakerConfig, DmScopeConfig, ElevatedReplyConfig, ModelRoutes, PruningConfig, HeartbeatConfig, HeartbeatTarget, PerAgentConfig, PerAgentCronConfig, PerAgentHeartbeatConfig, PerAgentSchedulerConfig, RagConfig, ResetPolicyOverride, RoutingBinding, RoutingConfig, SessionResetPolicyConfig, TracingConfig, ChannelConfig, ChannelEntry, ChannelHealthCheckConfig, AckReactionConfig, MemoryConfig, CompactionConfig, RetentionConfig, SecurityConfig, PermissionConfig, ActionConfirmationConfig, AgentToAgentConfig, SkillsConfig, DaemonConfig, LoggingConfig, TracingDefaults, ConfigWebhook, SchedulerConfig, GatewayConfig, GatewayTlsConfig, GatewayToken, GatewayRateLimit, IntegrationsConfig, BraveSearchConfig, McpServerEntry, McpConfig, TranscriptionConfig, TtsConfig, TtsAutoMode, ElevenLabsVoiceSettings, TtsOutputFormat, ImageAnalysisConfig, VisionScopeRule, VisionConfig, LinkUnderstandingConfig, MediaConfig, FileExtractionConfig, AutoReplyRule, AutoReplyConfig, MonitoringConfig, DiskMonitorConfig, ResourceMonitorConfig, SystemdMonitorConfig, SecurityUpdateMonitorConfig, GitMonitorConfig, PluginsConfig, PluginEntry, QueueConfig, PerChannelQueueConfig, QueueMode, OverflowPolicy, OverflowConfig, DebounceBufferConfig, FollowupConfig, PriorityLaneConfig, LaneAssignmentConfig, StreamingConfig, PerChannelStreamingConfig, TypingMode, ChunkMode, DeliveryMirrorConfig, DeliveryQueueConfig, DeliveryTimingConfig, DeliveryTimingMode, CoalescerConfig, AutoReplyEngineConfig, GroupActivationMode, SendPolicyConfig, SendPolicyRule, SendAction, EnvelopeConfig, RetryConfig, WebhooksConfig, WebhookMappingConfig, AgentSecretsConfig, SecretsConfig, ConfigError, ConfigErrorCode, FieldMetadata, PartialValidationResult, ConfigGitManager, GitCommitMetadata, HistoryEntry, GitManagerDeps, ExecGitFn, EnvValueWarning, UnresolvedEnvRef, LifecycleReactionsConfig, LifecycleReactionsTimingConfig, SenderTrustDisplayConfig, DocumentationConfig, DocumentationLink, ImageGenerationConfig, NotificationConfig, VerbosityConfig, VerbosityLevel, VerbosityOverride, ContextEngineConfig, BackgroundTasksConfig, OutputRetentionConfig, RetentionClass, MemoryReviewConfig, ProviderEntry, ProvidersConfig, UserModel, ModelCost, OperationModelEntry, OperationModels, ModelOperationType, ToolingConfig, OAuthConfig, } from "../config/index.js";

package/node_modules/@comis/core/dist/exports/config.js

@@ -1,3 +1,5 @@
 // SPDX-License-Identifier: Apache-2.0
 // @comis/core exports — Config (layered configuration with Zod validation)
-export { AppConfigSchema, AgentConfigSchema, AgentsMapSchema, BudgetConfigSchema, CircuitBreakerConfigSchema, DmScopeConfigSchema, ElevatedReplyConfigSchema, ModelRoutesSchema, HeartbeatConfigSchema, HeartbeatTargetSchema, PerAgentConfigSchema, PerAgentCronConfigSchema, PerAgentHeartbeatConfigSchema, PerAgentSchedulerConfigSchema, PruningConfigSchema, RagConfigSchema, ResetPolicyOverrideSchema, RoutingBindingSchema, RoutingConfigSchema, SessionResetPolicySchema, TracingConfigSchema, ChannelConfigSchema, ChannelEntrySchema, ChannelHealthCheckSchema, MemoryConfigSchema, CompactionConfigSchema, RetentionConfigSchema, SecurityConfigSchema, PermissionConfigSchema, ActionConfirmationConfigSchema, AgentToAgentConfigSchema, SkillsConfigSchema, DaemonConfigSchema, LoggingConfigSchema, TracingDefaultsSchema, ConfigWebhookSchema, SchedulerConfigSchema, GatewayConfigSchema, GatewayTlsConfigSchema, GatewayTokenSchema, GatewayRateLimitSchema, IntegrationsConfigSchema, BraveSearchConfigSchema, McpServerEntrySchema, McpConfigSchema, TranscriptionConfigSchema, TtsConfigSchema, TtsAutoModeSchema, ElevenLabsVoiceSettingsSchema, TtsOutputFormatSchema, ImageAnalysisConfigSchema, VisionScopeRuleSchema, VisionConfigSchema, LinkUnderstandingConfigSchema, MediaConfigSchema, DOCUMENT_MIME_WHITELIST, FileExtractionConfigSchema, AutoReplyRuleSchema, AutoReplyConfigSchema, MonitoringConfigSchema, PluginsConfigSchema, PluginEntrySchema, QueueConfigSchema, QueueModeSchema, OverflowPolicySchema, PerChannelQueueConfigSchema, OverflowConfigSchema, DebounceBufferConfigSchema, FollowupConfigSchema, PriorityLaneConfigSchema, LaneAssignmentConfigSchema, StreamingConfigSchema, PerChannelStreamingConfigSchema, TypingModeSchema, ChunkModeSchema, DeliveryMirrorConfigSchema, DeliveryQueueConfigSchema, DeliveryTimingConfigSchema, DeliveryTimingModeSchema, CoalescerConfigSchema, AutoReplyEngineConfigSchema, GroupActivationModeSchema, SendPolicyConfigSchema, SendPolicyRuleSchema, SendActionSchema, EnvelopeConfigSchema, RetryConfigSchema, WebhooksConfigSchema, WebhookMappingConfigSchema, WebhookMappingMatchSchema, AgentSecretsConfigSchema, SecretsConfigSchema, DocumentationConfigSchema, DocumentationLinkSchema, ImageGenerationConfigSchema, NotificationConfigSchema, VerbosityConfigSchema, VerbosityLevelSchema, VerbosityOverrideSchema, ContextEngineConfigSchema, BackgroundTasksConfigSchema, MemoryReviewConfigSchema, ProviderEntrySchema, ProvidersConfigSchema, UserModelSchema, ModelCostSchema, OperationModelEntrySchema, OperationModelsSchema, OAuthConfigSchema, substituteEnvVars, warnSuspiciousEnvValues, findUnresolvedEnvRefs, formatMissingEnvRefError, loadConfigFile, validateConfig, deepMerge, mergeLayered, loadLayered, IMMUTABLE_CONFIG_PREFIXES, MUTABLE_CONFIG_OVERRIDES, isImmutableConfigPath, matchesOverridePattern, getMutableOverridesForSection, MANAGED_SECTIONS, getManagedSectionRedirect, formatRedirectHint, getConfigSchema, getConfigSections, getFieldMetadata, validatePartial, createConfigGitManager, checkApprovalsConfig, } from "../config/index.js";
+export { AppConfigSchema, AgentConfigSchema, AgentsMapSchema, BudgetConfigSchema, CircuitBreakerConfigSchema, DmScopeConfigSchema, ElevatedReplyConfigSchema, ModelRoutesSchema, HeartbeatConfigSchema, HeartbeatTargetSchema, PerAgentConfigSchema, PerAgentCronConfigSchema, PerAgentHeartbeatConfigSchema, PerAgentSchedulerConfigSchema, PruningConfigSchema, RagConfigSchema, ResetPolicyOverrideSchema, RoutingBindingSchema, RoutingConfigSchema, SessionResetPolicySchema, TracingConfigSchema, ChannelConfigSchema, ChannelEntrySchema, ChannelHealthCheckSchema, MemoryConfigSchema, CompactionConfigSchema, RetentionConfigSchema, SecurityConfigSchema, PermissionConfigSchema, ActionConfirmationConfigSchema, AgentToAgentConfigSchema, SkillsConfigSchema, DaemonConfigSchema, LoggingConfigSchema, TracingDefaultsSchema, ConfigWebhookSchema, SchedulerConfigSchema, GatewayConfigSchema, GatewayTlsConfigSchema, GatewayTokenSchema, GatewayRateLimitSchema, IntegrationsConfigSchema, BraveSearchConfigSchema, McpServerEntrySchema, McpConfigSchema, TranscriptionConfigSchema, TtsConfigSchema, TtsAutoModeSchema, ElevenLabsVoiceSettingsSchema, TtsOutputFormatSchema, ImageAnalysisConfigSchema, VisionScopeRuleSchema, VisionConfigSchema, LinkUnderstandingConfigSchema, MediaConfigSchema, DOCUMENT_MIME_WHITELIST, FileExtractionConfigSchema, AutoReplyRuleSchema, AutoReplyConfigSchema, MonitoringConfigSchema, PluginsConfigSchema, PluginEntrySchema, QueueConfigSchema, QueueModeSchema, OverflowPolicySchema, PerChannelQueueConfigSchema, OverflowConfigSchema, DebounceBufferConfigSchema, FollowupConfigSchema, PriorityLaneConfigSchema, LaneAssignmentConfigSchema, StreamingConfigSchema, PerChannelStreamingConfigSchema, TypingModeSchema, ChunkModeSchema, DeliveryMirrorConfigSchema, DeliveryQueueConfigSchema, DeliveryTimingConfigSchema, DeliveryTimingModeSchema, CoalescerConfigSchema, AutoReplyEngineConfigSchema, GroupActivationModeSchema, SendPolicyConfigSchema, SendPolicyRuleSchema, SendActionSchema, EnvelopeConfigSchema, RetryConfigSchema, WebhooksConfigSchema, WebhookMappingConfigSchema, WebhookMappingMatchSchema, AgentSecretsConfigSchema, SecretsConfigSchema, DocumentationConfigSchema, DocumentationLinkSchema, ImageGenerationConfigSchema, NotificationConfigSchema, VerbosityConfigSchema, VerbosityLevelSchema, VerbosityOverrideSchema, ContextEngineConfigSchema, BackgroundTasksConfigSchema, OutputRetentionConfigSchema, MemoryReviewConfigSchema, ProviderEntrySchema, ProvidersConfigSchema, UserModelSchema, ModelCostSchema, OperationModelEntrySchema, OperationModelsSchema, OAuthConfigSchema, substituteEnvVars, warnSuspiciousEnvValues, findUnresolvedEnvRefs, formatMissingEnvRefError, loadConfigFile, validateConfig, deepMerge, mergeLayered, loadLayered, IMMUTABLE_CONFIG_PREFIXES, MUTABLE_CONFIG_OVERRIDES, isImmutableConfigPath, matchesOverridePattern, getMutableOverridesForSection, MANAGED_SECTIONS, getManagedSectionRedirect, formatRedirectHint, getConfigSchema, getConfigSections, getFieldMetadata, validatePartial, createConfigGitManager, 
+// Tooling subtree (capability layer v1.1)
+ToolingConfigSchema, DEFAULT_CLUSTER_CONFIG, DEFAULT_BUILTIN_ASSIGNMENTS, checkApprovalsConfig, } from "../config/index.js";

package/node_modules/@comis/core/dist/exports/hooks.d.ts

@@ -3,4 +3,4 @@ export type { PluginRegistry, PluginRegistryOptions, HookRunner, HookRunnerOptio
 export { createApprovalGate } from "../approval/index.js";
 export type { ApprovalGate, ApprovalGateDeps } from "../approval/index.js";
 export { registerToolMetadata, getToolMetadata, getAllToolMetadata, truncateContentBlocks, } from "../tool-metadata.js";
-export type { ComisToolMetadata } from "../tool-metadata.js";
+export type { ComisToolMetadata, ToolCapabilityMetadata } from "../tool-metadata.js";

package/node_modules/@comis/core/dist/exports/ports.d.ts

@@ -1,2 +1,2 @@
-export { ChannelCapabilitySchema, createNoOpDeliveryQueue, createNoOpDeliveryMirror, validateProfileId, PROFILE_ID_RE, } from "../ports/index.js";
-export type { ChannelPort, MessageHandler, SendMessageOptions, FetchMessagesOptions, FetchedMessage, AttachmentPayload, ChannelPluginPort, ChannelCapability, ChannelStatus, MemoryPort, MemorySearchOptions, MemorySearchResult, MemoryUpdateFields, SkillPort, SkillPermissions, SkillInput, SkillOutput, SkillManifest, EmbeddingPort, TranscriptionPort, TranscriptionOptions, TranscriptionResult, TTSPort, TTSOptions, TTSResult, ImageAnalysisPort, ImageAnalysisOptions, VisionRequest, VideoRequest, VisionResult, VisionProvider, ResolvedMedia, MediaResolverPort, FileClassification, FileExtractionErrorKind, FileExtractionError, FileExtractionInput, FileExtractionResult, FileExtractionPort, HookName, ModifyingHookName, VoidHookName, HookHandlerMap, HookBeforeAgentStartEvent, HookBeforeAgentStartContext, HookBeforeAgentStartResult, HookAgentEndEvent, HookAgentEndContext, HookBeforeToolCallEvent, HookBeforeToolCallContext, HookBeforeToolCallResult, HookAfterToolCallEvent, HookAfterToolCallContext, HookToolResultPersistEvent, HookToolResultPersistContext, HookToolResultPersistResult, HookBeforeCompactionEvent, HookBeforeCompactionContext, HookBeforeCompactionResult, HookAfterCompactionEvent, HookAfterCompactionContext, HookSessionStartEvent, HookSessionStartContext, HookSessionEndEvent, HookSessionEndContext, HookGatewayStartEvent, HookGatewayStartContext, HookGatewayStopEvent, HookGatewayStopContext, PluginPort, PluginRegistryApi, RegisteredHook, PluginToolDefinition, PluginHttpRoute, DeviceIdentity, DeviceIdentityPort, PairingRequest, PairedDevice, OutputGuardPort, OutputGuardFinding, OutputGuardResult, SecretStorePort, SecretMetadata, CredentialMappingPort, OAuthCredentialStorePort, OAuthProfile, DeliveryQueuePort, DeliveryQueueEntry, DeliveryQueueEnqueueInput, DeliveryQueueStatusCounts, DeliveryMirrorPort, DeliveryMirrorEntry, DeliveryMirrorRecordInput, Provider, ImageGenInput, ImageGenOutput, ImageGenerationPort, } from "../ports/index.js";
+export { ChannelCapabilitySchema, createNoOpDeliveryQueue, createNoOpDeliveryMirror, createNoOpCapabilityPort, validateProfileId, PROFILE_ID_RE, } from "../ports/index.js";
+export type { ChannelPort, MessageHandler, SendMessageOptions, FetchMessagesOptions, FetchedMessage, AttachmentPayload, ChannelPluginPort, ChannelCapability, ChannelStatus, MemoryPort, MemorySearchOptions, MemorySearchResult, MemoryUpdateFields, SkillPort, SkillPermissions, SkillInput, SkillOutput, SkillManifest, EmbeddingPort, TranscriptionPort, TranscriptionOptions, TranscriptionResult, TTSPort, TTSOptions, TTSResult, ImageAnalysisPort, ImageAnalysisOptions, VisionRequest, VideoRequest, VisionResult, VisionProvider, ResolvedMedia, MediaResolverPort, FileClassification, FileExtractionErrorKind, FileExtractionError, FileExtractionInput, FileExtractionResult, FileExtractionPort, HookName, ModifyingHookName, VoidHookName, HookHandlerMap, HookBeforeAgentStartEvent, HookBeforeAgentStartContext, HookBeforeAgentStartResult, HookAgentEndEvent, HookAgentEndContext, HookBeforeToolCallEvent, HookBeforeToolCallContext, HookBeforeToolCallResult, HookAfterToolCallEvent, HookAfterToolCallContext, HookToolResultPersistEvent, HookToolResultPersistContext, HookToolResultPersistResult, HookBeforeCompactionEvent, HookBeforeCompactionContext, HookBeforeCompactionResult, HookAfterCompactionEvent, HookAfterCompactionContext, HookSessionStartEvent, HookSessionStartContext, HookSessionEndEvent, HookSessionEndContext, HookGatewayStartEvent, HookGatewayStartContext, HookGatewayStopEvent, HookGatewayStopContext, PluginPort, PluginRegistryApi, RegisteredHook, PluginToolDefinition, PluginHttpRoute, DeviceIdentity, DeviceIdentityPort, PairingRequest, PairedDevice, OutputGuardPort, OutputGuardFinding, OutputGuardResult, SecretStorePort, SecretMetadata, CredentialMappingPort, OAuthCredentialStorePort, OAuthProfile, DeliveryQueuePort, DeliveryQueueEntry, DeliveryQueueEnqueueInput, DeliveryQueueStatusCounts, DeliveryMirrorPort, DeliveryMirrorEntry, DeliveryMirrorRecordInput, Provider, ImageGenInput, ImageGenOutput, ImageGenerationPort, ToolCapabilityPort, PromptSkillCapability, CapabilitySourceRef, ClusterConfig, McpServerHint, SkillHint, } from "../ports/index.js";

package/node_modules/@comis/core/dist/exports/ports.js

@@ -1,3 +1,3 @@
 // SPDX-License-Identifier: Apache-2.0
 // @comis/core exports — Port interfaces (hexagonal architecture boundaries)
-export { ChannelCapabilitySchema, createNoOpDeliveryQueue, createNoOpDeliveryMirror, validateProfileId, PROFILE_ID_RE, } from "../ports/index.js";
+export { ChannelCapabilitySchema, createNoOpDeliveryQueue, createNoOpDeliveryMirror, createNoOpCapabilityPort, validateProfileId, PROFILE_ID_RE, } from "../ports/index.js";

package/node_modules/@comis/core/dist/ports/channel-plugin.d.ts

@@ -2,7 +2,6 @@ import { z } from "zod";
 import type { PluginPort } from "./plugin.js";
 import type { ChannelPort } from "./channel.js";
 export declare const ChannelCapabilitySchema: z.ZodObject<{
-    /** Chat types this channel supports */
     chatTypes: z.ZodArray<z.ZodEnum<{
         channel: "channel";
         dm: "dm";
@@ -10,7 +9,6 @@ export declare const ChannelCapabilitySchema: z.ZodObject<{
         thread: "thread";
         forum: "forum";
     }>>;
-    /** Feature flags for optional capabilities */
     features: z.ZodDefault<z.ZodObject<{
         reactions: z.ZodDefault<z.ZodBoolean>;
         editMessages: z.ZodDefault<z.ZodBoolean>;
@@ -20,44 +18,33 @@ export declare const ChannelCapabilitySchema: z.ZodObject<{
         threads: z.ZodDefault<z.ZodBoolean>;
         mentions: z.ZodDefault<z.ZodBoolean>;
         formatting: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        /** Whether the channel supports interactive buttons */
         buttons: z.ZodDefault<z.ZodBoolean>;
-        /** Whether the channel supports rich card embeds */
         cards: z.ZodDefault<z.ZodBoolean>;
-        /** Whether the channel supports message delivery effects (spoiler, silent) */
         effects: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
-    /** Platform-specific message and attachment size limits */
     limits: z.ZodObject<{
         maxMessageChars: z.ZodNumber;
         maxAttachmentSizeMb: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>;
-    /** Streaming support configuration */
     streaming: z.ZodDefault<z.ZodObject<{
         supported: z.ZodDefault<z.ZodBoolean>;
         throttleMs: z.ZodDefault<z.ZodNumber>;
         maxChars: z.ZodOptional<z.ZodNumber>;
-        /** Streaming delivery method: "edit" = edit message in-place, "block" = sequential messages, "none" = no streaming */
         method: z.ZodDefault<z.ZodEnum<{
             edit: "edit";
             none: "none";
             block: "block";
         }>>;
     }, z.core.$strict>>;
-    /** Threading capability metadata (extends features.threads with detail) */
     threading: z.ZodDefault<z.ZodObject<{
-        /** Whether threading is supported at all (mirrors features.threads for convenience) */
         supported: z.ZodDefault<z.ZodBoolean>;
-        /** Type of threading: "native" = platform threads (Discord), "reply-chain" = thread_ts reply chains (Slack), "none" = no threading */
         threadType: z.ZodDefault<z.ZodEnum<{
             none: "none";
             native: "native";
             "reply-chain": "reply-chain";
         }>>;
-        /** Maximum thread nesting depth (undefined = unlimited within a thread) */
         maxDepth: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Metadata key used for reply-to references (platform-specific) */
     replyToMetaKey: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 /** Inferred type from ChannelCapabilitySchema */

package/node_modules/@comis/core/dist/ports/index.d.ts

@@ -23,3 +23,5 @@ export type { DeliveryQueuePort, DeliveryQueueEntry, DeliveryQueueEnqueueInput,
 export { createNoOpDeliveryQueue } from "./delivery-queue.js";
 export type { DeliveryMirrorPort, DeliveryMirrorEntry, DeliveryMirrorRecordInput, } from "./delivery-mirror.js";
 export { createNoOpDeliveryMirror } from "./delivery-mirror.js";
+export type { ToolCapabilityPort, PromptSkillCapability, CapabilitySourceRef, ClusterConfig, McpServerHint, SkillHint, } from "./tool-capability.js";
+export { createNoOpCapabilityPort } from "./no-op-tool-capability.js";

package/node_modules/@comis/core/dist/ports/index.js

@@ -4,3 +4,7 @@ export { ChannelCapabilitySchema } from "./channel-plugin.js";
 export { validateProfileId, PROFILE_ID_RE } from "./oauth-credential-store.js";
 export { createNoOpDeliveryQueue } from "./delivery-queue.js";
 export { createNoOpDeliveryMirror } from "./delivery-mirror.js";
+export { createNoOpCapabilityPort } from "./no-op-tool-capability.js";
+// NOTE: the test-only stub factory in `__test-helpers/` is intentionally NOT
+// re-exported here. It must NEVER appear on this barrel (the architecture-grep
+// test enforces this).

package/node_modules/@comis/core/dist/ports/no-op-tool-capability.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Production no-op factory for ToolCapabilityPort.
+ *
+ * Returns an empty-defaults adapter that is safe to inject from any production
+ * code path. Used as the production no-op until the live daemon-side adapter
+ * is wired.
+ *
+ * With the no-op port:
+ * - The capability-index renderer sees no clusters/skills/servers -> returns
+ *   empty text -> executor-prompt-runner.ts filters it out.
+ * - The install-detour parser sees no overlaps -> no events emitted, no hints,
+ *   no soft-stop refusals.
+ * Both subsystems are inert but not broken.
+ *
+ * IMPORTANT -- boundary discipline:
+ * Test code must NOT import this. Tests use the test-only stub factory in
+ * `__test-helpers/` instead. The architecture-grep test in
+ * `packages/<pkg>/src/__tests__/architecture.test.ts` enforces this both ways.
+ *
+ * @module
+ */
+import type { ToolCapabilityPort } from "./tool-capability.js";
+/**
+ * Production no-op factory. Production-OK; safe to import from any production
+ * code path. Tests must NOT import this -- use the test-only stub factory in
+ * `__test-helpers/` instead.
+ *
+ * @returns A frozen ToolCapabilityPort with empty defaults for all 9 methods.
+ */
+export declare function createNoOpCapabilityPort(): ToolCapabilityPort;

package/node_modules/@comis/core/dist/ports/no-op-tool-capability.js

@@ -0,0 +1,47 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Production no-op factory for ToolCapabilityPort.
+ *
+ * Returns an empty-defaults adapter that is safe to inject from any production
+ * code path. Used as the production no-op until the live daemon-side adapter
+ * is wired.
+ *
+ * With the no-op port:
+ * - The capability-index renderer sees no clusters/skills/servers -> returns
+ *   empty text -> executor-prompt-runner.ts filters it out.
+ * - The install-detour parser sees no overlaps -> no events emitted, no hints,
+ *   no soft-stop refusals.
+ * Both subsystems are inert but not broken.
+ *
+ * IMPORTANT -- boundary discipline:
+ * Test code must NOT import this. Tests use the test-only stub factory in
+ * `__test-helpers/` instead. The architecture-grep test in
+ * `packages/<pkg>/src/__tests__/architecture.test.ts` enforces this both ways.
+ *
+ * @module
+ */
+// Module-level constants -- returned by every call so callers can rely on
+// reference-stability for cheap equality checks.
+const EMPTY_ALIAS_MAP = new Map();
+const EMPTY_SERVERS = Object.freeze([]);
+const EMPTY_SKILLS = Object.freeze([]);
+/**
+ * Production no-op factory. Production-OK; safe to import from any production
+ * code path. Tests must NOT import this -- use the test-only stub factory in
+ * `__test-helpers/` instead.
+ *
+ * @returns A frozen ToolCapabilityPort with empty defaults for all 9 methods.
+ */
+export function createNoOpCapabilityPort() {
+    return Object.freeze({
+        isCapabilityIndexEnabled: () => true,
+        getInstallDetourMode: () => "advise",
+        getBuiltinCluster: () => undefined,
+        getClusterConfig: () => undefined,
+        getMcpServerHint: () => undefined,
+        getSkillHint: () => undefined,
+        getPackageAliasMap: () => EMPTY_ALIAS_MAP,
+        getConnectedMcpServers: () => EMPTY_SERVERS,
+        getPromptSkillCapabilities: () => EMPTY_SKILLS,
+    });
+}