@opengeni/api-router 0.22.2 → 0.26.1

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

@@ -0,0 +1,24 @@
+import { type IntegrationCredentialResolver, type IntegrationInvocationAuthority, type IntegrationTransport } from "@opengeni/capabilities";
+import { ApiIntegrationPreview, type ApiIntegrationSource } from "@opengeni/contracts";
+import type { StoredApiIntegrationRevision } from "@opengeni/db";
+export type ApiIntegrationConnectionDescriptor = {
+    id: string;
+    kind: "oauth2" | "api_key" | "app_install" | "delegated";
+    providerDomain: string;
+    scopes: string[];
+    ownership: "workspace" | "personal";
+};
+export type ResolvedApiIntegrationPreview = {
+    preview: ApiIntegrationPreview;
+    revision: StoredApiIntegrationRevision;
+    provider: string | null;
+    requiredScopes: string[];
+    authScheme: Record<string, unknown>;
+};
+export declare function resolveApiIntegrationPreview(input: {
+    source: ApiIntegrationSource;
+    connection: ApiIntegrationConnectionDescriptor | null;
+    transport: IntegrationTransport;
+    credentialResolver?: IntegrationCredentialResolver;
+    authority: IntegrationInvocationAuthority;
+}): Promise<ResolvedApiIntegrationPreview>;

package/dist/integrations/atlassian.d.ts

