pigeongov 0.2.0

package/dist/src/mcp/shared.js

@@ -0,0 +1,354 @@
+import { z } from "zod";
+import { buildReturnBundle } from "../engine/field-mapper.js";
+import { validateReturnBundle } from "../engine/validator.js";
+import { calculateFederalTax } from "../engine/tax-calculator.js";
+import { schemaRegistry } from "../schemas/2025/index.js";
+import { buildWorkflowBundle, describeWorkflow, explainWorkflowFlag, getWorkflowStarterData, listDomains, listWorkflowSummaries, normalizeWorkflowId, reviewWorkflowBundle, validateWorkflowBundle, } from "../workflows/registry.js";
+export const PIGEONGOV_YEAR = 2025;
+export const supportedFormIds = [
+    "1040",
+    "schedule-1",
+    "schedule-c",
+    "w2",
+    "1099-nec",
+    "1099-int",
+];
+export const supportedFormSchema = z.enum(supportedFormIds);
+export const incomeDocumentTypeSchema = z.enum(["w2", "1099-nec", "1099-int"]);
+const dependentSchema = z
+    .object({
+    name: z.string().trim().min(1),
+    ssn: z.string().trim().regex(/^\d{3}-\d{2}-\d{4}$/),
+    relationship: z.string().trim().min(1),
+    childTaxCreditEligible: z.boolean(),
+    eitcEligible: z.boolean().optional(),
+})
+    .strict();
+const identitySchema = z
+    .object({
+    firstName: z.string().trim().min(1),
+    lastName: z.string().trim().min(1),
+    ssn: z.string().trim().regex(/^\d{3}-\d{2}-\d{4}$/),
+    address: z
+        .object({
+        street1: z.string().trim().min(1),
+        street2: z.string().trim().optional(),
+        city: z.string().trim().min(1),
+        state: z.string().trim().regex(/^[A-Z]{2}$/),
+        zipCode: z.string().trim().regex(/^\d{5}(?:-\d{4})?$/),
+    })
+        .strict(),
+})
+    .strict();
+const adjustmentSchema = z
+    .object({
+    educatorExpenses: z.coerce.number().default(0),
+    hsaDeduction: z.coerce.number().default(0),
+    selfEmploymentTaxDeduction: z.coerce.number().default(0),
+    iraDeduction: z.coerce.number().default(0),
+    studentLoanInterest: z.coerce.number().default(0),
+})
+    .strict();
+export const taxInputSchema = z
+    .object({
+    filingStatus: z.enum([
+        "single",
+        "married_filing_jointly",
+        "married_filing_separately",
+        "head_of_household",
+        "qualifying_surviving_spouse",
+    ]),
+    wages: z.coerce.number().default(0),
+    taxableInterest: z.coerce.number().default(0),
+    ordinaryDividends: z.coerce.number().default(0),
+    scheduleCNet: z.coerce.number().default(0),
+    otherIncome: z.coerce.number().default(0),
+    adjustments: adjustmentSchema.default({
+        educatorExpenses: 0,
+        hsaDeduction: 0,
+        selfEmploymentTaxDeduction: 0,
+        iraDeduction: 0,
+        studentLoanInterest: 0,
+    }),
+    useItemizedDeductions: z.boolean().default(false),
+    itemizedDeductions: z.coerce.number().default(0),
+    dependents: z.array(dependentSchema).default([]),
+    federalWithheld: z.coerce.number().min(0).default(0),
+    estimatedPayments: z.coerce.number().min(0).default(0),
+})
+    .strict();
+export const sourceDocumentDescriptorSchema = z
+    .object({
+    path: z.string().trim().min(1),
+    type: incomeDocumentTypeSchema.optional(),
+})
+    .strict();
+export const fillFormInputSchema = z
+    .object({
+    formId: supportedFormSchema,
+    taxYear: z.literal(PIGEONGOV_YEAR).optional(),
+    data: taxInputSchema,
+    documents: z.array(sourceDocumentDescriptorSchema).optional(),
+})
+    .strict();
+export const calculateTaxInputSchema = z
+    .object({
+    taxYear: z.literal(PIGEONGOV_YEAR).optional(),
+    data: taxInputSchema,
+})
+    .strict();
+export const validateFormInputSchema = z
+    .object({
+    formId: supportedFormSchema,
+    taxYear: z.literal(PIGEONGOV_YEAR).optional(),
+    data: taxInputSchema,
+})
+    .strict();
+export const describeFormInputSchema = z
+    .object({
+    formId: supportedFormSchema,
+    taxYear: z.literal(PIGEONGOV_YEAR).optional(),
+})
+    .strict();
+export const extractDocumentInputSchema = z
+    .object({
+    path: z.string().trim().min(1),
+    type: incomeDocumentTypeSchema.optional(),
+})
+    .strict();
+export const workflowIdSchema = z.string().trim().min(1);
+export const describeWorkflowInputSchema = z
+    .object({
+    workflowId: workflowIdSchema,
+})
+    .strict();
+export const startWorkflowInputSchema = z
+    .object({
+    workflowId: workflowIdSchema,
+})
+    .strict();
+export const fillWorkflowInputSchema = z
+    .object({
+    workflowId: workflowIdSchema,
+    data: z.record(z.string(), z.unknown()),
+})
+    .strict();
+export const validateWorkflowInputSchema = z
+    .object({
+    workflowId: workflowIdSchema.optional(),
+    bundle: z.record(z.string(), z.unknown()),
+})
+    .strict();
+export const reviewWorkflowInputSchema = validateWorkflowInputSchema;
+export const buildPacketInputSchema = z
+    .object({
+    workflowId: workflowIdSchema,
+    data: z.record(z.string(), z.unknown()),
+})
+    .strict();
+export const explainFlagInputSchema = z
+    .object({
+    bundle: z.record(z.string(), z.unknown()),
+    field: z.string().trim().min(1),
+})
+    .strict();
+function unwrapSchema(schema) {
+    if (schema instanceof z.ZodOptional) {
+        const unwrapped = unwrapSchema(schema.unwrap());
+        return { schema: unwrapped.schema, optional: true };
+    }
+    if (schema instanceof z.ZodDefault) {
+        const unwrapped = unwrapSchema(schema.removeDefault());
+        return { schema: unwrapped.schema, optional: true };
+    }
+    return { schema, optional: false };
+}
+function describeSchemaField(name, schema) {
+    const { schema: unwrapped, optional } = unwrapSchema(schema);
+    const field = {
+        name,
+        kind: unwrapped.constructor.name.replace(/^Zod/, "").toLowerCase() || "value",
+        optional,
+    };
+    if (unwrapped.description !== undefined) {
+        field.description = unwrapped.description;
+    }
+    if (unwrapped instanceof z.ZodObject) {
+        field.kind = "object";
+        field.children = Object.entries(unwrapped.shape).map(([childName, childSchema]) => describeSchemaField(childName, childSchema));
+    }
+    else if (unwrapped instanceof z.ZodArray) {
+        field.kind = "array";
+        field.children = [describeSchemaField(`${name}[]`, unwrapped.element)];
+    }
+    return field;
+}
+export function listForms() {
+    return supportedFormIds.map((formId) => ({
+        formId,
+        taxYear: PIGEONGOV_YEAR,
+        meta: schemaRegistry[formId].meta,
+    }));
+}
+export function describeForm(formId) {
+    const definition = schemaRegistry[formId];
+    const fields = definition.schema instanceof z.ZodObject
+        ? Object.entries(definition.schema.shape).map(([name, schema]) => describeSchemaField(name, schema))
+        : [];
+    return {
+        formId,
+        taxYear: PIGEONGOV_YEAR,
+        meta: definition.meta,
+        fields,
+    };
+}
+export function listWorkflows() {
+    return listWorkflowSummaries();
+}
+export function workflowDomains() {
+    return listDomains();
+}
+export function describeWorkflowDefinition(workflowId) {
+    return describeWorkflow(workflowId);
+}
+export function startWorkflow(workflowId) {
+    const normalizedId = normalizeWorkflowId(workflowId);
+    return {
+        workflowId: normalizedId,
+        starterData: getWorkflowStarterData(normalizedId),
+    };
+}
+export function fillWorkflow(workflowId, data) {
+    return buildWorkflowBundle(workflowId, data);
+}
+export function validateWorkflow(bundle) {
+    const parsed = bundle;
+    const workflowBundle = parsed.workflowId
+        ? buildWorkflowBundle(parsed.workflowId, bundle.answers ?? bundle)
+        : bundle;
+    return validateWorkflowBundle(workflowBundle);
+}
+export function reviewWorkflow(workflowId, data) {
+    const bundle = buildWorkflowBundle(workflowId, data);
+    return {
+        bundle,
+        review: reviewWorkflowBundle(bundle),
+        validation: validateWorkflowBundle(bundle),
+    };
+}
+export function explainFlag(bundle, field) {
+    return explainWorkflowFlag(bundle, field);
+}
+export function buildTaxCalculationInput(input) {
+    return {
+        filingStatus: input.filingStatus,
+        wages: input.wages,
+        taxableInterest: input.taxableInterest,
+        ordinaryDividends: input.ordinaryDividends,
+        scheduleCNet: input.scheduleCNet,
+        otherIncome: input.otherIncome,
+        adjustments: input.adjustments,
+        useItemizedDeductions: input.useItemizedDeductions,
+        itemizedDeductions: input.itemizedDeductions,
+        dependents: input.dependents.map((dependent) => {
+            const normalized = {
+                name: dependent.name,
+                ssn: dependent.ssn,
+                relationship: dependent.relationship,
+                childTaxCreditEligible: dependent.childTaxCreditEligible,
+            };
+            return dependent.eitcEligible === undefined
+                ? normalized
+                : { ...normalized, eitcEligible: dependent.eitcEligible };
+        }),
+        federalWithheld: input.federalWithheld,
+        estimatedPayments: input.estimatedPayments,
+    };
+}
+export function calculateTaxFromInput(input) {
+    return calculateFederalTax(buildTaxCalculationInput(input));
+}
+export async function extractDocumentFromPath(path, typeHint) {
+    const { readPdfDocument } = await import("../pdf/reader.js");
+    const result = await readPdfDocument(path, typeHint ? { typeHint } : {});
+    return {
+        documentType: result.detectedType,
+        confidence: result.confidence,
+        extracted: result.detectedType === "unknown" ? null : result.document,
+        text: result.rawText,
+        flaggedFields: result.flaggedFields,
+    };
+}
+export function mergeImportedDocuments(baseInput, documents) {
+    const merged = structuredClone(baseInput);
+    for (const document of documents) {
+        if (document.type === "w2") {
+            merged.wages += document.wages;
+            merged.federalWithheld += document.federalWithheld;
+        }
+        else if (document.type === "1099-nec") {
+            merged.scheduleCNet += document.nonemployeeCompensation;
+            merged.federalWithheld += document.federalWithheld ?? 0;
+        }
+        else if (document.type === "1099-int") {
+            merged.taxableInterest += document.interestIncome;
+            merged.federalWithheld += document.federalWithheld ?? 0;
+        }
+    }
+    return {
+        input: merged,
+        flaggedFields: documents.length > 0
+            ? [
+                {
+                    field: "documents",
+                    severity: "review",
+                    message: `Merged ${documents.length} imported document${documents.length === 1 ? "" : "s"}.`,
+                    source: "mcp",
+                },
+            ]
+            : [],
+    };
+}
+export function validateTaxInput(input) {
+    const bundle = buildReturnBundle({
+        formId: "1040",
+        taxYear: PIGEONGOV_YEAR,
+        filingStatus: input.filingStatus,
+        taxpayer: identitySchema.parse({
+            firstName: "Taxpayer",
+            lastName: "Example",
+            ssn: "000-00-0000",
+            address: {
+                street1: "Unknown",
+                city: "Unknown",
+                state: "CA",
+                zipCode: "00000",
+            },
+        }),
+        dependents: buildTaxCalculationInput(input).dependents,
+        importedDocuments: [],
+        taxInput: buildTaxCalculationInput(input),
+    });
+    return validateReturnBundle(bundle);
+}
+export function reviewTaxInput(input) {
+    const calculation = calculateTaxFromInput(input);
+    const validation = validateTaxInput(input);
+    return {
+        headline: calculation.refund > 0
+            ? "Refund due"
+            : calculation.amountOwed > 0
+                ? "Balance due"
+                : "No balance due",
+        notes: [
+            `Gross income: $${calculation.grossIncome.toFixed(2)}`,
+            `Taxable income: $${calculation.taxableIncome.toFixed(2)}`,
+            `Federal tax: $${calculation.federalTax.toFixed(2)}`,
+            `Refund: $${calculation.refund.toFixed(2)}`,
+        ],
+        flaggedFields: validation.flaggedFields,
+        checks: validation.checks,
+        calculation,
+    };
+}
+//# sourceMappingURL=shared.js.map

