@automate.ax/api-contract 0.26.1 → 0.28.0

package/dist/deployment.d.ts

@@ -11,8 +11,13 @@ export declare const deploymentTriggerInfoSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type DeploymentTriggerInfo = z.infer<typeof deploymentTriggerInfoSchema>;
 export declare const deploymentContract: {
+    cancel: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        deploymentId: z.ZodString;
+        projectId: z.ZodString;
+    }, z.core.$strip>, z.ZodVoid, Record<never, never>, Record<never, never>>;
     create: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
         artifact: z.ZodCustom<Blob, Blob>;
+        cancelExisting: z.ZodDefault<z.ZodBoolean>;
         manifest: z.ZodArray<z.ZodObject<{
             identityKey: z.ZodString;
         }, z.core.$strip>>;
@@ -24,7 +29,24 @@ export declare const deploymentContract: {
         rebindAccounts: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>, z.ZodObject<{
         id: z.ZodString;
-    }, z.core.$strip>, Record<never, never>, Record<never, never>>;
+    }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+        DEPLOYMENT_IN_PROGRESS: {
+            readonly data: z.ZodObject<{
+                deploymentId: z.ZodString;
+                status: z.ZodEnum<{
+                    succeeded: "succeeded";
+                    failed: "failed";
+                    planning: "planning";
+                    awaiting_authorization: "awaiting_authorization";
+                    configuring: "configuring";
+                    publishing: "publishing";
+                    cancelled: "cancelled";
+                }>;
+            }, z.core.$strip>;
+            readonly message: "A deployment is already in progress.";
+            readonly status: 409;
+        };
+    }>, Record<never, never>>;
     get: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
         deploymentId: z.ZodString;
         projectId: z.ZodString;
@@ -59,6 +81,7 @@ export declare const deploymentContract: {
             awaiting_authorization: "awaiting_authorization";
             configuring: "configuring";
             publishing: "publishing";
+            cancelled: "cancelled";
         }>;
     }, z.core.$strip>, Record<never, never>, Record<never, never>>;
 };

package/dist/deployment.js

@@ -12,10 +12,35 @@ export const deploymentTriggerInfoSchema = z.object({
     name: z.string(),
     type: z.string(),
 });
+const DEPLOYMENT_STATUS_SCHEMA = z.enum([
+    "planning",
+    "awaiting_authorization",
+    "configuring",
+    "publishing",
+    "succeeded",
+    "failed",
+    "cancelled",
+]);
+const DEPLOYMENT_IN_PROGRESS_ERROR = {
+    data: z.object({
+        deploymentId: z.string(),
+        status: DEPLOYMENT_STATUS_SCHEMA,
+    }),
+    message: "A deployment is already in progress.",
+    status: 409,
+};
 export const deploymentContract = {
+    cancel: oc
+        .input(z.object({
+        deploymentId: z.string(),
+        projectId: z.string(),
+    }))
+        .output(z.void()),
     create: oc
+        .errors({ DEPLOYMENT_IN_PROGRESS: DEPLOYMENT_IN_PROGRESS_ERROR })
         .input(z.object({
         artifact: z.instanceof(Blob),
+        cancelExisting: z.boolean().default(false),
         manifest: z
             .object({
             identityKey: z.string().min(1),
@@ -65,13 +90,6 @@ export const deploymentContract = {
             id: z.string(),
             name: z.string(),
         }),
-        status: z.enum([
-            "planning",
-            "awaiting_authorization",
-            "configuring",
-            "publishing",
-            "succeeded",
-            "failed",
-        ]),
+        status: DEPLOYMENT_STATUS_SCHEMA,
     })),
 };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export { AUTOMATION_SDK_VERSION, deploymentTriggerInfoSchema, type DeploymentTriggerInfo, } from "./deployment.js";
 export { integrationAccountOutputSchema } from "./account.js";
-export { runtimeContract } from "./runtime.js";
+export { generationInputSchema, generationResultSchema, runtimeContract, type GenerationInput, type GenerationResult, type RuntimeGenerationInput, } from "./runtime.js";
 export { createdOrganizationApiKeyOutputSchema, organizationApiKeyOutputSchema, } from "./api-key.js";
 export { integrationConnectionManifestSchema, integrationServiceManifestSchema, type IntegrationConnectionManifest, type IntegrationServiceManifest, } from "./authorization.js";
 export { activeSubscriptionOutputSchema, createdInvitationOutputSchema, organizationDetailsOutputSchema, organizationInvitationOutputSchema, organizationMemberOutputSchema, organizationProjectOutputSchema, organizationRoleSchema, organizationSummaryOutputSchema, publicOrganizationOutputSchema, } from "./org.js";
@@ -469,8 +469,13 @@ export declare const firstPartyContract: {
         }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
     };
     deployment: {
+        cancel: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+            deploymentId: import("zod").ZodString;
+            projectId: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
         create: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
             artifact: import("zod").ZodCustom<Blob, Blob>;
+            cancelExisting: import("zod").ZodDefault<import("zod").ZodBoolean>;
             manifest: import("zod").ZodArray<import("zod").ZodObject<{
                 identityKey: import("zod").ZodString;
             }, import("zod/v4/core").$strip>>;
@@ -482,7 +487,24 @@ export declare const firstPartyContract: {
             rebindAccounts: import("zod").ZodDefault<import("zod").ZodBoolean>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
             id: import("zod").ZodString;
-        }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
+        }, import("zod/v4/core").$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            DEPLOYMENT_IN_PROGRESS: {
+                readonly data: import("zod").ZodObject<{
+                    deploymentId: import("zod").ZodString;
+                    status: import("zod").ZodEnum<{
+                        succeeded: "succeeded";
+                        failed: "failed";
+                        planning: "planning";
+                        awaiting_authorization: "awaiting_authorization";
+                        configuring: "configuring";
+                        publishing: "publishing";
+                        cancelled: "cancelled";
+                    }>;
+                }, import("zod/v4/core").$strip>;
+                readonly message: "A deployment is already in progress.";
+                readonly status: 409;
+            };
+        }>, Record<never, never>>;
         get: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
             deploymentId: import("zod").ZodString;
             projectId: import("zod").ZodString;
