@copado/agentia-cli 0.6.0-alpha.0 → 0.7.0-alpha.0

package/dist/lib/environment-types.d.ts

@@ -0,0 +1,84 @@
+export declare const ENVIRONMENT_TYPES: readonly ["Production/Developer", "Sandbox", "Scratch Org", "Custom Domain"];
+export type EnvironmentType = (typeof ENVIRONMENT_TYPES)[number];
+export declare const DEFAULT_ENVIRONMENT_PLATFORM = "SFDX";
+export declare const DEFAULT_ENVIRONMENT_TYPE: EnvironmentType;
+export type EnvironmentCredential = {
+    createdBy?: string;
+    createdDate?: string;
+    customDomain?: null | string;
+    defaultCredential?: boolean;
+    environment?: string;
+    environmentName?: string;
+    id: string;
+    lastIndexRefreshDate?: null | string;
+    lastModifiedBy?: string;
+    lastModifiedDate?: string;
+    lastValidationDate?: string;
+    name?: string;
+    orgId?: string;
+    orgType?: string;
+    signature?: string;
+    username?: string;
+};
+export type Environment = {
+    apexTestLevel?: string;
+    createdBy?: string;
+    createdDate?: string;
+    credentials?: EnvironmentCredential[];
+    enableRollback?: boolean;
+    environmentVariables?: unknown[];
+    featureFlags?: Record<string, boolean>;
+    findAndReplaceRules?: unknown[];
+    id: null | string;
+    indexBackPromotionMetadata?: boolean;
+    lastModifiedBy?: string;
+    lastModifiedDate?: string;
+    lastRefreshDate?: string;
+    name: null | string;
+    namespace?: string;
+    orgId?: string;
+    platform: null | string;
+    promotionDefaultCredential?: string;
+    runLocalTests?: boolean;
+    runSpecifiedTests?: string;
+    systemProperties?: unknown[];
+    type: null | string;
+    validationPromotionDefaultCredential?: string;
+};
+export type EnvironmentsResponse = {
+    currentPage: number;
+    data: Environment[];
+    pageSize: number;
+    totalPages: number;
+    totalRecords: number;
+};
+export type EnvironmentMutationPayload = {
+    apexTestLevel?: string;
+    enableRollback?: boolean;
+    indexBackPromotionMetadata?: boolean;
+    name?: string;
+    namespace?: string;
+    platform?: string;
+    promotionDefaultCredential?: string;
+    runLocalTests?: boolean;
+    runSpecifiedTests?: string;
+    type?: string;
+    validationPromotionDefaultCredential?: string;
+};
+export declare function environmentEndpoint(id: string): string;
+export declare function environmentCredentialAuthUrlEndpoint(environmentId: string, credentialId: string, redirectUrl: string): string;
+export declare function environmentCredentialValidateEndpoint(environmentId: string, credentialId: string): string;
+export type EnvironmentCredentialValidation = {
+    message?: string;
+    validated: boolean;
+};
+export type EnvironmentAuthStatusFormatterOptions = {
+    colorize?: (color: string, text: string) => string;
+};
+export declare function formatEnvironmentAuthStatus(result: {
+    credentialId: string;
+    credentialName: string;
+    message?: string;
+    validated: boolean;
+}, options?: EnvironmentAuthStatusFormatterOptions): string;
+export declare function formatEnvironmentDetail(environment: Environment): string;

package/dist/lib/environment-types.js

