@tangle-network/agent-knowledge 4.0.0 → 4.1.0

package/dist/memory/index.d.ts

@@ -1,9 +1,9 @@
-import { b as AgentMemoryAdapter, j as AgentMemorySearchOptions, d as AgentMemoryContext, f as AgentMemoryHit, i as AgentMemoryScope, k as AgentMemoryWriteInput, l as AgentMemoryWriteResult, v as KnowledgeBenchmarkFamily, E as KnowledgeBenchmarkSplit, J as KnowledgeMemoryBenchmarkTaskKind, M as KnowledgeMemoryFactMatcher, h as AgentMemoryRunLease, L as KnowledgeMemoryEvent, H as KnowledgeMemoryBenchmarkCase, e as AgentMemoryControllerMode, A as AgentMemoryAcquireRunLease } from '../index-Bqg1mBPt.js';
-export { c as AgentMemoryBranchIsolation, g as AgentMemoryKind, T as OwnedAgentMemoryRunLease, $ as RetrievalHoldoutBypassReason, a0 as RetrievalHoldoutCallContext, a1 as RetrievalHoldoutConfig, a2 as RetrievalHoldoutEligibleItem, a3 as RetrievalHoldoutEvent, a4 as RetrievalHoldoutOffPolicyOptions, a5 as RetrievalHoldoutOffPolicyResult, a6 as RetrievalHoldoutResult, a7 as RetrievalHoldoutSessionState, a8 as RetrievalHoldoutSessionSummary, ak as acquireAgentMemoryRunLease, al as applyRetrievalHoldout, am as applySessionStickyRetrievalHoldout, aw as deterministicRng, ax as emitRetrievalHoldoutBypass, aD as resetRetrievalHoldoutRegistry, aI as retrievalHoldoutConfigHash, aS as toOffPolicyTrajectory } from '../index-Bqg1mBPt.js';
+import { b as AgentMemoryAdapter, j as AgentMemorySearchOptions, d as AgentMemoryContext, f as AgentMemoryHit, i as AgentMemoryScope, k as AgentMemoryWriteInput, l as AgentMemoryWriteResult, u as KnowledgeBenchmarkFamily, D as KnowledgeBenchmarkSplit, H as KnowledgeMemoryBenchmarkTaskKind, J as KnowledgeMemoryFactMatcher, h as AgentMemoryRunLease, I as KnowledgeMemoryEvent, G as KnowledgeMemoryBenchmarkCase, e as AgentMemoryControllerMode, A as AgentMemoryAcquireRunLease, $ as RetrievalHoldoutConfig, _ as RetrievalHoldoutCallContext, a2 as RetrievalHoldoutResult, Z as RetrievalHoldoutBypassReason, a1 as RetrievalHoldoutEvent } from '../types-DP38encz.js';
+export { c as AgentMemoryBranchIsolation, g as AgentMemoryKind, Q as OwnedAgentMemoryRunLease, a0 as RetrievalHoldoutEligibleItem, a3 as RetrievalHoldoutSessionState, af as acquireAgentMemoryRunLease } from '../types-DP38encz.js';
 import { CampaignResult, Scenario, DispatchContext, CampaignStorage, CostLedgerHandle, JudgeConfig, HeldoutSignificance, Lineage, GovernorContext, GovernorOp, SurfaceProposer, LineageStore, HeldoutSignificanceOptions } from '@tangle-network/agent-eval/campaign';
+import { OffPolicyTrajectory } from '@tangle-network/agent-eval/rl';
 import { z } from 'zod';
 import { S as SourceRecord } from '../types-6x0OpfW6.js';
-import '@tangle-network/agent-eval/rl';
 
 declare function defaultGetMemoryContext(adapter: Pick<AgentMemoryAdapter, 'search'>, query: string, options?: AgentMemorySearchOptions): Promise<AgentMemoryContext>;
 declare function renderMemoryContext(hits: AgentMemoryHit[]): string;
@@ -257,13 +257,16 @@ interface RunAgentMemoryExperimentResult {
     attemptLogPath: string;
     recoveryLogPath: string;
 }
+
 /** Converts existing ordered memory benchmark cases into executable histories. */
+
 declare function buildAgentMemorySequencesFromBenchmarkCases(cases: readonly KnowledgeMemoryBenchmarkCase[], options?: BuildAgentMemorySequencesFromBenchmarkCasesOptions): AgentMemorySequence[];
