@nodetool-ai/agents 0.7.0-rc.22 → 0.8.1

package/dist/capabilities/google.specs.js

@@ -0,0 +1,391 @@
+/**
+ * The `google` module's specs — data only, no implementation.
+ *
+ * Split out so a belt can be assembled synchronously: the registry's eager
+ * spec table imports this file, never `google.ts`, so nothing the
+ * implementations pull in reaches the entry graph. `google.ts` imports these
+ * back and attaches each to its implementation, so there is one spec object
+ * behind both halves.
+ */
+import { isString } from "../utils/type-guards.js";
+export const str = (params, key) => {
+    const value = params[key];
+    return isString(value) ? value.trim() : "";
+};
+export const DRIVE_SEARCH_SCHEMA = {
+    type: "object",
+    properties: {
+        query: { type: "string", description: "Search phrase or Drive query" },
+        max_results: {
+            type: "integer",
+            description: "Maximum files to return (1-100)",
+            default: 20
+        }
+    },
+    required: ["query"]
+};
+export const DRIVE_FILE_ID_SCHEMA = {
+    type: "object",
+    properties: {
+        file_id: { type: "string", description: "Drive file id" }
+    },
+    required: ["file_id"]
+};
+export const DRIVE_CREATE_SCHEMA = {
+    type: "object",
+    properties: {
+        name: { type: "string", description: "File name" },
+        content: { type: "string", description: "File contents" },
+        mime_type: {
+            type: "string",
+            description: "MIME type (default text/plain)"
+        },
+        folder_id: {
+            type: "string",
+            description: "Parent folder id (default: My Drive root)"
+        }
+    },
+    required: ["name", "content"]
+};
+export const GMAIL_SEARCH_SCHEMA = {
+    type: "object",
+    properties: {
+        query: { type: "string", description: "Gmail search query" },
+        max_results: {
+            type: "integer",
+            description: "Maximum messages to return (1-50)",
+            default: 10
+        }
+    },
+    required: ["query"]
+};
+export const GMAIL_MESSAGE_ID_SCHEMA = {
+    type: "object",
+    properties: {
+        message_id: { type: "string", description: "Gmail message id" }
+    },
+    required: ["message_id"]
+};
+export const GMAIL_SEND_SCHEMA = {
+    type: "object",
+    properties: {
+        to: {
+            type: "string",
+            description: "Recipient address(es), comma-separated"
+        },
+        subject: { type: "string", description: "Subject line" },
+        body: { type: "string", description: "Plain-text body" },
+        cc: { type: "string", description: "Cc address(es), comma-separated" },
+        bcc: { type: "string", description: "Bcc address(es), comma-separated" }
+    },
+    required: ["to", "subject", "body"]
+};
+export const GMAIL_MODIFY_LABELS_SCHEMA = {
+    type: "object",
+    properties: {
+        message_id: { type: "string", description: "Gmail message id" },
+        add_label_ids: {
+            type: "array",
+            items: { type: "string" },
+            description: "Label ids to add"
+        },
+        remove_label_ids: {
+            type: "array",
+            items: { type: "string" },
+            description: "Label ids to remove"
+        }
+    },
+    required: ["message_id"]
+};
+export const DOCS_READ_SCHEMA = {
+    type: "object",
+    properties: {
+        document_id: { type: "string", description: "Google Docs document id" }
+    },
+    required: ["document_id"]
+};
+export const DOCS_CREATE_SCHEMA = {
+    type: "object",
+    properties: {
+        title: { type: "string", description: "Document title" },
+        text: { type: "string", description: "Initial body text" }
+    },
+    required: ["title"]
+};
+export const DOCS_APPEND_SCHEMA = {
+    type: "object",
+    properties: {
+        document_id: { type: "string", description: "Google Docs document id" },
+        text: { type: "string", description: "Text to append" }
+    },
+    required: ["document_id", "text"]
+};
+export const SHEETS_READ_SCHEMA = {
+    type: "object",
+    properties: {
+        spreadsheet_id: { type: "string", description: "Spreadsheet id" },
+        range: { type: "string", description: "A1 range, e.g. Sheet1!A1:D50" }
+    },
+    required: ["spreadsheet_id", "range"]
+};
+export const SHEETS_APPEND_SCHEMA = {
+    type: "object",
+    properties: {
+        spreadsheet_id: { type: "string", description: "Spreadsheet id" },
+        range: {
+            type: "string",
+            description: "A1 range identifying the table, e.g. Sheet1!A:D"
+        },
+        values: {
+            type: "array",
+            items: { type: "array", items: {} },
+            description: "Rows to append, each an array of cell values"
+        }
+    },
+    required: ["spreadsheet_id", "range", "values"]
+};
+export const SHEETS_UPDATE_SCHEMA = {
+    type: "object",
+    properties: {
+        spreadsheet_id: { type: "string", description: "Spreadsheet id" },
+        range: { type: "string", description: "A1 range to overwrite" },
+        values: {
+            type: "array",
+            items: { type: "array", items: {} },
+            description: "Rows of cell values"
+        }
+    },
+    required: ["spreadsheet_id", "range", "values"]
+};
+export const SHEETS_CREATE_SCHEMA = {
+    type: "object",
+    properties: {
+        title: { type: "string", description: "Spreadsheet title" },
+        values: {
+            type: "array",
+            items: { type: "array", items: {} },
+            description: "Initial rows, written starting at A1"
+        }
+    },
+    required: ["title"]
+};
+export const CALENDAR_LIST_EVENTS_SCHEMA = {
+    type: "object",
+    properties: {
+        calendar_id: {
+            type: "string",
+            description: "Calendar id (default: primary)"
+        },
+        time_min: { type: "string", description: "RFC3339 window start" },
+        time_max: { type: "string", description: "RFC3339 window end" },
+        query: { type: "string", description: "Free-text event filter" },
+        max_results: {
+            type: "integer",
+            description: "Maximum events to return (1-250)",
+            default: 20
+        }
+    }
+};
+export const CALENDAR_CREATE_EVENT_SCHEMA = {
+    type: "object",
+    properties: {
+        summary: { type: "string", description: "Event title" },
+        start: { type: "string", description: "RFC3339 start time" },
+        end: { type: "string", description: "RFC3339 end time" },
+        calendar_id: {
+            type: "string",
+            description: "Calendar id (default: primary)"
+        },
+        description: { type: "string", description: "Event description" },
+        location: { type: "string", description: "Event location" },
+        attendees: {
+            type: "array",
+            items: { type: "string" },
+            description: "Attendee email addresses"
+        }
+    },
+    required: ["summary", "start", "end"]
+};
+export const CALENDAR_DELETE_EVENT_SCHEMA = {
+    type: "object",
+    properties: {
+        event_id: { type: "string", description: "Event id" },
+        calendar_id: {
+            type: "string",
+            description: "Calendar id (default: primary)"
+        }
+    },
+    required: ["event_id"]
+};
+export const driveSearchSpec = {
+    name: "google_drive_search",
+    description: "Search the user's Google Drive. Accepts a plain phrase (full-text " +
+        "search) or Drive query syntax such as \"mimeType = 'application/vnd.google-apps.spreadsheet'\".",
+    inputSchema: DRIVE_SEARCH_SCHEMA,
+    category: "external",
+    userMessage: (params) => `Searching Drive for "${str(params, "query")}"`
+};
+export const driveReadFileCapabilitySpec = {
+    name: "google_drive_read_file",
+    description: "Read a Google Drive file as text. Google Docs, Sheets and Slides are " +
+        "exported to plain text/CSV; other files are downloaded as-is.",
+    inputSchema: DRIVE_FILE_ID_SCHEMA,
+    category: "external",
+    userMessage: () => "Reading a Drive file"
+};
+export const driveGetFileCapabilitySpec = {
+    name: "google_drive_get_file",
+    description: "Get metadata (name, mime type, size, owners, link) for a Drive file.",
+    inputSchema: DRIVE_FILE_ID_SCHEMA,
+    category: "external",
+    userMessage: () => "Fetching Drive file details"
+};
+export const driveCreateFileCapabilitySpec = {
+    name: "google_drive_create_file",
+    description: "Create a text file in the user's Google Drive.",
+    inputSchema: DRIVE_CREATE_SCHEMA,
+    category: "external",
+    userMessage: (params) => `Creating "${str(params, "name")}" in Drive`
+};
+export const gmailSearchSpec = {
+    name: "gmail_search",
+    description: "Search the user's Gmail with Gmail query syntax (e.g. " +
+        "'from:alice@example.com is:unread newer_than:7d'). Returns parsed " +
+        "messages with subject, sender, date and body.",
+    inputSchema: GMAIL_SEARCH_SCHEMA,
+    category: "external",
+    userMessage: (params) => `Searching Gmail for "${str(params, "query")}"`
+};
+export const gmailGetMessageCapabilitySpec = {
+    name: "gmail_get_message",
+    description: "Fetch one Gmail message by id, fully parsed.",
+    inputSchema: GMAIL_MESSAGE_ID_SCHEMA,
+    category: "external",
+    userMessage: () => "Reading an email"
+};
+export const gmailSendMessageCapabilitySpec = {
+    name: "gmail_send_message",
+    description: "Send a plain-text email from the user's Gmail account.",
+    inputSchema: GMAIL_SEND_SCHEMA,
+    category: "external",
+    userMessage: (params) => `Sending an email to ${str(params, "to")}`
+};
+export const gmailModifyLabelsCapabilitySpec = {
+    name: "gmail_modify_labels",
+    description: "Add or remove Gmail labels on a message. Archive by removing 'INBOX'; " +
+        "mark read by removing 'UNREAD'.",
+    inputSchema: GMAIL_MODIFY_LABELS_SCHEMA,
+    category: "external",
+    userMessage: () => "Updating email labels"
+};
+export const gmailListLabelsCapabilitySpec = {
+    name: "gmail_list_labels",
+    description: "List the Gmail labels available in the user's mailbox (id and name).",
+    inputSchema: { type: "object", properties: {} },
+    category: "external",
+    userMessage: () => "Listing Gmail labels"
+};
+export const docsReadSpec = {
+    name: "google_docs_read",
+    description: "Read a Google Doc's title and full text.",
+    inputSchema: DOCS_READ_SCHEMA,
+    category: "external",
+    userMessage: () => "Reading a Google Doc"
+};
+export const docsCreateSpec = {
+    name: "google_docs_create",
+    description: "Create a Google Doc, optionally seeded with text. Returns its id and URL.",
+    inputSchema: DOCS_CREATE_SCHEMA,
+    category: "external",
+    userMessage: (params) => `Creating the doc "${str(params, "title")}"`
+};
+export const docsAppendSpec = {
+    name: "google_docs_append",
+    description: "Append text to the end of a Google Doc.",
+    inputSchema: DOCS_APPEND_SCHEMA,
+    category: "external",
+    userMessage: () => "Appending to a Google Doc"
+};
+export const sheetsReadSpec = {
+    name: "google_sheets_read",
+    description: "Read a range from a Google Sheet in A1 notation (e.g. 'Sheet1!A1:D50'). " +
+        "Returns rows of cell values.",
+    inputSchema: SHEETS_READ_SCHEMA,
+    category: "external",
+    userMessage: (params) => `Reading ${str(params, "range")} from a Google Sheet`
+};
+export const sheetsAppendSpec = {
+    name: "google_sheets_append",
+    description: "Append rows below the last populated row of a Google Sheet range.",
+    inputSchema: SHEETS_APPEND_SCHEMA,
+    category: "external",
+    userMessage: () => "Appending rows to a Google Sheet"
+};
+export const sheetsUpdateSpec = {
+    name: "google_sheets_update",
+    description: "Overwrite a Google Sheet range with new values.",
+    inputSchema: SHEETS_UPDATE_SCHEMA,
+    category: "external",
+    userMessage: (params) => `Updating ${str(params, "range")} in a Google Sheet`
+};
+export const sheetsCreateSpec = {
+    name: "google_sheets_create",
+    description: "Create a Google Sheet, optionally seeded with rows. Returns id and URL.",
+    inputSchema: SHEETS_CREATE_SCHEMA,
+    category: "external",
+    userMessage: (params) => `Creating the sheet "${str(params, "title")}"`
+};
+export const calendarListSpec = {
+    name: "google_calendar_list_calendars",
+    description: "List the user's Google calendars (id and name).",
+    inputSchema: { type: "object", properties: {} },
+    category: "external",
+    userMessage: () => "Listing Google calendars"
+};
+export const calendarEventsSpec = {
+    name: "google_calendar_list_events",
+    description: "List Google Calendar events in a time window, soonest first. Times are " +
+        "RFC3339 timestamps; `time_min` defaults to now.",
+    inputSchema: CALENDAR_LIST_EVENTS_SCHEMA,
+    category: "external",
+    userMessage: () => "Checking the calendar"
+};
+export const calendarCreateSpec = {
+    name: "google_calendar_create_event",
+    description: "Create a Google Calendar event. `start` and `end` are RFC3339 timestamps " +
+        "with an offset, e.g. '2026-07-27T15:00:00-07:00'.",
+    inputSchema: CALENDAR_CREATE_EVENT_SCHEMA,
+    category: "external",
+    userMessage: (params) => `Creating the event "${str(params, "summary")}"`
+};
+export const calendarDeleteSpec = {
+    name: "google_calendar_delete_event",
+    description: "Delete a Google Calendar event by id.",
+    inputSchema: CALENDAR_DELETE_EVENT_SCHEMA,
+    category: "external",
+    userMessage: () => "Deleting a calendar event"
+};
+/** Every spec this module declares, in declaration order. */
+export const googleSpecs = [
+    driveSearchSpec,
+    driveReadFileCapabilitySpec,
+    driveGetFileCapabilitySpec,
+    driveCreateFileCapabilitySpec,
+    gmailSearchSpec,
+    gmailGetMessageCapabilitySpec,
+    gmailSendMessageCapabilitySpec,
+    gmailModifyLabelsCapabilitySpec,
+    gmailListLabelsCapabilitySpec,
+    docsReadSpec,
+    docsCreateSpec,
+    docsAppendSpec,
+    sheetsReadSpec,
+    sheetsAppendSpec,
+    sheetsUpdateSpec,
+    sheetsCreateSpec,
+    calendarListSpec,
+    calendarEventsSpec,
+    calendarCreateSpec,
+    calendarDeleteSpec
+];
+//# sourceMappingURL=google.specs.js.map

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

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

