@qduc/term2 0.15.0 → 0.16.0

package/dist/tools/agent/run-subagent.js

@@ -4,22 +4,29 @@ import path from 'node:path';
 import { getOutputText, normalizeToolArguments, createBaseMessage, getCallIdFromItem, safeJsonParse, } from '../format-helpers.js';
 import { SUBAGENT_RUN_NAME_PATTERN, SubagentRegistryError } from '../../services/subagents/subagent-async-registry.js';
 import { isAbortLike, formatSubagentResult } from '../../services/subagents/utils.js';
-const RUN_SUBAGENT_DESCRIPTION = 'Delegate a bounded task to a specialized subagent. Set execution to "foreground" when you need the structured result in this turn, ' +
-    'or "background" when the work can continue after you return control; background returns a running handle and later completion notification. ' +
-    'The subagent runs in its own context and returns only a summary, preserving your context. ' +
-    '(When to reach for this vs. doing it yourself is covered by the delegation guidance in your system instructions.)\n\n' +
-    'Independent foreground explorer and librarian calls in the same model response may run in parallel; keep worker calls and dependent tasks serial.\n\n' +
-    '## Task Requirements\n' +
-    'Give the task one clear objective, one ownership boundary, and one concrete done condition. Include the task-specific scope, non-discoverable parent findings or decisions, constraints, deliverable or acceptance criteria, and validation when applicable. ' +
-    'Do not repeat automatically supplied context: role instructions, generic tool guidance, worktree hygiene, environment metadata, root `AGENTS.md`, or skills catalog. ' +
-    'The subagent does not see your conversation or reasoning. ' +
-    "For explorer, request concrete evidence to collect for a bounded question and choose breadth or depth, never both: map one defined surface shallowly or trace one narrow seam thoroughly. Do not ask explorer to diagnose, recommend a fix, choose an approach, or own the user's complete investigation, review, diagnosis, or planning deliverable. " +
-    'For worker, assign one cohesive implementation unit. For mentor, ask one decision or challenge question. For librarian, assign one retrieval objective or memory-maintenance topic boundary.\n\n' +
-    'For isolated worker edits, create a git worktree under the workspace root first ' +
-    '(`git worktree add .worktrees/<slug> -b <slug>`), then pass `worktree` as that directory basename or branch name. ' +
-    '`worktree` is worker-only; it pins the child into that existing tree without re-rooting this session.\n\n' +
-    'Foreground returns a summary with status (completed, failed, cancelled, or interrupted), any final text, a list of tools used, and files changed. ' +
-    'A background status of "running" means launch succeeded: do not duplicate the task or immediately call get_subagent_result; end the turn and wait for the completion notification.';
+function getRunSubagentDescription(backgroundEnabled) {
+    return ('Delegate a bounded task to a specialized subagent. ' +
+        (backgroundEnabled
+            ? 'This session requires background execution: the tool returns a running handle immediately and a later completion notification. '
+            : 'This session uses foreground execution and returns the structured result in this turn. ') +
+        'The subagent runs in its own context and returns only a summary, preserving your context. ' +
+        '(When to reach for this vs. doing it yourself is covered by the delegation guidance in your system instructions.)\n\n' +
+        (backgroundEnabled
+            ? 'Background launches return immediately; do not duplicate them or call get_subagent_result until the completion notification arrives.\n\n'
+            : 'Independent foreground explorer and librarian calls in the same model response may run in parallel; keep worker calls and dependent tasks serial.\n\n') +
+        '## Task Requirements\n' +
+        'Give the task one clear objective, one ownership boundary, and one concrete done condition. Include the task-specific scope, non-discoverable parent findings or decisions, constraints, deliverable or acceptance criteria, and validation when applicable. ' +
+        'Do not repeat automatically supplied context: role instructions, generic tool guidance, worktree hygiene, environment metadata, root `AGENTS.md`, or skills catalog. ' +
+        'The subagent does not see your conversation or reasoning. ' +
+        "For explorer, request concrete evidence to collect for a bounded question and choose breadth or depth, never both: map one defined surface shallowly or trace one narrow seam thoroughly. Do not ask explorer to diagnose, recommend a fix, choose an approach, or own the user's complete investigation, review, diagnosis, or planning deliverable. " +
+        'For worker, assign one cohesive implementation unit. For mentor, ask one decision or challenge question. For librarian, assign one retrieval objective or memory-maintenance topic boundary.\n\n' +
+        'For isolated worker edits, create a git worktree under the workspace root first ' +
+        '(`git worktree add .worktrees/<slug> -b <slug>`), then pass `worktree` as that directory basename or branch name. ' +
+        '`worktree` is worker-only; it pins the child into that existing tree without re-rooting this session.\n\n' +
+        (backgroundEnabled
+            ? 'A background status of "running" means launch succeeded: end the turn and wait for the completion notification.'
+            : 'Foreground returns a summary with status (completed, failed, cancelled, or interrupted), any final text, a list of tools used, and files changed.'));
+}
 const FOREGROUND_ROLES = ['explorer', 'worker', 'librarian'];
 const BACKGROUND_ROLES = ['explorer', 'worker', 'mentor', 'librarian'];
 const ALL_ROLES = ['explorer', 'worker', 'mentor', 'librarian'];
