@myagentroam/agent 0.10.29 → 0.10.31

package/dist/agent-core/sdk/types.d.ts

@@ -21,12 +21,15 @@ export interface ExecutionHandle extends AsyncIterable<MarAgentEvent> {
     /** Signals abort; await result() to observe the terminal status and cleanup. */
     cancel(): void;
 }
+export type CompactInput = Partial<RunInput> & {
+    readonly async?: boolean;
+};
 /** A persisted Session permits one active main execution at a time. */
 export interface MarAgentSession {
     readonly id: string;
     run(input: RunInput): ExecutionHandle;
     plan(input: RunInput): ExecutionHandle;
-    compact(input?: Partial<RunInput>): ExecutionHandle;
+    compact(input?: CompactInput): ExecutionHandle;
     cancel(executionId: string): Promise<void>;
 }
 export interface MarAgent {

package/dist/agent-core/session/catalog.js

@@ -86,8 +86,8 @@ export async function openMarAgentSessionCatalog(input) {
                 if (!isMarAgentEvent(record.payload))
                     continue;
                 if (record.payload.type === 'context.compacted')
-                    return { inputTokens: 0 };
-                if (record.payload.type === 'usage.updated') {
+                    return record.payload.retainedContext === true ? undefined : { inputTokens: 0 };
+                if (record.payload.type === 'usage.updated' && record.payload.purpose !== 'compact') {
                     const inputTokens = record.payload.contextInputTokens ?? record.payload.inputTokens;
                     if (typeof inputTokens === 'number' &&
                         Number.isSafeInteger(inputTokens) &&

package/dist/agent-core/session/jsonl-store.d.ts

@@ -193,6 +193,8 @@ export declare class JsonlSessionStore {
         summary: string;
         replacementHistory?: readonly CompactHistoryMessage[];
         retainedModelContext?: readonly ModelMessage[];
+        snapshotRecordId?: string;
+        snapshotMessageCount?: number;
         environment?: EnvironmentContextState;
         automatic?: boolean;
         modelId?: string;

package/dist/agent-core/session/jsonl-store.js

@@ -1306,6 +1306,12 @@ export class JsonlSessionStore {
             type: 'compact.completed',
             payload: {
                 summary: input.summary,
+                ...(input.snapshotRecordId === undefined
+                    ? {}
+                    : { snapshotRecordId: input.snapshotRecordId }),
+                ...(input.snapshotMessageCount === undefined
+                    ? {}
+                    : { snapshotMessageCount: input.snapshotMessageCount }),
                 ...(input.replacementHistory === undefined
                     ? {}
                     : { replacementHistory: input.replacementHistory }),
@@ -2521,7 +2527,8 @@ export function parseModelInputMetadata(value) {
         ...(typeof metadata.extensionId === 'string' && metadata.extensionId.length <= 128
             ? { extensionId: metadata.extensionId }
             : {}),
-        ...(metadata.truncated === true ? { truncated: true } : {})
+        ...(metadata.truncated === true ? { truncated: true } : {}),
+        ...(metadata.smartCompaction === true ? { smartCompaction: true } : {})
     };
 }
 export function inputMetadataFromRecord(record) {
@@ -2534,6 +2541,7 @@ export function inputMetadataFromRecord(record) {
                 ? 'parent_agent'
                 : 'user',
         recordId: record.recordId,
+        ...(payload.smartCompaction === true ? { smartCompaction: true } : {}),
         ...(typeof source?.extensionId === 'string' && source.extensionId.length <= 128
             ? { extensionId: source.extensionId }
             : {})

package/dist/agent-core/tools/agent/smart-compact.d.ts

@@ -0,0 +1,9 @@
+import type { ClientToolDefinition } from '../../model/contracts.js';
+import type { ToolRuntimeContext } from '../runtime-context.js';
+export declare const smartCompactToolDefinition: ClientToolDefinition;
+export declare function executeSmartCompact(arguments_: unknown, context: ToolRuntimeContext): Promise<{
+    content: string;
+    data: {
+        status: string;
+    };
+}>;

package/dist/agent-core/tools/agent/smart-compact.js

@@ -0,0 +1,20 @@
+import { MarAgentError } from '../../error.js';
+export const smartCompactToolDefinition = {
+    name: 'smart_compact',
+    allowedCallers: ['direct', 'programmatic'],
+    parallelSafety: 'safe',
+    description: 'Request background context compaction only when the current real user message ends with <mar_runtime><smart_compaction scope="this_message">eligible</smart_compaction></mar_runtime> (on separate lines). The scope applies only to the containing user message; a historical marker does not authorize the current input. Call only when prior work is substantially complete, the request begins a sustained new work phase, and prior detailed context has low continuation value while key state can be retained in a summary. Do not call merely because the conversation is long, for a one-off question, or while prior evidence is still needed. Prefer calling alongside the first batch of necessary read/search/exec tools rather than creating a separate rollout. Acceptance does not wait for generation or installation.',
+    inputSchema: { type: 'object', properties: {}, additionalProperties: false }
+};
+export function executeSmartCompact(arguments_, context) {
+    if (!arguments_ ||
+        typeof arguments_ !== 'object' ||
+        Array.isArray(arguments_) ||
+        Object.keys(arguments_).length)
+        throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Smart Compaction input must be an empty object.');
+    if (!context.requestSmartCompact)
+        throw new MarAgentError('MAR_AGENT_SMART_COMPACT_DENIED', 'The current user input is not eligible for Smart Compaction.');
+    context.requestSmartCompact();
+    const data = { status: 'accepted' };
+    return Promise.resolve({ content: JSON.stringify(data), data });
+}

package/dist/agent-core/tools/registry.js

@@ -12,6 +12,7 @@ import { executeTodoRead, todoReadToolDefinition } from './agent/todo-read.js';
 import { executeTodoWrite, todoWriteToolDefinition } from './agent/todo-write.js';
 import { executeToolSearch, toolSearchToolDefinition } from './mcp/tool-search.js';
 import { viewImageToolDefinition } from './local/view-image.js';
+import { smartCompactToolDefinition, executeSmartCompact } from './agent/smart-compact.js';
 export const BUILTIN_TOOL_DEFINITIONS = [
     skillToolDefinition,
     toolSearchToolDefinition,
@@ -28,10 +29,12 @@ export const BUILTIN_TOOL_DEFINITIONS = [
     agentStartToolDefinition,
     agentWaitToolDefinition,
     agentMessageToolDefinition,
-    agentCancelToolDefinition
+    agentCancelToolDefinition,
+    smartCompactToolDefinition
 ];
 export const AGENT_TOOL_HANDLERS = new Map([
     ['skill', executeSkill],
+    ['smart_compact', executeSmartCompact],
     ['tool_search', executeToolSearch],
     ['question', executeQuestion],
     ['todo_read', (_arguments, context) => executeTodoRead(context)],

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

@@ -40,6 +40,7 @@ export interface ToolRuntimeImage {
 export interface ToolRuntimeContext {
     host: MarAgentHost;
     todo: TodoStore;
+    requestSmartCompact?: () => void;
     subagents?: SubagentController;
     mode: ExecutionMode;
     sessionId: string;

package/dist/index.d.ts

@@ -38,7 +38,7 @@ export type { CoreModelsApi, CoreModelDescription, CoreModelTextBlock, CoreGener
 export type { CoreDataApi, CoreJsonValue, CoreCheckpoint, CoreCheckpointApi, CoreStateApi, CoreStateChange, CoreStoreApi, CoreStoreCommit } from './agent-core/extensions/data.js';
 export { generateSessionTitle, type GenerateSessionTitleInput } from './shared/auto-title.js';
 export type { CoreProcessesApi, CoreProcessesBackend, CoreProcessInput, CoreProcessRunInput, CoreProcessHandle, CoreProcessExit, CoreProcessResult, CoreProcessCompletion } from './agent-core/extensions/processes.js';
-export type { CreateMarAgentOptions, CreateSessionInput, ExecutionHandle, MarAgent, MarAgentSession, SessionTitleUpdateInput } from './agent-core/sdk/types.js';
+export type { CreateMarAgentOptions, CreateSessionInput, ExecutionHandle, CompactInput, MarAgent, MarAgentSession, SessionTitleUpdateInput } from './agent-core/sdk/types.js';
 export { openMarAgentSessionCatalog, type MarAgentContextUsage, type MarAgentHistoryEntry, type MarAgentHistoryPage, type MarAgentSessionCatalog, type MarAgentSessionDeleteResult, type MarAgentSessionImage, type MarAgentSessionPage, type MarAgentSessionSummary } from './agent-core/session/catalog.js';
 export type { SessionListInput, SessionSource } from './agent-core/session/types.js';
 export type { ApplyPatchFileResult, ApplyPatchResult, ApplyPatchPartialResult, ClientToolDefinition, MarAgentToolArtifact, MarAgentToolImageArtifact, McpCatalogTool, McpToolCallContext, McpToolCatalog, McpToolCatalogContext, ToolCall, ToolCaller, ToolExecutionContext, ToolExecutionResult } from './agent-core/tools/contracts.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/agent",
-  "version": "0.10.29",
+  "version": "0.10.31",
   "description": "Embeddable MAR coding agent SDK and CLI.",
   "license": "Apache-2.0",
   "type": "module",