@warmio/contracts 1.0.0

package/dist/openapi/build-openapi.d.ts

@@ -0,0 +1,28 @@
+type OpenApiOperation = {
+    operationId?: string;
+    security?: Array<Record<string, never[]>>;
+    summary?: string;
+};
+type OpenApiDocument = {
+    components?: {
+        schemas?: Record<string, unknown>;
+        securitySchemes?: Record<string, unknown>;
+    };
+    info?: {
+        description?: string;
+    };
+    paths?: Record<string, Record<string, OpenApiOperation>>;
+    servers?: Array<{
+        description?: string;
+        url?: string;
+    }>;
+};
+/**
+ * The rich hand-authored v2 document is package-owned in base.yaml. This builder
+ * preserves its prose and protocol details while replacing canonical wire shapes
+ * and endpoint identities from the manifest and Zod contracts.
+ */
+export declare function buildOpenApiDocument(): OpenApiDocument;
+export declare function buildOpenApiYaml(): string;
+export {};
+//# sourceMappingURL=build-openapi.d.ts.map

package/dist/openapi/build-openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-openapi.d.ts","sourceRoot":"","sources":["../../src/openapi/build-openapi.ts"],"names":[],"mappings":"AA4BA,KAAK,gBAAgB,GAAG;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AACF,KAAK,eAAe,GAAG;IACrB,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC3C,CAAC;IACF,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD,CAAC;AAUF;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,eAAe,CAyEtD;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC"}

package/dist/openapi/build-openapi.js

