@oomol-lab/open-connector 1.9.0 → 1.9.1

package/src/providers/hrmos_kintai/business-schemas.js

@@ -0,0 +1,320 @@
+import { s } from "../../core/json-schema.js";
+const dealPurchaseSchema = s.object("Supplier payment-notice data.", {
+    id: s.integer("Record ID."),
+    business_partner_id: s.integer("Business partner ID."),
+    partner_number: s.string("Business partner number."),
+    postal_code: s.string("Postal code."),
+    prefectural_id: s.integer("Prefecture ID."),
+    city: s.string("City, district and street address."),
+    building: s.string("Building name."),
+    branch: s.string("Department."),
+    appointment: s.string("Job title."),
+    person: s.string("Billing or payment contact person."),
+    pay_type: s.integer("Rate type: 0 hourly with adjustments, 10 single hourly rate, 1 monthly with adjustments, 11 single monthly rate."),
+    monthly_price: s.integer("Monthly rate."),
+    min_hour: s.integer("Lower bound of base working hours."),
+    max_hour: s.integer("Upper bound of base working hours."),
+    surplus: s.integer("Excess-hours rate."),
+    surplus_fractional_price: s.integer("Amount used to round the excess-hours rate."),
+    surplus_fractional: s.integer("Excess-rate rounding: 1 up, 2 down, 3 nearest."),
+    deduction: s.integer("Deduction amount or rate in the contract settlement settings."),
+    deduction_fractional_price: s.integer("Amount used to round deductions."),
+    deduction_fractional: s.integer("Deduction rounding: 1 up, 2 down, 3 nearest."),
+    fractional_total: s.integer("Daily total working-time rounding: 0 none, 1 up, 2 down."),
+    fractional_minute_total: s.integer("Rounding interval in minutes for daily total working time."),
+    fractional_start_at: s.integer("Clock-in rounding mode. 0 none, 1 up, 2 down."),
+    fractional_minute_start_at: s.integer("Clock-in rounding interval in minutes."),
+    fractional_end_at: s.integer("Clock-out rounding mode. 0 none, 1 up, 2 down."),
+    fractional_minute_end_at: s.integer("Clock-out rounding interval in minutes."),
+    fractional: s.integer("Settlement rounding mode."),
+    fractional_minute: s.integer("Settlement rounding interval in minutes."),
+    subject: s.string("Document subject."),
+    show_year_month: s.boolean("Document show year and month."),
+    show_work_time: s.boolean("Document show working time."),
+    memo: s.string("Document memo."),
+    hourly_price: s.integer("Regular hourly rate."),
+    late_night_price: s.integer("Regular late-night hourly rate."),
+    overtime_price: s.integer("Overtime hourly rate."),
+    overtime_late_night_price: s.integer("Late-night overtime hourly rate."),
+    over_60_hour_price: s.integer("Hourly rate for overtime beyond 60 hours."),
+    over_60_hour_late_night_price: s.integer("Late-night hourly rate for overtime beyond 60 hours."),
+    holiday_1_price: s.integer("Non-statutory holiday hourly rate."),
+    holiday_1_late_night_price: s.integer("Non-statutory holiday late-night hourly rate."),
+    holiday_2_price: s.integer("Statutory holiday hourly rate."),
+    holiday_2_late_night_price: s.integer("Statutory holiday late-night hourly rate."),
+}, { required: [] });
+const dealPurchaseInvoiceSchema = s.object("Supplier purchase-invoice data.", {
+    id: s.integer("Record ID."),
+    business_partner_id: s.integer("Business partner ID."),
+    partner_number: s.string("Business partner number."),
+    postal_code: s.string("Postal code."),
+    prefectural_id: s.integer("Prefecture ID."),
+    city: s.string("City, district and street address."),
+    building: s.string("Building name."),
+    branch: s.string("Department."),
+    appointment: s.string("Job title."),
+    person: s.string("Billing or payment contact person."),
+    pay_type: s.integer("Rate type: 0 hourly with adjustments, 10 single hourly rate, 1 monthly with adjustments, 11 single monthly rate."),
+    monthly_price: s.integer("Monthly rate."),
+    min_hour: s.integer("Lower bound of base working hours."),
+    max_hour: s.integer("Upper bound of base working hours."),
+    surplus: s.integer("Excess-hours rate."),
+    surplus_fractional_price: s.integer("Amount used to round the excess-hours rate."),
+    surplus_fractional: s.integer("Excess-rate rounding: 1 up, 2 down, 3 nearest."),
+    deduction: s.integer("Deduction amount or rate in the contract settlement settings."),
+    deduction_fractional_price: s.integer("Amount used to round deductions."),
+    deduction_fractional: s.integer("Deduction rounding: 1 up, 2 down, 3 nearest."),
+    fractional_total: s.integer("Daily total working-time rounding: 0 none, 1 up, 2 down."),
+    fractional_minute_total: s.integer("Rounding interval in minutes for daily total working time."),
+    fractional_start_at: s.integer("Clock-in rounding mode. 0 none, 1 up, 2 down."),
+    fractional_minute_start_at: s.integer("Clock-in rounding interval in minutes."),
+    fractional_end_at: s.integer("Clock-out rounding mode. 0 none, 1 up, 2 down."),
+    fractional_minute_end_at: s.integer("Clock-out rounding interval in minutes."),
+    fractional: s.integer("Settlement rounding mode."),
+    fractional_minute: s.integer("Settlement rounding interval in minutes."),
+    subject: s.string("Document subject."),
+    show_year_month: s.boolean("Document show year and month."),
+    show_work_time: s.boolean("Document show working time."),
+    memo: s.string("Document memo."),
+    hourly_price: s.integer("Regular hourly rate."),
+    late_night_price: s.integer("Regular late-night hourly rate."),
+    overtime_price: s.integer("Overtime hourly rate."),
+    overtime_late_night_price: s.integer("Late-night overtime hourly rate."),
+    over_60_hour_price: s.integer("Hourly rate for overtime beyond 60 hours."),
+    over_60_hour_late_night_price: s.integer("Late-night hourly rate for overtime beyond 60 hours."),
+    holiday_1_price: s.integer("Non-statutory holiday hourly rate."),
+    holiday_1_late_night_price: s.integer("Non-statutory holiday late-night hourly rate."),
+    holiday_2_price: s.integer("Statutory holiday hourly rate."),
+    holiday_2_late_night_price: s.integer("Statutory holiday late-night hourly rate."),
+}, { required: [] });
+const contractApproverSchema = s.object("Contract approver assignment.", {
+    id: s.integer("Record ID."),
+    deal_contract_id: s.integer("Contract ID."),
+    user_id: s.integer("Employee ID."),
+    deal_enabled: s.boolean("Whether this contract approver is enabled."),
+}, { required: [] });
+export const contractSchema = {
+    minProperties: 1,
+    ...s.object("Contract data, including rates, settlement, supplier documents and approvers.", {
+        id: s.integer("Record ID."),
+        business_partner_id: s.integer("Business partner ID."),
+        user_id: s.integer("Employee ID."),
+        contract_number: s.string("Contract number."),
+        contract_category: s.string("Contract category: contract, delegation, semi_delegation, regular_use_type_temping, registration_type_temping, introduction_plan_temping, maintenance or other."),
+        partner_number: s.string("Business partner number."),
+        postal_code: s.string("Postal code."),
+        prefectural_id: s.integer("Prefecture ID."),
+        city: s.string("City, district and street address."),
+        building: s.string("Building name."),
+        branch: s.string("Department."),
+        appointment: s.string("Job title."),
+        person: s.string("Billing or payment contact person."),
+        contract_notes: s.string("Contract notes."),
+        start_at: s.string("Contract start date.", { format: "date" }),
+        end_at: s.string("Contract end date.", { format: "date" }),
+        work_type: s.integer("Work report mode: 0 daily arrival/departure times, 1 monthly working hours only."),
+        pay_type: s.integer("Rate type: 0 hourly with adjustments, 10 single hourly rate, 1 monthly with adjustments, 11 single monthly rate."),
+        hourly_price: s.nullableInteger("Regular hourly rate."),
+        monthly_price: s.integer("Monthly rate."),
+        late_night_price: s.nullableInteger("Regular late-night hourly rate."),
+        overtime_price: s.nullableInteger("Overtime hourly rate."),
+        overtime_late_night_price: s.nullableInteger("Late-night overtime hourly rate."),
+        over_60_hour_price: s.nullableInteger("Hourly rate for overtime beyond 60 hours."),
+        over_60_hour_late_night_price: s.nullableInteger("Late-night hourly rate for overtime beyond 60 hours."),
+        holiday_1_price: s.nullableInteger("Non-statutory holiday hourly rate."),
+        holiday_1_late_night_price: s.nullableInteger("Non-statutory holiday late-night hourly rate."),
+        holiday_2_price: s.nullableInteger("Statutory holiday hourly rate."),
+        holiday_2_late_night_price: s.nullableInteger("Statutory holiday late-night hourly rate."),
+        min_hour: s.integer("Lower bound of base working hours."),
+        max_hour: s.integer("Upper bound of base working hours."),
+        surplus: s.integer("Excess-hours rate."),
+        surplus_fractional_price: s.integer("Amount used to round the excess-hours rate."),
+        surplus_fractional: s.integer("Excess-rate rounding: 1 up, 2 down, 3 nearest."),
+        deduction: s.integer("Deduction amount or rate in the contract settlement settings."),
+        deduction_fractional_price: s.integer("Amount used to round deductions."),
+        deduction_fractional: s.integer("Deduction rounding: 1 up, 2 down, 3 nearest."),
+        cutoff_date: s.integer("Billing cutoff day."),
+        pay_cycle: s.integer("Payment cycle: 0 current month, 1 next month, 2 two months later, 3 three months later."),
+        pay_date: s.integer("Payment day; 31 means month-end."),
+        fractional_total: s.integer("Daily total working-time rounding: 0 none, 2 down."),
+        fractional_minute_total: s.integer("Rounding interval in minutes for daily total working time."),
+        fractional_start_at: s.integer("Clock-in rounding mode. 1 up, 2 down, 3 nearest."),
+        fractional_minute_start_at: s.integer("Clock-in rounding interval in minutes."),
+        fractional_end_at: s.integer("Clock-out rounding mode. 1 up, 2 down, 3 nearest."),
+        fractional_minute_end_at: s.integer("Clock-out rounding interval in minutes."),
+        fractional: s.integer("Contract settlement rounding mode."),
+        fractional_minute: s.integer("Contract settlement rounding interval in minutes."),
+        subject: s.string("Document subject."),
+        show_year_month: s.boolean("Document show year and month."),
+        show_work_time: s.boolean("Document show working time."),
+        memo: s.string("Document memo."),
+        deal_purchase: { ...dealPurchaseSchema, description: "Supplier payment-notice settings." },
+        deal_purchase_invoice: {
+            ...dealPurchaseInvoiceSchema,
+            description: "Supplier purchase-invoice settings.",
+        },
+        deal_contract_user_approvers: s.array("Contract approver assignments.", contractApproverSchema),
+    }, { required: [] }),
+};
+export const businessPartnerSchema = {
+    minProperties: 1,
+    ...s.object("Business partner data. HRMOS validates required fields according to corporation or individual status; retain all applicable document settings.", {
+        id: s.integer("Record ID."),
+        last_name: s.string("Individual partner or contact family name."),
+        first_name: s.string("Individual partner or contact given name."),
+        last_name_kana: s.string("Individual partner family name in Katakana."),
+        first_name_kana: s.string("Individual partner given name in Katakana."),
+        lodgment_id: s.integer("Workplace ID."),
+        configuration: s.integer("Position of the legal entity designation: 0 none, 1 before the name, 2 after the name."),
+        configuration_label: s.integer("Legal entity designation ID: 1 stock company, 2 limited company, 3 religious corporation, 4 foundation, 5 association, 6 social welfare, 7 school, 8 medical, 9 public-interest corporation, 10 NPO, 11 LLC, 12 general partnership, 13 limited partnership, 14 general association, 15 public-interest association, 16 special association, 17 general foundation, 18 public-interest foundation, 19 special foundation, 20 legal professional, 21 tax accountant, 22 labor/social security attorney, 23 judicial scrivener corporation."),
+        deal_report_mail_subject: s.string("Consolidated billing email subject."),
+        deal_report_mail_body: s.string("Consolidated billing email body."),
+        name: s.string("Business partner name; required fields depend on whether the partner is a corporation or an individual."),
+        name_kana: s.string("Business partner name in Katakana."),
+        partner_number: s.string("Business partner number."),
+        invoice_code: s.string("Qualified invoice issuer registration number."),
+        postal_code: s.string("Postal code."),
+        prefectural_id: s.integer("Prefecture ID."),
+        city: s.string("City, district and street address."),
+        building: s.string("Building name."),
+        branch: s.string("Department."),
+        appointment: s.string("Job title."),
+        person: s.string("Billing or payment contact person."),
+        tel: s.string("Telephone number."),
+        email: s.string("Email address."),
+        cc_email: s.string("CC email address."),
+        fractional_total: s.integer("Daily total working-time rounding: 0 none, 1 up, 2 down."),
+        fractional_minute_total: s.integer("Rounding interval in minutes for daily total working time."),
+        fractional_start_at: s.integer("Clock-in rounding mode. 1 up, 2 down, 3 nearest."),
+        fractional_minute_start_at: s.integer("Clock-in rounding interval in minutes."),
+        fractional_end_at: s.integer("Clock-out rounding mode. 1 up, 2 down, 3 nearest."),
+        fractional_minute_end_at: s.integer("Clock-out rounding interval in minutes."),
+        invoice_create: s.integer("Whether to create sales invoices: 0 no, 1 yes."),
+        fractional: s.integer("Settlement rounding mode."),
+        fractional_minute: s.integer("Settlement rounding interval in minutes."),
+        cutoff_date: s.integer("Billing cutoff day."),
+        pay_cycle: s.integer("Payment cycle: 0 current month, 1 next month, 2 two months later, 3 three months later."),
+        pay_date: s.integer("Payment day; 31 means month-end."),
+        deal_document_purchases: s.array("Payment-notice attachments: purchase, work or expense.", {
+            ...s.string("Document type."),
+            enum: ["purchase", "work", "expense"],
+        }),
+        purchase_tax_type: {
+            ...s.string("Payment notice tax treatment: included or excluded."),
+            enum: ["included", "excluded"],
+        },
+        purchase_withholding: s.boolean("Payment notice withholding tax flag."),
+        purchase_subject: s.string("Payment notice subject."),
+        purchase_show_year_month: s.boolean("Payment notice show year and month."),
+        purchase_show_work_time: s.boolean("Payment notice show working time."),
+        purchase_main: s.string("Payment notice monthly base-work item label."),
+        purchase_deduction: s.string("Payment notice monthly deduction item label."),
+        purchase_surplus: s.string("Payment notice monthly excess-hours item label."),
+        purchase_username_view: s.boolean("Payment notice show employee name on monthly items."),
+        purchase_monthly_only_one: s.string("Payment notice single monthly rate item label."),
+        purchase_monthly_only_one_username_view: s.boolean("Payment notice show employee name on single monthly rate items."),
+        purchase_hourly_main: s.string("Payment notice regular hourly item label."),
+        purchase_late_night: s.string("Payment notice regular late-night item label."),
+        purchase_overtime: s.string("Payment notice overtime item label."),
+        purchase_overtime_late_night: s.string("Payment notice late-night overtime item label."),
+        purchase_over_60_hour: s.string("Payment notice overtime beyond 60 hours item label."),
+        purchase_over_60_hour_late_night: s.string("Payment notice late-night overtime beyond 60 hours item label."),
+        purchase_holiday_1: s.string("Payment notice non-statutory holiday item label."),
+        purchase_holiday_1_late_night: s.string("Payment notice non-statutory holiday late-night item label."),
+        purchase_holiday_2: s.string("Payment notice statutory holiday item label."),
+        purchase_holiday_2_late_night: s.string("Payment notice statutory holiday late-night item label."),
+        purchase_hourly_username_view: s.boolean("Payment notice show employee name on hourly items."),
+        purchase_hourly_only_one: s.string("Payment notice single hourly rate item label."),
+        purchase_hourly_only_one_username_view: s.boolean("Payment notice show employee name on single hourly rate items."),
+        bank_account: s.string("Document bank account for payment."),
+        purchase_notes: s.string("Payment notice notes."),
+        purchase_memo: s.string("Payment notice memo."),
+        purchase_mail_subject: s.string("Payment notice email subject."),
+        purchase_mail_body: s.string("Payment notice email body."),
+        deal_document_invoices: s.array("Sales-invoice attachments: invoice, work or expense.", {
+            ...s.string("Document type."),
+            enum: ["invoice", "work", "expense"],
+        }),
+        deal_document_totals: s.array("Consolidated billing attachments: invoice, work or expense.", {
+            ...s.string("Document type."),
+            enum: ["invoice", "work", "expense"],
+        }),
+        subject: s.string("Document subject."),
+        show_year_month: s.boolean("Document show year and month."),
+        show_work_time: s.boolean("Document show working time."),
+        invoice_main: s.string("Sales invoice monthly base-work item label."),
+        invoice_deduction: s.string("Sales invoice monthly deduction item label."),
+        invoice_surplus: s.string("Sales invoice monthly excess-hours item label."),
+        invoice_username_view: s.boolean("Sales invoice show employee name on monthly items."),
+        invoice_monthly_only_one: s.string("Sales invoice single monthly rate item label."),
+        invoice_monthly_only_one_username_view: s.boolean("Sales invoice show employee name on single monthly rate items."),
+        invoice_hourly_main: s.string("Sales invoice regular hourly item label."),
+        invoice_late_night: s.string("Sales invoice regular late-night item label."),
+        invoice_overtime: s.string("Sales invoice overtime item label."),
+        invoice_overtime_late_night: s.string("Sales invoice late-night overtime item label."),
+        invoice_over_60_hour: s.string("Sales invoice overtime beyond 60 hours item label."),
+        invoice_over_60_hour_late_night: s.string("Sales invoice late-night overtime beyond 60 hours item label."),
+        invoice_holiday_1: s.string("Sales invoice non-statutory holiday item label."),
+        invoice_holiday_1_late_night: s.string("Sales invoice non-statutory holiday late-night item label."),
+        invoice_holiday_2: s.string("Sales invoice statutory holiday item label."),
+        invoice_holiday_2_late_night: s.string("Sales invoice statutory holiday late-night item label."),
+        invoice_hourly_username_view: s.boolean("Sales invoice show employee name on hourly items."),
+        invoice_hourly_only_one: s.string("Sales invoice single hourly rate item label."),
+        invoice_hourly_only_one_username_view: s.boolean("Sales invoice show employee name on single hourly rate items."),
+        invoice_bank_account: s.string("Sales invoice bank account for payment."),
+        invoice_notes: s.string("Sales invoice notes."),
+        invoice_memo: s.string("Sales invoice memo."),
+        mail_subject: s.string("Document email subject."),
+        mail_body: s.string("Document email body."),
+        purchase_issue_document: {
+            ...s.string("Document to issue to the supplier."),
+            enum: ["purchase", "purchase_invoice"],
+        },
+        deal_document_purchase_invoices: s.array("Purchase-invoice attachments: purchase_invoice, work or expense.", {
+            ...s.string("Document type."),
+            enum: ["purchase_invoice", "work", "expense"],
+        }),
+        purchase_invoice_tax_type: {
+            ...s.string("Purchase invoice tax treatment: included or excluded."),
+            enum: ["included", "excluded"],
+        },
+        purchase_invoice_withholding: s.boolean("Purchase invoice withholding tax flag."),
+        purchase_invoice_subject: s.string("Purchase invoice subject."),
+        purchase_invoice_show_year_month: s.boolean("Purchase invoice show year and month."),
+        purchase_invoice_show_work_time: s.boolean("Purchase invoice show working time."),
+        purchase_invoice_main: s.string("Purchase invoice monthly base-work item label."),
+        purchase_invoice_deduction: s.string("Purchase invoice monthly deduction item label."),
+        purchase_invoice_surplus: s.string("Purchase invoice monthly excess-hours item label."),
+        purchase_invoice_username_view: s.boolean("Purchase invoice show employee name on monthly items."),
+        purchase_invoice_monthly_only_one: s.string("Purchase invoice single monthly rate item label."),
+        purchase_invoice_monthly_only_one_username_view: s.boolean("Purchase invoice show employee name on single monthly rate items."),
+        purchase_invoice_hourly_main: s.string("Purchase invoice regular hourly item label."),
+        purchase_invoice_late_night: s.string("Purchase invoice regular late-night item label."),
+        purchase_invoice_overtime: s.string("Purchase invoice overtime item label."),
+        purchase_invoice_overtime_late_night: s.string("Purchase invoice late-night overtime item label."),
+        purchase_invoice_over_60_hour: s.string("Purchase invoice overtime beyond 60 hours item label."),
+        purchase_invoice_over_60_hour_late_night: s.string("Purchase invoice late-night overtime beyond 60 hours item label."),
+        purchase_invoice_holiday_1: s.string("Purchase invoice non-statutory holiday item label."),
+        purchase_invoice_holiday_1_late_night: s.string("Purchase invoice non-statutory holiday late-night item label."),
+        purchase_invoice_holiday_2: s.string("Purchase invoice statutory holiday item label."),
+        purchase_invoice_holiday_2_late_night: s.string("Purchase invoice statutory holiday late-night item label."),
+        purchase_invoice_hourly_username_view: s.boolean("Purchase invoice show employee name on hourly items."),
+        purchase_invoice_hourly_only_one: s.string("Purchase invoice single hourly rate item label."),
+        purchase_invoice_hourly_only_one_username_view: s.boolean("Purchase invoice show employee name on single hourly rate items."),
+        purchase_invoice_bank_account: s.string("Purchase invoice bank account for payment."),
+        purchase_invoice_notes: s.string("Purchase invoice notes."),
+        purchase_invoice_memo: s.string("Purchase invoice memo."),
+        purchase_invoice_mail_subject: s.string("Purchase invoice email subject."),
+        purchase_invoice_mail_body: s.string("Purchase invoice email body."),
+        close_out: s.integer("Trading status: 0 active, 1 trading ended."),
+        notes: s.string("Notes."),
+    }, { required: [] }),
+};
+export const businessPartnerUserSchema = s.object("Business partner approval contact data.", {
+    id: s.integer("Record ID."),
+    first_name: s.string("Individual partner or contact given name."),
+    last_name: s.string("Individual partner or contact family name."),
+    email: s.string("Email address."),
+    branch: s.string("Department."),
+    appointment: s.string("Job title."),
+}, { required: ["email", "first_name", "last_name"] });

