tru-mcp 0.1.0

package/dist/tools/check_identity.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { checkIdentity } from "../api-client.js";
+export const checkIdentityTool = {
+    name: "check_identity",
+    description: "Check if a user has a verified tru identity. Returns verification status without requiring user approval.",
+    inputSchema: {
+        email: z.string().describe("Email address of the user to check"),
+    },
+    handler: async (args) => {
+        try {
+            const result = await checkIdentity(args.email);
+            if (!result.verified) {
+                const reason = result.reason === "user_not_found"
+                    ? "No tru account found for this email. The user needs to sign up at tru first."
+                    : result.reason === "not_verified"
+                        ? "This user has a tru account but has not completed identity verification."
+                        : result.reason === "no_vault"
+                            ? "This user is verified but their credential vault is not yet populated."
+                            : `Identity not verified (reason: ${result.reason}).`;
+                return {
+                    content: [{ type: "text", text: `Not verified: ${reason}` }],
+                };
+            }
+            const lines = [
+                `Verified: Yes`,
+                `Name: ${result.name}`,
+                `Email: ${result.email}`,
+                `Identity verified: ${result.identity_verified ? "Yes" : "No"}`,
+                `Bank account linked: ${result.bank_linked ? "Yes" : "No"}`,
+                `Vault status: ${result.vault_status}`,
+            ];
+            if (result.risk) {
+                lines.push(`Risk level: ${result.risk.level}`);
+                if (result.risk.score !== null)
+                    lines.push(`Risk score: ${result.risk.score}/99`);
+                if (result.risk.card_funding)
+                    lines.push(`Card type: ${result.risk.card_funding}`);
+                if (result.risk.card_country)
+                    lines.push(`Card country: ${result.risk.card_country}`);
+                if (result.risk.fingerprint_reuse)
+                    lines.push(`Warning: Card fingerprint seen on another account`);
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [{ type: "text", text: `Error checking identity: ${message}` }],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=check_identity.js.map

package/dist/tools/check_identity.js.map

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

package/dist/tools/check_request_status.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export declare const checkRequestStatusTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        request_id: z.ZodString;
+    };
+    handler: (args: {
+        request_id: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};

package/dist/tools/check_request_status.js

@@ -0,0 +1,87 @@
+import { z } from "zod";
+import { getRequestStatus } from "../api-client.js";
+export const checkRequestStatusTool = {
+    name: "check_request_status",
+    description: "Check the status of a credential sharing request. Returns 'pending', 'approved', or 'rejected'. If approved, returns the requested credential data.",
+    inputSchema: {
+        request_id: z.string().describe("The credential request ID to check"),
+    },
+    handler: async (args) => {
+        try {
+            const request = await getRequestStatus(args.request_id);
+            if (request.status === "pending") {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: [
+                                `Status: pending`,
+                                ``,
+                                `Request ID: ${request.id}`,
+                                `User: ${request.user_email}`,
+                                `Service: ${request.requesting_service}`,
+                                `Fields: ${request.requested_fields.join(", ")}`,
+                                ``,
+                                `The user has not yet responded. Check again later.`,
+                            ].join("\n"),
+                        },
+                    ],
+                };
+            }
+            if (request.status === "rejected") {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: [
+                                `Status: rejected`,
+                                ``,
+                                `Request ID: ${request.id}`,
+                                `User: ${request.user_email}`,
+                                `Service: ${request.requesting_service}`,
+                                ``,
+                                `The user declined to share their credentials with ${request.requesting_service}.`,
+                            ].join("\n"),
+                        },
+                    ],
+                };
+            }
+            // Approved — include vault data
+            const lines = [
+                `Status: approved`,
+                ``,
+                `Request ID: ${request.id}`,
+                `User: ${request.user_email}`,
+                `Service: ${request.requesting_service}`,
+                ``,
+                `Shared credential data:`,
+            ];
+            if (request.vault_data) {
+                for (const [key, value] of Object.entries(request.vault_data)) {
+                    if (typeof value === "object" && value !== null) {
+                        lines.push(`  ${key}: ${JSON.stringify(value)}`);
+                    }
+                    else {
+                        lines.push(`  ${key}: ${value}`);
+                    }
+                }
+            }
+            else {
+                lines.push("  (No vault data returned)");
+            }
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    { type: "text", text: `Error checking request status: ${message}` },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=check_request_status.js.map

package/dist/tools/check_request_status.js.map

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

package/dist/tools/create_charge.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+export declare const createChargeTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        email: z.ZodString;
+        amount_cents: z.ZodNumber;
+        description: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodEnum<{
+            one_time: "one_time";
+            recurring: "recurring";
+        }>>;
+        interval: z.ZodOptional<z.ZodEnum<{
+            month: "month";
+            year: "year";
+        }>>;
+        currency: z.ZodOptional<z.ZodString>;
+        payment_mode: z.ZodOptional<z.ZodEnum<{
+            direct: "direct";
+            virtual_card: "virtual_card";
+        }>>;
+        action: z.ZodOptional<z.ZodString>;
+    };
+    handler: (args: {
+        email: string;
+        amount_cents: number;
+        description?: string;
+        type?: "one_time" | "recurring";
+        interval?: "month" | "year";
+        currency?: string;
+        payment_mode?: "direct" | "virtual_card";
+        action?: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};

package/dist/tools/create_charge.js

@@ -0,0 +1,135 @@
+import { z } from "zod";
+import { createCharge } from "../api-client.js";
+export const createChargeTool = {
+    name: "create_charge",
+    description: "Create a direct charge or subscription on behalf of a user. " +
+        "Unlike request_virtual_card, this charges the user's payment method directly " +
+        "or creates a recurring subscription. " +
+        "The charge goes through the user's agent rules: auto-approved if within limits, " +
+        "left pending for manual approval if escalated, or auto-rejected if denied. " +
+        "For recurring subscriptions, set type to 'recurring' and specify the interval.",
+    inputSchema: {
+        email: z.string().describe("Email address of the tru user who will be charged"),
+        amount_cents: z
+            .number()
+            .int()
+            .positive()
+            .describe("Amount in cents (e.g. 4999 for $49.99)"),
+        description: z
+            .string()
+            .optional()
+            .describe("What this charge is for (shown to the user)"),
+        type: z
+            .enum(["one_time", "recurring"])
+            .optional()
+            .describe("Charge type: 'one_time' (default) or 'recurring' for subscriptions"),
+        interval: z
+            .enum(["month", "year"])
+            .optional()
+            .describe("Billing interval for recurring charges: 'month' or 'year'"),
+        currency: z
+            .string()
+            .optional()
+            .describe("Currency code (default: 'usd')"),
+        payment_mode: z
+            .enum(["direct", "virtual_card"])
+            .optional()
+            .describe("Payment mode: 'direct' (default) charges the user's card directly, 'virtual_card' issues a virtual card"),
+        action: z
+            .string()
+            .optional()
+            .describe("The action being performed (e.g. 'purchase products', 'create subscription'). Used to evaluate action permission rules."),
+    },
+    handler: async (args) => {
+        try {
+            const result = await createCharge(args.email, args.amount_cents, args.description, args.type, args.interval, args.currency, args.payment_mode, args.action);
+            const amount = (args.amount_cents / 100).toFixed(2);
+            const currencyLabel = (args.currency || "usd").toUpperCase();
+            const chargeType = args.type === "recurring"
+                ? `recurring (${args.interval || "month"})`
+                : "one-time";
+            // Charge was auto-rejected by agent rules
+            if (result.status === "rejected") {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: [
+                                `Denied: The user's agent rules do not allow this charge.`,
+                                `Amount: $${amount} ${currencyLabel} (${chargeType})`,
+                                `Reason: ${result.rule_evaluation?.reason || "Blocked by spending rules"}`,
+                                `Charge request ID: ${result.id}`,
+                            ].join("\n"),
+                        },
+                    ],
+                };
+            }
+            // Charge is pending (escalated or no auto-approve rule matched)
+            if (result.status === "pending") {
+                const escalated = result.rule_evaluation?.action === "escalate";
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: [
+                                escalated
+                                    ? `Escalated: This charge requires user approval.`
+                                    : `Pending: The charge has been created and is awaiting user approval.`,
+                                `Amount: $${amount} ${currencyLabel} (${chargeType})`,
+                                escalated
+                                    ? `Reason: ${result.rule_evaluation?.reason || "Exceeds spending limits"}`
+                                    : null,
+                                `Charge request ID: ${result.id}`,
+                                ``,
+                                `The user needs to approve this in their tru dashboard.`,
+                                `You can poll the status using the check_charge_status tool with this ID.`,
+                            ]
+                                .filter(Boolean)
+                                .join("\n"),
+                        },
+                    ],
+                };
+            }
+            // Charge was auto-approved
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: [
+                            `Charge created successfully.`,
+                            `Amount: $${amount} ${currencyLabel} (${chargeType})`,
+                            `Status: ${result.status}`,
+                            `Charge request ID: ${result.id}`,
+                            result.description ? `Description: ${result.description}` : null,
+                        ]
+                            .filter(Boolean)
+                            .join("\n"),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            if (message.includes("no_payment_method")) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `The user has no payment method on file. They need to add a card in their tru dashboard first.`,
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error creating charge: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=create_charge.js.map

