@dobbyai/mcp-external 1.0.4 → 1.2.0

package/dist/tools/hosted-agents.js

@@ -0,0 +1,214 @@
+/**
+ * Managed Agents (hosted-agents) MCP Tools
+ *
+ * Read-only visibility, for AI clients, into the tenant's hosted agents and
+ * their month-to-date usage/cost:
+ *   1. list_hosted_agents        — GET /hosted-agents
+ *   2. get_hosted_agent_usage    — GET /hosted-agents/{id}/usage
+ *
+ * Write tools (P0a, one-prompt hosted-agent flow, approved by Gil 2026-07-16):
+ * host_sample_agent · create_hosted_agent · deploy_hosted_agent ·
+ * run_hosted_agent · get_agent_results · delete_hosted_agent. Tool definitions
+ * only — dispatch + descriptions live in
+ * packages/capability-core/src/capabilities/hosted-agents.ts (byte-identical,
+ * enforced by registry-listing-parity.test.ts).
+ */
+export const hostedAgentsTools = {
+    list_hosted_agents: {
+        name: "list_hosted_agents",
+        annotations: {
+            title: "List Managed (Hosted) Agents",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "List the current tenant's Managed Agents (container agents Dobby hosts and runs) with their status, region, and labels. Managed Agents is an allowlist-gated feature; returns an entitlement error if the tenant is not enabled.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+    get_hosted_agent_usage: {
+        name: "get_hosted_agent_usage",
+        annotations: {
+            title: "Get Managed Agent Usage & Cost",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "For one Managed Agent, return its daily usage (executions + vCPU/GiB-seconds) and the month-to-date itemized charge lines with an estimated total cost. Costs are computed for transparency and are not invoiced here.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "The hosted agent id (ha_...).",
+                },
+                days: {
+                    type: "number",
+                    description: "Usage lookback window in days (default 30)",
+                    default: 30,
+                },
+            },
+            required: ["agent_id"],
+        },
+    },
+    host_sample_agent: {
+        name: "host_sample_agent",
+        annotations: {
+            title: "Host Sample Agent",
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "The fastest way to get a running, governed Managed Agent: creates a new agent, connects it, deploys Dobby's own public zero-config sample image (a small weather-lookup agent — no Docker, no image to build), and runs it — all in one call. Use this when the user wants to try/demo Managed Agents, or hasn't confirmed they have Docker installed for create_hosted_agent's own-code path. Returns fast (deploy-kickoff); call get_agent_results a few seconds later to see the run outcome.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Display name for the agent (default 'Sample Agent').",
+                },
+                region: {
+                    type: "string",
+                    enum: ["il", "eu", "us"],
+                    description: "Hosting region (default 'il'). Only regions with a provisioned hosting shard are accepted.",
+                },
+            },
+        },
+    },
+    create_hosted_agent: {
+        name: "create_hosted_agent",
+        annotations: {
+            title: "Create Managed Agent",
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "Register a new Managed Agent. TWO kinds: (1) agent_kind='prompt' (NO code, NO Docker) — you supply prompt_text describing what the agent does and it runs on Dobby's Gemini runner with a generic http_request tool; reference secrets by name as {{NAME}} in the prompt and add their values later via the secrets API, then deploy_hosted_agent + run_hosted_agent to get an answer. (2) agent_kind='container' (default) — your OWN image: returns a one-time SDK bearer token + a one-time Artifact Registry push token (save both, unrecoverable); build+push your image to repo_path then deploy_hosted_agent. Optionally attach to an existing eligible dobby_sdk workload via existing_connector_id (container kind only).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Display name for the agent (required).",
+                },
+                region: {
+                    type: "string",
+                    enum: ["il", "eu", "us"],
+                    description: "Hosting region (default 'il'). Only regions with a provisioned hosting shard are accepted.",
+                },
+                agent_kind: {
+                    type: "string",
+                    enum: ["container", "prompt"],
+                    description: "'container' (default, your own image) or 'prompt' (no-code — runs prompt_text on Dobby's Gemini runner).",
+                },
+                prompt_text: {
+                    type: "string",
+                    description: "Required when agent_kind='prompt'. The single prompt defining what the agent does. Reference secrets by NAME as {{NAME}} — never paste secret values here.",
+                },
+                model_name: {
+                    type: "string",
+                    enum: ["gemini-2.5-flash", "gemini-2.5-flash-lite", "gemini-2.5-pro"],
+                    description: "prompt-kind only: Gemini model (default gemini-2.5-flash).",
+                },
+                allowed_hosts: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: 'prompt-kind only: hostnames the http_request tool may reach (e.g. ["salesforce.com"]). Empty = reasoning-only, no external calls.',
+                },
+                existing_connector_id: {
+                    type: "string",
+                    description: "Attach to an existing eligible dobby_sdk workload connector (wc_...) instead of auto-provisioning a dedicated one. Container kind only.",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    deploy_hosted_agent: {
+        name: "deploy_hosted_agent",
+        annotations: {
+            title: "Deploy Managed Agent",
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "Deploy an image tag you've already pushed (via create_hosted_agent's repo_path) to a Managed Agent. Runs Dobby's preflight scan and refuses on any CRITICAL finding (e.g. baked-in secrets, missing entrypoint, unsupported architecture, oversized image) — read fix_hint on failure and correct. After a successful deploy, call run_hosted_agent to start it.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "The hosted agent id (ha_...).",
+                },
+                image_tag: {
+                    type: "string",
+                    description: "The tag you pushed (default 'v1').",
+                },
+            },
+            required: ["agent_id"],
+        },
+    },
+    run_hosted_agent: {
+        name: "run_hosted_agent",
+        annotations: {
+            title: "Run Managed Agent",
+            readOnlyHint: false,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "Start a run of a deployed Managed Agent (Cloud Run Job execution). Returns immediately with a queued execution_id — this does NOT wait for the run to finish. Call get_agent_results a few seconds later to see the outcome.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "The hosted agent id (ha_...).",
+                },
+            },
+            required: ["agent_id"],
+        },
+    },
+    get_agent_results: {
+        name: "get_agent_results",
+        annotations: {
+            title: "Get Managed Agent Results",
+            readOnlyHint: true,
+            destructiveHint: false,
+            openWorldHint: false,
+        },
+        description: "Check a Managed Agent's latest run: status, a short log tail, and — once the run has been scanned — the governance verdict (compliant/violated/needs_review/unverifiable) with a link to the full scan. If the latest execution is still 'queued' or 'running', poll this again in about 10 seconds; after roughly 2 minutes of no terminal status, STOP polling and hand the watch_url to the user instead of looping indefinitely.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "The hosted agent id (ha_...).",
+                },
+            },
+            required: ["agent_id"],
+        },
+    },
+    delete_hosted_agent: {
+        name: "delete_hosted_agent",
+        annotations: {
+            title: "Delete Managed Agent",
+            readOnlyHint: false,
+            destructiveHint: true,
+            openWorldHint: false,
+        },
+        description: "Delete (tear down) a Managed Agent — soft-deletes the agent and best-effort removes its Cloud Run Job + staged secrets. Cannot be undone; create a new agent if needed afterward.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agent_id: {
+                    type: "string",
+                    description: "The hosted agent id (ha_...).",
+                },
+            },
+            required: ["agent_id"],
+        },
+    },
+};
+//# sourceMappingURL=hosted-agents.js.map

package/dist/tools/hosted-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-agents.js","sourceRoot":"","sources":["../../src/tools/hosted-agents.ts"],"names":[],"mappings":"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"}