agentfootprint 10.3.0 → 10.4.0

package/dist/esm/hosting/types.d.ts

@@ -22,11 +22,11 @@
 /// <reference types="node" />
 import type { FlowchartCheckpoint } from 'footprintjs';
 import type { Agent } from '../core/Agent.js';
-import type { AskComponent } from '../core/askComponent.js';
+import type { AskComponent } from '../tools/askComponent.js';
 import type { CheckInRequest } from '../core/checkin.js';
 import type { MiddlewareAsk } from '../core/pause.js';
 import type { AgentRunCheckpoint } from '../core/runCheckpoint.js';
-import type { AwaitingInput } from '../core/inputRequest.js';
+import type { AwaitingInput } from '../tools/inputRequest.js';
 import type { Unsubscribe } from '../events/dispatcher.js';
 import type { ToolArtifacts } from '../artifacts/capability.js';
 import type { ArtifactWireRequest, ArtifactWireResult } from './artifactWire.js';
@@ -871,6 +871,21 @@ export interface PausedRun {
     readonly conversation: AgentRunCheckpoint;
     /** What the run is waiting on, as data. */
     readonly pending: PendingAsk;
+    /**
+     * What the WIRE that served the pause recorded about it — the ids it handed
+     * the caller for the answer — so a later request on that wire is matched to
+     * this pause and continued as the same invocation (`streamHandler` keeps the
+     * AG-UI adapter's record here). Absent for a pause a door with nothing to
+     * remember stored, and opaque to the store and to every other door.
+     */
+    readonly wire?: PausedWire;
+}
+/** One wire protocol's own record of a pause it served — see {@link PausedRun.wire}. */
+export interface PausedWire {
+    /** The protocol that recorded it: the protocol adapter's `name`. */
+    readonly protocol: string;
+    /** Plain JSON, the protocol's own; ids and names, never a value of the run. */
+    readonly record: unknown;
 }
 /**
  * The question a paused run is waiting on — the part of a pause that is safe to

package/dist/esm/hosting/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hosting/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAoxCH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AA2QxC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD;iFACiF;AACjF,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/hosting/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAoyCH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AA2QxC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD;iFACiF;AACjF,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC"}

package/dist/esm/hosting/verifiedThreads.d.ts

@@ -0,0 +1,29 @@
+/**
+ * verifiedThreads — the {@link ThreadBinder} that binds a thread to a VERIFIED
+ * caller, so the secure binding is the one-line one.
+ *
+ * A request names a thread; naming one proves nothing. This binder checks the
+ * caller's credential with the door's own identity verification
+ * (`verifyRequestIdentity` — the bearer token, through your verifier), never a
+ * header read as a name, and keys the conversation by WHO
+ * plus WHICH: the same thread id from two people is two conversations. The
+ * run's `identity` names the verified person, so a stored conversation records
+ * its owner and a later request from anyone else is refused as not found.
+ *
+ * A caller with no credential is REFUSED (401), even at a door that allows
+ * anonymous requests elsewhere: a thread with no owner would be anybody's who
+ * guessed its id.
+ */
+import { type IdentityVerificationOptions } from './identityVerification.js';
+import type { ThreadBinder } from './protocolAdapter.js';
+/**
+ * Bind every thread to the caller `identity` verifies.
+ *
+ * @example
+ * ```ts
+ * import { jwksIdentity } from 'agentfootprint/security';
+ * const threads = verifiedThreads(jwksIdentity({ jwksUrl, issuer, audience }));
+ * streamHandler({ agent, adapter: agUi(), threads, sessions: memorySessions() });
+ * ```
+ */
+export declare function verifiedThreads(identity: IdentityVerificationOptions): ThreadBinder;

package/dist/esm/hosting/verifiedThreads.js