@@ -517,6 +539,7 @@ export declare const firstPartyContract: {
                 awaiting_authorization: "awaiting_authorization";
                 configuring: "configuring";
                 publishing: "publishing";
+                cancelled: "cancelled";
             }>;
         }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
     };
@@ -1008,6 +1031,108 @@ export declare const contract: {
             output: import("zod").ZodOptional<import("zod").ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
             status: import("zod").ZodLiteral<"succeeded">;
         }, import("zod/v4/core").$strip>], "status">, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
+        generate: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodUnion<readonly [import("zod").ZodObject<{
+            frequencyPenalty: import("zod").ZodOptional<import("zod").ZodNumber>;
+            instructions: import("zod").ZodOptional<import("zod").ZodString>;
+            maxOutputTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+            maxRetries: import("zod").ZodOptional<import("zod").ZodNumber>;
+            model: import("zod").ZodString;
+            presencePenalty: import("zod").ZodOptional<import("zod").ZodNumber>;
+            providerOptions: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodJSONSchema>>>;
+            seed: import("zod").ZodOptional<import("zod").ZodNumber>;
+            stopSequences: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            system: import("zod").ZodOptional<import("zod").ZodString>;
+            temperature: import("zod").ZodOptional<import("zod").ZodNumber>;
+            timeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+            topK: import("zod").ZodOptional<import("zod").ZodNumber>;
+            topP: import("zod").ZodOptional<import("zod").ZodNumber>;
+            messages: import("zod").ZodOptional<import("zod").ZodNever>;
+            prompt: import("zod").ZodString;
+            output: import("zod").ZodOptional<import("zod").ZodObject<{
+                description: import("zod").ZodOptional<import("zod").ZodString>;
+                name: import("zod").ZodOptional<import("zod").ZodString>;
+                schema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodJSONSchema>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+            frequencyPenalty: import("zod").ZodOptional<import("zod").ZodNumber>;
+            instructions: import("zod").ZodOptional<import("zod").ZodString>;
+            maxOutputTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+            maxRetries: import("zod").ZodOptional<import("zod").ZodNumber>;
+            model: import("zod").ZodString;
+            presencePenalty: import("zod").ZodOptional<import("zod").ZodNumber>;
+            providerOptions: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodJSONSchema>>>;
+            seed: import("zod").ZodOptional<import("zod").ZodNumber>;
+            stopSequences: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+            system: import("zod").ZodOptional<import("zod").ZodString>;
+            temperature: import("zod").ZodOptional<import("zod").ZodNumber>;
+            timeout: import("zod").ZodOptional<import("zod").ZodNumber>;
+            topK: import("zod").ZodOptional<import("zod").ZodNumber>;
+            topP: import("zod").ZodOptional<import("zod").ZodNumber>;
+            messages: import("zod").ZodArray<import("zod").ZodObject<{
+                content: import("zod").ZodString;
+                role: import("zod").ZodEnum<{
+                    assistant: "assistant";
+                    user: "user";
+                }>;
+            }, import("zod/v4/core").$strip>>;
+            prompt: import("zod").ZodOptional<import("zod").ZodNever>;
+            output: import("zod").ZodOptional<import("zod").ZodObject<{
+                description: import("zod").ZodOptional<import("zod").ZodString>;
+                name: import("zod").ZodOptional<import("zod").ZodString>;
+                schema: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodJSONSchema>;
+            }, import("zod/v4/core").$strip>>;
+        }, import("zod/v4/core").$strip>]>, import("zod").ZodObject<{
+            finishReason: import("zod").ZodEnum<{
+                error: "error";
+                length: "length";
+                other: "other";
+                stop: "stop";
+                "content-filter": "content-filter";
+                "tool-calls": "tool-calls";
+            }>;
+            output: import("zod").ZodOptional<import("zod").ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+            providerMetadata: import("zod").ZodOptional<import("zod").ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+            rawFinishReason: import("zod").ZodOptional<import("zod").ZodString>;
+            reasoningText: import("zod").ZodOptional<import("zod").ZodString>;
+            response: import("zod").ZodObject<{
+                headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
+                id: import("zod").ZodString;
+                modelId: import("zod").ZodString;
+                timestamp: import("zod").ZodISODateTime;
+            }, import("zod/v4/core").$strip>;
+            text: import("zod").ZodString;
+            usage: import("zod").ZodObject<{
+                inputTokenDetails: import("zod").ZodObject<{
+                    cacheReadTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    cacheWriteTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    noCacheTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+                }, import("zod/v4/core").$strip>;
+                inputTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+                outputTokenDetails: import("zod").ZodObject<{
+                    reasoningTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+                    textTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+                }, import("zod/v4/core").$strip>;
+                outputTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+                raw: import("zod").ZodOptional<import("zod").ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+                totalTokens: import("zod").ZodOptional<import("zod").ZodNumber>;
+            }, import("zod/v4/core").$strip>;
+            warnings: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
+                details: import("zod").ZodOptional<import("zod").ZodString>;
+                feature: import("zod").ZodString;
+                type: import("zod").ZodLiteral<"unsupported">;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                details: import("zod").ZodOptional<import("zod").ZodString>;
+                feature: import("zod").ZodString;
+                type: import("zod").ZodLiteral<"compatibility">;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                message: import("zod").ZodString;
+                setting: import("zod").ZodString;
+                type: import("zod").ZodLiteral<"deprecated">;
+            }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+                message: import("zod").ZodString;
+                type: import("zod").ZodLiteral<"other">;
+            }, import("zod/v4/core").$strip>], "type">>>;
+        }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
         loadInvocation: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, import("zod").ZodObject<{
             context: import("zod").ZodObject<{
                 actionOutputs: import("zod").ZodArray<import("zod").ZodDiscriminatedUnion<[import("zod").ZodObject<{
@@ -1183,8 +1308,13 @@ export declare const contract: {
         }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
     };
     deployment: {
+        cancel: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
+            deploymentId: import("zod").ZodString;
+            projectId: import("zod").ZodString;
+        }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
         create: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
             artifact: import("zod").ZodCustom<Blob, Blob>;
+            cancelExisting: import("zod").ZodDefault<import("zod").ZodBoolean>;
             manifest: import("zod").ZodArray<import("zod").ZodObject<{
                 identityKey: import("zod").ZodString;
             }, import("zod/v4/core").$strip>>;
@@ -1196,7 +1326,24 @@ export declare const contract: {
             rebindAccounts: import("zod").ZodDefault<import("zod").ZodBoolean>;
         }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
             id: import("zod").ZodString;
-        }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
+        }, import("zod/v4/core").$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, {
+            DEPLOYMENT_IN_PROGRESS: {
+                readonly data: import("zod").ZodObject<{
+                    deploymentId: import("zod").ZodString;
+                    status: import("zod").ZodEnum<{
+                        succeeded: "succeeded";
+                        failed: "failed";
+                        planning: "planning";
+                        awaiting_authorization: "awaiting_authorization";
+                        configuring: "configuring";
+                        publishing: "publishing";
+                        cancelled: "cancelled";
+                    }>;
+                }, import("zod/v4/core").$strip>;
+                readonly message: "A deployment is already in progress.";
+                readonly status: 409;
+            };
+        }>, Record<never, never>>;
         get: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
             deploymentId: import("zod").ZodString;
             projectId: import("zod").ZodString;
@@ -1231,6 +1378,7 @@ export declare const contract: {
                 awaiting_authorization: "awaiting_authorization";
                 configuring: "configuring";
                 publishing: "publishing";
+                cancelled: "cancelled";
             }>;
         }, import("zod/v4/core").$strip>, Record<never, never>, Record<never, never>>;
     };

