octoflow-core 1.0.0

package/dist/runtime/sessions/bridge-options.d.ts

@@ -0,0 +1,474 @@
+import type { ActionDefinition, ActionPolicy, BuiltinActionsConfig } from '../../actions/types.js';
+import type { CustomApiClientOptions } from '../../adapters/agents/custom-api-client.js';
+import type { CustomCliOptions } from '../../adapters/agents/custom-cli-client.js';
+import type { AgentRegistry } from '../../adapters/agents/registry/loader.js';
+import type { RoutingStrategy } from '../../adapters/agents/routing.js';
+import type { ProcessRunner } from '../../adapters/agents/runtime/runner.js';
+import type { ApprovalStore } from '../../adapters/data/approval-store/types.js';
+import type { BudgetOptions } from '../../adapters/data/budget/cost-accumulator.js';
+import type { SessionStore } from '../../adapters/data/session-store/types.js';
+import type { TaskStore, TaskStoreConfig, TaskStoreConnectors } from '../../adapters/data/task-store/index.js';
+import type { AuthStore, OAuthProviderId } from '../../auth/types.js';
+import type { AgentGuardrail, ContextMiddleware } from '../../capabilities/agent-context/types.js';
+import type { MemoryIndexerOptions } from '../../capabilities/memory-indexer.js';
+import type { AgentLoopOptions, BridgeMcpLoadOptions, BridgeMcpServerConfig, CapabilityContextOptions, CapabilityMiddleware, CapabilitySkill } from '../../capabilities/types.js';
+import type { BackendOverrides, OctoFlowConfig } from '../../config/config.js';
+import type { AcpElicitationRequest, AcpElicitationResponse } from '../../domain/acp-elicitation.js';
+import type { BridgeFallbackOptions, BridgeHistoryStrategy, BridgeMiddleware, BridgeToolConfig, SessionBackendMobilityOptions, SessionGcOptions } from '../../domain/bridge-api.js';
+import type { ManagedWorktreeOptions } from '../../domain/contracts/backends.js';
+import type { BackendName } from '../../domain/core-client.js';
+import type { AgentRole, BridgeApprovalMode, BridgeCacheOptions, Part } from '../../domain/core-task.js';
+import type { PermissionConfig } from '../../domain/permission.js';
+import type { BackendType, LlmProvider } from '../../domain/protocol.js';
+import type { ResolvedProviderProfile } from '../../domain/provider-profile.js';
+import type { ObservabilityOptions } from '../../observability/types.js';
+import type { BridgePolicy, PolicySubject } from '../../policy/index.js';
+import type { RuntimeBrainConfig } from '../bridge/brain-config.js';
+import type { BridgeAnyEventHandler, BridgeEventHandler } from '../bridge/events.js';
+import type { BridgePlugin } from '../bridge/plugins.js';
+import type { TopicChannelOptions } from '../bridge/topic-types.js';
+import type { LoopConfig, TaskConfig } from '../orchestration/run/types.js';
+import type { SubagentsBridgeOptions } from '../orchestration/subagent/subagent-action-types.js';
+import type { AgentSkillsOptions } from './agent-skills-types.js';
+import type { BridgeApprovalOptions, BridgeSecurityOptions, CircuitBreakerOptions, ContextEvictInfo } from './bridge-aux-types.js';
+import type { ContextCompactionOptions } from './compaction-types.js';
+import type { LocalContextOptions } from './local-context-types.js';
+/**
+ * Grouped session options shorthand for `createAgent({ sessions })`.
+ *
+ * Expands to the equivalent flat `BridgeOptions` fields before the Bridge
+ * sees the config. Explicit flat fields take precedence over `sessions.*`.
+ *
+ * @example
+ * createAgent({
+ *   sessions: { dynamic: true, maxContexts: 20, contextTtlMs: 60_000 },
+ * })
+ */
+export interface SessionsConfig {
+    /** Allocate a new session per `sendMessage`. Maps to `dynamicSession`. */
+    dynamic?: boolean;
+    /** Session-persistence store. Maps to `sessionStore`. */
+    store?: SessionStore;
+    /** Policy for moving a session between backends. Maps to `sessionBackendMobility`. */
+    backendMobility?: SessionBackendMobilityOptions;
+    /** Session garbage-collection policy. Maps to `sessionGc`. */
+    gc?: SessionGcOptions;
+    /** Max concurrent context slots. Maps to `maxContexts`. */
+    maxContexts?: number;
+    /** Max queued sends per context. Maps to `maxQueueDepth`. */
+    maxQueueDepth?: number;
+    /** Context TTL for idle eviction (ms). Maps to `contextTtlMs`. */
+    contextTtlMs?: number;
+}
+/**
+ * Grouped prompt shorthand for `createAgent({ prompt })`.
+ *
+ * Expands to the equivalent flat `BridgeOptions` fields before the Bridge
+ * sees the config. Explicit flat fields take precedence over `prompt.*`.
+ *
+ * @example
+ * createAgent({
+ *   prompt: {
+ *     system: 'You are a senior engineer.',
+ *     caller: 'Be concise and cite sources.',
+ *   },
+ * })
+ */
+export interface PromptConfig {
+    /** Base system prompt. Maps to `systemPrompt`. */
+    system?: string;
+    /**
+     * Caller policy/style appended as a distinct tagged section.
+     * Maps to `userSystemPrompt`. Clearer name for the same concept.
+     */
+    caller?: string;
+    /** Structured cache-aware prompt parts. Maps to `systemPromptParts`. */
+    parts?: Part[];
+}
+/**
+ * Bridge-level security knobs surfaced on `createBridge({ security })`.
+ * These affect defaults for built-in actions (e.g. bash approval gating).
+ */
+export type { BridgeApprovalOptions, BridgeSecurityOptions, CircuitBreakerOptions, ContextEvictInfo, } from './bridge-aux-types.js';
+export interface ProjectWorkspaceMemoryOptions extends Omit<MemoryIndexerOptions, 'root' | 'brain'> {
+    /** Master toggle for indexing discovered `MEMORY.md` / `memory/` files. */
+    enabled?: boolean;
+    /** Run indexing once during `createBridge()`. Default `true` when enabled. */
+    indexOnCreate?: boolean;
+}
+export interface ProjectWorkspaceOptions {
+    /** Master toggle. Use `projectWorkspace: true` for all project conventions. */
+    enabled?: boolean;
+    /** Explicit project root. Defaults to the resolved bridge workspace. */
+    root?: string;
+    /** Starting directory for upward discovery when `root` is omitted. */
+    start?: string;
+    /** Parent-walk cap forwarded to `discoverProjectWorkspace()`. */
+    maxDepth?: number;
+    /** Load `<root>/.octoflow/mcp.json`. Default `true`. */
+    mcp?: boolean;
+    /** Load `<root>/.octoflow/skills`. Default `true`. */
+    skills?: boolean;
+    /** Index `<root>/MEMORY.md` and `<root>/memory/` into `bridge.brain`. Opt-in. */
+    memory?: boolean | ProjectWorkspaceMemoryOptions;
+}
+/**
+ * Structured logger interface — compatible with Pino, Winston, and `console`.
+ * Wire `BridgeOptions.logger` to route bridge events to your logging backend.
+ */
+export interface BridgeLogger {
+    debug(msg: string, data?: Record<string, unknown>): void;
+    info(msg: string, data?: Record<string, unknown>): void;
+    warn(msg: string, data?: Record<string, unknown>): void;
+    error(msg: string, data?: Record<string, unknown>): void;
+}
+export interface BridgeOptions {
+    /**
+     * Controls the per-task bridge action loop that re-prompts the backend after
+     * bridge actions run. When omitted and actions are available, the bridge
+     * auto-enables the loop with `maxRounds: 10`.
+     */
+    agentLoop?: boolean | AgentLoopOptions;
+    apiKeys?: Partial<Record<BackendName | 'anthropic' | 'google' | 'openai', string>>;
+    /** Default environment variables forwarded to backend executions; per-call `env` wins on collision. */
+    env?: Record<string, string>;
+    /** Loaded named-agent registry used for per-agent runtime policies. */
+    agentRegistry?: AgentRegistry;
+    /** Smart routing shortcut used when `priority` is absent. */
+    llmProvider?: LlmProvider;
+    /** Smart runtime-family shortcut used when `priority` is absent. */
+    backendType?: BackendType;
+    approvalMode?: BridgeApprovalMode;
+    /**
+     * Unified approval preset. Persistent default for every send unless
+     * overridden by `BridgeSendMessageParams.permission`. Pass a preset
+     * (`'allow-all'`, `'allow-this-session'`, `'ask'`, `'deny-all'`,
+     * `'deny-this-session'`) or a structured `PermissionOptions` object.
+     *
+     * Guarantees (see `BridgeSendMessageParams.permission` for the full
+     * contract):
+     *   - Every grant or denial creates an approval record + emits
+     *     `approval:created`/`approval:updated` (with `decidedBy:
+     *     'permission:allow-all'` for the auto-decided path).
+     *   - Actions explicitly opted into approval (`requireApproval: true`)
+     *     keep their guard under `allow-*` presets and fall back to the
+     *     regular prompt.
+     *   - Only effective for backends whose `approvalCallback` capability is
+     *     `'supported'`. Backends with `'flag-only'` / `'safety-gate'` cannot
+     *     intercept individual tool calls and emit a one-shot
+     *     `PERMISSION_PRESET_WILL_NOT_FIRE` warning.
+     */
+    permission?: PermissionConfig;
+    /** Per-backend overrides: host, model, mcpConfigPath. */
+    backends?: Partial<Record<BackendName, BackendOverrides>>;
+    config?: OctoFlowConfig;
+    /** Skip loading OCTOFLOW_CONFIG, project config, and ~/.octoflow/config.json. */
+    ignoreFileConfig?: boolean;
+    context?: CapabilityContextOptions;
+    /**
+     * Config for the `'custom-api'` backend. When `priority` includes
+     * `'custom-api'`, auto-discovery uses this to construct a `CustomApiClient`.
+     * Ignored otherwise.
+     */
+    customApi?: CustomApiClientOptions;
+    /**
+     * Config for the `'custom'` (custom-CLI) backend. When `priority` includes
+     * `'custom'`, auto-discovery uses this to construct a `CustomCliClient`.
+     * Ignored otherwise.
+     */
+    customCli?: CustomCliOptions;
+    /** Ordered named-provider candidates resolved from `createAgent({ llm: [...] })`. */
+    providerFallbacks?: ResolvedProviderProfile[];
+    workspace?: string;
+    dynamicSession?: boolean;
+    /**
+     * Automatically advance to the next backend in `priority` when any LLM call
+     * fails (403, credit error, timeout, etc.).  Pass `true` to enable with default
+     * settings, or a `BridgeFallbackOptions` object for fine-grained control.
+     * Defaults to `false` (disabled).
+     *
+     * @example
+     * // Try claude-code-cli first; silently switch to Ollama on any failure.
+     * createAgent({ priority: ['claude-code-cli', 'ollama'], fallback: true })
+     */
+    fallback?: boolean | BridgeFallbackOptions;
+    /**
+     * Convenience event listener registered on the bridge's `backend:fallback`
+     * event.  Equivalent to calling `bridge.on('backend:fallback', handler)` after
+     * creation but without keeping a reference to the bridge handle.
+     *
+     * Fires whenever a backend call fails and the bridge is switching to the next
+     * candidate in `priority`.  The payload is the full typed event object —
+     * `fromBackend`, `toBackend`, `error`, `attempt`, `taskId`, `contextId`, and
+     * standard `timestamp` / `eventVersion` fields.
+     *
+     * Enable automatic switching first with {@link fallback}`= true`.
+     *
+     * @example
+     * createAgent({
+     *   priority: ['claude-code-cli', 'anthropic-api', 'ollama'],
+     *   fallback: true,
+     *   onFallback(event) {
+     *     console.warn(`[fallback] ${event.fromBackend} → ${event.toBackend}: ${event.error.message}`);
+     *   },
+     * })
+     */
+    onFallback?: BridgeEventHandler<'backend:fallback'>;
+    /**
+     * Callback invoked when an ACP CLI agent requests user input via
+     * `unstable_createElicitation` (form fields, OAuth URLs, permission dialogs).
+     *
+     * Return `{ action: 'accept', values }`, `{ action: 'decline' }`, or
+     * `{ action: 'cancel' }` (default when unset).
+     *
+     * @example
+     * createAgent({
+     *   priority: ['acp-cli'],
+     *   onAcpElicitation: async (req) => {
+     *     if (req.mode === 'form') {
+     *       const values = await promptUser(req.fields);
+     *       return { action: 'accept', values };
+     *     }
+     *     return { action: 'cancel' };
+     *   },
+     * })
+     */
+    onAcpElicitation?: (req: AcpElicitationRequest) => Promise<AcpElicitationResponse>;
+    runner?: ProcessRunner;
+    historyStrategy?: BridgeHistoryStrategy;
+    /**
+     * Runtime-conditional action bundles. Each bundle groups `ActionDefinition`
+     * objects with an optional activation condition.
+     *
+     * Prefer `tools: ActionDefinition[]` on `createAgent` for simple tool lists.
+     * Use `actionBundles` when you need conditional bundles.
+     */
+    actionBundles?: CapabilitySkill[];
+    mcpConfigPath?: string;
+    mcpOptions?: BridgeMcpLoadOptions;
+    mcpServers?: Record<string, BridgeMcpServerConfig>;
+    model?: string;
+    /**
+     * Pre-compaction input-token budget for this client.
+     *
+     * Behavior by backend mode:
+     *   - **Bridge + API/SDK backends**: drives `contextCompaction.maxTokens`
+     *     (default 80% of value). The bridge compacts conversation history
+     *     before sending to the model.
+     *   - **Bridge + CLI backends**: also injected as the backend's native
+     *     pre-compaction signal (e.g. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` for
+     *     `claude-code-cli`, `num_ctx` for `ollama`). Compaction stays in the
+     *     CLI to avoid double-compaction.
+     *   - **`maxContext: 0`**: disables both bridge compaction and native env
+     *     injection. Useful for tests or when the backend already has a
+     *     hardcoded native default.
+     *
+     * Per-call `RunOptions.maxContext` overrides this for a single run.
+     */
+    maxContext?: number;
+    /**
+     * Soft cap on the composed system-prompt sections (identity, instructions,
+     * MCP, tools, custom, ...). When the total exceeds this cap,
+     * lower-priority non-protected sections are trimmed and a `bridge:warn`
+     * event with code `CONTEXT_SECTIONS_OVERFLOW` is emitted.
+     *
+     * Identity, instructions, tools (for prompt-injection backends), and
+     * guardrails are NEVER trimmed — this is a soft policy that prefers
+     * preserving correctness over hitting the exact budget.
+     *
+     * `0` or omitted disables the cap (no-op). Per-call
+     * `RunOptions.maxSectionTokens` overrides this for a single run.
+     *
+     * Use this knob when MCP server instructions, custom context sections,
+     * or tool catalogs grow large enough to consume the bridge-side
+     * `maxContext` budget invisibly. Compaction only handles message
+     * history; this cap is the equivalent for the system prompt.
+     */
+    maxSectionTokens?: number;
+    maxOutputTokens?: number;
+    /** Default managed git worktree policy for sends that do not pass worktree. */
+    worktree?: boolean | string | ManagedWorktreeOptions;
+    priority?: BackendName[];
+    profile?: string;
+    retries?: number;
+    routing?: RoutingStrategy;
+    sessionBackendMobility?: SessionBackendMobilityOptions;
+    sessionGc?: SessionGcOptions;
+    sessionStore?: SessionStore;
+    systemPrompt?: string;
+    /**
+     * User-authored system prompt added as a distinct tagged section during
+     * agent creation. Use this for caller policy/style that should not be
+     * merged into bridge identity, tools, MCP, skills, plugins, or tasks.
+     */
+    userSystemPrompt?: string;
+    /**
+     * Optional structured system-prompt parts. When provided, cache-aware
+     * backends emit cache markers per part. The composed bridge prompt keeps
+     * these parts additive with `systemPrompt`, so agent-type architecture and
+     * runtime instructions are not dropped when structured parts are supplied.
+     */
+    systemPromptParts?: Part[];
+    /**
+     * Prompt-cache configuration. Enables cache markers on the
+     * stable prefix of the system prompt so cache-aware backends can reuse
+     * it across turns.
+     */
+    cache?: BridgeCacheOptions;
+    taskStore?: TaskStore | TaskStoreConfig;
+    /** Named factories for `{ type: 'external', name }` task-store configs. */
+    taskStoreConnectors?: TaskStoreConnectors;
+    storage?: boolean;
+    /**
+     * Default per-send timeout (milliseconds) applied when `sendMessage()` is
+     * called without an explicit `timeoutMs`. Drives both the
+     * `waitForSettlement` deadline and the backend execution plan's timeout.
+     *
+     * Per-call `sendMessage({ timeoutMs })` always wins. Set to `0` or leave
+     * undefined to fall back to the backend runner default (600_000 / 10 min).
+     *
+     * Long-running local models (e.g. Ollama Gemma, llama.cpp) typically need
+     * 10–20 minutes; remote API backends usually finish in under 2 minutes.
+     *
+     * @default undefined (runner default: 600_000 ms)
+     */
+    timeoutMs?: number;
+    maxQueueDepth?: number;
+    maxContexts?: number;
+    contextTtlMs?: number;
+    approval?: BridgeApprovalOptions;
+    approvalStore?: ApprovalStore;
+    budget?: BudgetOptions;
+    loop?: LoopConfig;
+    middleware?: Array<BridgeMiddleware | CapabilityMiddleware>;
+    tasks?: TaskConfig;
+    contextCompaction?: ContextCompactionOptions | false;
+    tools?: BridgeToolConfig;
+    plugins?: BridgePlugin[];
+    /** Subscribe to every bridge event emitted by this agent runtime. */
+    onEvent?: BridgeAnyEventHandler;
+    onContextEvict?: (info: ContextEvictInfo) => void;
+    contextEvictionPolicy?: 'immediate' | 'defer-if-busy' | 'abort-and-evict';
+    circuitBreaker?: CircuitBreakerOptions | false;
+    auth?: {
+        store?: AuthStore;
+        providers?: OAuthProviderId[];
+        autoRefresh?: boolean;
+        clientIds?: Partial<Record<OAuthProviderId, string>>;
+    };
+    actions?: ActionDefinition[];
+    /**
+     * Control which groups of built-in actions (file I/O, bash, task management,
+     * observability, auth) are registered for this agent.
+     *
+     * - **`undefined`** (default for `'tool-loop'`): load all applicable groups.
+     * - **`false`** (default for `'loop'`): load **nothing** — no tools injected.
+     *   This is the lightest possible agent and is required when using a CLI
+     *   backend that manages its own tool loop (e.g. `claude-code-cli`,
+     *   `codex-cli`, `cursor-cli`) to avoid a runaway multi-turn tool loop.
+     * - **`BuiltinActionsConfig`**: selectively enable/disable individual groups.
+     *
+     * @example
+     * // Disable everything — best for CLI backends
+     * createAgent({ backend: 'claude-code-cli', builtinActions: false })
+     *
+     * @example
+     * // Enable only bash, disable files
+     * createAgent({ builtinActions: { bash: true, files: false } })
+     */
+    builtinActions?: BuiltinActionsConfig | false;
+    actionPolicy?: ActionPolicy;
+    /** Central RBAC and tenant authorization policy. Omitted preserves current behavior. */
+    policy?: BridgePolicy;
+    /** Default policy subject used when a per-call subject is not supplied. */
+    policySubject?: PolicySubject;
+    /**
+     * Bridge-level security knobs. These are explicit, bridge-wide opt-ins —
+     * never per-call. See `docs/security.md` for the full model.
+     */
+    security?: BridgeSecurityOptions;
+    suppressWarnings?: boolean;
+    /**
+     * Emit one-line diagnostics to stderr. `true` / `'actions'` logs action
+     * activity only; `'all'` also logs backend selection and tool delivery.
+     * `BRIDGE_VERBOSE=1|actions|all` enables the same output unless this is
+     * explicitly set to `false`.
+     */
+    verbose?: boolean | 'actions' | 'all';
+    topicChannel?: TopicChannelOptions;
+    observability?: ObservabilityOptions;
+    /**
+     * Guardrails propagated into every built agent context. Hard guardrails are
+     * integrity-protected against middleware tampering. See `AgentContextBuilder`.
+     */
+    guardrails?: AgentGuardrail[];
+    /**
+     * `ContextMiddleware` pipeline applied when the bridge builds an agent
+     * context (system prompt, tools, guardrails) via `AgentContextBuilder`.
+     */
+    contextMiddleware?: ContextMiddleware[];
+    /**
+     * Agent Skills — native `SKILL.md` discovery and catalog injection.
+     *
+     * Controls how the bridge discovers and activates `SKILL.md` files from the
+     * project workspace and npm packages. Skills inject instructions and tools
+     * into the system prompt based on the current task context.
+     *
+     * Note: unrelated to `actionBundles` (runtime-conditional `ActionDefinition` groups).
+     */
+    agentSkills?: AgentSkillsOptions;
+    /**
+     * Config-driven brain activation. When `enabled`, `createBridge()`
+     * dynamically imports `octoflow-brain`, resolves a shipped store, and
+     * attaches a `MemoryBrain` via `brainPlugin()` before plugin init — no
+     * manual `brainPlugin({ brain })` wiring required.
+     *
+     * Runtime values win over the top-level `config.brain` leaf-by-leaf;
+     * `enabled: false` at runtime disables even when the file enables.
+     *
+     * See `docs/brain.md`.
+     */
+    brain?: RuntimeBrainConfig;
+    /**
+     * LLM-callable `task` subagent tool. When truthy, the Bridge auto-registers
+     * `createSubagentAction()` with itself as `parentBridge`, defaulting the
+     * registry to `builtInAgentRegistry()` (`general-purpose`, `explore`,
+     * `plan`, `search`). Pass `true` for defaults or an object to customize
+     * caps, registry, allow-list, or the tool name.
+     *
+     * See `docs/api-usage.md` and the `subagent-task-tool-delegation` template.
+     */
+    subagents?: boolean | SubagentsBridgeOptions;
+    /** local-context auto-discovery for MCP servers + skills. */
+    getToolsFromLocalContext?: boolean;
+    /** Project `.octoflow` convention auto-wiring for MCP, skills, and memory. */
+    projectWorkspace?: boolean | ProjectWorkspaceOptions;
+    localContext?: LocalContextOptions;
+    /**
+     * Self-identification: this bridge's role within a multi-agent Pack.
+     * Defaults to `undefined` (standalone). When set, it is injected into every
+     * outgoing task's `metadata.bridge.agentRole`. Per-call `metadata.bridge.agentRole`
+     * always wins over this default.
+     */
+    role?: AgentRole;
+    /**
+     * Self-identification: the Pack this bridge belongs to.
+     * Defaults to `undefined` (standalone). When set, it is injected into every
+     * outgoing task's `metadata.bridge.packId`. Per-call `metadata.bridge.packId`
+     * always wins over this default.
+     */
+    packId?: string;
+    /**
+     * Structured logger. When set, bridge events are routed to the appropriate
+     * log level: `task:completed` → info, `task:failed` → error, `backend:retry` → warn,
+     * everything else → debug. Compatible with Pino, Winston, and `console`.
+     */
+    logger?: BridgeLogger;
+    /**
+     * When `true`, action outputs are scanned for secrets (API keys, tokens,
+     * passwords) and replaced with `[REDACTED:*]` before the result reaches LLM
+     * history. Default `false` (opt-in).
+     */
+    redactActionOutput?: boolean;
+}
+//# sourceMappingURL=bridge-options.d.ts.map

