code-mode

Code mode

execute runs one JavaScript program over every app you can reach. App tools are async functions under tools. One program can call several tools, combine their results and return a small value, so large results never pass through your context.

The interpreter has no imports, fetch, process or filesystem, no timers (setTimeout, setInterval, queueMicrotask), and no btoa, atob, TextEncoder, TextDecoder or globalThis. A tool call is its only way out. Use await and Promise.all for independent calls. As in JavaScript, code between two awaits runs without interruption, so concurrent async functions can update shared variables. console.log output comes back in logs. Write JavaScript; TypeScript syntax is not portable across Executor hosts.

Find tools and read signatures

return await tools.search({ query: "send email", namespace: "gmail", limit: 5 });

tools.search({ query?, namespace?, limit?, offset? }) returns one page of ranked matches. Each item in items has the exact callable path, the first line of its description and its input type on one line. A longer input type is cut and marked inputTruncated: true. namespaces lists each app and titled router on the page once, with the app's linked account labels, instead of repeating them in every item.

namespace is an app slug, such as gmail, or a namespace inside it. Without it, search loads and searches every app, which is slower. A page holds at most limit items, 10 by default, and stops sooner at about 25 KB of JSON. remaining counts the matches after the page, and next is the input for the following page, or null after the last match: call tools.search(next) to continue.

Search leaves out output types and later description lines. For full detail, pass up to 20 exact paths from search:

return await tools.search.describe({ paths: ["<path from search>"] });

describe returns items with the whole description and the TypeScript signature, with input and output types, plus their namespaces. A path that names no tool comes back in missing with the closest matches.