@myagentroam/agent 0.11.33 → 0.11.34

package/dist/agent-core/runtime/compaction/smart.js

@@ -1,59 +0,0 @@
-import { MarAgentError } from '../../error.js';
-import { compactSummaryFromCheckpoint } from '../../session/store/execution-state.js';
-export const SMART_COMPACTION_MARKER = '<mar_runtime>\n  <smart_compaction>For this message only, smart_compact may be considered at a clear transition into sustained new work, when the previous phase is largely complete and its details have low continuation value.</smart_compaction>\n</mar_runtime>';
-/** A measured watermark, not the stricter native-request budget calibration. */
-export function latestSmartContextTokens(records, modelId, contextWindowTokens) {
-    let tokens;
-    let matchingModel = false;
-    for (const record of records) {
-        const payload = record.payload;
-        if (compactSummaryFromCheckpoint(record) !== undefined) {
-            tokens = undefined;
-            // A sliced checkpoint does not prove the input window used by later usage.
-            matchingModel = false;
-        }
-        if (record.type === 'context.gc.completed')
-            tokens = undefined;
-        if (record.type === 'execution.header' && payload.mode !== 'compact') {
-            matchingModel =
-                payload.modelId === modelId && payload.contextWindowTokens === contextWindowTokens;
-            if (!matchingModel)
-                tokens = undefined;
-        }
-        if (matchingModel && payload.type === 'usage.updated' && payload.purpose !== 'compact') {
-            const value = payload.contextInputTokens ?? payload.inputTokens;
-            if (typeof value === 'number' && Number.isSafeInteger(value) && value >= 0)
-                tokens = value;
-        }
-    }
-    return tokens;
-}
-/** Only provider views receive the marker; durable message content stays unchanged. */
-export function projectSmartCompactionMessage(message) {
-    if (message.role !== 'user' ||
-        message.contextKind !== undefined ||
-        !message.metadata?.smartCompaction)
-        return message;
-    const suffix = '\n\n' + SMART_COMPACTION_MARKER;
-    return {
-        ...message,
-        content: message.content + suffix,
-        ...(message.textBlocks ? { textBlocks: [...message.textBlocks, { text: suffix }] } : {})
-    };
-}
-export function requestSmartCompaction(input, start) {
-    if (!input?.eligible)
-        throw new MarAgentError('MAR_AGENT_SMART_COMPACT_DENIED', 'The current user input is not eligible for Smart Compaction.');
-    if ('error' in input)
-        throw input.error;
-    if (input.requested)
-        return;
-    input.requested = true;
-    try {
-        start();
-    }
-    catch (error) {
-        input.error = error;
-        throw error;
-    }
-}

package/dist/agent-core/runtime/context/contextual-blocks.d.ts

@@ -1,30 +0,0 @@
-import type { ModelContextualBlock, ModelMessage, ModelTextBlock } from '../../model/contracts.js';
-import type { CorePromptPart } from '../../extensions/prompt-composition.js';
-export interface ContextualPart {
-    id: string;
-    source: ModelContextualBlock['source'];
-    authority: ModelContextualBlock['authority'];
-    content: string;
-    textBlocks?: readonly ModelTextBlock[];
-}
-export declare function contextualBlock(part: ContextualPart, kind: string, operation?: ModelContextualBlock['operation']): ModelContextualBlock;
-/** Keep arbitrary whole-string middleware and explicit cache scopes lossless. */
-export declare function splitContextualPrompt(composed: {
-    text: string;
-    blocks?: readonly ModelTextBlock[];
-    sections?: readonly CorePromptPart[];
-}): {
-    system: string;
-    systemBlocks?: readonly ModelTextBlock[];
-    parts: ContextualPart[];
-};
-interface ContextualChange {
-    part: ContextualPart;
-    block: ModelContextualBlock;
-    content: string;
-    textBlocks?: readonly ModelTextBlock[];
-}
-export declare function contextualChanges(previous: readonly ContextualPart[], current: readonly ContextualPart[]): ContextualChange[];
-/** Compact reuses a sent prefix when possible, but fallback evidence excludes private state. */
-export declare function projectCompactPromptMessages(messages: readonly ModelMessage[], parts: readonly ContextualPart[], previous: readonly ContextualPart[]): ModelMessage[];
-export {};