@@ -0,0 +1,46 @@
+/**
+ * verifiedThreads — the {@link ThreadBinder} that binds a thread to a VERIFIED
+ * caller, so the secure binding is the one-line one.
+ *
+ * A request names a thread; naming one proves nothing. This binder checks the
+ * caller's credential with the door's own identity verification
+ * (`verifyRequestIdentity` — the bearer token, through your verifier), never a
+ * header read as a name, and keys the conversation by WHO
+ * plus WHICH: the same thread id from two people is two conversations. The
+ * run's `identity` names the verified person, so a stored conversation records
+ * its owner and a later request from anyone else is refused as not found.
+ *
+ * A caller with no credential is REFUSED (401), even at a door that allows
+ * anonymous requests elsewhere: a thread with no owner would be anybody's who
+ * guessed its id.
+ */
+import { IdentityNotVerifiedError } from './errors.js';
+import { verifyRequestIdentity } from './identityVerification.js';
+/**
+ * Bind every thread to the caller `identity` verifies.
+ *
+ * @example
+ * ```ts
+ * import { jwksIdentity } from 'agentfootprint/security';
+ * const threads = verifiedThreads(jwksIdentity({ jwksUrl, issuer, audience }));
+ * streamHandler({ agent, adapter: agUi(), threads, sessions: memorySessions() });
+ * ```
+ */
+export function verifiedThreads(identity) {
+    const binder = {
+        async bind({ conversation, headers }) {
+            const who = await verifyRequestIdentity(identity, headers, undefined);
+            if (who === undefined)
+                throw new IdentityNotVerifiedError('no-token', false);
+            return {
+                // Injective, and visible ASCII whatever the name (`josé`, `John Smith`):
+                // both halves are percent-encoded, the separator included, so no
+                // (who, which) pair spells another's key.
+                sessionId: `${encodeURIComponent(who.userId)}/${encodeURIComponent(conversation)}`,
+                identity: { principal: who.userId, conversationId: conversation },
+            };
+        },
+    };
+    return Object.freeze(binder);
+}
+//# sourceMappingURL=verifiedThreads.js.map

package/dist/esm/hosting/verifiedThreads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifiedThreads.js","sourceRoot":"","sources":["../../../src/hosting/verifiedThreads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAoC,MAAM,2BAA2B,CAAC;AAGpG;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,QAAqC;IACnE,MAAM,MAAM,GAAiB;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE;YAClC,MAAM,GAAG,GAAG,MAAM,qBAAqB,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;YACtE,IAAI,GAAG,KAAK,SAAS;gBAAE,MAAM,IAAI,wBAAwB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YAC7E,OAAO;gBACL,yEAAyE;gBACzE,iEAAiE;gBACjE,0CAA0C;gBAC1C,SAAS,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,kBAAkB,CAAC,YAAY,CAAC,EAAE;gBAClF,QAAQ,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE;aAClE,CAAC;QACJ,CAAC;KACF,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/esm/index.d.ts

@@ -1,8 +1,8 @@
 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 './adapters/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 './conventions.js';
-export { milestoneOf, milestoneStops, milestoneStopsStrategy } from './lib/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 './lib/time-travel/index.js';
+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';
@@ -11,27 +11,28 @@ 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, 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 './core/inputRequest.js';
-export { InputRequestError } from './core/inputRequest.js';
-export { readAskComponent, assertAskComponent, InvalidAskComponentError, type AskComponent, type AskComponentRefusalReason, } from './core/askComponent.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 './core/agent/moments.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 type { AttributionUnit } from './lib/influence-core/types.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, 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 { 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 './lib/trace-toolpack/selfExplain.js';
+export type { SelfExplainInclude, SelfExplainOptions } from './trace-toolpack/selfExplain.js';
 export type { ObserverDrainResult, ObserverStats } from 'footprintjs';
-export type { ToolArgValidationMode } from './core/agent/toolArgsValidation.js';
+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';
@@ -41,7 +42,7 @@ export { EMPTY_LOOKUP_CEILING, type LookupResultReading } from './integrity/empt
 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 './core/outputSchema.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, StepsUnfinishedRow } from './core/agent/assessment/witness.js';
