asqend-mcp-contracts 0.3.2

package/dist/generated/tools.visibility.d.ts

@@ -0,0 +1 @@
+export declare const generatedDefaultVisibleToolNames: Set<string>;

package/dist/generated/tools.visibility.js

@@ -0,0 +1,120 @@
+/* AUTO-GENERATED: DO NOT EDIT DIRECTLY. */
+export const generatedDefaultVisibleToolNames = new Set([
+    "platform_discover",
+    "platform_capability_fulfillments_get",
+    "platform_capability_fulfillments_update",
+    "web_search",
+    "web_fetch",
+    "get_pending_work",
+    "heartbeat",
+    "complete_task",
+    "fail_task",
+    "objects_list",
+    "objects_create",
+    "objects_update",
+    "objects_seed_system",
+    "templates_get",
+    "templates_install",
+    "systems_templates_list",
+    "systems_templates_get",
+    "systems_template_deploy",
+    "systems_get",
+    "systems_run_now",
+    "systems_run_get",
+    "systems_run_steps_get",
+    "systems_run_events_get",
+    "systems_update",
+    "systems_form_get",
+    "systems_form_submit",
+    "systems_portal_get",
+    "systems_queue_get",
+    "systems_queue_list_items",
+    "systems_queue_get_item",
+    "systems_queue_claim",
+    "systems_queue_release",
+    "systems_queue_start_session",
+    "systems_session_get",
+    "systems_session_action_execute",
+    "systems_session_close",
+    "systems_hosted_chat_context_get",
+    "systems_propose_action_revision",
+    "systems_social_content_draft_capture",
+    "systems_social_content_draft_update",
+    "meetings_context_get",
+    "meetings_ingest_manual_source",
+    "meetings_propose_action_review",
+    "meetings_participant_identity_update",
+    "systems_plan_patch",
+    "systems_apply_patch",
+    "systems_rollback",
+    "objects_execute_build_plan",
+    "fields_create",
+    "fields_create_batch",
+    "relations_create",
+    "relations_attach",
+    "relations_detach",
+    "relations_replace",
+    "records_list",
+    "records_get",
+    "records_lookup_exact",
+    "records_create",
+    "records_create_batch",
+    "records_upsert",
+    "records_update",
+    "records_delete",
+    "record_comments_create",
+    "record_comments_update",
+    "record_comments_delete",
+    "record_checklist_create",
+    "record_checklist_update",
+    "record_checklist_delete",
+    "record_attachments_upload",
+    "record_attachments_delete",
+    "triggers_create",
+    "triggers_update",
+    "triggers_delete",
+    "batch_execute",
+    "project_execution_context",
+    "calendar_get_event",
+    "calendar_create_focus_block",
+    "calendar_move_event",
+    "calendar_create_event",
+    "calendar_update_event",
+    "calendar_delete_event",
+    "email_accounts_list",
+    "email_label_create",
+    "email_message_get",
+    "email_attachment_get",
+    "email_reply_send",
+    "email_reply_with_attachment",
+    "email_compose",
+    "email_compose_with_attachment",
+    "email_forward",
+    "email_draft_create",
+    "email_draft_send",
+    "email_draft_delete",
+    "email_search",
+    "email_thread_get",
+    "email_modify",
+    "email_archive_thread",
+    "drive_create",
+    "drive_copy",
+    "drive_create_folder",
+    "drive_upload",
+    "drive_share",
+    "drive_delete",
+    "drive_move",
+    "drive_rename",
+    "sheets_write_values",
+    "sheets_append_rows",
+    "sheets_create_spreadsheet",
+    "sheets_add_tab",
+    "sheets_clear_range",
+    "sheets_format_cells",
+    "sheets_batch_update",
+    "docs_replace_text",
+    "docs_batch_update",
+    "docs_create_tab",
+    "docs_write_tab",
+    "docs_insert_text"
+]);

package/dist/generated/tools.write-set.d.ts

