@taxdao/fintax-mcp 0.2.0

package/dist/schemas/common.d.ts

@@ -0,0 +1,226 @@
+import { z } from 'zod/v4';
+export declare const contextSchema: z.ZodObject<{
+    org_id: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strict>;
+export declare const sourceRefSchema: z.ZodObject<{
+    service: z.ZodEnum<{
+        base: "base";
+        suite: "suite";
+        mcp: "mcp";
+    }>;
+    operation: z.ZodString;
+}, z.core.$strict>;
+export declare const pageInfoSchema: z.ZodObject<{
+    number: z.ZodNumber;
+    size: z.ZodNumber;
+    total_items: z.ZodNumber;
+    has_more: z.ZodBoolean;
+}, z.core.$strict>;
+export declare const fileRefSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        local_path: "local_path";
+        artifact: "artifact";
+        upload_id: "upload_id";
+    }>;
+    value: z.ZodString;
+}, z.core.$strict>;
+export declare const artifactMetadataSchema: z.ZodObject<{
+    file_ref: z.ZodObject<{
+        kind: z.ZodLiteral<"artifact">;
+        value: z.ZodUUID;
+    }, z.core.$strict>;
+    file_name: z.ZodString;
+    media_type: z.ZodString;
+    size_bytes: z.ZodNumber;
+    sha256: z.ZodString;
+    expires_at: z.ZodISODateTime;
+}, z.core.$strict>;
+export declare const toolFailureSchema: z.ZodObject<{
+    ok: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodEnum<{
+            AUTH_REQUIRED: "AUTH_REQUIRED";
+            PERMISSION_DENIED: "PERMISSION_DENIED";
+            VALIDATION_FAILED: "VALIDATION_FAILED";
+            NOT_FOUND: "NOT_FOUND";
+            CONFLICT: "CONFLICT";
+            CONFIRMATION_REQUIRED: "CONFIRMATION_REQUIRED";
+            RATE_LIMITED: "RATE_LIMITED";
+            UPSTREAM_UNAVAILABLE: "UPSTREAM_UNAVAILABLE";
+            TIMEOUT: "TIMEOUT";
+            UNKNOWN: "UNKNOWN";
+        }>;
+        message: z.ZodString;
+        retryable: z.ZodBoolean;
+        field_errors: z.ZodArray<z.ZodObject<{
+            field: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strict>>;
+        recovery: z.ZodOptional<z.ZodObject<{
+            tool: z.ZodString;
+            input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    trace_id: z.ZodString;
+}, z.core.$strict>;
+export type ToolFailure = z.infer<typeof toolFailureSchema>;
+/** A non-paginated success response for detail, write, preview, and execute Tools. */
+export declare function successEnvelopeSchema<T extends z.ZodType>(dataSchema: T): z.ZodObject<{
+    warnings: z.ZodArray<z.ZodString>;
+    trace_id: z.ZodString;
+    source_refs: z.ZodArray<z.ZodObject<{
+        service: z.ZodEnum<{
+            base: "base";
+            suite: "suite";
+            mcp: "mcp";
+        }>;
+        operation: z.ZodString;
+    }, z.core.$strict>>;
+    page?: never;
+    ok: z.ZodLiteral<true>;
+    data: T;
+} | {
+    warnings: z.ZodArray<z.ZodString>;
+    trace_id: z.ZodString;
+    source_refs: z.ZodArray<z.ZodObject<{
+        service: z.ZodEnum<{
+            base: "base";
+            suite: "suite";
+            mcp: "mcp";
+        }>;
+        operation: z.ZodString;
+    }, z.core.$strict>>;
+    page: z.ZodObject<{
+        number: z.ZodNumber;
+        size: z.ZodNumber;
+        total_items: z.ZodNumber;
+        has_more: z.ZodBoolean;
+    }, z.core.$strict> | z.ZodOptional<z.ZodObject<{
+        number: z.ZodNumber;
+        size: z.ZodNumber;
+        total_items: z.ZodNumber;
+        has_more: z.ZodBoolean;
+    }, z.core.$strict>>;
+    ok: z.ZodLiteral<true>;
+    data: T;
+}, z.core.$strict>;
+/** A list response whose pagination metadata is always present. */
+export declare function paginatedSuccessEnvelopeSchema<T extends z.ZodType>(dataSchema: T): z.ZodObject<{
+    warnings: z.ZodArray<z.ZodString>;
+    trace_id: z.ZodString;
+    source_refs: z.ZodArray<z.ZodObject<{
+        service: z.ZodEnum<{
+            base: "base";
+            suite: "suite";
+            mcp: "mcp";
+        }>;
+        operation: z.ZodString;
+    }, z.core.$strict>>;
+    page?: never;
+    ok: z.ZodLiteral<true>;
+    data: T;
+} | {
+    warnings: z.ZodArray<z.ZodString>;
+    trace_id: z.ZodString;
+    source_refs: z.ZodArray<z.ZodObject<{
+        service: z.ZodEnum<{
+            base: "base";
+            suite: "suite";
+            mcp: "mcp";
+        }>;
+        operation: z.ZodString;
+    }, z.core.$strict>>;
+    page: z.ZodObject<{
+        number: z.ZodNumber;
+        size: z.ZodNumber;
+        total_items: z.ZodNumber;
+        has_more: z.ZodBoolean;
+    }, z.core.$strict> | z.ZodOptional<z.ZodObject<{
+        number: z.ZodNumber;
+        size: z.ZodNumber;
+        total_items: z.ZodNumber;
+        has_more: z.ZodBoolean;
+    }, z.core.$strict>>;
+    ok: z.ZodLiteral<true>;
+    data: T;
+}, z.core.$strict>;
+/** A response whose pagination requirement depends on the returned view. */
+export declare function viewPageSuccessEnvelopeSchema<T extends z.ZodType>(dataSchema: T, paginatedViews: readonly string[]): z.ZodObject<{
+    warnings: z.ZodArray<z.ZodString>;
+    trace_id: z.ZodString;
+    source_refs: z.ZodArray<z.ZodObject<{
+        service: z.ZodEnum<{
+            base: "base";
+            suite: "suite";
+            mcp: "mcp";
+        }>;
+        operation: z.ZodString;
+    }, z.core.$strict>>;
+    page?: never;
+    ok: z.ZodLiteral<true>;
+    data: T;
+} | {
+    warnings: z.ZodArray<z.ZodString>;
+    trace_id: z.ZodString;
+    source_refs: z.ZodArray<z.ZodObject<{
+        service: z.ZodEnum<{
+            base: "base";
+            suite: "suite";
+            mcp: "mcp";
+        }>;
+        operation: z.ZodString;
+    }, z.core.$strict>>;
+    page: z.ZodObject<{
+        number: z.ZodNumber;
+        size: z.ZodNumber;
+        total_items: z.ZodNumber;
+        has_more: z.ZodBoolean;
+    }, z.core.$strict> | z.ZodOptional<z.ZodObject<{
+        number: z.ZodNumber;
+        size: z.ZodNumber;
+        total_items: z.ZodNumber;
+        has_more: z.ZodBoolean;
+    }, z.core.$strict>>;
+    ok: z.ZodLiteral<true>;
+    data: T;
+}, z.core.$strict>;
+/** A response with a page field that is optional for all returned data. */
+export declare function optionalPageSuccessEnvelopeSchema<T extends z.ZodType>(dataSchema: T): z.ZodObject<{
+    warnings: z.ZodArray<z.ZodString>;
+    trace_id: z.ZodString;
+    source_refs: z.ZodArray<z.ZodObject<{
+        service: z.ZodEnum<{
+            base: "base";
+            suite: "suite";
+            mcp: "mcp";
+        }>;
+        operation: z.ZodString;
+    }, z.core.$strict>>;
+    page?: never;
+    ok: z.ZodLiteral<true>;
+    data: T;
+} | {
+    warnings: z.ZodArray<z.ZodString>;
+    trace_id: z.ZodString;
+    source_refs: z.ZodArray<z.ZodObject<{
+        service: z.ZodEnum<{
+            base: "base";
+            suite: "suite";
+            mcp: "mcp";
+        }>;
+        operation: z.ZodString;
+    }, z.core.$strict>>;
+    page: z.ZodObject<{
+        number: z.ZodNumber;
+        size: z.ZodNumber;
+        total_items: z.ZodNumber;
+        has_more: z.ZodBoolean;
+    }, z.core.$strict> | z.ZodOptional<z.ZodObject<{
+        number: z.ZodNumber;
+        size: z.ZodNumber;
+        total_items: z.ZodNumber;
+        has_more: z.ZodBoolean;
+    }, z.core.$strict>>;
+    ok: z.ZodLiteral<true>;
+    data: T;
+}, z.core.$strict>;

package/dist/schemas/common.js

@@ -0,0 +1,133 @@
+import { z } from 'zod/v4';
+export const contextSchema = z
+    .object({
+    org_id: z.uuid().optional(),
+})
+    .strict();
+export const sourceRefSchema = z
+    .object({
+    service: z.enum(['base', 'suite', 'mcp']),
+    operation: z.string().min(1),
+})
+    .strict();
+export const pageInfoSchema = z
+    .object({
+    number: z.number().int().positive(),
+    size: z.number().int().positive(),
+    total_items: z.number().int().nonnegative(),
+    has_more: z.boolean(),
+})
+    .strict();
+export const fileRefSchema = z
+    .object({
+    kind: z.enum(['local_path', 'artifact', 'upload_id']),
+    value: z.string().min(1),
+})
+    .strict();
+export const artifactMetadataSchema = z
+    .object({
+    file_ref: z
+        .object({
+        kind: z.literal('artifact'),
+        value: z.uuid(),
+    })
+        .strict(),
+    file_name: z.string().min(1),
+    media_type: z.string().min(1),
+    size_bytes: z.number().int().nonnegative(),
+    sha256: z.string().regex(/^[a-f0-9]{64}$/),
+    expires_at: z.iso.datetime(),
+})
+    .strict();
+export const toolFailureSchema = z
+    .object({
+    ok: z.literal(false),
+    error: z
+        .object({
+        code: z.enum([
+            'AUTH_REQUIRED',
+            'PERMISSION_DENIED',
+            'VALIDATION_FAILED',
+            'NOT_FOUND',
+            'CONFLICT',
+            'CONFIRMATION_REQUIRED',
+            'RATE_LIMITED',
+            'UPSTREAM_UNAVAILABLE',
+            'TIMEOUT',
+            'UNKNOWN',
+        ]),
+        message: z.string(),
+        retryable: z.boolean(),
+        field_errors: z.array(z.object({ field: z.string(), message: z.string() }).strict()),
+        recovery: z
+            .object({
+            tool: z.string(),
+            input: z.record(z.string(), z.unknown()),
+        })
+            .strict()
+            .optional(),
+    })
+        .strict(),
+    trace_id: z.string(),
+})
+    .strict();
+function envelopeSchema(dataSchema, page) {
+    const pageShape = page === 'none'
+        ? {}
+        : {
+            page: page === 'required' ? pageInfoSchema : pageInfoSchema.optional(),
+        };
+    return z
+        .object({
+        ok: z.literal(true),
+        data: dataSchema,
+        ...pageShape,
+        warnings: z.array(z.string()),
+        trace_id: z.string(),
+        source_refs: z.array(sourceRefSchema),
+    })
+        .strict();
+}
+/** A non-paginated success response for detail, write, preview, and execute Tools. */
+export function successEnvelopeSchema(dataSchema) {
+    return envelopeSchema(dataSchema, 'none');
+}
+/** A list response whose pagination metadata is always present. */
+export function paginatedSuccessEnvelopeSchema(dataSchema) {
+    return envelopeSchema(dataSchema, 'required');
+}
+/** A response whose pagination requirement depends on the returned view. */
+export function viewPageSuccessEnvelopeSchema(dataSchema, paginatedViews) {
+    return envelopeSchema(dataSchema, 'optional').superRefine((value, refinementContext) => {
+        const envelope = value;
+        const data = envelope.data;
+        const view = data !== null &&
+            typeof data === 'object' &&
+            'view' in data &&
+            typeof data.view === 'string'
+            ? data.view
+            : undefined;
+        if (view === undefined)
+            return;
+        const paginated = paginatedViews.includes(view);
+        if (paginated && envelope.page === undefined) {
+            refinementContext.addIssue({
+                code: 'custom',
+                path: ['page'],
+                message: 'Pagination metadata is required for this view',
+            });
+        }
+        if (!paginated && envelope.page !== undefined) {
+            refinementContext.addIssue({
+                code: 'custom',
+                path: ['page'],
+                message: 'Pagination metadata is not valid for this view',
+            });
+        }
+    });
+}
+/** A response with a page field that is optional for all returned data. */
+export function optionalPageSuccessEnvelopeSchema(dataSchema) {
+    return envelopeSchema(dataSchema, 'optional');
+}
+//# sourceMappingURL=common.js.map

package/dist/schemas/common.js.map

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