@myagentroam/agent 0.9.141 → 0.9.143

package/dist/sdk/types.d.ts

@@ -1,349 +0,0 @@
-import type { HostDescription } from '../host/contracts.js';
-import type { MarAgentModelConfiguration, MarAgentReasoningEffort } from '../model/configuration.js';
-import type { ClientToolDefinition } from '../model/contracts.js';
-import type { MarAgentSessionPage, MarAgentSessionSummary } from '../session/catalog.js';
-import type { SessionListInput, SessionSource } from '../session/types.js';
-import type { CodeModeStateEntry, CodeModeStateMutation } from '../tools/code-mode/state.js';
-/** @deprecated MAR Agent always executes tools directly through the Host. */
-export type AccessMode = 'full-access';
-export type ExecutionMode = 'run' | 'plan' | 'compact';
-export interface ToolCall {
-    name: string;
-    arguments: unknown;
-    callId?: string;
-}
-export interface ToolExecutionContext {
-    mode: ExecutionMode;
-    signal: AbortSignal;
-    sessionId: string;
-    executionId: string;
-    recentImages?: readonly {
-        readonly mimeType: string;
-        readonly data: Buffer;
-    }[];
-    codeMode?: {
-        retainSession?(): Promise<() => Promise<void>>;
-        onSettled?(result: CodeCellEventData): Promise<void>;
-        supportsImages?: boolean;
-        tools: readonly import('../model/contracts.js').ClientToolDefinition[];
-        state?: readonly CodeModeStateEntry[];
-        commitState?(mutations: readonly CodeModeStateMutation[]): Promise<readonly CodeModeStateEntry[]>;
-        invoke(call: ToolCall, signal: AbortSignal): Promise<ToolExecutionResult>;
-    };
-}
-export interface McpToolCatalogContext extends Pick<ToolExecutionContext, 'sessionId' | 'executionId'> {
-    executionScopeId?: string;
-    claimExecutionScope?: boolean;
-}
-export interface McpToolCatalog {
-    readonly revision: string;
-    readonly servers: readonly {
-        readonly id: string;
-        readonly name: string;
-        readonly description?: string;
-        readonly instructions?: string;
-    }[];
-    readonly tools: readonly McpCatalogTool[];
-}
-export interface McpCatalogTool {
-    readonly definition: import('../model/contracts.js').ClientToolDefinition;
-    readonly serverId: string;
-    readonly rawName: string;
-    readonly sourceIdentity: string;
-    readonly definitionRevision: string;
-    readonly lifetime: 'session' | 'execution';
-    readonly exposure: 'direct' | 'deferred';
-    /** Untrusted MCP hints; never an authorization or parallel-safety decision. */
-    readonly annotations?: Readonly<Record<string, unknown>>;
-}
-export interface McpToolCallContext extends Pick<ToolExecutionContext, 'sessionId' | 'executionId'> {
-    readonly mode?: ExecutionMode;
-    readonly expectedTool?: {
-        readonly sourceIdentity: string;
-        readonly definitionRevision: string;
-    };
-}
-export interface HostSkill {
-    readonly name: string;
-    readonly description: string;
-    readonly requiredTools: readonly string[];
-    load(): Promise<string>;
-}
-export interface HostExecutionExtensions {
-    readonly tools?: readonly import('../model/contracts.js').ClientToolDefinition[];
-    readonly skills?: readonly HostSkill[];
-}
-export interface MarAgentToolImageArtifact {
-    kind: 'image';
-    name: string;
-    mimeType: 'image/png';
-    byteSize: number;
-    sha256: string;
-    fileName: string;
-}
-export type MarAgentToolArtifact = MarAgentToolImageArtifact;
-export interface ToolExecutionResult {
-    content: string;
-    data?: unknown;
-    /** Runtime-only definitions used to encode a Tool Search output. */
-    toolSearchTools?: readonly ClientToolDefinition[];
-    truncated?: boolean;
-    images?: readonly {
-        mimeType: string;
-        dataBase64: string;
-    }[];
-    artifacts?: readonly MarAgentToolArtifact[];
-}
-export interface CodeCellEventData {
-    cellId: string;
-    status: 'running' | 'completed' | 'failed' | 'cancelled';
-    cached?: boolean;
-}
-export interface HostSessionResourceSnapshot {
-    codeCells?: readonly {
-        cellId: string;
-        status: 'running' | 'completed' | 'failed' | 'cancelled';
-        executionId: string;
-    }[];
-    idleTtlMs?: number;
-    processes: readonly {
-        processId: string;
-        status: 'running' | 'completed' | 'cancelled';
-        command: string;
-        cwd: string;
-    }[];
-}
-/** The Host owns workspace/tool effects; the SDK owns JSONL storage beneath its supplied HOME. */
-export interface MarAgentHost {
-    describe(): Promise<HostDescription>;
-    executeTool(call: ToolCall, context: ToolExecutionContext): Promise<ToolExecutionResult>;
-    listExecutionExtensions?(context: McpToolCatalogContext): Promise<HostExecutionExtensions>;
-    emit(event: MarAgentEvent): Promise<void> | void;
-    requestUserInput?(input: {
-        requestId: string;
-        questions: unknown[];
-    }, signal: AbortSignal): Promise<Record<string, unknown>>;
-    listMcpTools?(context?: McpToolCatalogContext): Promise<readonly import('../model/contracts.js').ClientToolDefinition[]>;
-    listMcpToolCatalog?(context: McpToolCatalogContext): Promise<McpToolCatalog>;
-    callMcpTool?(call: ToolCall, signal: AbortSignal, context?: McpToolCallContext): Promise<ToolExecutionResult>;
-    listSessionResources?(sessionId: string): Promise<HostSessionResourceSnapshot>;
-    disposeSessionResources?(sessionId: string): Promise<void>;
-    dispose(): Promise<void>;
-}
-export interface MarAgentEventBase {
-    eventId: string;
-    sequence: number;
-    timestamp: string;
-    sessionId: string;
-    executionId: string;
-    turnId?: string;
-}
-export type MarAgentEvent = MarAgentEventBase & ({
-    type: 'execution.started';
-    mode: ExecutionMode;
-} | {
-    type: 'message.delta';
-    itemId: string;
-    phase: 'commentary' | 'final_answer';
-    delta: string;
-} | {
-    type: 'message.completed';
-    itemId: string;
-    phase: 'commentary' | 'final_answer';
-    text: string;
-    modelId: string;
-    modelName: string;
-} | {
-    type: 'model.performance';
-    latencyMs: number;
-    outputTokens?: number | undefined;
-    outputDurationMs?: number | undefined;
-    tokensPerSecond?: number | undefined;
-} | {
-    /** Legacy history event; new executions publish model.performance instead. */
-    type: 'message.performance';
-    itemId: string;
-    ttftMs: number;
-    outputTokens?: number | undefined;
-    outputDurationMs?: number | undefined;
-    tokensPerSecond?: number | undefined;
-} | {
-    type: 'plan.completed';
-    itemId: string;
-    text: string;
-} | {
-    type: 'reasoning.summary';
-    text: string;
-} | {
-    type: 'hosted_tool.updated';
-    itemId: string;
-    kind: 'WEB_SEARCH' | 'WEB_FETCH';
-    status: 'RUNNING' | 'COMPLETED' | 'FAILED';
-    summary: {
-        query?: string | undefined;
-        url?: string | undefined;
-        title?: string | undefined;
-        sources?: readonly {
-            url: string;
-            title?: string | undefined;
-        }[] | undefined;
-        sourcesTruncated?: boolean | undefined;
-    };
-} | {
-    type: 'citation.added';
-    id: string;
-    url: string;
-    title?: string;
-} | {
-    type: 'tool.started';
-    toolName: string;
-    callId: string;
-    parentCallId?: string;
-    input?: unknown;
-} | {
-    type: 'tool.completed';
-    toolName: string;
-    callId: string;
-    parentCallId?: string;
-    summary: string;
-    truncated?: boolean;
-    artifacts?: readonly MarAgentToolArtifact[];
-    data?: CodeCellEventData | import('../tools/exec.js').ExecResult | Omit<import('../tools/exec.js').ExecResult, 'stdout' | 'stderr'> | import('../tools/apply-patch.js').ApplyPatchResult | import('../tools/read.js').ReadEventData | import('../tools/view-image.js').ViewImageResult | import('../subagent/scheduler.js').SubagentTaskSnapshot;
-} | {
-    type: 'tool.failed';
-    toolName: string;
-    callId: string;
-    parentCallId?: string;
-    code: string;
-    message?: string;
-} | {
-    type: 'usage.updated';
-    inputTokens?: number | undefined;
-    contextInputTokens?: number | undefined;
-    outputTokens?: number | undefined;
-    cacheReadTokens?: number | undefined;
-    cacheWriteTokens?: number | undefined;
-} | {
-    type: 'todo.updated';
-    revision: number;
-    items: readonly import('../tools/todo.js').TodoItem[];
-} | {
-    type: 'user_input.requested';
-    requestId: string;
-    questions: unknown[];
-} | {
-    type: 'user_input.resolved';
-    requestId: string;
-} | {
-    type: 'subagent.started';
-    agentId: string;
-    description: string;
-    modelId?: string;
-    modelName?: string;
-    reasoningEffort?: MarAgentReasoningEffort;
-} | {
-    type: 'subagent.completed';
-    agentId: string;
-    description?: string;
-    status: string;
-    modelId?: string;
-    modelName?: string;
-    reasoningEffort?: MarAgentReasoningEffort;
-    latestMessage?: import('../subagent/scheduler.js').SubagentLatestMessage;
-    latestActivity?: import('../subagent/scheduler.js').SubagentLatestActivity;
-    errorCode?: string;
-    errorMessage?: string;
-} | {
-    type: 'execution.completed';
-} | {
-    type: 'execution.failed';
-    code: string;
-    message?: string;
-} | {
-    type: 'execution.cancelled';
-} | {
-    type: 'context.compacting';
-    compactionId: string;
-} | {
-    type: 'context.compacted';
-    compactionId: string;
-});
-export interface RunInputImage {
-    name: string;
-    mimeType: string;
-    dataBase64: string;
-}
-export interface MarAgentImageMetadata {
-    name: string;
-    mimeType: string;
-    byteSize: number;
-}
-export interface RunInput {
-    prompt: string;
-    clientMessageId?: string;
-    modelId?: string;
-    reasoningEffort?: MarAgentReasoningEffort;
-    /** @deprecated Accepted for source compatibility and otherwise ignored. */
-    access?: AccessMode;
-    images?: readonly RunInputImage[];
-}
-export interface CreateSessionInput {
-    workspace: string;
-    title?: string;
-}
-export interface ExecutionResult {
-    executionId: string;
-    status: 'completed' | 'failed' | 'cancelled';
-    finalAnswer: string;
-    errorCode?: string;
-    errorMessage?: string;
-}
-/** A live execution exposes streamed events separately from its terminal result. */
-export interface ExecutionHandle extends AsyncIterable<MarAgentEvent> {
-    readonly executionId: string;
-    result(): Promise<ExecutionResult>;
-    /** Signals abort; await result() to observe the terminal status and cleanup. */
-    cancel(): void;
-}
-/** 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;
-    cancel(executionId: string): Promise<void>;
-}
-export interface MarAgent {
-    createSession(input: CreateSessionInput): Promise<MarAgentSession>;
-    openSession(sessionId: string): Promise<MarAgentSession>;
-    listSessions(input?: SessionListInput): Promise<MarAgentSessionPage>;
-    clearSession(sessionId: string): Promise<void>;
-    /** Rebinds future main executions only; running subagents keep their captured model providers. */
-    reconfigureModels(input: {
-        readonly models: readonly MarAgentModelConfiguration[];
-        readonly defaultModelId?: string;
-    }): Promise<void>;
-    deleteSession(sessionId: string): Promise<void>;
-    /** Cancels active executions, then closes SDK-owned providers, the Host and the Session store. */
-    dispose(): Promise<void>;
-}
-export interface RolloutBudgetOptions {
-    limitTokens?: number;
-    conserveAtRemainingTokens?: number;
-    finalizeAtRemainingTokens?: number;
-    samplingTokenWeight?: number;
-    prefillTokenWeight?: number;
-}
-export interface CreateMarAgentOptions {
-    mode: 'normal' | 'node';
-    host: MarAgentHost;
-    models: readonly MarAgentModelConfiguration[];
-    defaultModelId?: string;
-    systemInstruction?: string;
-    workspaceMapping?: {
-        readonly logicalPath: string;
-        readonly physicalPath: string;
-    };
-    rolloutBudget?: false | RolloutBudgetOptions;
-}
-export type { MarAgentSessionSummary, SessionListInput, SessionSource };