package/dist/tools/create_charge.js.map

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

package/dist/tools/discover_apps.d.ts

@@ -0,0 +1,18 @@
+export declare const discoverAppsTool: {
+    name: string;
+    description: string;
+    inputSchema: {};
+    handler: () => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};

package/dist/tools/discover_apps.js

@@ -0,0 +1,56 @@
+const BASE_URL = process.env.TRU_API_URL || "http://localhost:3000";
+export const discoverAppsTool = {
+    name: "discover_apps",
+    description: "List all apps in the tru directory. Returns active apps with their service names, " +
+        "descriptions, and SKILL.md URLs. Use this to find services an agent can interact with.",
+    inputSchema: {},
+    handler: async () => {
+        try {
+            const res = await fetch(`${BASE_URL}/api/apps/directory`);
+            if (!res.ok) {
+                const body = await res.text();
+                throw new Error(`API error ${res.status}: ${body}`);
+            }
+            const data = (await res.json());
+            if (data.apps.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No apps are currently registered in the tru directory.",
+                        },
+                    ],
+                };
+            }
+            const lines = [
+                `Found ${data.apps.length} app(s) in the tru directory:\n`,
+            ];
+            for (const app of data.apps) {
+                lines.push(`## ${app.display_name} (${app.service_name})`);
+                if (app.description)
+                    lines.push(app.description);
+                if (app.website)
+                    lines.push(`Website: ${app.website}`);
+                lines.push(`SKILL.md: ${app.skill_url}`);
+                lines.push("");
+            }
+            lines.push("Use the read_skill tool with a service_name to learn how to interact with an app.");
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error discovering apps: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=discover_apps.js.map