@@ -53,35 +54,38 @@ export { EVIDENCE_CHECK_FRAME_PREFIX, type EvidencePosture, type EvidenceShape,
 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 './adapters/llm/contextWindow.js';
+export { ContextWindowExceededError, ERR_CONTEXT_WINDOW_EXCEEDED, isContextWindowExceeded, } from './provider-contract/contextWindow.js';
 export { NoConversationError, type NoConversationReason, PendingQuestionError, ResumeIdentityConflictError, ResumeRedactionError, type ResumeRedactionReason, RunInFlightError, } from './core/conversation.js';
+export { MemberIdentityError, ParentRunRefusedError } 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 './core/tools.js';
-export type { AskOrAssume, ToolPeriod } from './core/agent/arguments/declare.js';
-export { defineTool, assertValidToolName, assertResultCeiling, assertResultClass, assertResultKind, assertComposedOf, assertGates, warnIfInvalidToolName, } from './core/tools.js';
-export { explainStatusOnlyNearMiss, readToolResultEnvelope, TOOL_RESULT_STATUSES, type InstructionDeliveryLease, type InstructionLease, type PendingToolTransition, type ProposedEffect, type ProposeTransitionEffect, type ReadToolResultEnvelope, type RequireInstructionEffect, type ToolResultEnvelope, type ToolResultStatus, } from './core/agent/toolEffects.js';
-export { ABSENCE_MARKER, ABSENCE_NOTE, absent, coverage, COVERAGE_BLOCK_HEADING, COVERAGE_MARKER, COVERAGE_NOTE, readAbsence, readCoverageLedger, readCoverageResult, type AbsenceDeclaration, type AnswerCoverage, type AnswerInProgress, type Coverage, type CoverageDeclaration, type CoverageInput, type CoverageItem, type CoverageReading, type CoveredResult, type DeclaredCoverage, type ToolAbsence, type TryInsteadTool, } from './core/agent/coverage/index.js';
-export { PERIOD_WIRE, periodVerdict, type DeclaredPeriod, type PeriodRow, } from './core/agent/coverage/period.js';
-export { IN_PROGRESS_CLAUSE, IN_PROGRESS_SECTION_LABEL, IN_PROGRESS_WIRE, } from './core/agent/coverage/inProgress.js';
-export type { InProgressInput, InProgressItem } from './core/agent/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 './lib/semantics/index.js';
-export { toolSessionKey, hashSessionKey, ToolTeardownTimeoutError, TOOL_TEARDOWN_TIMEOUT_MS, type TeardownScope, type TeardownReason, type TeardownOptions, } from './core/toolSessions.js';
+export type { Tool, ToolExecutionContext, ToolRegistryEntry, DefineToolOptions, ToolDispatch, ToolDispatchCallOptions, ToolResultCeiling, } from './tools/tools.js';
+export type { AskOrAssume, ToolPeriod } from './tools/declare.js';
+export { defineTool, assertResultCeiling, assertResultClass, assertResultKind, assertComposedOf, assertGates, } from './tools/tools.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 AbsenceDeclaration, type AnswerCoverage, type AnswerInProgress, type Coverage, type CoverageDeclaration, type CoverageInput, type CoverageItem, type CoverageReading, type CoveredResult, type DeclaredCoverage, type ToolAbsence, type TryInsteadTool, } 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, 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 './core/toolContract.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 './core/time/clock.js';
-export type { TimeRange } from './core/time/range.js';
-export type { CallRow, CallWindowRow, ClockOnResumeRow, ClockRow, ControlWindow, PersonWindow, SourceClockRow, TimeAnswerRow, TimeDerivedRow, TimeReaderStamp, TimeReadingRow, } from './core/time/rows.js';
-export type { Bound, BoundAs, PeriodDirection, PeriodFacts, PeriodForm, PeriodSpelling, ZoneArgument, } from './core/time/convert.js';
-export type { TimeContext } from './core/time/wire.js';
-export type { TimeDate, TimeMention, TimeParts, TimeReadContext, TimeReader, TimeReading, TimeRelative, TimeWall, } from './core/time/reader.js';
-export { englishTimeReader } from './core/time/readers/english.js';
-export type { EnglishTimeReaderOptions } from './core/time/readers/english.js';
-export type { OpenQuestion, ReadingChoice, ReadingTags, ResolvedWindow, TimeCandidate, TimeNote, TimePart, TimePolicy, TimeWindow, ZoneAbbreviation, } from './core/time/resolve.js';
-export type { TimeAnswerProblem, TimeAskMessageKey, TimeAskMessages, TimeFormat, } from './core/time/ask.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 './lib/mcp/elicitation.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';
@@ -93,6 +97,6 @@ export { workflow, Workflow, type NextStepInput, type WorkflowOptions, } from '.
 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 './lib/rag/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 { AnswerValidationError, type AnswerValidationOptions, type AnswerValidationReport, type AnswerCheck, type AnswerEvidenceResolver, } from './answer-validation/index.js';

package/dist/esm/index.js

@@ -10,7 +10,7 @@
  * re-exported footprintjs types as their documentation.
  */
 // Adapter interfaces (ports)
-export * from './adapters/types.js';
+export * from './provider-contract/types.js';
 // Injection keys + recorder authoring helpers — needed by anyone writing
 // a custom recorder that switches on injection events.
 export { INJECTION_KEYS, injectionKeyForSlot, isInjectionKey, 
@@ -35,7 +35,7 @@ MILESTONE_KINDS, MILESTONE_TAG_PREFIX, MILESTONE_LABEL_TAG_PREFIX, milestoneTag,
 // pattern miner imports the law instead of hardcoding 'sf-'. The refusal
 // itself (assertUnreservedSubflowSegment) stays internal: it belongs to the
 // declaration doors, not to consumers.
-RESERVED_SUBFLOW_PREFIX, isReservedSubflowSegment, } from './conventions.js';
+RESERVED_SUBFLOW_PREFIX, isReservedSubflowSegment, } from './lib/conventions.js';
 // The milestones ON the reader's cursor. `milestoneFor` above classifies ONE
 // stage id; this is that classifier mapped onto a finished run's commit log as
 // a footprintjs `TimeTravelStrategy`, so `timeTravel(snapshot, { strategy:
