@andreprado/agentkit 0.1.0-alpha.17 → 0.1.0-alpha.18

package/src/cli/deploy-chat-ui.ts

@@ -70,6 +70,27 @@ export async function startDeployChatUiServer(
         return;
       }
 
+      if (
+        request.method === "GET" &&
+        (requestUrl.pathname === "/v1/conversations" ||
+          /^\/v1\/conversations\/[^/]+(?:\/trace)?$/.test(requestUrl.pathname))
+      ) {
+        const token = await readDeployAccessTokenForUi(tokenPath);
+        const upstream = await fetch(new URL(requestUrl.pathname, deployUrl).href, {
+          method: "GET",
+          headers: {
+            Authorization: `Bearer ${token}`,
+          },
+        });
+        const text = await upstream.text();
+
+        response.writeHead(upstream.status, {
+          "content-type": upstream.headers.get("content-type") ?? "application/json",
+        });
+        response.end(text);
+        return;
+      }
+
       sendJson(response, 404, { error: { code: "not_found", message: "Route not found." } });
     } catch (error) {
       sendJson(response, 500, {
@@ -196,6 +217,8 @@ function renderDeployChatUi(input: { deployUrl: string }): string {
       header {
         border-bottom: 1px solid var(--line);
         padding: 18px 22px;
+        display: grid;
+        gap: 10px;
       }
 
       h1 {
@@ -204,12 +227,27 @@ function renderDeployChatUi(input: { deployUrl: string }): string {
         line-height: 1.2;
       }
 
+      .topline {
+        display: flex;
+        align-items: start;
+        justify-content: space-between;
+        gap: 12px;
+      }
+
       code {
         color: var(--muted);
         font-size: 12px;
         overflow-wrap: anywhere;
       }
 
+      .meta {
+        display: flex;
+        flex-wrap: wrap;
+        gap: 8px 14px;
+        color: var(--muted);
+        font-size: 12px;
+      }
+
       #messages {
         padding: 22px;
         overflow: auto;
@@ -255,6 +293,39 @@ function renderDeployChatUi(input: { deployUrl: string }): string {
         background: #fff6f6;
       }
 
+      #trace {
+        border-top: 1px solid var(--line);
+        padding: 12px 22px;
+        display: grid;
+        gap: 8px;
+        background: #fbfbfa;
+      }
+
+      .tool-call {
+        border: 1px solid var(--line);
+        border-radius: 8px;
+        padding: 10px 12px;
+        display: grid;
+        gap: 6px;
+        font-size: 12px;
+      }
+
+      .tool-head {
+        display: flex;
+        flex-wrap: wrap;
+        gap: 8px;
+        align-items: center;
+        color: var(--muted);
+        font-weight: 700;
+      }
+
+      .tool-call pre {
+        margin: 0;
+        max-height: 180px;
+        overflow: auto;
+        white-space: pre-wrap;
+      }
+
       form {
         border-top: 1px solid var(--line);
         padding: 14px;
@@ -286,6 +357,13 @@ function renderDeployChatUi(input: { deployUrl: string }): string {
         cursor: pointer;
       }
 
+      button.secondary {
+        min-height: 34px;
+        color: var(--ink);
+        background: #eef1ee;
+        border: 1px solid var(--line);
+      }
+
       button:disabled {
         cursor: wait;
         opacity: 0.65;
@@ -305,10 +383,20 @@ function renderDeployChatUi(input: { deployUrl: string }): string {
   <body>
     <main>
       <header>
-        <h1>AgentKit Hosted Chat</h1>
-        <code>${deployUrl}</code>
+        <div class="topline">
+          <div>
+            <h1>AgentKit Hosted Chat</h1>
+            <code>${deployUrl}</code>
+          </div>
+          <button class="secondary" id="new-conversation" type="button">New conversation</button>
+        </div>
+        <div class="meta">
+          <span>Conversation: <code id="conversation-id">none</code></span>
+          <span>Tool calls: <code id="tool-count">0</code></span>
+        </div>
       </header>
       <section id="messages" aria-live="polite"></section>
+      <section id="trace" aria-live="polite"></section>
       <form id="form">
         <textarea id="message" name="message" placeholder="Type a message" required autofocus></textarea>
         <button id="send" type="submit">Send</button>
@@ -319,6 +407,10 @@ function renderDeployChatUi(input: { deployUrl: string }): string {
       const textarea = document.querySelector("#message");
       const send = document.querySelector("#send");
       const messages = document.querySelector("#messages");
+      const trace = document.querySelector("#trace");
+      const conversationLabel = document.querySelector("#conversation-id");
+      const toolCount = document.querySelector("#tool-count");
+      const newConversation = document.querySelector("#new-conversation");
       let conversationId = null;
 
       function addMessage(role, content, className = "") {
@@ -335,6 +427,55 @@ function renderDeployChatUi(input: { deployUrl: string }): string {
         messages.scrollTop = messages.scrollHeight;
       }
 
+      function setConversationId(value) {
+        conversationId = value || null;
+        conversationLabel.textContent = conversationId || "none";
+      }
+
+      function renderTrace(payload) {
+        const calls = [];
+        for (const run of payload.runs || []) {
+          for (const call of run.toolCalls || []) {
+            calls.push(call);
+          }
+        }
+
+        toolCount.textContent = String(calls.length);
+        trace.innerHTML = "";
+
+        for (const call of calls.slice(-8)) {
+          const item = document.createElement("article");
+          item.className = "tool-call";
+          const head = document.createElement("div");
+          head.className = "tool-head";
+          head.textContent = [call.name, call.status, call.errorMessage].filter(Boolean).join(" · ");
+          const input = document.createElement("pre");
+          input.textContent = JSON.stringify(call.input || {}, null, 2);
+          item.append(head, input);
+          trace.append(item);
+        }
+      }
+
+      async function refreshTrace() {
+        if (!conversationId) {
+          toolCount.textContent = "0";
+          trace.innerHTML = "";
+          return;
+        }
+
+        const response = await fetch("/v1/conversations/" + encodeURIComponent(conversationId) + "/trace");
+        const payload = await response.json();
+        if (response.ok) renderTrace(payload);
+      }
+
+      newConversation.addEventListener("click", () => {
+        setConversationId(null);
+        messages.innerHTML = "";
+        trace.innerHTML = "";
+        toolCount.textContent = "0";
+        textarea.focus();
+      });
+
       textarea.addEventListener("keydown", (event) => {
         if (event.key !== "Enter" || event.shiftKey || event.isComposing) return;
         event.preventDefault();
@@ -363,10 +504,12 @@ function renderDeployChatUi(input: { deployUrl: string }): string {
             throw new Error(payload.error?.message || "Request failed");
           }
 
-          conversationId = payload.conversationId || conversationId;
+          setConversationId(payload.conversationId || conversationId);
           addMessage("assistant", payload.message?.content || "");
+          await refreshTrace();
         } catch (error) {
           addMessage("error", error instanceof Error ? error.message : String(error), "error");
+          await refreshTrace().catch(() => {});
         } finally {
           send.disabled = false;
           textarea.focus();

package/src/cli/deploy-readiness.ts

@@ -2,13 +2,14 @@ import { findAgentCapsuleRoot, loadAgentCapsule } from "../runtime/config";
 import { loadDeployReadinessContext, type DeployReadinessContext } from "../runtime/deploy-readiness";
 import { loadCapsuleEnv } from "../runtime/env";
 import { isAgentKitError } from "../runtime/errors";
-import { MANAGED_COMPOSIO_ENTITLEMENT } from "../runtime/integrations/composio";
+import { MANAGED_COMPOSIO_API_KEY_SECRET, MANAGED_COMPOSIO_ENTITLEMENT } from "../runtime/integrations/composio";
 import {
   cloudApiRequest,
   formatCloudAuthSource,
   readCloudAuthForApiUrl,
   type CloudCapabilitiesResponse,
   type CloudLimitsResponse,
+  type CloudManagedComposioResponse,
   type CloudMeResponse,
   type CloudProjectResolveResponse,
   type CloudSecretsResponse,
@@ -203,6 +204,58 @@ export async function checkDeployReadiness(options: {
         message: `Could not verify online deploy capacity. ${formatReadinessError(error)}`,
       });
     }
+
+    if (context.integrations.managedComposio.enabled) {
+      try {
+        const payload = (await cloudApiRequest(
+          options.apiUrl,
+          `/v1/me/managed-composio?toolkits=${encodeURIComponent(context.integrations.managedComposio.toolkits.join(","))}`,
+          {
+            method: "GET",
+          },
+        )) as CloudManagedComposioResponse;
+        const managed = payload.managed_composio;
+        const missingToolkits = (managed?.toolkits ?? []).filter((toolkit) => toolkit.auth_config !== "set");
+
+        if (managed?.api_key !== "set") {
+          checks.push({
+            status: "fail",
+            title: "Managed Composio API key",
+            message: `AgentKit Cloud is missing AGENTKIT_SECRET_${MANAGED_COMPOSIO_API_KEY_SECRET}.`,
+            action: "ask the AgentKit Cloud operator to configure managed Composio",
+          });
+        } else {
+          checks.push({
+            status: "pass",
+            title: "Managed Composio API key",
+            message: "AgentKit Cloud has the managed COMPOSIO_API_KEY.",
+          });
+        }
+
+        if (missingToolkits.length > 0) {
+          checks.push({
+            status: "fail",
+            title: "Managed Composio auth configs",
+            message: `Missing ${missingToolkits
+              .map((toolkit) => `${toolkit.auth_config_env ?? "auth config"} for ${toolkit.toolkit ?? "unknown"}`)
+              .join(", ")}.`,
+            action: "ask the AgentKit Cloud operator to configure the missing toolkit auth config",
+          });
+        } else {
+          checks.push({
+            status: "pass",
+            title: "Managed Composio auth configs",
+            message: `Auth configs are available for ${context.integrations.managedComposio.toolkits.join(", ")}.`,
+          });
+        }
+      } catch (error) {
+        checks.push({
+          status: "warn",
+          title: "Managed Composio auth configs",
+          message: `Could not verify managed Composio auth configs. ${formatReadinessError(error)}`,
+        });
+      }
+    }
   }
 
   if (context.agentKitManagedSecrets.length > 0) {

package/src/cli/help.ts

@@ -73,9 +73,9 @@ Usage:
   agentkit db seed [--file <path>]
   agentkit eval run
   agentkit eval from-conversation <conversation-id> [--out <path>] [--force]
-  agentkit conversations list
-  agentkit conversations show <conversation-id>
-  agentkit conversations trace <conversation-id>
+  agentkit conversations list [--deploy]
+  agentkit conversations show <conversation-id> [--deploy]
+  agentkit conversations trace <conversation-id> [--deploy]
   agentkit channels list
   agentkit channels add <website|telegram|whatsapp> <name> [--provider zapster|meta] [--api <url>]
   agentkit channels connect <website|telegram|whatsapp> <name> [--provider zapster|meta] [--api <url>]
@@ -91,7 +91,7 @@ Usage:
   agentkit channels buffers flush [<name>] <conversation-id> [--api <url>]
   agentkit channels buffers clear [<name>] <conversation-id> [--api <url>]
   agentkit channels buffers retry [<name>] <conversation-id> [--api <url>]
-  agentkit integrations status [--api <url>]
+  agentkit integrations status [--toolkit <slug>] [--api <url>]
   agentkit integrations connect composio [--toolkit <slug>] [--callback-url <url>] [--api <url>]
   agentkit skills status
   agentkit skills sync
@@ -182,7 +182,7 @@ export function renderCommandHelp(command: string): string {
     sync: "agentkit sync init [--force] | agentkit sync run [--file <path>]",
     eval: "agentkit eval run | agentkit eval from-conversation <conversation-id> [--out <path>] [--force]",
     conversations:
-      "agentkit conversations list | agentkit conversations show <conversation-id> | agentkit conversations trace <conversation-id>",
+      "agentkit conversations list [--deploy] | agentkit conversations show <conversation-id> [--deploy] | agentkit conversations trace <conversation-id> [--deploy]",
     channels:
       "agentkit channels list | add | connect | setup | status | doctor | test | test-audio | deliveries | buffers",
     skills: "agentkit skills status | agentkit skills sync",
@@ -192,7 +192,7 @@ export function renderCommandHelp(command: string): string {
     secret:
       "agentkit secret set <NAME> --stdin | --from-env [ENV_NAME] | --from-local-env | agentkit secret sync --from-local | list | unset <NAME>",
     access: "agentkit access token create <name> [--out <path>] | list | revoke <token-id>",
-    integrations: "agentkit integrations status | agentkit integrations connect composio [--toolkit <slug>]",
+    integrations: "agentkit integrations status [--toolkit <slug>] | agentkit integrations connect composio [--toolkit <slug>]",
     env: "agentkit env set <NAME> --stdin | --from-env [ENV_NAME] | list | unset <NAME>",
     docs: "agentkit docs path | llms | full",
     handoff: "agentkit handoff codex [goal] | agentkit handoff claude [goal]",

package/src/cli/index.ts

@@ -338,8 +338,15 @@ async function main() {
 
   if (args.command === "conversations") {
     const [subcommand, conversationId] = args.positional;
+    const fromDeploy = args.flags.deploy === true;
 
     if (subcommand === "list") {
+      if (fromDeploy) {
+        const payload = await fetchDeployConversationJson(process.cwd(), "/v1/conversations");
+        printJson(payload);
+        return;
+      }
+
       const conversations = await listConversationsFromCwd(process.cwd());
 
       if (conversations.length === 0) {
@@ -365,7 +372,16 @@ async function main() {
 
     if (subcommand === "show") {
       if (!conversationId) {
-        throw new Error("Missing conversation id. Usage: agentkit conversations show <conversation-id>");
+        throw new Error("Missing conversation id. Usage: agentkit conversations show <conversation-id> [--deploy]");
+      }
+
+      if (fromDeploy) {
+        const payload = await fetchDeployConversationJson(
+          process.cwd(),
+          `/v1/conversations/${encodeURIComponent(conversationId)}`,
+        );
+        printJson(payload);
+        return;
       }
 
       const conversation = await getConversationFromCwd(process.cwd(), conversationId);
@@ -384,7 +400,16 @@ async function main() {
 
     if (subcommand === "trace") {
       if (!conversationId) {
-        throw new Error("Missing conversation id. Usage: agentkit conversations trace <conversation-id>");
+        throw new Error("Missing conversation id. Usage: agentkit conversations trace <conversation-id> [--deploy]");
+      }
+
+      if (fromDeploy) {
+        const trace = await fetchDeployConversationJson(
+          process.cwd(),
+          `/v1/conversations/${encodeURIComponent(conversationId)}/trace`,
+        );
+        printJson(trace);
+        return;
       }
 
       const trace = await getConversationTraceFromCwd(process.cwd(), conversationId);
@@ -392,7 +417,7 @@ async function main() {
       return;
     }
 
-    throw new Error("Usage: agentkit conversations list | agentkit conversations show <conversation-id> | agentkit conversations trace <conversation-id>");
+    throw new Error("Usage: agentkit conversations list [--deploy] | agentkit conversations show <conversation-id> [--deploy] | agentkit conversations trace <conversation-id> [--deploy]");
   }
 
   if (args.command === "knowledge") {
@@ -805,9 +830,16 @@ async function main() {
     const apiUrl = await resolveCloudApiUrl(args.flags.api);
 
     if (subcommand === "status") {
+      const toolkit = parseOptionalStringFlag(
+        args.flags.toolkit,
+        "toolkit",
+        "agentkit integrations status --toolkit <slug>",
+      );
       const payload = await cloudApiRequest(
         apiUrl,
-        `/v1/deploys/${encodeURIComponent(state.deploy_id)}/integrations/composio/status`,
+        `/v1/deploys/${encodeURIComponent(state.deploy_id)}/integrations/composio/status${
+          toolkit ? `?toolkit=${encodeURIComponent(toolkit)}` : ""
+        }`,
         { method: "GET" },
       );
       printJson(payload);
@@ -1180,6 +1212,39 @@ async function runDeploySmoke(input: { deployUrl: string; message: string; token
   }
 }
 
+async function fetchDeployConversationJson(cwd: string, path: string): Promise<unknown> {
+  const state = await requireLocalDeployState();
+  const deployUrl = requireDeployUrl(state);
+  const token = await readDeployAccessTokenForSmoke(cwd, state);
+  const headers = new Headers();
+
+  if (token) {
+    headers.set("Authorization", `Bearer ${token}`);
+  }
+
+  let response: Response;
+
+  try {
+    response = await fetch(new URL(path, deployUrl).href, {
+      method: "GET",
+      headers,
+    });
+  } catch (error) {
+    throw new AgentKitError(
+      "deploy_conversation_request_failed",
+      `Could not read hosted conversation data: ${error instanceof Error ? error.message : String(error)}`,
+    );
+  }
+
+  const payload = await response.json().catch(() => null);
+
+  if (!response.ok) {
+    throw new AgentKitError("deploy_conversation_request_failed", readCloudError(payload, response.status));
+  }
+
+  return payload;
+}
+
 function printJson(value: unknown): void {
   console.log(JSON.stringify(value, null, 2));
 }

package/src/index.ts

@@ -155,6 +155,7 @@ export type ComposioManagedIntegrationInput = {
   toolkits: string[];
   tools?: Record<string, string[]>;
   tags?: IntegrationTagsConfig;
+  confirmExternalWrites?: boolean;
 };
 
 export type ComposioManagedIntegration = {
@@ -165,6 +166,7 @@ export type ComposioManagedIntegration = {
   toolkits: string[];
   tools?: Record<string, string[]>;
   tags?: IntegrationTagsConfig;
+  confirmExternalWrites?: boolean;
 };
 
 export type AgentIntegration = ComposioManagedIntegration;
@@ -368,6 +370,7 @@ export function composioManaged(input: ComposioManagedIntegrationInput): Composi
   const toolkits = normalizeToolkitList(input.toolkits, "composioManaged.toolkits");
   const tools = input.tools ? normalizeComposioToolMap(input.tools, toolkits) : undefined;
   const tags = input.tags ? normalizeIntegrationTags(input.tags) : undefined;
+  const confirmExternalWrites = input.confirmExternalWrites;
 
   return {
     type: "composio",
@@ -377,6 +380,7 @@ export function composioManaged(input: ComposioManagedIntegrationInput): Composi
     toolkits,
     ...(tools ? { tools } : {}),
     ...(tags ? { tags } : {}),
+    ...(confirmExternalWrites === undefined ? {} : { confirmExternalWrites }),
   };
 }
 

package/src/runtime/config.ts

@@ -371,6 +371,10 @@ function validateComposioManagedIntegration(value: AgentIntegration, index: numb
   if (value.tags !== undefined) {
     validateIntegrationTags(value.tags, `integrations[${index}].tags`);
   }
+
+  if (value.confirmExternalWrites !== undefined && typeof value.confirmExternalWrites !== "boolean") {
+    throw invalidConfig(`integrations[${index}].confirmExternalWrites must be a boolean when provided.`);
+  }
 }
 
 function validateIntegrationTags(value: unknown, label: string): void {

package/src/runtime/core/manifest.ts

@@ -40,6 +40,7 @@ export type SharedAgentManifest = {
     toolkits: string[];
     tools: string[];
     userId: string;
+    confirmExternalWrites: boolean;
   }>;
   channels: NonNullable<AgentConfig["channels"]>;
   transcription: {
@@ -174,6 +175,7 @@ export function buildSharedAgentManifest(
       toolkits: integration.toolkits,
       tools: integration.allowedTools,
       userId: integration.userId,
+      confirmExternalWrites: integration.confirmExternalWrites !== false,
     })),
     channels: capsule.config.channels ?? [],
     transcription: {

package/src/runtime/inspect.ts

@@ -203,6 +203,7 @@ export function buildInspectState(
       toolkits: integration.toolkits,
       tools: integration.allowedTools,
       userId: integration.userId,
+      confirmExternalWrites: integration.confirmExternalWrites !== false,
     })),
     channels: (capsule.config.channels ?? []).map((channel) => ({
       name: channel.name,