@@ -0,0 +1,176 @@
+import type { AccessGrant, ScheduledTask } from "@opengeni/contracts";
+import { AtlassianOAuthStartResponse, type AtlassianDisconnectRequest, type AtlassianLifecycleActionRequest, type AtlassianOAuthStartRequest } from "@opengeni/contracts/atlassian";
+import { type ApiRouteDeps } from "@opengeni/core";
+import { getConnectionMetadata } from "@opengeni/db";
+type AtlassianConnectionRecord = NonNullable<Awaited<ReturnType<typeof getConnectionMetadata>>>;
+export declare function startAtlassianOAuth(deps: ApiRouteDeps, input: {
+    accountId: string;
+    workspaceId: string;
+    subjectId: string;
+    requestUrl: string;
+    payload: AtlassianOAuthStartRequest;
+}): Promise<AtlassianOAuthStartResponse>;
+export declare function completeAtlassianOAuthCallback(deps: ApiRouteDeps, input: {
+    code?: string | undefined;
+    state?: string | undefined;
+    error?: string | undefined;
+    requestUrl: string;
+}): Promise<{
+    redirectTo: string;
+}>;
+export declare function browseAtlassianSources(deps: ApiRouteDeps, input: {
+    workspaceId: string;
+    subjectId: string;
+    connectionId: string;
+}): Promise<{
+    connection: {
+        id: string;
+        accountId: string;
+        workspaceId: string;
+        subjectId: string | null;
+        providerDomain: string;
+        kind: "api_key" | "app_install" | "delegated" | "oauth2";
+        status: "active" | "error" | "needs_reauth" | "revoked";
+        grantedScopes: string[];
+        expiresAt: string | null;
+        lastRefreshAt: string | null;
+        lastUsedAt: string | null;
+        lastError: string | null;
+        version: number;
+        verifiedInstallAt?: string | null | undefined;
+        verifiedInstallVersion?: number | null | undefined;
+        metadata: Record<string, unknown>;
+        createdBySubjectId: string | null;
+        updatedBySubjectId: string | null;
+        createdAt: string;
+        updatedAt: string;
+    };
+    items: {
+        id: string;
+        cloudId: string;
+        siteName: string;
+        siteUrl: string;
+        resourceId: string;
+        key: string;
+        name: string;
+        kind: "confluence_space" | "jira_project";
+        description: string | null;
+        webUrl: string;
+    }[];
+}>;
+export declare function searchAtlassianLive(deps: ApiRouteDeps, input: {
+    workspaceId: string;
+    subjectId: string;
+    connectionId: string;
+    query: string;
+    product?: "jira" | "confluence" | undefined;
+    limit: number;
+}): Promise<({
+    kind: "jira_issue";
+    id: string;
+    key: string;
+    title: string;
+    sourceId: string | null;
+    sourceName: string | null;
+    status: string | null;
+    updatedAt: string | null;
+    url: string;
+} | {
+    kind: "confluence_page";
+    id: string;
+    key: null;
+    title: string;
+    sourceId: string | null;
+    sourceName: string | null;
+    status: null;
+    updatedAt: string | null;
+    url: string;
+})[]>;
+export declare function getAtlassianLiveItem(deps: ApiRouteDeps, input: {
+    workspaceId: string;
+    subjectId: string;
+    connectionId: string;
+    kind: "jira_issue" | "confluence_page";
+    id: string;
+}): Promise<{
+    kind: "jira_issue";
+    id: string;
+    key: string;
+    title: string;
+    source: {
+        id: string;
+        name: string;
+        siteName: string;
+    };
+    status: string | null;
+    issueType: string | null;
+    priority: string | null;
+    assignee: string | null;
+    reporter: string | null;
+    labels: string[];
+    createdAt: string | null;
+    updatedAt: string | null;
+    description: string;
+    comments: {
+        author: string | null;
+        createdAt: string | null;
+        body: string;
+    }[];
+    url: string;
+    content?: never;
+} | {
+    key?: never;
+    issueType?: never;
+    priority?: never;
+    assignee?: never;
+    reporter?: never;
+    labels?: never;
+    description?: never;
+    kind: "confluence_page";
+    id: string;
+    title: string;
+    source: {
+        id: string;
+        name: string;
+        siteName: string;
+    };
+    status: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+    content: string;
+    comments: {
+        createdAt: string | null;
+        content: string;
+    }[];
+    url: string;
+}>;
+export declare function saveAtlassianSources(deps: ApiRouteDeps, input: {
+    accountId: string;
+    workspaceId: string;
+    subjectId: string;
+    connectionId: string;
+    grant: AccessGrant;
+    payload: unknown;
+    canManageOrganizationDestination: boolean;
+    canManageWorkspaceDestination: boolean;
+    canManagePersonalDestination: boolean;
+}): Promise<import("@opengeni/db").ConnectionMetadataWithVerification>;
+export declare function transitionAtlassianLifecycle(deps: ApiRouteDeps, input: {
+    workspaceId: string;
+    subjectId: string;
+    connectionId: string;
+    payload: AtlassianLifecycleActionRequest;
+}): Promise<import("@opengeni/db").ConnectionMetadataWithVerification>;
+export declare function disconnectAtlassian(deps: ApiRouteDeps, input: {
+    workspaceId: string;
+    subjectId: string;
+    connection: AtlassianConnectionRecord;
+    payload: AtlassianDisconnectRequest;
+}): Promise<import("@opengeni/db").ConnectionMetadataWithVerification | null>;
+export declare function revokeAtlassianScheduleAuthorization(deps: ApiRouteDeps, input: {
+    task: ScheduledTask;
+    subjectId: string;
+}): Promise<void>;
+export declare function isSelectableConfluenceSpaceType(value: unknown): boolean;
+export declare function confluenceNextUrl(cloudId: string, next: string): URL;
+export {};

package/dist/integrations/github-skill-source.d.ts

@@ -0,0 +1,5 @@
+import type { Settings } from "@opengeni/config";
+import type { GitHubSkillSourceClient } from "@opengeni/core";
+type GitHubJsonRequest = (path: string, maxBytes: number, label: string) => Promise<unknown>;
+export declare function createGitHubSkillSourceClient(settings: Settings, requestJson?: GitHubJsonRequest): GitHubSkillSourceClient;
+export {};

package/dist/integrations/google-drive.d.ts