@@ -43,8 +43,8 @@ RESERVED_SUBFLOW_PREFIX, isReservedSubflowSegment, } from './conventions.js';
 // decision instead of stopping on every stage. `milestoneOf(stop)` reads the
 // milestone back off a stop (footprintjs's `Stop` has no slot for a
 // consumer's own vocabulary). Fold: derived from the recorded log, never a
-// re-walk — see src/lib/time-travel/README.md.
-export { milestoneOf, milestoneStops, milestoneStopsStrategy } from './lib/time-travel/index.js';
+// re-walk — see src/time-travel/README.md.
+export { milestoneOf, milestoneStops, milestoneStopsStrategy } from './time-travel/index.js';
 // THE RECEIPT AT THE STOP (9.88.0). The wire a model receives is assembled from
 // committed pieces and is itself never committed — so `servedAt(snapshot, k)`
 // REBUILDS it from those pieces, and `receiptAt(snapshot, k)` reads the
@@ -56,11 +56,11 @@ export { milestoneOf, milestoneStops, milestoneStopsStrategy } from './lib/time-
 // `receiptAt` answers a `StoredReceipt` (9.94.1): the receipt AS STORED, by
 // the release that minted it — a container a later release added may be
 // absent, and a reader reads it as "cannot say", never as a throw.
-export { epochAt, epochLocations, keyedFold, messageDigestInput, toolDigestInput, receiptAt, receiptHash, servedAt, servedViews, transformHashOf, RECEIPT_BOUNDARY, TRANSFORM_HASH_PREFIX, SERVED_GAPS, UNGAPPED_FIELDS, } from './lib/time-travel/index.js';
+export { epochAt, epochLocations, keyedFold, messageDigestInput, toolDigestInput, receiptAt, receiptHash, servedAt, servedViews, transformHashOf, RECEIPT_BOUNDARY, TRANSFORM_HASH_PREFIX, SERVED_GAPS, UNGAPPED_FIELDS, } from './time-travel/index.js';
 // `STAGE_IDS`, `SUBFLOW_IDS`, `isSlotSubflow`, `slotFromSubflowId`,
 // `isKnownStage`, `isKnownSubflow` are intentionally NOT exported — they
 // are the internal builder↔recorder coordination protocol, not consumer
-// API. Library code reaches them via the relative `./conventions.js`
+// API. Library code reaches them via the relative `./lib/conventions.js`
 // import; downstream code should never need them.
 export { COMPOSITION_KEYS, } from './recorders/core/types.js';
 // Context-engineering + emit primitives.
@@ -91,7 +91,7 @@ pauseDemandsDecision, DecisionRequiredError, StaleDecisionError,
 // conversations and the caller picks; the library used to pick silently and
 // crash a turn later.
 PauseAnswerRequiredError, } from './core/pause.js';
-export { InputRequestError } from './core/inputRequest.js';
+export { InputRequestError } from './tools/inputRequest.js';
 // Typed HITL (9.24.0) — the OPTIONAL component half of a human ask: WHICH
 // registered screen component collects the answer, with small `props` inline
 // and the big half as an artifact ref (`propsRef`) that rides the STORE, not