@@ -0,0 +1 @@
+export declare const generatedWriteTools: Set<string>;

package/dist/generated/tools.write-set.js

@@ -0,0 +1,93 @@
+/* AUTO-GENERATED: DO NOT EDIT DIRECTLY. */
+export const generatedWriteTools = new Set([
+    "platform_capability_fulfillments_update",
+    "get_pending_work",
+    "heartbeat",
+    "complete_task",
+    "fail_task",
+    "objects_create",
+    "objects_update",
+    "objects_seed_system",
+    "templates_install",
+    "systems_template_deploy",
+    "systems_run_now",
+    "systems_update",
+    "systems_form_submit",
+    "systems_queue_claim",
+    "systems_queue_release",
+    "systems_queue_start_session",
+    "systems_session_action_execute",
+    "systems_session_close",
+    "systems_propose_action_revision",
+    "systems_social_content_draft_capture",
+    "systems_social_content_draft_update",
+    "meetings_ingest_manual_source",
+    "meetings_propose_action_review",
+    "meetings_participant_identity_update",
+    "systems_plan_patch",
+    "systems_apply_patch",
+    "systems_rollback",
+    "objects_execute_build_plan",
+    "fields_create",
+    "fields_create_batch",
+    "fields_update",
+    "fields_delete",
+    "relations_create",
+    "relations_update",
+    "relations_delete",
+    "relations_attach",
+    "relations_detach",
+    "relations_replace",
+    "records_create",
+    "records_create_batch",
+    "records_upsert",
+    "records_update",
+    "records_delete",
+    "record_comments_create",
+    "record_comments_update",
+    "record_comments_delete",
+    "record_checklist_create",
+    "record_checklist_update",
+    "record_checklist_delete",
+    "record_attachments_upload",
+    "record_attachments_delete",
+    "triggers_create",
+    "triggers_update",
+    "triggers_delete",
+    "calendar_create_focus_block",
+    "calendar_move_event",
+    "calendar_create_event",
+    "calendar_update_event",
+    "calendar_delete_event",
+    "email_label_create",
+    "email_reply_send",
+    "email_reply_with_attachment",
+    "email_compose",
+    "email_compose_with_attachment",
+    "email_forward",
+    "email_draft_create",
+    "email_draft_send",
+    "email_draft_delete",
+    "email_modify",
+    "email_archive_thread",
+    "drive_create",
+    "drive_copy",
+    "drive_create_folder",
+    "drive_upload",
+    "drive_share",
+    "drive_delete",
+    "drive_move",
+    "drive_rename",
+    "sheets_write_values",
+    "sheets_append_rows",
+    "sheets_create_spreadsheet",
+    "sheets_add_tab",
+    "sheets_clear_range",
+    "sheets_format_cells",
+    "sheets_batch_update",
+    "docs_replace_text",
+    "docs_batch_update",
+    "docs_create_tab",
+    "docs_write_tab",
+    "docs_insert_text"
+]);

package/dist/hosted-bridge.d.ts

@@ -0,0 +1,2 @@
+import generatedHostedBridgeConfig from './generated/hosted.bridge.json';
+export { generatedHostedBridgeConfig };

package/dist/hosted-bridge.js

@@ -0,0 +1,2 @@
+import generatedHostedBridgeConfig from './generated/hosted.bridge.json' with { type: 'json' };
+export { generatedHostedBridgeConfig };

package/dist/hosted-rollout.d.ts

@@ -0,0 +1,7 @@
+import type { HostedRemoteRolloutTier } from './types.js';
+export declare const hostedRemoteRolloutTierByCanonicalToolName: Record<string, HostedRemoteRolloutTier>;
+export declare function getHostedRemoteRolloutTier(canonicalToolName: string): HostedRemoteRolloutTier | null;
+export declare function isHostedRemoteToolEnabled(args: {
+    canonicalToolName: string;
+    enabledTiers: ReadonlySet<HostedRemoteRolloutTier>;
+}): boolean;