@@ -1,6 +1,19 @@
+import type { AccessGrant, ScheduledTask } from "@opengeni/contracts";
 import { GoogleDriveOAuthStartResponse, type GoogleDriveDisconnectRequest, type GoogleDriveLifecycleActionRequest, type GoogleDriveOAuthStartRequest } from "@opengeni/contracts/google-drive";
+import { IntegrationFeatureMutationResult } from "@opengeni/contracts";
 import type { ApiRouteDeps } from "@opengeni/core";
 import { getConnectionMetadata } from "@opengeni/db";
+export declare function wakeGoogleDriveSourcesFromWorkspaceEvent(deps: ApiRouteDeps, input: {
+    accountId: string;
+    workspaceId: string;
+    connectionId: string;
+    connectionOwnerSubjectId: string;
+    eventId: string;
+    driveId: string | null;
+}): Promise<{
+    enabled: boolean;
+    triggered: number;
+}>;
 type GoogleDriveConnectionRecord = NonNullable<Awaited<ReturnType<typeof getConnectionMetadata>>>;
 export declare function startGoogleDriveOAuth(deps: ApiRouteDeps, input: {
     accountId: string;
@@ -82,14 +95,86 @@ export declare function browseGoogleDrive(deps: ApiRouteDeps, input: {
     nextPageToken: string | null;
     incompleteSearch: boolean;
 }>;
+export declare function browseGoogleDriveIntegrationSource(deps: ApiRouteDeps, input: {
+    workspaceId: string;
+    subjectId: string;
+    capabilityId: string;
+    instanceKey: string;
+    featureKey: string;
+    parentId: string;
+    pageToken?: string | undefined;
+}): Promise<{
+    connection: {
+        id: string;
+        accountId: string;
+        workspaceId: string;
+        subjectId: string | null;
+        providerDomain: string;
+        kind: "api_key" | "app_install" | "delegated" | "oauth2";
+        status: "active" | "error" | "needs_reauth" | "revoked";
+        grantedScopes: string[];
+        expiresAt: string | null;
+        lastRefreshAt: string | null;
+        lastUsedAt: string | null;
+        lastError: string | null;
+        version: number;
+        verifiedInstallAt?: string | null | undefined;
+        verifiedInstallVersion?: number | null | undefined;
+        metadata: Record<string, unknown>;
+        createdBySubjectId: string | null;
+        updatedBySubjectId: string | null;
+        createdAt: string;
+        updatedAt: string;
+    };
+    parentId: string;
+    current: {
+        id: string;
+        name: string;
+        mimeType: string;
+        kind: "file" | "folder";
+        driveId: string | null;
+        modifiedTime: string | null;
+        size: string | null;
+        webViewLink: string | null;
+    } | null;
+    items: {
+        id: string;
+        name: string;
+        mimeType: string;
+        kind: "file" | "folder";
+        driveId: string | null;
+        modifiedTime: string | null;
+        size: string | null;
+        webViewLink: string | null;
+    }[];
+    nextPageToken: string | null;
+    incompleteSearch: boolean;
+}>;
+export declare function saveGoogleDriveIntegrationSource(deps: ApiRouteDeps, input: {
+    accountId: string;
+    workspaceId: string;
+    subjectId: string;
+    capabilityId: string;
+    instanceKey: string;
+    featureKey: string;
+    payload: unknown;
+    canManageOrganizationDestination: boolean;
+    canManageWorkspaceDestination: boolean;
+    canManagePersonalDestination: boolean;
+}): Promise<IntegrationFeatureMutationResult>;
 export declare function saveGoogleDriveSource(deps: ApiRouteDeps, input: {
     accountId: string;
     workspaceId: string;
     subjectId: string;
     connectionId: string;
+    grant: AccessGrant;
     payload: unknown;
     canManageOrganizationDestination: boolean;
     canManageWorkspaceDestination: boolean;
     canManagePersonalDestination: boolean;
 }): Promise<import("@opengeni/db").ConnectionMetadataWithVerification>;
+export declare function revokeKnowledgeSourceScheduleAuthorization(deps: ApiRouteDeps, input: {
+    task: ScheduledTask;
+    subjectId: string;
+}): Promise<void>;
 export {};

package/dist/integrations/oauth-client.d.ts

@@ -1,9 +1,11 @@
 import { type Settings } from "@opengeni/config";
-import { OAuthStartResponse, type OAuthStartRequest } from "@opengeni/contracts";
+import { OAuthStartResponse, type ConnectionOwnership, type OAuthStartRequest } from "@opengeni/contracts";
 import type { Observability } from "@opengeni/observability";
 import { type Database } from "@opengeni/db";
 export declare const oauthStateTtlMs: number;
 export declare const OFFICIAL_SLACK_MCP_URL: "https://mcp.slack.com/mcp";
+export declare const OFFICIAL_GMAIL_MCP_URL = "https://gmailmcp.googleapis.com/mcp/v1";
+export declare const OFFICIAL_GMAIL_MCP_SCOPES: readonly ["https://www.googleapis.com/auth/gmail.readonly", "https://www.googleapis.com/auth/gmail.compose", "https://www.googleapis.com/auth/gmail.modify"];
 export { OAUTH_MAX_RESPONSE_BYTES } from "@opengeni/network";
 type OAuthClientDeps = {
     db: Database;
@@ -37,6 +39,7 @@ export declare const OAUTH_START_DEADLINE_MS = 15000;
 export declare const OAUTH_CALLBACK_DEADLINE_MS = 30000;
 export type OAuthStartStage = "connection_lookup" | "mcp_challenge" | "protected_resource_metadata" | "authorization_server_metadata" | "client_registration";
 export declare function startMcpOAuth(deps: OAuthClientDeps, context: OAuthStartContext): Promise<OAuthStartResponse>;
+export declare function assertOfficialGmailPersonalOwnership(mcpUrl: string, ownership: ConnectionOwnership): void;
 export declare function completeMcpOAuthCallback(deps: OAuthClientDeps, input: {
     code?: string | undefined;
     state?: string | undefined;
@@ -45,3 +48,29 @@ export declare function completeMcpOAuthCallback(deps: OAuthClientDeps, input: {
 export declare function integrationBaseUrl(publicBaseUrl: string | undefined, requestUrl: string): string;
 export declare function requireIntegrationsStateSecret(settings: Settings): string;
 export declare function assertSlackAuthorizationServer(as: AuthorizationServerMetadata): void;
+export declare function assertGoogleAuthorizationServer(as: AuthorizationServerMetadata): void;
+export declare function buildAuthorizationUrl(input: {
+    endpoint: string;
+    settings: Settings;
+    clientId: string;
+    redirectUri: string;
+    state: string;
+    resource: string;
+    verifier: string;
+    scopes: string[];
+    resourceParameterSupported: boolean;
+}): string;
+export type OAuthPublicErrorFields = {
+    errorClass: "OAuthOperationError";
+    errorCode: "oauth_operation_failed";
+    status?: number;
+    origin: "oauth";
+};
+/** Allowlisted projection for public telemetry; canonical OAuth errors stay exact. */
+export declare function oauthPublicErrorFields(error: unknown): OAuthPublicErrorFields;
+export declare function chooseMcpAuthorizeScopes(input: {
+    mcpUrl: string;
+    requested: string[] | undefined;
+    challenged: string[] | undefined;
+    supported: string[];
+}): string[];

package/dist/integrations/provider-oauth.d.ts

@@ -0,0 +1,19 @@
+import { type Settings } from "@opengeni/config";
+import { OAuthStartResponse, type ApiIntegrationOAuthStartRequest } from "@opengeni/contracts";
+import { type ApiRouteDeps } from "@opengeni/core";
+export declare function startApiIntegrationProviderOAuth(deps: ApiRouteDeps, input: {
+    accountId: string;
+    workspaceId: string;
+    subjectId: string;
+    requestUrl: string;
+    payload: ApiIntegrationOAuthStartRequest;
+}): Promise<OAuthStartResponse>;
+export declare function completeApiIntegrationProviderOAuth(deps: ApiRouteDeps, input: {
+    code?: string | undefined;
+    state?: string | undefined;
+    error?: string | undefined;
+    requestUrl: string;
+}): Promise<{
+    redirectTo: string;
+}>;
+export declare function isApiIntegrationProviderOAuthState(value: string | undefined, settings: Settings): boolean;

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

@@ -157,6 +157,8 @@ export declare class OpenGeniSlackBotClient {
         channelId: string;
         limit?: number;
         cursor?: string;
+        latest?: string;
+        inclusive?: boolean;
     }): Promise<{
         channel: {
             id: string;
@@ -427,6 +429,7 @@ export declare class OpenGeniSlackBotClient {
         userId?: string;
         threadTimestamp?: string;
         text: string;
+        requireActiveNonSharedChannel?: boolean;
     }): Promise<{
         channelId: string;
         timestamp: string;
@@ -445,6 +448,7 @@ export declare class OpenGeniSlackBotClient {
     }>;
     private slackMessageExists;
     private requireMemberChannel;
+    private requireActiveNonSharedMemberChannel;
     private requireFileForChannel;
     private readPrivateFileText;
     private call;

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

@@ -2,7 +2,7 @@ import { 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";
 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"];
@@ -13,7 +13,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" | "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_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_debug" | "browser_identity" | "browser_lifecycle" | "browser_observe" | "browser_open" | "browser_publish" | "browser_tabs" | "capability_authorization_request" | "capability_catalog_search" | "computer_act" | "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" | "github_connect_link" | "github_repositories_list" | "goal_complete" | "goal_pause" | "goal_set" | "goal_update" | "interaction_discover" | "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" | "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;
@@ -25,6 +25,12 @@ export type NormalizedSlackInteraction = {
     triggerKind: SlackInteractionTriggerKind;
     text: string;
 };
+export declare function slackInteractionRoutePolicy(entry: Pick<SlackInteractionInboxEntry, "triggerKind" | "slackChannelId" | "slackThreadTs" | "slackMessageTs" | "slackUserId">): {
+    directMessageShortcut: boolean;
+    requiresChannelAccess: boolean;
+    visibility: "private" | "workspace";
+    initialRouteKey: string;
+};
 export declare function verifySlackRequestSignature(input: {
     timestamp: string | null;
     signature: string | null;
@@ -38,6 +44,12 @@ 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 SlackUserLinkToken = {

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/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 {};

package/dist/mcp/receipts.d.ts

@@ -0,0 +1,28 @@
+import { type McpMutationReceiptType } from "@opengeni/contracts";
+export type McpMutationReceiptInput = Omit<McpMutationReceiptType, "receiptVersion" | "timestamp" | "warnings"> & {
+    timestamp?: string;
+    warnings?: string[];
+};
+/**
+ * Build and validate a compact first-party MCP mutation receipt at the API
+ * boundary. Contract parsing is intentional: it prevents a handler from
+ * accidentally adding an unbounded entity or a copy of request fields.
+ */
+export declare function mcpMutationReceipt(input: McpMutationReceiptInput): McpMutationReceiptType;
+export type SessionCreateReceiptResult = {
+    session: {
+        id: string;
+        queueVersion: number;
+        status: string;
+        sandboxGroupId: string;
+        parentSessionId: string | null;
+        rootSessionId: string;
+        nestedAgentDepth: number;
+        effectiveMaxNestedAgentDepth: number;
+    };
+    outcome: "created" | "repaired" | "replayed";
+    changed: boolean;
+    usageRecording: "recorded" | "failed";
+};
+/** Project committed session-create truth without copying request fields. */
+export declare function sessionCreateMutationReceipt(result: SessionCreateReceiptResult, idempotencyKeyRequested: boolean): McpMutationReceiptType;