package/dist/capabilities/html-text.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Linear HTML-to-text stripping primitives, shared by the `web` and `email`
+ * capability modules.
+ *
+ * Everything here is an index scan, not a regex over the tag body: a page is
+ * library input, and both `<[^>]*>` and any `<script…</script>` regex go
+ * quadratic on adversarial runs of `<`. The outputs feed a model as plain
+ * text — this is readability stripping, not render sanitization.
+ */
+/**
+ * Remove every `<tagName …>…</tagName …>` block — tolerant of anything
+ * before the closing `>` (`</script\t\n bar>`). An unclosed block drops the
+ * rest of the input: script or style content is never text.
+ */
+export declare function stripElement(input: string, tagName: string): string;
+/**
+ * Remove every `<…>` span, matching what `/<[^>]*>/g` removes — the span runs
+ * from a `<` to the first `>` after it — without the quadratic rescans that
+ * regex pays on a run of `<` with no `>`. A trailing `<` with no `>` stays
+ * text ("5 < 6").
+ */
+export declare function stripTags(input: string): string;
+/**
+ * Strip until a pass changes nothing, so removed fragments cannot reassemble
+ * into a new match ("<scr<script>ipt>" → "<script>").
+ */
+export declare function stripToFixpoint(input: string, strip: (text: string) => string): string;
+//# sourceMappingURL=html-text.d.ts.map

