@botpress/adk-cli 1.19.0-beta.3 → 1.19.0-beta.4

package/dist/agent0-assets/skills/adk-debugger/references/traces-and-logs.md

@@ -4,15 +4,16 @@ Traces and logs are the primary debugging interface for ADK agents. Every conver
 
 ## CLI Debugging Tools
 
-All commands support `--format json` for structured output. **Always use `--format json`** when consuming output programmatically.
+Most commands support `--format json` for structured output — **always use it** when consuming output programmatically. The exception is `adk dev`, which has no `--format` flag: use `adk dev --non-interactive` to get a structured NDJSON event stream instead.
 
-| Command | Purpose | Additional Flags |
+| Command | Purpose | Options / tokens |
 |---------|---------|-----------------|
 | `adk check --format json` | Offline project validation — catches config/schema issues before runtime | — |
 | `adk logs --format json` | Browse or stream log entries | `--follow`, `--summary`, level filters (`error`, `warning`) |
-| `adk traces --format json` | Query conversation traces with span details | `--conversation-id` |
+| `adk traces --format json` | Query traces with span details — filter by workflow, action, trigger, conversation, error, time | `workflow=`, `action=`, `trigger=`, `conversation=`, `trace=`, `error`, `since=`, `until=`, `limit=`, `--follow`, `--include-llm` |
+| `adk workflows runs --format json` | List or inspect durable workflow runs by id, name, or status | `name=`, `status=`, `limit=`, `nextToken=`, `<wrkflow_id>` |
 | `adk chat --single "msg" --format json` | Send a test message and get structured response | `--conversation-id` |
-| `adk dev --non-interactive --format json` | Start dev server with structured NDJSON event stream (no TUI) | — |
+| `adk dev --non-interactive` | Start dev server with structured NDJSON event stream (no TUI) | — |
 
 ## Querying Logs
 
@@ -35,13 +36,20 @@ adk logs --summary --format json                # single snapshot summary
 
 ## Querying Traces
 
-Traces provide the full picture of a conversation turn: every span in order.
+Traces provide the full picture of a conversation turn: every span in order. The command takes positional filter tokens (not flags) for slicing the trace store.
 
 ```bash
-adk traces --format json                                    # recent traces
-adk traces --conversation-id <id> --format json             # traces for a specific conversation
+adk traces --format json                                    # recent traces (default limit 20)
+adk traces error --format json                              # error traces only
+adk traces workflow=<name> --format json                    # traces for a workflow
+adk traces conversation=<id> --format json                  # traces for a conversation
+adk traces trace=<id> --include-llm --format json           # drill into one trace with LLM content
+adk traces since=1h limit=50 --format json                  # last hour, up to 50
+adk traces error --follow --format json                     # stream errors live (NDJSON)
 ```
 
+Combine tokens freely (`adk traces error workflow=onboarding since=1h`). `--format` only accepts `json`; omit it for the default text output.
+
 ### Trace Structure
 
 A trace represents one unit of agent activity. Each trace contains:

package/dist/cli.js

@@ -36942,7 +36942,7 @@ var require_jsx_dev_runtime = __commonJS((exports, module) => {
 });
 
 // src/utils/build-constants.ts
