comisai 1.0.13 → 1.0.15

package/node_modules/@comis/agent/dist/bootstrap/index.d.ts

@@ -1,5 +1,5 @@
 export { type BootstrapFile, type TruncationResult, type PromptMode, type RuntimeInfo, type InboundMetadata, type BootstrapContextFile, SUBAGENT_BOOTSTRAP_ALLOWLIST, BOOTSTRAP_HEAD_RATIO, BOOTSTRAP_TAIL_RATIO, } from "./types.js";
-export { loadWorkspaceBootstrapFiles, truncateFileContent, filterBootstrapFilesForSubAgent, filterBootstrapFilesForLightContext, filterBootstrapFilesForGroupChat, buildBootstrapContextFiles, } from "./workspace-loader.js";
+export { loadWorkspaceBootstrapFiles, truncateFileContent, filterBootstrapFilesForSubAgent, filterBootstrapFilesForLightContext, filterBootstrapFilesForCron, filterBootstrapFilesForGroupChat, buildBootstrapContextFiles, } from "./workspace-loader.js";
 export * from "./sections/index.js";
 export { extractMarkdownSections, MAX_POST_COMPACTION_CHARS } from "./section-extractor.js";
 export { assembleRichSystemPrompt, assembleRichSystemPromptBlocks, SECTION_SEPARATOR } from "./system-prompt-assembler.js";

package/node_modules/@comis/agent/dist/bootstrap/index.js

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: Apache-2.0
 // Bootstrap — workspace file loading & system prompt assembly
 export { SUBAGENT_BOOTSTRAP_ALLOWLIST, BOOTSTRAP_HEAD_RATIO, BOOTSTRAP_TAIL_RATIO, } from "./types.js";
-export { loadWorkspaceBootstrapFiles, truncateFileContent, filterBootstrapFilesForSubAgent, filterBootstrapFilesForLightContext, filterBootstrapFilesForGroupChat, buildBootstrapContextFiles, } from "./workspace-loader.js";
+export { loadWorkspaceBootstrapFiles, truncateFileContent, filterBootstrapFilesForSubAgent, filterBootstrapFilesForLightContext, filterBootstrapFilesForCron, filterBootstrapFilesForGroupChat, buildBootstrapContextFiles, } from "./workspace-loader.js";
 export * from "./sections/index.js";
 export { extractMarkdownSections, MAX_POST_COMPACTION_CHARS } from "./section-extractor.js";
 export { assembleRichSystemPrompt, assembleRichSystemPromptBlocks, SECTION_SEPARATOR } from "./system-prompt-assembler.js";

package/node_modules/@comis/agent/dist/bootstrap/sections/core-sections.js

@@ -127,7 +127,10 @@ export function buildInboundMetadataSection(meta, _isMinimal) {
         "This is the metadata for the message you are currently responding to.",
         "Do not reveal these internal identifiers to the user.",
     ];