@@ -0,0 +1,52 @@
+import { cellValue } from './format.js';
+export const ENVIRONMENT_TYPES = ['Production/Developer', 'Sandbox', 'Scratch Org', 'Custom Domain'];
+export const DEFAULT_ENVIRONMENT_PLATFORM = 'SFDX';
+export const DEFAULT_ENVIRONMENT_TYPE = 'Production/Developer';
+export function environmentEndpoint(id) {
+    return `/corpus/environments/${id}`;
+}
+export function environmentCredentialAuthUrlEndpoint(environmentId, credentialId, redirectUrl) {
+    const endpoint = `/corpus/environments/${environmentId}/credentials/${credentialId}/auth-url`;
+    return `${endpoint}?redirectUrl=${encodeURIComponent(redirectUrl)}`;
+}
+export function environmentCredentialValidateEndpoint(environmentId, credentialId) {
+    return `/corpus/environments/${environmentId}/credentials/${credentialId}/validate`;
+}
+export function formatEnvironmentAuthStatus(result, options = {}) {
+    const colorize = options.colorize ?? ((_, text) => text);
+    const status = result.validated ? 'valid' : 'invalid';
+    const statusColor = result.validated ? 'green' : 'red';
+    const lines = [
+        `Credential ID: ${result.credentialId}`,
+        `Credential Name: ${result.credentialName}`,
+        `Status: ${colorize(statusColor, status)}`,
+    ];
+    if (typeof result.message === 'string' && result.message.trim().length > 0) {
+        lines.push(`Message: ${result.message}`);
+    }
+    return lines.join('\n');
+}
+export function formatEnvironmentDetail(environment) {
+    const lines = [
+        `ID: ${cellValue(environment.id)}`,
+        `Name: ${cellValue(environment.name)}`,
+        `Type: ${cellValue(environment.type)}`,
+        `Platform: ${cellValue(environment.platform)}`,
+        `Org ID: ${cellValue(environment.orgId)}`,
+        `Namespace: ${cellValue(environment.namespace)}`,
+        `Apex Test Level: ${cellValue(environment.apexTestLevel)}`,
+        `Run Local Tests: ${cellValue(environment.runLocalTests)}`,
+        `Run Specified Tests: ${cellValue(environment.runSpecifiedTests)}`,
+        `Promotion Default Credential: ${cellValue(environment.promotionDefaultCredential)}`,
+        `Validation Promotion Default Credential: ${cellValue(environment.validationPromotionDefaultCredential)}`,
+        `Index Back Promotion Metadata: ${cellValue(environment.indexBackPromotionMetadata)}`,
+        `Enable Rollback: ${cellValue(environment.enableRollback)}`,
+        `Created By: ${cellValue(environment.createdBy)}`,
+        `Created Date: ${cellValue(environment.createdDate)}`,
+        `Last Modified By: ${cellValue(environment.lastModifiedBy)}`,
+        `Last Modified Date: ${cellValue(environment.lastModifiedDate)}`,
+        `Last Refresh Date: ${cellValue(environment.lastRefreshDate)}`,
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=environment-types.js.map

package/dist/lib/environment-types.js.map

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

package/dist/lib/format.d.ts

@@ -0,0 +1,5 @@
+export declare function cellValue(value: unknown): string;
+export declare function table(headers: Array<{
+    alias: string;
+    value: string;
+}>, rows: Array<Record<string, unknown>>): string;

package/dist/lib/format.js

@@ -0,0 +1,8 @@
+import createTtyTable from 'tty-table';
+export function cellValue(value) {
+    return value === null || value === undefined ? '' : String(value);
+}
+export function table(headers, rows) {
+    return createTtyTable(headers, rows).render();
+}
+//# sourceMappingURL=format.js.map

package/dist/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/lib/format.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,WAAW,CAAA;AAEtC,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACnE,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAA8C,EAAE,IAAoC;IACxG,OAAO,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,EAAE,CAAA;AAC/C,CAAC"}

package/dist/lib/job-types.d.ts

@@ -0,0 +1,85 @@
+export declare const JOB_LIST_LIMIT_MAX = 200;
+export declare const JOB_LIST_LIMIT_MIN = 1;
+export type JobTemplate = {
+    id?: null | string;
+    name?: null | string;
+};
+export type JobStepResult = {
+    errorMessage?: null | string;
+    id?: null | string;
+    name?: null | string;
+    progressStatus?: null | string;
+    status?: null | string;
+};
+export type JobStep = {
+    customType?: null | string;
+    id?: null | string;
+    name?: null | string;
+    order?: null | number;
+    result?: JobStepResult | null;
+    resultId?: null | string;
+    status?: null | string;
+    type?: null | string;
+};
+export type Job = {
+    context?: null | string;
+    createdDate?: null | string;
+    dataJson?: null | string;
+    errorMessage?: null | string;
+    id?: null | string;
+    lastModifiedDate?: null | string;
+    name?: null | string;
+    parentId?: null | string;
+    status?: null | string;
+    steps?: JobStep[];
+    template?: JobTemplate | null;
+};
+export type JobListPage = {
+    currentPage?: number;
+    data?: Job[];
+    pageSize?: number;
+    totalPages?: number;
+    totalRecords?: number;
+};
+export type JobListResponse = {
+    data?: JobListPage;
+    message?: string;
+    status?: string;
+};
+export type JobResponse = {
+    data?: Job;
+    message?: string;
+    status?: string;
+};
+export type JobOperationResult = {
+    jobId?: null | string;
+    message?: null | string;
+    operation?: null | string;
+    status?: null | string;
+};
+export type JobOperationResponse = {
+    data?: JobOperationResult;
+    message?: string;
+    status?: string;
+};
+export type JobListFilters = {
+    context?: string;
+    id?: string;
+    limit?: number;
+    name?: string;
+    parent?: string;
+    status?: string;
+    type?: string;
+};
+export declare function jobListEndpoint(filters?: JobListFilters): string;
+export declare function jobEndpoint(jobId: string): string;
+export declare function jobRunEndpoint(jobId: string, restart?: boolean): string;
+export declare function jobResumeEndpoint(jobId: string): string;
+export declare function jobKillEndpoint(jobId: string): string;
+export declare function jobPauseEndpoint(jobId: string): string;
+export declare function normalizeJobs(response: Job[] | JobListPage | JobListResponse): Job[];
+export declare function normalizeJob(response: Job | JobResponse): Job;
+export declare function normalizeJobOperation(response: JobOperationResponse | JobOperationResult): JobOperationResult;
+export declare function formatJobTable(jobs: Job[]): string;
+export declare function formatJobDetail(job: Job): string;
+export declare function formatJobOperationResult(result: JobOperationResult): string;

package/dist/lib/job-types.js

@@ -0,0 +1,115 @@
+import { cellValue, table } from './format.js';
+export const JOB_LIST_LIMIT_MAX = 200;
+export const JOB_LIST_LIMIT_MIN = 1;
+export function jobListEndpoint(filters = {}) {
+    const params = new URLSearchParams();
+    if (filters.id) {
+        params.set('id', filters.id);
+    }
+    if (filters.name) {
+        params.set('name', filters.name);
+    }
+    if (filters.type) {
+        params.set('type', filters.type);
+    }
+    if (filters.status) {
+        params.set('status', filters.status);
+    }
+    if (filters.context) {
+        params.set('context', filters.context);
+    }
+    if (filters.parent) {
+        params.set('parent', filters.parent);
+    }
+    if (filters.limit !== undefined) {
+        params.set('limit', String(filters.limit));
+    }
+    const query = params.toString();
+    return query.length > 0 ? `/release/job?${query}` : '/release/job';
+}
+export function jobEndpoint(jobId) {
+    return `/release/job/${jobId}`;
+}
+export function jobRunEndpoint(jobId, restart) {
+    if (restart) {
+        return `/release/job/${jobId}/run?restart=true`;
+    }
+    return `/release/job/${jobId}/run`;
+}
+export function jobResumeEndpoint(jobId) {
+    return `/release/job/${jobId}/resume`;
+}
+export function jobKillEndpoint(jobId) {
+    return `/release/job/${jobId}/kill`;
+}
+export function jobPauseEndpoint(jobId) {
+    return `/release/job/${jobId}/pause`;
+}
+export function normalizeJobs(response) {
+    if (Array.isArray(response)) {
+        return response;
+    }
+    if (Array.isArray(response.data)) {
+        return response.data;
+    }
+    if (response.data && typeof response.data === 'object' && Array.isArray(response.data.data)) {
+        return response.data.data;
+    }
+    return [];
+}
+export function normalizeJob(response) {
+    if ('data' in response && response.data !== undefined && typeof response.data === 'object' && !Array.isArray(response.data)) {
+        return response.data;
+    }
+    return response;
+}
+export function normalizeJobOperation(response) {
+    if ('data' in response && response.data !== undefined && typeof response.data === 'object' && !Array.isArray(response.data)) {
+        return response.data;
+    }
+    return response;
+}
+export function formatJobTable(jobs) {
+    return table([
+        { alias: 'ID', value: 'id' },
+        { alias: 'NAME', value: 'name' },
+        { alias: 'STATUS', value: 'status' },
+        { alias: 'TEMPLATE', value: 'template' },
+        { alias: 'PARENT ID', value: 'parentId' },
+        { alias: 'CREATED', value: 'createdDate' },
+    ], jobs.map((job) => ({
+        createdDate: cellValue(job.createdDate),
+        id: cellValue(job.id),
+        name: cellValue(job.name),
+        parentId: cellValue(job.parentId),
+        status: cellValue(job.status),
+        template: cellValue(job.template?.name),
+    })));
+}
+export function formatJobDetail(job) {
+    const lines = [
+        `ID: ${cellValue(job.id)}`,
+        `Name: ${cellValue(job.name)}`,
+        `Status: ${cellValue(job.status)}`,
+        `Template ID: ${cellValue(job.template?.id)}`,
+        `Template Name: ${cellValue(job.template?.name)}`,
+        `Parent ID: ${cellValue(job.parentId)}`,
+        `Created: ${cellValue(job.createdDate)}`,
+        `Last Modified: ${cellValue(job.lastModifiedDate)}`,
+        `Error: ${cellValue(job.errorMessage)}`,
+        `Steps: ${cellValue(job.steps?.length ?? 0)}`,
+    ];
+    for (const step of job.steps ?? []) {
+        lines.push(`  Step ${cellValue(step.order)}: ${cellValue(step.name)} [${cellValue(step.status)}] type=${cellValue(step.type)} result=${cellValue(step.result?.status)}`);
+    }
+    return lines.join('\n');
+}
+export function formatJobOperationResult(result) {
+    return [
+        `Job ID: ${cellValue(result.jobId)}`,
+        `Operation: ${cellValue(result.operation)}`,
+        `Status: ${cellValue(result.status)}`,
+        `Message: ${cellValue(result.message)}`,
+    ].join('\n');
+}
+//# sourceMappingURL=job-types.js.map

package/dist/lib/job-types.js.map

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

package/dist/lib/loopback-callback-server.d.ts

@@ -0,0 +1,35 @@
+import { createServer } from 'node:http';
+export declare const DEFAULT_CALLBACK_PATH = "/callback";
+export declare const DEFAULT_PORT_START = 8080;
+export declare const DEFAULT_PORT_END = 8090;
+export type LoopbackCallbackResult = {
+    errorCode?: string;
+    errorDescription?: string;
+    ok: boolean;
+};
+export type LoopbackCallbackServerOptions = {
+    callbackPath?: string;
+    checkPortAvailable?: (port: number, host: string) => Promise<boolean>;
+    createServerImpl?: typeof createServer;
+    host?: string;
+    port?: number;
+    portEnd?: number;
+    portStart?: number;
+};
+export type LoopbackCallbackServer = {
+    callbackUrl: string;
+    close(): Promise<void>;
+    port: number;
+    waitForCallback(options: {
+        timeoutMs: number;
+    }): Promise<LoopbackCallbackResult>;
+};
+export declare function defaultCheckPortAvailable(port: number, host: string): Promise<boolean>;
+export declare function findAvailablePort(options: {
+    checkPortAvailable?: (port: number, host: string) => Promise<boolean>;
+    host: string;
+    port?: number;
+    portEnd?: number;
+    portStart?: number;
+}): Promise<null | number>;
+export declare function createLoopbackCallbackServer(options?: LoopbackCallbackServerOptions): Promise<LoopbackCallbackServer | null>;

package/dist/lib/loopback-callback-server.js

@@ -0,0 +1,162 @@
+import { createServer } from 'node:http';
+import { createConnection } from 'node:net';
+export const DEFAULT_CALLBACK_PATH = '/callback';
+export const DEFAULT_PORT_START = 8080;
+export const DEFAULT_PORT_END = 8090;
+function parseCallbackResult(req, callbackPath) {
+    const url = new URL(req.url ?? '/', 'http://127.0.0.1');
+    if (url.pathname !== callbackPath) {
+        return null;
+    }
+    const errorCode = url.searchParams.get('errorCode');
+    if (errorCode) {
+        return {
+            errorCode,
+            errorDescription: url.searchParams.get('errorDescription') ?? '',
+            ok: false,
+        };
+    }
+    const status = url.searchParams.get('status');
+    if (status === 'error') {
+        const reason = url.searchParams.get('reason') ?? 'Authentication failed';
+        return {
+            errorCode: reason,
+            errorDescription: reason,
+            ok: false,
+        };
+    }
+    return { ok: true };
+}
+function successHtml() {
+    return `<!DOCTYPE html>
+<html><body style="font-family:sans-serif;text-align:center;padding:50px;">
+  <h2 style="color:#2e7d32;">&#10004; Authentication Successful</h2>
+  <p>You can safely close this browser window and return to your terminal.</p>
+</body></html>`;
+}
+function errorHtml(errorCode, errorDescription) {
+    const safeCode = escapeHtml(errorCode);
+    const safeDescription = escapeHtml(errorDescription || errorCode);
+    return `<!DOCTYPE html>
+<html><body style="font-family:sans-serif;text-align:center;padding:50px;">
+  <h2 style="color:#c62828;">Authentication Failed</h2>
+  <p><strong>${safeCode}</strong></p>
+  <p>${safeDescription}</p>
+  <p>You can close this window and check your terminal for details.</p>
+</body></html>`;
+}
+function escapeHtml(text) {
+    return text
+        .replaceAll('&', '&amp;')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;');
+}
+function respondNotFound(res) {
+    res.writeHead(404, { 'Content-Type': 'text/plain' });
+    res.end('Not Found');
+}
+function respondHtml(res, status, body) {
+    res.writeHead(status, { 'Content-Type': 'text/html; charset=utf-8' });
+    res.end(body);
+}
+export function defaultCheckPortAvailable(port, host) {
+    return new Promise((resolve) => {
+        const socket = createConnection({ host, port });
+        socket.once('connect', () => {
+            socket.destroy();
+            resolve(false);
+        });
+        socket.once('error', () => {
+            socket.destroy();
+            resolve(true);
+        });
+    });
+}
+export async function findAvailablePort(options) {
+    const { host } = options;
+    const check = options.checkPortAvailable ?? defaultCheckPortAvailable;
+    if (options.port !== undefined) {
+        return (await check(options.port, host)) ? options.port : null;
+    }
+    const start = options.portStart ?? DEFAULT_PORT_START;
+    const end = options.portEnd ?? DEFAULT_PORT_END;
+    for (let port = start; port <= end; port++) {
+        // Sequential probing is intentional: stop at the first available port.
+        // eslint-disable-next-line no-await-in-loop
+        if (await check(port, host)) {
+            return port;
+        }
+    }
+    return null;
+}
+export async function createLoopbackCallbackServer(options) {
+    const host = options?.host ?? '127.0.0.1';
+    const callbackPath = options?.callbackPath ?? DEFAULT_CALLBACK_PATH;
+    const createSrv = options?.createServerImpl ?? createServer;
+    const port = await findAvailablePort({
+        checkPortAvailable: options?.checkPortAvailable,
+        host,
+        port: options?.port,
+        portEnd: options?.portEnd,
+        portStart: options?.portStart,
+    });
+    if (port === null) {
+        return null;
+    }
+    const callbackUrl = `http://localhost:${port}${callbackPath}`;
+    let resolveWait = null;
+    let settled = false;
+    const server = createSrv((req, res) => {
+        const parsed = parseCallbackResult(req, callbackPath);
+        if (!parsed) {
+            respondNotFound(res);
+            return;
+        }
+        if (parsed.ok) {
+            respondHtml(res, 200, successHtml());
+        }
+        else {
+            respondHtml(res, 200, errorHtml(parsed.errorCode ?? '', parsed.errorDescription ?? ''));
+        }
+        if (!settled && resolveWait) {
+            settled = true;
+            resolveWait(parsed);
+        }
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(port, host, () => resolve());
+    });
+    return {
+        callbackUrl,
+        close() {
+            return new Promise((resolve, reject) => {
+                server.close((error) => (error ? reject(error) : resolve()));
+            });
+        },
+        port,
+        waitForCallback({ timeoutMs }) {
+            return new Promise((resolve, reject) => {
+                if (settled) {
+                    reject(new Error('Callback already received'));
+                    return;
+                }
+                const timer = setTimeout(() => {
+                    if (!settled) {
+                        settled = true;
+                        resolveWait = null;
+                        const error = new Error('Authentication timed out');
+                        error.code = 'ETIMEDOUT';
+                        reject(error);
+                    }
+                }, timeoutMs);
+                resolveWait = (result) => {
+                    clearTimeout(timer);
+                    resolve(result);
+                };
+            });
+        },
+    };
+}
+//# sourceMappingURL=loopback-callback-server.js.map

package/dist/lib/loopback-callback-server.js.map

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

package/dist/lib/mcp/redaction.d.ts

@@ -0,0 +1,2 @@
+export declare function redactSecrets<T>(value: T): T;
+export declare function redactErrorMessage(error: unknown): string;

package/dist/lib/mcp/redaction.js

@@ -0,0 +1,24 @@
+const REDACTED = '[REDACTED]';
+const SENSITIVE_KEY_PATTERN = /(access.?token|refresh.?token|session.?id|api.?key|apikey|password|secret|authorization|bearer)/i;
+const BEARER_VALUE_PATTERN = /Bearer\s+[\w.~+/=-]+/gi;
+export function redactSecrets(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => redactSecrets(item));
+    }
+    if (value && typeof value === 'object') {
+        const result = {};
+        for (const [key, nested] of Object.entries(value)) {
+            result[key] = SENSITIVE_KEY_PATTERN.test(key) ? REDACTED : redactSecrets(nested);
+        }
+        return result;
+    }
+    if (typeof value === 'string') {
+        return value.replaceAll(BEARER_VALUE_PATTERN, `Bearer ${REDACTED}`);
+    }
+    return value;
+}
+export function redactErrorMessage(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return redactSecrets(message);
+}
+//# sourceMappingURL=redaction.js.map

