@nodetool-ai/agents 0.7.0-rc.23 → 0.8.2

package/dist/capabilities/serpapi.js

@@ -0,0 +1,262 @@
+/**
+ * The `serpapi` capability module — every SerpAPI engine as one gated surface,
+ * with the engine list and each engine's parameters discovered rather than
+ * hand-written.
+ *
+ * The point of this module is what it is *not*: it is not a Google node, a
+ * Scholar node, and a Walmart node. SerpAPI publishes one endpoint whose
+ * `engine` parameter selects which of ~120 contracts applies, and wrapping them
+ * one at a time produces a wrapper backlog that never catches up — the same
+ * trade the Apify actor wrappers lost. So NodeTool exposes the primitive — list
+ * the engines, read one engine's contract, run it — and lets an agent compose
+ * the rest. `list_serpapi_engines` and `get_serpapi_engine_schema` read
+ * SerpAPI's own engine table, so an engine SerpAPI ships tomorrow is callable
+ * tomorrow, with no diff here.
+ *
+ * The `web_search` capability stays what it is: one query, normalized results,
+ * whichever SERP provider this install configured. This module is the layer
+ * under it for the questions a plain web search cannot ask.
+ *
+ * What the surface costs, and how it is bounded:
+ *
+ * - **The key stays here.** Guest code calls `serpapi_search`; it never sees
+ *   `SERPAPI_API_KEY`. Every HTTP call happens on the host, and the client
+ *   redacts the key out of errors before they are thrown.
+ * - **`api_key` and `output` are host-owned.** A caller that sets either is
+ *   refused rather than obeyed, so the credential slot cannot be overwritten
+ *   and the response cannot be switched to HTML this layer cannot parse.
+ * - **Parameters are checked before the call.** SerpAPI ignores an unknown
+ *   parameter, so a typo is a billed search that answers a different question.
+ *   Checking against the catalogued contract turns that into a message.
+ */
+import { getSerpApiAccountSpec, getSerpApiEngineSchemaSpec, getSerpApiLocationsSpec, listSerpApiEnginesSpec, serpApiSearchSpec } from "./serpapi.specs.js";
+import { SerpApiClient } from "../serpapi/client.js";
+import { SerpApiError, asSerpApiError } from "../serpapi/errors.js";
+import { loadSerpApiCatalog } from "../serpapi/catalog.js";
+import { DEFAULT_MAX_ITEMS, checkParams, resultKeys, summarizeSearch } from "../serpapi/normalize.js";
+import { isRecord, isString } from "../utils/type-guards.js";
+/** The secret this module reads, and the name the SERP provider layer uses. */
+const SECRET_NAME = "SERPAPI_API_KEY";
+/**
+ * Resolve the key the way every other external module does: the run's secret
+ * store first, the environment second, and a message a user can act on when
+ * neither has it.
+ */
+export async function resolveSerpApiKey(context) {
+    const fromContext = await context.getSecret(SECRET_NAME).catch(() => null);
+    const value = fromContext ?? process.env[SECRET_NAME];
+    if (typeof value === "string" && value.trim().length > 0)
+        return value;
+    throw new SerpApiError("auth", `No SerpAPI key is configured. Add ${SECRET_NAME} in Settings → Secrets ` +
+        "(get one at https://serpapi.com/manage-api-key).");
+}
+/** Build a client for this run, or fail with the reason a user can act on. */
+async function clientFor(context) {
+    return new SerpApiClient(await resolveSerpApiKey(context));
+}
+/** The run-scoped cancellation signal, which every SerpAPI call threads through. */
+function signalOf(run) {
+    return run.context.signal;
+}
+/**
+ * Every capability answers `{ok: false, error, kind}` rather than throwing.
+ *
+ * A model that gets an exception sees a stack it cannot act on; a model that
+ * gets a classified refusal — no key, unknown engine, missing parameter — can
+ * fix the call itself, which is the difference between one wasted turn and a
+ * dead branch.
+ */
+async function guarded(body) {
+    try {
+        return await body();
+    }
+    catch (error) {
+        return asSerpApiError(error).toResult();
+    }
+}
+async function catalogFor(run) {
+    const signal = signalOf(run);
+    return loadSerpApiCatalog(signal === undefined ? {} : { signal });
+}
+/** One engine's contract, or a refusal naming the near-misses. */
+function requireEngine(catalog, engine) {
+    const found = catalog.engines.get(engine);
+    if (found !== undefined)
+        return found;
+    const near = [...catalog.engines.keys()]
+        .filter((id) => id.includes(engine) || engine.includes(id))
+        .slice(0, 10);
+    throw new SerpApiError("unknown_engine", `SerpAPI has no "${engine}" engine.` +
+        (near.length === 0
+            ? " Call list_serpapi_engines to see what it does have."
+            : ` Closest: ${near.join(", ")}.`), { engine });
+}
+function requireString(params, key) {
+    const value = params[key];
+    if (!isString(value) || value.trim().length === 0) {
+        throw new SerpApiError("invalid_input", `"${key}" is required.`);
+    }
+    return value.trim();
+}
+function readInteger(value, fallback) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? Math.floor(parsed) : fallback;
+}
+// ---------------------------------------------------------------------------
+// list_serpapi_engines
+// ---------------------------------------------------------------------------
+const listSerpApiEngines = {
+    spec: listSerpApiEnginesSpec,
+    impl: (run, params) => guarded(async () => {
+        const catalog = await catalogFor(run);
+        const query = isString(params.query) ? params.query.toLowerCase() : "";
+        const limit = Math.min(Math.max(1, readInteger(params.limit, 50)), 200);
+        const matched = [...catalog.engines.values()].filter((engine) => query.length === 0 ||
+            engine.engine.toLowerCase().includes(query) ||
+            engine.label.toLowerCase().includes(query));
+        return {
+            ok: true,
+            total: matched.length,
+            returned: Math.min(matched.length, limit),
+            engines: matched.slice(0, limit).map((engine) => ({
+                engine: engine.engine,
+                name: engine.label,
+                required: engine.parameters
+                    .filter((parameter) => parameter.required)
+                    .map((parameter) => parameter.name),
+                parameter_count: engine.parameters.length,
+                playground_url: engine.playgroundUrl
+            })),
+            note: "Read one engine's parameters with get_serpapi_engine_schema before " +
+                "calling serpapi_search."
+        };
+    })
+};
+// ---------------------------------------------------------------------------
+// get_serpapi_engine_schema
+// ---------------------------------------------------------------------------
+const getSerpApiEngineSchema = {
+    spec: getSerpApiEngineSchemaSpec,
+    impl: (run, params) => guarded(async () => {
+        const catalog = await catalogFor(run);
+        const engine = requireEngine(catalog, requireString(params, "engine"));
+        const includeHidden = params.include_hidden === true;
+        const parameters = engine.parameters
+            .filter((parameter) => includeHidden || !parameter.hidden)
+            .map((parameter) => {
+            const described = {
+                name: parameter.name,
+                label: parameter.label,
+                description: parameter.description,
+                required: parameter.required,
+                group: parameter.group
+            };
+            if (parameter.type !== undefined)
+                described.type = parameter.type;
+            if (parameter.options !== undefined) {
+                described.options = parameter.options.map((option) => option.value);
+            }
+            return described;
+        });
+        return {
+            ok: true,
+            engine: engine.engine,
+            name: engine.label,
+            playground_url: engine.playgroundUrl,
+            required: engine.parameters
+                .filter((parameter) => parameter.required)
+                .map((parameter) => parameter.name),
+            parameters,
+            note: "Pass these under `params` to serpapi_search. `location` values " +
+                "come from get_serpapi_locations."
+        };
+    })
+};
+// ---------------------------------------------------------------------------
+// serpapi_search
+// ---------------------------------------------------------------------------
+const serpApiSearch = {
+    spec: serpApiSearchSpec,
+    impl: (run, params) => guarded(async () => {
+        const engineId = requireString(params, "engine");
+        const raw = isRecord(params.params) ? params.params : {};
+        const catalog = await catalogFor(run);
+        const engine = requireEngine(catalog, engineId);
+        const checked = checkParams(engine, raw);
+        if (checked.errors.length > 0) {
+            return {
+                ok: false,
+                error: `The parameters do not match the ${engine.engine} engine.`,
+                error_kind: "invalid_input",
+                retryable: false,
+                engine: engine.engine,
+                issues: checked.errors
+            };
+        }
+        const client = await clientFor(run.context);
+        const body = await client.search(engine.engine, checked.params, signalOf(run));
+        const fields = Array.isArray(params.fields)
+            ? params.fields.filter(isString)
+            : undefined;
+        // `summarizeSearch` clamps `maxItems` itself, so this only supplies the
+        // default; the ceiling lives next to the trimming it bounds.
+        const trim = {
+            maxItems: readInteger(params.max_items, DEFAULT_MAX_ITEMS)
+        };
+        if (fields !== undefined && fields.length > 0)
+            trim.fields = fields;
+        const summary = summarizeSearch(body, trim);
+        return {
+            ok: true,
+            engine: engine.engine,
+            available_keys: resultKeys(body),
+            ...summary
+        };
+    })
+};
+// ---------------------------------------------------------------------------
+// get_serpapi_account
+// ---------------------------------------------------------------------------
+const getSerpApiAccount = {
+    spec: getSerpApiAccountSpec,
+    impl: (run) => guarded(async () => {
+        const client = await clientFor(run.context);
+        const account = await client.account(signalOf(run));
+        return { ok: true, ...account };
+    })
+};
+// ---------------------------------------------------------------------------
+// get_serpapi_locations
+// ---------------------------------------------------------------------------
+const getSerpApiLocations = {
+    spec: getSerpApiLocationsSpec,
+    impl: (run, params) => guarded(async () => {
+        const client = await clientFor(run.context);
+        const limit = Math.min(Math.max(1, readInteger(params.limit, 10)), 50);
+        const locations = await client.locations(requireString(params, "query"), limit, signalOf(run));
+        return {
+            ok: true,
+            locations: locations.map((location) => ({
+                name: location.name,
+                // The value the `location` parameter wants — not `name`, which is
+                // ambiguous across the several Austins SerpAPI knows about.
+                location: location.canonicalName,
+                country_code: location.countryCode,
+                target_type: location.targetType,
+                reach: location.reach
+            }))
+        };
+    })
+};
+export const SERPAPI_CAPABILITIES = [
+    listSerpApiEngines,
+    getSerpApiEngineSchema,
+    serpApiSearch,
+    getSerpApiAccount,
+    getSerpApiLocations
+];
+export const module = {
+    module: "serpapi",
+    exports: SERPAPI_CAPABILITIES
+};
+//# sourceMappingURL=serpapi.js.map