package/dist/src/mcp/shared.js.map

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

package/dist/src/mcp/tools/build-packet.d.ts

@@ -0,0 +1,7 @@
+import { type InferSchema, type ToolMetadata } from "xmcp";
+export declare const schema: {
+    workflowId: import("zod").ZodString;
+    data: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+};
+export declare const metadata: ToolMetadata;
+export default function buildPacketTool(args: InferSchema<typeof schema>): any;

package/dist/src/mcp/tools/build-packet.js

@@ -0,0 +1,23 @@
+import { fillWorkflow, buildPacketInputSchema } from "../shared.js";
+import { withStructuredContent } from "../result.js";
+export const schema = {
+    workflowId: buildPacketInputSchema.shape.workflowId,
+    data: buildPacketInputSchema.shape.data,
+};
+export const metadata = {
+    name: "build-packet",
+    description: "Build a workflow packet summary with output artifact metadata for local saving.",
+};
+export default function buildPacketTool(args) {
+    const bundle = fillWorkflow(args.workflowId, args.data);
+    return withStructuredContent({
+        ok: true,
+        workflowId: bundle.workflowId,
+        outputArtifacts: bundle.outputArtifacts,
+        review: bundle.review,
+        validation: bundle.validation,
+        flaggedFields: bundle.validation.flaggedFields,
+        bundle,
+    });
+}
+//# sourceMappingURL=build-packet.js.map

