pigeongov 0.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract-document.js","sourceRoot":"","sources":["../../../../src/mcp/tools/extract-document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,CAAC,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC;AAEvD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,6DAA6D;CAC3E,CAAC;AAEF,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,mBAAmB,CAAC,KAAc;IAC9D,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAEvE,OAAO,qBAAqB,CAAC;QAC3B,EAAE,EAAE,IAAI;QACR,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE;QACjD,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;KACvC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/mcp/tools/fees.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 listFeesTool(args: InferSchema<typeof schema>): any;

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

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { withStructuredContent } from "../result.js";
+import { DEFAULT_FEES, getWorkflowFees, calculateTotalFees, } from "../../workflows/fees.js";
+export const schema = {
+    workflowId: z.string().trim().min(1).optional(),
+};
+export const metadata = {
+    name: "pigeongov-list-fees",
+    description: "List fees associated with government workflows. Optionally filter by workflow ID.",
+};
+export default function listFeesTool(args) {
+    let fees = DEFAULT_FEES;
+    if (args.workflowId) {
+        fees = getWorkflowFees(fees, args.workflowId);
+    }
+    const total = calculateTotalFees(fees);
+    return withStructuredContent({
+        ok: true,
+        fees,
+        total,
+        flaggedFields: [],
+    });
+}
+//# sourceMappingURL=fees.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fees.js","sourceRoot":"","sources":["../../../../src/mcp/tools/fees.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EACL,YAAY,EACZ,eAAe,EACf,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAEjC,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,qBAAqB;IAC3B,WAAW,EACT,mFAAmF;CACtF,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,YAAY,CAClC,IAAgC;IAEhC,IAAI,IAAI,GAAG,YAAY,CAAC;IAExB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,IAAI,GAAG,eAAe,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,KAAK,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAEvC,OAAO,qBAAqB,CAAC;QAC3B,EAAE,EAAE,IAAI;QACR,IAAI;QACJ,KAAK;QACL,aAAa,EAAE,EAAE;KAClB,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,56 @@
+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>>;
+    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>;
+    documents: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+        path: import("zod").ZodString;
+        type: import("zod").ZodOptional<import("zod").ZodEnum<{
+            w2: "w2";
+            "1099-nec": "1099-nec";
+            "1099-int": "1099-int";
+        }>>;
+    }, import("zod/v4/core").$strict>>>;
+};
+export declare const metadata: {
+    title: string;
+    description: string;
+};
+export default function fillFormTool(input: unknown): any;

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

@@ -0,0 +1,47 @@
+import { fillFormInputSchema, } from "../shared.js";
+import { withStructuredContent } from "../result.js";
+import { buildValidated1040Bundle } from "../return-bundle.js";
+export const schema = fillFormInputSchema.shape;
+export const metadata = {
+    title: "Fill form",
+    description: "Build a validated form bundle from structured data and optional source documents.",
+};
+export default function fillFormTool(input) {
+    const parsed = fillFormInputSchema.parse(input);
+    const validationBundle = parsed.formId === "1040" ? buildValidated1040Bundle(parsed.data) : undefined;
+    if (parsed.formId !== "1040") {
+        return withStructuredContent({
+            ok: true,
+            formId: parsed.formId,
+            taxYear: parsed.taxYear ?? 2025,
+            flaggedFields: [],
+            calculation: undefined,
+            validation: {
+                validationChecks: [],
+                flaggedFields: [],
+            },
+            filledForm: {
+                formId: parsed.formId,
+                taxYear: parsed.taxYear ?? 2025,
+                data: parsed.data,
+            },
+        });
+    }
+    const { calculation, bundle, validation } = validationBundle;
+    return withStructuredContent({
+        ok: true,
+        formId: parsed.formId,
+        taxYear: parsed.taxYear ?? 2025,
+        flaggedFields: validation.flaggedFields,
+        calculation,
+        validation: {
+            validationChecks: validation.checks,
+            flaggedFields: validation.flaggedFields,
+        },
+        filledForm: {
+            ...bundle,
+            calculation,
+        },
+    });
+}
+//# sourceMappingURL=fill-form.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fill-form.js","sourceRoot":"","sources":["../../../../src/mcp/tools/fill-form.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,GACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,CAAC,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC;AAEhD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,WAAW;IAClB,WAAW,EAAE,mFAAmF;CACjG,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,KAAc;IACjD,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,gBAAgB,GACpB,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE/E,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC7B,OAAO,qBAAqB,CAAC;YAC3B,EAAE,EAAE,IAAI;YACR,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;YAC/B,aAAa,EAAE,EAAE;YACjB,WAAW,EAAE,SAAS;YACtB,UAAU,EAAE;gBACV,gBAAgB,EAAE,EAAE;gBACpB,aAAa,EAAE,EAAE;aAClB;YACD,UAAU,EAAE;gBACV,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;gBAC/B,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB;SACF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,gBAAiB,CAAC;IAE9D,OAAO,qBAAqB,CAAC;QAC3B,EAAE,EAAE,IAAI;QACR,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;QAC/B,aAAa,EAAE,UAAU,CAAC,aAAa;QACvC,WAAW;QACX,UAAU,EAAE;YACV,gBAAgB,EAAE,UAAU,CAAC,MAAM;YACnC,aAAa,EAAE,UAAU,CAAC,aAAa;SACxC;QACD,UAAU,EAAE;YACV,GAAG,MAAM;YACT,WAAW;SACZ;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/src/mcp/tools/fill-workflow.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 fillWorkflowTool(args: InferSchema<typeof schema>): any;

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