package/dist/capabilities/serpapi.js.map

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

package/dist/capabilities/serpapi.specs.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The `serpapi` module's specs — data only, no implementation.
+ *
+ * Split out for the reason every module splits: the registry's eager spec table
+ * imports this file and never `serpapi.ts`, so the client and the catalog
+ * parser stay out of the entry graph until something calls them.
+ *
+ * The descriptions carry the discovery order, because that is the whole design:
+ * SerpAPI is one endpoint with ~120 engine contracts behind it, so the model is
+ * told to list, read the schema, then search — not to guess parameter names for
+ * an engine it has never seen. A guessed parameter is not an error on SerpAPI's
+ * side; it is a billed search that answers the wrong question.
+ */
+import type { JsonSchema } from "@nodetool-ai/runtime";
+import type { CapabilitySpec } from "./types.js";
+export declare const LIST_SERPAPI_ENGINES_SCHEMA: JsonSchema;
+export declare const listSerpApiEnginesSpec: CapabilitySpec;
+export declare const getSerpApiEngineSchemaSpec: CapabilitySpec;
+export declare const SERPAPI_SEARCH_SCHEMA: JsonSchema;
+export declare const serpApiSearchSpec: CapabilitySpec;
+export declare const getSerpApiAccountSpec: CapabilitySpec;
+export declare const getSerpApiLocationsSpec: CapabilitySpec;
+export declare const serpApiSpecs: readonly CapabilitySpec[];
+//# sourceMappingURL=serpapi.specs.d.ts.map

