@xenosystem/agent-sdk 0.10.32 → 0.10.34

package/dist/mcp/index.d.ts

@@ -38,6 +38,202 @@ interface PermissionProfile {
         startProcesses: PermissionProfileDecision;
     };
 }
+declare const WEB_CONTEXT_TOOL_RESULT_SCHEMA: "xeno.web-context.tool-result.v1";
+interface WebContextEvidenceProjection {
+    evidenceId: string;
+    requestId: string;
+    sourceUrl: string;
+    finalUrl?: string;
+    citations: Array<{
+        url: string;
+        title?: string;
+        artifactId?: string;
+    }>;
+}
+interface WebContextToolResult {
+    schemaVersion: typeof WEB_CONTEXT_TOOL_RESULT_SCHEMA;
+    operation: "search" | "fetch";
+    requestId: string;
+    evidence: WebContextEvidenceProjection;
+    job?: {
+        jobId: string;
+        state: string;
+    };
+    artifact?: {
+        artifactId: string;
+        mediaType: string;
+        bytes: number;
+    };
+    jobProgress?: WebJobProgress;
+}
+interface ToolDefinition {
+    name: string;
+    description: string;
+    input_schema: {
+        type: "object";
+        properties: Record<string, unknown>;
+        required?: string[];
+        additionalProperties?: boolean | Record<string, unknown>;
+        [keyword: string]: unknown;
+    };
+}
+interface ImageUrlBlock {
+    type: "image_url";
+    image_url: {
+        url: string;
+        detail?: "auto" | "low" | "high";
+    };
+}
+interface ResourceContentBlock {
+    type: "resource";
+    uri?: string;
+    mimeType?: string;
+    text?: string;
+    data?: string;
+}
+type ToolAssistantContentBlock = TextBlock | ImageUrlBlock | ResourceContentBlock;
+declare const TOOL_OPERATION_TERMINAL_STATES: readonly [
+    "completed",
+    "failed",
+    "timed_out",
+    "cancelled",
+    "outcome_unknown",
+    "orphaned"
+];
+type ToolOperationTerminalState = (typeof TOOL_OPERATION_TERMINAL_STATES)[number];
+type ToolOperationState = "registered" | "starting" | "running_foreground" | "running_background" | "waiting_for_input" | "stalled" | "verifying" | ToolOperationTerminalState;
+type ToolCompletionPolicy = "await" | "observe" | "detach";
+interface ExpectedOutputContract {
+    path: string;
+    kind?: "file" | "directory";
+    nonEmpty?: boolean;
+}
+interface ToolEvidence {
+    id: string;
+    kind: "artifact" | "process" | "verification";
+    status: "pending" | "verified" | "failed";
+    path?: string;
+    observedAt: string;
+    operationId: string;
+    detail?: Record<string, string | number | boolean | null>;
+}
+interface ToolOperationSnapshot {
+    schemaVersion: 1;
+    operationId: string;
+    turnId: string;
+    generation: number;
+    toolCallId: string;
+    toolName: string;
+    ownerSessionId?: string;
+    state: ToolOperationState;
+    terminal: boolean;
+    presentation: "foreground" | "background";
+    completionPolicy: ToolCompletionPolicy;
+    promotable: boolean;
+    processId?: string;
+    taskId?: string;
+    displayName?: string;
+    pid?: number;
+    commandFingerprint?: string;
+    outputPath?: string;
+    startedAt: string;
+    lastActivityAt: string;
+    deadlineAt?: string;
+    elapsedMs: number;
+    idleMs: number;
+    outputBytes: number;
+    nextOffset: number;
+    exitCode?: number | null;
+    completionReason?: string;
+    suggestedNextAction?: string;
+    expectedOutputs?: ExpectedOutputContract[];
+    evidence?: ToolEvidence[];
+}
+interface ToolProgressUpdate {
+    activity?: "stdout" | "stderr" | "input" | "waiting_for_input" | "heartbeat" | "state";
+    message?: string;
+    bytes?: number;
+    outputBytes?: number;
+    nextOffset?: number;
+    webContextProgress?: WebJobProgress;
+}
+interface ToolAuthorizationReceipt {
+    turnId: string;
+    toolCallId: string;
+    toolName: string;
+    iteration: number;
+    policy: {
+        allowed: true;
+        reason: string;
+        temporaryOverride: boolean;
+    };
+    permission: {
+        allowed: true;
+        reason: string;
+    };
+    elevation?: {
+        network: boolean;
+        directories: string[];
+        justification: string;
+    };
+}
+interface ToolResult {
+    success: boolean;
+    output: string;
+    error?: string;
+    errorCode?: string;
+    errorDetails?: Record<string, unknown>;
+    assistantContent?: ToolAssistantContentBlock[];
+    assistantOnlyContent?: ToolAssistantContentBlock[];
+    operation?: ToolOperationSnapshot;
+    evidence?: ToolEvidence[];
+    webContext?: WebContextToolResult;
+    retryable?: boolean;
+}
+interface ToolExecutionContext {
+    signal?: AbortSignal;
+    operationId?: string;
+    reportProgress?: (event: ToolProgressUpdate) => void;
+    authorization?: ToolAuthorizationReceipt;
+    ownerSessionId?: string;
+}
+interface ToolPolicyProjectionContext {
+    ownerSessionId?: string;
+}
+type ToolExecutor = (input: Record<string, unknown>, context?: ToolExecutionContext) => Promise<ToolResult>;
+interface ToolPolicyProjection {
+    observabilityInput: Record<string, unknown>;
+    permissionInput: Record<string, unknown>;
+    permissionPreview?: string;
+    approvalKey?: string;
+    riskLevel?: "low" | "medium" | "high";
+}
+interface ToolAnnotationHints {
+    title?: string;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
+interface ToolOrigin {
+    kind: "mcp";
+    server: string;
+    tool: string;
+}
+interface RegisteredTool {
+    definition: ToolDefinition;
+    execute: ToolExecutor;
+    readOnly?: boolean;
+    annotations?: ToolAnnotationHints;
+    origin?: ToolOrigin;
+    projectPolicyInput?: (input: Record<string, unknown>, context?: ToolPolicyProjectionContext) => ToolPolicyProjection | {
+        error: ToolResult;
+    };
+}
+interface TextBlock {
+    type: "text";
+    text: string;
+}
 declare const MCP_APPS_EXTENSION_ID: "io.modelcontextprotocol/ui";
 declare const MCP_APP_RESOURCE_SCHEME: "ui:";
 declare const MCP_APP_MIME_TYPE: "text/html;profile=mcp-app";
@@ -136,6 +332,7 @@ interface MCPTool {
     description: string;
     inputSchema: Record<string, unknown>;
     server: string;
+    annotations?: ToolAnnotationHints;
     _meta?: MCPAppExtensionMetadata;
     appResourceUri?: string;
     visibility: MCPAppVisibility[];
@@ -232,6 +429,7 @@ interface MCPToolsListResult {
         name: string;
         description?: string;
         inputSchema: Record<string, unknown>;
+        annotations?: Record<string, unknown>;
         _meta?: MCPAppExtensionMetadata;
     }>;
 }
@@ -497,188 +695,6 @@ declare class MCPManager {
     private resolveApprovalDecision;
     private emitServerStateChanged;
 }
-declare const WEB_CONTEXT_TOOL_RESULT_SCHEMA: "xeno.web-context.tool-result.v1";
-interface WebContextEvidenceProjection {
-    evidenceId: string;
-    requestId: string;
-    sourceUrl: string;
-    finalUrl?: string;
-    citations: Array<{
-        url: string;
-        title?: string;
-        artifactId?: string;
-    }>;
-}
-interface WebContextToolResult {
-    schemaVersion: typeof WEB_CONTEXT_TOOL_RESULT_SCHEMA;
-    operation: "search" | "fetch";
-    requestId: string;
-    evidence: WebContextEvidenceProjection;
-    job?: {
-        jobId: string;
-        state: string;
-    };
-    artifact?: {
-        artifactId: string;
-        mediaType: string;
-        bytes: number;
-    };
-    jobProgress?: WebJobProgress;
-}
-interface ToolDefinition {
-    name: string;
-    description: string;
-    input_schema: {
-        type: "object";
-        properties: Record<string, unknown>;
-        required?: string[];
-        additionalProperties?: boolean | Record<string, unknown>;
-        [keyword: string]: unknown;
-    };
-}
-interface ImageUrlBlock {
-    type: "image_url";
-    image_url: {
-        url: string;
-        detail?: "auto" | "low" | "high";
-    };
-}
-interface ResourceContentBlock {
-    type: "resource";
-    uri?: string;
-    mimeType?: string;
-    text?: string;
-    data?: string;
-}
-type ToolAssistantContentBlock = TextBlock | ImageUrlBlock | ResourceContentBlock;
-declare const TOOL_OPERATION_TERMINAL_STATES: readonly [
-    "completed",
-    "failed",
-    "timed_out",
-    "cancelled",
-    "outcome_unknown",
-    "orphaned"
-];
-type ToolOperationTerminalState = (typeof TOOL_OPERATION_TERMINAL_STATES)[number];
-type ToolOperationState = "registered" | "starting" | "running_foreground" | "running_background" | "waiting_for_input" | "stalled" | "verifying" | ToolOperationTerminalState;
-type ToolCompletionPolicy = "await" | "observe" | "detach";
-interface ExpectedOutputContract {
-    path: string;
-    kind?: "file" | "directory";
-    nonEmpty?: boolean;
-}
-interface ToolEvidence {
-    id: string;
-    kind: "artifact" | "process" | "verification";
-    status: "pending" | "verified" | "failed";
-    path?: string;
-    observedAt: string;
-    operationId: string;
-    detail?: Record<string, string | number | boolean | null>;
-}
-interface ToolOperationSnapshot {
-    schemaVersion: 1;
-    operationId: string;
-    turnId: string;
-    generation: number;
-    toolCallId: string;
-    toolName: string;
-    ownerSessionId?: string;
-    state: ToolOperationState;
-    terminal: boolean;
-    presentation: "foreground" | "background";
-    completionPolicy: ToolCompletionPolicy;
-    promotable: boolean;
-    processId?: string;
-    taskId?: string;
-    displayName?: string;
-    pid?: number;
-    commandFingerprint?: string;
-    outputPath?: string;
-    startedAt: string;
-    lastActivityAt: string;
-    deadlineAt?: string;
-    elapsedMs: number;
-    idleMs: number;
-    outputBytes: number;
-    nextOffset: number;
-    exitCode?: number | null;
-    completionReason?: string;
-    suggestedNextAction?: string;
-    expectedOutputs?: ExpectedOutputContract[];
-    evidence?: ToolEvidence[];
-}
-interface ToolProgressUpdate {
-    activity?: "stdout" | "stderr" | "input" | "waiting_for_input" | "heartbeat" | "state";
-    message?: string;
-    bytes?: number;
-    outputBytes?: number;
-    nextOffset?: number;
-    webContextProgress?: WebJobProgress;
-}
-interface ToolAuthorizationReceipt {
-    turnId: string;
-    toolCallId: string;
-    toolName: string;
-    iteration: number;
-    policy: {
-        allowed: true;
-        reason: string;
-        temporaryOverride: boolean;
-    };
-    permission: {
-        allowed: true;
-        reason: string;
-    };
-    elevation?: {
-        network: boolean;
-        directories: string[];
-        justification: string;
-    };
-}
-interface ToolResult {
-    success: boolean;
-    output: string;
-    error?: string;
-    errorCode?: string;
-    errorDetails?: Record<string, unknown>;
-    assistantContent?: ToolAssistantContentBlock[];
-    assistantOnlyContent?: ToolAssistantContentBlock[];
-    operation?: ToolOperationSnapshot;
-    evidence?: ToolEvidence[];
-    webContext?: WebContextToolResult;
-    retryable?: boolean;
-}
-interface ToolExecutionContext {
-    signal?: AbortSignal;
-    operationId?: string;
-    reportProgress?: (event: ToolProgressUpdate) => void;
-    authorization?: ToolAuthorizationReceipt;
-    ownerSessionId?: string;
-}
-interface ToolPolicyProjectionContext {
-    ownerSessionId?: string;
-}
-type ToolExecutor = (input: Record<string, unknown>, context?: ToolExecutionContext) => Promise<ToolResult>;
-interface ToolPolicyProjection {
-    observabilityInput: Record<string, unknown>;
-    permissionInput: Record<string, unknown>;
-    permissionPreview?: string;
-    approvalKey?: string;
-    riskLevel?: "low" | "medium" | "high";
-}
-interface RegisteredTool {
-    definition: ToolDefinition;
-    execute: ToolExecutor;
-    readOnly?: boolean;
-    projectPolicyInput?: (input: Record<string, unknown>, context?: ToolPolicyProjectionContext) => ToolPolicyProjection | {
-        error: ToolResult;
-    };
-}
-interface TextBlock {
-    type: "text";
-    text: string;
-}
 interface ToolRegistryOptions {
     validateInputs?: boolean;
     toolSchemaMode?: "all" | "demand";