package/dist/capabilities/html-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-text.d.ts","sourceRoot":"","sources":["../../src/capabilities/html-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAyBnE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAW/C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAC9B,MAAM,CAOR"}

package/dist/capabilities/html-text.js

@@ -0,0 +1,76 @@
+/**
+ * Linear HTML-to-text stripping primitives, shared by the `web` and `email`
+ * capability modules.
+ *
+ * Everything here is an index scan, not a regex over the tag body: a page is
+ * library input, and both `<[^>]*>` and any `<script…</script>` regex go
+ * quadratic on adversarial runs of `<`. The outputs feed a model as plain
+ * text — this is readability stripping, not render sanitization.
+ */
+/**
+ * Remove every `<tagName …>…</tagName …>` block — tolerant of anything
+ * before the closing `>` (`</script\t\n bar>`). An unclosed block drops the
+ * rest of the input: script or style content is never text.
+ */
+export function stripElement(input, tagName) {
+    const lower = input.toLowerCase();
+    const open = `<${tagName}`;
+    const close = `</${tagName}`;
+    let out = "";
+    let i = 0;
+    for (;;) {
+        const start = lower.indexOf(open, i);
+        if (start === -1)
+            return out + input.slice(i);
+        // Only a real tag boundary opens a block: "<scripted>" is not "<script>".
+        const after = lower.charCodeAt(start + open.length);
+        const boundary = Number.isNaN(after) || after === 0x3e || after === 0x2f || after <= 0x20;
+        if (!boundary) {
+            out += input.slice(i, start + open.length);
+            i = start + open.length;
+            continue;
+        }
+        out += input.slice(i, start);
+        const closeAt = lower.indexOf(close, start + open.length);
+        if (closeAt === -1)
+            return out;
+        const gt = input.indexOf(">", closeAt + close.length);
+        if (gt === -1)
+            return out;
+        i = gt + 1;
+    }
+}
+/**
+ * Remove every `<…>` span, matching what `/<[^>]*>/g` removes — the span runs
+ * from a `<` to the first `>` after it — without the quadratic rescans that
+ * regex pays on a run of `<` with no `>`. A trailing `<` with no `>` stays
+ * text ("5 < 6").
+ */
+export function stripTags(input) {
+    let out = "";
+    let i = 0;
+    for (;;) {
+        const lt = input.indexOf("<", i);
+        if (lt === -1)
+            return out + input.slice(i);
+        const gt = input.indexOf(">", lt + 1);
+        if (gt === -1)
+            return out + input.slice(i);
+        out += input.slice(i, lt);
+        i = gt + 1;
+    }
+}
+/**
+ * Strip until a pass changes nothing, so removed fragments cannot reassemble
+ * into a new match ("<scr<script>ipt>" → "<script>").
+ */
+export function stripToFixpoint(input, strip) {
+    let out = input;
+    for (;;) {
+        const next = strip(out);
+        if (next === out)
+            return out;
+        out = next;
+    }
+}
+//# sourceMappingURL=html-text.js.map