@@ -0,0 +1,24 @@
+import { fillWorkflow, fillWorkflowInputSchema } from "../shared.js";
+import { withStructuredContent } from "../result.js";
+export const schema = {
+    workflowId: fillWorkflowInputSchema.shape.workflowId,
+    data: fillWorkflowInputSchema.shape.data,
+};
+export const metadata = {
+    name: "fill-workflow",
+    description: "Build a validated workflow bundle from structured workflow data.",
+};
+export default function fillWorkflowTool(args) {
+    const bundle = fillWorkflow(args.workflowId, args.data);
+    return withStructuredContent({
+        ok: !bundle.validation.flaggedFields.some((flag) => flag.severity === "error"),
+        workflowId: bundle.workflowId,
+        domain: bundle.domain,
+        review: bundle.review,
+        validation: bundle.validation,
+        flaggedFields: bundle.validation.flaggedFields,
+        outputArtifacts: bundle.outputArtifacts,
+        bundle,
+    });
+}
+//# sourceMappingURL=fill-workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fill-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tools/fill-workflow.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,UAAU,EAAE,uBAAuB,CAAC,KAAK,CAAC,UAAU;IACpD,IAAI,EAAE,uBAAuB,CAAC,KAAK,CAAC,IAAI;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAiB;IACpC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,kEAAkE;CAChF,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,IAAgC;IACvE,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAExD,OAAO,qBAAqB,CAAC;QAC3B,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC;QAC9E,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,aAAa;QAC9C,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,MAAM;KACP,CAAC,CAAC;AACL,CAAC"}

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

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

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

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { withStructuredContent } from "../result.js";
+import { lookupTerm, searchTerms, getTermsForDomain } from "../../glossary/index.js";
+export const schema = {
+    term: z.string().trim().min(1),
+    domain: z.string().trim().min(1).optional(),
+};
+export const metadata = {
+    name: "pigeongov-lookup-term",
+    description: "Look up a plain-language definition of a government or tax term. Returns an exact match or fuzzy search results.",
+};
+export default function lookupTermTool(args) {
+    // If domain specified, search within that domain
+    if (args.domain) {
+        const domainTerms = getTermsForDomain(args.domain);
+        const needle = args.term.toLowerCase();
+        const match = domainTerms.find((e) => e.term.toLowerCase() === needle ||
+            (e.abbreviation !== undefined && e.abbreviation.toLowerCase() === needle));
+        if (match) {
+            return withStructuredContent({
+                ok: true,
+                entry: match,
+                flaggedFields: [],
+            });
+        }
+        const results = domainTerms.filter((e) => e.term.toLowerCase().includes(needle) ||
+            (e.abbreviation !== undefined && e.abbreviation.toLowerCase().includes(needle)) ||
+            e.definition.toLowerCase().includes(needle));
+        return withStructuredContent({
+            ok: results.length > 0,
+            query: args.term,
+            domain: args.domain,
+            results,
+            flaggedFields: [],
+        });
+    }
+    // No domain: look up across all domains
+    const exact = lookupTerm(args.term);
+    if (exact) {
+        return withStructuredContent({
+            ok: true,
+            entry: exact,
+            flaggedFields: [],
+        });
+    }
+    const results = searchTerms(args.term);
+    return withStructuredContent({
+        ok: results.length > 0,
+        query: args.term,
+        results,
+        flaggedFields: [],
+    });
+}
+//# sourceMappingURL=glossary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.js","sourceRoot":"","sources":["../../../../src/mcp/tools/glossary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAGrF,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAiB;IACpC,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,kHAAkH;CACrH,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,cAAc,CACpC,IAAgC;IAEhC,iDAAiD;IACjD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,MAAwB,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM;YAC/B,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAC5E,CAAC;QAEF,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,qBAAqB,CAAC;gBAC3B,EAAE,EAAE,IAAI;gBACR,KAAK,EAAE,KAAK;gBACZ,aAAa,EAAE,EAAE;aAClB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;YACrC,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/E,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAC9C,CAAC;QAEF,OAAO,qBAAqB,CAAC;YAC3B,EAAE,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;YACtB,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO;YACP,aAAa,EAAE,EAAE;SAClB,CAAC,CAAC;IACL,CAAC;IAED,wCAAwC;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEpC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,qBAAqB,CAAC;YAC3B,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,KAAK;YACZ,aAAa,EAAE,EAAE;SAClB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEvC,OAAO,qBAAqB,CAAC;QAC3B,EAAE,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;QACtB,KAAK,EAAE,IAAI,CAAC,IAAI;QAChB,OAAO;QACP,aAAa,EAAE,EAAE;KAClB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/mcp/tools/list-forms.d.ts