package/dist/tools/discover_apps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover_apps.js","sourceRoot":"","sources":["../../src/tools/discover_apps.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,uBAAuB,CAAC;AAWpE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,oFAAoF;QACpF,wFAAwF;IAC1F,WAAW,EAAE,EAAE;IACf,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,qBAAqB,CAAC,CAAC;YAE1D,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA6B,CAAC;YAE5D,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,wDAAwD;yBAC/D;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG;gBACZ,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,iCAAiC;aAC3D,CAAC;YAEF,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,YAAY,KAAK,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC;gBAC3D,IAAI,GAAG,CAAC,WAAW;oBAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBACjD,IAAI,GAAG,CAAC,OAAO;oBAAE,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;gBACvD,KAAK,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;YAED,KAAK,CAAC,IAAI,CACR,mFAAmF,CACpF,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;aAC7D,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,2BAA2B,OAAO,EAAE;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/initiate_oauth.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export declare const initiateOAuthTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        service_name: z.ZodString;
+    };
+    handler: (args: {
+        service_name: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};

package/dist/tools/initiate_oauth.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import crypto from "crypto";
+import { lookupAppByServiceName } from "../api-client.js";
+const BASE_URL = process.env.TRU_API_URL || "http://localhost:3000";
+export const initiateOAuthTool = {
+    name: "initiate_oauth",
+    description: "Generate an OAuth authorization URL for a tru-integrated app. " +
+        "Given a service_name, looks up the app and returns the URL the user should open in their browser to authenticate via tru.",
+    inputSchema: {
+        service_name: z
+            .string()
+            .describe("The service_name of the app to initiate OAuth for"),
+    },
+    handler: async (args) => {
+        try {
+            const lookup = await lookupAppByServiceName(args.service_name);
+            if (lookup.status === "not_found" || !lookup.app) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No active app found with service_name "${args.service_name}". Use the discover_apps tool to see available apps.`,
+                        },
+                    ],
+                };
+            }
+            const app = lookup.app;
+            const redirectUri = app.redirect_uris[0];
+            if (!redirectUri) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `The app "${app.display_name}" does not have any redirect URIs configured. The app developer needs to set up a redirect URI before OAuth can be used.`,
+                        },
+                    ],
+                };
+            }
+            const state = crypto.randomUUID();
+            const params = new URLSearchParams({
+                client_id: app.id,
+                redirect_uri: redirectUri,
+                scope: "openid",
+                state,
+            });
+            const authUrl = `${BASE_URL}/oauth/authorize?${params.toString()}`;
+            const lines = [
+                `## OAuth Authorization for ${app.display_name}`,
+                "",
+                `Open this URL in the user's browser:`,
+                "",
+                authUrl,
+                "",
+                "The user will authenticate via tru and be redirected back to the app.",
+                `State parameter: ${state}`,
+            ];
+            return {
+                content: [{ type: "text", text: lines.join("\n") }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error initiating OAuth: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=initiate_oauth.js.map

package/dist/tools/initiate_oauth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initiate_oauth.js","sourceRoot":"","sources":["../../src/tools/initiate_oauth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,uBAAuB,CAAC;AAEpE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,gEAAgE;QAChE,2HAA2H;IAC7H,WAAW,EAAE;QACX,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,CAAC,mDAAmD,CAAC;KACjE;IACD,OAAO,EAAE,KAAK,EAAE,IAA8B,EAAE,EAAE;QAChD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAE/D,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;gBACjD,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,0CAA0C,IAAI,CAAC,YAAY,sDAAsD;yBACxH;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;YACvB,MAAM,WAAW,GAAG,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAEzC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,YAAY,GAAG,CAAC,YAAY,0HAA0H;yBAC7J;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;gBACjC,SAAS,EAAE,GAAG,CAAC,EAAE;gBACjB,YAAY,EAAE,WAAW;gBACzB,KAAK,EAAE,QAAQ;gBACf,KAAK;aACN,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,GAAG,QAAQ,oBAAoB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;YAEnE,MAAM,KAAK,GAAG;gBACZ,8BAA8B,GAAG,CAAC,YAAY,EAAE;gBAChD,EAAE;gBACF,sCAAsC;gBACtC,EAAE;gBACF,OAAO;gBACP,EAAE;gBACF,uEAAuE;gBACvE,oBAAoB,KAAK,EAAE;aAC5B,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;aAC7D,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,2BAA2B,OAAO,EAAE;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/tools/read_skill.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export declare const readSkillTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        service_name: z.ZodString;
+    };
+    handler: (args: {
+        service_name: string;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError?: undefined;
+    } | {
+        content: {
+            type: "text";
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};

package/dist/tools/read_skill.js

@@ -0,0 +1,50 @@
+import { z } from "zod";
+const BASE_URL = process.env.TRU_API_URL || "http://localhost:3000";
+export const readSkillTool = {
+    name: "read_skill",
+    description: "Fetch and return the SKILL.md for a specific app. " +
+        "The SKILL.md describes how an agent should interact with the app's API, " +
+        "including available endpoints, authentication, and usage examples.",
+    inputSchema: {
+        service_name: z
+            .string()
+            .describe("The service_name of the app (e.g. 'clayking')"),
+    },
+    handler: async (args) => {
+        try {
+            const url = `${BASE_URL}/apps/${encodeURIComponent(args.service_name)}/SKILL.md`;
+            const res = await fetch(url);
+            if (res.status === 404) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No app found with service_name "${args.service_name}". Use discover_apps to list available apps.`,
+                        },
+                    ],
+                };
+            }
+            if (!res.ok) {
+                const body = await res.text();
+                throw new Error(`API error ${res.status}: ${body}`);
+            }
+            const markdown = await res.text();
+            return {
+                content: [{ type: "text", text: markdown }],
+            };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error reading SKILL.md: ${message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=read_skill.js.map

package/dist/tools/read_skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read_skill.js","sourceRoot":"","sources":["../../src/tools/read_skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,uBAAuB,CAAC;AAEpE,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,oDAAoD;QACpD,0EAA0E;QAC1E,oEAAoE;IACtE,WAAW,EAAE;QACX,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,CAAC,+CAA+C,CAAC;KAC7D;IACD,OAAO,EAAE,KAAK,EAAE,IAA8B,EAAE,EAAE;QAChD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,GAAG,QAAQ,SAAS,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC;YACjF,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;YAE7B,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,mCAAmC,IAAI,CAAC,YAAY,8CAA8C;yBACzG;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAElC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;aACrD,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,2BAA2B,OAAO,EAAE;qBAC3C;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}