package/dist/subagent/scheduler.d.ts

@@ -1,206 +0,0 @@
-import { type MarAgentReasoningEffort } from '../model/configuration.js';
-export interface SubagentTaskInput {
-    description: string;
-    prompt: string;
-    role: 'general-purpose' | 'explore';
-    modelId?: string;
-    reasoningEffort?: MarAgentReasoningEffort;
-    background?: boolean;
-    parentSubagentId?: string;
-}
-export interface SubagentTaskResult {
-    summary: string;
-    changedFiles: string[];
-    verification: string[];
-    evidence: Array<{
-        path: string;
-        startLine?: number;
-        endLine?: number;
-    }>;
-}
-export interface SubagentLatestMessage {
-    itemId: string;
-    turnId: string;
-    phase: 'commentary' | 'final_answer';
-    text: string;
-    timestamp: string;
-    truncated: boolean;
-}
-export type SubagentLatestActivity = {
-    kind: 'message';
-    timestamp: string;
-    phase: 'commentary' | 'final_answer';
-} | {
-    kind: 'tool';
-    timestamp: string;
-    toolName: string;
-    status: 'started' | 'completed' | 'failed';
-};
-export interface SubagentTaskSnapshot extends Record<string, unknown> {
-    agentId: string;
-    description: string;
-    status: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled' | 'interrupted';
-    modelId?: string;
-    modelName?: string;
-    reasoningEffort?: MarAgentReasoningEffort;
-    latestMessage?: SubagentLatestMessage;
-    latestActivity?: SubagentLatestActivity;
-    summary?: string;
-    changedFiles?: string[];
-    verification?: string[];
-    evidence?: Array<{
-        path: string;
-        startLine?: number;
-        endLine?: number;
-    }>;
-    errorCode?: string;
-    errorMessage?: string;
-    messageId?: string;
-    turnId?: string;
-    deliveryStatus?: 'accepted' | 'applied' | 'cancelled' | 'failed';
-    waitOutcome?: SubagentWaitOutcome;
-}
-export type SubagentWaitFor = 'completion' | 'message';
-export type SubagentWaitOutcome = 'snapshot' | 'message' | 'completion' | 'timeout';
-export interface SubagentMessageOptions {
-    delivery?: 'append' | 'replace';
-    signal?: AbortSignal;
-}
-export interface SubagentRunOptions {
-    signal?: AbortSignal;
-    onCreated?: (task: SubagentTaskSnapshot) => Promise<void> | void;
-}
-export interface SubagentOutputOptions {
-    waitMs?: number;
-    waitFor?: SubagentWaitFor;
-    signal?: AbortSignal;
-}
-export interface SubagentController {
-    beginExecution?(runner: (task: SubagentTaskInput, signal: AbortSignal) => Promise<SubagentTaskResult>): void;
-    run(input: SubagentTaskInput, options?: SubagentRunOptions): Promise<SubagentTaskSnapshot>;
-    output(agentId: string, options?: SubagentOutputOptions): Promise<SubagentTaskSnapshot>;
-    outputAny(options?: SubagentOutputOptions): Promise<SubagentTaskSnapshot>;
-    message(agentId: string, message: string, options?: SubagentMessageOptions): Promise<SubagentTaskSnapshot>;
-    cancel(agentId: string): Promise<SubagentTaskSnapshot>;
-    listSessionResources(): readonly {
-        agentId: string;
-        status: SubagentTaskSnapshot['status'];
-        description: string;
-    }[];
-    dispose(): Promise<void>;
-}
-export declare class SubagentScheduler implements SubagentController {
-    #private;
-    readonly limits: {
-        maxTasks: number;
-        maxConcurrent: number;
-    };
-    constructor(runner: (task: SubagentTaskInput, signal: AbortSignal) => Promise<SubagentTaskResult>, limits?: {
-        maxTasks: number;
-        maxConcurrent: number;
-    });
-    beginExecution(runner: (task: SubagentTaskInput, signal: AbortSignal) => Promise<SubagentTaskResult>): void;
-    run(input: SubagentTaskInput, options?: SubagentRunOptions): Promise<SubagentTaskSnapshot>;
-    output(agentId: string, options?: SubagentOutputOptions): Promise<{
-        waitOutcome: "snapshot";
-        agentId: string;
-        description: string;
-        status: "queued" | "running" | "completed" | "failed" | "cancelled" | "interrupted";
-        modelId?: string;
-        modelName?: string;
-        reasoningEffort?: MarAgentReasoningEffort;
-        latestMessage?: SubagentLatestMessage;
-        latestActivity?: SubagentLatestActivity;
-        summary?: string;
-        changedFiles?: string[];
-        verification?: string[];
-        evidence?: Array<{
-            path: string;
-            startLine?: number;
-            endLine?: number;
-        }>;
-        errorCode?: string;
-        errorMessage?: string;
-        messageId?: string;
-        turnId?: string;
-        deliveryStatus?: "accepted" | "applied" | "cancelled" | "failed";
-    } | {
-        waitOutcome: "completion" | "timeout";
-        agentId: string;
-        description: string;
-        status: "queued" | "running" | "completed" | "failed" | "cancelled" | "interrupted";
-        modelId?: string;
-        modelName?: string;
-        reasoningEffort?: MarAgentReasoningEffort;
-        latestMessage?: SubagentLatestMessage;
-        latestActivity?: SubagentLatestActivity;
-        summary?: string;
-        changedFiles?: string[];
-        verification?: string[];
-        evidence?: Array<{
-            path: string;
-            startLine?: number;
-            endLine?: number;
-        }>;
-        errorCode?: string;
-        errorMessage?: string;
-        messageId?: string;
-        turnId?: string;
-        deliveryStatus?: "accepted" | "applied" | "cancelled" | "failed";
-    }>;
-    outputAny(options?: SubagentOutputOptions): Promise<{
-        waitOutcome: "snapshot";
-        agentId: string;
-        description: string;
-        status: "queued" | "running" | "completed" | "failed" | "cancelled" | "interrupted";
-        modelId?: string;
-        modelName?: string;
-        reasoningEffort?: MarAgentReasoningEffort;
-        latestMessage?: SubagentLatestMessage;
-        latestActivity?: SubagentLatestActivity;
-        summary?: string;
-        changedFiles?: string[];
-        verification?: string[];
-        evidence?: Array<{
-            path: string;
-            startLine?: number;
-            endLine?: number;
-        }>;
-        errorCode?: string;
-        errorMessage?: string;
-        messageId?: string;
-        turnId?: string;
-        deliveryStatus?: "accepted" | "applied" | "cancelled" | "failed";
-    } | {
-        waitOutcome: "completion" | "timeout";
-        agentId: string;
-        description: string;
-        status: "queued" | "running" | "completed" | "failed" | "cancelled" | "interrupted";
-        modelId?: string;
-        modelName?: string;
-        reasoningEffort?: MarAgentReasoningEffort;
-        latestMessage?: SubagentLatestMessage;
-        latestActivity?: SubagentLatestActivity;
-        summary?: string;
-        changedFiles?: string[];
-        verification?: string[];
-        evidence?: Array<{
-            path: string;
-            startLine?: number;
-            endLine?: number;
-        }>;
-        errorCode?: string;
-        errorMessage?: string;
-        messageId?: string;
-        turnId?: string;
-        deliveryStatus?: "accepted" | "applied" | "cancelled" | "failed";
-    }>;
-    cancel(agentId: string): Promise<SubagentTaskSnapshot>;
-    message(_agentId: string, _message: string): Promise<SubagentTaskSnapshot>;
-    listSessionResources(): {
-        agentId: string;
-        status: "completed" | "cancelled" | "running" | "queued" | "failed";
-        description: string;
-    }[];
-    dispose(): Promise<void>;
-}