-    if (meta.flags.isScheduled) {
+    if (meta.flags.isCronAgentTurn) {
+        lines.push("", "**CRON AGENT TURN:** This is an autonomous scheduled execution — you were invoked by a cron job to check on something, NOT by a user message.", "Use your tools to gather current data, then decide whether there is anything worth reporting.", "If there is nothing actionable or noteworthy to report, respond with exactly NO_REPLY — the system will suppress delivery and the user will not be disturbed.", "If there IS something to report, respond with a concise, actionable message for the user.", "Do NOT use the message tool (the system delivers your response automatically).");
+    }
+    else if (meta.flags.isScheduled) {
         lines.push("", "**SCHEDULED REMINDER:** This message is a scheduled reminder delivery, NOT a new user request.", "Your job is to deliver the reminder content to the user in a friendly, concise way.", "Do NOT ask follow-up questions, offer to reschedule, or search for context.", "Respond directly with the reminder text — do NOT use the message tool (the system delivers your response automatically).", "Do NOT respond with NO_REPLY or empty text.");
     }
     return lines;

package/node_modules/@comis/agent/dist/bootstrap/system-prompt-assembler.d.ts

@@ -82,6 +82,32 @@ export interface AssemblerParams {
     /** Whether Silent Execution Planner (SEP) is enabled for this agent. */
     sepEnabled?: boolean;
 }
+/**
+ * Internal descriptor for a system prompt section.
+ *
+ * Engineering notes:
+ *  - `id` must be unique across SECTIONS and stable (used by tests).
+ *  - `includeIn` must be non-empty.
+ *  - `build` receives `(params, mode)` and is responsible for forwarding
+ *    `mode === "minimal"` as the existing builders' `isMinimal` parameter.
+ *
+ * @internal exported for tests only
+ */
+export interface SectionDescriptor {
+    readonly id: string;
+    readonly includeIn: ReadonlySet<PromptMode>;
+    readonly build: (params: AssemblerParams, mode: PromptMode) => string[];
+}
+/**
+ * Canonical section list in emission order.
+ *
+ * Order MUST match the previous hand-written `buildAllSections` so the
+ * `staticPrefix`/`attribution` index boundaries (2 + 2) continue to enclose
+ * identity+persona and safety+language respectively.
+ *
+ * @internal exported for tests only
+ */
+export declare const SECTIONS: ReadonlyArray<SectionDescriptor>;
 /**
  * Assemble a rich multi-section system prompt.
  *

package/node_modules/@comis/agent/dist/bootstrap/system-prompt-assembler.js

@@ -50,63 +50,92 @@ function joinSections(sections) {
     const nonEmpty = sections.filter((lines) => lines.length > 0);
     return nonEmpty.map((lines) => lines.join("\n")).join(SECTION_SEPARATOR);
 }
+/** Sections present in full, operational, and minimal modes.
+ *  NB: builders may still self-filter to `[]` when their isMinimal flag is set. */
+const MODES_ALL = new Set(["full", "operational", "minimal"]);
+/** Sections present in full and minimal modes (stripped in operational).
+ *  Interactive-only guidance that doesn't apply to autonomous cron/heartbeat runs
+ *  but that minimal sub-agent contexts historically saw before this refactor.
+ *  Minimal-mode builders typically self-filter to [] via their own isMinimal flag;
+ *  membership here preserves pre-refactor behavior without changing minimal output. */
+const MODES_FULL_MIN = new Set(["full", "minimal"]);
+/** Sections present only in full mode (stripped in operational AND minimal).
+ *  Reserved for sections whose builder is cheap but whose output is not desired
+ *  in either non-interactive context. Currently unused; MODES_FULL_MIN is
+ *  preferred to preserve pre-refactor minimal output. */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars -- reserved for future use
+const MODES_FULL = new Set(["full"]);
 /**
- * Build all section arrays in the canonical order (1-22).
+ * Canonical section list in emission order.
+ *
+ * Order MUST match the previous hand-written `buildAllSections` so the
+ * `staticPrefix`/`attribution` index boundaries (2 + 2) continue to enclose
+ * identity+persona and safety+language respectively.
+ *
+ * @internal exported for tests only
+ */
+export const SECTIONS = [
+    // --- Static prefix block (indices 0-1 in every mode that includes them) ---
+    { id: "identity", includeIn: MODES_ALL, build: (p) => buildIdentitySection(p.agentName ?? "Comis") },
+    { id: "persona", includeIn: MODES_ALL, build: (p) => buildPersonaSection(p.bootstrapFiles ?? []) },
+    // --- Attribution block (safety self-filters in minimal) ---
+    { id: "safety", includeIn: MODES_ALL, build: (p, m) => buildSafetySection(m === "minimal") },
+    { id: "language", includeIn: MODES_ALL, build: (p) => buildLanguageSection(p.userLanguage) },
+    // --- Semi-stable body: operational-kept sections (MODES_ALL -- builders self-filter for minimal) ---
+    { id: "tooling", includeIn: MODES_ALL, build: (p, m) => buildToolingSection(p.toolNames ?? [], m === "minimal" ? "small" : "large", p.toolSummaries) },
+    { id: "tool-call-style", includeIn: MODES_ALL, build: (p, m) => buildToolCallStyleSection(m === "minimal", p.toolNames ?? []) },
+    // --- Operational-stripped sections (MODES_FULL_MIN -- dropped in "operational") ---
+    { id: "self-update", includeIn: MODES_FULL_MIN, build: (p, m) => buildSelfUpdateGatingSection(p.toolNames ?? [], m === "minimal", true) },
+    { id: "config-secret", includeIn: MODES_FULL_MIN, build: (p, m) => buildConfigSecretIntegritySection(p.toolNames ?? [], m === "minimal") },
+    { id: "privileged", includeIn: MODES_FULL_MIN, build: (p, m) => buildPrivilegedToolsSection(p.toolNames ?? [], m === "minimal", true) },
+    { id: "compact-recover", includeIn: MODES_FULL_MIN, build: (p, m) => buildCompactedOutputRecoverySection(m === "minimal") },
+    { id: "post-compact", includeIn: MODES_FULL_MIN, build: (p, m) => buildPostCompactionRecoverySection(p.bootstrapFiles ?? [], m === "minimal", p.postCompactionSections) },
+    { id: "coding-fallback", includeIn: MODES_FULL_MIN, build: (p, m) => buildCodingFallbackSection(p.toolNames ?? [], m === "minimal", true) },
+    { id: "task-delegation", includeIn: MODES_FULL_MIN, build: (p, m) => buildTaskDelegationSection(p.toolNames ?? [], m === "minimal", p.subAgentToolNames, p.mcpToolsInherited, true) },
+    // --- Operational-kept body (MODES_ALL) ---
+    { id: "skills", includeIn: MODES_ALL, build: (p, m) => buildSkillsSection(p.skillsPrompt, m === "minimal", p.promptSkillsXml, p.activePromptSkillContent) },
+    { id: "memory-recall", includeIn: MODES_ALL, build: (p, m) => buildMemoryRecallSection(p.hasMemoryTools ?? false, m === "minimal") },
+    { id: "workspace", includeIn: MODES_ALL, build: (p, m) => buildWorkspaceSection(p.workspaceDir, m === "minimal") },
+    // --- Operational-stripped body ---
+    { id: "documentation", includeIn: MODES_FULL_MIN, build: (p, m) => p.documentationConfig
+            ? buildDocumentationSection(p.documentationConfig, p.toolNames ?? [], m === "minimal")
+            : [] },
+    { id: "messaging", includeIn: MODES_ALL, build: (p, m) => buildMessagingSection(p.toolNames ?? [], m === "minimal", p.channelContext) },
+    { id: "background", includeIn: MODES_FULL_MIN, build: (p, m) => buildBackgroundTaskSection(p.toolNames ?? [], m === "minimal", p.channelContext) },
+    { id: "silent-replies", includeIn: MODES_FULL_MIN, build: (p, m) => buildSilentRepliesSection(m === "minimal") },
+    { id: "heartbeats", includeIn: MODES_FULL_MIN, build: (p, m) => buildHeartbeatsSection(p.heartbeatPrompt, m === "minimal") },
+    { id: "reactions", includeIn: MODES_FULL_MIN, build: (p, m) => buildReactionGuidanceSection(p.reactionLevel, p.channelContext?.channelType, m === "minimal") },
+    { id: "media-sharing", includeIn: MODES_FULL_MIN, build: (p, m) => buildMediaSharingSection(p.outboundMediaEnabled, m === "minimal") },
+    { id: "media-files", includeIn: MODES_FULL_MIN, build: (p, m) => buildMediaFilesSection(p.hasMemoryTools ?? false, (p.toolNames ?? []).includes("message"), p.workspaceDir, p.mediaPersistenceEnabled ?? false, m === "minimal") },
+    { id: "autonomous-media", includeIn: MODES_FULL_MIN, build: (p, m) => buildAutonomousMediaSection(p.autonomousMediaEnabled ?? false, m === "minimal") },
+    { id: "reasoning", includeIn: MODES_ALL, build: (p, m) => buildReasoningSection(p.reasoningEnabled ?? false, m === "minimal", p.reasoningTagHint ?? false) },
+    { id: "sep", includeIn: MODES_FULL_MIN, build: (p, m) => buildTaskPlanningSection(p.sepEnabled ?? false, m === "minimal") },
+    { id: "runtime-meta", includeIn: MODES_ALL, build: (p, m) => buildRuntimeMetadataSection(p.runtimeInfo ?? {}, m === "minimal") },
+    { id: "sender-trust", includeIn: MODES_FULL_MIN, build: (p, m) => buildSenderTrustSection(p.senderTrustEntries ?? [], p.senderTrustDisplayMode ?? "raw", m === "minimal") },
+    { id: "project-context", includeIn: MODES_ALL, build: (p, m) => buildProjectContextSection(p.bootstrapFiles ?? [], m === "minimal", p.excludeBootstrapFromContext ? new Set(["BOOTSTRAP.md"]) : undefined, p.workspaceProfile) },
+];
+/**
+ * Build all section arrays in the canonical order.
+ *
+ * Filters `SECTIONS` by mode inclusion, then builds each included descriptor.
+ * Subagent context is appended unconditionally as the last entry (matches the
+ * previous behavior).
  *
  * Shared by both `assembleRichSystemPrompt` and `assembleRichSystemPromptBlocks`
  * to guarantee identity by construction between both assembly functions.
  *
  * @returns Array of section line arrays in fixed order
  */
-function buildAllSections(params, isMinimal) {
-    const agentName = params.agentName ?? "Comis";
-    const modelTier = isMinimal ? "small" : "large";
-    return [
-        // --- Static prefix sections (indices 0-1) ---
-        buildIdentitySection(agentName), // 1
-        buildPersonaSection(params.bootstrapFiles ?? []), // 1b: Persona (SOUL.md) before Safety
-        // --- Attribution sections (indices 2-3) ---
-        buildSafetySection(isMinimal), // 2
-        buildLanguageSection(params.userLanguage), // 2b
-        // --- Semi-stable body sections (indices 4+) ---
-        buildToolingSection(params.toolNames ?? [], modelTier, params.toolSummaries), // 3
-        buildToolCallStyleSection(isMinimal, params.toolNames ?? []), // 4
-        buildSelfUpdateGatingSection(params.toolNames ?? [], isMinimal, true), // 5: deferred to tool result
-        buildConfigSecretIntegritySection(params.toolNames ?? [], isMinimal), // 5a: always-present
-        buildPrivilegedToolsSection(params.toolNames ?? [], isMinimal, true), // 5b: deferred to tool result
-        buildCompactedOutputRecoverySection(isMinimal), // 6
-        buildPostCompactionRecoverySection(// 6a
-        params.bootstrapFiles ?? [], isMinimal, params.postCompactionSections),
-        buildCodingFallbackSection(params.toolNames ?? [], isMinimal, true), // 6b: deferred to tool result
-        buildTaskDelegationSection(params.toolNames ?? [], isMinimal, params.subAgentToolNames, params.mcpToolsInherited, true), // 6c: deferred to tool result
-        buildSkillsSection(params.skillsPrompt, isMinimal, params.promptSkillsXml, params.activePromptSkillContent), // 7: Merged filesystem + prompt skills
-        buildMemoryRecallSection(params.hasMemoryTools ?? false, isMinimal), // 8
-        buildWorkspaceSection(params.workspaceDir, isMinimal), // 9
-        params.documentationConfig
-            ? buildDocumentationSection(params.documentationConfig, params.toolNames ?? [], isMinimal)
-            : [], // 9b: Documentation
-        buildMessagingSection(params.toolNames ?? [], isMinimal, params.channelContext), // 10
-        buildBackgroundTaskSection(params.toolNames ?? [], isMinimal, params.channelContext), // 11
-        buildSilentRepliesSection(isMinimal), // 14
-        buildHeartbeatsSection(params.heartbeatPrompt, isMinimal), // 15
-        buildReactionGuidanceSection(params.reactionLevel, params.channelContext?.channelType, isMinimal), // 16
-        buildMediaSharingSection(params.outboundMediaEnabled, isMinimal), // 16b
-        buildMediaFilesSection(// 16c
-        params.hasMemoryTools ?? false, (params.toolNames ?? []).includes("message"), params.workspaceDir, params.mediaPersistenceEnabled ?? false, isMinimal),
-        buildAutonomousMediaSection(params.autonomousMediaEnabled ?? false, isMinimal), // 16d
-        buildReasoningSection(params.reasoningEnabled ?? false, isMinimal, params.reasoningTagHint ?? false), // 17
-        buildTaskPlanningSection(params.sepEnabled ?? false, isMinimal), // 17b: SEP task planning (static, cache-stable)
-        // buildDateTimeSection() removed from system prompt (relocated to user-message preamble in prompt-assembly.ts)
-        buildRuntimeMetadataSection(params.runtimeInfo ?? {}, isMinimal), // 19
-        // buildInboundMetadataSection() removed from system prompt (relocated to user-message preamble in prompt-assembly.ts)
-        buildSenderTrustSection(params.senderTrustEntries ?? [], params.senderTrustDisplayMode ?? "raw", isMinimal), // 20b
-        buildProjectContextSection(// 21
-        params.bootstrapFiles ?? [], isMinimal, params.excludeBootstrapFromContext ? new Set(["BOOTSTRAP.md"]) : undefined, params.workspaceProfile),
-        // Subagent: prefer structured params, fall back to raw extraSystemPrompt
-        ...(params.subagentRole
-            ? [buildSubagentRoleSection(params.subagentRole)]
-            : [buildSubagentContextSection(params.extraSystemPrompt)]), // 22
-    ];
+function buildAllSections(params, mode) {
+    const base = SECTIONS
+        .filter((s) => s.includeIn.has(mode))
+        .map((s) => s.build(params, mode));
+    // Subagent section: prefer structured params, fall back to raw extraSystemPrompt.
+    // Unconditional; matches the previous hand-written emission.
+    const subagent = params.subagentRole
+        ? buildSubagentRoleSection(params.subagentRole)
+        : buildSubagentContextSection(params.extraSystemPrompt);
+    return [...base, subagent];
 }
 /**
  * Append additional sections (backward compat for RAG memory etc.) to a joined string.
@@ -141,8 +170,7 @@ export function assembleRichSystemPrompt(params) {
     if (mode === "none") {
         return buildIdentitySection(agentName).join("\n");
     }
-    const isMinimal = mode === "minimal";
-    const allSections = buildAllSections(params, isMinimal);
+    const allSections = buildAllSections(params, mode);
     // Filter out empty arrays, join each section's lines, then join sections
     const joined = joinSections(allSections);
     // Append additional sections (backward compat for RAG memory etc.)
@@ -186,9 +214,13 @@ export function assembleRichSystemPromptBlocks(params) {
             semiStableBody: "",
         };
     }
-    const isMinimal = mode === "minimal";
-    const allSections = buildAllSections(params, isMinimal);
+    const allSections = buildAllSections(params, mode);
     // Split at boundaries: identity+persona | safety+language | tooling+workspace+...
+    // Boundaries are index-based on the filtered section list. In `"full"` and
+    // `"operational"` modes the first 2 entries are identity+persona (both are
+    // in MODES_FULL_OP) and the next 2 are safety+language (MODES_ALL). In
+    // `"minimal"` mode persona is dropped, so the prefix shrinks by one and the
+    // byte-identity between full/operational is NOT expected in minimal mode.
     const staticSections = allSections.slice(0, STATIC_PREFIX_SECTION_COUNT);
     const attributionSections = allSections.slice(STATIC_PREFIX_SECTION_COUNT, STATIC_PREFIX_SECTION_COUNT + ATTRIBUTION_SECTION_COUNT);
     const bodySections = allSections.slice(STATIC_PREFIX_SECTION_COUNT + ATTRIBUTION_SECTION_COUNT);

package/node_modules/@comis/agent/dist/bootstrap/types.d.ts

@@ -37,10 +37,16 @@ export interface TruncationResult {
  * System prompt verbosity mode.
  *
  * - `"full"`: All workspace sections included (primary agents)
+ * - `"operational"`: All workspace sections relevant to autonomous operations;
+ *    drops interactive-only guidance (compaction recovery, silent replies,
+ *    heartbeats, reactions, media, SEP, sender trust). Used for cron and
+ *    heartbeat executions. `staticPrefix` and `attribution` cache blocks
+ *    remain byte-identical to `"full"` so the cached identity/attribution
+ *    prefix is shared across modes.
  * - `"minimal"`: Only AGENTS.md + TOOLS.md (sub-agents)
  * - `"none"`: Identity-only prompt (lightweight contexts)
  */
-export type PromptMode = "full" | "minimal" | "none";
+export type PromptMode = "full" | "operational" | "minimal" | "none";
 /**
  * Runtime metadata injected into the system prompt header.
  */
@@ -89,7 +95,7 @@ export interface BootstrapContextFile {
  * Workspace file names allowed in sub-agent bootstrap context.
  * Sub-agents only receive AGENTS.md (instructions) and TOOLS.md (tool notes).
  */
-export declare const SUBAGENT_BOOTSTRAP_ALLOWLIST: Set<"AGENTS.md" | "SOUL.md" | "IDENTITY.md" | "USER.md" | "ROLE.md" | "TOOLS.md" | "HEARTBEAT.md" | "BOOTSTRAP.md" | "BOOT.md">;
+export declare const SUBAGENT_BOOTSTRAP_ALLOWLIST: Set<"SOUL.md" | "IDENTITY.md" | "USER.md" | "AGENTS.md" | "ROLE.md" | "TOOLS.md" | "HEARTBEAT.md" | "BOOTSTRAP.md" | "BOOT.md">;
 /** Head portion ratio for truncation (first 70% of maxChars) */
 export declare const BOOTSTRAP_HEAD_RATIO = 0.7;
 /** Tail portion ratio for truncation (last 20% of maxChars) */

package/node_modules/@comis/agent/dist/bootstrap/workspace-loader.d.ts

@@ -87,6 +87,18 @@ export declare function filterBootstrapFilesForSubAgent(files: BootstrapFile[]):
  * @returns Filtered array containing only HEARTBEAT.md
  */
 export declare function filterBootstrapFilesForLightContext(files: BootstrapFile[]): BootstrapFile[];
+/**
+ * Filter bootstrap files for cron execution.
+ *
+ * Autonomous cron runs don't need heartbeat cadence rules, user preferences,
+ * tooling docs, or workspace bootstrap -- only the agent's persona (SOUL.md)
+ * and role behavior (ROLE.md). Mirrors the pattern of
+ * filterBootstrapFilesForLightContext.
+ *
+ * @param files - Full array of loaded bootstrap files
+ * @returns Filtered array containing only SOUL.md and ROLE.md
+ */
+export declare function filterBootstrapFilesForCron(files: BootstrapFile[]): BootstrapFile[];
 /**
  * Filter bootstrap files for group chat context.
  *

package/node_modules/@comis/agent/dist/bootstrap/workspace-loader.js

@@ -136,6 +136,27 @@ const HEARTBEAT_LIGHT_ALLOWLIST = new Set(["HEARTBEAT.md"]);
 export function filterBootstrapFilesForLightContext(files) {
     return files.filter((f) => HEARTBEAT_LIGHT_ALLOWLIST.has(f.name));
 }
+/**
+ * Allowlist for cron execution context.
+ * Retains ONLY SOUL.md and ROLE.md -- the persona and role behavior needed
+ * for autonomous cron runs. Strips heartbeat cadence rules, user preferences,
+ * tooling docs, and workspace bootstrap.
+ */
+const CRON_BOOTSTRAP_ALLOWLIST = new Set(["SOUL.md", "ROLE.md"]);
+/**
+ * Filter bootstrap files for cron execution.
+ *
+ * Autonomous cron runs don't need heartbeat cadence rules, user preferences,
+ * tooling docs, or workspace bootstrap -- only the agent's persona (SOUL.md)
+ * and role behavior (ROLE.md). Mirrors the pattern of
+ * filterBootstrapFilesForLightContext.
+ *
+ * @param files - Full array of loaded bootstrap files
+ * @returns Filtered array containing only SOUL.md and ROLE.md
+ */
+export function filterBootstrapFilesForCron(files) {
+    return files.filter((f) => CRON_BOOTSTRAP_ALLOWLIST.has(f.name));
+}
 /**
  * Excludelist for group chat context mode.
  * Excludes USER.md (privacy protection: personal preferences

package/node_modules/@comis/agent/dist/executor/executor-tool-assembly.js

@@ -169,6 +169,8 @@ export async function assembleTools(params) {
         resolvedModelId: resolvedModel?.id,
         resolvedModelProvider: resolvedModel?.provider,
         resolvedModelReasoning: resolvedModel?.reasoning,
+        // "interactive" default guards the optional overrides; mirrors pi-executor.ts:1077.
+        operationType: executionOverrides?.operationType ?? "interactive",
     });
     // -------------------------------------------------------------------
     // 5. System token estimate

package/node_modules/@comis/agent/dist/executor/prompt-assembly.d.ts

@@ -8,7 +8,7 @@
  *
  * @module
  */
-import type { SessionKey, NormalizedMessage, PerAgentConfig, MemoryPort, HookRunner, SecretManager, EnvelopeConfig, WrapExternalContentOptions, TypedEventBus, SenderTrustDisplayConfig, SpawnPacket, DeliveryMirrorPort } from "@comis/core";
+import type { SessionKey, NormalizedMessage, PerAgentConfig, MemoryPort, HookRunner, SecretManager, EnvelopeConfig, WrapExternalContentOptions, TypedEventBus, SenderTrustDisplayConfig, SpawnPacket, DeliveryMirrorPort, ModelOperationType } from "@comis/core";
 import type { ComisLogger } from "@comis/infra";
 import type { ToolDefinition } from "@mariozechner/pi-coding-agent";
 import type { BootstrapContextFile } from "../bootstrap/types.js";
@@ -151,6 +151,13 @@ export interface PromptAssemblyParams {
     /** Whether the resolved model has native reasoning support (e.g. encrypted thinking blocks).
      *  When true, the `<think>`/`<final>` tag hint is suppressed to avoid double-reasoning. */
     resolvedModelReasoning?: boolean;
+    /** Operation type from ExecutionOverrides. Resolves promptMode and bootstrap filter.
+     *  When omitted by callers at the TypeScript level, executor-tool-assembly supplies
+     *  "interactive" as the default before invoking this function, so this is required
+     *  at the call-site contract level. Values of "cron" or "heartbeat" auto-upgrade
+     *  the promptMode from "full" to "operational" and dispatch operation-specific
+     *  bootstrap filters. */
+    operationType: ModelOperationType;
 }
 /**
  * Assemble the full system prompt for a PiExecutor execution cycle.

package/node_modules/@comis/agent/dist/executor/prompt-assembly.js

@@ -12,7 +12,7 @@
 import * as fs from "node:fs/promises";
 import { wrapExternalContent, safePath, formatSessionKey, generateCanaryToken } from "@comis/core";
 import { suppressError } from "@comis/shared";
-import { loadWorkspaceBootstrapFiles, buildBootstrapContextFiles, assembleRichSystemPrompt, assembleRichSystemPromptBlocks, filterBootstrapFilesForLightContext, filterBootstrapFilesForGroupChat, resolveSenderDisplay, buildDateTimeSection, buildInboundMetadataSection, buildSenderTrustSection, buildSubagentRoleSection, // for dynamic preamble injection
+import { loadWorkspaceBootstrapFiles, buildBootstrapContextFiles, assembleRichSystemPrompt, assembleRichSystemPromptBlocks, filterBootstrapFilesForLightContext, filterBootstrapFilesForCron, filterBootstrapFilesForGroupChat, resolveSenderDisplay, buildDateTimeSection, buildInboundMetadataSection, buildSenderTrustSection, buildSubagentRoleSection, // for dynamic preamble injection
 buildVerbosityHintSection, resolveVerbosityProfile, } from "../bootstrap/index.js";
 import { deduplicateResults } from "../rag/rag-retriever.js";
 import { createHybridMemoryInjector } from "../rag/hybrid-memory-injector.js";
@@ -189,6 +189,9 @@ function buildMessageFlags(msg) {
     if (meta.isScheduled === true) {
         flags.isScheduled = true;
     }
+    if (meta.isCronAgentTurn === true) {
+        flags.isCronAgentTurn = true;
+    }
     return flags;
 }
 /**
@@ -317,7 +320,19 @@ export async function assembleExecutionPrompt(params) {
         return { systemPrompt: parentCache.frozenSystemPrompt, systemPromptBlocks: parentCache.frozenSystemPromptBlocks, dynamicPreamble, inlineMemory: undefined };
     }
     // 1. Resolve promptMode
-    const promptMode = config.bootstrap?.promptMode ?? "full";
+    // Cron and heartbeat auto-upgrade from "full" -> "operational" to trim
+    // interactive-only sections (compaction recovery, silent replies, reactions,
+    // media, SEP, sender trust). An explicit `config.bootstrap?.promptMode` wins
+    // -- operators can still force "minimal"/"none"/"full" if they have reason.
+    const baseMode = config.bootstrap?.promptMode ?? "full";
+    const promptMode = (params.operationType === "cron" || params.operationType === "heartbeat") && baseMode === "full"
+        ? "operational"
+        : baseMode;
+    // Consolidated lightContext flag: heartbeat implies light-context regardless
+    // of the explicit msg.metadata.lightContext flag. Callers that only set the
+    // metadata flag OR only set operationType="heartbeat" produce identical
+    // prompt output (design-doc §Risks: "Heartbeat lightContext and operationType drift").
+    const effectiveLightContext = msg.metadata?.lightContext === true || params.operationType === "heartbeat";
     // 2. Load workspace bootstrap files (skip for "none" mode)
     let bootstrapContextFiles = [];
     if (promptMode !== "none") {
@@ -334,11 +349,16 @@ export async function assembleExecutionPrompt(params) {
             bootstrapFiles = await loadWorkspaceBootstrapFiles(deps.workspaceDir, bootstrapMaxChars);
             sessionBootstrapFileSnapshots.set(bsSnapKey, bootstrapFiles);
         }
-        // Heartbeat light context -- keep only HEARTBEAT.md
-        if (msg.metadata?.lightContext === true) {
+        // Bootstrap filter dispatch:
+        //  - effectiveLightContext (heartbeat / explicit flag) -> HEARTBEAT.md only
+        //  - operationType === "cron" -> SOUL.md + ROLE.md only
+        //  - group chat context -> strip USER.md for privacy
+        if (effectiveLightContext) {
             bootstrapFiles = filterBootstrapFilesForLightContext(bootstrapFiles);
         }
-        // Group chat privacy -- exclude USER.md
+        else if (params.operationType === "cron") {
+            bootstrapFiles = filterBootstrapFilesForCron(bootstrapFiles);
+        }
         else if (config.bootstrap?.groupChatFiltering !== false &&
             isGroupContext(msg)) {
             bootstrapFiles = filterBootstrapFilesForGroupChat(bootstrapFiles);

package/node_modules/@comis/agent/dist/session/comis-session-manager.js

@@ -18,7 +18,7 @@
 import { SessionManager as SdkSessionManager } from "@mariozechner/pi-coding-agent";
 import { formatSessionKey, safePath } from "@comis/core";
 import { suppressError } from "@comis/shared";
-import { mkdir, unlink, rm } from "node:fs/promises";
+import { mkdir, unlink, rm, rmdir } from "node:fs/promises";
 import { existsSync, writeFileSync, readFileSync } from "node:fs";
 import { dirname } from "node:path";
 import { sessionKeyToPath } from "./session-key-mapper.js";
@@ -61,8 +61,13 @@ export function createComisSessionManager(deps) {
                     await unlink(sessionPath);
                 }
                 catch { /* ENOENT ok */ }
-                const toolResultsDir = safePath(dirname(sessionPath), "tool-results");
+                const sessionDir = dirname(sessionPath);
+                const toolResultsDir = safePath(sessionDir, "tool-results");
                 await suppressError(rm(toolResultsDir, { recursive: true, force: true }), "tool-results dir may not exist");
+                try {
+                    await rmdir(sessionDir);
+                }
+                catch { /* non-empty or already gone */ }
             }, { retries: 10, retryMinTimeout: 500 });
         },
         writeSessionMetadata(sessionKey, metadata) {

package/node_modules/@comis/agent/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@comis/agent",
   "private": true,
-  "version": "1.0.13",
+  "version": "1.0.15",
   "author": "Moshe Anconina",
   "license": "Apache-2.0",
   "description": "AI agent executor, budget control, and session management for Comis",

package/node_modules/@comis/channels/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@comis/channels",
   "private": true,
-  "version": "1.0.13",
+  "version": "1.0.15",
   "author": "Moshe Anconina",
   "license": "Apache-2.0",
   "description": "Chat platform adapters — Discord, Telegram, Slack, WhatsApp, Signal, iMessage, IRC, LINE",

package/node_modules/@comis/cli/dist/doctor/checks/channel-health.js

@@ -8,12 +8,12 @@
  *
  * @module
  */
-import { CHANNEL_ENV_KEYS } from "../../wizard/flow-types.js";
+import { CHANNEL_ENV_KEYS } from "../../wizard/index.js";
 const CATEGORY = "channels";
 /**
  * Map of channel types to their required credential environment variable names.
  *
- * Sourced from the shared CHANNEL_ENV_KEYS constant in flow-types.
+ * Sourced from the shared CHANNEL_ENV_KEYS constant in the wizard module.
  * These are format checks only -- we verify the credential appears to be
  * a non-empty string, not that it's a valid API key.
  */

package/node_modules/@comis/cli/dist/wizard/index.d.ts

@@ -6,9 +6,8 @@
  * init command, tests, future phases) imports from this single entry
  * point rather than reaching into individual wizard files.
  *