package/dist/hosted-rollout.js

@@ -0,0 +1,12 @@
+import { getHostedRemoteToolPolicy, hostedRemoteToolPolicyByCanonicalToolName, } from './hosted-tools.js';
+export const hostedRemoteRolloutTierByCanonicalToolName = Object.fromEntries(Object.entries(hostedRemoteToolPolicyByCanonicalToolName).map(([toolName, policy]) => [
+    toolName,
+    policy.rolloutTier,
+]));
+export function getHostedRemoteRolloutTier(canonicalToolName) {
+    return getHostedRemoteToolPolicy(canonicalToolName)?.rolloutTier ?? null;
+}
+export function isHostedRemoteToolEnabled(args) {
+    const tier = getHostedRemoteRolloutTier(args.canonicalToolName);
+    return tier !== null && args.enabledTiers.has(tier);
+}

package/dist/hosted-tools.d.ts

@@ -0,0 +1,10 @@
+import type { HostedRemoteRolloutTier } from './types.js';
+export interface HostedRemoteToolAccessPolicy {
+    requiredScopes: string[];
+    requiresUnsafeWrites: boolean;
+}
+export interface HostedRemoteToolPolicy extends HostedRemoteToolAccessPolicy {
+    rolloutTier: HostedRemoteRolloutTier;
+}
+export declare const hostedRemoteToolPolicyByCanonicalToolName: Record<string, HostedRemoteToolPolicy>;
+export declare function getHostedRemoteToolPolicy(canonicalToolName: string): HostedRemoteToolPolicy | null;

package/dist/hosted-tools.js