package/dist/src/mcp/tools/build-packet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-packet.js","sourceRoot":"","sources":["../../../../src/mcp/tools/build-packet.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,UAAU,EAAE,sBAAsB,CAAC,KAAK,CAAC,UAAU;IACnD,IAAI,EAAE,sBAAsB,CAAC,KAAK,CAAC,IAAI;CACxC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAiB;IACpC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,iFAAiF;CAC/F,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,IAAgC;IACtE,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAExD,OAAO,qBAAqB,CAAC;QAC3B,EAAE,EAAE,IAAI;QACR,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,aAAa;QAC9C,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

package/dist/src/mcp/tools/calculate-tax.d.ts

@@ -0,0 +1,40 @@
+export declare const schema: {
+    taxYear: import("zod").ZodOptional<import("zod").ZodLiteral<2025>>;
+    data: import("zod").ZodObject<{
+        filingStatus: import("zod").ZodEnum<{
+            single: "single";
+            married_filing_jointly: "married_filing_jointly";
+            married_filing_separately: "married_filing_separately";
+            head_of_household: "head_of_household";
+            qualifying_surviving_spouse: "qualifying_surviving_spouse";
+        }>;
+        wages: import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+        taxableInterest: import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+        ordinaryDividends: import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+        scheduleCNet: import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+        otherIncome: import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+        adjustments: import("zod").ZodDefault<import("zod").ZodObject<{
+            educatorExpenses: import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+            hsaDeduction: import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+            selfEmploymentTaxDeduction: import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+            iraDeduction: import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+            studentLoanInterest: import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+        }, import("zod/v4/core").$strict>>;
+        useItemizedDeductions: import("zod").ZodDefault<import("zod").ZodBoolean>;
+        itemizedDeductions: import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+        dependents: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodObject<{
+            name: import("zod").ZodString;
+            ssn: import("zod").ZodString;
+            relationship: import("zod").ZodString;
+            childTaxCreditEligible: import("zod").ZodBoolean;
+            eitcEligible: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        }, import("zod/v4/core").$strict>>>;
+        federalWithheld: import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+        estimatedPayments: import("zod").ZodDefault<import("zod").ZodCoercedNumber<unknown>>;
+    }, import("zod/v4/core").$strict>;
+};
+export declare const metadata: {
+    title: string;
+    description: string;
+};
+export default function calculateTaxTool(input: unknown): any;

