/**
 * `@graphorin/agent` - agent runtime for the Graphorin framework.
 *
 * The package owns:
 *
 * - The `createAgent({...})` factory that wires the typed
 *   `model -> tool calls -> model` loop, the streaming event
 *   surface, the steering / followUp queues, durable HITL
 *   approvals, multi-agent handoffs (`Agent.toTool`, the filter
 *   library, secrets isolation), the agent-level model fallback
 *   chain, the per-step compaction lifecycle, the per-tool
 *   preferred-model resolution, the structured progress-artifact
 *   APIs, and the lateral-leak defense layer.
 * - `runStateToJSON / runStateFromJSON` helpers for caller-managed
 *   durable HITL.
 * - The handoff filter library.
 * - The agent-step-level fan-out helpers (`runFanOut`,
 *   `evaluatorOptimizer`, the progress IO surface).
 * - Pure decision functions consulted by the loop
 *   (`isAgentFallbackEligible`, `resolvePreferredModel`).
 * - Lateral-leak primitives (`CausalityMonitor`,
 *   `MergeAgentSidewaysInjectionGuard` decision helpers,
 *   protocol-injection guard).
 *
 * The full documentation lives in the package `README.md`.
 *
 * @packageDocumentation
 */

/** Canonical version constant, derived from `package.json` at build time. */
import pkg from '../package.json' with { type: 'json' };

export const VERSION: string = pkg.version;

// AG-2 / SDF-4: the canonical guardrail contract lives in
// `@graphorin/security`; re-exported here for config ergonomics.
export type {
  GuardrailContext,
  GuardrailDefinition,
  GuardrailResult,
  InputGuardrail,
  OutputGuardrail,
} from '@graphorin/security/guardrails';
export {
  AgentBudgetExceededError,
  AgentBudgetUnpricedError,
  AgentResolutionError,
  AgentRuntimeError,
  type AgentRuntimeErrorCode,
  EvaluatorOptimizerConfigError,
  InvalidAgentConfigError,
  InvalidPreferredModelError,
  MergeBlockedError,
  MultipleHandoffsInStepError,
  ProgressWriteError,
  ProtocolInjectionRejectError,
  ProviderMiddlewareOrderError,
  RunStateMalformedError,
  RunStateVersionUnsupportedError,
  SubAgentResumeTargetNotFoundError,
  ToolNotFoundError,
} from './errors/index.js';
export {
  type EvaluatorCallable,
  type EvaluatorOptimizerOptions,
  type EvaluatorOptimizerOutcome,
  type EvaluatorOutcome,
  evaluatorOptimizer,
  type GeneratorCallable,
  type Rubric,
} from './evaluator-optimizer/index.js';
export { createAgent } from './factory.js';
export {
  type AgentFallbackEligibility,
  type AgentFallbackPolicy,
  type AgentFallbackReason,
  isAgentFallbackEligible,
} from './fallback/index.js';
export {
  type ChildResult,
  type FanOutOptions,
  type FanOutResult,
  type MergeStrategy,
  type PerChildBudget,
  runFanOut,
} from './fanout/index.js';
export {
  bySensitivity,
  compose,
  custom,
  type DescribedFilter,
  defaultHandoffFilter,
  FILTER_KIND_CUSTOM,
  filters,
  full,
  lastN,
  lastUser,
  stripReasoning,
  stripSensitiveOutputs,
  stripToolCalls,
  summary,
} from './filters/index.js';
export {
  CausalityMonitor,
  type CausalityMonitorCheck,
  type CausalityMonitorConfig,
  type CausalityMonitorStrictness,
  type ChildTrustInput,
  type ContentOriginKind,
  computeSourceTrust,
  DEFAULT_DENIAL_PATTERNS,
  DEFAULT_MAX_CHAIN_DEPTH,
  evaluateMerge,
  type GuardOutcome,
  guardOutboundContent,
  type MergeBiasDecision,
  type MergeGuardConfig,
  type ProtocolBoundary,
  type ProtocolEscapePolicy,
  type ProtocolGuardConfig,
  resolvePolicy,
  type TrustClass,
} from './lateral-leak/index.js';
export {
  type PreferredModelResolution,
  pickTopTierAcrossTools,
  type ResolvePreferredModelInput,
  resolvePreferredModel,
} from './preferred-model/index.js';
export {
  createProgressIO,
  type ProgressIO,
  type ProgressIOConfig,
  type ProgressReadOptions,
  type ProgressWriteOptions,
} from './progress/index.js';
export {
  addModelUsage,
  aggregateUsageFromByModel,
  completedToolCallsFromState,
  createInitialRunState,
  deserializeRunState,
  RUN_STATE_SCHEMA_MAJOR_SUPPORTED,
  RUN_STATE_SCHEMA_VERSION,
  runStateFromJSON,
  runStateToJSON,
  type SerializedPendingSubRun,
  type SerializedRunState,
  type SerializeRunStateOptions,
  serializeRunState,
} from './run-state/index.js';
export {
  getSubAgentToolRefs,
  SUBAGENT_TOOL,
  type SubAgentFoldTaint,
  type SubAgentToolRefs,
} from './runtime/agent-to-tool.js';
export { foldChildRunUsage } from './runtime/messages.js';
export {
  createReplayProvider,
  type ReplayProviderOptions,
} from './testing/replay-provider.js';
export type {
  AbortOptions,
  Agent,
  AgentCallOptions,
  AgentCapability,
  AgentConfig,
  AgentFanOutOptions,
  AgentInput,
  AgentProgressIO,
  AgentToToolOptions,
  ApprovalDecision,
  CompactionApiResult,
  CompactOptions,
  HandoffEntry,
  InboundTaintSeed,
  OutputSpec,
  PermissionHook,
  PermissionHookInput,
  PermissionHookResult,
  PostCompactionHook,
  PrepareStepHook,
  PrepareStepOverrides,
  ResponseVerifier,
  ResumeDirective,
  RunBudget,
  SkillsRegistryLike,
  SubagentForwardPolicy,
  VerifierResult,
} from './types.js';