@@ -0,0 +1,6 @@
+export declare const schema: {};
+export declare const metadata: {
+    title: string;
+    description: string;
+};
+export default function listFormsTool(_input?: unknown): any;

package/dist/src/mcp/tools/list-forms.js

@@ -0,0 +1,15 @@
+import { listForms } from "../shared.js";
+import { withStructuredContent } from "../result.js";
+export const schema = {};
+export const metadata = {
+    title: "List forms",
+    description: "List supported PigeonGov schemas for the current tax year.",
+};
+export default function listFormsTool(_input) {
+    return withStructuredContent({
+        ok: true,
+        flaggedFields: [],
+        forms: listForms(),
+    });
+}
+//# sourceMappingURL=list-forms.js.map

package/dist/src/mcp/tools/list-forms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-forms.js","sourceRoot":"","sources":["../../../../src/mcp/tools/list-forms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,CAAC;AAEzB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,YAAY;IACnB,WAAW,EAAE,4DAA4D;CAC1E,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,MAAgB;IACpD,OAAO,qBAAqB,CAAC;QAC3B,EAAE,EAAE,IAAI;QACR,aAAa,EAAE,EAAE;QACjB,KAAK,EAAE,SAAS,EAAE;KACnB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/mcp/tools/list-workflows.d.ts

@@ -0,0 +1,6 @@
+export declare const schema: {};
+export declare const metadata: {
+    title: string;
+    description: string;
+};
+export default function listWorkflowsTool(): any;

package/dist/src/mcp/tools/list-workflows.js

@@ -0,0 +1,16 @@
+import { listWorkflows, workflowDomains } from "../shared.js";
+import { withStructuredContent } from "../result.js";
+export const schema = {};
+export const metadata = {
+    title: "List workflows",
+    description: "List supported PigeonGov workflows across tax and non-tax domains.",
+};
+export default function listWorkflowsTool() {
+    return withStructuredContent({
+        ok: true,
+        domains: workflowDomains(),
+        workflows: listWorkflows(),
+        flaggedFields: [],
+    });
+}
+//# sourceMappingURL=list-workflows.js.map

package/dist/src/mcp/tools/list-workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-workflows.js","sourceRoot":"","sources":["../../../../src/mcp/tools/list-workflows.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,CAAC,MAAM,MAAM,GAAG,EAAE,CAAC;AAEzB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EAAE,oEAAoE;CAClF,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,iBAAiB;IACvC,OAAO,qBAAqB,CAAC;QAC3B,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,eAAe,EAAE;QAC1B,SAAS,EAAE,aAAa,EAAE;QAC1B,aAAa,EAAE,EAAE;KAClB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/mcp/tools/plan-life-event.d.ts