package/dist/capabilities/serpapi.specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serpapi.specs.d.ts","sourceRoot":"","sources":["../../src/capabilities/serpapi.specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAUjD,eAAO,MAAM,2BAA2B,EAAE,UAgBzC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,cAmBpC,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,cA0BxC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,UAgCnC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cA0B/B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,cASnC,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,cA0BrC,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,SAAS,cAAc,EAMjD,CAAC"}

package/dist/capabilities/serpapi.specs.js

@@ -0,0 +1,174 @@
+/**
+ * The `serpapi` module's specs — data only, no implementation.
+ *
+ * Split out for the reason every module splits: the registry's eager spec table
+ * imports this file and never `serpapi.ts`, so the client and the catalog
+ * parser stay out of the entry graph until something calls them.
+ *
+ * The descriptions carry the discovery order, because that is the whole design:
+ * SerpAPI is one endpoint with ~120 engine contracts behind it, so the model is
+ * told to list, read the schema, then search — not to guess parameter names for
+ * an engine it has never seen. A guessed parameter is not an error on SerpAPI's
+ * side; it is a billed search that answers the wrong question.
+ */
+const ENGINE_FIELD = {
+    type: "string",
+    description: 'SerpAPI engine id, e.g. "google", "google_scholar", "youtube", ' +
+        '"amazon", "google_maps". Find one with list_serpapi_engines rather than ' +
+        "guessing — an id SerpAPI does not ship fails the call."
+};
+export const LIST_SERPAPI_ENGINES_SCHEMA = {
+    type: "object",
+    properties: {
+        query: {
+            type: "string",
+            description: 'Filter engines by id or name, e.g. "scholar", "maps", "shopping". ' +
+                "Omit to list every engine this SerpAPI account can call."
+        },
+        limit: {
+            type: "integer",
+            description: "How many engines to return.",
+            default: 50,
+            maximum: 200
+        }
+    }
+};
+export const listSerpApiEnginesSpec = {
+    name: "list_serpapi_engines",
+    description: "List the search engines SerpAPI exposes — Google and its verticals " +
+        "(news, images, scholar, maps, jobs, flights, hotels, trends, lens, " +
+        "shopping), Bing, Baidu, DuckDuckGo, Yandex, Naver, YouTube, Amazon, " +
+        "eBay, Walmart, Home Depot, Yelp, TripAdvisor, the app stores, and more. " +
+        "The list is read from SerpAPI itself, so it is whatever SerpAPI ships " +
+        "today, not a hard-coded set. Each entry names the engine id and its " +
+        "required parameters. Start here, then read one engine's full contract " +
+        "with get_serpapi_engine_schema before calling serpapi_search.",
+    inputSchema: LIST_SERPAPI_ENGINES_SCHEMA,
+    category: "read",
+    userMessage: (params) => {
+        const query = params.query;
+        return typeof query === "string" && query.length > 0
+            ? `Listing SerpAPI engines matching '${query}'`
+            : "Listing SerpAPI engines";
+    }
+};
+export const getSerpApiEngineSchemaSpec = {
+    name: "get_serpapi_engine_schema",
+    description: "Read one engine's full parameter contract — every parameter, its " +
+        "meaning, whether it is required, its type, and its allowed values — " +
+        "read from SerpAPI's own machine-readable engine table. Call this before " +
+        "searching any engine whose parameters you do not already know: a wrong " +
+        "parameter name is not rejected by SerpAPI, it is ignored, and the search " +
+        "is billed for results that answer a different question.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            engine: ENGINE_FIELD,
+            include_hidden: {
+                type: "boolean",
+                description: "Include parameters SerpAPI does not show in its playground. They " +
+                    "are still accepted by the API.",
+                default: false
+            }
+        },
+        required: ["engine"]
+    },
+    category: "read",
+    userMessage: (params) => `Reading the SerpAPI schema for ${String(params.engine ?? "an engine")}`
+};
+export const SERPAPI_SEARCH_SCHEMA = {
+    type: "object",
+    properties: {
+        engine: ENGINE_FIELD,
+        params: {
+            type: "object",
+            description: "The engine's own parameters, spelled as its schema spells them — " +
+                '`{"q": "…"}` for most, but `google_scholar_author` wants ' +
+                "`author_id`, `google_maps` wants `ll`, and so on. Checked against " +
+                "the engine's contract before the call, so an unknown or missing " +
+                "parameter comes back as a message instead of a billed search.",
+            additionalProperties: true
+        },
+        fields: {
+            type: "array",
+            items: { type: "string" },
+            description: 'Return only these top-level result keys, e.g. ["organic_results"]. ' +
+                "Everything else is named in `omitted` rather than sent. Omit to get " +
+                "every key the engine returned."
+        },
+        max_items: {
+            type: "integer",
+            description: "Cap the entries returned per result array. The count cut is " +
+                "reported per key.",
+            default: 10,
+            maximum: 100
+        }
+    },
+    required: ["engine", "params"]
+};
+export const serpApiSearchSpec = {
+    name: "serpapi_search",
+    description: "Run one search on any SerpAPI engine and get its structured results. " +
+        "This is the general surface: anything SerpAPI can answer — a Google " +
+        "results page, a scholar citation, a maps listing, a product page, a " +
+        "video, a job posting, a flight — is this call with a different `engine` " +
+        "and parameters. Use web_search for a plain web query; use this when the " +
+        "answer needs a specific engine, a vertical, or fields a plain search " +
+        "does not return. Each call spends one search from the account's quota " +
+        "(see get_serpapi_account).",
+    inputSchema: SERPAPI_SEARCH_SCHEMA,
+    category: "read",
+    userMessage: (params) => {
+        const engine = String(params.engine ?? "serpapi");
+        const bag = params.params;
+        const query = typeof bag === "object" && bag !== null && "q" in bag
+            ? String(bag.q)
+            : undefined;
+        const message = query === undefined
+            ? `Searching ${engine}`
+            : `Searching ${engine} for '${query}'`;
+        return message.length > 80 ? `Searching ${engine}` : message;
+    }
+};
+export const getSerpApiAccountSpec = {
+    name: "get_serpapi_account",
+    description: "Read the SerpAPI account's plan and how many searches are left this " +
+        "month. Use it before a batch of searches, so a plan that is nearly " +
+        "spent is a decision rather than a surprise mid-run.",
+    inputSchema: { type: "object", properties: {} },
+    category: "read",
+    userMessage: () => "Reading the SerpAPI account"
+};
+export const getSerpApiLocationsSpec = {
+    name: "get_serpapi_locations",
+    description: "Resolve a place name to the canonical values SerpAPI's `location` " +
+        "parameter accepts. A guessed location string does not fail — it returns " +
+        "results for somewhere else — so look it up before setting `location` on " +
+        "any engine whose schema has one.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: 'Place name to resolve, e.g. "Austin" or "Bavaria".'
+            },
+            limit: {
+                type: "integer",
+                description: "How many matches to return.",
+                default: 10,
+                maximum: 50
+            }
+        },
+        required: ["query"]
+    },
+    category: "read",
+    userMessage: (params) => `Resolving SerpAPI locations for '${String(params.query ?? "")}'`
+};
+export const serpApiSpecs = [
+    listSerpApiEnginesSpec,
+    getSerpApiEngineSchemaSpec,
+    serpApiSearchSpec,
+    getSerpApiAccountSpec,
+    getSerpApiLocationsSpec
+];
+//# sourceMappingURL=serpapi.specs.js.map