package/dist/src/mcp/tools/calculate-tax.js

@@ -0,0 +1,17 @@
+import { calculateTaxFromInput, calculateTaxInputSchema, } from "../shared.js";
+import { withStructuredContent } from "../result.js";
+export const schema = calculateTaxInputSchema.shape;
+export const metadata = {
+    title: "Calculate tax",
+    description: "Run deterministic federal tax calculations for the 2025 tax year.",
+};
+export default function calculateTaxTool(input) {
+    const parsed = calculateTaxInputSchema.parse(input);
+    const calculation = calculateTaxFromInput(parsed.data);
+    return withStructuredContent({
+        ok: true,
+        flaggedFields: [],
+        calculation,
+    });
+}
+//# sourceMappingURL=calculate-tax.js.map

package/dist/src/mcp/tools/calculate-tax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculate-tax.js","sourceRoot":"","sources":["../../../../src/mcp/tools/calculate-tax.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,CAAC,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC;AAEpD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,eAAe;IACtB,WAAW,EAAE,mEAAmE;CACjF,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,KAAc;IACrD,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,WAAW,GAAG,qBAAqB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEvD,OAAO,qBAAqB,CAAC;QAC3B,EAAE,EAAE,IAAI;QACR,aAAa,EAAE,EAAE;QACjB,WAAW;KACZ,CAAC,CAAC;AACL,CAAC"}

