comisai 1.0.34 → 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>;
@@ -497,6 +492,7 @@ export declare const AppConfigSchema: z.ZodObject<{
             maxTotal: z.ZodDefault<z.ZodNumber>;
             maxBackgroundDurationMs: z.ZodDefault<z.ZodNumber>;
             excludeTools: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            maxBackgroundHops: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
         memoryReview: z.ZodOptional<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -507,8 +503,8 @@ export declare const AppConfigSchema: z.ZodObject<{
             dedupThreshold: z.ZodDefault<z.ZodNumber>;
             autoTags: z.ZodDefault<z.ZodArray<z.ZodString>>;
         }, 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>;
@@ -1080,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>;
@@ -1096,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>;
@@ -1166,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<{
@@ -1177,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>;
@@ -1216,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>;
@@ -1256,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>;
@@ -1299,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<{
@@ -1475,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>;
@@ -1501,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>;
@@ -1509,7 +1496,12 @@ export declare const AppConfigSchema: z.ZodObject<{
             snapshotIntervalMs: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strict>>;
     }, z.core.$strict>>;
-    /** Plugin system configuration */
+    oauth: z.ZodDefault<z.ZodObject<{
+        storage: z.ZodDefault<z.ZodEnum<{
+            file: "file";
+            encrypted: "encrypted";
+        }>>;
+    }, z.core.$strict>>;
     plugins: z.ZodDefault<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         plugins: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -1518,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>;
@@ -1584,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<{
@@ -1698,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<{
@@ -1711,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<{
@@ -1729,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<{
@@ -1766,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<{
@@ -1777,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>;
@@ -1799,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>;
@@ -1811,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;
@@ -1868,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>;
@@ -1879,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<{
@@ -1906,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>;
@@ -1947,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<{
@@ -1971,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<{
@@ -1979,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>;
@@ -1987,9 +1964,9 @@ export declare const AppConfigSchema: z.ZodObject<{
         defaultExpireMs: z.ZodDefault<z.ZodNumber>;
         drainOnStartup: z.ZodDefault<z.ZodBoolean>;
         drainBudgetMs: z.ZodDefault<z.ZodNumber>;
+        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>;
@@ -1997,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";
@@ -2010,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>;
@@ -2021,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<{
@@ -2033,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>;
@@ -2047,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";
@@ -19,6 +20,7 @@ import { MessagesConfigSchema } from "./schema-messages.js";
 import { ModelsConfigSchema } from "./schema-models.js";
 import { MonitoringConfigSchema } from "./schema-observability.js";
 import { ObservabilityConfigSchema } from "./schema-observability.js";
+import { OAuthConfigSchema } from "./schema-oauth.js";
 import { PluginsConfigSchema } from "./schema-plugins.js";
 import { ProvidersConfigSchema } from "./schema-providers.js";
 import { QueueConfigSchema } from "./schema-queue.js";
@@ -29,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.
@@ -68,6 +71,8 @@ export const AppConfigSchema = z.strictObject({
     monitoring: MonitoringConfigSchema.default(() => MonitoringConfigSchema.parse({})),
     /** Observability persistence configuration */
     observability: ObservabilityConfigSchema.default(() => ObservabilityConfigSchema.parse({})),
+    /** OAuth credential storage configuration (storage backend selector) */
+    oauth: OAuthConfigSchema.default(() => OAuthConfigSchema.parse({})),
     /** Plugin system configuration */
     plugins: PluginsConfigSchema.default(() => PluginsConfigSchema.parse({})),
     /** Command queue configuration for session serialization and concurrency control */
@@ -102,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 */
@@ -112,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

@@ -0,0 +1,29 @@
+/**
+ * Background task origin: captures the originating session attribution
+ * (agent + session + channel + trace + hop count) at the moment a tool
+ * execution is promoted to a background task. Persisted on the task so
+ * completion can route a re-entry announcement back to the right session
+ * even after a daemon restart.
+ *
+ * Lives in @comis/core (not @comis/agent) so the event-bus payload type
+ * in core/src/event-bus/events-infra.ts can carry it without violating
+ * the inward-only dependency direction (AGENTS.md §1).
+ *
+ * @module
+ */
+import { z } from "zod";
+/**
+ * Origin context captured at promote() time. All string fields are
+ * non-empty so the runner can reconstruct a valid SessionKey via
+ * parseFormattedSessionKey() and dispatch executor.execute() to the
+ * correct session.
+ */
+export declare const BackgroundTaskOriginSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    sessionKey: z.ZodString;
+    channelType: z.ZodString;
+    channelId: z.ZodString;
+    traceId: z.ZodNullable<z.ZodString>;
+    backgroundHopCount: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+export type BackgroundTaskOrigin = z.infer<typeof BackgroundTaskOriginSchema>;

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

@@ -0,0 +1,39 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Background task origin: captures the originating session attribution
+ * (agent + session + channel + trace + hop count) at the moment a tool
+ * execution is promoted to a background task. Persisted on the task so
+ * completion can route a re-entry announcement back to the right session
+ * even after a daemon restart.
+ *
+ * Lives in @comis/core (not @comis/agent) so the event-bus payload type
+ * in core/src/event-bus/events-infra.ts can carry it without violating
+ * the inward-only dependency direction (AGENTS.md §1).
+ *
+ * @module
+ */
+import { z } from "zod";
+/**
+ * Origin context captured at promote() time. All string fields are
+ * non-empty so the runner can reconstruct a valid SessionKey via
+ * parseFormattedSessionKey() and dispatch executor.execute() to the
+ * correct session.
+ */
+export const BackgroundTaskOriginSchema = z.strictObject({
+    /** The agent that owned the tool call. */
+    agentId: z.string().min(1),
+    /** Formatted session key string (parseFormattedSessionKey-compatible). */
+    sessionKey: z.string().min(1),
+    /** Channel type the originating message arrived on (e.g., "telegram"). */
+    channelType: z.string().min(1),
+    /** Channel-specific identifier for the originating user/group. */
+    channelId: z.string().min(1),
+    /** Per-execution trace identifier; null when no trace was active. */
+    traceId: z.string().nullable(),
+    /** 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.number().int().nonnegative().default(0),
+});

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>>;