@@ -0,0 +1,89 @@
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { parse, stringify } from 'yaml';
+import { apiAuthSchemes, apiEndpointManifest, apiRateLimits, API_ORIGIN } from '../api/index.js';
+import { baseOpenApiYaml } from '../generated/base-openapi.js';
+import { automationInputSchema, automationInvocationResponseSchema, automationOperationSchema, describeOperationRequestSchema, financialContextMetaSchema, financialContextAccountSchema, financialContextBudgetSchema, financialContextGoalSchema, financialContextHealthSchema, financialContextHoldingSchema, financialContextLiabilitySchema, financialContextPositionSchema, financialContextRecurringSchema, financialContextSchema, financialContextSnapshotSchema, financialContextStatusSchema, financialContextTransactionIndexSchema, financialContextTransactionSchema, invokeOperationRequestSchema, latestTransactionsSchema, transactionMonthSchema, } from '../schemas/index.js';
+function cloneBaseDocument() {
+    return parse(baseOpenApiYaml);
+}
+function schema(value) {
+    return zodToJsonSchema(value, { $refStrategy: 'none' });
+}
+/**
+ * The rich hand-authored v2 document is package-owned in base.yaml. This builder
+ * preserves its prose and protocol details while replacing canonical wire shapes
+ * and endpoint identities from the manifest and Zod contracts.
+ */
+export function buildOpenApiDocument() {
+    const document = cloneBaseDocument();
+    if (!document.info ||
+        !document.paths ||
+        !document.servers?.[0] ||
+        !document.components?.schemas ||
+        !document.components.securitySchemes) {
+        throw new Error('The OpenAPI base document is missing paths, schemas, or a production server.');
+    }
+    document.info.description = `Read your financial context or invoke supported Warm actions through a compact operation catalog.
+
+## Authentication
+All requests use \`Authorization: Bearer\`. ${apiAuthSchemes.context.description}
+${apiAuthSchemes.automation.description} Automation keys begin with \`${apiAuthSchemes.automation.bearer_prefix}\`.
+
+## Rate Limits
+- Context keys: ${apiRateLimits.context.requests_per_hour} requests per hour per key
+- Automation keys: ${apiRateLimits.automation.requests_per_hour} requests per hour per key
+- Rate limit headers are included in authenticated responses.
+- \`/api/export\` supports dataset-scoped delta sync with \`since\` and publishes edge-cache metadata headers.`;
+    document.servers[0].url = API_ORIGIN;
+    document.components.securitySchemes = {
+        AutomationKeyAuth: {
+            description: `Automation format: Authorization: Bearer ${apiAuthSchemes.automation.bearer_prefix}...`,
+            scheme: apiAuthSchemes.automation.scheme,
+            type: 'http',
+        },
+        BearerAuth: {
+            description: apiAuthSchemes.context.description,
+            scheme: apiAuthSchemes.context.scheme,
+            type: 'http',
+        },
+    };
+    for (const endpoint of apiEndpointManifest) {
+        const operation = document.paths[endpoint.path]?.[endpoint.method.toLowerCase()];
+        if (!operation) {
+            throw new Error(`The OpenAPI base document is missing ${endpoint.method} ${endpoint.path}.`);
+        }
+        operation.operationId = endpoint.operation_id;
+        operation.security = [
+            endpoint.audience === 'automation' ? { AutomationKeyAuth: [] } : { BearerAuth: [] },
+        ];
+        operation.summary = endpoint.summary;
+    }
+    Object.assign(document.components.schemas, {
+        AutomationInvocationResponse: schema(automationInvocationResponseSchema),
+        AutomationOperation: schema(automationOperationSchema),
+        FinancialContext: schema(financialContextSchema),
+        FinancialContextAccount: schema(financialContextAccountSchema),
+        FinancialContextBudget: schema(financialContextBudgetSchema),
+        FinancialContextGoal: schema(financialContextGoalSchema),
+        FinancialContextHealth: schema(financialContextHealthSchema),
+        FinancialContextHolding: schema(financialContextHoldingSchema),
+        FinancialContextLiability: schema(financialContextLiabilitySchema),
+        FinancialContextMeta: schema(financialContextMetaSchema),
+        FinancialContextPosition: schema(financialContextPositionSchema),
+        FinancialContextRecurring: schema(financialContextRecurringSchema),
+        FinancialContextSnapshot: schema(financialContextSnapshotSchema),
+        FinancialContextStatus: schema(financialContextStatusSchema),
+        FinancialContextTransaction: schema(financialContextTransactionSchema),
+        LatestTransactions: schema(latestTransactionsSchema),
+        OperationInput: schema(automationInputSchema),
+        OperationInvokeRequest: schema(invokeOperationRequestSchema),
+        OperationRequest: schema(describeOperationRequestSchema),
+        TransactionMonth: schema(transactionMonthSchema),
+        TransactionIndex: schema(financialContextTransactionIndexSchema),
+    });
+    return document;
+}
+export function buildOpenApiYaml() {
+    return stringify(buildOpenApiDocument(), { lineWidth: 0 });
+}
+//# sourceMappingURL=build-openapi.js.map

package/dist/openapi/build-openapi.js.map

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

package/dist/openapi/index.d.ts

@@ -0,0 +1,2 @@
+export * from './build-openapi.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/openapi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/openapi/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/openapi/index.js

@@ -0,0 +1,2 @@
+export * from './build-openapi.js';
+//# sourceMappingURL=index.js.map

package/dist/openapi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/openapi/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/schemas/automation.d.ts