package/dist/capabilities/serpapi.specs.js.map

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

package/dist/capabilities/settings.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The `settings` capability module — NodeTool's own configuration, reachable
+ * from sandboxed code as `@nodetool-ai/sandbox-nodetool/settings`.
+ *
+ * The catalog it reads is `@nodetool-ai/config`'s `settingCatalog()`, the same
+ * table the tRPC settings router answers `settings.list` from. That shared
+ * table is what makes the secret/non-secret split trustworthy here: a
+ * capability that decided whether `OPENAI_API_KEY` holds a credential by
+ * looking at the name would eventually be wrong, and being wrong once means a
+ * key in a model's context.
+ *
+ * ## Secrets are asked for, never set
+ *
+ * `set_setting` refuses a secret and there is no `set_secret`. The only path
+ * from guest code to a stored credential is {@link requestSecret}, which takes
+ * a *name and a reason* and no value: it opens a dialog in the user's client,
+ * they type the key there, and the client saves it over its own authenticated
+ * tRPC call. The value never enters the guest, the model's context, the chat
+ * transcript, or this process.
+ *
+ * The dialog is a host capability, not a fallback. A run that carries no
+ * `CapabilityRun.secretPrompt` — every headless run: a workflow on the
+ * kernel, the CLI, an eval — is refused by name rather than quietly writing
+ * something the user never saw.
+ *
+ * Reading a secret is unchanged and lives elsewhere: `nodetool.secrets.get`,
+ * bound by the run's declared `secretScope` at the sandbox bridge.
+ */
+import type { CapabilityExport, CapabilityModule } from "./types.js";
+/** One setting as the guest sees it. A secret never reaches this shape. */
+export interface SettingView {
+    key: string;
+    group: string;
+    description: string;
+    allowed_values: string[] | null;
+    value: string | null;
+    source: "user" | "env" | "unset";
+}
+/** One credential as the guest sees it: whether it exists, never what it is. */
+export interface SecretView {
+    key: string;
+    group: string;
+    description: string;
+    configured: boolean;
+}
+export declare const SETTINGS_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+//# sourceMappingURL=settings.d.ts.map

package/dist/capabilities/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/capabilities/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AASH,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAUpB,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;CAClC;AAED,gFAAgF;AAChF,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB;AA0OD,eAAO,MAAM,qBAAqB,EAAE,SAAS,gBAAgB,EAM5D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC"}