-var CLI_VERSION = "1.19.0-beta.3", EXPECTED_RUNTIME_VERSION = "1.19.0-beta.3", MIN_SUPPORTED_RUNTIME = "1.17.0", IS_RELEASE_BUILD = false;
+var CLI_VERSION = "1.19.0-beta.4", EXPECTED_RUNTIME_VERSION = "1.19.0-beta.4", MIN_SUPPORTED_RUNTIME = "1.17.0", IS_RELEASE_BUILD = false;
 
 // ../../node_modules/.bun/browser-or-node@2.1.1/node_modules/browser-or-node/lib/index.js
 var require_lib = __commonJS((exports) => {
@@ -364769,7 +364769,7 @@ var init_internal = __esm(() => {
   });
   init_define_PACKAGE_VERSIONS = __esm2({
     "<define:__PACKAGE_VERSIONS__>"() {
-      define_PACKAGE_VERSIONS_default = { runtime: "1.19.0-beta.3", adk: "not-installed", sdk: "6.11.1", llmz: "0.0.78", zai: "2.6.21", cognitive: "0.5.4" };
+      define_PACKAGE_VERSIONS_default = { runtime: "1.19.0-beta.4", adk: "not-installed", sdk: "6.11.1", llmz: "0.0.78", zai: "2.6.21", cognitive: "0.5.4" };
     }
   });
   init_eval = __esm2({
@@ -671415,7 +671415,7 @@ var init_library2 = __esm(() => {
   });
   init_define_PACKAGE_VERSIONS2 = __esm3({
     "<define:__PACKAGE_VERSIONS__>"() {
-      define_PACKAGE_VERSIONS_default2 = { runtime: "1.19.0-beta.3", adk: "not-installed", sdk: "6.11.1", llmz: "0.0.78", zai: "2.6.21", cognitive: "0.5.4" };
+      define_PACKAGE_VERSIONS_default2 = { runtime: "1.19.0-beta.4", adk: "not-installed", sdk: "6.11.1", llmz: "0.0.78", zai: "2.6.21", cognitive: "0.5.4" };
     }
   });
   init_assets2 = __esm3({
@@ -766139,7 +766139,7 @@ var init_definition3 = __esm(() => {
   });
   init_define_PACKAGE_VERSIONS3 = __esm5({
     "<define:__PACKAGE_VERSIONS__>"() {
-      define_PACKAGE_VERSIONS_default3 = { runtime: "1.19.0-beta.3", adk: "not-installed", sdk: "6.11.1", llmz: "0.0.78", zai: "2.6.21", cognitive: "0.5.4" };
+      define_PACKAGE_VERSIONS_default3 = { runtime: "1.19.0-beta.4", adk: "not-installed", sdk: "6.11.1", llmz: "0.0.78", zai: "2.6.21", cognitive: "0.5.4" };
     }
   });
   init_transcript3 = __esm5({
@@ -836754,7 +836754,7 @@ var init_runtime6 = __esm(() => {
   });
   init_define_PACKAGE_VERSIONS4 = __esm6({
     "<define:__PACKAGE_VERSIONS__>"() {
-      define_PACKAGE_VERSIONS_default4 = { runtime: "1.19.0-beta.3", adk: "not-installed", sdk: "6.11.1", llmz: "0.0.78", zai: "2.6.21", cognitive: "0.5.4" };
+      define_PACKAGE_VERSIONS_default4 = { runtime: "1.19.0-beta.4", adk: "not-installed", sdk: "6.11.1", llmz: "0.0.78", zai: "2.6.21", cognitive: "0.5.4" };
     }
   });
   init_globals4 = __esm6({
@@ -903591,7 +903591,7 @@ ${names || "  (none found)"}`);
   async copyTemplateFiles(templateDir) {
     const substitutions = {
       "{{projectName}}": this.projectName,
-      "{{runtimeVersion}}": "1.19.0-beta.3",
+      "{{runtimeVersion}}": "1.19.0-beta.4",
       "{{packageManager}}": this.packageManager
     };
     await this.copyDirRecursive(templateDir, this.projectPath, substitutions);
@@ -909247,7 +909247,7 @@ var semver2, import_ts_morph, import_debug, semver22, import_ts_morph2, import_t
 `));
     return code;
   }
-}, ADK_VERSION = "1.19.0-beta.3", relative4 = (from, to6) => {
+}, ADK_VERSION = "1.19.0-beta.4", relative4 = (from, to6) => {
   const fromDir = path142.dirname(from);
   const relative22 = path142.relative(fromDir, to6);
   return relative22.startsWith(".") ? relative22 : `./${relative22}`;
@@ -921693,7 +921693,7 @@ caused by: ` + e7.fullStack(i7);
   require_package3 = __commonJS9((exports7, module) => {
     module.exports = {
       name: "@botpress/adk",
-      version: "1.19.0-beta.3",
+      version: "1.19.0-beta.4",
       description: "Core ADK library for building AI agents on Botpress",
       keywords: [
         "adk",
@@ -921750,7 +921750,7 @@ caused by: ` + e7.fullStack(i7);
         "@botpress/cli": "~6.8.1",
         "@botpress/client": "~1.46.0",
         "@botpress/cognitive": "~0.5.4",
-        "@botpress/runtime": "^1.19.0-beta.3",
+        "@botpress/runtime": "^1.19.0-beta.4",
         "@botpress/sdk": "~6.11.1",
         "@bpinternal/jex": "^1.2.4",
         "@bpinternal/yargs-extra": "^0.0.21",
@@ -937007,7 +937007,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@botpress/adk-cli",
-    version: "1.19.0-beta.3",
+    version: "1.19.0-beta.4",
     description: "Command-line interface for the Botpress Agent Development Kit (ADK)",
     keywords: [
       "adk",
@@ -937049,12 +937049,12 @@ var init_package = __esm(() => {
       "check:type": "bun scripts/generate-build-constants.ts >/dev/null && bun scripts/embed-assets.ts >/dev/null && tsc --noEmit"
     },
     dependencies: {
-      "@botpress/adk": "^1.19.0-beta.3",
+      "@botpress/adk": "^1.19.0-beta.4",
       "@botpress/chat": "~0.5.5",
       "@botpress/cli": "~6.8.1",
       "@botpress/client": "~1.46.0",
-      "@botpress/evals": "^1.19.0-beta.3",
-      "@botpress/runtime": "^1.19.0-beta.3",
+      "@botpress/evals": "^1.19.0-beta.4",
+      "@botpress/runtime": "^1.19.0-beta.4",
       "@botpress/sdk": "~6.11.1",
       "@botpress/webchat-client": "^0.7.2",
       "@modelcontextprotocol/sdk": "^1.25.1",
@@ -955742,11 +955742,23 @@ function countModelsByProvider(models2) {
   }
   return counts;
 }
-function buildAgent0OpenCodePermissionConfig() {
-  return Object.fromEntries(Object.entries(AGENT0_OPEN_CODE_PERMISSION_POLICY).map(([key, value2]) => [
-    key,
-    typeof value2 === "string" ? value2 : { ...value2 }
-  ]));
+function buildAgent0OpenCodePermissionConfig(options = {}) {
+  return {
+    ...Object.fromEntries(Object.entries(AGENT0_OPEN_CODE_PERMISSION_POLICY).map(([key, value2]) => [
+      key,
+      typeof value2 === "string" ? value2 : { ...value2 }
+    ])),
+    external_directory: buildAgent0ExternalDirectoryPermission(options.externalSkillPaths ?? [])
+  };
+}
+function buildAgent0ExternalDirectoryPermission(skillPaths) {
+  return Object.fromEntries([
+    ["*", "deny"],
+    ...skillPaths.map(toRecursivePathPattern).toSorted().map((pattern) => [pattern, "allow"])
+  ]);
+}
+function toRecursivePathPattern(path54) {
+  return `${path54.replace(/[\\/]+$/, "")}/**`;
 }
 function getAgent0ProjectDiscoveryGitShimFilename(targetPlatform = platform5()) {
   return targetPlatform === "win32" ? "git.cmd" : "git";
@@ -955792,7 +955804,7 @@ function buildAgent0OpenCodeConfig(options) {
     ...options.agent0Config || options.cognitiveModels !== undefined ? { enabled_providers: enabledProviders } : {},
     ...Object.keys(provider5).length ? { provider: provider5 } : {},
     mcp: builtIns.mcp,
-    permission: buildAgent0OpenCodePermissionConfig(),
+    permission: buildAgent0OpenCodePermissionConfig({ externalSkillPaths: builtIns.skills.paths }),
     default_agent: builtIns.defaultAgent,
     agent: builtIns.agent,
     ...Object.keys(builtIns.command).length ? { command: builtIns.command } : {},
@@ -957904,7 +957916,6 @@ var init_agent0 = __esm(() => {
       [AGENT0_HIDDEN_OPENCODE_SKILL]: "deny"
     },
     lsp: "allow",
-    external_directory: "deny",
     repo_clone: "deny",
     repo_overview: "allow",
     [AGENT0_BUILT_IN_MCP_PERMISSION]: "allow"

package/dist/commands.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.19.0-beta.3",
-  "generatedAt": "2026-05-28T20:26:30.899Z",
+  "version": "1.19.0-beta.4",
+  "generatedAt": "2026-05-28T21:29:27.978Z",
   "cliName": "adk",
   "globalOptions": [
     {

package/dist/{index-gqxgqnyz.html → index-3t354nbw.html}

@@ -15,8 +15,8 @@
         }
       }
     </script>
-    <script type="module" crossorigin src="/assets/index-CSTz-oTK.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-DAztRXeA.css">
+    <script type="module" crossorigin src="/assets/index-B3b7PPgV.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DIFGtVmI.css">
   </head>
   <body>
     <div id="root"></div>