@mnemonik/shared 7.51.0 → 7.57.0

package/dist/claudeProxySettings.d.ts

@@ -0,0 +1,45 @@
+export type ClaudeBaseUrlState = {
+    kind: 'absent';
+} | {
+    kind: 'value';
+    value: string;
+};
+export type ClaudeProxyStatus = 'on' | 'off' | 'custom' | 'not-paired' | 'invalid';
+export interface ClaudeProxySettingsOptions {
+    homeDir?: string;
+    settingsPath?: string;
+    configPath?: string;
+}
+export type ClaudeProxyPairingConfig = Record<string, unknown> & {
+    server: string;
+    proxyToken: string;
+};
+export interface ClaudeProxyMutationResult {
+    changed: boolean;
+    handoffCleanupUnconfirmed: boolean;
+}
+export interface ClaudeProxyOffResult extends ClaudeProxyMutationResult {
+    outcome: 'disabled' | 'already-off';
+}
+export interface ClaudeProxyOnResult extends ClaudeProxyMutationResult {
+    outcome: 'enabled' | 'already-on';
+}
+export declare class ClaudeProxyConflictError extends Error {
+    constructor();
+}
+export declare class ClaudeProxySettingsError extends Error {
+    constructor();
+}
+export declare class ClaudeProxyNotPairedError extends Error {
+    constructor();
+}
+export declare function buildClaudeProxyUrl(server: string, proxyToken: string): string;
+export declare function stageClaudeProxyPairingConfig(nextConfig: ClaudeProxyPairingConfig, options?: ClaudeProxySettingsOptions): Promise<void>;
+export declare function assertClaudeProxyCanBeConfigured(options?: ClaudeProxySettingsOptions): Promise<void>;
+export declare function configureClaudeProxy(server: string, proxyToken: string, options?: ClaudeProxySettingsOptions): Promise<ClaudeProxyMutationResult>;
+export declare function turnClaudeProxyOff(options?: ClaudeProxySettingsOptions): Promise<ClaudeProxyOffResult>;
+export declare function turnClaudeProxyOn(options?: ClaudeProxySettingsOptions): Promise<ClaudeProxyOnResult>;
+export declare function getClaudeProxyStatus(options?: ClaudeProxySettingsOptions): Promise<ClaudeProxyStatus>;
+export declare function formatClaudeProxyStatus(status: ClaudeProxyStatus): string;
+export declare function formatClaudeProxyCleanupWarning(result: ClaudeProxyMutationResult): string | null;
+//# sourceMappingURL=claudeProxySettings.d.ts.map

package/dist/claudeProxySettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeProxySettings.d.ts","sourceRoot":"","sources":["../src/claudeProxySettings.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvF,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,KAAK,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;AAEnF,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,yBAAyB,EAAE,OAAO,CAAC;CACpC;AAED,MAAM,WAAW,oBAAqB,SAAQ,yBAAyB;IACrE,OAAO,EAAE,UAAU,GAAG,aAAa,CAAC;CACrC;AAED,MAAM,WAAW,mBAAoB,SAAQ,yBAAyB;IACpE,OAAO,EAAE,SAAS,GAAG,YAAY,CAAC;CACnC;AA6BD,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,cAGC;CACF;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,cAGC;CACF;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,cAGC;CACF;AAsED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAgB9E;AA8ID,wBAAsB,6BAA6B,CACjD,UAAU,EAAE,wBAAwB,EACpC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED,wBAAsB,gCAAgC,CACpD,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,yBAAyB,CAAC,CAyBpC;AAED,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,oBAAoB,CAAC,CA0B/B;AAED,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,mBAAmB,CAAC,CA+B9B;AAED,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,iBAAiB,CAAC,CAe5B;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAazE;AAED,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,GAAG,IAAI,CAIhG"}

package/dist/claudeProxySettings.js