package/dist/src/mcp/tools/deadlines.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+import type { InferSchema, ToolMetadata } from "xmcp";
+export declare const schema: {
+    workflowId: z.ZodOptional<z.ZodString>;
+};
+export declare const metadata: ToolMetadata;
+export default function listDeadlinesTool(args: InferSchema<typeof schema>): any;

package/dist/src/mcp/tools/deadlines.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { withStructuredContent } from "../result.js";
+import { DEFAULT_DEADLINES, getUpcomingDeadlines, } from "../../workflows/deadlines.js";
+export const schema = {
+    workflowId: z.string().trim().min(1).optional(),
+};
+export const metadata = {
+    name: "pigeongov-list-deadlines",
+    description: "List upcoming deadlines for government workflows. Optionally filter by workflow ID.",
+};
+export default function listDeadlinesTool(args) {
+    let deadlines = DEFAULT_DEADLINES;
+    if (args.workflowId) {
+        deadlines = deadlines.filter((d) => d.workflowId === args.workflowId);
+    }
+    const upcoming = getUpcomingDeadlines(deadlines);
+    return withStructuredContent({
+        ok: true,
+        deadlines: upcoming,
+        flaggedFields: [],
+    });
+}
+//# sourceMappingURL=deadlines.js.map

package/dist/src/mcp/tools/deadlines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadlines.js","sourceRoot":"","sources":["../../../../src/mcp/tools/deadlines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAiB;IACpC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACT,qFAAqF;CACxF,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACvC,IAAgC;IAEhC,IAAI,SAAS,GAAG,iBAAiB,CAAC;IAElC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,QAAQ,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAEjD,OAAO,qBAAqB,CAAC;QAC3B,EAAE,EAAE,IAAI;QACR,SAAS,EAAE,QAAQ;QACnB,aAAa,EAAE,EAAE;KAClB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/mcp/tools/describe-form.d.ts