@@ -0,0 +1,248 @@
+import { z } from 'zod';
+export declare const automationOperationDescriptorSchema: z.ZodObject<{
+    confirmation_required: z.ZodBoolean;
+    description: z.ZodString;
+    method: z.ZodEnum<["DELETE", "GET", "PATCH", "POST", "PUT"]>;
+    operation_id: z.ZodString;
+    path: z.ZodString;
+    path_parameter_kind: z.ZodNullable<z.ZodEnum<["opaque", "uuid"]>>;
+    risk: z.ZodArray<z.ZodEnum<["read", "write", "destructive", "external_effect"]>, "many">;
+    summary: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    confirmation_required: boolean;
+    description: string;
+    method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+    operation_id: string;
+    path: string;
+    path_parameter_kind: "opaque" | "uuid" | null;
+    risk: ("destructive" | "external_effect" | "read" | "write")[];
+    summary: string;
+}, {
+    confirmation_required: boolean;
+    description: string;
+    method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+    operation_id: string;
+    path: string;
+    path_parameter_kind: "opaque" | "uuid" | null;
+    risk: ("destructive" | "external_effect" | "read" | "write")[];
+    summary: string;
+}>;
+export declare const automationOperationSchema: z.ZodObject<Omit<{
+    confirmation_required: z.ZodBoolean;
+    description: z.ZodString;
+    method: z.ZodEnum<["DELETE", "GET", "PATCH", "POST", "PUT"]>;
+    operation_id: z.ZodString;
+    path: z.ZodString;
+    path_parameter_kind: z.ZodNullable<z.ZodEnum<["opaque", "uuid"]>>;
+    risk: z.ZodArray<z.ZodEnum<["read", "write", "destructive", "external_effect"]>, "many">;
+    summary: z.ZodString;
+}, "path_parameter_kind">, "strict", z.ZodTypeAny, {
+    confirmation_required: boolean;
+    description: string;
+    method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+    operation_id: string;
+    path: string;
+    risk: ("destructive" | "external_effect" | "read" | "write")[];
+    summary: string;
+}, {
+    confirmation_required: boolean;
+    description: string;
+    method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+    operation_id: string;
+    path: string;
+    risk: ("destructive" | "external_effect" | "read" | "write")[];
+    summary: string;
+}>;
+export declare const automationOperationDescriptionSchema: z.ZodObject<Omit<{
+    confirmation_required: z.ZodBoolean;
+    description: z.ZodString;
+    method: z.ZodEnum<["DELETE", "GET", "PATCH", "POST", "PUT"]>;
+    operation_id: z.ZodString;
+    path: z.ZodString;
+    path_parameter_kind: z.ZodNullable<z.ZodEnum<["opaque", "uuid"]>>;
+    risk: z.ZodArray<z.ZodEnum<["read", "write", "destructive", "external_effect"]>, "many">;
+    summary: z.ZodString;
+}, "path_parameter_kind"> & {
+    input_schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strict", z.ZodTypeAny, {
+    confirmation_required: boolean;
+    description: string;
+    method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+    operation_id: string;
+    path: string;
+    risk: ("destructive" | "external_effect" | "read" | "write")[];
+    summary: string;
+    input_schema: Record<string, unknown>;
+}, {
+    confirmation_required: boolean;
+    description: string;
+    method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+    operation_id: string;
+    path: string;
+    risk: ("destructive" | "external_effect" | "read" | "write")[];
+    summary: string;
+    input_schema: Record<string, unknown>;
+}>;
+export declare const automationApprovalSchema: z.ZodObject<{
+    approval_url: z.ZodString;
+    expires_at: z.ZodString;
+    id: z.ZodString;
+    status: z.ZodLiteral<"pending">;
+}, "strict", z.ZodTypeAny, {
+    approval_url: string;
+    expires_at: string;
+    id: string;
+    status: "pending";
+}, {
+    approval_url: string;
+    expires_at: string;
+    id: string;
+    status: "pending";
+}>;
+export declare const automationOperationSearchResponseSchema: z.ZodObject<{
+    operations: z.ZodArray<z.ZodObject<Omit<{
+        confirmation_required: z.ZodBoolean;
+        description: z.ZodString;
+        method: z.ZodEnum<["DELETE", "GET", "PATCH", "POST", "PUT"]>;
+        operation_id: z.ZodString;
+        path: z.ZodString;
+        path_parameter_kind: z.ZodNullable<z.ZodEnum<["opaque", "uuid"]>>;
+        risk: z.ZodArray<z.ZodEnum<["read", "write", "destructive", "external_effect"]>, "many">;
+        summary: z.ZodString;
+    }, "path_parameter_kind">, "strict", z.ZodTypeAny, {
+        confirmation_required: boolean;
+        description: string;
+        method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+        operation_id: string;
+        path: string;
+        risk: ("destructive" | "external_effect" | "read" | "write")[];
+        summary: string;
+    }, {
+        confirmation_required: boolean;
+        description: string;
+        method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+        operation_id: string;
+        path: string;
+        risk: ("destructive" | "external_effect" | "read" | "write")[];
+        summary: string;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    operations: {
+        confirmation_required: boolean;
+        description: string;
+        method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+        operation_id: string;
+        path: string;
+        risk: ("destructive" | "external_effect" | "read" | "write")[];
+        summary: string;
+    }[];
+}, {
+    operations: {
+        confirmation_required: boolean;
+        description: string;
+        method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+        operation_id: string;
+        path: string;
+        risk: ("destructive" | "external_effect" | "read" | "write")[];
+        summary: string;
+    }[];
+}>;
+export declare const automationOperationDescriptionResponseSchema: z.ZodObject<{
+    approval: z.ZodOptional<z.ZodObject<{
+        approval_url: z.ZodString;
+        expires_at: z.ZodString;
+        id: z.ZodString;
+        status: z.ZodLiteral<"pending">;
+    }, "strict", z.ZodTypeAny, {
+        approval_url: string;
+        expires_at: string;
+        id: string;
+        status: "pending";
+    }, {
+        approval_url: string;
+        expires_at: string;
+        id: string;
+        status: "pending";
+    }>>;
+    operation: z.ZodObject<Omit<{
+        confirmation_required: z.ZodBoolean;
+        description: z.ZodString;
+        method: z.ZodEnum<["DELETE", "GET", "PATCH", "POST", "PUT"]>;
+        operation_id: z.ZodString;
+        path: z.ZodString;
+        path_parameter_kind: z.ZodNullable<z.ZodEnum<["opaque", "uuid"]>>;
+        risk: z.ZodArray<z.ZodEnum<["read", "write", "destructive", "external_effect"]>, "many">;
+        summary: z.ZodString;
+    }, "path_parameter_kind"> & {
+        input_schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strict", z.ZodTypeAny, {
+        confirmation_required: boolean;
+        description: string;
+        method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+        operation_id: string;
+        path: string;
+        risk: ("destructive" | "external_effect" | "read" | "write")[];
+        summary: string;
+        input_schema: Record<string, unknown>;
+    }, {
+        confirmation_required: boolean;
+        description: string;
+        method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+        operation_id: string;
+        path: string;
+        risk: ("destructive" | "external_effect" | "read" | "write")[];
+        summary: string;
+        input_schema: Record<string, unknown>;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    approval?: {
+        approval_url: string;
+        expires_at: string;
+        id: string;
+        status: "pending";
+    } | undefined;
+    operation: {
+        confirmation_required: boolean;
+        description: string;
+        method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+        operation_id: string;
+        path: string;
+        risk: ("destructive" | "external_effect" | "read" | "write")[];
+        summary: string;
+        input_schema: Record<string, unknown>;
+    };
+}, {
+    approval?: {
+        approval_url: string;
+        expires_at: string;
+        id: string;
+        status: "pending";
+    } | undefined;
+    operation: {
+        confirmation_required: boolean;
+        description: string;
+        method: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+        operation_id: string;
+        path: string;
+        risk: ("destructive" | "external_effect" | "read" | "write")[];
+        summary: string;
+        input_schema: Record<string, unknown>;
+    };
+}>;
+export declare const automationInvocationResponseSchema: z.ZodObject<{
+    body: z.ZodUnknown;
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
+    operation_id: z.ZodString;
+    status: z.ZodNumber;
+}, "strict", z.ZodTypeAny, {
+    body?: unknown;
+    headers: Record<string, string>;
+    operation_id: string;
+    status: number;
+}, {
+    body?: unknown;
+    headers: Record<string, string>;
+    operation_id: string;
+    status: number;
+}>;
+//# sourceMappingURL=automation.d.ts.map

package/dist/schemas/automation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.d.ts","sourceRoot":"","sources":["../../src/schemas/automation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;EAWrC,CAAC;AAEZ,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;EAE3B,CAAC;AAEZ,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEtC,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;EAO1B,CAAC;AAEZ,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEzC,CAAC;AAEZ,eAAO,MAAM,4CAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAK9C,CAAC;AAEZ,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;EAOpC,CAAC"}

package/dist/schemas/automation.js

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+import { apiMethodSchema, apiOperationRiskSchema, pathParameterKindSchema } from './common.js';
+export const automationOperationDescriptorSchema = z
+    .object({
+    confirmation_required: z.boolean(),
+    description: z.string(),
+    method: apiMethodSchema,
+    operation_id: z.string(),
+    path: z.string(),
+    path_parameter_kind: pathParameterKindSchema.nullable(),
+    risk: z.array(apiOperationRiskSchema),
+    summary: z.string(),
+})
+    .strict();
+export const automationOperationSchema = automationOperationDescriptorSchema
+    .omit({ path_parameter_kind: true })
+    .strict();
+export const automationOperationDescriptionSchema = automationOperationSchema
+    .extend({ input_schema: z.record(z.unknown()) })
+    .strict();
+export const automationApprovalSchema = z
+    .object({
+    approval_url: z.string().url(),
+    expires_at: z.string().datetime({ offset: true }),
+    id: z.string().min(1),
+    status: z.literal('pending'),
+})
+    .strict();
+export const automationOperationSearchResponseSchema = z
+    .object({ operations: z.array(automationOperationSchema) })
+    .strict();
+export const automationOperationDescriptionResponseSchema = z
+    .object({
+    approval: automationApprovalSchema.optional(),
+    operation: automationOperationDescriptionSchema,
+})
+    .strict();
+export const automationInvocationResponseSchema = z
+    .object({
+    body: z.unknown(),
+    headers: z.record(z.string()),
+    operation_id: z.string(),
+    status: z.number().int().min(100).max(599),
+})
+    .strict();
+//# sourceMappingURL=automation.js.map

package/dist/schemas/automation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automation.js","sourceRoot":"","sources":["../../src/schemas/automation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE/F,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC;KACjD,MAAM,CAAC;IACN,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,MAAM,EAAE,eAAe;IACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,mBAAmB,EAAE,uBAAuB,CAAC,QAAQ,EAAE;IACvD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC;IACrC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,yBAAyB,GAAG,mCAAmC;KACzE,IAAI,CAAC,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;KACnC,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,oCAAoC,GAAG,yBAAyB;KAC1E,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;KAC/C,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,MAAM,CAAC;IACN,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACjD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CAC7B,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC;KACrD,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,EAAE,CAAC;KAC1D,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,4CAA4C,GAAG,CAAC;KAC1D,MAAM,CAAC;IACN,QAAQ,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IAC7C,SAAS,EAAE,oCAAoC;CAChD,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC;KAChD,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;CAC3C,CAAC;KACD,MAAM,EAAE,CAAC"}

package/dist/schemas/common.d.ts

@@ -0,0 +1,76 @@
+import { z } from 'zod';
+export declare const apiOperationRiskSchema: z.ZodEnum<["read", "write", "destructive", "external_effect"]>;
+export declare const apiMethodSchema: z.ZodEnum<["DELETE", "GET", "PATCH", "POST", "PUT"]>;
+export declare const pathParameterKindSchema: z.ZodEnum<["opaque", "uuid"]>;
+export declare const automationInputSchema: z.ZodObject<{
+    body: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, "strict", z.ZodTypeAny, {
+    body?: Record<string, unknown> | undefined;
+    params?: Record<string, string> | undefined;
+}, {
+    body?: Record<string, unknown> | undefined;
+    params?: Record<string, string> | undefined;
+}>;
+export declare const searchOperationsRequestSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    query?: string | undefined;
+}, {
+    query?: string | undefined;
+}>;
+export declare const describeOperationRequestSchema: z.ZodObject<{
+    input: z.ZodOptional<z.ZodObject<{
+        body: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        body?: Record<string, unknown> | undefined;
+        params?: Record<string, string> | undefined;
+    }, {
+        body?: Record<string, unknown> | undefined;
+        params?: Record<string, string> | undefined;
+    }>>;
+    operation_id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    input?: {
+        body?: Record<string, unknown> | undefined;
+        params?: Record<string, string> | undefined;
+    } | undefined;
+    operation_id: string;
+}, {
+    input?: {
+        body?: Record<string, unknown> | undefined;
+        params?: Record<string, string> | undefined;
+    } | undefined;
+    operation_id: string;
+}>;
+export declare const invokeOperationRequestSchema: z.ZodObject<{
+    input: z.ZodOptional<z.ZodObject<{
+        body: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        body?: Record<string, unknown> | undefined;
+        params?: Record<string, string> | undefined;
+    }, {
+        body?: Record<string, unknown> | undefined;
+        params?: Record<string, string> | undefined;
+    }>>;
+    operation_id: z.ZodString;
+} & {
+    approval_id: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    input?: {
+        body?: Record<string, unknown> | undefined;
+        params?: Record<string, string> | undefined;
+    } | undefined;
+    operation_id: string;
+    approval_id?: string | undefined;
+}, {
+    input?: {
+        body?: Record<string, unknown> | undefined;
+        params?: Record<string, string> | undefined;
+    } | undefined;
+    operation_id: string;
+    approval_id?: string | undefined;
+}>;
+//# sourceMappingURL=common.d.ts.map

package/dist/schemas/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,sBAAsB,gEAA8D,CAAC;AAClG,eAAO,MAAM,eAAe,sDAAoD,CAAC;AACjF,eAAO,MAAM,uBAAuB,+BAA6B,CAAC;AAElE,eAAO,MAAM,qBAAqB;;;;;;;;;EAKvB,CAAC;AAEZ,eAAO,MAAM,6BAA6B;;;;;;EAE/B,CAAC;AAEZ,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;EAKhC,CAAC;AAEZ,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE9B,CAAC"}

package/dist/schemas/common.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export const apiOperationRiskSchema = z.enum(['read', 'write', 'destructive', 'external_effect']);
+export const apiMethodSchema = z.enum(['DELETE', 'GET', 'PATCH', 'POST', 'PUT']);
+export const pathParameterKindSchema = z.enum(['opaque', 'uuid']);
+export const automationInputSchema = z
+    .object({
+    body: z.record(z.unknown()).optional(),
+    params: z.record(z.string()).optional(),
+})
+    .strict();
+export const searchOperationsRequestSchema = z
+    .object({ query: z.string().max(200).optional() })
+    .strict();
+export const describeOperationRequestSchema = z
+    .object({
+    input: automationInputSchema.optional(),
+    operation_id: z.string().min(1),
+})
+    .strict();
+export const invokeOperationRequestSchema = describeOperationRequestSchema
+    .extend({ approval_id: z.string().uuid().optional() })
+    .strict();
+//# sourceMappingURL=common.js.map

package/dist/schemas/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAClG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AACjF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC;KAC3C,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC;KACjD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC;KAC5C,MAAM,CAAC;IACN,KAAK,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IACvC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAChC,CAAC;KACD,MAAM,EAAE,CAAC;AAEZ,MAAM,CAAC,MAAM,4BAA4B,GAAG,8BAA8B;KACvE,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;KACrD,MAAM,EAAE,CAAC"}