@@ -0,0 +1,180 @@
+const READ_OBJECTS = {
+    requiredScopes: ['objects:read'],
+    requiresUnsafeWrites: false,
+};
+const WRITE_OBJECTS = {
+    requiredScopes: ['objects:write'],
+    requiresUnsafeWrites: true,
+};
+const READ_SYSTEMS = {
+    requiredScopes: ['systems:read'],
+    requiresUnsafeWrites: false,
+};
+const WRITE_SYSTEMS = {
+    requiredScopes: ['systems:write'],
+    requiresUnsafeWrites: false,
+};
+const READ_RECORDS = {
+    requiredScopes: ['records:read'],
+    requiresUnsafeWrites: false,
+};
+const WRITE_RECORDS = {
+    requiredScopes: ['records:write'],
+    requiresUnsafeWrites: true,
+};
+const READ_CALENDAR = {
+    requiredScopes: ['calendar:read'],
+    requiresUnsafeWrites: false,
+};
+const WRITE_CALENDAR = {
+    requiredScopes: ['calendar:write'],
+    requiresUnsafeWrites: true,
+};
+const READ_DRIVE = {
+    requiredScopes: ['drive:read'],
+    requiresUnsafeWrites: false,
+};
+const WRITE_DRIVE = {
+    requiredScopes: ['drive:write'],
+    requiresUnsafeWrites: true,
+};
+const READ_GOOGLE_CONTACTS = {
+    requiredScopes: ['google_contacts:read'],
+    requiresUnsafeWrites: false,
+};
+const READ_EMAIL = {
+    requiredScopes: ['email:read'],
+    requiresUnsafeWrites: false,
+};
+const WRITE_EMAIL = {
+    requiredScopes: ['email:write'],
+    requiresUnsafeWrites: true,
+};
+const SEND_EMAIL = {
+    requiredScopes: ['email:send'],
+    requiresUnsafeWrites: true,
+};
+function withTier(rolloutTier, policy) {
+    return {
+        rolloutTier,
+        ...policy,
+    };
+}
+export const hostedRemoteToolPolicyByCanonicalToolName = {
+    platform_discover: withTier('foundation_live', READ_OBJECTS),
+    platform_capability_fulfillments_get: withTier('foundation_live', READ_OBJECTS),
+    platform_capability_fulfillments_update: withTier('hold_high_risk', WRITE_OBJECTS),
+    systems_templates_list: withTier('foundation_live', READ_OBJECTS),
+    systems_templates_get: withTier('foundation_live', READ_OBJECTS),
+    systems_template_deploy: withTier('tranche_4_power_writes', WRITE_OBJECTS),
+    systems_get: withTier('foundation_live', READ_OBJECTS),
+    systems_run_now: withTier('tranche_3_safe_writes', WRITE_OBJECTS),
+    systems_run_get: withTier('foundation_live', READ_OBJECTS),
+    systems_run_steps_get: withTier('foundation_live', READ_OBJECTS),
+    systems_run_events_get: withTier('foundation_live', READ_OBJECTS),
+    systems_update: withTier('tranche_4_power_writes', WRITE_OBJECTS),
+    systems_plan_patch: withTier('tranche_4_power_writes', WRITE_OBJECTS),
+    systems_apply_patch: withTier('tranche_4_power_writes', WRITE_OBJECTS),
+    systems_rollback: withTier('tranche_4_power_writes', WRITE_OBJECTS),
+    systems_form_get: withTier('foundation_live', READ_OBJECTS),
+    systems_form_submit: withTier('tranche_3_safe_writes', WRITE_OBJECTS),
+    systems_portal_get: withTier('foundation_live', READ_OBJECTS),
+    systems_queue_get: withTier('foundation_live', READ_OBJECTS),
+    systems_queue_list_items: withTier('foundation_live', READ_OBJECTS),
+    systems_queue_get_item: withTier('foundation_live', READ_OBJECTS),
+    systems_queue_claim: withTier('tranche_4_power_writes', WRITE_OBJECTS),
+    systems_queue_release: withTier('tranche_4_power_writes', WRITE_OBJECTS),
+    systems_queue_start_session: withTier('tranche_3_safe_writes', WRITE_OBJECTS),
+    systems_session_get: withTier('foundation_live', READ_OBJECTS),
+    systems_session_action_execute: withTier('tranche_3_safe_writes', WRITE_OBJECTS),
+    systems_session_close: withTier('tranche_3_safe_writes', WRITE_OBJECTS),
+    systems_hosted_chat_context_get: withTier('foundation_live', READ_SYSTEMS),
+    systems_propose_action_revision: withTier('tranche_3_safe_writes', WRITE_SYSTEMS),
+    asqend_propose_config_diff: withTier('tranche_3_safe_writes', WRITE_SYSTEMS),
+    systems_social_content_draft_capture: withTier('tranche_3_safe_writes', WRITE_SYSTEMS),
+    systems_social_content_draft_update: withTier('tranche_3_safe_writes', WRITE_SYSTEMS),
+    meetings_context_get: withTier('tranche_2_safe_reads', READ_RECORDS),
+    meetings_ingest_manual_source: withTier('tranche_3_safe_writes', WRITE_RECORDS),
+    meetings_propose_action_review: withTier('tranche_3_safe_writes', WRITE_RECORDS),
+    meetings_participant_identity_update: withTier('tranche_3_safe_writes', WRITE_RECORDS),
+    get_pending_work: withTier('foundation_live', WRITE_OBJECTS),
+    heartbeat: withTier('foundation_live', WRITE_OBJECTS),
+    complete_task: withTier('foundation_live', WRITE_OBJECTS),
+    fail_task: withTier('foundation_live', WRITE_OBJECTS),
+    records_get: withTier('tranche_2_safe_reads', READ_RECORDS),
+    records_list: withTier('tranche_2_safe_reads', READ_RECORDS),
+    records_lookup_exact: withTier('tranche_2_safe_reads', READ_RECORDS),
+    records_create: withTier('tranche_3_safe_writes', WRITE_RECORDS),
+    records_create_batch: withTier('tranche_3_safe_writes', WRITE_RECORDS),
+    records_upsert: withTier('tranche_3_safe_writes', WRITE_RECORDS),
+    records_update: withTier('tranche_3_safe_writes', WRITE_RECORDS),
+    records_delete: withTier('tranche_4_power_writes', WRITE_RECORDS),
+    record_comments_create: withTier('tranche_4_power_writes', WRITE_RECORDS),
+    record_comments_update: withTier('tranche_4_power_writes', WRITE_RECORDS),
+    record_comments_delete: withTier('tranche_4_power_writes', WRITE_RECORDS),
+    record_checklist_create: withTier('tranche_4_power_writes', WRITE_RECORDS),
+    record_checklist_update: withTier('tranche_4_power_writes', WRITE_RECORDS),
+    record_checklist_delete: withTier('tranche_4_power_writes', WRITE_RECORDS),
+    record_attachments_delete: withTier('tranche_4_power_writes', WRITE_RECORDS),
+    calendar_get_event: withTier('tranche_2_safe_reads', READ_CALENDAR),
+    calendar_list_events: withTier('tranche_2_safe_reads', READ_CALENDAR),
+    calendar_list_range: withTier('tranche_2_safe_reads', READ_CALENDAR),
+    calendar_list_calendars: withTier('tranche_2_safe_reads', READ_CALENDAR),
+    calendar_freebusy: withTier('tranche_2_safe_reads', READ_CALENDAR),
+    calendar_create_event: withTier('tranche_3_safe_writes', WRITE_CALENDAR),
+    calendar_update_event: withTier('tranche_3_safe_writes', WRITE_CALENDAR),
+    drive_list: withTier('tranche_2_safe_reads', READ_DRIVE),
+    drive_read: withTier('tranche_2_safe_reads', READ_DRIVE),
+    drive_download: withTier('tranche_2_safe_reads', READ_DRIVE),
+    drive_create: withTier('tranche_3_safe_writes', WRITE_DRIVE),
+    drive_copy: withTier('tranche_3_safe_writes', WRITE_DRIVE),
+    drive_create_folder: withTier('tranche_3_safe_writes', WRITE_DRIVE),
+    drive_upload: withTier('tranche_3_safe_writes', WRITE_DRIVE),
+    drive_rename: withTier('tranche_3_safe_writes', WRITE_DRIVE),
+    drive_move: withTier('tranche_4_power_writes', WRITE_DRIVE),
+    drive_share: withTier('tranche_4_power_writes', WRITE_DRIVE),
+    drive_delete: withTier('tranche_4_power_writes', WRITE_DRIVE),
+    sheets_read_values: withTier('tranche_2_safe_reads', READ_DRIVE),
+    sheets_list_tabs: withTier('tranche_2_safe_reads', READ_DRIVE),
+    sheets_write_values: withTier('tranche_3_safe_writes', WRITE_DRIVE),
+    sheets_append_rows: withTier('tranche_3_safe_writes', WRITE_DRIVE),
+    sheets_create_spreadsheet: withTier('tranche_3_safe_writes', WRITE_DRIVE),
+    sheets_add_tab: withTier('tranche_3_safe_writes', WRITE_DRIVE),
+    sheets_clear_range: withTier('tranche_3_safe_writes', WRITE_DRIVE),
+    sheets_format_cells: withTier('tranche_4_power_writes', WRITE_DRIVE),
+    sheets_batch_update: withTier('tranche_4_power_writes', WRITE_DRIVE),
+    docs_list_tabs: withTier('tranche_2_safe_reads', READ_DRIVE),
+    docs_read_tab: withTier('tranche_2_safe_reads', READ_DRIVE),
+    docs_get_text: withTier('tranche_2_safe_reads', READ_DRIVE),
+    docs_get_outline: withTier('tranche_2_safe_reads', READ_DRIVE),
+    docs_replace_text: withTier('tranche_3_safe_writes', WRITE_DRIVE),
+    docs_create_tab: withTier('tranche_3_safe_writes', WRITE_DRIVE),
+    docs_write_tab: withTier('tranche_3_safe_writes', WRITE_DRIVE),
+    docs_insert_text: withTier('tranche_3_safe_writes', WRITE_DRIVE),
+    docs_batch_update: withTier('tranche_4_power_writes', WRITE_DRIVE),
+    google_contacts_list: withTier('tranche_2_safe_reads', READ_GOOGLE_CONTACTS),
+    google_contacts_search: withTier('tranche_2_safe_reads', READ_GOOGLE_CONTACTS),
+    email_accounts_list: withTier('tranche_2_safe_reads', READ_EMAIL),
+    email_labels_list: withTier('tranche_2_safe_reads', READ_EMAIL),
+    email_search: withTier('tranche_2_safe_reads', READ_EMAIL),
+    email_thread_get: withTier('tranche_2_safe_reads', READ_EMAIL),
+    email_message_get: withTier('tranche_2_safe_reads', READ_EMAIL),
+    email_attachment_get: withTier('tranche_2_safe_reads', READ_EMAIL),
+    email_draft_list: withTier('tranche_2_safe_reads', READ_EMAIL),
+    email_compose: withTier('tranche_3_safe_writes', SEND_EMAIL),
+    email_compose_with_attachment: withTier('tranche_3_safe_writes', SEND_EMAIL),
+    email_reply_send: withTier('tranche_3_safe_writes', SEND_EMAIL),
+    email_reply_with_attachment: withTier('tranche_3_safe_writes', SEND_EMAIL),
+    email_forward: withTier('tranche_3_safe_writes', SEND_EMAIL),
+    email_draft_send: withTier('tranche_3_safe_writes', SEND_EMAIL),
+    email_modify: withTier('tranche_3_safe_writes', WRITE_EMAIL),
+    email_draft_create: withTier('tranche_3_safe_writes', WRITE_EMAIL),
+    email_draft_delete: withTier('tranche_3_safe_writes', WRITE_EMAIL),
+    email_label_create: withTier('tranche_3_safe_writes', WRITE_EMAIL),
+    email_archive_thread: withTier('tranche_3_safe_writes', WRITE_EMAIL),
+    web_search: withTier('tranche_2_safe_reads', READ_OBJECTS),
+    web_fetch: withTier('tranche_2_safe_reads', READ_OBJECTS),
+};
+export function getHostedRemoteToolPolicy(canonicalToolName) {
+    return hostedRemoteToolPolicyByCanonicalToolName[canonicalToolName] ?? null;
+}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { generatedToolManifest } from './manifest.js';
+export { generatedToolDefinitions } from './definitions.js';
+export { generatedDispatch } from './dispatch.js';
+export { generatedDefaultVisibleToolNames } from './visibility.js';
+export { generatedWriteTools } from './write-set.js';
+export { generatedFallbackTools } from './fallback-set.js';
+export { generatedHostedBridgeConfig } from './hosted-bridge.js';
+export { classifyGeneratedToolEndpointStatus, getGeneratedToolTransportSupport, generatedToolTransportSupportByName, } from './transport-support.js';
+export { executeBatchExecuteOperations, parseBatchExecuteOperations, resolveBatchExecuteConcurrency, } from './batch-execute.js';
+export type { BatchExecuteResult, BatchOperation, BatchOperationResult } from './batch-execute.js';
+export { getHostedRemoteToolPolicy, hostedRemoteToolPolicyByCanonicalToolName, } from './hosted-tools.js';
+export type { HostedRemoteToolAccessPolicy, HostedRemoteToolPolicy } from './hosted-tools.js';
+export { getHostedRemoteRolloutTier, hostedRemoteRolloutTierByCanonicalToolName, isHostedRemoteToolEnabled, } from './hosted-rollout.js';
+export type { GeneratedDispatchEntry, GeneratedHostedBridgeConfig, HostedRemoteRolloutTier, GeneratedToolEndpointHealthClass, GeneratedToolEndpointProbe, GeneratedToolEndpointStatus, GeneratedToolEndpointTransportClass, GeneratedToolDefinition, GeneratedToolTransportSupport, } from './types.js';