package/dist/agent-core/runtime/context/contextual-blocks.js

@@ -1,146 +0,0 @@
-import { createHash } from 'node:crypto';
-import { resolveModelTextBlocks } from '../../model/text-blocks.js';
-import { renderPromptSections } from '../../extensions/prompt-composition.js';
-export function contextualBlock(part, kind, operation = 'replace') {
-    return {
-        id: part.id,
-        kind,
-        source: part.source,
-        authority: part.authority,
-        operation,
-        revision: createHash('sha256')
-            .update(JSON.stringify({
-            id: part.id,
-            source: part.source,
-            authority: part.authority,
-            content: part.content,
-            textBlocks: part.textBlocks,
-            operation
-        }))
-            .digest('hex')
-    };
-}
-const CORE_IDS = new Set([
-    'core:identity',
-    'core:instruction-priority',
-    'core:workspace-discipline',
-    'core:workflow',
-    'core:interaction',
-    'core:safety',
-    'core:output-style'
-]);
-const SDK_CONTEXTUAL_IDS = new Set([
-    'core:environment-rules',
-    'core:tools',
-    'core:long-running',
-    'core:mode',
-    'core:compaction',
-    'core:subagent',
-    'core:skill-catalog',
-    'core:child-instructions'
-]);
-/** Keep arbitrary whole-string middleware and explicit cache scopes lossless. */
-export function splitContextualPrompt(composed) {
-    const sections = composed.sections;
-    if (!sections ||
-        !sections.some((part) => CORE_IDS.has(part.id)) ||
-        composed.blocks !== undefined ||
-        renderPromptSections(sections) !== composed.text)
-        return {
-            system: composed.text,
-            ...(composed.blocks === undefined ? {} : { systemBlocks: composed.blocks }),
-            parts: []
-        };
-    let dynamicSeen = false;
-    for (const section of sections) {
-        if (!section.text)
-            continue;
-        if (!CORE_IDS.has(section.id))
-            dynamicSeen = true;
-        else if (dynamicSeen)
-            return { system: composed.text, parts: [] };
-    }
-    return {
-        system: renderPromptSections(sections.filter((part) => CORE_IDS.has(part.id))),
-        parts: sections.flatMap((section) => {
-            if (CORE_IDS.has(section.id) || !section.text)
-                return [];
-            return [
-                {
-                    id: section.id,
-                    source: section.id === 'core:caller-instructions'
-                        ? 'host'
-                        : SDK_CONTEXTUAL_IDS.has(section.id)
-                            ? 'sdk'
-                            : 'extension',
-                    authority: 'instruction',
-                    content: section.text
-                }
-            ];
-        })
-    };
-}
-export function contextualChanges(previous, current) {
-    const before = new Map(previous.map((part) => [part.id, part]));
-    const after = new Set(current.map((part) => part.id));
-    // A reorder changes instruction precedence even when each text is unchanged.
-    const retainedBefore = previous.filter((part) => after.has(part.id)).map((part) => part.id);
-    const appendedOrder = [
-        ...retainedBefore,
-        ...current.filter((part) => !before.has(part.id)).map((part) => part.id)
-    ];
-    const reordered = JSON.stringify(appendedOrder) !== JSON.stringify(current.map((part) => part.id));
-    const changes = [];
-    for (const part of previous) {
-        if (after.has(part.id))
-            continue;
-        const { textBlocks: _blocks, ...retained } = part;
-        const removed = { ...retained, content: '' };
-        const block = contextualBlock(removed, 'instruction', 'remove');
-        changes.push({ part: removed, block, content: renderContextualChange(block, '') });
-    }
-    for (const part of current) {
-        const block = contextualBlock(part, 'instruction');
-        const prior = before.get(part.id);
-        if (!reordered && prior && contextualBlock(prior, 'instruction').revision === block.revision)
-            continue;
-        const content = renderContextualChange(block, part.content);
-        changes.push({
-            part,
-            block,
-            content,
-            ...(part.textBlocks === undefined
-                ? {}
-                : {
-                    textBlocks: [
-                        { text: content.slice(0, content.length - part.content.length) },
-                        ...resolveModelTextBlocks(part.content, part.textBlocks)
-                    ]
-                })
-        });
-    }
-    return changes;
-}
-function renderContextualChange(block, content) {
-    const id = JSON.stringify(block.id);
-    const action = block.operation === 'remove'
-        ? `Remove only the previous contextual instruction block with id ${id}. Other instructions and user requests remain in effect.`
-        : `This is the current complete contextual instruction block with id ${id}. It replaces only earlier versions of the same block.`;
-    return `# Contextual instruction ${id}\n${action}\n${content}`;
-}
-/** Compact reuses a sent prefix when possible, but fallback evidence excludes private state. */
-export function projectCompactPromptMessages(messages, parts, previous) {
-    const baseline = messages.some((message) => message.contextualBlock?.authority === 'instruction')
-        ? previous
-        : [];
-    const additions = contextualChanges(baseline, parts).map(({ content, block, textBlocks }) => ({
-        role: 'user',
-        content,
-        contextKind: 'contextual',
-        contextualBlock: block,
-        ...(textBlocks === undefined ? {} : { textBlocks })
-    }));
-    const control = messages.findIndex((message) => message.contextKind === 'compact_control');
-    const index = control < 0 ? messages.length : control;
-    return [...messages.slice(0, index), ...additions, ...messages.slice(index)];
-}

