agentfootprint/dist/types/index.d.ts

The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.

export type { CombinedRecorder, ScopeRecorder, FlowRecorder, EmitRecorder, WriteEvent, ReadEvent, CommitEvent, StageEvent, ErrorEvent, FlowStageEvent, FlowNextEvent, FlowDecisionEvent, FlowForkEvent, FlowSelectedEvent, FlowSubflowEvent, FlowSubflowRegisteredEvent, FlowLoopEvent, FlowBreakEvent, FlowErrorEvent, TraversalContext, EmitEvent, RedactionPolicy, RedactionReport, } from 'footprintjs';
export * from './provider-contract/types.js';
export { INJECTION_KEYS, injectionKeyForSlot, isInjectionKey, type InjectionKey, stageRole, type StageRole, milestoneFor, type Milestone, type MilestoneKind, MILESTONE_KINDS, MILESTONE_TAG_PREFIX, MILESTONE_LABEL_TAG_PREFIX, milestoneTag, milestoneTags, milestoneTagsFor, milestoneFromTags, RESERVED_SUBFLOW_PREFIX, isReservedSubflowSegment, } from './lib/conventions.js';
export { milestoneOf, milestoneStops, milestoneStopsStrategy } from './time-travel/index.js';
export { epochAt, epochLocations, keyedFold, messageDigestInput, toolDigestInput, receiptAt, receiptHash, servedAt, servedViews, transformHashOf, RECEIPT_BOUNDARY, TRANSFORM_HASH_PREFIX, SERVED_GAPS, UNGAPPED_FIELDS, type EpochLocation, type FoldBasis, type KeyedFold, type Receipt, type ReceiptCacheMarker, type ReceiptMessage, type ReceiptParams, type ReceiptPiece, type ReceiptRequestOnlyMessage, type RequestMeasurement, type RequestJsonSize, type ServedGap, type ServedGapCause, type ServedGapKind, type ServedPiece, type ServedRequestOnly, type ServedView, type StoredReceipt, } from './time-travel/index.js';
export { COMPOSITION_KEYS, type BudgetPressureRecord, type CompositionKey, type EvictionRecord, type InjectionRecord, type SlotComposition, } from './recorders/core/types.js';
export { type RunContext } from './bridge/eventMeta.js';
export { contextEngineering, isEngineeredSource, isBaselineSource, ENGINEERED_SOURCES, BASELINE_SOURCES, type ContextEngineeringHandle, type ContextEngineeringUnsubscribe, type ContextInjectedEvent, type ContextInjectedListener, } from './recorders/core/contextEngineering.js';
export type { EmittedEvent, EnableNamespace, Runner } from './core/runner.js';
export { RunnerBase, makeRunId } from './core/RunnerBase.js';
export type { ObservabilityHandle, StrategyHandle } from './strategies/types.js';
export type { GroupKind, GroupMember, GroupMetadata, GroupTranslator } from './core/translator.js';
export { pauseHere, askHuman, requestInput, isInputPause, isPauseRequest, isPaused, isCheckInPause, isAskPause, pauseDemandsDecision, DecisionRequiredError, StaleDecisionError, ResumeDecisionError, type ResumeDecisionRefusal, PauseAnswerRequiredError, type ConsentGate, type ConsentGateKind, type MiddlewareAsk, type RunnerPauseOutcome, } from './core/pause.js';
export type { InputValue, InputField, InputRequestDeclaration, AwaitingInput, InputResponse, InputCancellation, InputResponseResult, InputRefusal, InputRepeat, } from './tools/inputRequest.js';
export { InputRequestError } from './tools/inputRequest.js';
export { readAskComponent, assertAskComponent, InvalidAskComponentError, type AskComponent, type AskComponentRefusalReason, } from './tools/askComponent.js';
export { allow, ask, deny, MessageDeniedError, type AllowOutcome, type AskOutcome, type AskPayload, type DenyOutcome, type MessageDeniedContext, type MessageMiddleware, type MessageMiddlewareContext, type MessageOutcome, type MiddlewareDecision, type ToolCallMiddleware, type ToolMiddleware, type ToolMiddlewareContext, type ToolOutcome, type ToolResultContext, type ToolResultMiddleware, type ToolResultOutcome, } from './core/agent/middleware/index.js';
export { LOOP_MOMENTS, actKeyFor, type ActKey, type LoopMoment } from './lib/moments.js';
export { ACT_KEYS, type ActOptions } from './core/agent/act.js';
export type { Watcher } from './core/agent/watch.js';
export { checkInApproved, checkInDeclined, isCheckInDecision, lexicalDriverScorer, standardEvidenceAssembler, minimalEvidenceAssembler, type CheckInRequest, type CheckInEvidence, type CheckInContextFrame, type CheckInDriver, type CheckInTrail, type CheckInDecision, type CheckInDecisionInput, type DecisionValue, type CheckInDemand, type CheckInPredicateContext, type CheckInScorer, type CheckInScoreInput, type CheckInAssembler, type CheckInAssemblerInput, type EvidencePreset, type CheckInBuilderOptions, } from './core/checkin.js';
export { inMemoryDecisionLedger, type DecisionLedger } from './core/consentRequest.js';
export type { AttributionUnit } from './influence-core/types.js';
export { CheckInRecorder, type CheckInRequestRecord, type CheckInDecisionRecord, type CheckInStats, } from './recorders/core/CheckInRecorder.js';
export type { FlowchartHandle, FlowchartOptions, } from './recorders/observability/FlowchartRecorder.js';
export { defaultCommentaryTemplates, extractAgentName, extractCommentaryVars, renderCommentary, selectCommentaryKey, type CommentaryContext, type CommentaryTemplates, } from './recorders/observability/commentary/commentaryTemplates.js';
export { LLMCall, LLMCallBuilder, type LLMCallInput, type LLMCallOptions, type LLMCallOutput, } from './core/LLMCall.js';
export { type MessageApiChartDeps } from './core/agent/buildMessageApiChart.js';
export { buildAgentMessageApiChart, type AgentMessageApiChartDeps, } from './core/agent/buildAgentMessageApiChart.js';
export { Agent, AgentBuilder } from './trace-toolpack/selfExplainHost.js';
export { type AgentArtifactsOptions, type AgentRecordingsOptions, type AgentInput, type AgentOptions, type AgentOutput, type ObserverDeliveryOptions, type RunConfig, type RunConfigContext, type RunConfigFn, type SkillGraphOptions, type ProviderChoice, type EscalationPolicy, } from './core/Agent.js';
export { CompactionUnmeasurableError, COMPACTED_FRAME_PREFIX, DROP_NOTICE_PREFIX, foldedMessages, foldedSpanFor, isCompactedSummary, isDropNotice, slidingWindow, summarizeOldest, tokenBudget, type CompactionOptions, type CompactionRecord, type CompactionRetention, type FoldedConversation, type FoldedSpan, type LedgerFactPin, type RemovalFacts, type RemovalPlan, type SlidingWindowOptions, type SlidingWindowRecord, type TokenBudgetOptions, type TokenBudgetRecord, type Turn, type WindowEviction, type WindowObservations, type WindowRecord, type WindowRefusal, type WindowRefusalReason, type WindowStrategy, type WindowStrategyInput, type WindowStrategyResult, } from './core/agent/window/index.js';
export { isLibraryAuthoredFrame, isSaidByPerson, LIBRARY_AUTHORED_PREFIXES, LIBRARY_NOTE_OPENING, type AuthoredMessage, } from './lib/saidByPerson.js';
export type { SelfExplainInclude, SelfExplainOptions } from './trace-toolpack/selfExplain.js';
export type { ObserverDrainResult, ObserverStats } from 'footprintjs';
export type { ToolArgValidationMode } from './tools/toolArgsValidation.js';
export { isTruncatedToolResult, type TruncatedToolResult } from './core/agent/toolResultCap.js';
export type { ReadSummaryMarker, ReadTrackingMode } from 'footprintjs';
export type { WriteProvenanceMode } from './core/agent/types.js';
export type { ExternalGroundsProvider } from './core/agent/types.js';
export type { ExternalGround, ExternalGrounding } from './integrity/unsupported-argument/check.js';
export { EMPTY_LOOKUP_CEILING, type LookupResultReading } from './integrity/empty-lookup/check.js';
export { COLUMN_TYPE_CEILING, readRowset, type ColumnCheckMode, type ColumnViolation, type RowsetReading, } from './integrity/column-types/check.js';
export { COLUMN_TYPES, assertResultColumns, type ColumnDeclaration, type ColumnType, type ToolResultColumns, } from './integrity/column-types/types.js';
export { PRIOR_TURN_EVIDENCE_CEILING, type AnswerGroundingReading, } from './integrity/prior-turn-evidence/check.js';
export { OutputSchemaError, applyOutputSchema, type OutputSchemaParser, type OutputSchemaOptions, type OutputSchemaStrategy, } from './answer-validation/outputSchema.js';
export { RESERVED_ARGUMENT, type Basis, type BasisRow, type ConflictRow, type ConflictWitness, type ContingentCarrier, type ContingentRow, type Expect, type FindingsDeclaration, type FindingsLedger, type FindingsRow, type JudgmentErrorRow, type JudgmentRow, type Standing, type StandingRow, type UnsettledByAbsenceRow, } from './core/agent/findings/types.js';
export type { ArgumentRow } from './core/agent/arguments/rows.js';
export type { GroundedRow, ScriptShownRow, StepsUnfinishedRow, } from './core/agent/assessment/witness.js';
export type { ScriptBlockVerdict, ScriptLabel, ScriptRow, ScriptsVerdict, ScriptTravelOptions, ShownScript, TurnEndScripts, UnmatchedReason, } from './core/agent/scripts/types.js';
export { ALWAYS_SERVED_TOOLS, TOOL_CHOICE_QUESTION, type NarrowSkipReason, type ToolChoiceEntry, type ToolChoiceErrorRow, type ToolChoiceLedger, type ToolChoiceOutcomeRow, type ToolChoiceRow, type ToolChoiceScore, } from './core/agent/toolChoice/types.js';
export { InvalidRunInputError } from './core/runInput.js';
export { SCHEMA_CHECK_FRAME_PREFIX, SCHEMA_TOOL_NAME, isSchemaCheckMessage, type OutputAttempt, } from './core/agent/outputEnforcement.js';
export { type OutputFallbackOptions, type OutputFallbackFn } from './core/outputFallback.js';
export { EVIDENCE_CHECK_FRAME_PREFIX, type EvidencePosture, type EvidenceShape, type EvidenceRecoveryContext, type EvidenceRecoveryInstruction, type NamesAndNumbersOptions, type UnsupportedValue, } from './core/agent/evidence/index.js';
export { UnsupportedValuesError, type UnsupportedValuesContext, } from './core/agent/evidence/errors.js';
export { canResume, ConversationMismatchError, RunCheckpointError, type AgentRunCheckpoint, } from './core/runCheckpoint.js';
export { browserSessionId, DEFAULT_SESSION_STORAGE_KEY, type BrowserSessionIdOptions, } from './hosting/browserSession.js';
export { ContextWindowExceededError, ERR_CONTEXT_WINDOW_EXCEEDED, isContextWindowExceeded, } from './provider-contract/contextWindow.js';
export { CodeSandboxError, sandboxPath, type CodeSandboxRefusal, } from './provider-contract/codeSandbox.js';
export { SessionExpiredError } from './provider-contract/sessionExpired.js';
export { NoConversationError, type NoConversationReason, PendingQuestionError, ResumeIdentityConflictError, ResumeRedactionError, type ResumeRedactionReason, RunInFlightError, } from './core/conversation.js';
export { MemberIdentityError, ParentRunRefusedError, ResumeRequestConflictError, } from './core/memberRun.js';
export { flowchartAsTool, type FlowchartAsToolOptions, type FlowchartResultMapper, type FlowchartToolSnapshot, } from './core/flowchartAsTool.js';
export { absenceSignalOf, DECLINED_VERDICT, DEFAULT_MAX_ROWS, DEFAULT_RECORDING_MAX_BYTES, DEFAULT_WALK_CAP, PANEL_RENDER_NOTE, probeDispatch, projectWalk, recordingDispatch, renderVerdictTable, runbookAsTool, RunbookAbsenceSignal, VERDICT_RENDER_NOTE, verdictRowsOf, type InnerCallRecord, type ProjectedWalk, type RecordedDispatch, type RunbookAsToolOptions, type RunbookEnvelope, type RunbookPresentation, type RunbookProcedure, type RunbookRecordingOptions, type RunbookRules, type RunbookVerdictsOptions, type RunbookWalkOptions, type VerdictRow, type WalkDescriptor, type WalkRow, } from './core/runbook/index.js';
export type { Tool, ToolExecutionContext, ToolRegistryEntry, DefineToolOptions, ToolDispatch, ToolDispatchCallOptions, ToolResultCeiling, } from './tools/tools.js';
export { artifactDetailTool, type ArtifactDetailOptions } from './tools/artifactDetailTool.js';
export { ArtifactDetailError, type ArtifactDetailErrorCode } from './artifacts/detailError.js';
export type { ArtifactDetailAction, ArtifactDetailArgs, ArtifactDetailChild, ArtifactDetailResult, } from './artifacts/detailTypes.js';
export type { AskOrAssume, ToolPeriod } from './tools/declare.js';
export type { ToolScript } from './tools/script.js';
export { defineTool, assertResultCeiling, assertResultClass, assertResultKind, assertComposedOf, assertGates, } from './tools/tools.js';
export { hostFilled, fromCredential, fromIdentity, HostFilledArgumentError, HostFilledValueMissingError, HOST_FILLED_PLACEHOLDER, type HostFill, type HostFillFromCredential, type HostFillFromIdentity, type HostFilledIdentityField, } from './tools/hostFilled.js';
export { assertValidToolName, warnIfInvalidToolName } from './lib/toolName.js';
export { explainStatusOnlyNearMiss, readToolResultEnvelope, TOOL_RESULT_STATUSES, type InstructionDeliveryLease, type ProposedEffect, type ProposeTransitionEffect, type ReadToolResultEnvelope, type RequireInstructionEffect, type ToolResultEnvelope, type ToolResultStatus, } from './semantics/toolEffects.js';
export type { InstructionLease, PendingToolTransition } from './injection-engine/leases.js';
export { ABSENCE_MARKER, ABSENCE_NOTE, absent, coverage, COVERAGE_BLOCK_HEADING, COVERAGE_MARKER, COVERAGE_NOTE, readAbsence, readCoverageLedger, readCoverageResult, type AbsenceAmongDeclaration, type AbsenceDeclaration, type AmongDeclaration, type AnswerCoverage, type AnswerInProgress, type Coverage, type CoverageDeclaration, type CoverageInput, type CoverageItem, type CoverageReading, type CoveredResult, type DeclaredCoverage, type ToolAbsence, type TryInsteadTool, isComposedCoverage, type ComposedCoverage, type ToolSearch, } from './semantics/coverage/index.js';
export { PERIOD_WIRE, periodVerdict, type DeclaredPeriod, type PeriodRow, } from './semantics/coverage/period.js';
export { IN_PROGRESS_CLAUSE, IN_PROGRESS_SECTION_LABEL, IN_PROGRESS_WIRE, } from './semantics/coverage/inProgress.js';
export type { InProgressInput, InProgressItem } from './semantics/coverage/types.js';
export { composeNotCovered, COUNTER_AGGREGATION_WORDS, describedResult, explainSemantics, isCounterLookingAggregation, readSemantics, RESULT_CLASSES, SEMANTICS_MARKER, SEMANTICS_NOTE, semanticsForModel, type DescribedResultDeclaration, type SemanticClarify, type SemanticCoverage, type SemanticEdge, type SemanticFact, type SemanticGrain, type SemanticIssue, type SemanticIssueCode, type SemanticProvenance, type SemanticRender, type SemanticSeriesPoint, type ToolResultClass, type ToolSemantics, } from './semantics/index.js';
export { toolSessionKey, hashSessionKey, ToolTeardownTimeoutError, LocalSessionHandleLostError, TOOL_TEARDOWN_TIMEOUT_MS, type TeardownScope, type TeardownReason, type TeardownOptions, } from './tools/toolSessions.js';
export { codeRunnerTool, codeShape, codeRunsOf, toolSessionsOf, TOOL_SESSIONS, type CodeRunnerToolOptions, type CodeRunnerToolScope, type HoldsToolSessions, type CodeRunFacts, } from './core/codeRunnerTool.js';
export { toolContractCheckup, formatToolContractCheckup, type ToolContractCheckup, type ToolContractProblem, type ToolContractCode, type ServerToolEntry, } from './tools/toolContract.js';
export { ARTIFACT_REF_PREFIX, ArtifactIntegrityError, bindArtifacts, RECORDING_ARTIFACT_KIND, RECORDING_MEDIA_TYPE, recordingPutInput, CHART_WALK_ARTIFACT_KIND, chartWalkPutInput, UnserializableRecordingError, DEFAULT_IN_MEMORY_ARTIFACT_RETENTION, fileArtifacts, gcsArtifacts, inMemoryArtifacts, InvalidArtifactError, isArtifactRef, mintArtifactRef, s3Artifacts, sqliteArtifacts, unconfiguredArtifacts, UnknownParentRefError, UnreadableArtifactFileError, UnreadableArtifactStoreError, type ArtifactEventFact, type ArtifactEventSink, type ArtifactListOptions, type ArtifactListResult, type ArtifactMeta, type ArtifactOp, type ArtifactOrigin, type ArtifactPutResult, type ArtifactRecord, type ArtifactRef, type ArtifactRefusalReason, type ArtifactRetention, type ArtifactScope, type ArtifactStore, type ArtifactSweepReason, type BindArtifactsOptions, type FileArtifactsOptions, type GcsArtifactsOptions, type InMemoryArtifacts, type InMemoryArtifactsOptions, type PutArtifactInput, type RecordingMintFacts, type S3ArtifactsOptions, type SqliteArtifacts, type SqliteArtifactsOptions, type SweptArtifact, type ToolArtifactPutInput, type ToolArtifacts, withDatasetArtifacts, stageDatasetArtifacts, type DatasetArtifactInput, type DatasetArtifactReceipt, type DatasetPublication, type DatasetResultAdapter, type DatasetResultPlan, describeTimeAxis, normaliseInstants, readTimeAxis, timeAxisIssues, TIME_AXIS_AGGREGATES, TIME_AXIS_UNITS, type AxisCounts, type AxisOverlapNote, type AxisPoint, type AxisPrecision, type DatasetTimeAxis, type NaiveValues, type NormalisedAxis, type NormaliseOptions, type TimeAxisAggregate, type TimeAxisReading, type TimeAxisUnit, } from './artifacts/index.js';
export type { RunTime, TimeClock, TimeOptions } from './time/clock.js';
export type { TimeRange } from './time/range.js';
export type { CallRow, CallWindowRow, ClockOnResumeRow, ClockRow, ControlWindow, PersonWindow, SourceClockRow, TimeAnswerRow, TimeDerivedRow, TimeReaderStamp, TimeReadingRow, } from './time/rows.js';
export type { Bound, BoundAs, PeriodDirection, PeriodFacts, PeriodForm, PeriodSpelling, ZoneArgument, } from './time/convert.js';
export type { TimeContext } from './time/wire.js';
export type { TimeDate, TimeMention, TimeParts, TimeReadContext, TimeReader, TimeReading, TimeRelative, TimeWall, } from './time/reader.js';
export { englishTimeReader } from './time/readers/english.js';
export type { EnglishTimeReaderOptions } from './time/readers/english.js';
export type { OpenQuestion, ReadingChoice, ReadingTags, ResolvedWindow, TimeCandidate, TimeNote, TimePart, TimePolicy, TimeWindow, ZoneAbbreviation, } from './time/resolve.js';
export type { TimeAnswerProblem, TimeAskMessageKey, TimeAskMessages, TimeFormat, } from './time/ask.js';
export { defaultTimeAskMessages } from './locales/timeAsk.js';
export { answerFromElicitation, elicitationOf, type ElicitationProperty, type ElicitationRequest, } from './mcp/elicitation.js';
export { canGetArtifactStream, canPutArtifactStream, canStreamArtifacts, type ArtifactStreamPutInput, type ArtifactStreamRecord, type StreamingArtifactStore, } from './artifacts/index.js';
export { artifactStoreConformance, formatArtifactStoreReport, runArtifactStoreCase, runArtifactStoreConformance, type ArtifactConformanceKit, type ArtifactStoreCase, type ArtifactStoreCaseName, type ArtifactStoreHarness, type ArtifactStoreHarnessHook, type ArtifactStoreMember, type ArtifactStoreOutcome, type ArtifactStoreReport, } from './artifacts/index.js';
export { assertToolWants, isPlacedToolResult, placedResultKind, PRESENT_TOOL_NAME, type ArtifactPlacement, type PlacedToolResult, type PresentedResult, type PresentSnapshot, type ToolWants, } from './artifacts/index.js';
export { Sequence, SequenceBuilder, type SequenceInput, type SequenceOptions, type SequenceOutput, } from './core-flow/Sequence.js';
export { Parallel, ParallelBuilder, type BranchOutcome, type MergeFn, type MergeOutcomesFn, type MergeWithLLMOptions, type ParallelBranchOptions, type ParallelInput, type ParallelOptions, type ParallelOutput, } from './core-flow/Parallel.js';
export { Conditional, ConditionalBuilder, type ConditionalInput, type ConditionalOptions, type ConditionalOutput, type Predicate, } from './core-flow/Conditional.js';
export { Loop, LoopBuilder, type LoopInput, type LoopOptions, type LoopOutput, type UntilGuard, } from './core-flow/Loop.js';
export { workflow, Workflow, type NextStepInput, type WorkflowOptions, } from './core-flow/Workflow.js';
export { graph, Graph, type GraphEdge, type GraphInput, type GraphNode, type GraphOptions, type GraphOutput, } from './core-flow/Graph.js';
export { providerFromEnv, type ProviderKind, type CreateProviderOptions, type ProviderFromEnv, } from './adapters/llm/createProvider.js';
export * from './patterns/index.js';
export { defineRAG, DEFAULT_CORPUS_IDENTITY, type DefineRAGOptions, indexDocuments, type IndexDocumentsOptions, type RagDocument, } from './rag/retriever/index.js';
export { topK, type TopKOptions, type RetrievalStrategy, type RetrievalEvidence, type RetrievedCandidate, type RetrievalRejectReason, } from './memory/retrieval/index.js';
export type { NegativeClaimsOptions, NegativeClaimCitation, } from './core/agent/negativeClaims/config.js';
export type { NegativeClaimPhraseExtensions } from './integrity/negative-claim/phrases.js';
export type { DeliveredNegative, AnswerNegatives } from './core/agent/negativeClaims/delivery.js';
export { AnswerValidationError, type AnswerValidationOptions, type AnswerValidationReport, type AnswerCheck, type AgentCheckName, type AnswerEvidenceResolver, type AnswerToolCall, type AnswerToolCallsView, type AnswerValidationContext, checkClaimRequirements, type ClaimRequirementPolicy, type ClaimRequirementAssessment, } from './answer-validation/index.js';
//# sourceMappingURL=index.d.ts.map