@rudderhq/agent-runtime-utils 0.4.6-canary.9 → 0.5.0

package/dist/rudder-mcp-contract.d.ts

@@ -0,0 +1,1028 @@
+export declare const RUDDER_MCP_CONTRACT_VERSION = "rudder.agent-mcp-tools/v1";
+export interface RudderMcpSemanticToolContract {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+export interface RudderMcpToolContractSource extends RudderMcpSemanticToolContract {
+    mutating: boolean;
+    requiresOrgId: boolean;
+    requiresAgentId: boolean;
+    attachesRunIdWhenAvailable: boolean;
+}
+export declare function rudderMcpInputSchemaForCapability(id: string): {
+    type: "object";
+    additionalProperties: false;
+    properties: Record<string, unknown>;
+};
+export declare const RUDDER_MCP_CANONICAL_TOOL_DEFINITIONS: ({
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "agent.me";
+    name: "rudder_agent_me";
+    description: "Show the authenticated agent identity, budget, and chain of command.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "agent.inbox";
+    name: "rudder_agent_inbox";
+    description: "List the compact assignee and reviewer work inbox for the authenticated agent.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "agent.capabilities";
+    name: "rudder_agent_capabilities";
+    description: "List the stable Rudder agent command contract.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "agent.update";
+    name: "rudder_agent_update";
+    description: "Update an agent's control-plane identity fields; defaults to the authenticated agent.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "agent.skills.create";
+    name: "rudder_agent_skills_create";
+    description: "Create an agent-private skill package under AGENT_HOME/skills.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "agent.skills.enable";
+    name: "rudder_agent_skills_enable";
+    description: "Add skill selections to an agent without replacing existing enabled skills.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "agent.skills.sync";
+    name: "rudder_agent_skills_sync";
+    description: "Sync the desired enabled skill set for an agent.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "issue.get";
+    name: "rudder_issue_get";
+    description: "Read a full issue by UUID or identifier.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "issue.search";
+    name: "rudder_issue_search";
+    description: "Search issues with the server-side issue index across title, identifier, description, and comments.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "issue.context";
+    name: "rudder_issue_context";
+    description: "Read the compact heartbeat context for an issue; wake comments may be addressed by full id or cmt_<uuid-prefix>.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "issue.checkout";
+    name: "rudder_issue_checkout";
+    description: "Atomically checkout an issue for the current or specified agent.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: true;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "issue.comment";
+    name: "rudder_issue_comment";
+    description: "Add a comment to an issue, optionally uploading images and appending Markdown image links.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "issue.comments.list";
+    name: "rudder_issue_comments_list";
+    description: "List issue comments, optionally only newer comments after a full comment id or cmt_<uuid-prefix> with --after.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "issue.comments.get";
+    name: "rudder_issue_comments_get";
+    description: "Read one issue comment by full id or cmt_<uuid-prefix> scoped to the issue.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "issue.update";
+    name: "rudder_issue_update";
+    description: "Apply generic issue updates when workflow commands are not enough, optionally uploading images for the update comment.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "issue.review";
+    name: "rudder_issue_review";
+    description: "Record a structured reviewer decision with a required comment.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "issue.commit";
+    name: "rudder_issue_commit";
+    description: "Report a code commit created during issue work as structured issue activity.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "issue.done";
+    name: "rudder_issue_done";
+    description: "Mark an issue done with a required completion comment, optionally uploading images.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "issue.block";
+    name: "rudder_issue_block";
+    description: "Mark an issue blocked with a required blocker comment, optionally uploading images.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "project.list";
+    name: "rudder_project_list";
+    description: "List projects in an organization.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "project.get";
+    name: "rudder_project_get";
+    description: "Read one project by ID or shortname.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "project.create";
+    name: "rudder_project_create";
+    description: "Create a project in the organization.";
+    mutating: true;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "project.update";
+    name: "rudder_project_update";
+    description: "Update mutable project fields such as name, description, status, goals, lead agent, target date, color, or archivedAt.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "user.activity";
+    name: "rudder_user_activity";
+    description: "Read a user-centered activity ledger with safe excerpts and provenance across chats, issue comments, approval comments, and user actor activity.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "library.file.list";
+    name: "rudder_library_file_list";
+    description: "List Library files and folders; file rows include `libraryEntryId` when a strong reference can be generated.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "library.file.get";
+    name: "rudder_library_file_get";
+    description: "Fallback read when local filesystem access is unavailable; JSON includes `mentionHref` and `markdownLink`.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "library.file.ref";
+    name: "rudder_library_file_ref";
+    description: "Return the stable Markdown reference for one Library file without printing file content.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "library.file.link";
+    name: "rudder_library_file_link";
+    description: "Compatibility alias for `rudder library file ref <path>`.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "library.file.put";
+    name: "rudder_library_file_put";
+    description: "Fallback create/update when local filesystem access is unavailable; JSON includes `mentionHref` and `markdownLink`.";
+    mutating: true;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "approval.get";
+    name: "rudder_approval_get";
+    description: "Read one approval request.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "approval.issues";
+    name: "rudder_approval_issues";
+    description: "List the issues linked to an approval.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "approval.comment";
+    name: "rudder_approval_comment";
+    description: "Add a comment to an approval.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "skill.list";
+    name: "rudder_skill_list";
+    description: "List organization-visible skills.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "skill.get";
+    name: "rudder_skill_get";
+    description: "Read one organization skill detail.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "skill.file";
+    name: "rudder_skill_file";
+    description: "Read one file from an organization skill package.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "skill.import";
+    name: "rudder_skill_import";
+    description: "Import a skill package into the organization skill library.";
+    mutating: true;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "skill.scan-local";
+    name: "rudder_skill_scan_local";
+    description: "Scan local roots for skill packages and import new ones.";
+    mutating: true;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "skill.scan-projects";
+    name: "rudder_skill_scan_projects";
+    description: "Scan the org workspace and any legacy project workspace records for skill packages and import new ones.";
+    mutating: true;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "browser.tabs";
+    name: "rudder_browser_tabs";
+    description: "List Browser tabs owned by the current Rudder agent run.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: true;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "browser.open";
+    name: "rudder_browser_open";
+    description: "Open a run-owned tab in the Rudder Browser.";
+    mutating: true;
+    requiresOrgId: true;
+    requiresAgentId: true;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "browser.navigate";
+    name: "rudder_browser_navigate";
+    description: "Navigate a run-owned Rudder Browser tab.";
+    mutating: true;
+    requiresOrgId: true;
+    requiresAgentId: true;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "browser.read";
+    name: "rudder_browser_read";
+    description: "Read a structured snapshot from a run-owned Rudder Browser tab.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: true;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "browser.click";
+    name: "rudder_browser_click";
+    description: "Click an element reference returned by Rudder Browser read.";
+    mutating: true;
+    requiresOrgId: true;
+    requiresAgentId: true;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "browser.type";
+    name: "rudder_browser_type";
+    description: "Type into an element reference in a run-owned Rudder Browser tab.";
+    mutating: true;
+    requiresOrgId: true;
+    requiresAgentId: true;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "browser.screenshot";
+    name: "rudder_browser_screenshot";
+    description: "Capture a screenshot of a run-owned Rudder Browser tab.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: true;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "browser.close";
+    name: "rudder_browser_close";
+    description: "Close a run-owned Rudder Browser tab.";
+    mutating: true;
+    requiresOrgId: true;
+    requiresAgentId: true;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "automation.list";
+    name: "rudder_automation_list";
+    description: "List automations for an organization with compact local filters.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "automation.get";
+    name: "rudder_automation_get";
+    description: "Read one automation detail including triggers and recent runs.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "automation.runs";
+    name: "rudder_automation_runs";
+    description: "List recent runs for one automation.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "automation.triggers.list";
+    name: "rudder_automation_triggers_list";
+    description: "List triggers configured for one automation.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "automation.triggers.create";
+    name: "rudder_automation_triggers_create";
+    description: "Create a schedule, webhook, or API trigger through the governed automation API.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "automation.triggers.update";
+    name: "rudder_automation_triggers_update";
+    description: "Update an automation trigger through the governed automation API.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "automation.triggers.delete";
+    name: "rudder_automation_triggers_delete";
+    description: "Delete an automation trigger through the governed automation API.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "automation.triggers.rotate-secret";
+    name: "rudder_automation_triggers_rotate_secret";
+    description: "Rotate an automation webhook trigger secret through the governed automation API.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "automation.create";
+    name: "rudder_automation_create";
+    description: "Create an automation through the governed automation API.";
+    mutating: true;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "automation.update";
+    name: "rudder_automation_update";
+    description: "Update automation fields through the governed automation API.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "automation.enable";
+    name: "rudder_automation_enable";
+    description: "Enable an automation by setting status to active.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "automation.disable";
+    name: "rudder_automation_disable";
+    description: "Disable an automation by setting status to paused.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "automation.run";
+    name: "rudder_automation_run";
+    description: "Trigger a manual automation run.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "chat.list";
+    name: "rudder_chat_list";
+    description: "List chat conversations without dumping full message history.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "chat.search";
+    name: "rudder_chat_search";
+    description: "Search chats with bounded snippets and optional scope filtering.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "chat.get";
+    name: "rudder_chat_get";
+    description: "Read one chat conversation record.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "chat.messages";
+    name: "rudder_chat_messages";
+    description: "Read bounded chat messages with page cursors; transcript output is omitted unless requested.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "chat.transcript";
+    name: "rudder_chat_transcript";
+    description: "Read paginated chat messages with assistant transcript entries clipped in human output.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "chat.read";
+    name: "rudder_chat_read";
+    description: "Read a bounded recent-message snapshot for one chat with page cursors.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "chat.create";
+    name: "rudder_chat_create";
+    description: "Create a chat conversation.";
+    mutating: true;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "chat.send";
+    name: "rudder_chat_send";
+    description: "Send an agent-authored message directly to the operator in a chat.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: true;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "chat.archive";
+    name: "rudder_chat_archive";
+    description: "Archive a chat conversation without deleting it.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "runs.list";
+    name: "rudder_runs_list";
+    description: "List lightweight run summaries with stable pagination and filters; use --full only for legacy full-row compatibility.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "runs.by-skill";
+    name: "rudder_runs_by_skill";
+    description: "Build a paginated skill evidence packet from lightweight run summaries; use --full only for legacy full-row compatibility.";
+    mutating: false;
+    requiresOrgId: true;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "runs.get";
+    name: "rudder_runs_get";
+    description: "Read one bounded run summary; use --full only from a direct trusted CLI for raw detail.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "runs.events";
+    name: "rudder_runs_events";
+    description: "List a bounded page of persisted run events with a lossless opaque cursor and clipped payload previews.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "runs.log";
+    name: "rudder_runs_log";
+    description: "Read a bounded byte range of stored run log content.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "runs.transcript";
+    name: "rudder_runs_transcript";
+    description: "Read a compact server-normalized transcript; --json changes encoding only and --full is direct-CLI-only raw access.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "runs.errors";
+    name: "rudder_runs_errors";
+    description: "List failed tool calls, stderr, runtime failures, and jump-to-context commands.";
+    mutating: false;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: false;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "runs.cancel";
+    name: "rudder_runs_cancel";
+    description: "Cancel a heartbeat run through the governed server route.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+} | {
+    inputSchema: {
+        type: "object";
+        additionalProperties: false;
+        properties: Record<string, unknown>;
+    };
+    capabilityId: "runs.retry";
+    name: "rudder_runs_retry";
+    description: "Retry a failed, timed out, or cancelled run through the governed server route.";
+    mutating: true;
+    requiresOrgId: false;
+    requiresAgentId: false;
+    attachesRunIdWhenAvailable: true;
+})[];
+export declare function rudderMcpSemanticToolContract(tool: RudderMcpToolContractSource): RudderMcpSemanticToolContract;
+export declare const RUDDER_MCP_CANONICAL_TOOL_CONTRACTS: RudderMcpSemanticToolContract[];
+export declare const RUDDER_CORE_MCP_TOOL_CONTRACTS: RudderMcpSemanticToolContract[];
+export declare const RUDDER_BROWSER_MCP_TOOL_CONTRACTS: RudderMcpSemanticToolContract[];
+export declare const RUDDER_CORE_MCP_TOOL_NAMES: string[];
+export declare const RUDDER_BROWSER_MCP_TOOL_NAMES: string[];
+export declare const RUDDER_CORE_MCP_CONTRACT_HASH = "85436ea9893ad336e449cef31a0d43ee34387e5955e836578f27828d2e576e17";
+export declare const RUDDER_BROWSER_MCP_CONTRACT_HASH = "c4d41b5aaa22d76e528877c17cee84e0fb363b38ebe9d2ff4e1c36a46edecfbe";
+//# sourceMappingURL=rudder-mcp-contract.d.ts.map