package/src/providers/hrmos_kintai/executors.d.ts

@@ -0,0 +1,4 @@
+import type { CredentialValidators, ProviderExecutors, ProviderProxyExecutor } from "../../core/types.ts";
+export declare const executors: ProviderExecutors;
+export declare const credentialValidators: CredentialValidators;
+export declare const proxy: ProviderProxyExecutor;

package/src/providers/hrmos_kintai/executors.js

@@ -0,0 +1,61 @@
+import { defineProviderExecutors, defineProviderProxy, mapProviderActionHandlers, providerInputError, requireApiKeyCredential, } from "../provider-runtime.js";
+import { hrmosKintaiActions } from "./actions.js";
+import { authenticate, executeHrmosAction, hrmosBaseUrl, normalizeCompany, readHrmosError } from "./runtime.js";
+export const executors = defineProviderExecutors({
+    service: "hrmos_kintai",
+    handlers: mapProviderActionHandlers("hrmos_kintai", hrmosKintaiActions, (action) => (input, context) => executeHrmosAction(action.name, input, context)),
+    async createContext(context, fetcher) {
+        const credential = await requireApiKeyCredential(context, "hrmos_kintai");
+        return {
+            company: normalizeCompany(credential.values.companyUrl ?? credential.metadata?.companyUrl),
+            apiKey: credential.apiKey,
+            fetcher,
+            signal: context.signal,
+            transitFiles: context.transitFiles,
+        };
+    },
+});
+export const credentialValidators = {
+    async apiKey(input, { fetcher, signal }) {
+        const company = normalizeCompany(input.values.companyUrl);
+        await authenticate(company, input.apiKey, fetcher, signal, true);
+        return {
+            profile: { accountId: company, displayName: company },
+            grantedScopes: [],
+            metadata: { companyUrl: company },
+        };
+    },
+};
+export const proxy = defineProviderProxy({
+    service: "hrmos_kintai",
+    async baseUrl(context) {
+        const credential = await requireApiKeyCredential(context, "hrmos_kintai");
+        return hrmosBaseUrl(normalizeCompany(credential.values.companyUrl ?? credential.metadata?.companyUrl));
+    },
+    auth: { type: "none" },
+    readError: readHrmosError,
+    async customizeRequest({ context, url, headers, fetcher }) {
+        const credential = await requireApiKeyCredential(context, "hrmos_kintai");
+        const company = normalizeCompany(credential.values.companyUrl ?? credential.metadata?.companyUrl);
+        const prefix = new URL(hrmosBaseUrl(company)).pathname;
+        if (url.origin !== "https://ieyasu.co" || !url.pathname.startsWith(`${prefix}/`)) {
+            throw providerInputError("HRMOS Kintai proxy must stay within the connected company API");
+        }
+        let relativePath;
+        try {
+            relativePath = decodeURIComponent(url.pathname.slice(prefix.length));
+        }
+        catch {
+            throw providerInputError("HRMOS Kintai proxy path has invalid encoding");
+        }
+        const segments = relativePath.split("/").filter(Boolean);
+        if (segments.some((segment) => segment === "." || segment === ".." || segment.includes("\\"))) {
+            throw providerInputError("HRMOS Kintai proxy path must not contain traversal segments");
+        }
+        if (segments[0] === "authentication") {
+            throw providerInputError("HRMOS Kintai authentication endpoints are managed by the connection");
+        }
+        headers.set("authorization", `Token ${await authenticate(company, credential.apiKey, fetcher, context.signal)}`);
+        headers.set("accept", "application/json");
+    },
+});

