terse-cli 0.2.14 → 0.2.15

package/dist/commands/toolRun.d.ts

@@ -0,0 +1,7 @@
+export declare function integrateToolRun(opts: IntegrateToolRunOpts): Promise<void>;
+export type IntegrateToolRunOpts = {
+    toolName: string;
+    params?: string;
+    integrationId?: string;
+};
+//# sourceMappingURL=toolRun.d.ts.map

package/dist/commands/toolRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolRun.d.ts","sourceRoot":"","sources":["../../src/commands/toolRun.ts"],"names":[],"mappings":"AAWA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAShF;AA0HD,MAAM,MAAM,oBAAoB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA"}

package/dist/commands/toolRun.js

@@ -0,0 +1,135 @@
+import { ApiRoutes, integrationTypeEnum, isValidToolName, toolsWithIntegrationId } from "terse-types";
+import { z } from "zod";
+import { ApiError, fetchWithAuth, readApiKeyOrBail } from "../api.js";
+import { CliError, isCliError } from "../cliError.js";
+import { readRawStdin } from "../cliHelpers.js";
+import { fetchIntegrationConnections } from "../integrationApi.js";
+import { readProjectConfig } from "../projectConfig.js";
+import { toCamelCase } from "../providers/typescript/prepareCodegenData.js";
+import { fetchToolDetails } from "../toolCatalog.js";
+export async function integrateToolRun(opts) {
+    const apiKey = readApiKeyOrBail();
+    const params = await readToolParams(opts.params);
+    const catalog = await fetchToolDetails(apiKey);
+    const tool = resolveTool(opts.toolName, catalog);
+    assertAdHocRunnable(tool);
+    const finalParams = await withIntegrationId(params, tool, opts.integrationId, apiKey);
+    const result = await executeTool(tool.name, finalParams, apiKey);
+    process.stdout.write(JSON.stringify(result ?? null, null, 2) + "\n");
+}
+async function readToolParams(raw) {
+    if (raw !== undefined && raw !== "-")
+        return parseParamsJson(raw, "--params");
+    if (raw === "-" || !process.stdin.isTTY) {
+        const fromStdin = await readRawStdin();
+        if (fromStdin)
+            return parseParamsJson(fromStdin, "stdin");
+        if (raw === "-") {
+            throw new CliError("missing_params", "Expected JSON params on stdin (--params -), but stdin was empty.");
+        }
+    }
+    return {};
+}
+function parseParamsJson(raw, source) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new CliError("invalid_params", `Could not parse JSON params from ${source}.`, {
+            detail: err instanceof Error ? err.message : String(err)
+        });
+    }
+    const result = z.record(z.string(), z.unknown()).safeParse(parsed);
+    if (!result.success || Array.isArray(parsed)) {
+        throw new CliError("invalid_params", `Params from ${source} must be a JSON object.`, {
+            detail: 'Example: --params \'{"objectSlug":"deals","request":{"action":"query"}}\''
+        });
+    }
+    return result.data;
+}
+function resolveTool(input, catalog) {
+    const exact = catalog.find(tool => tool.name === input);
+    if (exact)
+        return exact;
+    const dotIndex = input.indexOf(".");
+    if (dotIndex > 0) {
+        const integration = input.slice(0, dotIndex);
+        const method = input.slice(dotIndex + 1);
+        const match = catalog.find(tool => tool.integration === integration && toCamelCase(tool.displayName) === method);
+        if (match)
+            return match;
+        const available = catalog.filter(tool => tool.integration === integration);
+        if (available.length > 0) {
+            throw new CliError("unknown_tool", `Unknown tool '${method}' for integration '${integration}'.`, {
+                detail: `Available: ${available.map(tool => `${integration}.${toCamelCase(tool.displayName)} [${tool.name}]${tool.isReadOnly ? "" : " (write)"}`).join(", ")}`
+            });
+        }
+    }
+    throw new CliError("unknown_tool", `Unknown tool '${input}'.`, {
+        detail: "Pass a wire name (attio_records) or dotted form (attio.records). Use `terse integrate tool <integration>` to list tools."
+    });
+}
+function assertAdHocRunnable(tool) {
+    if (tool.isReadOnly && !tool.supportsApproval)
+        return;
+    const reason = tool.isReadOnly ? "requires approval" : "is a write tool";
+    throw new CliError("tool_not_runnable", `Tool '${tool.name}' ${reason} and cannot be run ad hoc.`, {
+        detail: "Only read-only tools can be invoked with `terse integrate tool run`. Call this tool from a job instead."
+    });
+}
+async function withIntegrationId(params, tool, flagIntegrationId, apiKey) {
+    if (flagIntegrationId)
+        return { ...params, integrationId: flagIntegrationId };
+    if (params.integrationId !== undefined)
+        return params;
+    if (!toolRequiresIntegrationId(tool.name))
+        return params;
+    const pinned = pinnedConnectionFor(tool.integration);
+    if (pinned)
+        return { ...params, integrationId: pinned };
+    return { ...params, integrationId: await resolveSingleIntegrationId(tool.integration, apiKey) };
+}
+function toolRequiresIntegrationId(toolName) {
+    return isValidToolName(toolName) && toolsWithIntegrationId.has(toolName);
+}
+function pinnedConnectionFor(integration) {
+    const parsed = integrationTypeEnum.safeParse(integration);
+    if (!parsed.success)
+        return undefined;
+    return readProjectConfig()?.connections?.[parsed.data];
+}
+async function resolveSingleIntegrationId(integration, apiKey) {
+    const connections = await fetchIntegrationConnections(apiKey, integration);
+    if (connections.length === 0) {
+        throw new CliError("integration_not_connected", `Integration '${integration}' is not connected.`, {
+            detail: `Run \`terse integrate connect ${integration}\` first.`,
+            actionRequired: true
+        });
+    }
+    if (connections.length > 1) {
+        const listing = connections.map(connection => (connection.name === connection.id ? connection.id : `${connection.id} (${connection.name})`)).join(", ");
+        throw new CliError("integration_ambiguous", `Integration '${integration}' has ${connections.length} connections.`, {
+            detail: `List them with \`terse integrate connections ${integration} --json\`, then pass --integration <id> or pin one for this project with \`terse integrate use ${integration} <id>\`. Connections: ${listing}`
+        });
+    }
+    return connections[0].id;
+}
+async function executeTool(toolName, params, apiKey) {
+    try {
+        const response = await fetchWithAuth(ApiRoutes.SDK.TOOL_EXECUTE, apiKey, { toolName, params }, "POST");
+        return response.result;
+    }
+    catch (err) {
+        throw toToolExecutionError(err, toolName);
+    }
+}
+function toToolExecutionError(err, toolName) {
+    if (isCliError(err))
+        return err;
+    if (err instanceof ApiError && typeof err.body.error === "string") {
+        return new CliError("tool_execution_failed", `Tool '${toolName}' failed: ${err.body.error}`);
+    }
+    return new CliError("tool_execution_failed", `Tool '${toolName}' failed: ${err instanceof Error ? err.message : String(err)}`);
+}
+//# sourceMappingURL=toolRun.js.map

package/dist/commands/toolRun.js.map

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

package/dist/data/standardSlackEmoji.d.ts

@@ -0,0 +1,2 @@
+export declare const STANDARD_SLACK_EMOJI: readonly string[];
+//# sourceMappingURL=standardSlackEmoji.d.ts.map

package/dist/data/standardSlackEmoji.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standardSlackEmoji.d.ts","sourceRoot":"","sources":["../../src/data/standardSlackEmoji.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAq7DjD,CAAA"}