package/dist/capabilities/html-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-text.js","sourceRoot":"","sources":["../../src/capabilities/html-text.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,OAAe;IACzD,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,OAAO,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,KAAK,OAAO,EAAE,CAAC;IAC7B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,SAAS,CAAC;QACR,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,CAAC,CAAC;YAAE,OAAO,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC9C,0EAA0E;QAC1E,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,QAAQ,GACZ,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC;QAC3E,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;YACxB,SAAS;QACX,CAAC;QACD,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,OAAO,KAAK,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QAC/B,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QAC1B,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,SAAS,CAAC;QACR,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACjC,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,OAAO,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;QACtC,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,OAAO,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3C,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1B,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAa,EACb,KAA+B;IAE/B,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,IAAI,KAAK,GAAG;YAAE,OAAO,GAAG,CAAC;QAC7B,GAAG,GAAG,IAAI,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/capabilities/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Capabilities: the shape that replaces the `Tool` class.
+ *
+ * Design: docs/tool-class-retirement-design.md
+ */
+export { PERMISSION_CATEGORIES } from "./types.js";
+export type { AvailableSecretsResolver, CapabilitySpec, CapabilityImpl, CapabilityRun, CapabilityModule, CapabilityExport, CapabilityGate, CapabilityLoaders, ClientToolRouter, SecretPrompt, SecretPromptRequest, SecretPromptStatus, SubAgentRuntime, PermissionCategory } from "./types.js";
+export { toolFromLazyCapability, toolForCapabilityName } from "./lazy-tool.js";
+export { DECLARED_CAPABILITY_MODULES, listCapabilitySpecs, capabilitySpec, capabilityCategoryFor, capabilityModuleOf, capabilityModuleSpecTable, loadCapabilityImpl, eagerSpecDrift, loadCapabilityModule, listCapabilityModules, loadAllCapabilityModules, findCapability, capabilityCategorySnapshot, capabilityModuleIssues, capabilityModuleDrift } from "./registry.js";
+export { SandboxCapabilityError, capabilityModuleSpecs, createCapabilityDispatcher } from "./dispatcher.js";
+export type { SandboxCapabilityDispatcher } from "./dispatcher.js";
+export { toolFromCapability, capabilityFromTool } from "./adapters.js";
+export type { CapabilityRunSource } from "./adapters.js";
+export { UNGATED, contextSecretAvailability, createCapabilityRun, resolveCapabilityMessage, ungatedCapabilityRun } from "./invoke.js";
+export type { CreateCapabilityRunOptions } from "./invoke.js";
+export { gateFromContext } from "./gate-from-context.js";
+export { VIDEO_PRODUCTION_SCHEMA_VERSION, preflightVideoProduction, prepareVideoProduction, validateVideoProductionAcceptance } from "./video-production.js";
+export type { PreparedVideoProduction, VideoProductionAcceptance, VideoProductionCandidate, VideoProductionCandidateRequest, VideoProductionCandidateStatus, VideoProductionDestination, VideoProductionPreflight, VideoProductionRequest, VideoProductionRoute } from "./video-production.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EACV,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EACL,OAAO,EACP,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACL,+BAA+B,EAC/B,wBAAwB,EACxB,sBAAsB,EACtB,iCAAiC,EAClC,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,EACxB,+BAA+B,EAC/B,8BAA8B,EAC9B,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC"}