@@ -0,0 +1,59 @@
+import { z } from "zod";
+import type { ToolMetadata } from "xmcp";
+export declare const schema: {
+    eventId: z.ZodOptional<z.ZodString>;
+};
+export declare const metadata: ToolMetadata;
+export default function planLifeEventTool(args: {
+    eventId?: string;
+}): ({
+    ok: boolean;
+    events: {
+        id: string;
+        label: string;
+        description: string;
+        workflowCount: number;
+    }[];
+} & {
+    structuredContent: {
+        ok: boolean;
+        events: {
+            id: string;
+            label: string;
+            description: string;
+            workflowCount: number;
+        }[];
+    };
+}) | ({
+    ok: boolean;
+    error: string;
+    availableEvents: string[];
+} & {
+    structuredContent: {
+        ok: boolean;
+        error: string;
+        availableEvents: string[];
+    };
+}) | ({
+    ok: boolean;
+    event: {
+        id: string;
+        label: string;
+        description: string;
+    };
+    totalWorkflows: number;
+    hasUrgentDeadlines: boolean;
+    workflows: import("../../advisory/life-events/planner.js").PlannedWorkflow[];
+} & {
+    structuredContent: {
+        ok: boolean;
+        event: {
+            id: string;
+            label: string;
+            description: string;
+        };
+        totalWorkflows: number;
+        hasUrgentDeadlines: boolean;
+        workflows: import("../../advisory/life-events/planner.js").PlannedWorkflow[];
+    };
+});

package/dist/src/mcp/tools/plan-life-event.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { withStructuredContent } from "../result.js";
+import { planLifeEvent, listLifeEvents } from "../../advisory/life-events/planner.js";
+export const schema = {
+    eventId: z.string().optional().describe("Life event ID (e.g., 'job-loss', 'marriage'). Omit to list all events."),
+};
+export const metadata = {
+    name: "pigeongov_plan_life_event",
+    description: "Get a prioritized action plan for a life event. Returns ordered workflow recommendations with deadlines and dependencies. Omit eventId to list available life events.",
+};
+export default function planLifeEventTool(args) {
+    if (!args.eventId) {
+        const events = listLifeEvents().map((e) => ({
+            id: e.id,
+            label: e.label,
+            description: e.description,
+            workflowCount: e.workflows.length,
+        }));
+        return withStructuredContent({ ok: true, events });
+    }
+    const plan = planLifeEvent(args.eventId);
+    if (!plan) {
+        return withStructuredContent({
+            ok: false,
+            error: `Unknown life event: "${args.eventId}"`,
+            availableEvents: listLifeEvents().map((e) => e.id),
+        });
+    }
+    return withStructuredContent({
+        ok: true,
+        event: {
+            id: plan.event.id,
+            label: plan.event.label,
+            description: plan.event.description,
+        },
+        totalWorkflows: plan.totalWorkflows,
+        hasUrgentDeadlines: plan.hasUrgentDeadlines,
+        workflows: plan.orderedWorkflows,
+    });
+}
+//# sourceMappingURL=plan-life-event.js.map

package/dist/src/mcp/tools/plan-life-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-life-event.js","sourceRoot":"","sources":["../../../../src/mcp/tools/plan-life-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAEtF,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wEAAwE,CAAC;CAClH,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAiB;IACpC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,uKAAuK;CAC1K,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,iBAAiB,CAAC,IAA0B;IAClE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1C,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,aAAa,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM;SAClC,CAAC,CAAC,CAAC;QACJ,OAAO,qBAAqB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,qBAAqB,CAAC;YAC3B,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,wBAAwB,IAAI,CAAC,OAAO,GAAG;YAC9C,eAAe,EAAE,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,qBAAqB,CAAC;QAC3B,EAAE,EAAE,IAAI;QACR,KAAK,EAAE;YACL,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK;YACvB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;SACpC;QACD,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,SAAS,EAAE,IAAI,CAAC,gBAAgB;KACjC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/mcp/tools/review-form.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 reviewFormTool(input: unknown): any;

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