package/src/providers/hrmos_kintai/export-actions.d.ts

@@ -0,0 +1,2 @@
+import type { ActionDefinition } from "../../core/types.ts";
+export declare const exportActions: ActionDefinition[];

package/src/providers/hrmos_kintai/export-actions.js

@@ -0,0 +1,58 @@
+import { s } from "../../core/json-schema.js";
+import { defineProviderAction } from "../../core/provider-definition.js";
+const exportInput = s.actionInput({
+    year: s.integer("Four-digit target year.", { minimum: 1000, maximum: 9999 }),
+}, ["year"], "CSV export parameters.");
+const exportOutput = s.actionOutput({
+    file: s.actionOutput({
+        fileId: s.string("Transit file identifier."),
+        name: s.string("CSV file name."),
+        mimeType: s.string("Original CSV media type and character encoding when supplied."),
+        downloadUrl: s.string("Local transit file download URL."),
+        sizeBytes: s.integer("File size in bytes."),
+    }, "Downloadable CSV artifact."),
+}, "Exported CSV file.");
+export const exportActions = [
+    defineProviderAction("hrmos_kintai", {
+        name: "export_dependent_declaration",
+        operationType: "read",
+        description: "Export dependent declaration as a downloadable CSV file for the specified year.",
+        inputSchema: exportInput,
+        outputSchema: exportOutput,
+    }),
+    defineProviderAction("hrmos_kintai", {
+        name: "export_next_year_dependent_declaration",
+        operationType: "read",
+        description: "Export next year dependent declaration as a downloadable CSV file for the specified year.",
+        inputSchema: exportInput,
+        outputSchema: exportOutput,
+    }),
+    defineProviderAction("hrmos_kintai", {
+        name: "export_insurance_deduction_declaration",
+        operationType: "read",
+        description: "Export insurance deduction declaration as a downloadable CSV file for the specified year.",
+        inputSchema: exportInput,
+        outputSchema: exportOutput,
+    }),
+    defineProviderAction("hrmos_kintai", {
+        name: "export_income_deduction_declaration",
+        operationType: "read",
+        description: "Export income deduction declaration as a downloadable CSV file for the specified year.",
+        inputSchema: exportInput,
+        outputSchema: exportOutput,
+    }),
+    defineProviderAction("hrmos_kintai", {
+        name: "export_housing_loan_declaration",
+        operationType: "read",
+        description: "Export housing loan declaration as a downloadable CSV file for the specified year.",
+        inputSchema: exportInput,
+        outputSchema: exportOutput,
+    }),
+    defineProviderAction("hrmos_kintai", {
+        name: "export_previous_employment_withholding",
+        operationType: "read",
+        description: "Export previous employment withholding as a downloadable CSV file for the specified year.",
+        inputSchema: exportInput,
+        outputSchema: exportOutput,
+    }),
+];

package/src/providers/hrmos_kintai/operations.d.ts

@@ -0,0 +1,9 @@
+interface HrmosOperation {
+    path: string;
+    method: "GET" | "POST" | "PUT" | "DELETE";
+    response: "list" | "record" | "definitions" | "file";
+    bodyField?: string;
+    aliases?: Record<string, string>;
+}
+export declare const hrmosOperations: Record<string, HrmosOperation>;
+export {};