@@ -103,7 +103,7 @@ export { InputRequestError } from './core/inputRequest.js';
 // `readAskComponent` is the one reader of a pause payload's component (for
 // anyone building a host); `InvalidAskComponentError` is the raise-time
 // refusal — a dangling `propsRef` fails at its source, never on the screen.
-export { readAskComponent, assertAskComponent, InvalidAskComponentError, } from './core/askComponent.js';
+export { readAskComponent, assertAskComponent, InvalidAskComponentError, } from './tools/askComponent.js';
 // The middleware family — a typed chain around every tool dispatch
 // (`.toolMiddleware()`) and around the message boundary
 // (`.messageMiddleware()`): the input before the model sees it, the output
@@ -121,7 +121,7 @@ export { allow, ask, deny, MessageDeniedError, } from './core/agent/middleware/i
 // about its own turn. Pure sugar over the five doors above and below; the keys
 // are locked at compile time against `LoopMoment`, so the bundle cannot fall
 // behind the loop.
-export { LOOP_MOMENTS, actKeyFor } from './core/agent/moments.js';
+export { LOOP_MOMENTS, actKeyFor } from './lib/moments.js';
 export { ACT_KEYS } from './core/agent/act.js';
 // Check in with the receipts — evidence-carrying human consent. A tool
 // declares `checkIn` (see `defineTool`); when it trips the run pauses with a
@@ -154,7 +154,11 @@ export { LLMCall, LLMCallBuilder, } from './core/LLMCall.js';
 // → Call-LLM → route → [tool-exec → loop] / final. tools + the loop are the
 // only additions over buildMessageApiChart. See buildAgentMessageApiChart.
 export { buildAgentMessageApiChart, } from './core/agent/buildAgentMessageApiChart.js';
-export { Agent, AgentBuilder, } from './core/Agent.js';
+// `Agent` and `AgentBuilder` come through the trace toolpack's host, which
+// plugs `.selfExplain()` into the builder's port at load — the registration
+// travels with the class, so a bundler that skips this barrel cannot drop it
+// (`trace-toolpack/selfExplainHost.ts` says why).
+export { Agent, AgentBuilder } from './trace-toolpack/selfExplainHost.js';
 // `.window(strategy)` / `.compaction()` — keep the live context window inside
 // its budget without ever losing the record. A strategy edits the WINDOW; the
 // LEDGER keeps every removed turn byte-identical, and every strategy files its
@@ -214,7 +218,7 @@ export { COLUMN_TYPES, assertResultColumns, } from './integrity/column-types/typ
 // read one owner. `AnswerGroundingReading` is what the library could see of
 // an answer's grounding — the vocabulary behind an `unreachable` row.
 export { PRIOR_TURN_EVIDENCE_CEILING, } from './integrity/prior-turn-evidence/check.js';
-export { OutputSchemaError, applyOutputSchema, } from './core/outputSchema.js';
+export { OutputSchemaError, applyOutputSchema, } from './answer-validation/outputSchema.js';
 // 9.101.0 — the findings ledger (`.findings()`): the row shapes
 // `agent.findings()` hands back and `AgentState.findingsLedger` /
 // `AgentRunCheckpoint.findingsLedger` carry, plus the reserved argument name
@@ -259,11 +263,14 @@ export { browserSessionId, DEFAULT_SESSION_STORAGE_KEY, } from './hosting/browse
 // from every vendor's wording, carrying the numbers and the fixes. Exported
 // from the ROOT (not `/llm-providers`) because the thing you catch it with is
 // `agent.run()`, and because `canResume` classifies on it.
-export { ContextWindowExceededError, ERR_CONTEXT_WINDOW_EXCEEDED, isContextWindowExceeded, } from './adapters/llm/contextWindow.js';
+export { ContextWindowExceededError, ERR_CONTEXT_WINDOW_EXCEEDED, isContextWindowExceeded, } from './provider-contract/contextWindow.js';
 // The conversation refusals (9.2.0) — `instanceof`-able so a caller can tell
 // "you are already running" from "somebody is still waiting on an answer" from
 // "there is nothing to follow up on".
 export { NoConversationError, PendingQuestionError, ResumeIdentityConflictError, ResumeRedactionError, RunInFlightError, } from './core/conversation.js';
+// A composition member runs for the run that mounted it; one no run reached is
+// refused by name (`core/memberRun.ts`).
+export { MemberIdentityError, ParentRunRefusedError } from './core/memberRun.js';
 export { flowchartAsTool, } from './core/flowchartAsTool.js';
 // runbookAsTool (9.76.0) — the STANDARD bridge from a footprintjs procedure
 // to an Agent tool: every answer is the mandatory honesty spine (coverage