package/dist/lib/mcp/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../../src/lib/mcp/redaction.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,YAAY,CAAA;AAE7B,MAAM,qBAAqB,GACzB,kGAAkG,CAAA;AACpG,MAAM,oBAAoB,GAAG,wBAAwB,CAAA;AAErD,MAAM,UAAU,aAAa,CAAI,KAAQ;IACvC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAiB,CAAA;IACjE,CAAC;IAED,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,MAAM,GAA4B,EAAE,CAAA;QAE1C,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YAC7E,MAAM,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAA;QAClF,CAAC;QAED,OAAO,MAAW,CAAA;IACpB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,UAAU,CAAC,oBAAoB,EAAE,UAAU,QAAQ,EAAE,CAAiB,CAAA;IACrF,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACtE,OAAO,aAAa,CAAC,OAAO,CAAC,CAAA;AAC/B,CAAC"}

package/dist/lib/mcp/result.d.ts

@@ -0,0 +1,37 @@
+export declare function toolResult(data: Record<string, unknown>): {
+    content: {
+        text: string;
+        type: "text";
+    }[];
+    structuredContent: Record<string, unknown>;
+};
+export declare function toolError(error: unknown): {
+    content: {
+        text: string;
+        type: "text";
+    }[];
+    isError: boolean;
+    structuredContent: {
+        error: {
+            message: string;
+        };
+    };
+};
+export declare function safelyHandleTool(handler: () => Promise<Record<string, unknown>>): Promise<{
+    content: {
+        text: string;
+        type: "text";
+    }[];
+    structuredContent: Record<string, unknown>;
+} | {
+    content: {
+        text: string;
+        type: "text";
+    }[];
+    isError: boolean;
+    structuredContent: {
+        error: {
+            message: string;
+        };
+    };
+}>;