package/dist/runtime/sessions/bridge-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-options.d.ts","sourceRoot":"","sources":["../../../src/runtime/sessions/bridge-options.ts"],"names":[],"mappings":"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"}

package/dist/runtime/sessions/bridge-options.js

@@ -0,0 +1 @@
+//# sourceMappingURL=bridge-options.js.map

package/dist/runtime/sessions/bridge-options.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/runtime/sessions/compaction-types.d.ts

@@ -0,0 +1,59 @@
+import type { BackendName } from '../../domain/core-client.js';
+export type ContextCompactionTrigger = 'budget-exceeded' | 'task:created';
+export interface ContextCompactionStartInfo {
+    backend: BackendName;
+    contextId: string;
+    messageCount: number;
+    preCompactTokenCount: number;
+    promptTokenCount: number;
+    strategy: 'truncate' | 'summarize';
+    taskId: string;
+    trigger: ContextCompactionTrigger;
+}
+export interface ContextCompactionEndInfo extends ContextCompactionStartInfo {
+    compacted: boolean;
+    messagesRemoved: number;
+    postCompactTokenCount: number;
+    summaryGenerated: boolean;
+}
+export type ContextCompactionSummaryClient = (systemPrompt: string, userMessage: string) => Promise<string>;
+export type ContextCompactionSummaryClientFactory = (model: string) => ContextCompactionSummaryClient;
+export interface ContextCompactionOptions {
+    maxTokens?: number;
+    keepRecent?: number;
+    strategy?: 'truncate' | 'summarize';
+    /**
+     * Summarizer used by the bridge runtime when `strategy: 'summarize'`.
+     * Use this for a single app-level summarizer independent of model routing.
+     */
+    summaryClient?: ContextCompactionSummaryClient;
+    /**
+     * Factory used by the bridge runtime when `strategy: 'summarize'`. Receives
+     * `summaryModel`, or the effective task model when `summaryModel` is absent.
+     */
+    summaryClientFactory?: ContextCompactionSummaryClientFactory;
+    summaryModel?: string;
+    summarySystemPrompt?: string;
+    estimator?: (text: string) => number;
+    /**
+     * When set to `'task:created'`, compaction runs during task setup even when
+     * the current history is still below `maxTokens`. Defaults to compacting
+     * only after the prompt + history budget is exceeded.
+     */
+    trigger?: ContextCompactionTrigger | readonly ContextCompactionTrigger[];
+    /**
+     * Bridge-path hook fired immediately before a compaction pass begins.
+     */
+    onCompactStart?: (info: ContextCompactionStartInfo) => void | Promise<void>;
+    /**
+     * Bridge-path hook fired after a compaction pass finishes.
+     */
+    onCompactEnd?: (info: ContextCompactionEndInfo) => void | Promise<void>;
+    /**
+     * Advisory cap (in estimated tokens) on protected history entries —
+     * activated skill bodies, etc. Default 25_000. Oldest-first eviction
+     * when exceeded emits `skill:protection:overflow`.
+     */
+    maxProtectedTokens?: number;
+}
+//# sourceMappingURL=compaction-types.d.ts.map

