indusagi 0.12.24 → 0.12.27

package/local-dist/bot/actions/composio/execute.d.ts

@@ -0,0 +1,27 @@
+import type { AgentTool } from "../../types.js";
+import type { ComposioExecuteResult, ComposioToolFactoryOptions } from "./types.js";
+declare const composioExecuteSchema: import("@sinclair/typebox").TObject<{
+    toolSlug: import("@sinclair/typebox").TString;
+    arguments: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    toolkits: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    authConfigs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TString>>;
+    connectedAccounts: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TString>>;
+    authConfigId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    connectedAccountId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export interface ComposioExecuteToolDetails extends ComposioExecuteResult {
+    userId: string;
+    toolSlug: string;
+}
+export declare function createComposioExecuteTool(options?: ComposioToolFactoryOptions): AgentTool<typeof composioExecuteSchema, ComposioExecuteToolDetails>;
+export declare const composioExecuteTool: AgentTool<import("@sinclair/typebox").TObject<{
+    toolSlug: import("@sinclair/typebox").TString;
+    arguments: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TUnknown>>;
+    toolkits: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    authConfigs: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TString>>;
+    connectedAccounts: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TString>>;
+    authConfigId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    connectedAccountId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>, ComposioExecuteToolDetails>;
+export {};
+//# sourceMappingURL=execute.d.ts.map

package/local-dist/bot/actions/composio/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../../app/bot/actions/composio/execute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,OAAO,KAAK,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAEpF,QAAA,MAAM,qBAAqB;;;;;;;;EAQzB,CAAC;AAEH,MAAM,WAAW,0BAA2B,SAAQ,qBAAqB;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,yBAAyB,CAAC,OAAO,GAAE,0BAA+B,GAAG,SAAS,CAAC,OAAO,qBAAqB,EAAE,0BAA0B,CAAC,CAkCvJ;AAED,eAAO,MAAM,mBAAmB;;;;;;;;+BAA8B,CAAC"}

package/local-dist/bot/actions/composio/execute.js

@@ -0,0 +1,46 @@
+import { Type } from "@sinclair/typebox";
+import { ComposioService } from "./client.js";
+import { formatExecuteResult } from "./helpers.js";
+const composioExecuteSchema = Type.Object({
+    toolSlug: Type.String({ description: "The exact Composio tool slug to execute (for example GITHUB_CREATE_ISSUE)" }),
+    arguments: Type.Optional(Type.Record(Type.String(), Type.Unknown(), { description: "Arguments to pass to the Composio tool" })),
+    toolkits: Type.Optional(Type.Array(Type.String(), { description: "Optional toolkit scope for the session" })),
+    authConfigs: Type.Optional(Type.Record(Type.String(), Type.String(), { description: "Optional toolkit to authConfigId map" })),
+    connectedAccounts: Type.Optional(Type.Record(Type.String(), Type.String(), { description: "Optional toolkit to connectedAccountId map" })),
+    authConfigId: Type.Optional(Type.String({ description: "Single auth config to use when exactly one toolkit is in scope" })),
+    connectedAccountId: Type.Optional(Type.String({ description: "Single connected account to use when exactly one toolkit is in scope" })),
+});
+export function createComposioExecuteTool(options = {}) {
+    const service = options.service ?? new ComposioService(options);
+    return {
+        name: "composio_execute",
+        label: "composio_execute",
+        description: "Advanced fallback flow. Execute a Composio tool directly by slug when native toolkit hydration is not practical or when debugging a specific tool call.",
+        parameters: composioExecuteSchema,
+        execute: async (_toolCallId, input) => {
+            const [userId, result] = await Promise.all([
+                service.resolveUserId(),
+                service.executeTool({
+                    toolSlug: input.toolSlug,
+                    arguments: input.arguments,
+                    toolkits: input.toolkits,
+                    authConfigs: input.authConfigs,
+                    connectedAccounts: input.connectedAccounts,
+                    authConfigId: input.authConfigId,
+                    connectedAccountId: input.connectedAccountId,
+                }),
+            ]);
+            return {
+                content: [{ type: "text", text: formatExecuteResult(result) }],
+                details: {
+                    ...result,
+                    userId,
+                    toolSlug: input.toolSlug,
+                },
+                isError: !result.successful,
+            };
+        },
+    };
+}
+export const composioExecuteTool = createComposioExecuteTool();
+//# sourceMappingURL=execute.js.map

package/local-dist/bot/actions/composio/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../../app/bot/actions/composio/execute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,MAAM,qBAAqB,GAAG,IAAI,CAAC,MAAM,CAAC;IACzC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2EAA2E,EAAE,CAAC;IACnH,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,wCAAwC,EAAE,CAAC,CAAC;IAC/H,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,wCAAwC,EAAE,CAAC,CAAC;IAC7G,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,sCAAsC,EAAE,CAAC,CAAC;IAC9H,iBAAiB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,4CAA4C,EAAE,CAAC,CAAC;IAC1I,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gEAAgE,EAAE,CAAC,CAAC;IAC3H,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,sEAAsE,EAAE,CAAC,CAAC;CACvI,CAAC,CAAC;AAOH,MAAM,UAAU,yBAAyB,CAAC,UAAsC,EAAE;IACjF,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;IAEhE,OAAO;QACN,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACV,yJAAyJ;QAC1J,UAAU,EAAE,qBAAqB;QACjC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,EAAE;YACrC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC1C,OAAO,CAAC,aAAa,EAAE;gBACvB,OAAO,CAAC,WAAW,CAAC;oBACnB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;oBAC1C,YAAY,EAAE,KAAK,CAAC,YAAY;oBAChC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;iBAC5C,CAAC;aACF,CAAC,CAAC;YAEH,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE;oBACR,GAAG,MAAM;oBACT,MAAM;oBACN,QAAQ,EAAE,KAAK,CAAC,QAAQ;iBACxB;gBACD,OAAO,EAAE,CAAC,MAAM,CAAC,UAAU;aAC3B,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,yBAAyB,EAAE,CAAC"}

package/local-dist/bot/actions/composio/helpers.d.ts

@@ -0,0 +1,17 @@
+import type { ConnectedAccountListResponse, Tool as ComposioRawTool, ToolRouterSessionSearchResponse, ToolkitConnectionsDetails } from "@composio/core";
+import type { ComposioConnectResult, ComposioExecuteResult, ComposioToolMetadata } from "./types.js";
+export declare const DEFAULT_COMPOSIO_USER_ID = "default";
+export declare function buildComposioToolName(slug: string): string;
+export declare function buildComposioToolDescription(tool: ComposioRawTool): string;
+export declare function extractToolMetadata(tool: Pick<ComposioRawTool, "slug" | "name" | "toolkit" | "isNoAuth" | "version">): ComposioToolMetadata;
+export declare function safeJsonStringify(value: unknown): string;
+export declare function formatExecutionPayload(data: unknown, fallback?: string): string;
+export declare function formatExecuteResult(result: ComposioExecuteResult): string;
+export declare function formatToolkitList(toolkits: ToolkitConnectionsDetails): string;
+export declare function formatRawToolList(items: ComposioRawTool[]): string;
+export declare function formatSearchResults(result: ToolRouterSessionSearchResponse): string;
+export declare function formatConnectedAccounts(accounts: ConnectedAccountListResponse): string;
+export declare function formatConnectResult(result: ComposioConnectResult): string;
+export declare function stableStringify(value: unknown): string;
+export declare function uniqueStrings(values: readonly string[] | undefined): string[];
+//# sourceMappingURL=helpers.d.ts.map

package/local-dist/bot/actions/composio/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../app/bot/actions/composio/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,4BAA4B,EAC5B,IAAI,IAAI,eAAe,EACvB,+BAA+B,EAC/B,yBAAyB,EACzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAErG,eAAO,MAAM,wBAAwB,YAAY,CAAC;AAkDlD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAI1E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC,GAAG,oBAAoB,CAQ3I;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMxD;AA+ZD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAoC/E;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAKzE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,CAW7E;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAYlE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,+BAA+B,GAAG,MAAM,CAYnF;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,4BAA4B,GAAG,MAAM,CAMtF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAoBzE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYtD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAK7E"}

package/local-dist/bot/actions/composio/helpers.js

@@ -0,0 +1,533 @@
+export const DEFAULT_COMPOSIO_USER_ID = "default";
+const MAX_TEXT_LENGTH = 1200;
+const CONNECTION_STATUSES = new Set(["INITIALIZING", "INITIATED", "ACTIVE", "FAILED", "EXPIRED", "INACTIVE"]);
+const PENDING_CONNECTION_STATUSES = new Set(["INITIALIZING", "INITIATED"]);
+const CONNECTION_URL_KEYS = [
+    "authUri",
+    "auth_uri",
+    "authUrl",
+    "auth_url",
+    "authorizationUrl",
+    "authorization_url",
+    "redirectUrl",
+    "redirect_url",
+    "composio_link_redirect_url",
+    "account_url",
+    "accountUrl",
+    "borneo_dashboard_url",
+    "callbackUrl",
+    "callback_url",
+];
+const CONNECTION_REASON_KEYS = [
+    "status_reason",
+    "statusReason",
+    "error_description",
+    "errorDescription",
+    "error",
+    "reason",
+];
+const COLLECTION_KEYS = ["repositories", "repos", "items", "results", "nodes", "values"];
+const LOW_SIGNAL_SUMMARIES = new Set(["ok", "okay", "success", "successful", "completed", "complete", "done", "true"]);
+function asRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    return value;
+}
+export function buildComposioToolName(slug) {
+    const normalized = slug.trim().toLowerCase().replace(/[^a-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+    return `composio__${normalized || "tool"}`;
+}
+export function buildComposioToolDescription(tool) {
+    const toolkitPrefix = tool.toolkit?.slug ? `[${tool.toolkit.slug}] ` : "";
+    const description = tool.description?.trim() || "Execute a Composio tool.";
+    return `${toolkitPrefix}${description}`;
+}
+export function extractToolMetadata(tool) {
+    return {
+        slug: tool.slug,
+        name: tool.name,
+        toolkit: tool.toolkit?.slug,
+        isNoAuth: tool.isNoAuth,
+        version: tool.version,
+    };
+}
+export function safeJsonStringify(value) {
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+}
+function truncate(text, maxLength = MAX_TEXT_LENGTH) {
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return `${text.slice(0, maxLength - 3)}...`;
+}
+function summarizeScalar(value) {
+    if (typeof value === "string") {
+        return value.trim() || undefined;
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    return undefined;
+}
+function summarizeNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function pushUnique(target, value) {
+    if (!value || target.includes(value)) {
+        return;
+    }
+    target.push(value);
+}
+function isLowSignalSummary(value) {
+    const normalized = value.trim().toLowerCase().replace(/[.!]+$/g, "");
+    return LOW_SIGNAL_SUMMARIES.has(normalized);
+}
+function isUrlLike(value) {
+    try {
+        const parsed = new URL(value);
+        return parsed.protocol === "http:" || parsed.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+function connectionUrlPriority(key) {
+    const priorities = {
+        authUri: 1,
+        auth_uri: 1,
+        authUrl: 1,
+        auth_url: 1,
+        authorizationUrl: 1,
+        authorization_url: 1,
+        redirectUrl: 2,
+        redirect_url: 2,
+        composio_link_redirect_url: 2,
+        account_url: 3,
+        accountUrl: 3,
+        borneo_dashboard_url: 4,
+        callbackUrl: 5,
+        callback_url: 5,
+    };
+    return priorities[key] ?? 10;
+}
+function collectConnectionSignals(value, signals = { statuses: [], reasons: [], urls: [] }, seen = new WeakSet(), depth = 0) {
+    if (value == null || depth > 7) {
+        return signals;
+    }
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            collectConnectionSignals(item, signals, seen, depth + 1);
+        }
+        return signals;
+    }
+    const record = asRecord(value);
+    if (!record) {
+        return signals;
+    }
+    if (seen.has(record)) {
+        return signals;
+    }
+    seen.add(record);
+    const status = summarizeScalar(record.status);
+    if (status && CONNECTION_STATUSES.has(status)) {
+        pushUnique(signals.statuses, status);
+    }
+    for (const key of CONNECTION_REASON_KEYS) {
+        pushUnique(signals.reasons, summarizeScalar(record[key]));
+    }
+    for (const key of CONNECTION_URL_KEYS) {
+        const url = summarizeScalar(record[key]);
+        if (!url || !isUrlLike(url) || signals.urls.some((entry) => entry.url === url)) {
+            continue;
+        }
+        signals.urls.push({ key, url });
+    }
+    for (const nested of Object.values(record)) {
+        collectConnectionSignals(nested, signals, seen, depth + 1);
+    }
+    return signals;
+}
+function getBestConnectionUrls(value, limit = 3) {
+    return collectConnectionSignals(value).urls
+        .slice()
+        .sort((left, right) => connectionUrlPriority(left.key) - connectionUrlPriority(right.key))
+        .slice(0, limit);
+}
+function formatConnectionSignalSummary(data) {
+    const signals = collectConnectionSignals(data);
+    const failedStatus = signals.statuses.find((status) => status === "FAILED" || status === "EXPIRED");
+    if (failedStatus) {
+        const lines = [`Composio connection failed (${failedStatus}).`];
+        if (signals.reasons.length > 0) {
+            lines.push(`Reason: ${signals.reasons[0]}`);
+        }
+        const urls = getBestConnectionUrls(data, 2);
+        if (urls.length > 0) {
+            lines.push("Retry or inspect the connection here:");
+            for (const entry of urls) {
+                lines.push(`- ${entry.url}`);
+            }
+        }
+        return truncate(lines.join("\n"));
+    }
+    const pendingStatus = signals.statuses.find((status) => PENDING_CONNECTION_STATUSES.has(status));
+    if (!pendingStatus) {
+        return undefined;
+    }
+    const urls = getBestConnectionUrls(data, 3);
+    const lines = [`Composio connection is pending (${pendingStatus}).`];
+    if (signals.reasons.length > 0) {
+        lines.push(`Reason: ${signals.reasons[0]}`);
+    }
+    if (urls.length > 0) {
+        lines.push("Complete the authentication in your browser:");
+        for (const entry of urls) {
+            lines.push(`- ${entry.url}`);
+        }
+        lines.push("After approving access, rerun the request.");
+    }
+    else {
+        lines.push("Finish the provider auth flow, then rerun the request.");
+        lines.push("If no auth URL is visible yet, run composio_accounts again in a few seconds.");
+    }
+    return truncate(lines.join("\n"));
+}
+function getToolkitConnectionStatus(toolkit) {
+    const connection = asRecord(toolkit.connection);
+    if (connection?.isActive === true) {
+        const connectedAccount = asRecord(connection.connectedAccount) ?? asRecord(connection.connected_account);
+        const activeStatus = summarizeScalar(connectedAccount?.status) ?? "ACTIVE";
+        return `connected (${activeStatus})`;
+    }
+    const pendingStatus = summarizeScalar(connection?.status) ??
+        summarizeScalar((asRecord(connection?.connectedAccount) ?? asRecord(connection?.connected_account))?.status);
+    if (pendingStatus && PENDING_CONNECTION_STATUSES.has(pendingStatus)) {
+        return `pending (${pendingStatus})`;
+    }
+    if (pendingStatus === "FAILED" || pendingStatus === "EXPIRED") {
+        return `connection failed (${pendingStatus})`;
+    }
+    if (toolkit.isNoAuth === true) {
+        return "no auth required";
+    }
+    return "not connected";
+}
+function getRecordField(record, ...keys) {
+    for (const key of keys) {
+        if (key in record) {
+            return record[key];
+        }
+    }
+    return undefined;
+}
+function getNestedScalar(record, keys) {
+    return summarizeScalar(getRecordField(record, ...keys));
+}
+function getNestedNumber(record, keys) {
+    return summarizeNumber(getRecordField(record, ...keys));
+}
+function pluralize(count, singular, plural = `${singular}s`) {
+    return count === 1 ? singular : plural;
+}
+function getCollectionNoun(label) {
+    switch (label) {
+        case "repos":
+        case "repositories":
+            return { singular: "repository", plural: "repositories" };
+        case "items":
+            return { singular: "item", plural: "items" };
+        case "results":
+            return { singular: "result", plural: "results" };
+        case "nodes":
+            return { singular: "node", plural: "nodes" };
+        case "values":
+            return { singular: "value", plural: "values" };
+        default:
+            return { singular: label, plural: `${label}s` };
+    }
+}
+function formatCountBreakdown(parts) {
+    const filtered = parts.filter((part) => Boolean(part));
+    return filtered.length > 0 ? filtered.join(", ") : undefined;
+}
+function extractListLabel(item) {
+    if (typeof item === "string") {
+        return item.trim() || undefined;
+    }
+    const record = asRecord(item);
+    if (!record) {
+        return summarizeScalar(item);
+    }
+    const fullName = getNestedScalar(record, ["full_name", "fullName", "path_with_namespace", "pathWithNamespace"]);
+    if (fullName) {
+        return fullName;
+    }
+    const owner = asRecord(getRecordField(record, "owner", "namespace"));
+    const ownerLogin = owner ? getNestedScalar(owner, ["login", "name", "path"]) : undefined;
+    const name = getNestedScalar(record, ["name", "title", "slug", "login"]);
+    if (ownerLogin && name) {
+        return `${ownerLogin}/${name}`;
+    }
+    return (name ??
+        getNestedScalar(record, ["id"]) ??
+        getNestedScalar(record, ["html_url", "htmlUrl", "url"]));
+}
+function summarizeListPayload(key, items) {
+    if (!items.length) {
+        const noun = getCollectionNoun(key);
+        return `Retrieved 0 ${noun.plural}.`;
+    }
+    const label = key === "repos" ? "repositories" : key;
+    const noun = getCollectionNoun(label);
+    const lines = [`Retrieved ${items.length} ${pluralize(items.length, noun.singular, noun.plural)}${label === "repositories" ? " in this page" : ""}.`];
+    const visibilityCounts = {
+        private: 0,
+        public: 0,
+        internal: 0,
+    };
+    for (const item of items) {
+        const record = asRecord(item);
+        if (!record) {
+            continue;
+        }
+        const visibility = getNestedScalar(record, ["visibility"]);
+        if (visibility === "private" || record.private === true) {
+            visibilityCounts.private += 1;
+            continue;
+        }
+        if (visibility === "internal") {
+            visibilityCounts.internal += 1;
+            continue;
+        }
+        if (visibility === "public" || record.private === false) {
+            visibilityCounts.public += 1;
+        }
+    }
+    const visibilitySummary = formatCountBreakdown([
+        visibilityCounts.private > 0 ? `${visibilityCounts.private} private` : undefined,
+        visibilityCounts.public > 0 ? `${visibilityCounts.public} public` : undefined,
+        visibilityCounts.internal > 0 ? `${visibilityCounts.internal} internal` : undefined,
+    ]);
+    if (visibilitySummary) {
+        lines.push(`Visibility in this page: ${visibilitySummary}.`);
+    }
+    const samples = [];
+    for (const item of items) {
+        pushUnique(samples, extractListLabel(item));
+        if (samples.length >= 5) {
+            break;
+        }
+    }
+    if (samples.length > 0) {
+        lines.push(`Sample: ${samples.join(", ")}.`);
+    }
+    if (label === "repositories" && items.length >= 25) {
+        lines.push("This may be one page of a larger paginated result set.");
+    }
+    return truncate(lines.join("\n"));
+}
+function summarizeGithubUser(record) {
+    const login = getNestedScalar(record, ["login"]);
+    if (!login) {
+        return undefined;
+    }
+    const name = getNestedScalar(record, ["name"]);
+    const publicRepos = getNestedNumber(record, ["public_repos"]);
+    const privateRepos = getNestedNumber(record, ["total_private_repos"]) ??
+        getNestedNumber(record, ["owned_private_repos"]);
+    const followers = getNestedNumber(record, ["followers"]);
+    const lines = [`GitHub user ${login}${name && name !== login ? ` (${name})` : ""}.`];
+    const repoSummary = formatCountBreakdown([
+        publicRepos !== undefined ? `${publicRepos} public repos` : undefined,
+        privateRepos !== undefined ? `${privateRepos} private repos reported on the profile` : undefined,
+    ]);
+    if (repoSummary) {
+        lines.push(`Profile counts: ${repoSummary}.`);
+    }
+    if (followers !== undefined) {
+        lines.push(`Followers: ${followers}.`);
+    }
+    return truncate(lines.join("\n"));
+}
+function summarizeEntityPayload(record) {
+    const title = getNestedScalar(record, ["full_name", "fullName"]) ??
+        getNestedScalar(record, ["title", "name", "slug", "login"]);
+    if (!title) {
+        return undefined;
+    }
+    const status = getNestedScalar(record, ["status"]);
+    const lines = [title];
+    if (status && !isLowSignalSummary(status)) {
+        lines.push(`Status: ${status}.`);
+    }
+    return truncate(lines.join("\n"));
+}
+function summarizeStructuredPayload(record) {
+    for (const key of COLLECTION_KEYS) {
+        const items = getRecordField(record, key);
+        if (Array.isArray(items)) {
+            return summarizeListPayload(key, items);
+        }
+    }
+    return summarizeGithubUser(record) ?? summarizeEntityPayload(record);
+}
+function findPreferredScalarSummary(record, allowLowSignal) {
+    const keysToCheck = ["message", "result", "summary", "text", "content", "status"];
+    for (const key of keysToCheck) {
+        const summary = summarizeScalar(record[key]);
+        if (!summary) {
+            continue;
+        }
+        if (!allowLowSignal && isLowSignalSummary(summary)) {
+            continue;
+        }
+        return summary;
+    }
+    return undefined;
+}
+function formatConnectedAccount(account) {
+    const record = asRecord(account) ?? {};
+    const toolkitRecord = asRecord(getRecordField(record, "toolkit"));
+    const authConfigRecord = asRecord(getRecordField(record, "authConfig", "auth_config"));
+    const toolkit = getNestedScalar(toolkitRecord ?? {}, ["slug"]) ?? getNestedScalar(record, ["toolkitSlug", "toolkit_slug"]) ?? "unknown";
+    const id = getNestedScalar(record, ["id"]) ?? "unknown";
+    const status = getNestedScalar(record, ["status"]) ?? "UNKNOWN";
+    const authConfig = getNestedScalar(authConfigRecord ?? {}, ["id"]);
+    const statusReason = getNestedScalar(record, ["statusReason", "status_reason"]);
+    const urls = getBestConnectionUrls(record, 2);
+    const lines = [`- ${toolkit} account ${id} [status=${status}${authConfig ? `, authConfig=${authConfig}` : ""}]`];
+    if (statusReason && status !== "ACTIVE") {
+        lines.push(`  reason: ${statusReason}`);
+    }
+    if (status !== "ACTIVE" && urls.length > 0) {
+        for (const entry of urls) {
+            lines.push(`  open: ${entry.url}`);
+        }
+    }
+    else if (PENDING_CONNECTION_STATUSES.has(status)) {
+        lines.push("  action: finish the auth flow, then rerun the request.");
+    }
+    return lines.join("\n");
+}
+export function formatExecutionPayload(data, fallback) {
+    const connectionSummary = formatConnectionSignalSummary(data);
+    if (connectionSummary) {
+        return connectionSummary;
+    }
+    if (Array.isArray(data)) {
+        return summarizeListPayload("items", data) ?? truncate(safeJsonStringify(data));
+    }
+    if (data && typeof data === "object") {
+        const record = data;
+        const preferredScalar = findPreferredScalarSummary(record, false);
+        if (preferredScalar) {
+            return truncate(preferredScalar);
+        }
+        const structuredSummary = summarizeStructuredPayload(record);
+        if (structuredSummary) {
+            return structuredSummary;
+        }
+        const fallbackScalar = findPreferredScalarSummary(record, true);
+        if (fallbackScalar) {
+            return truncate(fallbackScalar);
+        }
+        return truncate(safeJsonStringify(data));
+    }
+    const scalar = summarizeScalar(data);
+    if (scalar) {
+        return truncate(scalar);
+    }
+    return truncate(fallback ?? safeJsonStringify(data));
+}
+export function formatExecuteResult(result) {
+    if (!result.successful) {
+        return `Composio tool failed: ${result.error ?? "Unknown error"}`;
+    }
+    return formatExecutionPayload(result.data, "Composio tool completed successfully.");
+}
+export function formatToolkitList(toolkits) {
+    if (!toolkits.items.length) {
+        return "No Composio toolkits matched the current filters.";
+    }
+    return toolkits.items
+        .map((toolkit) => {
+        const status = getToolkitConnectionStatus(toolkit);
+        return `- ${toolkit.slug} (${status})${toolkit.name ? ` - ${toolkit.name}` : ""}`;
+    })
+        .join("\n");
+}
+export function formatRawToolList(items) {
+    if (!items.length) {
+        return "No Composio tools matched the current filters.";
+    }
+    return items
+        .map((tool) => {
+        const toolkit = tool.toolkit?.slug ?? "unknown";
+        const description = tool.description?.trim() || "No description available.";
+        return `- ${tool.slug} [${toolkit}] - ${description}`;
+    })
+        .join("\n");
+}
+export function formatSearchResults(result) {
+    if (!result.results.length) {
+        return result.error ? `No Composio search results: ${result.error}` : "No Composio search results found.";
+    }
+    return result.results
+        .map((entry) => {
+        const tools = entry.primaryToolSlugs.join(", ");
+        const toolkitLabel = entry.toolkits.join(", ");
+        return `- ${entry.useCase}\n  Toolkits: ${toolkitLabel}\n  Primary tools: ${tools}`;
+    })
+        .join("\n");
+}
+export function formatConnectedAccounts(accounts) {
+    if (!accounts.items.length) {
+        return "No connected accounts found for the current user.";
+    }
+    return accounts.items.map((account) => formatConnectedAccount(account)).join("\n");
+}
+export function formatConnectResult(result) {
+    const headerParts = [
+        `Composio connection ${result.action === "already_connected" ? "is already active" : result.action}.`,
+        result.toolkit ? `Toolkit: ${result.toolkit}.` : undefined,
+        `Account: ${result.accountId}.`,
+        `Status: ${result.status}.`,
+    ];
+    const lines = [headerParts.filter(Boolean).join(" ")];
+    if (result.redirectUrl) {
+        lines.push("Open this URL in your browser to finish authentication:");
+        lines.push(result.redirectUrl);
+        lines.push("After approving access, rerun the request.");
+    }
+    else if (result.action === "already_connected") {
+        lines.push("The connected account is already active and ready to use.");
+    }
+    else {
+        lines.push("No auth URL was returned. Run composio_accounts again in a few seconds.");
+    }
+    return truncate(lines.join("\n"));
+}
+export function stableStringify(value) {
+    if (value === null || typeof value !== "object") {
+        return safeJsonStringify(value);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+    }
+    const record = value;
+    const keys = Object.keys(record).sort();
+    return `{${keys.map((key) => `${safeJsonStringify(key)}:${stableStringify(record[key])}`).join(",")}}`;
+}
+export function uniqueStrings(values) {
+    if (!values) {
+        return [];
+    }
+    return [...new Set(values.filter((value) => value.trim().length > 0))];
+}
+//# sourceMappingURL=helpers.js.map