package/dist/index.js

@@ -0,0 +1,11 @@
+export { generatedToolManifest } from './manifest.js';
+export { generatedToolDefinitions } from './definitions.js';
+export { generatedDispatch } from './dispatch.js';
+export { generatedDefaultVisibleToolNames } from './visibility.js';
+export { generatedWriteTools } from './write-set.js';
+export { generatedFallbackTools } from './fallback-set.js';
+export { generatedHostedBridgeConfig } from './hosted-bridge.js';
+export { classifyGeneratedToolEndpointStatus, getGeneratedToolTransportSupport, generatedToolTransportSupportByName, } from './transport-support.js';
+export { executeBatchExecuteOperations, parseBatchExecuteOperations, resolveBatchExecuteConcurrency, } from './batch-execute.js';
+export { getHostedRemoteToolPolicy, hostedRemoteToolPolicyByCanonicalToolName, } from './hosted-tools.js';
+export { getHostedRemoteRolloutTier, hostedRemoteRolloutTierByCanonicalToolName, isHostedRemoteToolEnabled, } from './hosted-rollout.js';

package/dist/manifest.d.ts

@@ -0,0 +1,2 @@
+import generatedToolManifest from './generated/tools.manifest.json';
+export { generatedToolManifest };

package/dist/manifest.js