@@ -278,7 +285,7 @@ export { absenceSignalOf, DECLINED_VERDICT, DEFAULT_MAX_ROWS,
 // and a bundle over this many bytes is REFUSED (never truncated) with the
 // reason stated on `walk.recording_note`.
 DEFAULT_RECORDING_MAX_BYTES, DEFAULT_WALK_CAP, PANEL_RENDER_NOTE, probeDispatch, projectWalk, recordingDispatch, renderVerdictTable, runbookAsTool, RunbookAbsenceSignal, VERDICT_RENDER_NOTE, verdictRowsOf, } from './core/runbook/index.js';
-export { defineTool, assertValidToolName, assertResultCeiling, assertResultClass, 
+export { defineTool, assertResultCeiling, assertResultClass, 
 // The placed-result kind (9.70.0) — `Tool.resultKind` lets a tool declare
 // the artifact kind its PLACED result is minted under, so the ticket speaks
 // the vocabulary a `wants` argument names. Exported beside the other two
@@ -288,13 +295,16 @@ assertResultKind,
 // agent build, when the catalog is complete) and `gates` (whether the
 // procedure can raise an approval gate). Exported beside the others for
 // consumers assembling `Tool` objects by hand.
-assertComposedOf, assertGates, warnIfInvalidToolName, } from './core/tools.js';
+assertComposedOf, assertGates, } from './tools/tools.js';
+// The tool-name law (`lib/toolName.ts`): the strict check and the dev-mode
+// warning `defineTool` runs, for consumers assembling `Tool` objects by hand.
+export { assertValidToolName, warnIfInvalidToolName } from './lib/toolName.js';
 // Typed tool effects (9.19.0) — the result envelope a tool may return to
 // steer the run with DATA instead of string conventions: propose a graph
 // transition, push a registered instruction, declare an outcome status. The
 // law: push mandatory procedure; pull optional knowledge; never let
 // arbitrary text promote itself into control authority.
-export { explainStatusOnlyNearMiss, readToolResultEnvelope, TOOL_RESULT_STATUSES, } from './core/agent/toolEffects.js';
+export { explainStatusOnlyNearMiss, readToolResultEnvelope, TOOL_RESULT_STATUSES, } from './semantics/toolEffects.js';
 // The two coverage primitives — both invented in FIELD USE, on a live triage
 // agent, because the library had no answer for either.
 //
