comisai 1.0.36 → 1.0.37

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

@@ -7,9 +7,7 @@ import { z } from "zod";
  * file (or even empty object) produces a valid AppConfig.
  */
 export declare const AppConfigSchema: z.ZodObject<{
-    /** Tenant identifier for SaaS multi-tenancy */
     tenantId: z.ZodDefault<z.ZodString>;
-    /** Global log level */
     logLevel: z.ZodDefault<z.ZodEnum<{
         error: "error";
         trace: "trace";
@@ -18,11 +16,8 @@ export declare const AppConfigSchema: z.ZodObject<{
         warn: "warn";
         fatal: "fatal";
     }>>;
-    /** Base data directory for all persistent storage (default: ~/.comis) */
     dataDir: z.ZodDefault<z.ZodString>;
-    /** SDK agent directory for persistent settings (default: ~/.pi/agent) */
     agentDir: z.ZodDefault<z.ZodString>;
-    /** Multi-agent configuration map (agent ID -> per-agent config with optional skills) */
     agents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         name: z.ZodDefault<z.ZodString>;
         model: z.ZodDefault<z.ZodString>;
@@ -510,7 +505,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         }, z.core.$strict>>;
         oauthProfiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strict>>>;
-    /** Channel adapter configuration */
     channels: z.ZodDefault<z.ZodObject<{
         telegram: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1082,7 +1076,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             restartCooldownMs: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    /** Memory system configuration */
     memory: z.ZodDefault<z.ZodObject<{
         dbPath: z.ZodDefault<z.ZodString>;
         walMode: z.ZodDefault<z.ZodBoolean>;
@@ -1098,7 +1091,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             maxEntries: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    /** Security configuration */
     security: z.ZodDefault<z.ZodObject<{
         logRedaction: z.ZodDefault<z.ZodBoolean>;
         auditLog: z.ZodDefault<z.ZodBoolean>;
@@ -1168,7 +1160,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             dbPath: z.ZodDefault<z.ZodString>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    /** Multi-agent routing configuration */
     routing: z.ZodDefault<z.ZodObject<{
         defaultAgentId: z.ZodDefault<z.ZodString>;
         bindings: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -1179,7 +1170,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             agentId: z.ZodString;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
-    /** Daemon process configuration */
     daemon: z.ZodDefault<z.ZodObject<{
         watchdogIntervalMs: z.ZodDefault<z.ZodNumber>;
         shutdownTimeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -1218,7 +1208,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             }, z.core.$strict>]>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    /** Scheduler / proactive automation configuration */
     scheduler: z.ZodDefault<z.ZodObject<{
         cron: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1258,7 +1247,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             storeDir: z.ZodDefault<z.ZodString>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    /** Gateway HTTPS server configuration */
     gateway: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         host: z.ZodDefault<z.ZodString>;
@@ -1301,7 +1289,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             windowMs: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    /** External integrations configuration */
     integrations: z.ZodDefault<z.ZodObject<{
         braveSearch: z.ZodDefault<z.ZodObject<{
             apiKey: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
@@ -1477,7 +1464,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             }, z.core.$strict>>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    /** System monitoring configuration */
     monitoring: z.ZodDefault<z.ZodObject<{
         disk: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1503,7 +1489,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             checkRemote: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    /** Observability persistence configuration */
     observability: z.ZodDefault<z.ZodObject<{
         persistence: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -1511,14 +1496,12 @@ export declare const AppConfigSchema: z.ZodObject<{
             snapshotIntervalMs: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    /** OAuth credential storage configuration (storage backend selector) */
     oauth: z.ZodDefault<z.ZodObject<{
         storage: z.ZodDefault<z.ZodEnum<{
             file: "file";
             encrypted: "encrypted";
         }>>;
     }, z.core.$strict>>;
-    /** Plugin system configuration */
     plugins: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         plugins: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -1527,7 +1510,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
-    /** Command queue configuration for session serialization and concurrency control */
     queue: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         maxConcurrentSessions: z.ZodDefault<z.ZodNumber>;
@@ -1593,7 +1575,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         }, z.core.$strict>>;
         priorityEnabled: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
-    /** Block streaming and typing indicator configuration */
     streaming: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         defaultChunkMode: z.ZodDefault<z.ZodEnum<{
@@ -1707,7 +1688,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             }>>>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
-    /** Auto-reply engine: controls whether the agent activates for inbound messages */
     autoReplyEngine: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         groupActivation: z.ZodDefault<z.ZodEnum<{
@@ -1720,7 +1700,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         maxHistoryInjections: z.ZodDefault<z.ZodNumber>;
         maxGroupHistoryMessages: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Send policy: rules-based outbound message gating */
     sendPolicy: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         defaultAction: z.ZodDefault<z.ZodEnum<{
@@ -1738,7 +1717,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
-    /** Embedding provider configuration (local GGUF, OpenAI, auto-selection) */
     embedding: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         provider: z.ZodDefault<z.ZodEnum<{
@@ -1775,7 +1753,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         }, z.core.$strict>>;
         autoReindex: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
-    /** Message envelope: enriches inbound messages with provider, timestamp, and elapsed time for LLM context */
     envelope: z.ZodDefault<z.ZodObject<{
         timezoneMode: z.ZodDefault<z.ZodString>;
         timeFormat: z.ZodDefault<z.ZodEnum<{
@@ -1786,7 +1763,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         showProvider: z.ZodDefault<z.ZodBoolean>;
         elapsedMaxMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Browser automation configuration (CDP, headless Chrome) */
     browser: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         chromePath: z.ZodOptional<z.ZodString>;
@@ -1808,7 +1784,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         downloadsDir: z.ZodOptional<z.ZodString>;
         downloadTimeoutMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Model catalog and alias configuration */
     models: z.ZodDefault<z.ZodObject<{
         scanOnStartup: z.ZodDefault<z.ZodBoolean>;
         scanTimeoutMs: z.ZodDefault<z.ZodNumber>;
@@ -1820,7 +1795,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         defaultModel: z.ZodDefault<z.ZodString>;
         defaultProvider: z.ZodDefault<z.ZodString>;
     }, z.core.$strict>>;
-    /** LLM provider configuration (API keys via SecretManager, endpoints, retries) */
     providers: z.ZodDefault<z.ZodObject<{
         entries: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
             type: z.ZodString;
@@ -1877,7 +1851,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             }, z.core.$strict>>>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
-    /** Messaging UX configuration (splitting, typing indicators, receipts) */
     messages: z.ZodDefault<z.ZodObject<{
         maxOutboundLength: z.ZodDefault<z.ZodNumber>;
         splitLongMessages: z.ZodDefault<z.ZodBoolean>;
@@ -1888,7 +1861,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         readReceipts: z.ZodDefault<z.ZodBoolean>;
         maxSendsPerExecution: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Action approval workflow configuration (rules-based gating) */
     approvals: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         defaultMode: z.ZodDefault<z.ZodEnum<{
@@ -1915,7 +1887,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         denialCacheTtlMs: z.ZodDefault<z.ZodNumber>;
         batchApprovalTtlMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Webhook subsystem configuration (path-based routing, HMAC auth, mappings) */
     webhooks: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         path: z.ZodDefault<z.ZodString>;
@@ -1956,7 +1927,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             timeoutSeconds: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
-    /** Lifecycle status reactions for agent processing phases */
     lifecycleReactions: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         emojiTier: z.ZodDefault<z.ZodEnum<{
@@ -1980,7 +1950,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             }>>;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
-    /** Response prefix/suffix template injected into agent replies */
     responsePrefix: z.ZodDefault<z.ZodObject<{
         template: z.ZodDefault<z.ZodString>;
         position: z.ZodDefault<z.ZodEnum<{
@@ -1988,7 +1957,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             append: "append";
         }>>;
     }, z.core.$strict>>;
-    /** Crash-safe outbound delivery queue configuration */
     deliveryQueue: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         maxQueueDepth: z.ZodDefault<z.ZodNumber>;
@@ -1999,7 +1967,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         drainIntervalMs: z.ZodDefault<z.ZodNumber>;
         pruneIntervalMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Session mirroring persistence configuration */
     deliveryMirror: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         retentionMs: z.ZodDefault<z.ZodNumber>;
@@ -2007,7 +1974,13 @@ export declare const AppConfigSchema: z.ZodObject<{
         maxEntriesPerInjection: z.ZodDefault<z.ZodNumber>;
         maxCharsPerInjection: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Inter-block delivery timing and pacing configuration */
+    outputRetention: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        intervalMs: z.ZodDefault<z.ZodNumber>;
+        classes: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+            retentionMs: z.ZodNumber;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
     deliveryTiming: z.ZodDefault<z.ZodObject<{
         mode: z.ZodDefault<z.ZodEnum<{
             custom: "custom";
@@ -2020,7 +1993,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         jitterMs: z.ZodDefault<z.ZodNumber>;
         firstBlockDelayMs: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strict>>;
-    /** Block coalescer: accumulates small streaming blocks before delivery */
     coalescer: z.ZodDefault<z.ZodObject<{
         minChars: z.ZodDefault<z.ZodNumber>;
         maxChars: z.ZodDefault<z.ZodNumber>;
@@ -2031,7 +2003,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         }>>;
         adaptiveIdle: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strict>>;
-    /** Sender trust display: controls how sender identity is surfaced to the LLM */
     senderTrustDisplay: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         displayMode: z.ZodDefault<z.ZodEnum<{
@@ -2043,7 +2014,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         hashSecretRef: z.ZodDefault<z.ZodString>;
         aliases: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, z.core.$strict>>;
-    /** Documentation links injected into system prompt */
     documentation: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         localDocsPath: z.ZodDefault<z.ZodString>;
@@ -2057,11 +2027,44 @@ export declare const AppConfigSchema: z.ZodObject<{
             url: z.ZodString;
         }, z.core.$strict>>>;
     }, z.core.$strict>>;
-    /** Telegram file reference guard: detects hallucinated file paths in responses */
     telegramFileRefGuard: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         additionalExtensions: z.ZodDefault<z.ZodArray<z.ZodString>>;
         excludedExtensions: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
+    tooling: z.ZodDefault<z.ZodObject<{
+        capabilityClusters: z.ZodDefault<z.ZodObject<{
+            clusters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+                label: z.ZodString;
+                priority: z.ZodDefault<z.ZodNumber>;
+                preferOverInstalls: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strict>>>;
+            builtinAssignments: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>>;
+        mcp: z.ZodDefault<z.ZodObject<{
+            capabilityHints: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+                cluster: z.ZodString;
+                description: z.ZodString;
+                replacesPackages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        skills: z.ZodDefault<z.ZodObject<{
+            capabilityHints: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+                cluster: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                replacesPackages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        capabilityIndex: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        installDetours: z.ZodDefault<z.ZodObject<{
+            mode: z.ZodDefault<z.ZodEnum<{
+                observe: "observe";
+                advise: "advise";
+                "soft-stop": "soft-stop";
+            }>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
 export type AppConfig = z.infer<typeof AppConfigSchema>;

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

@@ -8,6 +8,7 @@ import { ChannelConfigSchema } from "./schema-channel.js";
 import { CoalescerConfigSchema } from "./schema-coalescer.js";
 import { DaemonConfigSchema } from "./schema-daemon.js";
 import { DeliveryMirrorConfigSchema, DeliveryQueueConfigSchema, DeliveryTimingConfigSchema } from "./schema-delivery.js";
+import { OutputRetentionConfigSchema } from "./schema-output-retention.js";
 import { DocumentationConfigSchema } from "./schema-documentation.js";
 import { EmbeddingConfigSchema } from "./schema-embedding.js";
 import { EnvelopeConfigSchema } from "./schema-envelope.js";
@@ -30,6 +31,7 @@ import { SenderTrustDisplayConfigSchema } from "./schema-sender-trust-display.js
 import { SendPolicyConfigSchema } from "./schema-send-policy.js";
 import { StreamingConfigSchema } from "./schema-streaming.js";
 import { TelegramFileRefGuardConfigSchema } from "./schema-telegram-file-guard.js";
+import { ToolingConfigSchema } from "./schema-tooling.js";
 import { WebhooksConfigSchema } from "./schema-webhooks.js";
 /**
  * Root application configuration schema.
@@ -105,6 +107,8 @@ export const AppConfigSchema = z.strictObject({
     deliveryQueue: DeliveryQueueConfigSchema.default(() => DeliveryQueueConfigSchema.parse({})),
     /** Session mirroring persistence configuration */
     deliveryMirror: DeliveryMirrorConfigSchema.default(() => DeliveryMirrorConfigSchema.parse({})),
+    /** Output retention housekeeper configuration (per-class retentionMs). */
+    outputRetention: OutputRetentionConfigSchema.default(() => OutputRetentionConfigSchema.parse({})),
     /** Inter-block delivery timing and pacing configuration */
     deliveryTiming: DeliveryTimingConfigSchema.default(() => DeliveryTimingConfigSchema.parse({})),
     /** Block coalescer: accumulates small streaming blocks before delivery */
@@ -115,6 +119,8 @@ export const AppConfigSchema = z.strictObject({
     documentation: DocumentationConfigSchema.default(() => DocumentationConfigSchema.parse({})),
     /** Telegram file reference guard: detects hallucinated file paths in responses */
     telegramFileRefGuard: TelegramFileRefGuardConfigSchema.default(() => TelegramFileRefGuardConfigSchema.parse({})),
+    /** Tool-first capability layer (v1.1) -- capability clusters, MCP/skill hints, install-detour mode. Operator-only. */
+    tooling: ToolingConfigSchema.default(() => ToolingConfigSchema.parse({})),
 }).superRefine((config, ctx) => {
     // Startup invariant: reject the reserved "default" provider name.
     // "default" collides with PerAgentConfigSchema.provider's schema default

package/node_modules/@comis/core/dist/context/context.d.ts

@@ -36,11 +36,8 @@ export declare const RequestContextSchema: z.ZodObject<{
         user: "user";
         guest: "guest";
     }>>;
-    /** Per-session random delimiter for external content wrapping */
     contentDelimiter: z.ZodOptional<z.ZodString>;
-    /** Channel type for the originating request (e.g. "telegram", "discord"). Flows through AsyncLocalStorage for downstream delivery routing. */
     channelType: z.ZodOptional<z.ZodString>;
-    /** Immutable origin context for delivery routing. Captured at channel adapter entry point. */
     deliveryOrigin: z.ZodOptional<z.ZodObject<{
         channelType: z.ZodString;
         channelId: z.ZodString;
@@ -48,7 +45,6 @@ export declare const RequestContextSchema: z.ZodObject<{
         threadId: z.ZodOptional<z.ZodString>;
         tenantId: z.ZodDefault<z.ZodString>;
     }, z.core.$strict>>;
-    /** Resolved model string ("provider:modelId") set by parent executor for sub-agent inheritance via ALS. */
     resolvedModel: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type RequestContext = z.infer<typeof RequestContextSchema>;

package/node_modules/@comis/core/dist/domain/approval-request.d.ts

@@ -17,27 +17,18 @@ import { z } from "zod";
  * informed approve/deny decision.
  */
 export declare const ApprovalRequestSchema: z.ZodObject<{
-    /** Unique identifier for this approval request */
     requestId: z.ZodString;
-    /** Name of the tool being invoked */
     toolName: z.ZodString;
-    /** The classified action (e.g., "agents.delete") */
     action: z.ZodString;
-    /** Tool parameters (sanitized, no secrets) */
     params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    /** The agent that triggered the action */
     agentId: z.ZodString;
-    /** Session context identifier */
     sessionKey: z.ZodString;
-    /** Trust level of the requesting user */
     trustLevel: z.ZodEnum<{
         admin: "admin";
         user: "user";
         guest: "guest";
     }>;
-    /** Timestamp when the request was created (epoch ms) */
     createdAt: z.ZodNumber;
-    /** How long before auto-deny (ms) */
     timeoutMs: z.ZodNumber;
 }, z.core.$strict>;
 /** An approval request awaiting operator decision. */
@@ -48,15 +39,10 @@ export type ApprovalRequest = z.infer<typeof ApprovalRequestSchema>;
  * Created when an operator approves/denies or the request times out.
  */
 export declare const ApprovalResolutionSchema: z.ZodObject<{
-    /** The request being resolved */
     requestId: z.ZodString;
-    /** Whether the action was approved */
     approved: z.ZodBoolean;
-    /** Who approved/denied (operator ID or "system:timeout") */
     approvedBy: z.ZodString;
-    /** Optional reason for the decision */
     reason: z.ZodOptional<z.ZodString>;
-    /** Timestamp when the resolution was made (epoch ms) */
     resolvedAt: z.ZodNumber;
 }, z.core.$strict>;
 /** The resolution outcome of an approval request. */
@@ -81,9 +67,7 @@ export declare const SerializedApprovalRequestSchema: z.ZodObject<{
 export type SerializedApprovalRequest = z.infer<typeof SerializedApprovalRequestSchema>;
 /** Schema for a serialized approval cache entry (for restart persistence of cached approvals). */
 export declare const SerializedApprovalCacheEntrySchema: z.ZodObject<{
-    /** The cache key: "${sessionKey}::${action}" */
     cacheKey: z.ZodString;
-    /** The cached approval resolution */
     resolution: z.ZodObject<{
         requestId: z.ZodString;
         approved: z.ZodBoolean;
@@ -91,7 +75,6 @@ export declare const SerializedApprovalCacheEntrySchema: z.ZodObject<{
         reason: z.ZodOptional<z.ZodString>;
         resolvedAt: z.ZodNumber;
     }, z.core.$strict>;
-    /** Absolute expiry timestamp (epoch ms) */
     expiresAt: z.ZodNumber;
 }, z.core.$strict>;
 /** A serialized approval cache entry for persistence across restarts. */

package/node_modules/@comis/core/dist/domain/background-task-origin.d.ts

@@ -19,21 +19,11 @@ import { z } from "zod";
  * correct session.
  */
 export declare const BackgroundTaskOriginSchema: z.ZodObject<{
-    /** The agent that owned the tool call. */
     agentId: z.ZodString;
-    /** Formatted session key string (parseFormattedSessionKey-compatible). */
     sessionKey: z.ZodString;
-    /** Channel type the originating message arrived on (e.g., "telegram"). */
     channelType: z.ZodString;
-    /** Channel-specific identifier for the originating user/group. */
     channelId: z.ZodString;
-    /** Per-execution trace identifier; null when no trace was active. */
     traceId: z.ZodNullable<z.ZodString>;
-    /** Recursion-bound counter. Captured at promote-time from the inbound
-     *  NormalizedMessage's metadata.backgroundHopCount (defaults to 0 for
-     *  top-level user messages). The completion runner increments this
-     *  when constructing the outgoing synthetic message, and falls back to
-     *  fallbackNotifyFn when (incomingHopCount + 1) >= maxBackgroundHops. */
     backgroundHopCount: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strict>;
 export type BackgroundTaskOrigin = z.infer<typeof BackgroundTaskOriginSchema>;

package/node_modules/@comis/core/dist/domain/delivery-origin.d.ts

@@ -11,15 +11,10 @@ import { z } from "zod";
  * to guarantee immutability after creation.
  */
 export declare const DeliveryOriginSchema: z.ZodObject<{
-    /** Platform identifier (e.g., "telegram", "discord", "gateway") */
     channelType: z.ZodString;
-    /** Channel or chat identifier within the platform */
     channelId: z.ZodString;
-    /** Originating user identifier */
     userId: z.ZodString;
-    /** Thread within the channel (platform-specific, e.g., Discord thread, Telegram topic) */
     threadId: z.ZodOptional<z.ZodString>;
-    /** Multi-tenant isolation key */
     tenantId: z.ZodDefault<z.ZodString>;
 }, z.core.$strict>;
 export type DeliveryOrigin = Readonly<z.infer<typeof DeliveryOriginSchema>>;

package/node_modules/@comis/core/dist/domain/execution-graph.d.ts

@@ -52,38 +52,26 @@ export type NodeTypeId = z.infer<typeof NodeTypeIdSchema>;
  * `dependsOn` array.
  */
 export declare const GraphNodeSchema: z.ZodObject<{
-    /** Unique identifier within the graph */
     nodeId: z.ZodString;
-    /** Task description for the sub-agent */
     task: z.ZodString;
-    /** Which agent executes this node (defaults to caller's agent) */
     agentId: z.ZodOptional<z.ZodString>;
-    /** Model override for this node */
     model: z.ZodOptional<z.ZodString>;
-    /** Node IDs that must complete before this node can run */
     dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    /** Per-node timeout in milliseconds. When omitted, typed nodes use driver.defaultTimeoutMs; regular nodes rely on maxSteps / graph-level timeout. */
     timeoutMs: z.ZodOptional<z.ZodNumber>;
-    /** Maximum agentic steps for the sub-agent */
     maxSteps: z.ZodOptional<z.ZodNumber>;
-    /** Barrier mode for fan-in nodes: all (default), majority (>50%), best-effort (any completed) */
     barrierMode: z.ZodDefault<z.ZodEnum<{
         all: "all";
         majority: "majority";
         "best-effort": "best-effort";
     }>>;
-    /** Number of automatic retries on failure (0-3, default 1) */
     retries: z.ZodDefault<z.ZodNumber>;
-    /** Context verbosity mode: full (default), summary (500 chars + shared dir ref), refs (file path refs), none (skip upstream outputs) */
     contextMode: z.ZodDefault<z.ZodEnum<{
         full: "full";
         none: "none";
         summary: "summary";
         refs: "refs";
     }>>;
-    /** MCP server names whose tools should be pre-discovered for this node's sub-agent. Resolves against the graph tool superset at spawn time. */
     mcpServers: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    /** Node type identifier -- if set, this node uses a built-in driver instead of direct agent execution */
     typeId: z.ZodOptional<z.ZodEnum<{
         agent: "agent";
         debate: "debate";
@@ -93,7 +81,6 @@ export declare const GraphNodeSchema: z.ZodObject<{
         "approval-gate": "approval-gate";
         "map-reduce": "map-reduce";
     }>>;
-    /** Type-specific configuration -- validated against the driver's configSchema at the RPC layer */
     typeConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>;
 export type GraphNode = z.infer<typeof GraphNodeSchema>;
@@ -104,9 +91,7 @@ export type GraphNode = z.infer<typeof GraphNodeSchema>;
  * and timing information for observability.
  */
 export declare const NodeExecutionStateSchema: z.ZodObject<{
-    /** Node identifier (matches GraphNode.nodeId) */
     nodeId: z.ZodString;
-    /** Current lifecycle status */
     status: z.ZodEnum<{
         completed: "completed";
         failed: "failed";
@@ -115,31 +100,18 @@ export declare const NodeExecutionStateSchema: z.ZodObject<{
         running: "running";
         skipped: "skipped";
     }>;
-    /** Sub-agent run ID, set when running */
     runId: z.ZodOptional<z.ZodString>;
-    /** Result text, set when completed */
     output: z.ZodOptional<z.ZodString>;
-    /** Error text, set when failed */
     error: z.ZodOptional<z.ZodString>;
-    /** Epoch ms when execution started */
     startedAt: z.ZodOptional<z.ZodNumber>;
-    /** Epoch ms when execution finished */
     completedAt: z.ZodOptional<z.ZodNumber>;
-    /** Current retry attempt number (0 = first run, 1 = first retry, etc.) */
     retryAttempt: z.ZodOptional<z.ZodNumber>;
-    /** Number of retries still available */
     retriesRemaining: z.ZodOptional<z.ZodNumber>;
-    /** Formatted sessionKey of the most recent aborted attempt. Passed as
-     *  reuseSessionKey on the next retry spawn so the sub-agent can benefit
-     *  from any cache written by the aborted run and avoid sending an entirely
-     *  cold prompt. Cleared when the node reaches a terminal state. */
     priorSessionKey: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type NodeExecutionState = z.infer<typeof NodeExecutionStateSchema>;
 export declare const GraphBudgetSchema: z.ZodObject<{
-    /** Maximum total tokens across all nodes */
     maxTokens: z.ZodOptional<z.ZodNumber>;
-    /** Maximum total cost across all nodes */
     maxCost: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export type GraphBudget = z.infer<typeof GraphBudgetSchema>;
@@ -151,40 +123,27 @@ export type GraphBudget = z.infer<typeof GraphBudgetSchema>;
  * must be acyclic.
  */
 export declare const ExecutionGraphSchema: z.ZodObject<{
-    /** DAG nodes (1..20) */
     nodes: z.ZodArray<z.ZodObject<{
-        /** Unique identifier within the graph */
         nodeId: z.ZodString;
-        /** Task description for the sub-agent */
         task: z.ZodString;
-        /** Which agent executes this node (defaults to caller's agent) */
         agentId: z.ZodOptional<z.ZodString>;
-        /** Model override for this node */
         model: z.ZodOptional<z.ZodString>;
-        /** Node IDs that must complete before this node can run */
         dependsOn: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        /** Per-node timeout in milliseconds. When omitted, typed nodes use driver.defaultTimeoutMs; regular nodes rely on maxSteps / graph-level timeout. */
         timeoutMs: z.ZodOptional<z.ZodNumber>;
-        /** Maximum agentic steps for the sub-agent */
         maxSteps: z.ZodOptional<z.ZodNumber>;
-        /** Barrier mode for fan-in nodes: all (default), majority (>50%), best-effort (any completed) */
         barrierMode: z.ZodDefault<z.ZodEnum<{
             all: "all";
             majority: "majority";
             "best-effort": "best-effort";
         }>>;
-        /** Number of automatic retries on failure (0-3, default 1) */
         retries: z.ZodDefault<z.ZodNumber>;
-        /** Context verbosity mode: full (default), summary (500 chars + shared dir ref), refs (file path refs), none (skip upstream outputs) */
         contextMode: z.ZodDefault<z.ZodEnum<{
             full: "full";
             none: "none";
             summary: "summary";
             refs: "refs";
         }>>;
-        /** MCP server names whose tools should be pre-discovered for this node's sub-agent. Resolves against the graph tool superset at spawn time. */
         mcpServers: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        /** Node type identifier -- if set, this node uses a built-in driver instead of direct agent execution */
         typeId: z.ZodOptional<z.ZodEnum<{
             agent: "agent";
             debate: "debate";
@@ -194,23 +153,16 @@ export declare const ExecutionGraphSchema: z.ZodObject<{
             "approval-gate": "approval-gate";
             "map-reduce": "map-reduce";
         }>>;
-        /** Type-specific configuration -- validated against the driver's configSchema at the RPC layer */
         typeConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strict>>;
-    /** Human-readable graph label */
     label: z.ZodOptional<z.ZodString>;
-    /** Failure strategy: fail-fast stops on first failure, continue runs remaining */
     onFailure: z.ZodDefault<z.ZodEnum<{
         continue: "continue";
         "fail-fast": "fail-fast";
     }>>;
-    /** Graph-level timeout in milliseconds (default: 1 500 000 — 25 minutes) */
     timeoutMs: z.ZodDefault<z.ZodNumber>;
-    /** Resource limits for the graph execution */
     budget: z.ZodOptional<z.ZodObject<{
-        /** Maximum total tokens across all nodes */
         maxTokens: z.ZodOptional<z.ZodNumber>;
-        /** Maximum total cost across all nodes */
         maxCost: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>>;
 }, z.core.$strict>;

package/node_modules/@comis/core/dist/domain/memory-entry.d.ts

@@ -32,7 +32,6 @@ export declare const MemorySourceSchema: z.ZodObject<{
 export declare const MemoryEntrySchema: z.ZodObject<{
     id: z.ZodGUID;
     tenantId: z.ZodDefault<z.ZodString>;
-    /** Agent that created this memory entry (enables per-agent memory isolation) */
     agentId: z.ZodDefault<z.ZodString>;
     userId: z.ZodString;
     content: z.ZodString;
@@ -51,13 +50,11 @@ export declare const MemoryEntrySchema: z.ZodObject<{
     createdAt: z.ZodNumber;
     updatedAt: z.ZodOptional<z.ZodNumber>;
     expiresAt: z.ZodOptional<z.ZodNumber>;
-    /** Taint level indicating content sanitization status */
     taintLevel: z.ZodOptional<z.ZodEnum<{
         clean: "clean";
         wrapped: "wrapped";
         raw: "raw";
     }>>;
-    /** Type of source that produced this entry */
     sourceType: z.ZodOptional<z.ZodEnum<{
         system: "system";
         unknown: "unknown";