package/dist/agent-core/runtime/context/environment.d.ts

@@ -1,5 +0,0 @@
-import type { ModelMessage } from '../../model/contracts.js';
-import type { EnvironmentContextState } from './contracts.js';
-export declare function restoreEnvironmentState(payload: unknown): EnvironmentContextState | undefined;
-export declare function environmentContextUpdate(current: EnvironmentContextState, previous?: EnvironmentContextState, contextualEntries?: readonly string[]): ModelMessage | undefined;
-export declare function currentLocalTimeContext(instant?: Date, timezone?: string): Pick<EnvironmentContextState, 'currentDate' | 'timezone'>;

package/dist/agent-core/runtime/context/gc-runtime.d.ts

@@ -1,38 +0,0 @@
-import type { ClientToolDefinition, ModelMessage, ModelUsage } from '../../model/contracts.js';
-import { type ContextGcPlatform } from '../../session/context-gc-checkpoint.js';
-import type { SessionStore, SessionRecord } from '../../session/store/contracts.js';
-import { type ContextProjection } from './projection.js';
-export interface ContextGcRuntimeInput {
-    readonly inlineMedia?: import('../../session/inline-media.js').InlineMediaGcCandidate | undefined;
-    readonly store: SessionStore;
-    readonly sessionId: string;
-    readonly records?: readonly SessionRecord[];
-    readonly mediaView?: (messages: readonly ModelMessage[]) => readonly ModelMessage[];
-    readonly system: string;
-    readonly tools: readonly ClientToolDefinition[];
-    readonly modelId: string;
-    readonly modelProtocol?: string;
-    readonly responsesConfigurationUpdates?: boolean;
-    readonly contextWindowTokens: number;
-    readonly usage: ModelUsage;
-    readonly workspace: string;
-    readonly platform: ContextGcPlatform;
-    readonly activeProcessIds?: ReadonlySet<string>;
-    readonly getActiveProcessIds?: () => Promise<ReadonlySet<string>>;
-}
-export interface ContextGcCommitResult {
-    readonly records: readonly SessionRecord[];
-    readonly projection: ContextProjection;
-}
-/** Only scheduling metadata survives a call; records and validation caches do not. */
-export declare class ContextGcRuntime {
-    #private;
-    reset(): void;
-    run(input: ContextGcRuntimeInput): Promise<ContextGcCommitResult | false>;
-}
-/**
- * Runs the deterministic planner and commits its checkpoint. Planning and
- * commit failures are opportunistic no-ops unless the checkpoint is confirmed
- * durable after an ambiguous append result.
- */
-export declare function tryCommitContextGc(input: ContextGcRuntimeInput): Promise<ContextGcCommitResult | false>;