-/** Runs ordered, branch-isolated memory histories across candidate systems. */
-declare function runAgentMemoryExperiment(options: RunAgentMemoryExperimentOptions): Promise<RunAgentMemoryExperimentResult>;
 declare function buildAgentMemorySequenceScenarios(sequences: readonly AgentMemorySequence[], candidates: readonly Pick<AgentMemoryExperimentCandidate, 'id'>[]): AgentMemorySequenceScenario[];
 declare function agentMemorySequenceJudge(): JudgeConfig<AgentMemorySequenceArtifact, AgentMemorySequenceScenario>;
 
+/** Runs ordered, branch-isolated memory histories across candidate systems. */
+declare function runAgentMemoryExperiment(options: RunAgentMemoryExperimentOptions): Promise<RunAgentMemoryExperimentResult>;
+
 interface GraphitiMcpClientLike {
     callTool(request: {
         name: string;
@@ -298,6 +301,125 @@ declare function graphitiMemoryAdapterIdentity(options: Pick<GraphitiMemoryAdapt
     backendRef: string;
 }): string;
 
+/**
+ * Deterministic uniform [0,1) for assignment draws. The sha256 key derivation is ours — it makes
+ * every draw replayable from the logged keys alone (design rule D5) — while the generator core is
+ * the substrate's `mulberry32` (@tangle-network/agent-eval statistics vocabulary), seeded with the
+ * top 32 bits of the digest, so the statistical machinery is reused rather than forked.
+ */
+declare function deterministicRng(key: string): number;
+/**
+ * Value-hash of the knobs that DEFINE the experiment (epsilon + watchlist, order-independent).
+ * Everything else on the config (callbacks, attribution stamps, privacy flags) does not change
+ * which assignments are drawn, so it stays out of the hash.
+ */
+declare function retrievalHoldoutConfigHash(config: Pick<RetrievalHoldoutConfig, 'epsilon' | 'watchlist'>): string;
+/**
+ * Pure per-call holdout: takes post-filter hits, returns delivered hits plus the log event
+ * and the next session state. Suppression only removes items (no backfill), and it happens
+ * before rendering so a drop session's context is byte-identical to a natural smaller retrieval.
+ */
+declare function applyRetrievalHoldout(hits: AgentMemoryHit[], config: RetrievalHoldoutConfig, ctx?: RetrievalHoldoutCallContext): RetrievalHoldoutResult;
+/**
+ * Logs a holdout event for adapter context paths that answer WITHOUT going through the
+ * search→render seam (Neo4j short-term conversation context, raw-string getContext results),
+ * so a consumer with a holdout configured still sees every call and the fraction-under-experiment
+ * denominator stays honest instead of silently losing these calls. No suppression is applied:
+ * dropping is only meaningful for retrieved memory hits, never for conversation context.
+ */
+declare function emitRetrievalHoldoutBypass(hits: AgentMemoryHit[], config: RetrievalHoldoutConfig, ctx: Omit<RetrievalHoldoutCallContext, 'session'>, bypassReason: RetrievalHoldoutBypassReason): RetrievalHoldoutEvent;
+/**
+ * Clears all sticky-session state. For test isolation and experiment-epoch boundaries;
+ * sessions in flight afterwards re-draw deterministically (same rng keys), so with the default
+ * rng a reset is invisible in the logs unless eligibility sets changed in between.
+ */
+declare function resetRetrievalHoldoutRegistry(): void;
+/**
+ * Convenience wrapper that threads session state internally, keyed by the VALUE of the
+ * experiment-defining knobs (configHash = epsilon + sorted watchlist) plus sessionId, so a fresh
+ * config object per call — the natural pattern when options are built inline — keeps full
+ * stickiness. Distinct experiments never share session state; two config objects with the same
+ * epsilon/watchlist are the same experiment by definition.
+ */
+declare function applySessionStickyRetrievalHoldout(hits: AgentMemoryHit[], config: RetrievalHoldoutConfig, ctx?: Omit<RetrievalHoldoutCallContext, 'session'>): RetrievalHoldoutResult;
+/** Aggregated view of one session's holdout exposure — the randomization unit of this design. */
+interface RetrievalHoldoutSessionSummary {
+    /** `${configHash}:${sessionIdHash}` — the trajectory's runId. */
+    runId: string;
+    configHash: string;
+    sessionIdHash: string;
+    sessionHoldout: boolean;
+    sessionTargetId: string | null;
+    /** Item actually suppressed in this session (equals sessionTargetId when a drop occurred). */
+    droppedId: string | null;
+    /** |watchlist ∩ E| at the session's first intersecting randomized call; 0 when never intersecting. */
+    firstCandidateCount: number;
+    /** Randomized retrieval calls observed for this session. */
+    callCount: number;
+    /** Adapter bypass calls observed for this session (logged, never randomized). */
+    bypassCallCount: number;
+    /** Session-level probability of the OBSERVED assignment under the behavior policy. */
+    behaviorProb: number;
+    /** True when the session's events disagree on arm or target (e.g. registry eviction re-draw). */
+    mixedExposure: boolean;
+    /** Present only on sessions surfaced in `excluded` rather than converted. */
+    exclusionReason?: 'mixed-exposure' | 'no-randomized-calls';
+}
+interface RetrievalHoldoutOffPolicyOptions {
+    /**
+     * Realized outcome PER SESSION, keyed by sessionIdHash — the session is the randomization
+     * unit, so rewards are per session, never per call. A missing entry for an included session
+     * throws: silently dropping unscored sessions would corrupt the estimator's denominator, so
+     * filter events to scored sessions upstream instead.
+     */
+    rewards: Record<string, number>;
+    /**
+     * Target-policy probability of the session's observed assignment. Default models the
+     * always-deliver-in-full policy: 1 for full-delivery sessions, 0 for drop sessions.
+     */
+    targetProb?: (session: RetrievalHoldoutSessionSummary) => number;
+    /** Per-session reward-model prediction enabling `doublyRobust`; when absent, qHat is null. */
+    qHat?: (session: RetrievalHoldoutSessionSummary) => number | null;
+}
+interface RetrievalHoldoutOffPolicyResult {
+    /** One trajectory per (configHash, sessionIdHash), never per call. */
+    trajectories: OffPolicyTrajectory[];
+    /** 1:1 with `trajectories` (same order): the diagnostic view of each converted session. */
+    sessions: RetrievalHoldoutSessionSummary[];
+    /** Sessions not converted because exposure was mixed or retrieval was bypassed. */
+    excluded: RetrievalHoldoutSessionSummary[];
+    /** Events with no sessionIdHash: outside session randomization, cannot join a reward. */
+    unattributableEvents: number;
+}
+/**
+ * Maps retrieval-dropout events onto one `OffPolicyTrajectory` per session for use with
+ * `inverseProbabilityWeighting`, `selfNormalizedImportanceWeighting`, or `doublyRobust`.
+ * Randomization occurs once per session: the arm is selected with P(dropout) = epsilon and
+ * the sticky target is drawn once,
+ * uniformly over watchlist ∩ E at the session's first intersecting call.
+ *
+ * Session-level action space and behavior probabilities (they sum to 1 by construction):
+ * - full delivery: `1 - epsilon`;
+ * - drop candidate i of k = |watchlist ∩ E_first|: `epsilon / k` each (the draw event's logged
+ *   `dropPropensity`);
+ * - sessions whose eligibility sets never intersect the watchlist: probability 1, because full
+ *   delivery was certain in either arm.
+ *
+ * Per-call events are repeated observations WITHIN one session-level randomization; per-call
+ * IPW is statistically invalid for this design (per-call "propensities" imply an action
+ * distribution summing to more than 1 and bias IPS downward). Calls where the sticky target is
+ * absent from E, and adapter bypass calls, fold into the session summary (callCount /
+ * bypassCallCount) instead of generating independent propensities.
+ *
+ * Join contract: `rewards` is keyed by `sessionIdHash` (sha256(sessionId) first 16 hex; compute
+ * the same prefix over the outcome table's session ids, or log with
+ * `includePlaintextIdentifiers: true` and join on raw ids upstream). Events are grouped per
+ * (configHash, sessionIdHash) so different experiment configs are never pooled. Mixed-exposure
+ * sessions (arm or target disagreement, e.g. after registry eviction) are excluded from the
+ * trajectories and surfaced in `excluded` for analysis.
+ */
+declare function toOffPolicyTrajectory(events: RetrievalHoldoutEvent[], options: RetrievalHoldoutOffPolicyOptions): RetrievalHoldoutOffPolicyResult;
+
 interface AgentMemoryImprovementSeed<TConfig> {
     config: TConfig;
     track: string;
@@ -420,6 +542,7 @@ interface RunAgentMemoryImprovementResult<TConfig> {
     totalCostUsd: number;
     resultJsonPath: string;
 }
+
 /** Searches branchable memory configurations and activates only a fresh holdout win. */
 declare function runAgentMemoryImprovement<TConfig>(options: RunAgentMemoryImprovementOptions<TConfig>): Promise<RunAgentMemoryImprovementResult<TConfig>>;
 
@@ -580,4 +703,4 @@ declare function memoryWriteResultToSourceRecord(result: AgentMemoryWriteResult,
     scope?: AgentMemoryScope;
 }): SourceRecord;
 
-export { AgentMemoryAcquireRunLease, type AgentMemoryActivation, type AgentMemoryActivationDriver, AgentMemoryAdapter, type AgentMemoryAttemptEvent, type AgentMemoryBranch, type AgentMemoryBranchLifetime, type AgentMemoryBranchSnapshot, AgentMemoryContext, AgentMemoryControllerMode, type AgentMemoryDimensionComparison, type AgentMemoryExperimentCandidate, type AgentMemoryExperimentRankingRow, type AgentMemoryExperimentRunLease, type AgentMemoryGovernor, AgentMemoryHit, AgentMemoryHitSchema, type AgentMemoryImprovementRunLease, type AgentMemoryImprovementSeed, type AgentMemoryJournalEntry, AgentMemoryKindSchema, AgentMemoryLifecycleTimeoutError, AgentMemoryLifecycleUnsafeError, type AgentMemoryPromotionDecision, AgentMemoryRunLease, AgentMemoryScope, AgentMemoryScopeSchema, AgentMemorySearchOptions, type AgentMemorySequence, type AgentMemorySequenceArtifact, type AgentMemorySequenceProbe, type AgentMemorySequenceProbeResult, type AgentMemorySequenceScenario, type AgentMemorySequenceStep, type AgentMemorySharingPolicy, type AgentMemoryVisibility, AgentMemoryWriteInput, AgentMemoryWriteInputSchema, AgentMemoryWriteResult, type BuildAgentMemorySequencesFromBenchmarkCasesOptions, type CreateAgentMemoryBranchOptions, DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, type ForkAgentMemoryBranchSnapshotOptions, type GraphitiMcpClientLike, type GraphitiMemoryAdapterOptions, type GraphitiToolNames, type Mem0ClientLike, type Mem0ClientMode, type Mem0MemoryAdapterOptions, type Neo4jAgentMemoryAdapterOptions, type RunAgentMemoryExperimentOptions, type RunAgentMemoryExperimentResult, type RunAgentMemoryImprovementOptions, type RunAgentMemoryImprovementResult, agentMemorySequenceJudge, buildAgentMemorySequenceScenarios, buildAgentMemorySequencesFromBenchmarkCases, createAgentMemoryBranch, createGraphitiMemoryAdapter, createMem0MemoryAdapter, createMemoryExecutionPool, createNeo4jAgentMemoryAdapter, defaultGetMemoryContext, forkAgentMemoryBranchSnapshot, graphitiMemoryAdapterIdentity, mem0MemoryAdapterIdentity, memoryHitToSourceRecord, memoryRecoveryDelayMs, memoryWriteResultToSourceRecord, renderMemoryContext, resolveMemoryCleanupTimeoutMs, runAgentMemoryExperiment, runAgentMemoryImprovement, runBoundedMemoryLifecycle, sleepForMemoryRecovery };
+export { AgentMemoryAcquireRunLease, type AgentMemoryActivation, type AgentMemoryActivationDriver, AgentMemoryAdapter, type AgentMemoryAttemptEvent, type AgentMemoryBranch, type AgentMemoryBranchLifetime, type AgentMemoryBranchSnapshot, AgentMemoryContext, AgentMemoryControllerMode, type AgentMemoryDimensionComparison, type AgentMemoryExperimentCandidate, type AgentMemoryExperimentRankingRow, type AgentMemoryExperimentRunLease, type AgentMemoryGovernor, AgentMemoryHit, AgentMemoryHitSchema, type AgentMemoryImprovementRunLease, type AgentMemoryImprovementSeed, type AgentMemoryJournalEntry, AgentMemoryKindSchema, AgentMemoryLifecycleTimeoutError, AgentMemoryLifecycleUnsafeError, type AgentMemoryPromotionDecision, AgentMemoryRunLease, AgentMemoryScope, AgentMemoryScopeSchema, AgentMemorySearchOptions, type AgentMemorySequence, type AgentMemorySequenceArtifact, type AgentMemorySequenceProbe, type AgentMemorySequenceProbeResult, type AgentMemorySequenceScenario, type AgentMemorySequenceStep, type AgentMemorySharingPolicy, type AgentMemoryVisibility, AgentMemoryWriteInput, AgentMemoryWriteInputSchema, AgentMemoryWriteResult, type BuildAgentMemorySequencesFromBenchmarkCasesOptions, type CreateAgentMemoryBranchOptions, DEFAULT_MEMORY_CLEANUP_TIMEOUT_MS, type ForkAgentMemoryBranchSnapshotOptions, type GraphitiMcpClientLike, type GraphitiMemoryAdapterOptions, type GraphitiToolNames, type Mem0ClientLike, type Mem0ClientMode, type Mem0MemoryAdapterOptions, type Neo4jAgentMemoryAdapterOptions, RetrievalHoldoutBypassReason, RetrievalHoldoutCallContext, RetrievalHoldoutConfig, RetrievalHoldoutEvent, type RetrievalHoldoutOffPolicyOptions, type RetrievalHoldoutOffPolicyResult, RetrievalHoldoutResult, type RetrievalHoldoutSessionSummary, type RunAgentMemoryExperimentOptions, type RunAgentMemoryExperimentResult, type RunAgentMemoryImprovementOptions, type RunAgentMemoryImprovementResult, agentMemorySequenceJudge, applyRetrievalHoldout, applySessionStickyRetrievalHoldout, buildAgentMemorySequenceScenarios, buildAgentMemorySequencesFromBenchmarkCases, createAgentMemoryBranch, createGraphitiMemoryAdapter, createMem0MemoryAdapter, createMemoryExecutionPool, createNeo4jAgentMemoryAdapter, defaultGetMemoryContext, deterministicRng, emitRetrievalHoldoutBypass, forkAgentMemoryBranchSnapshot, graphitiMemoryAdapterIdentity, mem0MemoryAdapterIdentity, memoryHitToSourceRecord, memoryRecoveryDelayMs, memoryWriteResultToSourceRecord, renderMemoryContext, resetRetrievalHoldoutRegistry, resolveMemoryCleanupTimeoutMs, retrievalHoldoutConfigHash, runAgentMemoryExperiment, runAgentMemoryImprovement, runBoundedMemoryLifecycle, sleepForMemoryRecovery, toOffPolicyTrajectory };

package/dist/memory/index.js

@@ -24,7 +24,7 @@ import {
   runAgentMemoryExperiment,
   runAgentMemoryImprovement,
   toOffPolicyTrajectory
-} from "../chunk-UWOTQNBI.js";
+} from "../chunk-CPMLJYA3.js";
 import {
   AgentMemoryLifecycleTimeoutError,
   AgentMemoryLifecycleUnsafeError,
@@ -37,7 +37,7 @@ import {
   resolveMemoryCleanupTimeoutMs,
   runBoundedMemoryLifecycle,
   sleepForMemoryRecovery
-} from "../chunk-DW6APRTX.js";
+} from "../chunk-BBCIB4UL.js";
 import "../chunk-DQ3PDMDP.js";
 import "../chunk-YMKHCTS2.js";
 export {

package/dist/sources/index.d.ts

@@ -15,9 +15,9 @@
  * Sources MUST be pure with respect to local filesystem state outside the
  * cache directory the caller hands them — they read remote authorities and
  * return data. They MUST mark `verifiable: false` on any fragment they could
- * not authenticate (block page, 4xx, parse failure) rather than silently
- * substituting empty/partial content. The control loop downstream uses
- * `verifiable` to refuse promotion of un-grounded content.
+ * not fetch and extract (block page, 4xx, parse failure) rather than silently
+ * substituting empty or partial content. The control loop downstream uses
+ * `verifiable` to refuse promotion of unusable content.
  *
  * @stable
  */
@@ -77,10 +77,11 @@ interface FragmentProvenance {
      */
     jurisdiction?: string;
     /**
-     * True iff the source could authenticate the fetched content (HTTP 200,
-     * expected selectors present, parse succeeded). False on any block page,
-     * rate-limit response, 4xx/5xx, or selector miss. Consumers MUST refuse
-     * to promote `verifiable: false` fragments into citable knowledge.
+     * True iff the configured URL returned an acceptable response and the
+     * expected content was extracted. False on a block page, rate-limit
+     * response, 4xx/5xx, or selector miss. This is not publisher authentication
+     * or cryptographic content verification. Consumers MUST refuse to promote
+     * `verifiable: false` fragments into citable knowledge.
      */
     verifiable: boolean;
     /** If `verifiable === false`, the reason — surfaced to operators. */
@@ -222,33 +223,16 @@ declare function extractLinks(html: string, hrefPattern: RegExp, baseUrl: string
 }[];
 
 /**
- * Polite HTTP fetcher used by every shipped source.
+ * Polite HTTP fetcher shared by remote sources.
  *
- * Three invariants this enforces — each was a bug found while wiring real
- * authorities; do not regress:
- *
- *   1. Per-host throttling. Cornell LII serves under 1 req/s/origin
- *      politely and will start serving block pages above that. The lock
- *      is per-host (`hostThrottle`) rather than per-source so that two
- *      independent sources targeting the same authority still cooperate.
- *
- *   2. On-disk content cache keyed by URL. Production sources are called
- *      from a cron loop; without a cache, every run re-hits the same
- *      pages and inflates change-detection false-positives (the authority
- *      occasionally serves slightly different boilerplate). The cache is
- *      content-addressed by URL, not by ETag — authorities like IRS.gov
- *      do not consistently send ETag/Last-Modified.
- *
- *   3. Block-page detection on success. A 200 with a captcha body still
- *      means "we couldn't authenticate." Sources downstream rely on
- *      `verifiable` to refuse promotion — losing that signal because the
- *      fetcher said "well, the status code was 200" is the bug class
- *      this exists to prevent.
- *
- * @stable
+ * Independent sources share a per-origin throttle because rate-limited sites
+ * may return block pages instead of 429 responses. Responses are cached by URL
+ * because many publishers omit reliable ETag and Last-Modified headers. Bodies
+ * are checked even after a 2xx response because captcha and block pages often
+ * use successful status codes.
  */
 /** User-Agent string sent on every outbound request. */
-declare const POLITE_USER_AGENT = "agent-knowledge/0.2.0 (+https://github.com/tangle-network/agent-knowledge)";
+declare const POLITE_USER_AGENT = "agent-knowledge (+https://github.com/tangle-network/agent-knowledge)";
 /** Minimum gap between successive requests to the same origin (ms). */
 declare const MIN_REQUEST_GAP_MS = 1000;
 /** Maximum response body we will buffer in memory (bytes). */
@@ -257,7 +241,7 @@ interface PoliteFetchOptions {
     signal?: AbortSignal;
     cacheDir?: string;
     /**
-     * Cache age beyond which we re-fetch. Default 1 hour — long enough to
+     * Cache age beyond which we re-fetch. Default 1 hour, long enough to
      * batch a cron sweep across many selectors, short enough that hourly
      * authoritative-page changes get picked up next tick.
      */
@@ -291,7 +275,7 @@ interface PoliteFetchResult {
 }
 /**
  * Fetch one URL with per-host throttling, on-disk cache, and block-page
- * detection. Never throws on network/HTTP failure — returns a result with
+ * detection. Never throws on network/HTTP failure. It returns a result with
  * `verifiable: false` and `unverifiableReason` set so the caller can decide
  * whether to skip, retry, or surface.
  *

package/dist/sources/index.js

@@ -13,7 +13,7 @@ import {
   innerHtmlById,
   looksLikeBlockPage,
   politeFetch
-} from "../chunk-WCYW2GDA.js";
+} from "../chunk-MYFM6LKH.js";
 import "../chunk-YMKHCTS2.js";
 export {
   IRS_DIMENSION_HINTS,