@@ -0,0 +1,26 @@
+import { reviewTaxInput, calculateTaxInputSchema, } from "../shared.js";
+import { withStructuredContent } from "../result.js";
+import { buildValidated1040Bundle } from "../return-bundle.js";
+export const schema = calculateTaxInputSchema.shape;
+export const metadata = {
+    title: "Review form",
+    description: "Generate a human-readable review summary for a filled form.",
+};
+export default function reviewFormTool(input) {
+    const parsed = calculateTaxInputSchema.parse(input);
+    const taxReview = reviewTaxInput(parsed.data);
+    const validationBundle = buildValidated1040Bundle(parsed.data);
+    return withStructuredContent({
+        ok: true,
+        flaggedFields: validationBundle.validation.flaggedFields,
+        summary: {
+            headline: taxReview.headline,
+            notes: taxReview.notes,
+            flaggedFields: validationBundle.validation.flaggedFields,
+        },
+        validationChecks: validationBundle.validation.checks,
+        calculation: taxReview.calculation,
+        parsed: parsed.data,
+    });
+}
+//# sourceMappingURL=review-form.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review-form.js","sourceRoot":"","sources":["../../../../src/mcp/tools/review-form.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,CAAC,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC;AAEpD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,aAAa;IACpB,WAAW,EAAE,6DAA6D;CAC3E,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,KAAc;IACnD,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,gBAAgB,GAAG,wBAAwB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE/D,OAAO,qBAAqB,CAAC;QAC3B,EAAE,EAAE,IAAI;QACR,aAAa,EAAE,gBAAgB,CAAC,UAAU,CAAC,aAAa;QACxD,OAAO,EAAE;YACP,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,aAAa,EAAE,gBAAgB,CAAC,UAAU,CAAC,aAAa;SACzD;QACD,gBAAgB,EAAE,gBAAgB,CAAC,UAAU,CAAC,MAAM;QACpD,WAAW,EAAE,SAAS,CAAC,WAAW;QAClC,MAAM,EAAE,MAAM,CAAC,IAAI;KACpB,CAAC,CAAC;AACL,CAAC"}

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

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

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

@@ -0,0 +1,27 @@
+import { reviewWorkflow, reviewWorkflowInputSchema } from "../shared.js";
+import { withStructuredContent } from "../result.js";
+export const schema = {
+    workflowId: reviewWorkflowInputSchema.shape.workflowId,
+    bundle: reviewWorkflowInputSchema.shape.bundle,
+};
+export const metadata = {
+    name: "review-workflow",
+    description: "Generate a human-readable review summary for a workflow bundle or structured input.",
+};
+export default function reviewWorkflowTool(args) {
+    const result = typeof args.bundle.workflowId === "string"
+        ? {
+            bundle: args.bundle,
+            review: args.bundle.review,
+            validation: args.bundle.validation,
+        }
+        : reviewWorkflow(args.workflowId ?? "tax/1040", args.bundle);
+    return withStructuredContent({
+        ok: true,
+        summary: result.review,
+        validation: result.validation,
+        flaggedFields: result.validation.flaggedFields,
+        bundle: result.bundle,
+    });
+}
+//# sourceMappingURL=review-workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tools/review-workflow.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,UAAU,EAAE,yBAAyB,CAAC,KAAK,CAAC,UAAU;IACtD,MAAM,EAAE,yBAAyB,CAAC,KAAK,CAAC,MAAM;CAC/C,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAiB;IACpC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,qFAAqF;CACnG,CAAC;AAEF,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAAC,IAAgC;IACzE,MAAM,MAAM,GACV,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,QAAQ;QACxC,CAAC,CAAC;YACE,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAG,IAAI,CAAC,MAA8B,CAAC,MAAM;YACnD,UAAU,EAAG,IAAI,CAAC,MAAkC,CAAC,UAAU;SAChE;QACH,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,IAAI,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjE,OAAO,qBAAqB,CAAC;QAC3B,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,MAAM,CAAC,MAAM;QACtB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,aAAa,EAAG,MAAM,CAAC,UAA2C,CAAC,aAAa;QAChF,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/mcp/tools/screen-eligibility.d.ts