@@ -312,20 +322,20 @@ export { explainStatusOnlyNearMiss, readToolResultEnvelope, TOOL_RESULT_STATUSES
 // Both are RECOGNIZED by the framework (status, events, evidence corpus), not
 // conventions: a shape the framework does not understand cannot stop a retry
 // loop or keep a value out of the evidence index.
-export { ABSENCE_MARKER, ABSENCE_NOTE, absent, coverage, COVERAGE_BLOCK_HEADING, COVERAGE_MARKER, COVERAGE_NOTE, readAbsence, readCoverageLedger, readCoverageResult, } from './core/agent/coverage/index.js';
+export { ABSENCE_MARKER, ABSENCE_NOTE, absent, coverage, COVERAGE_BLOCK_HEADING, COVERAGE_MARKER, COVERAGE_NOTE, readAbsence, readCoverageLedger, readCoverageResult, } from './semantics/coverage/index.js';
 // The one period shape (honesty layer 3, step 7b): what a result's READ
 // covered in time — the instants it asked for, what the store holds (or
 // 'unknown', said out loud) — declared on `absent()`, `coverage()` and
 // `describedResult()`; the ONE verdict rule over it; the wire spelling as data
 // (`canonical-notes.json` publishes it); and the ledger row the results layer
 // files per call — a member of `FindingsRow`, returned by `agent.findings()`.
-export { PERIOD_WIRE, periodVerdict, } from './core/agent/coverage/period.js';
+export { PERIOD_WIRE, periodVerdict, } from './semantics/coverage/period.js';
 // The third outcome (honesty layer 3): what a `coverage()`'s read found still
 // RUNNING — its outcome not known yet, neither a success nor a failure — as
 // the TOOL declares it (`inProgress`; the library never reads a vendor's state
 // name). The wire spelling as data (`canonical-notes.json` publishes it), the
 // served clause, the limits block's section label, and the typed shapes.
-export { IN_PROGRESS_CLAUSE, IN_PROGRESS_SECTION_LABEL, IN_PROGRESS_WIRE, } from './core/agent/coverage/inProgress.js';
+export { IN_PROGRESS_CLAUSE, IN_PROGRESS_SECTION_LABEL, IN_PROGRESS_WIRE, } from './semantics/coverage/inProgress.js';
 // The semantic tool-result envelope (9.53.0) — typed series/facts/edges with
 // the caveats that make them honest (grain, provenance, coverage) as DATA,
 // so honesty is inherited, not re-authored per tool. A sibling recognizer
@@ -337,13 +347,13 @@ export { IN_PROGRESS_CLAUSE, IN_PROGRESS_SECTION_LABEL, IN_PROGRESS_WIRE, } from
 // `agentfootprint-check-semantics` bin) ships through `/observe`.
 // `describedResult()` mints it from a camelCase declaration; the saved
 // snake_case wire format remains unchanged.
-export { composeNotCovered, COUNTER_AGGREGATION_WORDS, describedResult, explainSemantics, isCounterLookingAggregation, readSemantics, RESULT_CLASSES, SEMANTICS_MARKER, SEMANTICS_NOTE, semanticsForModel, } from './lib/semantics/index.js';
+export { composeNotCovered, COUNTER_AGGREGATION_WORDS, describedResult, explainSemantics, isCounterLookingAggregation, readSemantics, RESULT_CLASSES, SEMANTICS_MARKER, SEMANTICS_NOTE, semanticsForModel, } from './semantics/index.js';
 // Tool sessions (9.7.0) — the identity a tool holds a session under, and the
 // end-signal that releases it. The KEY DERIVATION is exported because it is the
 // isolation boundary: one implementation, or two that disagree.
-export { toolSessionKey, hashSessionKey, ToolTeardownTimeoutError, TOOL_TEARDOWN_TIMEOUT_MS, } from './core/toolSessions.js';
+export { toolSessionKey, hashSessionKey, ToolTeardownTimeoutError, TOOL_TEARDOWN_TIMEOUT_MS, } from './tools/toolSessions.js';
 export { codeRunnerTool, codeShape, codeRunsOf, toolSessionsOf, TOOL_SESSIONS, } from './core/codeRunnerTool.js';
-export { toolContractCheckup, formatToolContractCheckup, } from './core/toolContract.js';
+export { toolContractCheckup, formatToolContractCheckup, } from './tools/toolContract.js';
 // Artifacts (9.21.0) — the claim-check store: a tool checks a payload in and
 // hands the model a ~26-char claim ticket; the model routes tickets instead
 // of hauling data; a later tool redeems them under the run's own scope
@@ -364,9 +374,9 @@ 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, withDatasetArtifacts, stageDatasetArtifacts, describeTimeAxis, normaliseInstants, readTimeAxis, timeAxisIssues, TIME_AXIS_AGGREGATES, TIME_AXIS_UNITS, } from './artifacts/index.js';
 // The library's careful English reader (step T6b) — a tokenizer over the v1
 // phrases, "unreadable" for the rest: `.time({ reader: englishTimeReader() })`.
-export { englishTimeReader } from './core/time/readers/english.js';
+export { englishTimeReader } from './time/readers/english.js';
 export { defaultTimeAskMessages } from './locales/timeAsk.js';
-export { answerFromElicitation, elicitationOf, } from './lib/mcp/elicitation.js';
+export { answerFromElicitation, elicitationOf, } from './mcp/elicitation.js';
 // Artifacts, the optional streaming leg (9.25.0) — `putStream`/`getStream` are
 // FEATURE-DETECTED members of the port, so a store that cannot move bytes
 // without holding them whole leaves them absent rather than faking one. The
@@ -431,7 +441,7 @@ export * from './patterns/index.js';
 // RAG — retrieval-augmented generation as a context-engineering flavor.
 // Thin sugar over `defineMemory({ type: SEMANTIC, strategy: TOP_K })`
 // plus the `indexDocuments` helper for seeding the corpus at startup.