@@ -0,0 +1,14 @@
+import { type InferSchema, type ToolMetadata } from "xmcp";
+export declare const schema: {
+    formId: import("zod").ZodEnum<{
+        w2: "w2";
+        "1099-nec": "1099-nec";
+        "1099-int": "1099-int";
+        1040: "1040";
+        "schedule-1": "schedule-1";
+        "schedule-c": "schedule-c";
+    }>;
+    taxYear: import("zod").ZodOptional<import("zod").ZodLiteral<2025>>;
+};
+export declare const metadata: ToolMetadata;
+export default function describeFormTool(args: InferSchema<typeof schema>): Promise<any>;

package/dist/src/mcp/tools/describe-form.js

@@ -0,0 +1,23 @@
+import { describeForm, describeFormInputSchema } from "../shared.js";
+import { withStructuredContent } from "../result.js";
+export const schema = {
+    formId: describeFormInputSchema.shape.formId,
+    taxYear: describeFormInputSchema.shape.taxYear,
+};
+export const metadata = {
+    name: "describe-form",
+    description: "Return a field-level description of a supported form schema.",
+    annotations: {
+        title: "Describe form",
+        readOnlyHint: true,
+        idempotentHint: true,
+        destructiveHint: false,
+    },
+};
+export default async function describeFormTool(args) {
+    return withStructuredContent({
+        ...describeForm(args.formId),
+        flaggedFields: [],
+    });
+}
+//# sourceMappingURL=describe-form.js.map

package/dist/src/mcp/tools/describe-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-form.js","sourceRoot":"","sources":["../../../../src/mcp/tools/describe-form.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,MAAM,EAAE,uBAAuB,CAAC,KAAK,CAAC,MAAM;IAC5C,OAAO,EAAE,uBAAuB,CAAC,KAAK,CAAC,OAAO;CAC/C,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAiB;IACpC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,8DAA8D;IAC3E,WAAW,EAAE;QACX,KAAK,EAAE,eAAe;QACtB,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,KAAK;KACvB;CACF,CAAC;AAEF,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAgC;IAC7E,OAAO,qBAAqB,CAAC;QAC3B,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC;QAC5B,aAAa,EAAE,EAAE;KAClB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/mcp/tools/describe-workflow.d.ts

@@ -0,0 +1,6 @@
+import { type InferSchema, type ToolMetadata } from "xmcp";
+export declare const schema: {
+    workflowId: import("zod").ZodString;
+};
+export declare const metadata: ToolMetadata;
+export default function describeWorkflowTool(args: InferSchema<typeof schema>): any;

package/dist/src/mcp/tools/describe-workflow.js

@@ -0,0 +1,16 @@
+import { describeWorkflowDefinition, describeWorkflowInputSchema } from "../shared.js";
+import { withStructuredContent } from "../result.js";
+export const schema = {
+    workflowId: describeWorkflowInputSchema.shape.workflowId,
+};
+export const metadata = {
+    name: "describe-workflow",
+    description: "Describe a workflow schema, starter data, and guided sections.",
+};
+export default function describeWorkflowTool(args) {
+    return withStructuredContent({
+        ...describeWorkflowDefinition(args.workflowId),
+        flaggedFields: [],
+    });
+}
+//# sourceMappingURL=describe-workflow.js.map

