open-multi-agent-kit 0.80.6 → 0.80.7

package/dist/core/agent-session.d.ts

@@ -17,13 +17,15 @@ import type { ImageContent, Model, TextContent } from "@earendil-works/omk-ai";
 import { type BashResult } from "./bash-executor.ts";
 import { type CompactionResult } from "./compaction/index.ts";
 import { type ContextUsage, type ExtensionCommandContextActions, type ExtensionErrorListener, type ExtensionMode, ExtensionRunner, type ExtensionUIContext, type InputSource, type ReplacedSessionContext, type SessionStartEvent, type ShutdownHandler, type ToolDefinition, type ToolInfo } from "./extensions/index.ts";
+import { type FreedomConfig } from "./freedom/index.ts";
+import { type LoadoutAccessPolicy } from "./loadout-access-policy.ts";
 import type { CustomMessage } from "./messages.ts";
 import type { ModelRegistry } from "./model-registry.ts";
 import { type PromptTemplate } from "./prompt-templates.ts";
 import type { ResourceLoader } from "./resource-loader.ts";
 import type { BranchSummaryEntry, SessionManager } from "./session-manager.ts";
 import type { SettingsManager } from "./settings-manager.ts";
-import { type BashOperations } from "./tools/bash.ts";
+import { type BashOperations, type BashSandboxPreflight } from "./tools/bash.ts";
 /** Parsed skill block from a user message */
 export interface ParsedSkillBlock {
     name: string;
@@ -106,6 +108,10 @@ export interface AgentSessionConfig {
      * a definition-first registry even when callers provide plain AgentTool instances.
      */
     baseToolsOverride?: Record<string, AgentTool>;
+    /** Trusted sandbox preflight used for built-in local bash execution. Never sourced from RPC command payloads. */
+    bashSandboxPreflight?: BashSandboxPreflight;
+    /** Optional immutable loadout policy used to lock active tools and scope built-in tool access. */
+    loadoutAccessPolicy?: LoadoutAccessPolicy;
     /** Mutable ref used by Agent to access the current ExtensionRunner */
     extensionRunnerRef?: {
         current?: ExtensionRunner;
@@ -121,6 +127,13 @@ export interface ExtensionBindings {
     shutdownHandler?: ShutdownHandler;
     onError?: ExtensionErrorListener;
 }
+interface ExecuteBashOptions {
+    excludeFromContext?: boolean;
+    operations?: BashOperations;
+    safetyGate?: "headless";
+    /** Trusted internal/test override for local bash sandboxing. */
+    sandboxPolicy?: BashSandboxPreflight;
+}
 /** Options for AgentSession.prompt() */
 export interface PromptOptions {
     /** Whether to expand file-based prompt templates (default: true) */
@@ -181,6 +194,8 @@ export declare class AgentSession {
     private _retryAttempt;
     private _bashAbortController;
     private _pendingBashMessages;
+    private _configuredBashSandboxPreflight;
+    private _detectedBashSandboxBackend;
     private _extensionRunner;
     private _turnIndex;
     private _resourceLoader;
@@ -192,6 +207,7 @@ export declare class AgentSession {
     private _allowedToolNames?;
     private _excludedToolNames?;
     private _baseToolsOverride?;
+    private _loadoutAccessPolicy?;
     private _sessionStartEvent;
     private _extensionUIContext?;
     private _extensionMode;
@@ -205,11 +221,36 @@ export declare class AgentSession {
     private _toolDefinitions;
     private _toolPromptSnippets;
     private _toolPromptGuidelines;
+    private _readAnchorRegistry;
+    private _readIdFactory;
+    private _readContentCache;
     private _baseSystemPrompt;
     private _baseSystemPromptOptions;
+    private _freedomConfig;
+    private _freedomBannerMemo;
     constructor(config: AgentSessionConfig);
     /** Model registry for API key resolution and model discovery */
     get modelRegistry(): ModelRegistry;
+    /**
+     * Current freedom-mode configuration loaded from `.omk/config.toml`.
+     * Returns defaults when the file is absent or invalid. The TUI consumes
+     * this through `badgeText()` to render the footer badge; the session
+     * itself consumes it via the safety-floor gate before each tool call.
+     */
+    get freedomConfig(): FreedomConfig;
+    /**
+     * One-shot banner per interactive session. Returns the banner text the
+     * first time it is called when freedom mode is enabled; returns undefined
+     * afterward. The memo lives on the session so re-renders never repeat it.
+     */
+    consumeFreedomBanner(): string | undefined;
+    /**
+     * Apply freedom-mode env exports to a spawn env. Used by bash spawners
+     * that want subprocesses to see OMK_FREEDOM_MODE without reaching into
+     * the freedom module directly.
+     */
+    decorateFreedomEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+    private _getBashSandboxPreflight;
     private _getRequiredRequestAuth;
     private _getCompactionRequestAuth;
     /**
@@ -318,7 +359,7 @@ export declare class AgentSession {
     private _handlePostAgentRun;
     /**
      * Send a prompt to the agent.
-     * - Handles extension commands (registered via pi.registerCommand) immediately, even during streaming
+     * - Handles extension commands (registered via omk.registerCommand) immediately, even during streaming
      * - Expands file-based prompt templates by default
      * - During streaming, queues via steer() or followUp() based on streamingBehavior option
      * - Validates model and API key before sending (when not streaming)
@@ -510,10 +551,7 @@ export declare class AgentSession {
      * @param options.excludeFromContext If true, command output won't be sent to LLM (!! prefix)
      * @param options.operations Custom BashOperations for remote execution
      */
-    executeBash(command: string, onChunk?: (chunk: string) => void, options?: {
-        excludeFromContext?: boolean;
-        operations?: BashOperations;
-    }): Promise<BashResult>;
+    executeBash(command: string, onChunk?: (chunk: string) => void, options?: ExecuteBashOptions): Promise<BashResult>;
     /**
      * Record a bash execution result in session history.
      * Used by executeBash and by extensions that handle bash execution themselves.
@@ -602,4 +640,5 @@ export declare class AgentSession {
      */
     get extensionRunner(): ExtensionRunner;
 }
+export {};
 //# sourceMappingURL=agent-session.d.ts.map