@opengeni/api-router 0.23.1 → 0.30.0

package/dist/integrations/slack-bot.d.ts

@@ -3,6 +3,7 @@ import { OPENGENI_SLACK_BOT_CREDENTIAL_LABEL, OPENGENI_SLACK_BOT_CREDENTIAL_ROLE
 import { type Database } from "@opengeni/db";
 import { type FetchLike } from "@opengeni/network";
 import { HTTPException } from "hono/http-exception";
+export declare const SLACK_REACTION_IMAGE_MAX_BYTES: number;
 declare const SLACK_REACTION_CONTEXT_CHECKPOINT_VERSION = 1;
 type SlackPayload = Record<string, unknown> & {
     ok?: unknown;
@@ -20,6 +21,19 @@ export type VerifiedOpenGeniSlackBot = {
     grantedScopes: string[];
     metadata: OpenGeniSlackBotConnectionMetadata;
 };
+export type PreparedSlackReactionImage = Readonly<{
+    fileId: string;
+    filename: string;
+    declaredMimeType: string;
+    declaredSizeBytes: number | null;
+    downloadUrl: URL | null;
+}>;
+export type DownloadedSlackReactionImage = Readonly<{
+    fileId: string;
+    filename: string;
+    contentType: "image/png" | "image/jpeg" | "image/webp";
+    bytes: Uint8Array;
+}>;
 export declare function exchangeOpenGeniSlackAuthorizationCode(input: {
     code: string;
     clientId: string;
@@ -35,7 +49,32 @@ export type SlackBotReceipt = {
     operationId?: string;
     clientMessageId?: string;
 };
-type SlackBotOperation = "channels.list" | "channel_history.read" | "thread_replies.read" | "users.list" | "files.list" | "file.info" | "file.content.read" | "message.post" | "message.delete";
+export type SlackMessageBlock = {
+    type: "section";
+    block_id?: string;
+    text: {
+        type: "mrkdwn" | "plain_text";
+        text: string;
+        emoji?: boolean;
+    };
+} | {
+    type: "actions";
+    block_id: string;
+    elements: Array<{
+        type: "button";
+        action_id: string;
+        value: string;
+        text: {
+            type: "plain_text";
+            text: string;
+            emoji?: boolean;
+        };
+        style?: "primary" | "danger";
+    }>;
+} | {
+    type: "divider";
+};
+type SlackBotOperation = "channels.list" | "channel_history.read" | "thread_replies.read" | "users.list" | "files.list" | "file.info" | "file.content.read" | "message.post" | "message.update" | "message.delete";
 type SlackBotContext = {
     accountId: string;
     workspaceId: string;
@@ -127,10 +166,15 @@ export declare class OpenGeniSlackBotClient {
             isPrivate: boolean;
             isMember: boolean;
             isDirectMessage: boolean;
+            isMpim: boolean;
             isArchived: boolean;
             isShared: boolean;
             isExternallyShared: boolean;
             isOrgShared: boolean;
+            isPendingExternallyShared: boolean;
+            contextTeamId: string | null;
+            connectedTeamIds: string[] | null;
+            sharedTeamIds: string[] | null;
             topic: string;
             purpose: string;
             numMembers: number | null;
@@ -145,18 +189,76 @@ export declare class OpenGeniSlackBotClient {
         isPrivate: boolean;
         isMember: boolean;
         isDirectMessage: boolean;
+        isMpim: boolean;
         isArchived: boolean;
         isShared: boolean;
         isExternallyShared: boolean;
         isOrgShared: boolean;
+        isPendingExternallyShared: boolean;
+        contextTeamId: string | null;
+        connectedTeamIds: string[] | null;
+        sharedTeamIds: string[] | null;
         topic: string;
         purpose: string;
         numMembers: number | null;
     }>;
+    slackTaskPolicyFacts(channelId: string, userId: string): Promise<({
+        conversation: {
+            id: string;
+            name: string;
+            isPrivate: boolean;
+            isMember: boolean;
+            isDirectMessage: boolean;
+            isMpim: boolean;
+            isArchived: boolean;
+            isShared: boolean;
+            isExternallyShared: boolean;
+            isOrgShared: boolean;
+            isPendingExternallyShared: boolean;
+            contextTeamId: string | null;
+            connectedTeamIds: string[] | null;
+            sharedTeamIds: string[] | null;
+            topic: string;
+            purpose: string;
+            numMembers: number | null;
+        };
+        initiator: null;
+    } | {
+        conversation: {
+            id: string;
+            name: string;
+            isPrivate: boolean;
+            isMember: boolean;
+            isDirectMessage: boolean;
+            isMpim: boolean;
+            isArchived: boolean;
+            isShared: boolean;
+            isExternallyShared: boolean;
+            isOrgShared: boolean;
+            isPendingExternallyShared: boolean;
+            contextTeamId: string | null;
+            connectedTeamIds: string[] | null;
+            sharedTeamIds: string[] | null;
+            topic: string;
+            purpose: string;
+            numMembers: number | null;
+        };
+        initiator: {
+            id: string;
+            teamId: string | null;
+            isGuest: boolean | null;
+            isExternal: boolean | null;
+        };
+    }) & {
+        receipt: SlackBotReceipt;
+    }>;
     channelHistory(input: {
         channelId: string;
         limit?: number;
         cursor?: string;
+        latest?: string;
+        inclusive?: boolean;
+        authorizeRead?: () => Promise<void>;
     }): Promise<{
         channel: {
             id: string;
@@ -164,10 +266,15 @@ export declare class OpenGeniSlackBotClient {
             isPrivate: boolean;
             isMember: boolean;
             isDirectMessage: boolean;
+            isMpim: boolean;
             isArchived: boolean;
             isShared: boolean;
             isExternallyShared: boolean;
             isOrgShared: boolean;
+            isPendingExternallyShared: boolean;
+            contextTeamId: string | null;
+            connectedTeamIds: string[] | null;
+            sharedTeamIds: string[] | null;
             topic: string;
             purpose: string;
             numMembers: number | null;
@@ -199,6 +306,10 @@ export declare class OpenGeniSlackBotClient {
         threadTimestamp: string;
         limit?: number;
         cursor?: string;
+        oldest?: string;
+        latest?: string;
+        inclusive?: boolean;
+        authorizeRead?: () => Promise<void>;
     }): Promise<{
         channel: {
             id: string;
@@ -206,10 +317,15 @@ export declare class OpenGeniSlackBotClient {
             isPrivate: boolean;
             isMember: boolean;
             isDirectMessage: boolean;
+            isMpim: boolean;
             isArchived: boolean;
             isShared: boolean;
             isExternallyShared: boolean;
             isOrgShared: boolean;
+            isPendingExternallyShared: boolean;
+            contextTeamId: string | null;
+            connectedTeamIds: string[] | null;
+            sharedTeamIds: string[] | null;
             topic: string;
             purpose: string;
             numMembers: number | null;
@@ -250,10 +366,15 @@ export declare class OpenGeniSlackBotClient {
             isPrivate: boolean;
             isMember: boolean;
             isDirectMessage: boolean;
+            isMpim: boolean;
             isArchived: boolean;
             isShared: boolean;
             isExternallyShared: boolean;
             isOrgShared: boolean;
+            isPendingExternallyShared: boolean;
+            contextTeamId: string | null;
+            connectedTeamIds: string[] | null;
+            sharedTeamIds: string[] | null;
             topic: string;
             purpose: string;
             numMembers: number | null;
@@ -299,6 +420,22 @@ export declare class OpenGeniSlackBotClient {
     } & {
         receipt: SlackBotReceipt;
     }>;
+    /**
+     * Re-fetch and authorize the exact reacted-message files before any byte or
+     * workspace-storage mutation. The returned private URLs are process-local
+     * capabilities only and must never be persisted, logged, or projected into
+     * session input.
+     */
+    prepareReactionImageDownloads(input: {
+        channelId: string;
+        files: readonly {
+            id: string;
+            name: string;
+            title: string;
+        }[];
+    }): Promise<PreparedSlackReactionImage[]>;
+    /** Download and fully validate one previously authorized Slack image. */
+    downloadReactionImage(input: PreparedSlackReactionImage): Promise<DownloadedSlackReactionImage>;
     listUsers(input?: {
         limit?: number;
         cursor?: string;
@@ -326,10 +463,15 @@ export declare class OpenGeniSlackBotClient {
             isPrivate: boolean;
             isMember: boolean;
             isDirectMessage: boolean;
+            isMpim: boolean;
             isArchived: boolean;
             isShared: boolean;
             isExternallyShared: boolean;
             isOrgShared: boolean;
+            isPendingExternallyShared: boolean;
+            contextTeamId: string | null;
+            connectedTeamIds: string[] | null;
+            sharedTeamIds: string[] | null;
             topic: string;
             purpose: string;
             numMembers: number | null;
@@ -360,10 +502,15 @@ export declare class OpenGeniSlackBotClient {
             isPrivate: boolean;
             isMember: boolean;
             isDirectMessage: boolean;
+            isMpim: boolean;
             isArchived: boolean;
             isShared: boolean;
             isExternallyShared: boolean;
             isOrgShared: boolean;
+            isPendingExternallyShared: boolean;
+            contextTeamId: string | null;
+            connectedTeamIds: string[] | null;
+            sharedTeamIds: string[] | null;
             topic: string;
             purpose: string;
             numMembers: number | null;
@@ -394,10 +541,15 @@ export declare class OpenGeniSlackBotClient {
             isPrivate: boolean;
             isMember: boolean;
             isDirectMessage: boolean;
+            isMpim: boolean;
             isArchived: boolean;
             isShared: boolean;
             isExternallyShared: boolean;
             isOrgShared: boolean;
+            isPendingExternallyShared: boolean;
+            contextTeamId: string | null;
+            connectedTeamIds: string[] | null;
+            sharedTeamIds: string[] | null;
             topic: string;
             purpose: string;
             numMembers: number | null;
@@ -421,18 +573,36 @@ export declare class OpenGeniSlackBotClient {
     } & {
         receipt: SlackBotReceipt;
     }>;
+    /**
+     * Internal server-owned delivery only. Generic model-facing MCP callers do
+     * not have a trustworthy durable logical-delivery identity and must never
+     * reach this method with a caller-generated operation ID.
+     */
     postMessage(input: {
         operationId: string;
         channelId?: string;
         userId?: string;
         threadTimestamp?: string;
         text: string;
+        blocks?: SlackMessageBlock[];
+        requireActiveNonSharedChannel?: boolean;
     }): Promise<{
         channelId: string;
         timestamp: string;
         threadTimestamp: string | null;
         receipt: SlackBotReceipt;
     }>;
+    updateMessage(input: {
+        operationId: string;
+        channelId: string;
+        timestamp: string;
+        text: string;
+        blocks?: SlackMessageBlock[];
+    }): Promise<{
+        channelId: string;
+        timestamp: string;
+        receipt: SlackBotReceipt;
+    }>;
     deleteMessage(input: {
         operationId: string;
         channelId: string;
@@ -444,7 +614,9 @@ export declare class OpenGeniSlackBotClient {
         receipt: SlackBotReceipt;
     }>;
     private slackMessageExists;
+    private reconcilePostMessage;
     private requireMemberChannel;
+    private requireActiveNonSharedMemberChannel;
     private requireFileForChannel;
     private readPrivateFileText;
     private call;
@@ -457,6 +629,7 @@ export declare class OpenGeniSlackBotClient {
     private completedPostResult;
     private completedDeleteResult;
     private postRequestDigest;
+    private updateRequestDigest;
     private deleteRequestDigest;
     private deletePrincipal;
     private fileListPage;
@@ -480,6 +653,7 @@ export declare function createOpenGeniSlackBotInteractionClient(deps: {
     subjectId: string;
     sessionId?: string | null;
 }): Promise<OpenGeniSlackBotClient>;
+export declare function sniffSlackReactionImageMime(bytes: Uint8Array): "image/png" | "image/jpeg" | "image/webp" | null;
 export declare function resolveSlackFilesListPage(input: {
     channelId: string;
     limit?: number;

package/dist/integrations/slack-interactions.d.ts

@@ -1,11 +1,12 @@
-import { type WorkspaceSlackReactionSummonSettings } from "@opengeni/contracts";
+import { type FileResourceRef, type WorkspaceSlackReactionSummonSettings } from "@opengeni/contracts";
 import { type SlackInstallationRoute, type SlackInteractionInboxEntry, type SlackInteractionTriggerKind } from "@opengeni/db";
 import { type ApiRouteDeps } from "@opengeni/core";
 import type { Hono } from "hono";
-import { type OpenGeniSlackBotClient } from "./slack-bot";
+import { type OpenGeniSlackBotClient } from "./slack-bot.js";
+import { type ImportedSlackReactionImage } from "../slack-reaction-files.js";
 export declare const SLACK_INTERACTION_MAX_BODY_BYTES: number;
 export declare const SLACK_SIGNATURE_REPLAY_WINDOW_SECONDS = 300;
-export declare const SLACK_DELIVERY_EVENT_TYPES: readonly ["agent.message.completed", "session.humanInput.requested", "turn.completed", "turn.failed", "turn.cancelled", "session.status.changed"];
+export declare const SLACK_DELIVERY_EVENT_TYPES: readonly ["agent.message.completed", "session.humanInput.requested", "session.requiresAction", "turn.completed", "turn.failed", "turn.cancelled", "session.status.changed"];
 export declare const SLACK_TASK_INSTRUCTIONS: string;
 /**
  * Slack-originated tasks may retrieve the workspace bot's bounded read surface
@@ -13,7 +14,7 @@ export declare const SLACK_TASK_INSTRUCTIONS: string;
  * selection at session creation while keeping Slack mutations out of the model
  * surface; interaction delivery remains owned by the durable delivery pump.
  */
-export declare const SLACK_TASK_FIRST_PARTY_MCP_TOOLS: ("artifacts_create" | "artifacts_get_source" | "artifacts_list" | "artifacts_publish" | "artifacts_rollback" | "connected_machine_remove" | "environment_list" | "environment_set_variable" | "github_connect_link" | "github_repositories_list" | "goal_complete" | "goal_pause" | "goal_set" | "goal_update" | "memory_correct" | "memory_save" | "memory_search" | "preference_registry_get" | "preference_registry_summary" | "rig_get" | "rig_list" | "rig_promote" | "rig_propose_change" | "rig_verify" | "run_on" | "sandbox_attach" | "sandbox_provision" | "sandbox_swap" | "sandboxes_list" | "scheduled_task_runs_list" | "scheduled_tasks_create" | "scheduled_tasks_delete" | "scheduled_tasks_get" | "scheduled_tasks_list" | "scheduled_tasks_pause" | "scheduled_tasks_resume" | "scheduled_tasks_trigger" | "scheduled_tasks_update" | "session_create" | "session_events" | "session_get" | "session_pause" | "session_resume" | "session_send_message" | "session_steer" | "sessions_list" | "set_other_session_title" | "set_session_title" | "slack_bot_channel_history" | "slack_bot_delete_message" | "slack_bot_file_content" | "slack_bot_file_info" | "slack_bot_list_channels" | "slack_bot_list_files" | "slack_bot_list_users" | "slack_bot_post_message" | "slack_bot_thread_replies" | "social_connections_list" | "social_daily_analysis_context" | "social_mentions_live" | "social_post_reply" | "social_posts_recent" | "social_posts_sync" | "social_search_live" | "social_thread_fetch" | "variable_set_get_variable" | "variable_set_list" | "variable_set_set_variable")[];
+export declare const SLACK_TASK_FIRST_PARTY_MCP_TOOLS: ("artifacts_create" | "artifacts_get_source" | "artifacts_list" | "artifacts_publish" | "artifacts_rollback" | "atlassian_get" | "atlassian_search" | "atlassian_sources_list" | "browser_act" | "browser_auth" | "browser_clipboard" | "browser_debug" | "browser_identity" | "browser_lifecycle" | "browser_observe" | "browser_open" | "browser_publish" | "browser_tabs" | "capability_authorization_request" | "capability_catalog_search" | "computer_act" | "computer_clipboard" | "computer_lifecycle" | "computer_observe" | "computer_open" | "computer_targets" | "connected_machine_remove" | "editable_artifact_apply" | "editable_artifact_create" | "editable_artifact_export" | "editable_artifact_export_status" | "editable_artifact_get" | "editable_artifact_import" | "editable_artifact_inspect" | "editable_artifact_list" | "environment_list" | "environment_set_variable" | "fiken_bank_accounts_list" | "fiken_companies_list" | "fiken_contact_create" | "fiken_contacts_list" | "fiken_invoice_draft_create" | "fiken_invoice_get" | "fiken_invoices_list" | "fiken_products_list" | "fiken_purchases_list" | "fiken_sales_list" | "github_connect_link" | "github_repositories_list" | "goal_complete" | "goal_pause" | "goal_progress" | "goal_set" | "goal_update" | "interaction_discover" | "interaction_request_human" | "memory_correct" | "memory_save" | "memory_search" | "preference_registry_get" | "preference_registry_summary" | "reddit_accounts_list" | "reddit_mentions_live" | "reddit_post_reply" | "reddit_posts_sync" | "reddit_search_live" | "reddit_thread_fetch" | "rig_get" | "rig_list" | "rig_promote" | "rig_propose_change" | "rig_verify" | "run_on" | "sandbox_attach" | "sandbox_provision" | "sandbox_swap" | "sandboxes_list" | "scheduled_task_runs_list" | "scheduled_tasks_create" | "scheduled_tasks_delete" | "scheduled_tasks_get" | "scheduled_tasks_list" | "scheduled_tasks_pause" | "scheduled_tasks_resume" | "scheduled_tasks_trigger" | "scheduled_tasks_update" | "session_create" | "session_events" | "session_get" | "session_pause" | "session_resume" | "session_send_message" | "session_steer" | "sessions_list" | "set_other_session_title" | "set_session_title" | "slack_bot_channel_history" | "slack_bot_delete_message" | "slack_bot_file_content" | "slack_bot_file_info" | "slack_bot_list_channels" | "slack_bot_list_files" | "slack_bot_list_users" | "slack_bot_post_message" | "slack_bot_thread_replies" | "social_connections_list" | "social_daily_analysis_context" | "social_mentions_live" | "social_post_reply" | "social_posts_recent" | "social_posts_sync" | "social_search_live" | "social_thread_fetch" | "task_note_archive" | "task_note_save" | "task_notes_list" | "variable_set_get_variable" | "variable_set_list" | "variable_set_set_variable" | "x_accounts_list" | "x_mentions_live" | "x_post_reply" | "x_posts_sync" | "x_search_live" | "x_thread_fetch")[];
 export type NormalizedSlackInteraction = {
     providerEventId: string;
     providerMessageId: string;
@@ -24,8 +25,11 @@ export type NormalizedSlackInteraction = {
     slackThreadTs: string | null;
     triggerKind: SlackInteractionTriggerKind;
     text: string;
+    hasFiles: boolean;
 };
-export declare function slackInteractionRoutePolicy(entry: Pick<SlackInteractionInboxEntry, "triggerKind" | "slackChannelId" | "slackThreadTs" | "slackMessageTs" | "slackUserId">): {
+export declare function slackInteractionRoutePolicy(entry: Pick<SlackInteractionInboxEntry, "triggerKind" | "slackChannelId" | "slackThreadTs" | "slackMessageTs" | "slackUserId">, options?: {
+    privateHandoff?: boolean;
+}): {
     directMessageShortcut: boolean;
     requiresChannelAccess: boolean;
     visibility: "private" | "workspace";
@@ -44,8 +48,22 @@ export declare function startSlackInteractionPump(deps: ApiRouteDeps, options?:
     intervalMs?: number;
     maxPerTick?: number;
 }): () => void;
+export type SlackInvocationMessageContext = {
+    messages: Awaited<ReturnType<OpenGeniSlackBotClient["threadReplies"]>>["messages"];
+    nextCursor: string | null;
+    kind: "thread" | "channel";
+};
+export declare function slackInvocationTaskText(entry: Pick<SlackInteractionInboxEntry, "slackMessageTs" | "slackUserId" | "text">, context: SlackInvocationMessageContext): string;
 type SlackReactionMessageContext = Awaited<ReturnType<OpenGeniSlackBotClient["reactionMessageContext"]>>;
-export declare function slackReactionTaskText(context: SlackReactionMessageContext): string;
+type PreparedSlackReactionTask = Readonly<{
+    resources: FileResourceRef[];
+    attachments: ImportedSlackReactionImage[];
+    omissionCodes: string[];
+    omittedCount: number;
+}>;
+export declare function slackReactionTaskText(context: SlackReactionMessageContext, prepared?: PreparedSlackReactionTask): string;
+export declare function slackDeliveryTextsCoalesce(left: string, right: string): boolean;
+export declare function normalizedBlockActionInteraction(payload: Record<string, unknown>): NormalizedSlackInteraction;
 type SlackUserLinkToken = {
     workspaceId: string;
     connectionId: string;

package/dist/integrations/social-api.d.ts

@@ -2,7 +2,7 @@ import type { Settings } from "@opengeni/config";
 import type { SocialConnection } from "@opengeni/contracts";
 import type { Observability } from "@opengeni/observability";
 import type { Database } from "@opengeni/db";
-import { type SocialProviderFetch } from "./social-oauth";
+import { type SocialProviderFetch } from "./social-oauth.js";
 export type SocialLivePost = {
     id: string;
     provider: "x" | "reddit";
@@ -24,6 +24,7 @@ type ConnectionRef = {
     connectionId: string;
     subjectId?: string | null;
 };
+export declare function assertSocialConnectionProvider(connection: Pick<SocialConnection, "provider">, expected: "x" | "reddit"): void;
 export declare function socialSearchLive(deps: SocialApiDeps, ref: ConnectionRef, input: {
     query: string;
     limit?: number | undefined;

package/dist/interaction-holder-heartbeat.d.ts

@@ -0,0 +1,17 @@
+import type { AccessGrant } from "@opengeni/contracts";
+import type { ApiRouteDeps } from "@opengeni/core";
+/**
+ * Keep one durable interaction operation—and its sandbox holder when present—
+ * live while a bounded controller mutation is in flight. Browser profile
+ * capture/restore can legitimately take minutes; without this pulse a lifecycle
+ * reaper cannot distinguish that request from a caller that disappeared.
+ */
+export declare function withInteractionHolderHeartbeat<T>(deps: ApiRouteDeps, input: {
+    grant: AccessGrant;
+    workspaceId: string;
+    sandboxGroupId: string | null;
+    holderId: string;
+    operationId: string;
+    resourceId: string;
+    controllerGeneration: string;
+}, run: () => Promise<T>): Promise<T>;

package/dist/interaction-metrics.d.ts

@@ -0,0 +1,11 @@
+import type { AuthRunMutationResponse, BrowserActionReceipt, BrowserActionRequest, PublishBrowserRevisionResponse, BrowserSessionMutationResponse, ComputerActionReceipt, ComputerActionRequest, ComputerSessionMutationResponse, InteractionInterventionMutationResponse, ProtectedAuthFillResponse } from "@opengeni/contracts";
+import { type Observability } from "@opengeni/observability";
+type InteractionLifecycleMutation = BrowserSessionMutationResponse | ComputerSessionMutationResponse;
+type AuthMutation = AuthRunMutationResponse | ProtectedAuthFillResponse;
+export declare function observeBrowserActionResult(observability: Observability | null | undefined, startedAtMs: number, request: BrowserActionRequest, receipt: BrowserActionReceipt): void;
+export declare function observeComputerActionResult(observability: Observability | null | undefined, startedAtMs: number, request: ComputerActionRequest, receipt: ComputerActionReceipt): void;
+export declare function observeLifecycleResult(observability: Observability | null | undefined, startedAtMs: number, response: InteractionLifecycleMutation): void;
+export declare function observeBrowserRevisionPublication(observability: Observability | null | undefined, startedAtMs: number, response: PublishBrowserRevisionResponse): void;
+export declare function observeAuthMutation(observability: Observability | null | undefined, startedAtMs: number, response: AuthMutation): void;
+export declare function observeInterventionMutation(observability: Observability | null | undefined, response: InteractionInterventionMutationResponse): void;
+export {};

package/dist/mcp/editable-artifact-query-schema.d.ts

@@ -0,0 +1,4 @@
+import type { EditableArtifactAgentQuery } from "@opengeni/core/editable-artifacts";
+import * as z from "zod/v4";
+/** Exact bounded query union shared by the model-facing direct inspect tool. */
+export declare const EditableArtifactQueryRequestSchema: z.ZodType<EditableArtifactAgentQuery["query"]>;

package/dist/mcp/editable-artifacts.d.ts

@@ -0,0 +1,13 @@
+import type { AccessGrant } from "@opengeni/contracts";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ApiRouteDeps } from "@opengeni/core";
+type RegisterEditableArtifactToolsInput = Readonly<{
+    server: McpServer;
+    deps: ApiRouteDeps;
+    grant: AccessGrant;
+    sessionId: string;
+    authorize(): Promise<void>;
+}>;
+/** Register the one canonical agent artifact surface used directly and by CodeMode. */
+export declare function registerEditableArtifactAgentTools(input: RegisterEditableArtifactToolsInput): void;
+export {};