@myagentroam/agent 0.11.33 → 0.11.34

package/dist/agent-core/sdk/resource-input.d.ts

@@ -1,32 +0,0 @@
-import type { ModelMessage, ModelRequest } from '../model/contracts.js';
-import { type ModelImage } from '../model/image.js';
-import type { SessionStore } from '../session/store/contracts.js';
-import type { SessionRecord } from '../session/store/types.js';
-import { type InlineMediaGcCandidate, type InlineMediaState } from '../session/inline-media.js';
-interface Options {
-    records?: readonly SessionRecord[];
-    persist?: (state: InlineMediaState) => Promise<void>;
-}
-/** SDK-owned ordered visual window; durable image references are never rewritten. */
-export declare class ResourceInputProjection {
-    #private;
-    private readonly useResourceUrl;
-    private readonly store;
-    private readonly sessionId;
-    private readonly options;
-    constructor(useResourceUrl: boolean, store: Pick<SessionStore, 'readResource'>, sessionId: string, history: readonly ModelMessage[], options?: Options);
-    observe(messages: readonly ModelMessage[]): void;
-    /** Called only at an explicit context replacement, never as a history diff detector. */
-    replace(messages: readonly ModelMessage[]): void;
-    hasPendingImages(messages: readonly ModelMessage[]): boolean;
-    /** Reference-only view shared by GC; no byte loading or new eviction decisions. */
-    historyView(messages: readonly ModelMessage[]): ModelMessage[];
-    checkpoint(messages?: readonly ModelMessage[]): InlineMediaState;
-    prepare(request: ModelRequest, mirroredImages?: readonly ModelImage[], canonicalMessages?: readonly ModelMessage[]): Promise<ModelRequest>;
-    complete(request: ModelRequest): Promise<void>;
-    /** Propose a cursor; only the unified GC checkpoint may adopt it. */
-    gcCandidate(request?: ModelRequest, mirroredImages?: readonly ModelImage[]): Promise<InlineMediaGcCandidate | undefined>;
-    adoptGc(state: InlineMediaState | undefined): void;
-    releaseBytes(): void;
-}
-export {};

package/dist/agent-core/sdk/resource-input.js