@@ -54,24 +61,24 @@ const runSubagentSchema = z
 })
     .strict();
 function createRunSubagentSchema({ runSubagent, runSubagentAsync }) {
-    if (runSubagent && !runSubagentAsync) {
+    if (runSubagentAsync) {
         return z
             .object({
-            execution: z.literal('foreground').describe('Only foreground execution is available in this session.'),
-            role: z.enum(FOREGROUND_ROLES).describe('The subagent role to use.'),
+            execution: z.literal('background').describe('Only background execution is available in this session.'),
+            role: z.enum(BACKGROUND_ROLES).describe('The subagent role to use.'),
             task: z.string().describe(SUBAGENT_TASK_DESCRIPTION),
             ...worktreeField,
+            ...backgroundFields,
         })
             .strict();
     }
-    if (!runSubagent && runSubagentAsync) {
+    if (runSubagent && !runSubagentAsync) {
         return z
             .object({
-            execution: z.literal('background').describe('Only background execution is available in this session.'),
-            role: z.enum(BACKGROUND_ROLES).describe('The subagent role to use.'),
+            execution: z.literal('foreground').describe('Only foreground execution is available in this session.'),
+            role: z.enum(FOREGROUND_ROLES).describe('The subagent role to use.'),
             task: z.string().describe(SUBAGENT_TASK_DESCRIPTION),
             ...worktreeField,
-            ...backgroundFields,
         })
             .strict();
     }
@@ -269,7 +276,7 @@ export function createRunSubagentToolDefinition(callbacks) {
     const parameters = createRunSubagentSchema(resolvedCallbacks);
     return {
         name: 'run_subagent',
-        description: RUN_SUBAGENT_DESCRIPTION,
+        description: getRunSubagentDescription(Boolean(resolvedCallbacks.runSubagentAsync)),
         parameters,
         parallelSafe: (params) => {
             const candidate = params;
@@ -278,6 +285,15 @@ export function createRunSubagentToolDefinition(callbacks) {
         needsApproval: () => false,
         execute: async (rawParams, context, details) => {
             const params = rawParams;
+            if (resolvedCallbacks.runSubagentAsync && params.execution === 'foreground') {
+                return JSON.stringify({
+                    status: 'failed',
+                    error: {
+                        code: 'foreground_unavailable',
+                        message: 'Foreground execution is unavailable in this session; use execution: "background".',
+                    },
+                });
+            }
             if (params.execution === 'foreground' || (legacyForegroundOnly && params.execution === undefined)) {
                 if (params.name != null || params.continue_run_id != null) {
                     return failedForegroundResult(params.role, 'Background-only inputs name and continue_run_id cannot be used with execution: "foreground".');

package/dist/tools/agent/run-subagent.js.map

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

package/dist/tools/memory/memory-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-tools.d.ts","sourceRoot":"","sources":["../../../source/tools/memory/memory-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA8C,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ9F,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,uCAAuC,CAAC;AAE/C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC/C,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AA0E5D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,GAAG,cAAc,EAAE,CAmH/F"}
+{"version":3,"file":"memory-tools.d.ts","sourceRoot":"","sources":["../../../source/tools/memory/memory-tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA8C,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ9F,OAAO,EAOL,KAAK,WAAW,EACjB,MAAM,uCAAuC,CAAC;AAU/C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC/C,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;AAoH5D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,GAAG,cAAc,EAAE,CAoP/F"}

package/dist/tools/memory/memory-tools.js

@@ -1,10 +1,50 @@
 import { z } from 'zod';
 import { createBaseMessage, getCallIdFromItem, getOutputText, isSuccessOutput, normalizeToolArguments, } from '../format-helpers.js';
 import { InvalidMemoryError, MemoryAlreadyExistsError, MemoryNotFoundError, MemoryStorageError, } from '../../services/memory/memory-store.js';
+import { contentSnippet, queryTerms, rankMemorySearchResults, } from '../../services/memory/memory-search.js';
+import { boundedJsonFailure, fitSerializedEnvelope, fitsSerializedText } from '../../utils/output/bounded-json.js';
+import { resolveToolResultMaxBytes } from '../../utils/output/bound-tool-result.js';
 const scope = z.enum(['global', 'project']).describe('Memory scope to write to.');
+const MIN_TOOL_OUTPUT_CHARS = 512;
+const MAX_TOOL_OUTPUT_CHARS = 12_000;
+const DEFAULT_INDEX_OUTPUT_CHARS = 12_000;
+const DEFAULT_DOCUMENT_OUTPUT_CHARS = 12_000;
+const DEFAULT_RESULT_LIMIT = 10;
+const MAX_RESULT_LIMIT = 50;
+const maxChars = z.number().int().min(MIN_TOOL_OUTPUT_CHARS).max(MAX_TOOL_OUTPUT_CHARS).optional();
+const resultLimit = z.number().int().min(1).max(MAX_RESULT_LIMIT).optional();
 function normalizeStores(stores) {
     return 'list' in stores ? { global: stores, project: stores } : stores;
 }
+class MemoryCursorError extends Error {
+}
+class StaleMemoryCursorError extends Error {
+}
+class OutputBudgetExceededError extends Error {
+}
+function metadata(memory) {
+    return {
+        id: memory.id,
+        title: memory.title,
+        summary: memory.summary,
+        tags: memory.tags,
+        createdAt: memory.createdAt,
+        updatedAt: memory.updatedAt,
+    };
+}
+function output(maxChars, build) {
+    const fitted = fitSerializedEnvelope(build, { maxChars });
+    if (!fitted)
+        throw new OutputBudgetExceededError();
+    return fitted.value;
+}
+function boundedError(code, message, maxChars) {
+    const result = { error: { code, message } };
+    const serialized = JSON.stringify(result);
+    return fitsSerializedText(serialized, { maxChars, maxBytes: resolveToolResultMaxBytes() })
+        ? serialized
+        : boundedJsonFailure({ maxChars, maxBytes: resolveToolResultMaxBytes() });
+}
 const makeFormat = (toolName) => (item, index, calls) => {
     const callId = getCallIdFromItem(item);
     const args = normalizeToolArguments(item?.rawItem?.arguments ?? item?.arguments) ??
@@ -32,89 +72,207 @@ const fields = {
     content: z.string().optional(),
     tags: z.array(z.string()).optional(),
 };
-function safe(operation) {
+function safe(operation, maxChars) {
     return operation()
         .then((value) => JSON.stringify(value))
-        .catch((error) => JSON.stringify({
-        error: error instanceof MemoryNotFoundError
-            ? { code: 'not_found', message: 'Memory was not found.' }
-            : error instanceof MemoryAlreadyExistsError
-                ? { code: 'already_exists', message: 'A memory with this ID already exists.' }
-                : error instanceof InvalidMemoryError
-                    ? { code: 'invalid_memory', message: error.message }
-                    : error instanceof MemoryStorageError
-                        ? { code: 'storage_error', message: 'Memory storage is unavailable or corrupted.' }
-                        : { code: 'memory_error', message: 'Memory operation failed.' },
-    }));
+        .catch((error) => error instanceof MemoryNotFoundError
+        ? boundedError('not_found', 'Memory was not found.', maxChars)
+        : error instanceof MemoryAlreadyExistsError
+            ? boundedError('already_exists', 'A memory with this ID already exists.', maxChars)
+            : error instanceof InvalidMemoryError
+                ? boundedError('invalid_memory', 'Memory input is invalid.', maxChars)
+                : error instanceof MemoryStorageError
+                    ? boundedError('storage_error', 'Memory storage is unavailable or corrupted.', maxChars)
+                    : error instanceof MemoryCursorError
+                        ? boundedError('invalid_cursor', 'The memory cursor is invalid.', maxChars)
+                        : error instanceof StaleMemoryCursorError
+                            ? boundedError('stale_cursor', 'The memory cursor is stale.', maxChars)
+                            : error instanceof OutputBudgetExceededError
+                                ? boundedError('output_budget_exceeded', 'The requested result cannot fit in the output budget.', maxChars)
+                                : boundedError('memory_error', 'Memory operation failed.', maxChars));
 }
 function definition(name, description, parameters, execute, needsApproval = false) {
     return {
         name,
         description,
         parameters,
+        preserveSerializedOutput: ['memory_list', 'memory_get', 'memory_search', 'memory_retrieve'].includes(name),
         needsApproval: () => needsApproval,
-        execute: (params) => safe(() => execute(params)),
+        execute: (params) => safe(() => execute(params), params.maxChars ?? DEFAULT_DOCUMENT_OUTPUT_CHARS),
         formatCommandMessage: makeFormat(name),
     };
 }
 export function createMemoryToolDefinitions(input) {
     const stores = normalizeStores(input);
+    const configuredLimits = stores.global.searchLimits?.() ?? {
+        defaultLimit: DEFAULT_RESULT_LIMIT,
+        maxLimit: MAX_RESULT_LIMIT,
+    };
+    const effectiveLimit = (requested) => Math.min(requested ?? configuredLimits.defaultLimit, configuredLimits.maxLimit, MAX_RESULT_LIMIT);
+    const rankedSearch = async (query, limit) => {
+        const options = { limit: Math.min(configuredLimits.maxLimit, MAX_RESULT_LIMIT) };
+        const [global, project] = await Promise.all([
+            stores.global.search(query, options),
+            stores.project.search(query, options),
+        ]);
+        return rankMemorySearchResults([
+            ...global.map((result) => ({ ...result, scope: 'global' })),
+            ...project.map((result) => ({ ...result, scope: 'project' })),
+        ]).slice(0, limit);
+    };
     return [
-        definition('memory_list', 'List persistent-memory summaries from both the global and project scopes.', z.object({ limit: z.number().int().positive().optional() }).strict(), async ({ limit }) => {
-            const options = { limit };
-            const [global, project] = await Promise.all([stores.global.list(options), stores.project.list(options)]);
-            return { scope: 'all', global, project };
+        definition('memory_list', 'List persistent-memory summaries from both the global and project scopes.', z.object({ limit: resultLimit, maxChars }).strict(), async ({ limit, maxChars: requestedMaxChars }) => {
+            const selectedLimit = effectiveLimit(limit);
+            const [globalCandidates, projectCandidates] = await Promise.all([
+                stores.global.list({ limit: selectedLimit }),
+                stores.project.list({ limit: selectedLimit }),
+            ]);
+            const result = {
+                scope: 'all',
+                global: [],
+                project: [],
+                omitted: { global: 0, project: 0 },
+            };
+            const budget = requestedMaxChars ?? DEFAULT_INDEX_OUTPUT_CHARS;
+            // Admit each record against the largest possible final count so later
+            // omissions cannot invalidate an already admitted envelope.
+            const reservedOmitted = { global: globalCandidates.length, project: projectCandidates.length };
+            for (const [entryScope, candidate] of [
+                ...globalCandidates.map((memory) => ['global', memory]),
+                ...projectCandidates.map((memory) => ['project', memory]),
+            ]) {
+                const admitted = fitSerializedEnvelope((charsUsed) => ({
+                    ...result,
+                    [entryScope]: [...result[entryScope], metadata(candidate)],
+                    omitted: reservedOmitted,
+                    charsUsed,
+                }), { maxChars: budget });
+                if (admitted) {
+                    result[entryScope] = admitted.value[entryScope];
+                    continue;
+                }
+                result.omitted[entryScope]++;
+            }
+            return output(budget, (charsUsed) => ({ ...result, charsUsed }));
         }),
-        definition('memory_get', 'Load one memory by ID, checking both the global and project scopes.', z.object({ id }).strict(), async ({ id }) => {
+        definition('memory_get', 'Load one memory by ID, checking both the global and project scopes.', z.object({ id, cursor: z.string().optional(), maxChars }).strict(), async ({ id, cursor, maxChars: requestedMaxChars }) => {
+            const budget = requestedMaxChars ?? DEFAULT_DOCUMENT_OUTPUT_CHARS;
             for (const scope of ['global', 'project']) {
                 const memory = await stores[scope].get(id);
-                if (memory)
-                    return { scope, memory };
+                if (!memory)
+                    continue;
+                const offset = cursor ? decodeMemoryCursor(cursor, id, scope, memory) : 0;
+                if (cursor)
+                    return memoryPage(scope, memory, offset, budget);
+                const complete = fitSerializedEnvelope((charsUsed) => ({ scope, memory, charsUsed }), { maxChars: budget });
+                if (complete)
+                    return complete.value;
+                return memoryPage(scope, memory, offset, budget);
             }
             throw new MemoryNotFoundError(id);
         }),
-        definition('memory_search', 'Search both the global and project memory scopes using deterministic local text matching.', z.object({ query: z.string(), limit: z.number().int().positive().optional() }).strict(), async ({ query, ...options }) => {
-            const [global, project] = await Promise.all([
-                stores.global.search(query, options),
-                stores.project.search(query, options),
-            ]);
-            return {
-                results: [
-                    ...global.map((result) => ({ scope: 'global', ...result })),
-                    ...project.map((result) => ({ scope: 'project', ...result })),
-                ],
-            };
+        definition('memory_search', 'Search both the global and project memory scopes using deterministic local text matching.', z.object({ query: z.string().refine((value) => /\S/.test(value)), limit: resultLimit, maxChars }).strict(), async ({ query, limit, maxChars: requestedMaxChars }) => {
+            const budget = requestedMaxChars ?? DEFAULT_INDEX_OUTPUT_CHARS;
+            const candidates = await rankedSearch(query, effectiveLimit(limit));
+            const result = { results: [], omitted: 0 };
+            const terms = queryTerms(query);
+            for (const candidate of candidates) {
+                const item = {
+                    scope: candidate.scope,
+                    memory: metadata(candidate.memory),
+                    matchedFields: candidate.matchedFields,
+                    available: candidate.available,
+                    ...(candidate.matchedFields.includes('content') && candidate.content !== undefined
+                        ? { contentSnippet: contentSnippet(candidate.content, terms) }
+                        : {}),
+                };
+                const prospective = fitSerializedEnvelope(
+                // The eventual count is bounded by candidates.length; reserve its
+                // digit width before admitting a result.
+                (charsUsed) => ({ ...result, results: [...result.results, item], omitted: candidates.length, charsUsed }), { maxChars: budget });
+                if (prospective)
+                    result.results = prospective.value.results;
+                else {
+                    const omitted = fitSerializedEnvelope((charsUsed) => ({ ...result, omitted: result.omitted + 1, charsUsed }), {
+                        maxChars: budget,
+                    });
+                    if (!omitted)
+                        throw new OutputBudgetExceededError();
+                    result.omitted++;
+                }
+            }
+            return output(budget, (charsUsed) => ({ ...result, charsUsed }));
         }),
-        definition('memory_retrieve', 'Search and load relevant memories across both the global and project scopes.', z.object({ query: z.string(), limit: z.number().int().positive().optional() }).strict(), async ({ query, ...options }) => {
-            const searchAcross = async (scope) => {
-                const results = await stores[scope].search(query, options);
-                const memories = [];
-                const unavailableIds = [];
-                for (const result of results) {
-                    if (!result.available) {
-                        unavailableIds.push({ scope, id: result.memory.id });
-                        continue;
-                    }
-                    try {
-                        const memory = await stores[scope].get(result.memory.id);
-                        if (memory)
-                            memories.push({ scope, memory });
-                        else
-                            unavailableIds.push({ scope, id: result.memory.id });
-                    }
-                    catch (error) {
-                        if (!(error instanceof MemoryStorageError) && !(error instanceof MemoryNotFoundError))
-                            throw error;
-                        unavailableIds.push({ scope, id: result.memory.id });
-                    }
+        definition('memory_retrieve', 'Search and load relevant memories across both the global and project scopes.', z.object({ query: z.string().refine((value) => /\S/.test(value)), limit: resultLimit, maxChars }).strict(), async ({ query, limit, maxChars: requestedMaxChars }) => {
+            const budget = requestedMaxChars ?? DEFAULT_DOCUMENT_OUTPUT_CHARS;
+            const candidates = await rankedSearch(query, effectiveLimit(limit));
+            const loaded = [];
+            for (const candidate of candidates) {
+                if (!candidate.available) {
+                    loaded.push({ scope: candidate.scope, id: candidate.memory.id, unavailable: true });
+                    continue;
                 }
-                return { memories, unavailableIds };
-            };
-            const [global, project] = await Promise.all([searchAcross('global'), searchAcross('project')]);
-            return {
-                memories: [...global.memories, ...project.memories],
-                unavailableIds: [...global.unavailableIds, ...project.unavailableIds],
+                try {
+                    const memory = await stores[candidate.scope].get(candidate.memory.id);
+                    loaded.push({
+                        scope: candidate.scope,
+                        id: candidate.memory.id,
+                        memory: memory ?? undefined,
+                        unavailable: !memory,
+                    });
+                }
+                catch (error) {
+                    if (!(error instanceof MemoryStorageError) && !(error instanceof MemoryNotFoundError))
+                        throw error;
+                    loaded.push({ scope: candidate.scope, id: candidate.memory.id, unavailable: true });
+                }
+            }
+            const result = {
+                memories: [],
+                unavailableIds: [],
+                omittedIds: [],
+                omittedIdCount: 0,
+                unavailableIdCount: 0,
             };
+            const unavailable = loaded.filter((entry) => entry.unavailable);
+            const available = loaded.filter((entry) => !entry.unavailable && !!entry.memory);
+            // References and memories are admitted against both terminal count
+            // widths, so neither count can overflow a previously valid result.
+            const reservedCounts = () => ({
+                omittedIdCount: available.length,
+                unavailableIdCount: unavailable.length,
+            });
+            result.unavailableIdCount = unavailable.length;
+            for (const candidate of unavailable) {
+                const reference = { scope: candidate.scope, id: candidate.id };
+                const prospective = fitSerializedEnvelope((charsUsed) => ({
+                    ...result,
+                    ...reservedCounts(),
+                    unavailableIds: [...result.unavailableIds, reference],
+                    charsUsed,
+                }), { maxChars: budget });
+                if (prospective)
+                    result.unavailableIds = prospective.value.unavailableIds;
+            }
+            for (const candidate of available) {
+                const memory = { scope: candidate.scope, memory: candidate.memory };
+                const prospective = fitSerializedEnvelope((charsUsed) => ({ ...result, ...reservedCounts(), memories: [...result.memories, memory], charsUsed }), { maxChars: budget });
+                if (prospective) {
+                    result.memories = prospective.value.memories;
+                    continue;
+                }
+                result.omittedIdCount++;
+                const reference = { scope: candidate.scope, id: candidate.id };
+                const omission = fitSerializedEnvelope((charsUsed) => ({
+                    ...result,
+                    ...reservedCounts(),
+                    omittedIds: [...result.omittedIds, reference],
+                    charsUsed,
+                }), { maxChars: budget });
+                if (omission)
+                    result.omittedIds = omission.value.omittedIds;
+            }
+            return output(budget, (charsUsed) => ({ ...result, charsUsed }));
         }),
         definition('memory_create', 'Save durable information to the selected global or project memory scope.', z.object({
             scope,
@@ -141,4 +299,109 @@ export function createMemoryToolDefinitions(input) {
         }, true),
     ];
 }
+function decodeMemoryCursor(cursor, id, scope, memory) {
+    if (!/^[A-Za-z0-9_-]+$/.test(cursor))
+        throw new MemoryCursorError();
+    let decoded;
+    let value;
+    try {
+        decoded = Buffer.from(cursor, 'base64url').toString('utf8');
+        if (Buffer.from(decoded, 'utf8').toString('base64url') !== cursor)
+            throw new Error();
+        value = JSON.parse(decoded);
+    }
+    catch {
+        throw new MemoryCursorError();
+    }
+    const parsed = value;
+    if (!parsed ||
+        parsed.v !== 1 ||
+        parsed.scope !== scope ||
+        parsed.id !== id ||
+        !isUtcTimestamp(parsed.updatedAt) ||
+        typeof parsed.nextOffset !== 'number' ||
+        !Number.isSafeInteger(parsed.nextOffset) ||
+        parsed.nextOffset < 0 ||
+        Object.keys(parsed).join(',') !== 'v,scope,id,updatedAt,nextOffset' ||
+        JSON.stringify(parsed) !== decoded)
+        throw new MemoryCursorError();
+    const validated = parsed;
+    if (validated.updatedAt !== memory.updatedAt)
+        throw new StaleMemoryCursorError();
+    if ((memory.content.length === 0 && validated.nextOffset !== 0) ||
+        (memory.content.length > 0 && validated.nextOffset >= memory.content.length))
+        throw new MemoryCursorError();
+    if (validated.nextOffset > 0 &&
+        validated.nextOffset < memory.content.length &&
+        isHighSurrogate(memory.content.charCodeAt(validated.nextOffset - 1)) &&
+        isLowSurrogate(memory.content.charCodeAt(validated.nextOffset)))
+        throw new MemoryCursorError();
+    return validated.nextOffset;
+}
+function memoryPage(scope, memory, offset, maxChars) {
+    const totalChars = memory.content.length;
+    const page = (end) => {
+        const text = safePageSlice(memory.content, offset, end);
+        if (!text && totalChars > offset)
+            return null;
+        const nextOffset = offset + text.length;
+        const content = {
+            offset,
+            totalChars,
+            text,
+            ...(nextOffset < totalChars
+                ? { nextCursor: encodeMemoryCursor({ v: 1, scope, id: memory.id, updatedAt: memory.updatedAt, nextOffset }) }
+                : {}),
+        };
+        return fitSerializedEnvelope((charsUsed) => ({ scope, memory: metadata(memory), content, charsUsed }), {
+            maxChars,
+        });
+    };
+    if (totalChars === 0) {
+        const empty = page(0);
+        if (empty)
+            return empty.value;
+        throw new OutputBudgetExceededError();
+    }
+    let lower = offset + 1;
+    let upper = totalChars;
+    let best = null;
+    while (lower <= upper) {
+        const middle = Math.floor((lower + upper) / 2);
+        const candidate = page(middle);
+        if (candidate) {
+            best = candidate;
+            lower = middle + 1;
+        }
+        else {
+            upper = middle - 1;
+        }
+    }
+    if (!best || !best.value.content.text)
+        throw new OutputBudgetExceededError();
+    return best.value;
+}
+function safePageSlice(content, start, end) {
+    let safeEnd = end;
+    if (safeEnd > start &&
+        safeEnd < content.length &&
+        isHighSurrogate(content.charCodeAt(safeEnd - 1)) &&
+        isLowSurrogate(content.charCodeAt(safeEnd)))
+        safeEnd--;
+    return content.slice(start, safeEnd);
+}
+function encodeMemoryCursor(cursor) {
+    return Buffer.from(JSON.stringify(cursor), 'utf8').toString('base64url');
+}
+function isUtcTimestamp(value) {
+    return (typeof value === 'string' &&
+        /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/.test(value) &&
+        !Number.isNaN(Date.parse(value)));
+}
+function isHighSurrogate(value) {
+    return value >= 0xd800 && value <= 0xdbff;
+}
+function isLowSurrogate(value) {
+    return value >= 0xdc00 && value <= 0xdfff;
+}
 //# sourceMappingURL=memory-tools.js.map