storno-cli 1.0.5

package/dist/tools/recurring-invoices.js

@@ -0,0 +1,305 @@
+import { z } from 'zod';
+import { apiRequest } from '../client.js';
+import { formatResponse, notAuthenticated, noCompanySelected } from '../utils/errors.js';
+import { getConfig } from '../config.js';
+const recurringLineItemSchema = z.object({
+    description: z.string().describe('Line item description'),
+    quantity: z.number().describe('Quantity (must be > 0)'),
+    unitPrice: z.number().describe('Price per unit'),
+    vatRateId: z.string().describe('UUID of the VAT rate'),
+    unitOfMeasure: z.string().optional().describe('Unit of measure code (default: "buc")'),
+    productId: z.string().optional().describe('UUID of linked product'),
+    priceRule: z
+        .enum(['fixed', 'exchange_rate', 'markup'])
+        .optional()
+        .describe('Pricing rule: fixed (default), exchange_rate, or markup'),
+    referenceCurrency: z.string().optional().describe('Reference currency (required if priceRule is exchange_rate)'),
+    markupPercent: z.number().optional().describe('Markup percentage (required if priceRule is markup)'),
+});
+export const tools = [
+    {
+        name: 'recurring_invoices_list',
+        description: 'List recurring invoice templates for the selected company. Supports filtering by active status and frequency.',
+        inputSchema: z.object({
+            companyId: z.string().optional().describe('Company UUID (overrides configured default)'),
+            page: z.number().optional().describe('Page number (default: 1)'),
+            limit: z.number().optional().describe('Items per page (default: 20, max: 100)'),
+            search: z.string().optional().describe('Search term to filter by reference or notes'),
+            isActive: z.boolean().optional().describe('Filter by active status (true/false)'),
+            frequency: z
+                .enum(['weekly', 'biweekly', 'monthly', 'bimonthly', 'quarterly', 'semiannual', 'annual'])
+                .optional()
+                .describe('Filter by generation frequency'),
+        }),
+        handler: async (params) => {
+            const config = getConfig();
+            if (!config.token)
+                return notAuthenticated();
+            const companyId = params.companyId || config.companyId;
+            if (!companyId)
+                return noCompanySelected();
+            const res = await apiRequest('/api/v1/recurring-invoices', {
+                companyId,
+                query: {
+                    page: params.page,
+                    limit: params.limit,
+                    search: params.search,
+                    isActive: params.isActive,
+                    frequency: params.frequency,
+                },
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'recurring_invoices_get',
+        description: 'Get detailed information about a specific recurring invoice template including all line items used as a template for generated invoices.',
+        inputSchema: z.object({
+            uuid: z.string().describe('UUID of the recurring invoice template'),
+            companyId: z.string().optional().describe('Company UUID (overrides configured default)'),
+        }),
+        handler: async (params) => {
+            const config = getConfig();
+            if (!config.token)
+                return notAuthenticated();
+            const companyId = params.companyId || config.companyId;
+            if (!companyId)
+                return noCompanySelected();
+            const res = await apiRequest(`/api/v1/recurring-invoices/${params.uuid}`, { companyId });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'recurring_invoices_create',
+        description: 'Create a new recurring invoice template. The system will automatically generate invoices based on the specified frequency and schedule. Supports fixed, exchange_rate, and markup pricing rules on line items.',
+        inputSchema: z.object({
+            companyId: z.string().optional().describe('Company UUID (overrides configured default)'),
+            clientId: z.string().describe('UUID of the client'),
+            seriesId: z.string().describe('UUID of the document series'),
+            reference: z.string().optional().describe('Human-readable reference for this recurring invoice'),
+            documentType: z.enum(['invoice', 'credit_note']).describe('Document type to generate'),
+            currency: z.string().describe('ISO 4217 currency code (e.g., RON, EUR)'),
+            invoiceTypeCode: z.string().describe('e-Factura invoice type code (e.g., "380")'),
+            frequency: z
+                .enum(['weekly', 'biweekly', 'monthly', 'bimonthly', 'quarterly', 'semiannual', 'annual'])
+                .describe('How often to generate invoices'),
+            frequencyDay: z.number().describe('Day of month for generation (1-31)'),
+            frequencyMonth: z.number().optional().describe('Month for annual generation (1-12, required if frequency is annual)'),
+            nextIssuanceDate: z.string().describe('ISO 8601 date for the first invoice generation (YYYY-MM-DD)'),
+            stopDate: z.string().optional().describe('ISO 8601 date to stop generation (YYYY-MM-DD)'),
+            dueDateType: z.enum(['fixed', 'relative']).describe('How due date is calculated'),
+            dueDateDays: z
+                .number()
+                .optional()
+                .describe('Days after issue date for due date (required if dueDateType is relative)'),
+            dueDateFixedDay: z
+                .number()
+                .optional()
+                .describe('Fixed day of month for due date (1-31, required if dueDateType is fixed)'),
+            notes: z.string().optional().describe('Internal notes'),
+            paymentTerms: z.string().optional().describe('Payment terms text'),
+            autoEmailEnabled: z.boolean().optional().describe('Auto-send email on invoice generation (default: false)'),
+            autoEmailTime: z.string().optional().describe('Time to send email (HH:mm, default: "09:00")'),
+            autoEmailDayOffset: z.number().optional().describe('Days offset for email sending (default: 0)'),
+            penaltyEnabled: z.boolean().optional().describe('Enable late payment penalties (default: false)'),
+            penaltyPercentPerDay: z.number().optional().describe('Daily penalty percentage'),
+            penaltyGraceDays: z.number().optional().describe('Grace period in days before penalties apply'),
+            lines: z.array(recurringLineItemSchema).describe('Array of line items (minimum 1 required)'),
+        }),
+        handler: async (params) => {
+            const config = getConfig();
+            if (!config.token)
+                return notAuthenticated();
+            const companyId = params.companyId || config.companyId;
+            if (!companyId)
+                return noCompanySelected();
+            const { companyId: _cid, ...body } = params;
+            const res = await apiRequest('/api/v1/recurring-invoices', {
+                method: 'POST',
+                companyId,
+                body: body,
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'recurring_invoices_update',
+        description: 'Update an existing recurring invoice template. All fields are optional but at least one must be provided. When updating lines, the entire lines array replaces existing lines.',
+        inputSchema: z.object({
+            uuid: z.string().describe('UUID of the recurring invoice template to update'),
+            companyId: z.string().optional().describe('Company UUID (overrides configured default)'),
+            clientId: z.string().optional().describe('UUID of the client'),
+            seriesId: z.string().optional().describe('UUID of the document series'),
+            reference: z.string().optional().describe('Human-readable reference'),
+            documentType: z.enum(['invoice', 'credit_note']).optional().describe('Document type to generate'),
+            currency: z.string().optional().describe('ISO 4217 currency code'),
+            invoiceTypeCode: z.string().optional().describe('e-Factura invoice type code'),
+            frequency: z
+                .enum(['weekly', 'biweekly', 'monthly', 'bimonthly', 'quarterly', 'semiannual', 'annual'])
+                .optional()
+                .describe('How often to generate invoices'),
+            frequencyDay: z.number().optional().describe('Day of month for generation (1-31)'),
+            frequencyMonth: z.number().optional().describe('Month for annual generation (1-12)'),
+            nextIssuanceDate: z.string().optional().describe('ISO 8601 date for next invoice generation (YYYY-MM-DD)'),
+            stopDate: z.string().nullable().optional().describe('ISO 8601 date to stop generation (null to remove)'),
+            dueDateType: z.enum(['fixed', 'relative']).optional().describe('How due date is calculated'),
+            dueDateDays: z.number().optional().describe('Days after issue date for due date'),
+            dueDateFixedDay: z.number().optional().describe('Fixed day of month for due date (1-31)'),
+            notes: z.string().nullable().optional().describe('Internal notes'),
+            paymentTerms: z.string().nullable().optional().describe('Payment terms text'),
+            autoEmailEnabled: z.boolean().optional().describe('Auto-send email on invoice generation'),
+            autoEmailTime: z.string().optional().describe('Time to send email (HH:mm)'),
+            autoEmailDayOffset: z.number().optional().describe('Days offset for email sending'),
+            penaltyEnabled: z.boolean().optional().describe('Enable late payment penalties'),
+            penaltyPercentPerDay: z.number().optional().describe('Daily penalty percentage'),
+            penaltyGraceDays: z.number().optional().describe('Grace period in days before penalties apply'),
+            lines: z.array(recurringLineItemSchema).optional().describe('Array of line items (replaces all existing lines)'),
+        }),
+        handler: async (params) => {
+            const config = getConfig();
+            if (!config.token)
+                return notAuthenticated();
+            const companyId = params.companyId || config.companyId;
+            if (!companyId)
+                return noCompanySelected();
+            const { uuid, companyId: _cid, ...body } = params;
+            const res = await apiRequest(`/api/v1/recurring-invoices/${uuid}`, {
+                method: 'PUT',
+                companyId,
+                body: body,
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'recurring_invoices_delete',
+        description: 'Permanently delete a recurring invoice template. Previously generated invoices from this template are not affected. Use toggle to temporarily pause instead.',
+        inputSchema: z.object({
+            uuid: z.string().describe('UUID of the recurring invoice template to delete'),
+            companyId: z.string().optional().describe('Company UUID (overrides configured default)'),
+        }),
+        handler: async (params) => {
+            const config = getConfig();
+            if (!config.token)
+                return notAuthenticated();
+            const companyId = params.companyId || config.companyId;
+            if (!companyId)
+                return noCompanySelected();
+            const res = await apiRequest(`/api/v1/recurring-invoices/${params.uuid}`, {
+                method: 'DELETE',
+                companyId,
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'recurring_invoices_toggle',
+        description: 'Toggle the active status of a recurring invoice template to pause or resume automatic invoice generation. If active, it will be paused; if paused, it will be resumed.',
+        inputSchema: z.object({
+            uuid: z.string().describe('UUID of the recurring invoice template to toggle'),
+            companyId: z.string().optional().describe('Company UUID (overrides configured default)'),
+        }),
+        handler: async (params) => {
+            const config = getConfig();
+            if (!config.token)
+                return notAuthenticated();
+            const companyId = params.companyId || config.companyId;
+            if (!companyId)
+                return noCompanySelected();
+            const res = await apiRequest(`/api/v1/recurring-invoices/${params.uuid}/toggle`, {
+                method: 'POST',
+                companyId,
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'recurring_invoices_bulk_delete',
+        description: 'Delete multiple recurring invoice templates in a single request. Returns the count of deleted items and any errors for items that could not be deleted.',
+        inputSchema: z.object({
+            ids: z.array(z.string()).min(1).max(100).describe('Array of recurring invoice UUIDs to delete (1-100)'),
+            companyId: z.string().optional().describe('Company UUID (overrides configured default)'),
+        }),
+        handler: async (params) => {
+            const config = getConfig();
+            if (!config.token)
+                return notAuthenticated();
+            const companyId = params.companyId || config.companyId;
+            if (!companyId)
+                return noCompanySelected();
+            const res = await apiRequest('/api/v1/recurring-invoices/bulk-delete', {
+                method: 'POST',
+                companyId,
+                body: { ids: params.ids },
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'recurring_invoices_bulk_toggle_active',
+        description: 'Toggle the active/paused status of multiple recurring invoices at once. Set active=true to resume or active=false to pause invoice generation.',
+        inputSchema: z.object({
+            ids: z.array(z.string()).min(1).max(100).describe('Array of recurring invoice UUIDs (1-100)'),
+            active: z.boolean().describe('Set to true to activate, false to pause'),
+            companyId: z.string().optional().describe('Company UUID (overrides configured default)'),
+        }),
+        handler: async (params) => {
+            const config = getConfig();
+            if (!config.token)
+                return notAuthenticated();
+            const companyId = params.companyId || config.companyId;
+            if (!companyId)
+                return noCompanySelected();
+            const res = await apiRequest('/api/v1/recurring-invoices/bulk-toggle-active', {
+                method: 'POST',
+                companyId,
+                body: { ids: params.ids, active: params.active },
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'recurring_invoices_bulk_issue_now',
+        description: 'Immediately generate invoices from multiple recurring invoice templates. Useful for triggering generation outside the normal schedule. Does not update the nextIssuanceDate.',
+        inputSchema: z.object({
+            ids: z.array(z.string()).min(1).max(100).describe('Array of recurring invoice UUIDs (1-100)'),
+            companyId: z.string().optional().describe('Company UUID (overrides configured default)'),
+        }),
+        handler: async (params) => {
+            const config = getConfig();
+            if (!config.token)
+                return notAuthenticated();
+            const companyId = params.companyId || config.companyId;
+            if (!companyId)
+                return noCompanySelected();
+            const res = await apiRequest('/api/v1/recurring-invoices/bulk-issue-now', {
+                method: 'POST',
+                companyId,
+                body: { ids: params.ids },
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'recurring_invoices_issue_now',
+        description: 'Manually trigger immediate invoice generation from a recurring invoice template, bypassing the scheduled generation. Useful for testing configurations or creating one-off invoices. Does not update the nextIssuanceDate.',
+        inputSchema: z.object({
+            uuid: z.string().describe('UUID of the recurring invoice template to issue now'),
+            companyId: z.string().optional().describe('Company UUID (overrides configured default)'),
+        }),
+        handler: async (params) => {
+            const config = getConfig();
+            if (!config.token)
+                return notAuthenticated();
+            const companyId = params.companyId || config.companyId;
+            if (!companyId)
+                return noCompanySelected();
+            const res = await apiRequest(`/api/v1/recurring-invoices/${params.uuid}/issue-now`, {
+                method: 'POST',
+                companyId,
+            });
+            return formatResponse(res);
+        },
+    },
+];
+//# sourceMappingURL=recurring-invoices.js.map

package/dist/tools/recurring-invoices.js.map

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

package/dist/tools/reports.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+export declare const tools: ({
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        dateFrom: z.ZodString;
+        dateTo: z.ZodString;
+        companyId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        dateFrom: string;
+        dateTo: string;
+        companyId?: string | undefined;
+    }, {
+        dateFrom: string;
+        dateTo: string;
+        companyId?: string | undefined;
+    }>;
+    handler: (params: Record<string, unknown>) => Promise<string>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        year: z.ZodNumber;
+        companyId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        year: number;
+        companyId?: string | undefined;
+    }, {
+        year: number;
+        companyId?: string | undefined;
+    }>;
+    handler: (params: Record<string, unknown>) => Promise<string>;
+} | {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        id: z.ZodString;
+        companyId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        companyId?: string | undefined;
+    }, {
+        id: string;
+        companyId?: string | undefined;
+    }>;
+    handler: (params: Record<string, unknown>) => Promise<string>;
+})[];
+//# sourceMappingURL=reports.d.ts.map

package/dist/tools/reports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../src/tools/reports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;sBAyDU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAAC;;;;;;;;;;;;;;sBAkCzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAAC;;;;;;;;;;;;;;sBAuDzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAAC;IA+DpE,CAAC"}

package/dist/tools/reports.js

@@ -0,0 +1,200 @@
+import { z } from 'zod';
+import { apiRequest } from '../client.js';
+import { formatResponse, notAuthenticated, noCompanySelected } from '../utils/errors.js';
+import { getConfig } from '../config.js';
+export const tools = [
+    {
+        name: 'reports_vat',
+        description: 'Generate a detailed VAT (TVA) report for a specific month. Returns a summary of sales, purchases, VAT collected, VAT deductible, and net VAT due, along with per-invoice details. Requires X-Company header (companyId param or STORNO_COMPANY_ID env var).',
+        inputSchema: z.object({
+            year: z
+                .number()
+                .int()
+                .min(2000)
+                .max(2100)
+                .describe('Report year (e.g. 2026)'),
+            month: z
+                .number()
+                .int()
+                .min(1)
+                .max(12)
+                .describe('Report month (1–12)'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { year, month, companyId } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const res = await apiRequest('/api/v1/reports/vat', {
+                companyId: effectiveCompanyId,
+                query: { year, month },
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'reports_sales_analysis',
+        description: 'Generate a sales analysis report for a date range. Returns KPI summary (annual total, invoiced, collected, outstanding), monthly revenue trends, recent invoices, top clients, and top products. Requires X-Company header (companyId param or STORNO_COMPANY_ID env var).',
+        inputSchema: z.object({
+            dateFrom: z
+                .string()
+                .describe('Start date in YYYY-MM-DD format (e.g. 2026-01-01)'),
+            dateTo: z
+                .string()
+                .describe('End date in YYYY-MM-DD format (e.g. 2026-02-26)'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { dateFrom, dateTo, companyId } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const res = await apiRequest('/api/v1/reports/sales', {
+                companyId: effectiveCompanyId,
+                query: { dateFrom, dateTo },
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'balance_analysis',
+        description: 'Get balance analysis (Analiza Balante) for a year. Returns financial indicators (revenue, expenses, profit, turnover, salaries, etc.), monthly evolution, profitability ratios, top expenses by account, and year-over-year comparison. Data comes from uploaded trial balance PDFs. Requires X-Company header.',
+        inputSchema: z.object({
+            year: z
+                .number()
+                .int()
+                .min(2000)
+                .max(2100)
+                .describe('Analysis year (e.g. 2025)'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { year, companyId } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const res = await apiRequest('/api/v1/balances/analysis', {
+                companyId: effectiveCompanyId,
+                query: { year },
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'balance_list',
+        description: 'List uploaded trial balances (Balante de verificare) for a year. Shows upload status (pending/processing/completed/failed), month, account count, and source software for each uploaded balance.',
+        inputSchema: z.object({
+            year: z
+                .number()
+                .int()
+                .min(2000)
+                .max(2100)
+                .describe('Year to list balances for (e.g. 2025)'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { year, companyId } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const res = await apiRequest('/api/v1/balances', {
+                companyId: effectiveCompanyId,
+                query: { year },
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'balance_rows',
+        description: 'Get the parsed account rows for a trial balance. Returns all account codes, names, and 10 numeric columns (initial/previous/current/total/final debit & credit). Useful for verifying PDF parsing results.',
+        inputSchema: z.object({
+            id: z.string().describe('Trial balance UUID'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { id, companyId } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const res = await apiRequest(`/api/v1/balances/${id}/rows`, {
+                companyId: effectiveCompanyId,
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'balance_reprocess',
+        description: 'Reprocess a trial balance PDF. Re-parses the PDF file and updates the account rows. Useful after parser improvements.',
+        inputSchema: z.object({
+            id: z.string().describe('Trial balance UUID to reprocess'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { id, companyId } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const res = await apiRequest(`/api/v1/balances/${id}/reprocess`, {
+                companyId: effectiveCompanyId,
+                method: 'POST',
+            });
+            return formatResponse(res);
+        },
+    },
+    {
+        name: 'balance_delete',
+        description: 'Delete an uploaded trial balance by ID. This soft-deletes the balance and its parsed account rows.',
+        inputSchema: z.object({
+            id: z.string().describe('Trial balance UUID to delete'),
+            companyId: z
+                .string()
+                .optional()
+                .describe('Company UUID (overrides STORNO_COMPANY_ID env var)'),
+        }),
+        handler: async (params) => {
+            if (!getConfig().token)
+                return notAuthenticated();
+            const { id, companyId } = params;
+            const effectiveCompanyId = companyId || getConfig().companyId;
+            if (!effectiveCompanyId)
+                return noCompanySelected();
+            const res = await apiRequest(`/api/v1/balances/${id}`, {
+                companyId: effectiveCompanyId,
+                method: 'DELETE',
+            });
+            return formatResponse(res);
+        },
+    },
+];
+//# sourceMappingURL=reports.js.map

package/dist/tools/reports.js.map

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

package/dist/tools/storage-config.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const tools: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+    handler: (_params: Record<string, unknown>) => Promise<string>;
+}[];
+//# sourceMappingURL=storage-config.d.ts.map

package/dist/tools/storage-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-config.d.ts","sourceRoot":"","sources":["../../src/tools/storage-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,KAAK;;;;uBAMW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAAC;GAkHrE,CAAC"}