@@ -1,403 +0,0 @@
-import { isDeepStrictEqual } from 'node:util';
-import { MarAgentError } from '../error.js';
-import { isModelImageUrl } from '../model/image.js';
-import { observationImages, renderObservationResult, selectObservationImages } from '../tools/code-mode/observations.js';
-import { INLINE_MEDIA_POLICY as policy, assertInlineMediaBudget, inlineMediaBytes, inlineMediaHistory, inlineMediaLimit, inlineMediaSource } from '../session/inline-media.js';
-function releasedImageNotice(message, indices, unavailable) {
-    return indices
-        .map((index) => {
-        if (unavailable?.has(index))
-            return 'Image unavailable; omitted from context.';
-        const resourceId = message.images?.[index]?.resourceId;
-        const hint = resourceId
-            ? ` Reopen with view_image(${JSON.stringify({ resourceId })}) if needed.`
-            : '';
-        return `<mar_context_gc kind="image">Image released.${hint}</mar_context_gc>`;
-    })
-        .join('\n');
-}
-function projectRetainedImages(message, images, removed, unavailable) {
-    if (!removed.size)
-        return { ...message, images };
-    if (message.observations) {
-        const observations = message.observations.map((observation) => {
-            const removedIndices = observationImages(observation).filter((index) => removed.has(index));
-            if (!removedIndices.length)
-                return observation;
-            const notice = releasedImageNotice(message, removedIndices, unavailable);
-            return observation.type === 'tool_result'
-                ? {
-                    ...observation,
-                    result: { ...observation.result, content: `${observation.result.content}\n${notice}` }
-                }
-                : { ...observation, value: `${observation.value}\n${notice}` };
-        });
-        const selected = selectObservationImages(observations, images);
-        return {
-            ...message,
-            ...selected,
-            content: renderObservationResult(selected.observations, message.content)
-        };
-    }
-    const notice = releasedImageNotice(message, [...removed], unavailable);
-    return {
-        ...message,
-        images: images.filter(Boolean),
-        content: `${message.content}\n${notice}`,
-        ...(message.textBlocks ? { textBlocks: [...message.textBlocks, { text: notice }] } : {})
-    };
-}
-/** SDK-owned ordered visual window; durable image references are never rewritten. */
-export class ResourceInputProjection {
-    useResourceUrl;
-    store;
-    sessionId;
-    options;
-    #entries = [];
-    #sources = new Map();
-    #candidates = new WeakMap();
-    #resourceReads = new Map();
-    #cachedBytes = 0;
-    #considered = -1;
-    #rollout = 0;
-    #evicted = -1;
-    constructor(useResourceUrl, store, sessionId, history, options = {}) {
-        this.useResourceUrl = useResourceUrl;
-        this.store = store;
-        this.sessionId = sessionId;
-        this.options = options;
-        const restored = inlineMediaHistory(options.records ?? []);
-        this.#rollout = restored.rollouts;
-        for (const cursor of restored.cursors)
-            this.#entries[this.#entry(cursor.sourceId, cursor.imageIndex)].rollout = cursor.rollout;
-        this.observe(history);
-        if (restored.state) {
-            this.#considered = this.#position(restored.state.consideredThrough);
-            this.#evicted = this.#position(restored.state.evictedThrough);
-        }
-        else if (options.records === undefined)
-            this.#considered = this.#entries.length - 1;
-    }
-    #entry(source, imageIndex) {
-        let positions = this.#sources.get(source);
-        if (!positions)
-            this.#sources.set(source, (positions = []));
-        let position = positions[imageIndex];
-        if (position === undefined) {
-            position = this.#entries.length;
-            positions[imageIndex] = position;
-            this.#entries.push({ source, imageIndex, active: false, rollout: this.#rollout });
-        }
-        return position;
-    }
-    #position(cursor) {
-        if (!cursor)
-            return -1;
-        const position = this.#sources.get(cursor.sourceId)?.[cursor.imageIndex];
-        if (position === undefined)
-            throw new MarAgentError('MAR_AGENT_SESSION_CORRUPT', 'Inline media boundary is missing.');
-        return position;
-    }
-    observe(messages) {
-        for (const message of messages)
-            for (const [index, image] of (message.images ?? []).entries()) {
-                const entry = this.#entries[this.#entry(inlineMediaSource(message), index)];
-                if (entry.image && !isDeepStrictEqual(entry.image, image))
-                    delete entry.unavailable;
-                entry.image = image;
-                entry.active = true;
-            }
-    }
-    /** Called only at an explicit context replacement, never as a history diff detector. */
-    replace(messages) {
-        this.releaseBytes();
-        for (const entry of this.#entries) {
-            entry.active = false;
-            delete entry.image;
-        }
-        this.observe(messages);
-    }
-    hasPendingImages(messages) {
-        return messages.some((message) => (message.images ?? []).some((_, index) => {
-            const position = this.#sources.get(inlineMediaSource(message))?.[index];
-            return position === undefined || position > this.#considered;
-        }));
-    }
-    /** Reference-only view shared by GC; no byte loading or new eviction decisions. */
-    historyView(messages) {
-        return this.#historyView(messages, this.#evicted);
-    }
-    #historyView(messages, evicted, fromEvicted = -1) {
-        return messages.map((message) => {
-            const positions = this.#sources
-                .get(inlineMediaSource(message))
-                ?.filter((position) => position > fromEvicted);
-            const images = message.images ??
-                positions?.flatMap((position) => {
-                    const entry = this.#entries[position];
-                    return entry.active && entry.image ? [entry.image] : [];
-                });
-            if (!images?.length)
-                return message;
-            const removed = new Set();
-            const unavailable = new Set();
-            const retained = [];
-            images.forEach((image, index) => {
-                const position = positions?.[index];
-                const entry = position === undefined ? undefined : this.#entries[position];
-                if (entry?.unavailable && isDeepStrictEqual(entry.image, image)) {
-                    removed.add(index);
-                    unavailable.add(index);
-                }
-                else if (!this.useResourceUrl &&
-                    positions?.[index] !== undefined &&
-                    positions[index] <= evicted)
-                    removed.add(index);
-                else
-                    retained[index] = image;
-            });
-            return projectRetainedImages({ ...message, images }, retained, removed, unavailable);
-        });
-    }
-    checkpoint(messages) {
-        const retained = messages && new Set(messages.map(inlineMediaSource));
-        const cursor = (through) => {
-            for (let index = through; index >= 0; index--) {
-                const entry = this.#entries[index];
-                if (typeof entry.source === 'string' && (!retained || retained.has(entry.source)))
-                    return { sourceId: entry.source, imageIndex: entry.imageIndex };
-            }
-            return undefined;
-        };
-        const consideredThrough = cursor(this.#considered);
-        const evictedThrough = cursor(this.#evicted);
-        return {
-            version: 1,
-            ...(consideredThrough ? { consideredThrough } : {}),
-            ...(evictedThrough ? { evictedThrough } : {})
-        };
-    }
-    async prepare(request, mirroredImages = [], canonicalMessages = request.messages) {
-        this.observe(canonicalMessages);
-        const through = this.#entries.length - 1;
-        const cached = new Map();
-        const project = (image, entry) => {
-            const key = entry && isDeepStrictEqual(entry.image, image) ? entry : image;
-            let value = cached.get(key);
-            if (!value)
-                cached.set(key, (value = this.#project(image, entry)));
-            return value;
-        };
-        const top = (request.images ?? []).filter((image) => !mirroredImages.some((mirror) => isDeepStrictEqual(image, mirror)));
-        const evicted = this.#evicted;
-        const messages = await Promise.all(request.messages.map(async (message) => {
-            if (!message.images?.length)
-                return message;
-            const removed = new Set();
-            const unavailable = new Set();
-            const images = [];
-            await Promise.all(message.images.map(async (image, index) => {
-                const position = this.#sources.get(inlineMediaSource(message))?.[index];
-                const entry = position === undefined ? undefined : this.#entries[position];
-                const original = entry?.image;
-                if (!this.useResourceUrl &&
-                    position !== undefined &&
-                    position <= evicted &&
-                    isDeepStrictEqual(original, image))
-                    removed.add(index);
-                else {
-                    const projected = await project(image, entry);
-                    if (projected)
-                        images[index] = projected;
-                    else {
-                        removed.add(index);
-                        unavailable.add(index);
-                    }
-                }
-            }));
-            return projectRetainedImages(message, images, removed, unavailable);
-        }));
-        const { images: _topImages, ...retained } = request;
-        const images = (await Promise.all(top.map((image) => project(image)))).filter((image) => image !== undefined);
-        const result = { ...retained, messages, ...(images.length ? { images } : {}) };
-        if (!this.useResourceUrl)
-            assertInlineMediaBudget(result);
-        this.#candidates.set(result.messages, through);
-        return result;
-    }
-    async complete(request) {
-        const candidate = this.#candidates.get(request.messages);
-        if (candidate === undefined)
-            return;
-        this.#candidates.delete(request.messages);
-        this.#rollout++;
-        const considered = Math.max(this.#considered, candidate);
-        if (considered === this.#considered)
-            return;
-        const before = this.#considered;
-        this.#considered = considered;
-        try {
-            await this.options.persist?.(this.checkpoint());
-        }
-        catch (error) {
-            this.#considered = before;
-            this.#rollout--;
-            throw error;
-        }
-    }
-    /** Propose a cursor; only the unified GC checkpoint may adopt it. */
-    async gcCandidate(request, mirroredImages = []) {
-        if (this.useResourceUrl)
-            return undefined;
-        const size = async (image, entry) => {
-            if (entry?.unavailable && isDeepStrictEqual(entry.image, image))
-                return 0;
-            const sized = image.byteSize !== undefined || image.dataBase64 !== undefined
-                ? image
-                : await this.#project(image, entry);
-            return sized ? inlineMediaBytes(sized) : 0;
-        };
-        const actualSize = async (image, entry) => {
-            const projected = await this.#project(image, entry);
-            return projected ? inlineMediaBytes(projected) : 0;
-        };
-        const history = await Promise.all(this.#entries.map(async (entry, index) => ({
-            index,
-            bytes: entry.active && entry.image && index > this.#evicted && index <= this.#considered
-                ? await size(entry.image, entry)
-                : 0
-        })));
-        let beforeBytes = history.reduce((sum, entry) => sum + entry.bytes, 0);
-        let freshBytes = 0;
-        let requestBytes = 0;
-        const requestHistory = new Map();
-        if (request) {
-            for (const message of request.messages)
-                for (const [index, image] of (message.images ?? []).entries()) {
-                    const position = this.#sources.get(inlineMediaSource(message))?.[index];
-                    const entry = position === undefined ? undefined : this.#entries[position];
-                    const original = entry && isDeepStrictEqual(entry.image, image);
-                    if (original && position <= this.#evicted)
-                        continue;
-                    const bytes = await actualSize(image, entry);
-                    requestBytes += bytes;
-                    if (original && position <= this.#considered) {
-                        requestHistory.set(position, (requestHistory.get(position) ?? 0) + bytes);
-                        history[position].bytes = bytes;
-                    }
-                    else
-                        freshBytes += bytes;
-                }
-            for (const image of request.images ?? []) {
-                if (mirroredImages.some((mirror) => isDeepStrictEqual(image, mirror)))
-                    continue;
-                const bytes = await actualSize(image);
-                freshBytes += bytes;
-                requestBytes += bytes;
-            }
-            beforeBytes = history.reduce((sum, item) => sum + item.bytes, 0);
-            if (freshBytes > policy.requestInlineMediaHardLimit)
-                inlineMediaLimit();
-        }
-        const hard = requestBytes > policy.requestInlineMediaHardLimit;
-        if (!hard && beforeBytes <= policy.historicalInlineMediaTarget)
-            return undefined;
-        const target = hard
-            ? Math.max(0, policy.historicalInlineMediaTarget - freshBytes)
-            : policy.historicalInlineMediaTarget;
-        let afterBytes = beforeBytes;
-        let evicted = this.#evicted;
-        for (const item of history) {
-            if (afterBytes <= target && (!hard || requestBytes <= policy.requestInlineMediaHardLimit))
-                break;
-            if (!item.bytes)
-                continue;
-            if (!hard && this.#rollout - this.#entries[item.index].rollout < 2)
-                break;
-            afterBytes -= item.bytes;
-            requestBytes -= requestHistory.get(item.index) ?? 0;
-            evicted = item.index;
-        }
-        if (afterBytes > target || (hard && requestBytes > policy.requestInlineMediaHardLimit))
-            return undefined;
-        const entry = this.#entries[evicted];
-        if (!entry || typeof entry.source !== 'string' || evicted <= this.#evicted)
-            return undefined;
-        return {
-            reason: hard
-                ? 'HARD_LIMIT'
-                : beforeBytes > policy.historicalInlineMediaTrigger
-                    ? 'SOFT_LIMIT'
-                    : 'TEXT_GC',
-            state: {
-                ...this.checkpoint(),
-                evictedThrough: { sourceId: entry.source, imageIndex: entry.imageIndex }
-            },
-            beforeBytes,
-            afterBytes,
-            project: (messages) => this.#historyView(messages, evicted, this.#evicted)
-        };
-    }
-    adoptGc(state) {
-        if (state) {
-            this.#evicted = this.#position(state.evictedThrough);
-            this.releaseBytes();
-        }
-    }
-    releaseBytes() {
-        this.#resourceReads.clear();
-        this.#cachedBytes = 0;
-    }
-    #readBytes(resourceId) {
-        const cached = this.#resourceReads.get(resourceId);
-        if (cached)
-            return cached;
-        const pending = this.store.readResource(this.sessionId, resourceId).then((resource) => {
-            if (this.#resourceReads.get(resourceId) === pending) {
-                const bytes = resource?.dataBase64 ? inlineMediaBytes(resource) : 0;
-                if (!bytes || this.#cachedBytes + bytes > policy.requestInlineMediaHardLimit)
-                    this.#resourceReads.delete(resourceId);
-                else
-                    this.#cachedBytes += bytes;
-            }
-            return resource;
-        }, (error) => {
-            if (this.#resourceReads.get(resourceId) === pending)
-                this.#resourceReads.delete(resourceId);
-            throw error;
-        });
-        this.#resourceReads.set(resourceId, pending);
-        return pending;
-    }
-    async #project(image, entry) {
-        const original = entry && isDeepStrictEqual(entry.image, image);
-        if (original && entry.unavailable)
-            return undefined;
-        if (this.useResourceUrl) {
-            if (!isModelImageUrl(image.url))
-                throw new MarAgentError('MAR_AGENT_RESOURCE_URL_UNAVAILABLE', 'Resource URL is unavailable.');
-            const { dataBase64: _bytes, ...reference } = image;
-            return reference;
-        }
-        let bytes;
-        try {
-            bytes =
-                image.dataBase64 !== undefined
-                    ? image
-                    : image.resourceId === undefined
-                        ? undefined
-                        : await this.#readBytes(image.resourceId);
-        }
-        catch (error) {
-            if (!(error instanceof MarAgentError) || error.code !== 'MAR_AGENT_IMAGE_UNAVAILABLE')
-                throw error;
-        }
-        if (!bytes?.dataBase64) {
-            if (original)
-                entry.unavailable = true;
-            return undefined;
-        }
-        const { url: _url, urlExpiresAt: _expires, ...reference } = image;
-        return { ...reference, dataBase64: bytes.dataBase64 };
-    }
-}

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

@@ -1,94 +0,0 @@
-import type { SessionStore } from '../session/store/contracts.js';
-import type { ContextualWorldState } from '../runtime/context/world-state.js';
-import type { ResolvedModelConfiguration } from './model-runtime.js';
-import { ExecutionToolSources } from './extension-tools.js';
-import type { ExtensionManager } from '../extensions/manager.js';
-import type { CoreOperationContext } from '../extensions/operation.js';
-import { ExtensionRequestSnapshots } from '../extensions/model-request.js';
-import { SessionInputCoordinator, type CoreSessionBackend } from '../extensions/session-input.js';
-import type { CoreAgentsBackend } from '../extensions/agents.js';
-import type { HostDescription, MarAgentHost } from '../host/contracts.js';
-import type { MarAgentReasoningEffort } from '../model/configuration.js';
-import type { ModelAdapter, ModelMessage } from '../model/contracts.js';
-import { CompactRequests } from '../runtime/compaction/requests.js';
-import { SubagentSessionController, type SubagentMailboxMessage, type SubagentMessageDelivery, type SubagentTurnHandle } from '../subagent/session-controller.js';
-import { createSessionToolScheduler } from '../tools/scheduler.js';
-import { TodoStore } from '../tools/agent/todo.js';
-import type { CreateMarAgentOptions, ExecutionMode, ExecutionResult, MarAgentSession } from './types.js';
-interface SessionExecutionContext {
-    readonly executionId: string;
-    readonly modelId: string;
-    readonly mode: ExecutionMode;
-    readonly models: ReadonlyMap<string, ResolvedModelConfiguration>;
-    readonly instruction: string | undefined;
-    steer?: (input: import('./types.js').SteerInput) => Promise<import('./types.js').SteerResult>;
-    compactRequests?: CompactRequests;
-    requestMessages?: {
-        read(): readonly ModelMessage[];
-    };
-    appendedMessages?: {
-        append(recordId: string, message: ModelMessage): void;
-    };
-    toolSources?: ExecutionToolSources;
-}
-export interface SessionRuntime {
-    execution?: SessionExecutionContext;
-    todo?: TodoStore;
-    readonly scheduleTool: ReturnType<typeof createSessionToolScheduler>;
-    readonly sourceType: 'user' | 'subagent';
-    adapterGeneration: number;
-    adapters: Map<string, ModelAdapter>;
-    contextualWorldState?: ContextualWorldState;
-    subagents?: SubagentSessionController;
-    subagentsOpening?: Promise<SubagentSessionController>;
-    inputs?: SessionInputCoordinator;
-    requestSnapshots?: ExtensionRequestSnapshots;
-    recordProjection?: Promise<unknown>;
-    sessionBackend?: CoreSessionBackend & {
-        kick(): void;
-    };
-    agentsBackend?: CoreAgentsBackend;
-}
-interface InternalMarAgentSession extends MarAgentSession {
-    startSubagentTurn(input: {
-        readonly permissionMode?: import('../tools/permissions.js').PermissionMode;
-        readonly prompt: string;
-        readonly modelId: string;
-        readonly reasoningEffort: MarAgentReasoningEffort;
-        readonly role: 'general-purpose' | 'explore';
-        readonly initialMailbox: readonly SubagentMailboxMessage[];
-        readonly turnId: string;
-        readonly delivery?: SubagentMessageDelivery;
-        readonly mcpExecutionScopeId?: string;
-        readonly origin?: CoreOperationContext;
-    }): SubagentTurnHandle;
-}
-/** Agent-owned registries shared with Session orchestration, not public execution state. */
-export interface AgentSessionRegistry {
-    readonly active: Map<string, AbortController>;
-    readonly activeExecutionAdapters: Set<ModelAdapter>;
-    readonly executionResults: Map<string, Promise<ExecutionResult>>;
-    readonly sessionRuntimes: Map<string, SessionRuntime>;
-    readonly sessionWriterOwner: object;
-}
-interface SessionServices {
-    readonly host: MarAgentHost;
-    readonly description: HostDescription;
-    readonly settings: Pick<CreateMarAgentOptions, 'workspaceMapping' | 'systemInstruction'>;
-    readonly store: SessionStore;
-    readonly extensions: ExtensionManager;
-    readonly registry: AgentSessionRegistry;
-    readonly hasCustomAdapters: boolean;
-    readonly modelState: () => {
-        readonly models: ReadonlyMap<string, ResolvedModelConfiguration>;
-        readonly defaultModelId: string;
-        readonly generation: number;
-    };
-    readonly createAdapter: (modelId: string, models: ReadonlyMap<string, ResolvedModelConfiguration>) => ModelAdapter;
-    readonly activeAdaptersExcept: (sessionId: string) => ReadonlySet<ModelAdapter>;
-    readonly assertCanStart: (sessionId?: string) => void;
-    readonly assertSessionAdmission: (sessionId?: string) => void;
-}
-/** SDK Session orchestration owns warm resources; Runtime owns only the model/tool loop. */
-export declare function createSessionOpener(services: SessionServices): (sessionId: string, workspace?: string) => Promise<InternalMarAgentSession>;
-export {};