@@ -0,0 +1,53 @@
+import { z } from "zod";
+import type { ToolMetadata } from "xmcp";
+import { screenerInputSchema } from "../../advisory/screener/intake.js";
+export declare const schema: {
+    householdSize: z.ZodCoercedNumber<unknown>;
+    annualHouseholdIncome: z.ZodCoercedNumber<unknown>;
+    state: z.ZodString;
+    citizenshipStatus: z.ZodEnum<{
+        other: "other";
+        permanent_resident: "permanent_resident";
+        us_citizen: "us_citizen";
+        conditional_resident: "conditional_resident";
+        ead_holder: "ead_holder";
+        undocumented: "undocumented";
+        refugee_asylee: "refugee_asylee";
+    }>;
+    ages: z.ZodArray<z.ZodCoercedNumber<unknown>>;
+    hasDisability: z.ZodDefault<z.ZodBoolean>;
+    employmentStatus: z.ZodEnum<{
+        disabled: "disabled";
+        employed: "employed";
+        unemployed: "unemployed";
+        self_employed: "self_employed";
+        retired: "retired";
+    }>;
+    isVeteran: z.ZodDefault<z.ZodBoolean>;
+    hasHealthInsurance: z.ZodDefault<z.ZodBoolean>;
+    monthlyRent: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+};
+export declare const metadata: ToolMetadata;
+export default function screenEligibilityTool(args: z.infer<typeof screenerInputSchema>): ({
+    ok: boolean;
+    error: string;
+    details: z.core.$ZodIssue[];
+} & {
+    structuredContent: {
+        ok: boolean;
+        error: string;
+        details: z.core.$ZodIssue[];
+    };
+}) | ({
+    ok: boolean;
+    summary: string;
+    results: import("../../types.js").EligibilityResult[];
+    totalScreened: number;
+} & {
+    structuredContent: {
+        ok: boolean;
+        summary: string;
+        results: import("../../types.js").EligibilityResult[];
+        totalScreened: number;
+    };
+});

package/dist/src/mcp/tools/screen-eligibility.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { withStructuredContent } from "../result.js";
+import { screenerInputSchema } from "../../advisory/screener/intake.js";
+import { screenEligibility } from "../../advisory/screener/engine.js";
+export const schema = {
+    householdSize: z.coerce.number().int().min(1).max(20).describe("Number of people in household"),
+    annualHouseholdIncome: z.coerce.number().min(0).describe("Total annual household income before taxes"),
+    state: z.string().length(2).describe("Two-letter state code (e.g., CA, NY, TX)"),
+    citizenshipStatus: z
+        .enum(["us_citizen", "permanent_resident", "conditional_resident", "ead_holder", "undocumented", "refugee_asylee", "other"])
+        .describe("Citizenship or immigration status"),
+    ages: z.array(z.coerce.number().int().min(0).max(120)).describe("Ages of all household members"),
+    hasDisability: z.boolean().default(false).describe("Whether anyone in household has a disability"),
+    employmentStatus: z
+        .enum(["employed", "unemployed", "self_employed", "retired", "disabled"])
+        .describe("Current employment status"),
+    isVeteran: z.boolean().default(false).describe("Whether anyone in household is a military veteran"),
+    hasHealthInsurance: z.boolean().default(true).describe("Whether everyone has health insurance"),
+    monthlyRent: z.coerce.number().min(0).default(0).describe("Monthly rent or mortgage payment"),
+};
+export const metadata = {
+    name: "pigeongov_screen_eligibility",
+    description: "Universal eligibility screener. Takes 10 household data points and returns a tiered list of government programs the household may qualify for, with confidence levels and next steps.",
+};
+export default function screenEligibilityTool(args) {
+    const parsed = screenerInputSchema.safeParse(args);
+    if (!parsed.success) {
+        return withStructuredContent({
+            ok: false,
+            error: "Invalid screener input",
+            details: parsed.error.issues,
+        });
+    }
+    const results = screenEligibility(parsed.data);
+    const likely = results.filter((r) => r.eligible === "likely");
+    const possible = results.filter((r) => r.eligible === "possible");
+    return withStructuredContent({
+        ok: true,
+        summary: `Found ${likely.length} likely eligible and ${possible.length} possibly eligible programs`,
+        results,
+        totalScreened: results.length,
+    });
+}
+//# sourceMappingURL=screen-eligibility.js.map