-export { defineRAG, DEFAULT_CORPUS_IDENTITY, indexDocuments, } from './lib/rag/index.js';
+export { defineRAG, DEFAULT_CORPUS_IDENTITY, indexDocuments, } from './rag/retriever/index.js';
 // The retrieval seam (8.8.0) — what a retrieval considered, and the rule
 // that decided what it kept. `topK` is the rule every release before this
 // one applied without naming it. The record types are here because a

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/influence-core/attributability.d.ts

@@ -0,0 +1,72 @@
+/**
+ * rankingConfidence — honesty marker for an influence ranking (RFC-003 honesty
+ * marker; influence-core block D6). Internal concept: "attributability".
+ *
+ * Pattern: pure, embedder-free function over a `scoreInfluence` result.
+ *          Deterministic; no I/O.
+ * Role:    `src/influence-core/` leaf. The honesty companion to the
+ *          four-signal scorer: it says when the ranking is a SHORTLIST,
+ *          not a verdict.
+ *
+ * ## Why this exists (the measured blind spot)
+ *
+ * Output-similarity influence ranks sources by how much they resemble the
+ * final answer. That is structurally blind to ABSENCE / CROWDING bugs: a
+ * culprit that caused the error by *displacing* context (history truncation,
+ * context dilution) need not resemble the answer — so it ranks low, or below
+ * an innocent that the answer happens to talk about. The tell is not a low
+ * absolute score; it is a FLAT top — no source clearly dominates. This
+ * function reports that flatness honestly so consumers escalate to ablation
+ * (the causal tier) instead of trusting a confident-but-wrong rank-1.
+ *
+ * Honest claim (RFC-002 §2 discipline): `clearWinner` is a proxy for "the
+ * ranking has a clear lead", never "the lead is the cause". A clear lead can
+ * still be an innocent the answer rationalizes over — only ablation makes
+ * causal claims.
+ */
+import type { ConfidenceStrategy, InfluenceScore, RankingConfidence } from './types.js';
+/**
+ * Default strategy: ABSOLUTE top-2 gap `s0 − s1 >= threshold`. Simple and
+ * interpretable, but embedder-relative (the gap scale depends on the embedding
+ * geometry). Use `ratioStrategy` for cross-embedder transfer.
+ */
+export declare function marginStrategy(threshold?: number): ConfidenceStrategy;
+/**
+ * Scale-invariant strategy: top-2 gap as a FRACTION of the top score,
+ * `(s0 − s1) / |s0| >= threshold`. Transfers across embedders / answer lengths
+ * where the absolute margin does not. A zero (or all-equal) top is never a
+ * clear winner.
+ */
+export declare function ratioStrategy(threshold?: number): ConfidenceStrategy;
+export interface RankingConfidenceOptions {
+    /**
+     * The decisiveness rule. Default: `marginStrategy(clearWinnerMargin)`.
+     * When set, it WINS — `clearWinnerMargin` is ignored. Bring your own
+     * (e.g. entropy / dispersion) or use the shipped `ratioStrategy`.
+     */
+    readonly strategy?: ConfidenceStrategy;
+    /** Threshold for the DEFAULT margin strategy (ignored when `strategy` is
+     *  set). Default: `DEFAULT_CLEAR_WINNER_MARGIN` (0.05). */
+    readonly clearWinnerMargin?: number;
+    /** Score band below the top defining the shortlist to double-check.
+     *  Default: `DEFAULT_SHORTLIST_BAND` (0.1). Recommended >=
+     *  `clearWinnerMargin` so the shortlist is at least as wide as the
+     *  winning gap (the function also guarantees the runner-up is shortlisted
+     *  when there is no clear winner, so a smaller value is safe). */
+    readonly shortlistBand?: number;
+}
+/**
+ * Assess whether an influence ranking has a clear winner to trust as a lead,
+ * or is too close to call and should be confirmed by ablation.
+ *
+ * Guarantees (relied on by the localizer): the returned `shortlist` always
+ * contains `lead` when there is one, and — when there is NO clear winner and
+ * there are ≥2 suspects — always contains the runner-up too (so ablation over
+ * the shortlist covers the real culprit even if it ranked below an innocent).
+ *
+ * @param scores `scoreInfluence` output (any order — re-sorted defensively).
+ *               Ids are assumed unique (as `scoreInfluence` enforces); the
+ *               shortlist is de-duplicated defensively regardless.
+ * @throws Error on negative or NaN options.
+ */
+export declare function rankingConfidence(scores: readonly InfluenceScore[], options?: RankingConfidenceOptions): RankingConfidence;