package/dist/src/mcp/tools/describe-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tools/describe-workflow.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,UAAU,EAAE,2BAA2B,CAAC,KAAK,CAAC,UAAU;CACzD,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAiB;IACpC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,gEAAgE;CAC9E,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAC1C,IAAgC;IAEhC,OAAO,qBAAqB,CAAC;QAC3B,GAAG,0BAA0B,CAAC,IAAI,CAAC,UAAU,CAAC;QAC9C,aAAa,EAAE,EAAE;KAClB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/mcp/tools/explain-flag.d.ts

@@ -0,0 +1,7 @@
+import { type InferSchema, type ToolMetadata } from "xmcp";
+export declare const schema: {
+    bundle: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
+    field: import("zod").ZodString;
+};
+export declare const metadata: ToolMetadata;
+export default function explainFlagTool(args: InferSchema<typeof schema>): any;

package/dist/src/mcp/tools/explain-flag.js

@@ -0,0 +1,19 @@
+import { explainFlag, explainFlagInputSchema } from "../shared.js";
+import { withStructuredContent } from "../result.js";
+export const schema = {
+    bundle: explainFlagInputSchema.shape.bundle,
+    field: explainFlagInputSchema.shape.field,
+};
+export const metadata = {
+    name: "explain-flag",
+    description: "Explain a flagged field from a workflow bundle and suggest a next step.",
+};
+export default function explainFlagTool(args) {
+    const result = explainFlag(args.bundle, args.field);
+    return withStructuredContent({
+        ok: result.found,
+        flaggedFields: [],
+        ...result,
+    });
+}
+//# sourceMappingURL=explain-flag.js.map

package/dist/src/mcp/tools/explain-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-flag.js","sourceRoot":"","sources":["../../../../src/mcp/tools/explain-flag.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,MAAM,EAAE,sBAAsB,CAAC,KAAK,CAAC,MAAM;IAC3C,KAAK,EAAE,sBAAsB,CAAC,KAAK,CAAC,KAAK;CAC1C,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAiB;IACpC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,yEAAyE;CACvF,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,IAAgC;IACtE,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,qBAAqB,CAAC;QAC3B,EAAE,EAAE,MAAM,CAAC,KAAK;QAChB,aAAa,EAAE,EAAE;QACjB,GAAG,MAAM;KACV,CAAC,CAAC;AACL,CAAC"}

package/dist/src/mcp/tools/extract-document.d.ts

@@ -0,0 +1,13 @@
+export declare const schema: {
+    path: import("zod").ZodString;
+    type: import("zod").ZodOptional<import("zod").ZodEnum<{
+        w2: "w2";
+        "1099-nec": "1099-nec";
+        "1099-int": "1099-int";
+    }>>;
+};
+export declare const metadata: {
+    title: string;
+    description: string;
+};
+export default function extractDocumentTool(input: unknown): Promise<any>;

package/dist/src/mcp/tools/extract-document.js

@@ -0,0 +1,20 @@
+import { extractDocumentFromPath, extractDocumentInputSchema } from "../shared.js";
+import { withStructuredContent } from "../result.js";
+export const schema = extractDocumentInputSchema.shape;
+export const metadata = {
+    title: "Extract document",
+    description: "Extract W-2 and 1099 source document data from a local PDF.",
+};
+export default async function extractDocumentTool(input) {
+    const parsed = extractDocumentInputSchema.parse(input);
+    const result = await extractDocumentFromPath(parsed.path, parsed.type);
+    return withStructuredContent({
+        ok: true,
+        flaggedFields: result.flaggedFields,
+        detectedType: result.documentType,
+        confidence: result.confidence,
+        document: result.extracted ?? { type: "unknown" },
+        textPreview: result.text.slice(0, 500),
+    });
+}
+//# sourceMappingURL=extract-document.js.map