package/dist/agent-core/runtime/context/gc-tokens.d.ts

@@ -1,25 +0,0 @@
-import type { ClientToolDefinition, ModelMessage } from '../../model/contracts.js';
-export { MODEL_TOKEN_ESTIMATOR as CONTEXT_GC_TOKEN_ESTIMATOR } from '../token-budget.js';
-interface TokenContext {
-    readonly modelId: string;
-    readonly modelProtocol?: string;
-    readonly responsesConfigurationUpdates?: boolean;
-    readonly system: string;
-    readonly tools: readonly ClientToolDefinition[];
-    readonly messages?: readonly ModelMessage[];
-    readonly tokenCache?: Map<string, number>;
-}
-/** Uses Responses lowering, including native alias and cross-model filtering. */
-export declare function contextGcTokenEntries(input: TokenContext, messages: readonly ModelMessage[]): {
-    tokens: number;
-    key: string;
-    text: string;
-}[];
-/** Cancel identical entries, including multiplicity, before estimating the difference. */
-export declare function contextGcReclaimedTokens(input: TokenContext, before: readonly ModelMessage[], after: readonly ModelMessage[]): number;
-export declare function contextGcPrefixTokens(input: TokenContext): number;
-export declare function contextGcMessageTokens(input: TokenContext, messages: readonly ModelMessage[]): number;
-export declare function contextGcCacheImpact(input: TokenContext, before: readonly ModelMessage[], after: readonly ModelMessage[], cacheRead: number, reclaimedTokens: number): {
-    preservedCachedPrefixTokens: number;
-    reclaimedCachedTokens: number;
-};

package/dist/agent-core/runtime/context/gc-tokens.js