@@ -0,0 +1,375 @@
+import { dirname, join, resolve } from 'node:path';
+import { chmod, mkdir } from 'node:fs/promises';
+import { atomicWriteText, canonicalizeConfigTargets, installerConfigLockPath, readTextIfExists, withFileLocks, } from './settingsIo.js';
+const PROXY_TOKEN_PATTERN = /^pxt_[a-f0-9]{32}$/;
+export class ClaudeProxyConflictError extends Error {
+    constructor() {
+        super('Claude Code already has a base URL that does not match this paired device.');
+        this.name = 'ClaudeProxyConflictError';
+    }
+}
+export class ClaudeProxySettingsError extends Error {
+    constructor() {
+        super('Claude settings are invalid or unreadable.');
+        this.name = 'ClaudeProxySettingsError';
+    }
+}
+export class ClaudeProxyNotPairedError extends Error {
+    constructor() {
+        super('This device is not paired with Mnemonik. Run pairing first.');
+        this.name = 'ClaudeProxyNotPairedError';
+    }
+}
+function resolveHomeDirectory(env = process.env) {
+    const home = env.HOME?.trim() || env.USERPROFILE?.trim();
+    if (!home)
+        throw new ClaudeProxyNotPairedError();
+    return resolve(home);
+}
+function resolveBasePaths(options) {
+    const homeDir = resolve(options.homeDir ?? resolveHomeDirectory());
+    const configPath = resolve(options.configPath ?? join(homeDir, '.mnemonik', 'config.json'));
+    return { homeDir, configPath };
+}
+async function resolvePaths(options, basePaths = resolveBasePaths(options)) {
+    const requestedSettingsPath = resolve(options.settingsPath ?? join(basePaths.homeDir, '.claude', 'settings.json'));
+    const [settingsPath, configPath] = await canonicalizeConfigTargets([
+        requestedSettingsPath,
+        basePaths.configPath,
+    ]);
+    if (!settingsPath || !configPath)
+        throw new ClaudeProxySettingsError();
+    const runtimeParent = join(basePaths.homeDir, '.mnemonik', 'hooks');
+    return {
+        settingsPath,
+        configPath,
+        lockPath: installerConfigLockPath(settingsPath, runtimeParent),
+        configLockPath: installerConfigLockPath(configPath, runtimeParent),
+    };
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function parseSettingsRaw(raw) {
+    if (raw === null)
+        return { raw: null, value: {}, baseUrl: { kind: 'absent' } };
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new ClaudeProxySettingsError();
+    }
+    if (!isRecord(parsed))
+        throw new ClaudeProxySettingsError();
+    if (parsed.env === undefined)
+        return { raw, value: parsed, baseUrl: { kind: 'absent' } };
+    if (!isRecord(parsed.env))
+        throw new ClaudeProxySettingsError();
+    const baseUrl = parsed.env.ANTHROPIC_BASE_URL;
+    if (baseUrl === undefined)
+        return { raw, value: parsed, baseUrl: { kind: 'absent' } };
+    if (typeof baseUrl !== 'string' || baseUrl.length === 0) {
+        throw new ClaudeProxySettingsError();
+    }
+    return { raw, value: parsed, baseUrl: { kind: 'value', value: baseUrl } };
+}
+async function readSettings(settingsPath) {
+    try {
+        return parseSettingsRaw(await readTextIfExists(settingsPath));
+    }
+    catch (error) {
+        if (error instanceof ClaudeProxySettingsError)
+            throw error;
+        throw new ClaudeProxySettingsError();
+    }
+}
+export function buildClaudeProxyUrl(server, proxyToken) {
+    const trimmedServer = server.trim();
+    if (!trimmedServer || !PROXY_TOKEN_PATTERN.test(proxyToken)) {
+        throw new ClaudeProxyNotPairedError();
+    }
+    const proxyUrl = `${trimmedServer.replace(/\/$/, '')}/proxy/${proxyToken}`;
+    try {
+        const parsed = new URL(proxyUrl);
+        if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+            throw new ClaudeProxyNotPairedError();
+        }
+    }
+    catch (error) {
+        if (error instanceof ClaudeProxyNotPairedError)
+            throw error;
+        throw new ClaudeProxyNotPairedError();
+    }
+    return proxyUrl;
+}
+function parsePairedProxyConfig(raw) {
+    if (raw === null)
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (!isRecord(parsed) || typeof parsed.server !== 'string')
+        return null;
+    if (typeof parsed.proxyToken !== 'string')
+        return null;
+    const previousProxyToken = parsed.previousProxyToken;
+    if (previousProxyToken !== undefined &&
+        (typeof previousProxyToken !== 'string' || !PROXY_TOKEN_PATTERN.test(previousProxyToken))) {
+        return null;
+    }
+    try {
+        const normalizedPreviousToken = previousProxyToken && previousProxyToken !== parsed.proxyToken ? previousProxyToken : null;
+        return {
+            raw,
+            value: parsed,
+            server: parsed.server,
+            proxyToken: parsed.proxyToken,
+            previousProxyToken: normalizedPreviousToken,
+            proxyUrl: buildClaudeProxyUrl(parsed.server, parsed.proxyToken),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function readPairedProxyConfig(configPath) {
+    try {
+        return parsePairedProxyConfig(await readTextIfExists(configPath));
+    }
+    catch {
+        return null;
+    }
+}
+function managedProxyTokenForUrl(baseUrl, config) {
+    if (matchesProxyUrlForToken(baseUrl, config.server, config.proxyToken)) {
+        return config.proxyToken;
+    }
+    if (config.previousProxyToken &&
+        matchesProxyUrlForToken(baseUrl, config.server, config.previousProxyToken)) {
+        return config.previousProxyToken;
+    }
+    return null;
+}
+function matchesProxyUrlForToken(baseUrl, server, proxyToken) {
+    return (baseUrl === buildClaudeProxyUrl(server, proxyToken) ||
+        baseUrl === `${server}/proxy/${proxyToken}`);
+}
+function matchesManagedProxyUrl(baseUrl, config) {
+    return managedProxyTokenForUrl(baseUrl, config) !== null;
+}
+function serializeConfig(config) {
+    return `${JSON.stringify(config, null, 2)}\n`;
+}
+async function clearPreviousProxyToken(paths, config, expectedProxyToken) {
+    if (config.proxyToken !== expectedProxyToken || config.previousProxyToken === null)
+        return;
+    const nextConfig = { ...config.value };
+    delete nextConfig.previousProxyToken;
+    await atomicWriteText(paths.configPath, serializeConfig(nextConfig), config.raw, { mode: 0o600 });
+    await chmod(paths.configPath, 0o600);
+}
+async function tryClearPreviousProxyToken(paths, config, expectedProxyToken) {
+    try {
+        await clearPreviousProxyToken(paths, config, expectedProxyToken);
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
+function withProxyLocks(paths, action) {
+    return withFileLocks([paths.lockPath, paths.configLockPath], action);
+}
+function setBaseUrl(settings, next) {
+    const updated = { ...settings };
+    if (next.kind === 'value') {
+        const env = isRecord(settings.env) ? { ...settings.env } : {};
+        env.ANTHROPIC_BASE_URL = next.value;
+        updated.env = env;
+        return updated;
+    }
+    if (!isRecord(settings.env))
+        return updated;
+    const env = { ...settings.env };
+    delete env.ANTHROPIC_BASE_URL;
+    if (Object.keys(env).length === 0)
+        delete updated.env;
+    else
+        updated.env = env;
+    return updated;
+}
+function serializeSettings(settings) {
+    return `${JSON.stringify(settings, null, 2)}\n`;
+}
+async function writeBaseUrl(settingsPath, settings, next) {
+    await atomicWriteText(settingsPath, serializeSettings(setBaseUrl(settings.value, next)), settings.raw);
+}
+async function pairedConfigOrThrow(configPath) {
+    const config = await readPairedProxyConfig(configPath);
+    if (!config)
+        throw new ClaudeProxyNotPairedError();
+    return config;
+}
+export async function stageClaudeProxyPairingConfig(nextConfig, options = {}) {
+    const nextProxyUrl = buildClaudeProxyUrl(nextConfig.server, nextConfig.proxyToken);
+    const basePaths = resolveBasePaths(options);
+    await mkdir(dirname(basePaths.configPath), { recursive: true, mode: 0o700 });
+    await chmod(dirname(basePaths.configPath), 0o700);
+    const paths = await resolvePaths(options, basePaths);
+    await withProxyLocks(paths, async () => {
+        const currentRaw = await readTextIfExists(paths.configPath);
+        const currentConfig = parsePairedProxyConfig(currentRaw);
+        const settings = await readSettings(paths.settingsPath);
+        let previousProxyToken = null;
+        if (settings.baseUrl.kind === 'value') {
+            if (!currentConfig)
+                throw new ClaudeProxyConflictError();
+            previousProxyToken = managedProxyTokenForUrl(settings.baseUrl.value, currentConfig);
+            if (!previousProxyToken)
+                throw new ClaudeProxyConflictError();
+            if (settings.baseUrl.value === nextProxyUrl) {
+                previousProxyToken = null;
+            }
+            else if (!matchesProxyUrlForToken(settings.baseUrl.value, nextConfig.server, previousProxyToken)) {
+                throw new ClaudeProxyConflictError();
+            }
+            else if (previousProxyToken === nextConfig.proxyToken) {
+                previousProxyToken = null;
+            }
+        }
+        const serializedConfig = { ...nextConfig };
+        delete serializedConfig.previousProxyToken;
+        if (previousProxyToken)
+            serializedConfig.previousProxyToken = previousProxyToken;
+        await atomicWriteText(paths.configPath, serializeConfig(serializedConfig), currentRaw, {
+            mode: 0o600,
+        });
+        await chmod(paths.configPath, 0o600);
+    });
+}
+export async function assertClaudeProxyCanBeConfigured(options = {}) {
+    const paths = await resolvePaths(options);
+    return withProxyLocks(paths, async () => {
+        const config = await readPairedProxyConfig(paths.configPath);
+        const settings = await readSettings(paths.settingsPath);
+        if (settings.baseUrl.kind === 'value' &&
+            (!config || !matchesManagedProxyUrl(settings.baseUrl.value, config))) {
+            throw new ClaudeProxyConflictError();
+        }
+    });
+}
+export async function configureClaudeProxy(server, proxyToken, options = {}) {
+    const proxyUrl = buildClaudeProxyUrl(server, proxyToken);
+    const paths = await resolvePaths(options);
+    return withProxyLocks(paths, async () => {
+        const config = await pairedConfigOrThrow(paths.configPath);
+        if (config.proxyToken !== proxyToken || config.proxyUrl !== proxyUrl) {
+            throw new ClaudeProxyConflictError();
+        }
+        const settings = await readSettings(paths.settingsPath);
+        let changed = false;
+        if (settings.baseUrl.kind === 'value') {
+            if (!matchesManagedProxyUrl(settings.baseUrl.value, config)) {
+                throw new ClaudeProxyConflictError();
+            }
+            if (settings.baseUrl.value !== proxyUrl) {
+                await writeBaseUrl(paths.settingsPath, settings, { kind: 'value', value: proxyUrl });
+                changed = true;
+            }
+        }
+        else {
+            await writeBaseUrl(paths.settingsPath, settings, { kind: 'value', value: proxyUrl });
+            changed = true;
+        }
+        const handoffCleanupUnconfirmed = await tryClearPreviousProxyToken(paths, config, proxyToken);
+        return { changed, handoffCleanupUnconfirmed };
+    });
+}
+export async function turnClaudeProxyOff(options = {}) {
+    const basePaths = resolveBasePaths(options);
+    await pairedConfigOrThrow(basePaths.configPath);
+    const paths = await resolvePaths(options, basePaths);
+    return withProxyLocks(paths, async () => {
+        const config = await pairedConfigOrThrow(paths.configPath);
+        const settings = await readSettings(paths.settingsPath);
+        if (settings.baseUrl.kind === 'absent') {
+            const handoffCleanupUnconfirmed = await tryClearPreviousProxyToken(paths, config, config.proxyToken);
+            return { changed: false, outcome: 'already-off', handoffCleanupUnconfirmed };
+        }
+        if (!matchesManagedProxyUrl(settings.baseUrl.value, config)) {
+            throw new ClaudeProxyConflictError();
+        }
+        await writeBaseUrl(paths.settingsPath, settings, { kind: 'absent' });
+        const handoffCleanupUnconfirmed = await tryClearPreviousProxyToken(paths, config, config.proxyToken);
+        return { changed: true, outcome: 'disabled', handoffCleanupUnconfirmed };
+    });
+}
+export async function turnClaudeProxyOn(options = {}) {
+    const basePaths = resolveBasePaths(options);
+    await pairedConfigOrThrow(basePaths.configPath);
+    const paths = await resolvePaths(options, basePaths);
+    return withProxyLocks(paths, async () => {
+        const config = await pairedConfigOrThrow(paths.configPath);
+        const settings = await readSettings(paths.settingsPath);
+        if (settings.baseUrl.kind === 'value') {
+            if (settings.baseUrl.value === config.proxyUrl) {
+                const handoffCleanupUnconfirmed = await tryClearPreviousProxyToken(paths, config, config.proxyToken);
+                return { changed: false, outcome: 'already-on', handoffCleanupUnconfirmed };
+            }
+            if (!matchesManagedProxyUrl(settings.baseUrl.value, config)) {
+                throw new ClaudeProxyConflictError();
+            }
+        }
+        await writeBaseUrl(paths.settingsPath, settings, {
+            kind: 'value',
+            value: config.proxyUrl,
+        });
+        const handoffCleanupUnconfirmed = await tryClearPreviousProxyToken(paths, config, config.proxyToken);
+        return { changed: true, outcome: 'enabled', handoffCleanupUnconfirmed };
+    });
+}
+export async function getClaudeProxyStatus(options = {}) {
+    try {
+        const basePaths = resolveBasePaths(options);
+        if (!(await readPairedProxyConfig(basePaths.configPath)))
+            return 'not-paired';
+        const paths = await resolvePaths(options, basePaths);
+        return await withProxyLocks(paths, async () => {
+            const config = await readPairedProxyConfig(paths.configPath);
+            if (!config)
+                return 'not-paired';
+            const settings = await readSettings(paths.settingsPath);
+            if (settings.baseUrl.kind === 'absent')
+                return 'off';
+            return matchesManagedProxyUrl(settings.baseUrl.value, config) ? 'on' : 'custom';
+        });
+    }
+    catch {
+        return 'invalid';
+    }
+}
+export function formatClaudeProxyStatus(status) {
+    switch (status) {
+        case 'on':
+            return 'Mnemonik proxy is on and correctly configured.';
+        case 'off':
+            return 'Mnemonik proxy is off.';
+        case 'custom':
+            return 'Claude Code has a base URL that does not match this paired device.';
+        case 'not-paired':
+            return 'This device is not paired with Mnemonik.';
+        case 'invalid':
+            return 'Claude settings are invalid or unreadable.';
+    }
+}
+export function formatClaudeProxyCleanupWarning(result) {
+    return result.handoffCleanupUnconfirmed
+        ? 'Mnemonik could not confirm cleanup of the saved token handoff. The next proxy-changing command will check and retry it.'
+        : null;
+}
+//# sourceMappingURL=claudeProxySettings.js.map

package/dist/claudeProxySettings.js.map

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

package/dist/contextBudget.d.ts

@@ -3,26 +3,31 @@ export type ContextBudgetUnits = 'characters' | 'utf8-bytes';
 export interface ContextBudgetItem {
     /** Exact text emitted when the item fits in full. */
     text: string;
-    /** Stable envelope name used by continuation/not-reached pointers. */
+    /** Stable envelope name used for diagnostics only. Never emitted as a retrieval stub. */
     name: string;
     /** Memory identity when this item is one pointer-terminated memory precis. */
     memoryId?: string;
     /** Memory identities when one rendered envelope represents several memories. */
     memoryIds?: readonly string[];
+    /** Exact server-side call that can retrieve this emission after it is shed. */
+    retrievalRoute?: string;
 }
 export type ContextBudgetPiece = string | ContextBudgetItem;
 export interface BudgetedContextFit {
     value: string;
     fullyDeliveredItems: number;
+    /** Retained for caller compatibility. Atomic shedding never sets it. */
     partialItemIndex: number | null;
+    /** Retained for caller compatibility. Atomic shedding always returns zero. */
     partialUnitsDelivered: number;
 }
 /** Measure rendered context in the host's native budget unit. */
 export declare function measureContext(text: string, units?: ContextBudgetUnits): number;
 /**
  * Compose ordered items within a fixed budget. Full items are emitted exactly;
- * the first item that does not fit is packed by whole natural units, and all
- * later identities share one trailing not-reached pointer.
+ * the first item that does not fit and every later item are shed. Shed items
+ * share one trailing marker containing only their explicit retrieval routes.
+ * Items without a route leave no agent-visible stub.
  */
 export declare function fitContextItems(items: readonly ContextBudgetItem[], opts: {
     budget: number;

package/dist/contextBudget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contextBudget.d.ts","sourceRoot":"","sources":["../src/contextBudget.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,YAAY,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAgCD,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,kBAAiC,GAAG,MAAM,CAE7F;AAiED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,cAAc,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C,GACA,kBAAkB,CAmEpB;AA4BD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,iBAAiB,EAAE,CAMrB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAClF,MAAM,CAIR;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD"}
+{"version":3,"file":"contextBudget.d.ts","sourceRoot":"","sources":["../src/contextBudget.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,YAAY,CAAC;AAE7D,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,8EAA8E;IAC9E,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AA6BD,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,kBAAiC,GAAG,MAAM,CAE7F;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,cAAc,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C,GACA,kBAAkB,CAiDpB;AA4BD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,iBAAiB,EAAE,CAMrB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAClF,MAAM,CAIR;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD"}

package/dist/contextBudget.js

@@ -1,26 +1,24 @@
 import { AMBIENT_ITEM_POINTER_SOURCE } from './ambientPointer.js';
 export { AMBIENT_ITEM_POINTER_SOURCE } from './ambientPointer.js';
 const JOINER = '\n\n';
-const CONTINUATION_PREFIX = '… continues: ';
 const NOT_REACHED_PREFIX = '… not reached: ';
 function itemMemoryIds(item) {
     if (item.memoryIds && item.memoryIds.length > 0)
         return item.memoryIds;
     return item.memoryId ? [item.memoryId] : [];
 }
-function identity(item) {
+function retrievalRoutes(item) {
     const memoryIds = itemMemoryIds(item);
     if (memoryIds.length > 0)
-        return memoryIds.map((id) => `memory_get ${id}`).join(', ');
-    return item.name.replace(/\s+/g, ' ').trim();
-}
-function continuationPointer(item) {
-    return `${CONTINUATION_PREFIX}${identity(item)}`;
+        return memoryIds.map((id) => `memory_get ${id}`);
+    const route = item.retrievalRoute?.replace(/\s+/g, ' ').trim();
+    return route ? [route] : [];
 }
 function notReachedPointer(items) {
-    if (items.length === 0)
+    const routes = [...new Set(items.flatMap(retrievalRoutes))];
+    if (routes.length === 0)
         return null;
-    return `${NOT_REACHED_PREFIX}${items.map(identity).join(', ')}`;
+    return `${NOT_REACHED_PREFIX}${routes.join(', ')}`;
 }
 function joinSections(sections) {
     return sections
@@ -31,66 +29,11 @@ function joinSections(sections) {
 export function measureContext(text, units = 'characters') {
     return units === 'utf8-bytes' ? Buffer.byteLength(text, 'utf8') : text.length;
 }
-function withoutTerminalMemoryPointer(item) {
-    if (!item.memoryId)
-        return item.text;
-    const terminalPointer = new RegExp(`\\s*${AMBIENT_ITEM_POINTER_SOURCE}\\s*$`);
-    return item.text.replace(terminalPointer, '').trimEnd();
-}
-/**
- * Prefer bullet lines whenever the item contains them. Text ahead of the first
- * bullet is framing and travels with the first admitted fact. Otherwise each
- * sentence (including a final sentence ending at end-of-item) is one unit.
- */
-function naturalUnits(item) {
-    const text = withoutTerminalMemoryPointer(item);
-    const bulletStarts = [];
-    const bulletPattern = /(^|\n)(?=[ \t]*(?:•|[-*])[ \t]+)/g;
-    let bulletMatch;
-    while ((bulletMatch = bulletPattern.exec(text)) !== null) {
-        bulletStarts.push(bulletMatch.index + (bulletMatch[1] ?? '').length);
-        if (bulletPattern.lastIndex === bulletMatch.index)
-            bulletPattern.lastIndex += 1;
-    }
-    // The validated-use clause is a factual unit of its own. Keeping its start
-    // beside bullet starts means a partial-memory fit emits the whole clause or
-    // none of it; the context boundary can never cut inside the count or date.
-    const trackStarts = [];
-    const trackPattern = /(^|\n)(?=\(acted on and validated \d+ times; last \d{4}-\d{2}-\d{2}\))/g;
-    let trackMatch;
-    while ((trackMatch = trackPattern.exec(text)) !== null) {
-        trackStarts.push(trackMatch.index + (trackMatch[1] ?? '').length);
-        if (trackPattern.lastIndex === trackMatch.index)
-            trackPattern.lastIndex += 1;
-    }
-    const explicitStarts = [...new Set([...bulletStarts, ...trackStarts])].sort((a, b) => a - b);
-    if (explicitStarts.length > 0) {
-        return {
-            prefix: text.slice(0, explicitStarts[0]),
-            units: explicitStarts.map((start, index) => text.slice(start, explicitStarts[index + 1])),
-        };
-    }
-    const units = [];
-    const sentenceEnd = /[.!?](?:["')\]]*)?(?=\s|$)/g;
-    let cursor = 0;
-    let sentenceMatch;
-    while ((sentenceMatch = sentenceEnd.exec(text)) !== null) {
-        const end = sentenceMatch.index + sentenceMatch[0].length;
-        units.push(text.slice(cursor, end));
-        cursor = end;
-    }
-    if (cursor < text.length)
-        units.push(text.slice(cursor));
-    return { prefix: '', units: units.filter((unit) => unit.trim().length > 0) };
-}
-function partialText(item, plan, count) {
-    const content = `${plan.prefix}${plan.units.slice(0, count).join('')}`.trimEnd();
-    return `${content}\n${continuationPointer(item)}`;
-}
 /**
  * Compose ordered items within a fixed budget. Full items are emitted exactly;
- * the first item that does not fit is packed by whole natural units, and all
- * later identities share one trailing not-reached pointer.
+ * the first item that does not fit and every later item are shed. Shed items
+ * share one trailing marker containing only their explicit retrieval routes.
+ * Items without a route leave no agent-visible stub.
  */
 export function fitContextItems(items, opts) {
     const units = opts.units ?? 'characters';
@@ -120,35 +63,17 @@ export function fitContextItems(items, opts) {
             accepted.push(item.text);
             continue;
         }
-        const plan = naturalUnits(item);
-        let partialUnitsDelivered = 0;
-        for (let count = 1; count <= plan.units.length; count += 1) {
-            const candidate = joinSections([
-                ...accepted,
-                partialText(item, plan, count),
-                ...suffix.map((entry) => entry.text),
-                notReachedPointer(later),
-            ]);
-            if (measureContext(candidate, units) > opts.budget)
-                break;
-            partialUnitsDelivered = count;
-        }
-        // A one-fact excerpt reads as though it were the whole memory. Require two
-        // complete units before admitting a partial item; otherwise name it only.
-        const meaningfulMinimum = Math.min(2, plan.units.length);
-        const partialAccepted = partialUnitsDelivered >= meaningfulMinimum && partialUnitsDelivered > 0;
-        const partial = partialAccepted ? partialText(item, plan, partialUnitsDelivered) : null;
-        const unreached = partialAccepted ? later : items.slice(index);
+        const withoutPointer = joinSections([...accepted, ...suffix.map((entry) => entry.text)]);
+        const withPointer = joinSections([
+            ...accepted,
+            ...suffix.map((entry) => entry.text),
+            notReachedPointer(items.slice(index)),
+        ]);
         return {
-            value: joinSections([
-                ...accepted,
-                partial,
-                ...suffix.map((entry) => entry.text),
-                notReachedPointer(unreached),
-            ]),
+            value: measureContext(withPointer, units) <= opts.budget ? withPointer : withoutPointer,
             fullyDeliveredItems: index,
-            partialItemIndex: partialAccepted ? index : null,
-            partialUnitsDelivered: partialAccepted ? partialUnitsDelivered : 0,
+            partialItemIndex: null,
+            partialUnitsDelivered: 0,
         };
     }
     return {