package/dist/capabilities/index.js

@@ -0,0 +1,14 @@
+/**
+ * Capabilities: the shape that replaces the `Tool` class.
+ *
+ * Design: docs/tool-class-retirement-design.md
+ */
+export { PERMISSION_CATEGORIES } from "./types.js";
+export { toolFromLazyCapability, toolForCapabilityName } from "./lazy-tool.js";
+export { DECLARED_CAPABILITY_MODULES, listCapabilitySpecs, capabilitySpec, capabilityCategoryFor, capabilityModuleOf, capabilityModuleSpecTable, loadCapabilityImpl, eagerSpecDrift, loadCapabilityModule, listCapabilityModules, loadAllCapabilityModules, findCapability, capabilityCategorySnapshot, capabilityModuleIssues, capabilityModuleDrift } from "./registry.js";
+export { SandboxCapabilityError, capabilityModuleSpecs, createCapabilityDispatcher } from "./dispatcher.js";
+export { toolFromCapability, capabilityFromTool } from "./adapters.js";
+export { UNGATED, contextSecretAvailability, createCapabilityRun, resolveCapabilityMessage, ungatedCapabilityRun } from "./invoke.js";
+export { gateFromContext } from "./gate-from-context.js";
+export { VIDEO_PRODUCTION_SCHEMA_VERSION, preflightVideoProduction, prepareVideoProduction, validateVideoProductionAcceptance } from "./video-production.js";
+//# sourceMappingURL=index.js.map