package/dist/runtime/sessions/compaction-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction-types.d.ts","sourceRoot":"","sources":["../../../src/runtime/sessions/compaction-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAE1E,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,UAAU,GAAG,WAAW,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,wBAAwB,CAAC;CACnC;AAED,MAAM,WAAW,wBAAyB,SAAQ,0BAA0B;IAC1E,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,8BAA8B,GAAG,CAC3C,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,KAChB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,MAAM,qCAAqC,GAAG,CAClD,KAAK,EAAE,MAAM,KACV,8BAA8B,CAAC;AAEpC,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IACpC;;;OAGG;IACH,aAAa,CAAC,EAAE,8BAA8B,CAAC;IAC/C;;;OAGG;IACH,oBAAoB,CAAC,EAAE,qCAAqC,CAAC;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC;;;;OAIG;IACH,OAAO,CAAC,EAAE,wBAAwB,GAAG,SAAS,wBAAwB,EAAE,CAAC;IACzE;;OAEG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,0BAA0B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,wBAAwB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/runtime/sessions/compaction-types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=compaction-types.js.map

package/dist/runtime/sessions/compaction-types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/runtime/sessions/context-helpers.d.ts

@@ -0,0 +1,58 @@
+import type { RoutingStrategy } from '../../adapters/agents/routing.js';
+import type { OctoFlowConfig } from '../../config/config.js';
+import type { AgentEvent, BackendName } from '../../domain/core-client.js';
+import type { BridgeMetadata, ErrorInfo, FallbackInfo, GoalRef, Message, MessageMetadata, ProjectRef, RetryInfo } from '../../domain/core-task.js';
+import type { BridgeOptions, ContextState } from './context-types.js';
+export declare function getConfiguredWorkspace(options: BridgeOptions): string | undefined;
+export declare function isApiBackend(backend: BackendName): boolean;
+/**
+ * True for backends that manage their own model context (CLI wrappers).
+ * The underlying LLM model is opaque to the bridge for these backends, so
+ * `MessageMetadata.model` is NOT stamped on agent messages they produce.
+ * Local metadata (`agentName`) is still tracked for conversation-migration
+ * continuity when the session moves to an API or local backend.
+ */
+export declare function isCliBackend(backend: BackendName): boolean;
+/**
+ * Merge message-level observability fields (`model`, `agentName`) into the
+ * base `BridgeMetadata` so the returned object satisfies `MessageMetadata`
+ * and can be passed directly to `createMessage()`.
+ *
+ * - `model` is omitted for CLI backends (underlying model is opaque).
+ * - `agentName` uses the lineage name when available (Pack / multi-agent),
+ *   falling back to the bridge profile name in single-agent contexts.
+ */
+export declare function enrichAgentMessageMetadata(context: ContextState, backend: BackendName, base: BridgeMetadata): MessageMetadata;
+/**
+ * True when the backend persists its own multi-turn session server-side, so
+ * the bridge only needs to send the current user turn. Used by
+ * {@link resolveHistoryStrategy} to pick a default replay strategy under
+ * `historyStrategy: 'auto'`. Mirrors the `sessionPersistence` flag
+ * declared on each backend's `capabilities`.
+ */
+export declare function hasBackendSessionPersistence(backend: BackendName): boolean;
+export declare function createMetadata(context: ContextState, backend: BackendName, input?: {
+    error?: ErrorInfo;
+    fallback?: FallbackInfo & {
+        status: 'scheduled' | 'completed' | 'failed';
+    };
+    goal?: GoalRef;
+    project?: ProjectRef;
+    retry?: RetryInfo & {
+        status: 'exhausted' | 'scheduled';
+    };
+    sessionId?: string | null;
+    sourceEvent?: AgentEvent;
+    identity?: {
+        role?: NonNullable<BridgeMetadata['bridge']>['agentRole'];
+        packId?: string;
+    };
+}): BridgeMetadata;
+interface RoutingMaterializationInput {
+    config?: Pick<OctoFlowConfig, 'routing'> | null;
+    routing?: RoutingStrategy | OctoFlowConfig['routing'] | Record<string, unknown>;
+}
+export declare function materializeRoutingFromConfig(opts: BridgeOptions | RoutingMaterializationInput): RoutingStrategy | undefined;
+export declare function extractMessageText(message: Message | string | undefined): string | undefined;
+export {};
+//# sourceMappingURL=context-helpers.d.ts.map

package/dist/runtime/sessions/context-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-helpers.d.ts","sourceRoot":"","sources":["../../../src/runtime/sessions/context-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,eAAe,EAChB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,YAAY,EACZ,OAAO,EACP,OAAO,EACP,eAAe,EACf,UAAU,EACV,SAAS,EACV,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEtE,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,GACrB,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAS1D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAE1D;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,cAAc,GACnB,eAAe,CAQjB;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAM1E;AA4CD,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,WAAW,EACpB,KAAK,GAAE;IACL,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,CAAC,EAAE,YAAY,GAAG;QAAE,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAA;KAAE,CAAC;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,KAAK,CAAC,EAAE,SAAS,GAAG;QAAE,MAAM,EAAE,WAAW,GAAG,WAAW,CAAA;KAAE,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACE,GACL,cAAc,CAiBhB;AAED,UAAU,2BAA2B;IACnC,MAAM,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,IAAI,CAAC;IAChD,OAAO,CAAC,EACJ,eAAe,GACf,cAAc,CAAC,SAAS,CAAC,GACzB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7B;AA2BD,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,aAAa,GAAG,2BAA2B,GAChD,eAAe,GAAG,SAAS,CAI7B;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GACpC,MAAM,GAAG,SAAS,CASpB"}