package/dist/index.js

@@ -9,7 +9,7 @@ import { projectContract } from "./project.js";
 import { runtimeContract } from "./runtime.js";
 export { AUTOMATION_SDK_VERSION, deploymentTriggerInfoSchema, } from "./deployment.js";
 export { integrationAccountOutputSchema } from "./account.js";
-export { runtimeContract } from "./runtime.js";
+export { generationInputSchema, generationResultSchema, runtimeContract, } from "./runtime.js";
 export { createdOrganizationApiKeyOutputSchema, organizationApiKeyOutputSchema, } from "./api-key.js";
 export { integrationConnectionManifestSchema, integrationServiceManifestSchema, } from "./authorization.js";
 export { activeSubscriptionOutputSchema, createdInvitationOutputSchema, organizationDetailsOutputSchema, organizationInvitationOutputSchema, organizationMemberOutputSchema, organizationProjectOutputSchema, organizationRoleSchema, organizationSummaryOutputSchema, publicOrganizationOutputSchema, } from "./org.js";

package/dist/runtime.d.ts

@@ -1,4 +1,153 @@
 import { z } from "zod";
+/** Shared text-generation options accepted by the built-in generate action. */
+export declare const generationInputSchema: z.ZodUnion<readonly [z.ZodObject<{
+    frequencyPenalty: z.ZodOptional<z.ZodNumber>;
+    instructions: z.ZodOptional<z.ZodString>;
+    maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodString;
+    presencePenalty: z.ZodOptional<z.ZodNumber>;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    system: z.ZodOptional<z.ZodString>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    topK: z.ZodOptional<z.ZodNumber>;
+    topP: z.ZodOptional<z.ZodNumber>;
+    messages: z.ZodOptional<z.ZodNever>;
+    prompt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    frequencyPenalty: z.ZodOptional<z.ZodNumber>;
+    instructions: z.ZodOptional<z.ZodString>;
+    maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodString;
+    presencePenalty: z.ZodOptional<z.ZodNumber>;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    system: z.ZodOptional<z.ZodString>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    topK: z.ZodOptional<z.ZodNumber>;
+    topP: z.ZodOptional<z.ZodNumber>;
+    messages: z.ZodArray<z.ZodObject<{
+        content: z.ZodString;
+        role: z.ZodEnum<{
+            assistant: "assistant";
+            user: "user";
+        }>;
+    }, z.core.$strip>>;
+    prompt: z.ZodOptional<z.ZodNever>;
+}, z.core.$strip>]>;
+/** Serializable subset of the AI SDK text-generation result. */
+export declare const generationResultSchema: z.ZodObject<{
+    finishReason: z.ZodEnum<{
+        error: "error";
+        length: "length";
+        other: "other";
+        stop: "stop";
+        "content-filter": "content-filter";
+        "tool-calls": "tool-calls";
+    }>;
+    output: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+    providerMetadata: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+    rawFinishReason: z.ZodOptional<z.ZodString>;
+    reasoningText: z.ZodOptional<z.ZodString>;
+    response: z.ZodObject<{
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        id: z.ZodString;
+        modelId: z.ZodString;
+        timestamp: z.ZodISODateTime;
+    }, z.core.$strip>;
+    text: z.ZodString;
+    usage: z.ZodObject<{
+        inputTokenDetails: z.ZodObject<{
+            cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+            cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+            noCacheTokens: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+        outputTokenDetails: z.ZodObject<{
+            reasoningTokens: z.ZodOptional<z.ZodNumber>;
+            textTokens: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        outputTokens: z.ZodOptional<z.ZodNumber>;
+        raw: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+        totalTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    warnings: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        details: z.ZodOptional<z.ZodString>;
+        feature: z.ZodString;
+        type: z.ZodLiteral<"unsupported">;
+    }, z.core.$strip>, z.ZodObject<{
+        details: z.ZodOptional<z.ZodString>;
+        feature: z.ZodString;
+        type: z.ZodLiteral<"compatibility">;
+    }, z.core.$strip>, z.ZodObject<{
+        message: z.ZodString;
+        setting: z.ZodString;
+        type: z.ZodLiteral<"deprecated">;
+    }, z.core.$strip>, z.ZodObject<{
+        message: z.ZodString;
+        type: z.ZodLiteral<"other">;
+    }, z.core.$strip>], "type">>>;
+}, z.core.$strip>;
+export type GenerationInput = z.output<typeof generationInputSchema>;
+export type GenerationResult = z.output<typeof generationResultSchema>;
+declare const RUNTIME_GENERATION_INPUT_SCHEMA: z.ZodUnion<readonly [z.ZodObject<{
+    frequencyPenalty: z.ZodOptional<z.ZodNumber>;
+    instructions: z.ZodOptional<z.ZodString>;
+    maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodString;
+    presencePenalty: z.ZodOptional<z.ZodNumber>;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    system: z.ZodOptional<z.ZodString>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    topK: z.ZodOptional<z.ZodNumber>;
+    topP: z.ZodOptional<z.ZodNumber>;
+    messages: z.ZodOptional<z.ZodNever>;
+    prompt: z.ZodString;
+    output: z.ZodOptional<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        schema: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    frequencyPenalty: z.ZodOptional<z.ZodNumber>;
+    instructions: z.ZodOptional<z.ZodString>;
+    maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodString;
+    presencePenalty: z.ZodOptional<z.ZodNumber>;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    system: z.ZodOptional<z.ZodString>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    topK: z.ZodOptional<z.ZodNumber>;
+    topP: z.ZodOptional<z.ZodNumber>;
+    messages: z.ZodArray<z.ZodObject<{
+        content: z.ZodString;
+        role: z.ZodEnum<{
+            assistant: "assistant";
+            user: "user";
+        }>;
+    }, z.core.$strip>>;
+    prompt: z.ZodOptional<z.ZodNever>;
+    output: z.ZodOptional<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        schema: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+    }, z.core.$strip>>;
+}, z.core.$strip>]>;
+export type RuntimeGenerationInput = z.output<typeof RUNTIME_GENERATION_INPUT_SCHEMA>;
 export declare const runtimeContract: {
     commit: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
         actionInvocations: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -22,6 +171,108 @@ export declare const runtimeContract: {
         output: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
         status: z.ZodLiteral<"succeeded">;
     }, z.core.$strip>], "status">, z.ZodVoid, Record<never, never>, Record<never, never>>;