@@ -0,0 +1,2 @@
+import generatedToolManifest from './generated/tools.manifest.json' with { type: 'json' };
+export { generatedToolManifest };

package/dist/transport-support.d.ts

@@ -0,0 +1,7 @@
+import type { GeneratedToolEndpointProbe, GeneratedToolEndpointStatus, GeneratedToolTransportSupport } from './types.js';
+export declare const generatedToolTransportSupportByName: Record<string, GeneratedToolTransportSupport>;
+export declare function getGeneratedToolTransportSupport(toolName: string): GeneratedToolTransportSupport | null;
+export declare function classifyGeneratedToolEndpointStatus(args: {
+    toolName: string;
+    probe?: GeneratedToolEndpointProbe;
+}): GeneratedToolEndpointStatus;

package/dist/transport-support.js

@@ -0,0 +1,139 @@
+import { generatedToolManifest } from './manifest.js';
+function deriveGeneratedToolTransportSupport(toolName) {
+    const tool = generatedToolManifest.tools.find((entry) => entry.name === toolName);
+    if (!tool) {
+        return null;
+    }
+    const transportSupport = tool.transportSupport;
+    if (!transportSupport || typeof transportSupport !== 'object') {
+        return null;
+    }
+    const candidate = transportSupport;
+    if (typeof candidate.localStdio !== 'boolean' ||
+        typeof candidate.hostedRemote !== 'boolean' ||
+        typeof candidate.capabilityHttp !== 'boolean' ||
+        typeof candidate.localOnly !== 'boolean' ||
+        typeof candidate.remoteOnly !== 'boolean') {
+        return null;
+    }
+    return {
+        localStdio: candidate.localStdio,
+        hostedRemote: candidate.hostedRemote,
+        capabilityHttp: candidate.capabilityHttp,
+        localOnly: candidate.localOnly,
+        remoteOnly: candidate.remoteOnly,
+    };
+}
+export const generatedToolTransportSupportByName = Object.fromEntries(generatedToolManifest.tools
+    .map((tool) => [tool.name, deriveGeneratedToolTransportSupport(tool.name)])
+    .filter((entry) => entry[1] !== null));
+export function getGeneratedToolTransportSupport(toolName) {
+    return generatedToolTransportSupportByName[toolName] ?? null;
+}
+function getGeneratedManifestTool(toolName) {
+    return generatedToolManifest.tools.find((entry) => entry.name === toolName) ?? null;
+}
+function classifyTransport(support) {
+    if (!support) {
+        return 'unsupported_transport';
+    }
+    if (support.capabilityHttp) {
+        return 'capability_http';
+    }
+    if (support.hostedRemote) {
+        return 'hosted_remote_mcp_compatibility';
+    }
+    if (support.localOnly || support.localStdio) {
+        return 'local_stdio_only';
+    }
+    return 'unsupported_transport';
+}
+function defaultNonHttpReason(transportClass) {
+    switch (transportClass) {
+        case 'hosted_remote_mcp_compatibility':
+            return 'Tool is available as hosted remote MCP compatibility, not as hosted capability HTTP.';
+        case 'local_stdio_only':
+            return 'Tool is local stdio only and is not available over hosted capability HTTP.';
+        case 'unsupported_transport':
+            return 'Tool has no supported generated transport.';
+        case 'capability_http':
+            return 'Tool has a generated hosted capability HTTP route.';
+    }
+}
+function statusFromProbe(args) {
+    if (args.transportClass !== 'capability_http') {
+        return {
+            healthClass: 'not_capability_http',
+            statusLabel: args.transportClass === 'hosted_remote_mcp_compatibility'
+                ? 'Hosted remote MCP'
+                : args.transportClass === 'local_stdio_only'
+                    ? 'Local stdio only'
+                    : 'Unsupported transport',
+            reason: args.probe?.reason ?? defaultNonHttpReason(args.transportClass),
+        };
+    }
+    switch (args.probe?.kind) {
+        case 'http_success':
+            return {
+                healthClass: 'works',
+                statusLabel: 'Works',
+                reason: args.probe.reason ?? `Hosted capability HTTP route ${args.routePath} returned OK.`,
+            };
+        case 'http_error':
+            return {
+                healthClass: 'doesnt_work',
+                statusLabel: "Doesn't work",
+                reason: args.probe.reason ??
+                    `Hosted capability HTTP route ${args.routePath} returned HTTP ${args.probe.httpStatus}.`,
+            };
+        case 'capability_fulfillment_disabled':
+            return {
+                healthClass: 'requires_fulfillment',
+                statusLabel: 'Requires fulfillment',
+                reason: args.probe.reason ??
+                    `Hosted capability HTTP route ${args.routePath} is available but requires enabled capability fulfillment.`,
+            };
+        case 'fixture_required':
+            return {
+                healthClass: 'fixture_required',
+                statusLabel: 'Fixture required',
+                reason: args.probe.reason ??
+                    `Hosted capability HTTP route ${args.routePath} exists but needs a safe fixture for full proof.`,
+            };
+        case 'not_exercised':
+        case undefined:
+            return {
+                healthClass: 'half_works',
+                statusLabel: 'Half works',
+                reason: args.probe?.reason ??
+                    `Hosted capability HTTP route ${args.routePath} exists but was not fully exercised.`,
+            };
+    }
+}
+export function classifyGeneratedToolEndpointStatus(args) {
+    const tool = getGeneratedManifestTool(args.toolName);
+    if (!tool) {
+        return {
+            toolName: args.toolName,
+            routePath: null,
+            transportClass: 'unsupported_transport',
+            healthClass: 'unknown_tool',
+            statusLabel: 'Unknown tool',
+            reason: 'Tool is not present in the generated MCP manifest.',
+        };
+    }
+    const support = getGeneratedToolTransportSupport(args.toolName);
+    const transportClass = classifyTransport(support);
+    const routePath = typeof tool.routePath === 'string' ? tool.routePath : null;
+    const status = statusFromProbe({
+        routePath,
+        transportClass,
+        probe: args.probe,
+    });
+    return {
+        toolName: args.toolName,
+        routePath,
+        transportClass,
+        ...status,
+    };
+}