- * Legacy wizard files (flow-types.ts, quickstart-flow.ts, manual-flow.ts)
- * are NOT re-exported here -- they remain for backward compatibility
- * but are not part of the new wizard architecture.
+ * Legacy wizard files (flow-types.ts, quickstart-flow.ts, manual-flow.ts,
+ * config-writer.ts) were removed -- superseded by the step-based architecture.
  *
  * @module
  */

package/node_modules/@comis/cli/dist/wizard/index.js

@@ -7,9 +7,8 @@
  * init command, tests, future phases) imports from this single entry
  * point rather than reaching into individual wizard files.
  *
- * Legacy wizard files (flow-types.ts, quickstart-flow.ts, manual-flow.ts)
- * are NOT re-exported here -- they remain for backward compatibility
- * but are not part of the new wizard architecture.
+ * Legacy wizard files (flow-types.ts, quickstart-flow.ts, manual-flow.ts,
+ * config-writer.ts) were removed -- superseded by the step-based architecture.
  *
  * @module
  */

package/node_modules/@comis/cli/dist/wizard/steps/10-write-config.js

@@ -17,7 +17,7 @@ import { updateState, heading, success as themeSuccess, PROVIDER_ENV_KEYS, CHANN
 /**
  * Get a sensible default model for a provider.
  *
- * Matches the defaults in the existing config-writer.ts.
+ * Matches the defaults used by the wizard.
  */
 function getDefaultModel(provider) {
     if (!provider)

package/node_modules/@comis/cli/dist/wizard/types.d.ts

@@ -1,8 +1,7 @@
 /**
  * Foundational types and constants for the init wizard redesign.
  *
- * Replaces the role of flow-types.ts with a richer type system
- * that supports the full wizard architecture: immutable state
+ * Core type system for the wizard architecture: immutable state
  * accumulation, structured validation, and multi-flow support.
  *
  * @module

package/node_modules/@comis/cli/dist/wizard/types.js

@@ -2,8 +2,7 @@
 /**
  * Foundational types and constants for the init wizard redesign.
  *
- * Replaces the role of flow-types.ts with a richer type system
- * that supports the full wizard architecture: immutable state
+ * Core type system for the wizard architecture: immutable state
  * accumulation, structured validation, and multi-flow support.
  *
  * @module

package/node_modules/@comis/cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@comis/cli",
   "private": true,
-  "version": "1.0.13",
+  "version": "1.0.15",
   "author": "Moshe Anconina",
   "license": "Apache-2.0",
   "description": "Command-line interface for the Comis AI agent platform",