+    generate: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodUnion<readonly [z.ZodObject<{
+        frequencyPenalty: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        model: z.ZodString;
+        presencePenalty: z.ZodOptional<z.ZodNumber>;
+        providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        system: z.ZodOptional<z.ZodString>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        topK: z.ZodOptional<z.ZodNumber>;
+        topP: z.ZodOptional<z.ZodNumber>;
+        messages: z.ZodOptional<z.ZodNever>;
+        prompt: z.ZodString;
+        output: z.ZodOptional<z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            schema: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        frequencyPenalty: z.ZodOptional<z.ZodNumber>;
+        instructions: z.ZodOptional<z.ZodString>;
+        maxOutputTokens: z.ZodOptional<z.ZodNumber>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        model: z.ZodString;
+        presencePenalty: z.ZodOptional<z.ZodNumber>;
+        providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodJSONSchema>>>;
+        seed: z.ZodOptional<z.ZodNumber>;
+        stopSequences: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        system: z.ZodOptional<z.ZodString>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        timeout: z.ZodOptional<z.ZodNumber>;
+        topK: z.ZodOptional<z.ZodNumber>;
+        topP: z.ZodOptional<z.ZodNumber>;
+        messages: z.ZodArray<z.ZodObject<{
+            content: z.ZodString;
+            role: z.ZodEnum<{
+                assistant: "assistant";
+                user: "user";
+            }>;
+        }, z.core.$strip>>;
+        prompt: z.ZodOptional<z.ZodNever>;
+        output: z.ZodOptional<z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            schema: z.ZodRecord<z.ZodString, z.ZodJSONSchema>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>]>, z.ZodObject<{
+        finishReason: z.ZodEnum<{
+            error: "error";
+            length: "length";
+            other: "other";
+            stop: "stop";
+            "content-filter": "content-filter";
+            "tool-calls": "tool-calls";
+        }>;
+        output: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+        providerMetadata: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+        rawFinishReason: z.ZodOptional<z.ZodString>;
+        reasoningText: z.ZodOptional<z.ZodString>;
+        response: z.ZodObject<{
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            id: z.ZodString;
+            modelId: z.ZodString;
+            timestamp: z.ZodISODateTime;
+        }, z.core.$strip>;
+        text: z.ZodString;
+        usage: z.ZodObject<{
+            inputTokenDetails: z.ZodObject<{
+                cacheReadTokens: z.ZodOptional<z.ZodNumber>;
+                cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+                noCacheTokens: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>;
+            inputTokens: z.ZodOptional<z.ZodNumber>;
+            outputTokenDetails: z.ZodObject<{
+                reasoningTokens: z.ZodOptional<z.ZodNumber>;
+                textTokens: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>;
+            outputTokens: z.ZodOptional<z.ZodNumber>;
+            raw: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
+            totalTokens: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>;
+        warnings: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            details: z.ZodOptional<z.ZodString>;
+            feature: z.ZodString;
+            type: z.ZodLiteral<"unsupported">;
+        }, z.core.$strip>, z.ZodObject<{
+            details: z.ZodOptional<z.ZodString>;
+            feature: z.ZodString;
+            type: z.ZodLiteral<"compatibility">;
+        }, z.core.$strip>, z.ZodObject<{
+            message: z.ZodString;
+            setting: z.ZodString;
+            type: z.ZodLiteral<"deprecated">;
+        }, z.core.$strip>, z.ZodObject<{
+            message: z.ZodString;
+            type: z.ZodLiteral<"other">;
+        }, z.core.$strip>], "type">>>;
+    }, z.core.$strip>, Record<never, never>, Record<never, never>>;
     loadInvocation: import("@orpc/contract").ContractProcedureBuilderWithOutput<import("@orpc/contract").Schema<unknown, unknown>, z.ZodObject<{
         context: z.ZodObject<{
             actionOutputs: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -97,3 +348,4 @@ export declare const runtimeContract: {
         id: z.ZodNullable<z.ZodString>;
     }, z.core.$strip>, Record<never, never>, Record<never, never>>;
 };
+export {};

package/dist/runtime.js

@@ -6,6 +6,118 @@ const SIGNAL_FAILURE_SCHEMA = z.object({
     name: z.string(),
 });
 const TERMINAL_ACTION_STATUS_SCHEMA = z.enum(["closed", "failed", "succeeded"]);
+const GENERATION_WARNING_SCHEMA = z.discriminatedUnion("type", [
+    z.object({
+        details: z.string().optional(),
+        feature: z.string(),
+        type: z.literal("unsupported"),
+    }),
+    z.object({
+        details: z.string().optional(),
+        feature: z.string(),
+        type: z.literal("compatibility"),
+    }),
+    z.object({
+        message: z.string(),
+        setting: z.string(),
+        type: z.literal("deprecated"),
+    }),
+    z.object({
+        message: z.string(),
+        type: z.literal("other"),
+    }),
+]);
+const GENERATION_USAGE_SCHEMA = z.object({
+    inputTokenDetails: z.object({
+        cacheReadTokens: z.number().optional(),
+        cacheWriteTokens: z.number().optional(),
+        noCacheTokens: z.number().optional(),
+    }),
+    inputTokens: z.number().optional(),
+    outputTokenDetails: z.object({
+        reasoningTokens: z.number().optional(),
+        textTokens: z.number().optional(),
+    }),
+    outputTokens: z.number().optional(),
+    raw: encodableSchema,
+    totalTokens: z.number().optional(),
+});
+const GENERATION_OPTIONS_SCHEMA = z.object({
+    frequencyPenalty: z.number().optional(),
+    instructions: z.string().optional(),
+    maxOutputTokens: z.number().int().positive().optional(),
+    maxRetries: z.number().int().nonnegative().optional(),
+    model: z.string().min(1),
+    presencePenalty: z.number().optional(),
+    providerOptions: z
+        .record(z.string(), z.record(z.string(), z.json()))
+        .optional(),
+    seed: z.number().int().optional(),
+    stopSequences: z.string().array().min(1).optional(),
+    system: z.string().optional(),
+    temperature: z.number().optional(),
+    timeout: z.number().int().positive().optional(),
+    topK: z.number().int().positive().optional(),
+    topP: z.number().optional(),
+});
+const GENERATION_MESSAGES_INPUT_SCHEMA = GENERATION_OPTIONS_SCHEMA.extend({
+    messages: z
+        .object({
+        content: z.string(),
+        role: z.enum(["assistant", "user"]),
+    })
+        .array()
+        .min(1),
+    prompt: z.never().optional(),
+});
+const GENERATION_PROMPT_INPUT_SCHEMA = GENERATION_OPTIONS_SCHEMA.extend({
+    messages: z.never().optional(),
+    prompt: z.string(),
+});
+/** Shared text-generation options accepted by the built-in generate action. */
+export const generationInputSchema = z.union([
+    GENERATION_PROMPT_INPUT_SCHEMA,
+    GENERATION_MESSAGES_INPUT_SCHEMA,
+]);
+/** Serializable subset of the AI SDK text-generation result. */
+export const generationResultSchema = z.object({
+    finishReason: z.enum([
+        "stop",
+        "length",
+        "content-filter",
+        "tool-calls",
+        "error",
+        "other",
+    ]),
+    output: encodableSchema,
+    providerMetadata: encodableSchema,
+    rawFinishReason: z.string().optional(),
+    reasoningText: z.string().optional(),
+    response: z.object({
+        headers: z.record(z.string(), z.string()).optional(),
+        id: z.string(),
+        modelId: z.string(),
+        timestamp: z.iso.datetime(),
+    }),
+    text: z.string(),
+    usage: GENERATION_USAGE_SCHEMA,
+    warnings: GENERATION_WARNING_SCHEMA.array().optional(),
+});
+const RUNTIME_GENERATION_OUTPUT_SCHEMA = z
+    .object({
+    description: z.string().optional(),
+    name: z.string().optional(),
+    schema: z.record(z.string(), z.json()),
+})
+    .optional();
+const RUNTIME_GENERATION_INPUT_SCHEMA = z.union([
+    GENERATION_PROMPT_INPUT_SCHEMA.extend({
+        output: RUNTIME_GENERATION_OUTPUT_SCHEMA,
+    }),
+    GENERATION_MESSAGES_INPUT_SCHEMA.extend({
+        output: RUNTIME_GENERATION_OUTPUT_SCHEMA,
+    }),
+]);
 export const runtimeContract = {
     commit: oc
         .input(z.object({
@@ -35,6 +147,9 @@ export const runtimeContract = {
         }),
     ]))
         .output(z.void()),
+    generate: oc
+        .input(RUNTIME_GENERATION_INPUT_SCHEMA)
+        .output(generationResultSchema),
     loadInvocation: oc.output(z.object({
         context: z.object({
             actionOutputs: z

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/api-contract",
-  "version": "0.26.1",
+  "version": "0.28.0",
   "description": "Public oRPC contract for the Automate.ax API.",
   "license": "MIT",
   "repository": {
@@ -26,7 +26,7 @@
     }
   },
   "dependencies": {
-    "@automate.ax/codec": "0.26.1",
+    "@automate.ax/codec": "0.28.0",
     "@orpc/contract": "1.13.14",
     "zod": "^4.3.6"
   },

package/src/deployment.ts

@@ -17,11 +17,40 @@ export const deploymentTriggerInfoSchema = z.object({
 
 export type DeploymentTriggerInfo = z.infer<typeof deploymentTriggerInfoSchema>
 
+const DEPLOYMENT_STATUS_SCHEMA = z.enum([
+  "planning",
+  "awaiting_authorization",
+  "configuring",
+  "publishing",
+  "succeeded",
+  "failed",
+  "cancelled",
+])
+
+const DEPLOYMENT_IN_PROGRESS_ERROR = {
+  data: z.object({
+    deploymentId: z.string(),
+    status: DEPLOYMENT_STATUS_SCHEMA,
+  }),
+  message: "A deployment is already in progress.",
+  status: 409,
+} as const
+
 export const deploymentContract = {
+  cancel: oc
+    .input(
+      z.object({
+        deploymentId: z.string(),
+        projectId: z.string(),
+      }),
+    )
+    .output(z.void()),
   create: oc
+    .errors({ DEPLOYMENT_IN_PROGRESS: DEPLOYMENT_IN_PROGRESS_ERROR })
     .input(
       z.object({
         artifact: z.instanceof(Blob),
+        cancelExisting: z.boolean().default(false),
         manifest: z
           .object({
             identityKey: z.string().min(1),
@@ -76,14 +105,7 @@ export const deploymentContract = {
           id: z.string(),
           name: z.string(),
         }),
-        status: z.enum([
-          "planning",
-          "awaiting_authorization",
-          "configuring",
-          "publishing",
-          "succeeded",
-          "failed",
-        ]),
+        status: DEPLOYMENT_STATUS_SCHEMA,
       }),
     ),
 }

package/src/index.ts

@@ -14,7 +14,14 @@ export {
   type DeploymentTriggerInfo,
 } from "./deployment"
 export { integrationAccountOutputSchema } from "./account"
-export { runtimeContract } from "./runtime"
+export {
+  generationInputSchema,
+  generationResultSchema,
+  runtimeContract,
+  type GenerationInput,
+  type GenerationResult,
+  type RuntimeGenerationInput,
+} from "./runtime"
 export {
   createdOrganizationApiKeyOutputSchema,
   organizationApiKeyOutputSchema,

package/src/runtime.ts

@@ -9,6 +9,134 @@ const SIGNAL_FAILURE_SCHEMA = z.object({
 
 const TERMINAL_ACTION_STATUS_SCHEMA = z.enum(["closed", "failed", "succeeded"])
 
+const GENERATION_WARNING_SCHEMA = z.discriminatedUnion("type", [
+  z.object({
+    details: z.string().optional(),
+    feature: z.string(),
+    type: z.literal("unsupported"),
+  }),
+  z.object({
+    details: z.string().optional(),
+    feature: z.string(),
+    type: z.literal("compatibility"),
+  }),
+  z.object({
+    message: z.string(),
+    setting: z.string(),
+    type: z.literal("deprecated"),
+  }),
+  z.object({
+    message: z.string(),
+    type: z.literal("other"),
+  }),
+])
+
+const GENERATION_USAGE_SCHEMA = z.object({
+  inputTokenDetails: z.object({
+    cacheReadTokens: z.number().optional(),
+    cacheWriteTokens: z.number().optional(),
+    noCacheTokens: z.number().optional(),
+  }),
+  inputTokens: z.number().optional(),
+  outputTokenDetails: z.object({
+    reasoningTokens: z.number().optional(),
+    textTokens: z.number().optional(),
+  }),
+  outputTokens: z.number().optional(),
+  raw: encodableSchema,
+  totalTokens: z.number().optional(),
+})
+
+const GENERATION_OPTIONS_SCHEMA = z.object({
+  frequencyPenalty: z.number().optional(),
+  instructions: z.string().optional(),
+  maxOutputTokens: z.number().int().positive().optional(),
+  maxRetries: z.number().int().nonnegative().optional(),
+  model: z.string().min(1),
+  presencePenalty: z.number().optional(),
+  providerOptions: z
+    .record(z.string(), z.record(z.string(), z.json()))
+    .optional(),
+  seed: z.number().int().optional(),
+  stopSequences: z.string().array().min(1).optional(),
+  system: z.string().optional(),
+  temperature: z.number().optional(),
+  timeout: z.number().int().positive().optional(),
+  topK: z.number().int().positive().optional(),
+  topP: z.number().optional(),
+})
+
+const GENERATION_MESSAGES_INPUT_SCHEMA = GENERATION_OPTIONS_SCHEMA.extend({
+  messages: z
+    .object({
+      content: z.string(),
+      role: z.enum(["assistant", "user"]),
+    })
+    .array()
+    .min(1),
+  prompt: z.never().optional(),
+})
+
+const GENERATION_PROMPT_INPUT_SCHEMA = GENERATION_OPTIONS_SCHEMA.extend({
+  messages: z.never().optional(),
+  prompt: z.string(),
+})
+
+/** Shared text-generation options accepted by the built-in generate action. */
+export const generationInputSchema = z.union([
+  GENERATION_PROMPT_INPUT_SCHEMA,
+  GENERATION_MESSAGES_INPUT_SCHEMA,
+])
+
+/** Serializable subset of the AI SDK text-generation result. */
+export const generationResultSchema = z.object({
+  finishReason: z.enum([
+    "stop",
+    "length",
+    "content-filter",
+    "tool-calls",
+    "error",
+    "other",
+  ]),
+  output: encodableSchema,
+  providerMetadata: encodableSchema,
+  rawFinishReason: z.string().optional(),
+  reasoningText: z.string().optional(),
+  response: z.object({
+    headers: z.record(z.string(), z.string()).optional(),
+    id: z.string(),
+    modelId: z.string(),
+    timestamp: z.iso.datetime(),
+  }),
+  text: z.string(),
+  usage: GENERATION_USAGE_SCHEMA,
+  warnings: GENERATION_WARNING_SCHEMA.array().optional(),
+})
+
+export type GenerationInput = z.output<typeof generationInputSchema>
+export type GenerationResult = z.output<typeof generationResultSchema>
+
+const RUNTIME_GENERATION_OUTPUT_SCHEMA = z
+  .object({
+    description: z.string().optional(),
+    name: z.string().optional(),
+    schema: z.record(z.string(), z.json()),
+  })
+  .optional()
+
+const RUNTIME_GENERATION_INPUT_SCHEMA = z.union([
+  GENERATION_PROMPT_INPUT_SCHEMA.extend({
+    output: RUNTIME_GENERATION_OUTPUT_SCHEMA,
+  }),
+  GENERATION_MESSAGES_INPUT_SCHEMA.extend({
+    output: RUNTIME_GENERATION_OUTPUT_SCHEMA,
+  }),
+])
+
+export type RuntimeGenerationInput = z.output<
+  typeof RUNTIME_GENERATION_INPUT_SCHEMA
+>
+
 export const runtimeContract = {
   commit: oc
     .input(
@@ -42,6 +170,9 @@ export const runtimeContract = {
       ]),
     )
     .output(z.void()),
+  generate: oc
+    .input(RUNTIME_GENERATION_INPUT_SCHEMA)
+    .output(generationResultSchema),
   loadInvocation: oc.output(
     z.object({
       context: z.object({