@skrr-ai/cli 0.1.40 → 0.1.41

package/dist/lib/runtime-tool-support.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_COLUMN_FOOTNOTE = void 0;
+exports.agentRuntimeLabel = agentRuntimeLabel;
+exports.pluginKeysNotLoaded = pluginKeysNotLoaded;
+exports.pluginsNotLoadedNotice = pluginsNotLoadedNotice;
+exports.oauthActionNotice = oauthActionNotice;
+exports.splitStoredTools = splitStoredTools;
+exports.warnPluginsNotLoaded = warnPluginsNotLoaded;
+const data_provider_1 = require("@skrr-ai/data-provider");
+/**
+ * What an agent turn can call, said where tools are configured.
+ *
+ * Plugin tools (`agents tools`, `--tools`) and OpenAPI actions
+ * (`agents api-actions add`) reach an agent turn through the runtime's
+ * `agent-tools` server (OSK-9750, OSK-9754). Two limits remain, and the CLI is
+ * where the tool is set up, so it says them there:
+ *  - image and file plugins save their output through a web request an agent
+ *    turn does not have, so they are stored but not loaded;
+ *  - an OAuth action runs only after the user authorizes it once, through a
+ *    link the agent hands over on its first call.
+ */
+/** The catalog's AGENT column. `?` for a server older than the `agentRuntime` field. */
+function agentRuntimeLabel(tool) {
+    if (tool.agentRuntime === undefined)
+        return '?';
+    return tool.agentRuntime ? 'yes' : 'no';
+}
+exports.AGENT_COLUMN_FOOTNOTE = 'AGENT says whether an agent turn can call the tool. Image and file tools (AGENT no) ' +
+    'save their output through a web request an agent turn does not have.';
+/** Stored plugin keys the catalog says an agent turn does not load. */
+function pluginKeysNotLoaded(keys, catalog) {
+    const byKey = new Map(catalog.map((tool) => [tool.pluginKey, tool]));
+    return keys.filter((key) => byKey.get(key)?.agentRuntime === false);
+}
+function pluginsNotLoadedNotice(keys) {
+    const [subject, verb] = keys.length === 1 ? ['it', 'saves'] : ['they', 'save'];
+    return (`Saved, but an agent turn cannot call ${keys.join(', ')}: ${subject} ${verb} ` +
+        'output through a web request an agent turn does not have.');
+}
+/** Said after adding an OAuth action, since nothing works until both steps happen. */
+function oauthActionNotice(redirectUrl) {
+    return (`Register ${redirectUrl} as the redirect URL with the OAuth provider. ` +
+        "The agent's first call to one of these operations returns a link for you to authorize; " +
+        'after you finish, ask it to try again.');
+}
+/** Split an agent's stored `tools` into plugin keys and OpenAPI action tool names. */
+function splitStoredTools(tools) {
+    const list = Array.isArray(tools) ? tools.map(String) : [];
+    return {
+        plugins: list.filter((name) => !name.includes(data_provider_1.actionDelimiter)),
+        actions: list.filter((name) => name.includes(data_provider_1.actionDelimiter)),
+    };
+}
+/**
+ * After `--tools` is saved: warn about the plugin keys an agent turn will not load.
+ *
+ * Unknown keys are refused by the server (OSK-9545); this covers the known ones
+ * that are stored but skipped. Best effort: a catalog that cannot be read says
+ * nothing rather than failing a write that already succeeded.
+ */
+async function warnPluginsNotLoaded(tools, warn, fetchCatalog = () => data_provider_1.dataService.getAvailableTools()) {
+    const { plugins } = splitStoredTools(tools);
+    if (plugins.length === 0)
+        return;
+    let catalog;
+    try {
+        catalog = await fetchCatalog();
+    }
+    catch {
+        return;
+    }
+    const skipped = pluginKeysNotLoaded(plugins, catalog);
+    if (skipped.length > 0) {
+        warn(pluginsNotLoadedNotice(skipped));
+    }
+}

package/dist/lib/share-rows.d.ts

@@ -0,0 +1,17 @@
+/**
+ * How an agent-share row names its share and the other person.
+ *
+ * The share routes answer `{ shareId, owner: { userId, name }, recipient:
+ * { userId, name } }`. The four `agent-shares` listings read `id`/`_id` and
+ * stringified the person object, so every row printed SHARE ID `-` and FROM/TO
+ * `[object Object]` (OSK-10043): the one id `respond`/`revoke` need was
+ * unreadable, and so was who the share was with.
+ */
+/** The share's id, whichever key the row carries it under. */
+export declare function shareIdOf(share: Record<string, unknown>): string;
+/**
+ * A person as `Name (userId)` — the name to recognise, the id that
+ * `agent-shares with <userId>` takes. Accepts a bare id string too, which older
+ * rows used.
+ */
+export declare function sharePartyLabel(value: unknown): string;

package/dist/lib/share-rows.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * How an agent-share row names its share and the other person.
+ *
+ * The share routes answer `{ shareId, owner: { userId, name }, recipient:
+ * { userId, name } }`. The four `agent-shares` listings read `id`/`_id` and
+ * stringified the person object, so every row printed SHARE ID `-` and FROM/TO
+ * `[object Object]` (OSK-10043): the one id `respond`/`revoke` need was
+ * unreadable, and so was who the share was with.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shareIdOf = shareIdOf;
+exports.sharePartyLabel = sharePartyLabel;
+/** The share's id, whichever key the row carries it under. */
+function shareIdOf(share) {
+    const id = share.shareId ?? share.id ?? share._id;
+    return typeof id === 'string' && id.length > 0 ? id : '-';
+}
+/**
+ * A person as `Name (userId)` — the name to recognise, the id that
+ * `agent-shares with <userId>` takes. Accepts a bare id string too, which older
+ * rows used.
+ */
+function sharePartyLabel(value) {
+    if (typeof value === 'string')
+        return value.length > 0 ? value : '-';
+    if (!value || typeof value !== 'object')
+        return '-';
+    const party = value;
+    const id = [party.userId, party.id].find((v) => typeof v === 'string' && v.length > 0);
+    const name = [party.name, party.email].find((v) => typeof v === 'string' && v.length > 0);
+    if (name && id)
+        return `${name} (${id})`;
+    return name ?? id ?? '-';
+}