@@ -1,103 +0,0 @@
-import { openAiInput } from '../../model/openai-responses.js';
-import { countModelTokens } from '../token-budget.js';
-import { observationModelText } from '../../tools/code-mode/observations.js';
-export { MODEL_TOKEN_ESTIMATOR as CONTEXT_GC_TOKEN_ESTIMATOR } from '../token-budget.js';
-/** Uses Responses lowering, including native alias and cross-model filtering. */
-export function contextGcTokenEntries(input, messages) {
-    return serializedEntries(input, messages).map((entry) => ({
-        ...entry,
-        tokens: tokensFor(input, entry.text)
-    }));
-}
-function serializedEntries(input, messages) {
-    // Media bytes have a separate budget. Keep identity for cache boundaries without
-    // loading resources or counting base64 payloads as text tokens.
-    messages = messages.map((message) => message.images?.length
-        ? {
-            ...message,
-            images: message.images.map((image) => ({
-                mimeType: image.mimeType,
-                url: image.resourceId
-                    ? `https://mar.invalid/resource/${image.resourceId}`
-                    : (image.url ?? 'https://mar.invalid/inline-image')
-            }))
-        }
-        : message);
-    const responses = input.modelProtocol === 'OPENAI_RESPONSES' ||
-        (input.modelProtocol === undefined &&
-            (input.messages ?? messages).some((message) => message.provider === 'OPENAI_RESPONSES'));
-    const values = responses
-        ? openAiInput(messages, undefined, input.modelId, true, input.responsesConfigurationUpdates !== false)
-        : messages
-            .filter((message) => message.role !== 'provider' ||
-            (message.provider === 'ANTHROPIC_MESSAGES' && message.providerModelId === input.modelId))
-            .map((original) => {
-            const { observations: _observations, observationId: _observationId, ...message } = original;
-            const content = original.role === 'tool' ? observationModelText(original) : undefined;
-            return content === undefined ? message : { ...message, content };
-        });
-    return values.map((value, index) => {
-        const item = value;
-        const callId = item.call_id ?? item.callId;
-        const output = item.role === 'tool' ||
-            item.type === 'function_call_output' ||
-            item.type === 'custom_tool_call_output';
-        const key = typeof callId === 'string'
-            ? `${output ? 'output' : 'input'}:${callId}`
-            : typeof item.id === 'string'
-                ? `id:${item.id}`
-                : `index:${index}`;
-        const text = stableJson(value);
-        return { key, text };
-    });
-}
-/** Cancel identical entries, including multiplicity, before estimating the difference. */
-export function contextGcReclaimedTokens(input, before, after) {
-    const counts = new Map();
-    for (const entry of serializedEntries(input, before))
-        counts.set(entry.text, (counts.get(entry.text) ?? 0) + 1);
-    for (const entry of serializedEntries(input, after))
-        counts.set(entry.text, (counts.get(entry.text) ?? 0) - 1);
-    let reclaimed = 0;
-    for (const [text, count] of counts)
-        if (count !== 0)
-            reclaimed += count * tokensFor(input, text);
-    return Math.max(0, reclaimed);
-}
-export function contextGcPrefixTokens(input) {
-    return tokensFor(input, stableJson({ system: input.system, tools: input.tools }));
-}
-export function contextGcMessageTokens(input, messages) {
-    return contextGcTokenEntries(input, messages).reduce((sum, entry) => sum + entry.tokens, 0);
-}
-export function contextGcCacheImpact(input, before, after, cacheRead, reclaimedTokens) {
-    const afterByKey = new Map(contextGcTokenEntries(input, after).map((entry) => [entry.key, entry]));
-    let offset = contextGcPrefixTokens(input);
-    let earliest = cacheRead;
-    let reclaimedCachedTokens = 0;
-    for (const entry of contextGcTokenEntries(input, before)) {
-        const replacement = afterByKey.get(entry.key);
-        if (entry.text !== replacement?.text) {
-            earliest = Math.min(earliest, offset);
-            reclaimedCachedTokens += Math.min(Math.max(0, entry.tokens - (replacement?.tokens ?? 0)), Math.max(0, cacheRead - offset));
-        }
-        offset += entry.tokens;
-    }
-    return {
-        preservedCachedPrefixTokens: Math.max(0, Math.min(cacheRead, earliest)),
-        reclaimedCachedTokens: Math.min(reclaimedTokens, reclaimedCachedTokens)
-    };
-}
-function tokensFor(input, text) {
-    const cached = input.tokenCache?.get(text);
-    if (cached !== undefined)
-        return cached;
-    const tokens = countModelTokens(text);
-    input.tokenCache?.set(text, tokens);
-    return tokens;
-}
-function stableJson(value) {
-    return JSON.stringify(value, (_key, item) => item && typeof item === 'object' && !Array.isArray(item)
-        ? Object.fromEntries(Object.entries(item).sort(([a], [b]) => a.localeCompare(b)))
-        : item);
-}

package/dist/agent-core/runtime/context/gc.d.ts