package/dist/tools/agent-cancel.d.ts

@@ -1,7 +0,0 @@
-import type { ClientToolDefinition } from '../model/contracts.js';
-import type { ToolRuntimeContext } from './runtime-context.js';
-export declare const agentCancelToolDefinition: ClientToolDefinition;
-export declare function executeAgentCancel(arguments_: unknown, context: ToolRuntimeContext): Promise<{
-    content: string;
-    data: import("../subagent/scheduler.js").SubagentTaskSnapshot;
-}>;

package/dist/tools/agent-message.d.ts

@@ -1,7 +0,0 @@
-import type { ClientToolDefinition } from '../model/contracts.js';
-import type { ToolRuntimeContext } from './runtime-context.js';
-export declare const agentMessageToolDefinition: ClientToolDefinition;
-export declare function executeAgentMessage(arguments_: unknown, context: ToolRuntimeContext): Promise<{
-    content: string;
-    data: import("../subagent/scheduler.js").SubagentTaskSnapshot;
-}>;

package/dist/tools/agent-wait.d.ts

@@ -1,7 +0,0 @@
-import type { ClientToolDefinition } from '../model/contracts.js';
-import type { ToolRuntimeContext } from './runtime-context.js';
-export declare const agentWaitToolDefinition: ClientToolDefinition;
-export declare function executeAgentWait(arguments_: unknown, context: ToolRuntimeContext): Promise<{
-    content: string;
-    data: import("../subagent/scheduler.js").SubagentTaskSnapshot;
-}>;

package/dist/tools/apply-patch.d.ts

@@ -1,32 +0,0 @@
-import type { ClientToolDefinition } from '../model/contracts.js';
-import { WorkspacePathResolver } from './shared/path-resolver.js';
-export declare const applyPatchToolDefinition: ClientToolDefinition;
-export interface ApplyPatchFileResult {
-    path: string;
-    targetPath?: string;
-    operation: 'added' | 'modified' | 'deleted' | 'moved';
-    addedLines: number;
-    deletedLines: number;
-}
-export interface ApplyPatchResult {
-    files: ApplyPatchFileResult[];
-    totals: {
-        files: number;
-        addedLines: number;
-        deletedLines: number;
-    };
-}
-interface PatchFileOperations {
-    rename(source: string, target: string): Promise<void>;
-    rm(path: string, options?: {
-        force?: boolean;
-        recursive?: boolean;
-    }): Promise<void>;
-}
-export declare class ApplyPatchTool {
-    #private;
-    private readonly paths;
-    constructor(paths: WorkspacePathResolver, operations?: Partial<PatchFileOperations>);
-    execute(patch: string): Promise<ApplyPatchResult>;
-}
-export {};