package/dist/capabilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAiBnD,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,cAAc,EACd,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC3B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,OAAO,EACP,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EACL,+BAA+B,EAC/B,wBAAwB,EACxB,sBAAsB,EACtB,iCAAiC,EAClC,MAAM,uBAAuB,CAAC"}

package/dist/capabilities/invoke.d.ts

@@ -0,0 +1,89 @@
+/**
+ * `CapabilityRun.invoke` — the single choke point: lookup → gate → impl.
+ *
+ * The gate used to be a wrapper class applied where someone remembered
+ * `gateTools`. It lives here now, in the one place lookup already happens, so a
+ * direct call and an in-sandbox call cannot take different paths. `gateTools`
+ * survives as a shim that routes a `Tool` through this ladder
+ * (`tools/tool-permissions.ts`); `tests/capabilities-gate-parity.test.ts`
+ * drives both entrances and compares transcripts.
+ *
+ * Design: docs/tool-class-retirement-design.md § "Where the permission gate
+ * lives".
+ */
+import type { BaseProvider, ProcessingContext, RunBudget } from "@nodetool-ai/runtime";
+import type { NodeRegistry } from "@nodetool-ai/node-sdk";
+import type { VectorCollection } from "@nodetool-ai/vectorstore";
+import type { AvailableSecretsResolver, CapabilityExport, CapabilityGate, CapabilityLoaders, CapabilityRun, CapabilitySpec, ClientToolRouter, SecretPrompt, SubAgentRuntime } from "./types.js";
+import type { ExampleWorkflowCatalog, ModelCatalogs, PackageAssetLister, ProjectDeleter, WorkflowDslExporter, WorkflowEnvironmentProvider } from "../tools/mcp-tools.js";
+/**
+ * The gate a directly-constructed tool carries. Those tools are gated from the
+ * outside — `gateTools` wraps them per turn — and the adapter calls the
+ * implementation without consulting the run's own gate, so this exists only to
+ * satisfy the run's shape. `auto` keeps the two paths equivalent if anything
+ * ever reaches {@link CapabilityRun.invoke} through one of them.
+ */
+export declare const UNGATED: CapabilityGate;
+/**
+ * A run over one call's context and nothing else — what every ported tool
+ * class whose capability needs only the context builds in its `process()`.
+ */
+export declare function ungatedCapabilityRun(context: ProcessingContext): CapabilityRun;
+/**
+ * The availability callback for a run whose context can reach a secret store,
+ * and `undefined` for one that cannot.
+ *
+ * Every host resolves the same way BaseNode's secret injection does — a key
+ * with a non-empty value is available — so this is the one implementation
+ * instead of one per host. It reads values, but only to test them: nothing
+ * leaves the callback except the set of names that resolved.
+ */
+export declare function contextSecretAvailability(context: ProcessingContext): AvailableSecretsResolver | undefined;
+export interface CreateCapabilityRunOptions {
+    context: ProcessingContext;
+    gate: CapabilityGate;
+    client?: ClientToolRouter;
+    /** The project this run works in; see {@link CapabilityRun.projectId}. */
+    projectId?: string;
+    /** Opens the bespoke secret dialog; see {@link CapabilityRun.secretPrompt}. */
+    secretPrompt?: SecretPrompt;
+    subAgent?: SubAgentRuntime;
+    /** The run's budget; see {@link CapabilityRun.budget}. */
+    budget?: RunBudget;
+    /**
+     * Which declared credentials this install holds; see
+     * {@link CapabilityRun.availableSecrets}. Build it with
+     * {@link contextSecretAvailability} — a host that omits it turns off
+     * `validate_workflow`'s `missing_secret` check rather than reporting every
+     * declared key as absent.
+     */
+    availableSecrets?: AvailableSecretsResolver;
+    nodeRegistry?: NodeRegistry;
+    providers?: Record<string, BaseProvider>;
+    examples?: ExampleWorkflowCatalog;
+    exportDsl?: WorkflowDslExporter;
+    modelCatalogs?: ModelCatalogs;
+    listPackageAssets?: PackageAssetLister;
+    /** See {@link CapabilityRun.deleteProject}. */
+    deleteProject?: ProjectDeleter;
+    /** The collection the `vector_*` capabilities act on; see {@link CapabilityRun}. */
+    vectorCollection?: VectorCollection;
+    workflowEnvironment?: WorkflowEnvironmentProvider;
+    loaders?: CapabilityLoaders;
+    /**
+     * Capabilities this run serves beyond the registry — the subsystem-dependent
+     * ones a host constructs itself today (`run_node`, `run_subtask`, the vector
+     * tools), and the fakes a test registers. Checked before the registry, so a
+     * host can also override one.
+     */
+    capabilities?: Iterable<CapabilityExport>;
+}
+/** Build a run whose `invoke` runs the gate before every implementation. */
+export declare function createCapabilityRun(options: CreateCapabilityRunOptions): CapabilityRun;
+/**
+ * The user-facing message for an approval prompt: the LLM-authored `_message`
+ * wins, else the spec's template, else the generic fallback — the same order
+ * `Tool.resolveMessage` applies.
+ */
+export declare function resolveCapabilityMessage(spec: CapabilitySpec, args: Record<string, unknown> | null | undefined): string;
+//# sourceMappingURL=invoke.d.ts.map