@dory-agentic/dory-agentic-sdk 0.2.0

package/dist/lfs/memoryParser.d.ts

@@ -0,0 +1,121 @@
+import type { AdaptiveMessage, MemorySnapshotRow, TurnMemorySnapshot } from './tokenCounter';
+export { collectScorableMessageIds } from "../history/messageManifest";
+/** All non-archived rows with IDs (for prompt listing). */
+export declare function collectActiveMessageIds(history: AdaptiveMessage[]): string[];
+/** Map agent output keys to exact IDs from history (fixes msg_1 vs msg_01; never by list position). */
+export declare function canonicalizeMessageIds(weights: AllocationMap, activeIds: Set<string>): {
+    canonical: AllocationMap;
+    invalidIds: string[];
+};
+/**
+ * Merge agent relevance % with referenced_message_ids.
+ * Cited IDs with no score get a fair share so used context is never left at 0%.
+ */
+export declare function mergeRelevanceWithReferences(agentPercents: AllocationMap, referencedIds: string[], activeIds: Set<string>): AllocationMap;
+/** Shared instructions for optimized-lane relevance % (server converts to credits). */
+export declare function buildRelevanceScoringInstructions(params: {
+    budget: number;
+    history: AdaptiveMessage[];
+}): string;
+export type AllocationMap = Record<string, number>;
+export type ContextShift = 'continue' | 'new_topic';
+export interface ParsedAgentOutput {
+    thinking: string;
+    response: string;
+    referencedIds: string[];
+    creditAllocation: AllocationMap;
+    contextShift: ContextShift;
+}
+/** Extract |||ALLOCATION:{...}||| from any text (response body or full JSON stream). */
+export declare function extractAllocation(content: string): AllocationMap;
+export declare function extractReferencedIds(content: string): string[];
+/** Map normalized 0–100% shares to credits that sum to budget (2 decimal places). */
+export declare function percentMapToCredits(normalizedPercents: AllocationMap, budget: number): AllocationMap;
+/**
+ * Agent sends relevance as percentages (0–100) per message ID.
+ * Values are normalized to sum to 100%, then converted to credits in the backend.
+ */
+export declare function normalizePercentagesToBudget(agentPercents: AllocationMap, budget: number, activeIds: Set<string>): {
+    rawPercents: AllocationMap;
+    normalizedPercents: AllocationMap;
+    credits: AllocationMap;
+    rawSum: number;
+    invalidIds: string[];
+};
+/** Distribute integer credits so they sum exactly to budget using relevance weights. */
+export declare function normalizeRelevanceToBudget(weights: AllocationMap, budget: number, activeIds: Set<string>): AllocationMap;
+export declare function parsePartialJson(jsonStr: string, isMmuActive?: boolean): ParsedAgentOutput;
+/** Search credit_allocation JSON field, response |||ALLOCATION||| block, then stream buffer. */
+export declare function extractAllocationFromSources(responseText: string, streamBuffer: string, parsedCreditAllocation?: AllocationMap): AllocationMap;
+export declare function sanitizeContent(content: string): string;
+export type MemoryRowInput = {
+    id: string;
+    role: string;
+    content: string;
+    tokenCount?: number;
+    forgetScore?: number;
+    decayApplied?: number;
+    isArchived?: boolean;
+};
+export declare function deriveMemoryStatus(id: string, referencedIds: string[], creditsApplied: number, forgetScore: number, decayApplied: number, forceDecayingIds?: Set<string>): MemorySnapshotRow['status'];
+export declare function buildTurnMemorySnapshot(params: {
+    turnBudget: number;
+    contextShift: ContextShift;
+    creditsConsumed: number;
+    agentAllocation: AllocationMap;
+    effectiveAllocation: AllocationMap;
+    usedFallback: boolean;
+    scaledAllocation: AllocationMap;
+    scale: number;
+    totalRequested: number;
+    referencedIds: string[];
+    messages: MemoryRowInput[];
+    estimateTokens: (text: string) => number;
+    /** Immediate predecessor of the outgoing message — always shown as DECAYING when decay applied. */
+    forceDecayingIds?: Set<string>;
+    invalidAgentIds?: string[];
+}): TurnMemorySnapshot;
+/** Turn agent relevance percentages into final credits for this round. */
+export declare function resolveTurnCredits(params: {
+    contextShift: ContextShift;
+    agentWeights: AllocationMap;
+    referencedIds: string[];
+    budget: number;
+    activeIds: Set<string>;
+    activeTurnId?: string | null;
+}): {
+    agentAllocation: AllocationMap;
+    effectiveAllocation: AllocationMap;
+    scaledAllocation: AllocationMap;
+    scale: number;
+    totalRequested: number;
+    usedFallback: boolean;
+    creditsConsumed: number;
+    invalidAgentIds: string[];
+};
+export declare function scaleAllocation(allocation: AllocationMap, budget: number, activeIds: Set<string>): {
+    validAllocation: AllocationMap;
+    scaledAllocation: AllocationMap;
+    scale: number;
+    totalRequested: number;
+};
+export declare function extractHydrationBeaconVariables(messages: AdaptiveMessage[], query?: string): string;
+/**
+ * Pre-flight speculative hydration scanner.
+ * Scans the user query for keywords that suggest a recall of archived data,
+ * then returns the list of long-term memory IDs to hydrate.
+ *
+ * This runs client-side *before* the LLM call to eliminate the "double query"
+ * penalty (where the model would otherwise need to call remind() then re-run).
+ */
+export declare function preFlightSpeculativeScan(userPrompt: string, longTermMemory: Record<string, AdaptiveMessage>): Promise<string[]>;
+/**
+ * Build an attention anchor beacon from hydrated long-term memory messages.
+ * Combines speculative hydration with the extraction of exact variable values
+ * to produce a pinned system block that guides the LLM's attention to the
+ * correct parameters.
+ *
+ * Returns empty string if no variables were found.
+ */
+export declare function buildAttentionAnchorBeacon(hydratedMsgs: AdaptiveMessage[]): string;
+//# sourceMappingURL=memoryParser.d.ts.map

package/dist/lfs/memoryParser.d.ts.map

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