@@ -1,75 +0,0 @@
-import type { ClientToolDefinition, ModelMessage, ModelUsage } from '../../model/contracts.js';
-import { ContextGcCheckpointCache, type ContextGcCheckpointDraft, type ContextGcEconomicsPolicy, type ContextGcMetrics, type ContextGcPlatform, type ContextGcReplacement } from '../../session/context-gc-checkpoint.js';
-import type { SessionRecord } from '../../session/store/index.js';
-export declare const CONTEXT_GC_POLICY: ContextGcEconomicsPolicy;
-interface ContextGcEconomicsInput {
-    readonly contextUsageTokens: number;
-    readonly reclaimedTokens: number;
-    readonly reclaimedCachedTokens: number;
-    readonly cacheReadTokens: number;
-    readonly preservedCachedPrefixTokens: number;
-    readonly compactDeferralCreditCostUnits: number;
-    readonly projectedRolloutsUntilCompactAfterGc: number;
-    readonly contextGrowthSampleCount: number;
-    readonly minimumGrossReductionRate?: number;
-    readonly minimumReclaimedTokens?: number;
-}
-export interface ContextGcEconomicsResult {
-    readonly cacheRebuildPenaltyCostUnits: number;
-    readonly requiredPositiveNetRollouts: number;
-    readonly requiredTargetRoiRollouts: number;
-    readonly expectedNetSavedCostUnits: number;
-    readonly cacheInvestmentRoi: number;
-    readonly grossReductionRate: number;
-    readonly passes: boolean;
-}
-export interface ContextGcPlan {
-    readonly stage: ContextGcMetrics['stage'];
-    readonly draft: ContextGcCheckpointDraft;
-    readonly metrics: ContextGcMetrics;
-}
-interface ContextGcCacheEconomicsProfile {
-    readonly reclaimedTokens: number;
-    readonly reclaimedCachedTokens: number;
-    readonly cacheRebuildPenaltyCostUnits: number;
-}
-export interface ContextGcInspection {
-    readonly plan?: ContextGcPlan;
-    readonly retryAfterRollouts?: number;
-}
-export interface ContextGcPlannerInput {
-    readonly inlineMedia?: import('../../session/inline-media.js').InlineMediaGcCandidate;
-    readonly records: readonly SessionRecord[];
-    readonly messages: readonly ModelMessage[];
-    readonly messageSources: readonly SessionRecord[];
-    readonly system: string;
-    readonly tools: readonly ClientToolDefinition[];
-    readonly modelId: string;
-    readonly modelProtocol?: string;
-    readonly responsesConfigurationUpdates?: boolean;
-    readonly contextWindowTokens: number;
-    readonly usage: ModelUsage;
-    readonly workspace: string;
-    readonly platform: ContextGcPlatform;
-    readonly activeProcessIds: ReadonlySet<string>;
-    readonly tokenCache?: Map<string, number>;
-    readonly checkpointCache?: ContextGcCheckpointCache;
-}
-export declare function evaluateContextGcEconomics(input: ContextGcEconomicsInput): ContextGcEconomicsResult;
-export declare function contextGcMinimumGrossReductionRate(usageRatio: number): number;
-export declare function contextGcMinimumReclaimedTokens(contextUsageTokens: number, contextWindowTokens: number): number;
-export declare function contextGcEligibleUsage(usage: ModelUsage, contextWindowTokens: number): number | undefined;
-export declare function planContextGc(input: ContextGcPlannerInput): ContextGcPlan | undefined;
-export declare function inspectContextGc(input: ContextGcPlannerInput): ContextGcInspection;
-export declare function contextGcMarginalCacheInvestmentPaysBack(current: ContextGcCacheEconomicsProfile, combined: ContextGcCacheEconomicsProfile): boolean;
-export declare function contextGcEarliestReplacementSequence(replacements: readonly ContextGcReplacement[]): number;
-export declare function contextGcImminentCompactAvoidanceCredit(input: {
-    readonly contextUsageTokens: number;
-    readonly contextWindowTokens: number;
-    readonly compactThresholdTokens: number;
-    readonly projectedTokensBeforeGc: number;
-    readonly projectedTokensAfterGc: number;
-    readonly contextGrowthP75Tokens: number;
-}): number;
-export declare function contextGcAppliedCompactCreditCostUnits(compactDeferralCreditCostUnits: number, imminentCompactAvoidanceCreditCostUnits: number): number;
-export {};