/**
 * M3 — the four model tools: compress / decompress / search_context /
 * arc_status, registered through `ctx.tools` (defineTool).
 *
 * compress is the heart of ARC: the model writes the summary and the tool
 * lands it as a durable surface replacement (no second LLM summarization
 * call). decompress recovers shadowed content read-only from the log (DSH
 * keeps the originals — V5). search_context scores blocks rebuilt from the
 * log. arc_status reports the block ledger and pressure.
 * @module dsh-arc-context/tools
 */
import { type ToolDefinition } from '@deepseek-ai/dsh-tools';
import type { CompressionCore } from 'acp-kernel';
import type { Agent } from '@deepseek-ai/dsh-agent';
import type { ArcStateStore } from './state.ts';
import { type KernelConfigInput } from './config.ts';
import { type ArcWindow } from './window.ts';
import { type ResolvedPrompts } from './prompts.ts';
export interface ToolEnvironment extends KernelConfigInput {
    readonly kernel: CompressionCore;
    readonly store: ArcStateStore;
    /** Refresh tier-2/3 appendices from recursively expanded original sources. Default true. */
    readonly effectiveSourceSafetyIndex?: boolean;
    /** Body-assembly policy for the model-checkpoint safety appendix ('value' | 'chronological'). Default 'value'. */
    readonly safetyIndexRanking?: string;
    /** Resolve the effective context window for an agent (optional: status falls back to modelContextLimit). */
    readonly windowFor?: (agent: Agent) => Promise<ArcWindow>;
    /** Resolved prompt templates (optional: falls back to DEFAULT_RESOLVED). */
    readonly prompts?: ResolvedPrompts;
    /** Whether this ARC instance is the backend the executing agent resolves. */
    readonly backendOwnership?: (agent: Agent) => BackendOwnership;
}
export interface BackendOwnership {
    readonly status: 'active' | 'shadowed' | 'unknown';
    readonly resolvedBackend: string;
}
/** Build the four ARC model tools bound to one engine. */
export declare function makeTools(env: ToolEnvironment): ToolDefinition[];