@automate.ax/api-contract 0.96.0 → 0.97.0

package/dist/execution-data.d.ts

@@ -1,11 +1,14 @@
 import { z } from "zod";
 export declare const EXECUTION_DATASET_VERSION = 8;
+/** @deprecated Retained until execution dataset version 8 clients are retired. */
+export declare const LEGACY_TRACE_SPANS_EXECUTION_DATASET_RESOURCE: "trace-spans";
 export declare const executionDatasetResourceSchema: z.ZodEnum<{
     automations: "automations";
     projects: "projects";
     events: "events";
     actions: "actions";
     outputs: "outputs";
+    "trace-spans": "trace-spans";
     "automation-invocations": "automation-invocations";
     contexts: "contexts";
     "context-parents": "context-parents";
@@ -16,7 +19,6 @@ export declare const executionDatasetResourceSchema: z.ZodEnum<{
     "signal-offers": "signal-offers";
     "signal-decisions": "signal-decisions";
     logs: "logs";
-    "trace-spans": "trace-spans";
 }>;
 export declare const executionDatasetScopeSchema: z.ZodObject<{
     organizationId: z.ZodNullable<z.ZodString>;
@@ -34,6 +36,7 @@ export declare const executionDatasetManifestSchema: z.ZodObject<{
             events: "events";
             actions: "actions";
             outputs: "outputs";
+            "trace-spans": "trace-spans";
             "automation-invocations": "automation-invocations";
             contexts: "contexts";
             "context-parents": "context-parents";
@@ -44,11 +47,10 @@ export declare const executionDatasetManifestSchema: z.ZodObject<{
             "signal-offers": "signal-offers";
             "signal-decisions": "signal-decisions";
             logs: "logs";
-            "trace-spans": "trace-spans";
         }>;
         url: z.ZodURL;
     }, z.core.$strip>>;
-    schemaVersion: z.ZodLiteral<8>;
+    schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<8>, z.ZodLiteral<9>]>;
     scope: z.ZodObject<{
         organizationId: z.ZodNullable<z.ZodString>;
         projectId: z.ZodNullable<z.ZodString>;
@@ -73,6 +75,7 @@ export declare const executionDataContract: {
                 events: "events";
                 actions: "actions";
                 outputs: "outputs";
+                "trace-spans": "trace-spans";
                 "automation-invocations": "automation-invocations";
                 contexts: "contexts";
                 "context-parents": "context-parents";
@@ -83,11 +86,10 @@ export declare const executionDataContract: {
                 "signal-offers": "signal-offers";
                 "signal-decisions": "signal-decisions";
                 logs: "logs";
-                "trace-spans": "trace-spans";
             }>;
             url: z.ZodURL;
         }, z.core.$strip>>;
-        schemaVersion: z.ZodLiteral<8>;
+        schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<8>, z.ZodLiteral<9>]>;
         scope: z.ZodObject<{
             organizationId: z.ZodNullable<z.ZodString>;
             projectId: z.ZodNullable<z.ZodString>;

package/dist/execution-data.js

@@ -1,6 +1,9 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
 export const EXECUTION_DATASET_VERSION = 8;
+const NEXT_EXECUTION_DATASET_VERSION = 9;
+/** @deprecated Retained until execution dataset version 8 clients are retired. */
+export const LEGACY_TRACE_SPANS_EXECUTION_DATASET_RESOURCE = "trace-spans";
 export const executionDatasetResourceSchema = z.enum([
     "projects",
     "automations",
@@ -17,7 +20,7 @@ export const executionDatasetResourceSchema = z.enum([
     "signal-decisions",
     "logs",
     "outputs",
-    "trace-spans",
+    LEGACY_TRACE_SPANS_EXECUTION_DATASET_RESOURCE,
 ]);
 export const executionDatasetScopeSchema = z.object({
     organizationId: z.string().nullable(),
@@ -36,7 +39,10 @@ export const executionDatasetManifestSchema = z.object({
         url: z.url(),
     })
         .array(),
-    schemaVersion: z.literal(EXECUTION_DATASET_VERSION),
+    schemaVersion: z.union([
+        z.literal(EXECUTION_DATASET_VERSION),
+        z.literal(NEXT_EXECUTION_DATASET_VERSION),
+    ]),
     scope: executionDatasetScopeSchema,
 });
 export const executionDataContract = {

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { AUTOMATION_SDK_VERSION, deploymentOutputSchema, deploymentStatusSchema,
 export { AUTOMATION_RUNTIME_PROTOCOL_VERSION } from "./runtime-protocol.js";
 export { AUTOMATION_ERROR_CAUSE_DEPTH, automationErrorSchema, type AutomationErrorValue, } from "./errors.js";
 export { integrationAccountOutputSchema, integrationAccountRevocationImpactOutputSchema, integrationAccountRevocationOutputSchema, integrationServiceOutputSchema, } from "./account.js";
-export { AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT, AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX, AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX, AUTOMATION_LOG_MAX_ENTRIES, AUTOMATION_LOG_MAX_MESSAGE_LENGTH, AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES, AUTOMATION_OBSERVABILITY_MAX_FIELDS, AUTOMATION_TRACE_MAX_NAME_LENGTH, AUTOMATION_TRACE_MAX_SPANS, DEFAULT_GATEWAY_IMAGE_MODEL_ID, DEFAULT_GATEWAY_MODEL_ID, DEFAULT_ACTION_MAX_ATTEMPTS, MAX_ACTION_ATTEMPTS, actionReplaySafetySchema, automationInvocationInputSchema, automationInvocationOutputSchema, automationInvocationScheduleSchema, generationInputSchema, generationResultSchema, imageGenerationInputSchema, imageGenerationCompletionSchema, imageGenerationResultSchema, platformImageGenerationInputSchema, platformImageGenerationStartSchema, hashSignalCoordinatorConfiguration, runtimeContract, type GenerationInput, type GenerationResult, type ImageGenerationInput, type ImageGenerationCompletion, type ImageGenerationResult, type PlatformImageGenerationInput, type RuntimeGenerationInput, type RuntimeCoordinationOffer, type ActionReplaySafety, type RuntimeActionAttemptCompletion, type RuntimeActionAttemptStart, } from "./runtime.js";
+export { AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT, AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX, AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX, AUTOMATION_LOG_MAX_ENTRIES, AUTOMATION_LOG_MAX_MESSAGE_LENGTH, AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES, AUTOMATION_OBSERVABILITY_MAX_FIELDS, DEFAULT_GATEWAY_IMAGE_MODEL_ID, DEFAULT_GATEWAY_MODEL_ID, DEFAULT_ACTION_MAX_ATTEMPTS, MAX_ACTION_ATTEMPTS, actionReplaySafetySchema, automationInvocationInputSchema, automationInvocationOutputSchema, automationInvocationScheduleSchema, generationInputSchema, generationResultSchema, imageGenerationInputSchema, imageGenerationCompletionSchema, imageGenerationResultSchema, platformImageGenerationInputSchema, platformImageGenerationStartSchema, hashSignalCoordinatorConfiguration, runtimeContract, type GenerationInput, type GenerationResult, type ImageGenerationInput, type ImageGenerationCompletion, type ImageGenerationResult, type PlatformImageGenerationInput, type RuntimeGenerationInput, type RuntimeCoordinationOffer, type ActionReplaySafety, type RuntimeActionAttemptCompletion, type RuntimeActionAttemptStart, } from "./runtime.js";
 export type { GatewayImageModelId, GatewayModelId } from "@ai-sdk/gateway";
 export { createdOrganizationApiKeyOutputSchema, organizationApiKeyOutputSchema, } from "./api-key.js";
 export { activeSubscriptionOutputSchema, createdInvitationOutputSchema, organizationDetailsOutputSchema, organizationInvitationOutputSchema, organizationMemberOutputSchema, organizationProjectOutputSchema, organizationRoleSchema, organizationSummaryOutputSchema, publicOrganizationOutputSchema, } from "./org.js";
@@ -676,6 +676,7 @@ export declare const publicContract: {
                     events: "events";
                     actions: "actions";
                     outputs: "outputs";
+                    "trace-spans": "trace-spans";
                     "automation-invocations": "automation-invocations";
                     contexts: "contexts";
                     "context-parents": "context-parents";
@@ -686,11 +687,10 @@ export declare const publicContract: {
                     "signal-offers": "signal-offers";
                     "signal-decisions": "signal-decisions";
                     logs: "logs";
-                    "trace-spans": "trace-spans";
                 }>;
                 url: import("zod").ZodURL;
             }, import("zod/v4/core").$strip>>;
-            schemaVersion: import("zod").ZodLiteral<8>;
+            schemaVersion: import("zod").ZodUnion<readonly [import("zod").ZodLiteral<8>, import("zod").ZodLiteral<9>]>;
             scope: import("zod").ZodObject<{
                 organizationId: import("zod").ZodNullable<import("zod").ZodString>;
                 projectId: import("zod").ZodNullable<import("zod").ZodString>;
@@ -2032,6 +2032,7 @@ export declare const firstPartyContract: {
                     events: "events";
                     actions: "actions";
                     outputs: "outputs";
+                    "trace-spans": "trace-spans";
                     "automation-invocations": "automation-invocations";
                     contexts: "contexts";
                     "context-parents": "context-parents";
@@ -2042,11 +2043,10 @@ export declare const firstPartyContract: {
                     "signal-offers": "signal-offers";
                     "signal-decisions": "signal-decisions";
                     logs: "logs";
-                    "trace-spans": "trace-spans";
                 }>;
                 url: import("zod").ZodURL;
             }, import("zod/v4/core").$strip>>;
-            schemaVersion: import("zod").ZodLiteral<8>;
+            schemaVersion: import("zod").ZodUnion<readonly [import("zod").ZodLiteral<8>, import("zod").ZodLiteral<9>]>;
             scope: import("zod").ZodObject<{
                 organizationId: import("zod").ZodNullable<import("zod").ZodString>;
                 projectId: import("zod").ZodNullable<import("zod").ZodString>;
@@ -4208,15 +4208,6 @@ export declare const contract: {
             output: import("zod").ZodCustom<import("@automate.ax/codec/rpc").CodecEnvelope, import("@automate.ax/codec/rpc").CodecEnvelope>;
             status: import("zod").ZodLiteral<"succeeded">;
         }, import("zod/v4/core").$strip>], "status">, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
-        completeTraceSpan: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodIntersection<import("zod").ZodObject<{
-            completedAt: import("zod").ZodDate;
-            spanIndex: import("zod").ZodNumber;
-        }, import("zod/v4/core").$strip>, import("zod").ZodUnion<readonly [import("zod").ZodObject<{
-            status: import("zod").ZodLiteral<"succeeded">;
-        }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
-            failure: import("zod").ZodType<import("./errors").AutomationErrorValue, import("./errors").AutomationErrorValue, import("zod/v4/core").$ZodTypeInternals<import("./errors").AutomationErrorValue, import("./errors").AutomationErrorValue>>;
-            status: import("zod").ZodLiteral<"failed">;
-        }, import("zod/v4/core").$strip>]>>, 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>;
@@ -4970,17 +4961,8 @@ export declare const contract: {
             logIndex: import("zod").ZodNumber;
             message: import("zod").ZodString;
             sensitivity: import("zod").ZodOptional<import("zod").ZodCustom<import("@automate.ax/codec").SensitivityMask, import("@automate.ax/codec").SensitivityMask>>;
-            spanIndex: import("zod").ZodOptional<import("zod").ZodNumber>;
             timestamp: import("zod").ZodDate;
         }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
-        startTraceSpan: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodObject<{
-            attributes: import("zod").ZodOptional<import("zod").ZodCustom<import("@automate.ax/codec/rpc").CodecEnvelope, import("@automate.ax/codec/rpc").CodecEnvelope>>;
-            name: import("zod").ZodString;
-            sensitivity: import("zod").ZodOptional<import("zod").ZodCustom<import("@automate.ax/codec").SensitivityMask, import("@automate.ax/codec").SensitivityMask>>;
-            parentSpanIndex: import("zod").ZodOptional<import("zod").ZodNumber>;
-            spanIndex: import("zod").ZodNumber;
-            startedAt: import("zod").ZodDate;
-        }, import("zod/v4/core").$strip>, import("zod").ZodVoid, Record<never, never>, Record<never, never>>;
         sendEmail: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<import("zod").ZodIntersection<import("zod").ZodObject<{
             headers: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodString>>;
             replyTo: import("zod").ZodOptional<import("zod").ZodEmail>;
@@ -6011,6 +5993,7 @@ export declare const contract: {
                     events: "events";
                     actions: "actions";
                     outputs: "outputs";
+                    "trace-spans": "trace-spans";
                     "automation-invocations": "automation-invocations";
                     contexts: "contexts";
                     "context-parents": "context-parents";
@@ -6021,11 +6004,10 @@ export declare const contract: {
                     "signal-offers": "signal-offers";
                     "signal-decisions": "signal-decisions";
                     logs: "logs";
-                    "trace-spans": "trace-spans";
                 }>;
                 url: import("zod").ZodURL;
             }, import("zod/v4/core").$strip>>;
-            schemaVersion: import("zod").ZodLiteral<8>;
+            schemaVersion: import("zod").ZodUnion<readonly [import("zod").ZodLiteral<8>, import("zod").ZodLiteral<9>]>;
             scope: import("zod").ZodObject<{
                 organizationId: import("zod").ZodNullable<import("zod").ZodString>;
                 projectId: import("zod").ZodNullable<import("zod").ZodString>;

package/dist/index.js

@@ -15,7 +15,7 @@ export { AUTOMATION_SDK_VERSION, deploymentOutputSchema, deploymentStatusSchema,
 export { AUTOMATION_RUNTIME_PROTOCOL_VERSION } from "./runtime-protocol.js";
 export { AUTOMATION_ERROR_CAUSE_DEPTH, automationErrorSchema, } from "./errors.js";
 export { integrationAccountOutputSchema, integrationAccountRevocationImpactOutputSchema, integrationAccountRevocationOutputSchema, integrationServiceOutputSchema, } from "./account.js";
-export { AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT, AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX, AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX, AUTOMATION_LOG_MAX_ENTRIES, AUTOMATION_LOG_MAX_MESSAGE_LENGTH, AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES, AUTOMATION_OBSERVABILITY_MAX_FIELDS, AUTOMATION_TRACE_MAX_NAME_LENGTH, AUTOMATION_TRACE_MAX_SPANS, DEFAULT_GATEWAY_IMAGE_MODEL_ID, DEFAULT_GATEWAY_MODEL_ID, DEFAULT_ACTION_MAX_ATTEMPTS, MAX_ACTION_ATTEMPTS, actionReplaySafetySchema, automationInvocationInputSchema, automationInvocationOutputSchema, automationInvocationScheduleSchema, generationInputSchema, generationResultSchema, imageGenerationInputSchema, imageGenerationCompletionSchema, imageGenerationResultSchema, platformImageGenerationInputSchema, platformImageGenerationStartSchema, hashSignalCoordinatorConfiguration, runtimeContract, } from "./runtime.js";
+export { AUTOMATION_INVOCATION_DEFAULT_ENTRYPOINT, AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX, AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX, AUTOMATION_LOG_MAX_ENTRIES, AUTOMATION_LOG_MAX_MESSAGE_LENGTH, AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES, AUTOMATION_OBSERVABILITY_MAX_FIELDS, DEFAULT_GATEWAY_IMAGE_MODEL_ID, DEFAULT_GATEWAY_MODEL_ID, DEFAULT_ACTION_MAX_ATTEMPTS, MAX_ACTION_ATTEMPTS, actionReplaySafetySchema, automationInvocationInputSchema, automationInvocationOutputSchema, automationInvocationScheduleSchema, generationInputSchema, generationResultSchema, imageGenerationInputSchema, imageGenerationCompletionSchema, imageGenerationResultSchema, platformImageGenerationInputSchema, platformImageGenerationStartSchema, hashSignalCoordinatorConfiguration, runtimeContract, } from "./runtime.js";
 export { createdOrganizationApiKeyOutputSchema, organizationApiKeyOutputSchema, } from "./api-key.js";
 export { activeSubscriptionOutputSchema, createdInvitationOutputSchema, organizationDetailsOutputSchema, organizationInvitationOutputSchema, organizationMemberOutputSchema, organizationProjectOutputSchema, organizationRoleSchema, organizationSummaryOutputSchema, publicOrganizationOutputSchema, } from "./org.js";
 export { projectOutputSchema } from "./project.js";

package/dist/runtime.d.ts

@@ -12,11 +12,9 @@ export declare const AUTOMATION_DELAY_ENTRYPOINT_PREFIX: "__$delay:";
 export declare const AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX: "__$generate-image:";
 export declare const CALLBACK_PROTECTION_QUERY_PARAMETER = "_axCallback";
 export declare const AUTOMATION_LOG_MAX_ENTRIES = 1000;
-export declare const AUTOMATION_TRACE_MAX_SPANS = 250;
 export declare const AUTOMATION_OBSERVABILITY_MAX_FIELDS = 64;
 export declare const AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES: number;
 export declare const AUTOMATION_LOG_MAX_MESSAGE_LENGTH = 16384;
-export declare const AUTOMATION_TRACE_MAX_NAME_LENGTH = 256;
 export declare const runtimeObservabilityFieldsSchema: z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>;
 /** Runtime-validated structural policy for author-visible value projection. */
 export declare const sensitivityMaskSchema: z.ZodCustom<SensitivityMask, SensitivityMask>;
@@ -1712,15 +1710,6 @@ export declare const runtimeContract: {
         output: z.ZodCustom<import("@automate.ax/codec/rpc").CodecEnvelope, import("@automate.ax/codec/rpc").CodecEnvelope>;
         status: z.ZodLiteral<"succeeded">;
     }, z.core.$strip>], "status">, z.ZodVoid, Record<never, never>, Record<never, never>>;
-    completeTraceSpan: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodIntersection<z.ZodObject<{
-        completedAt: z.ZodDate;
-        spanIndex: z.ZodNumber;
-    }, z.core.$strip>, z.ZodUnion<readonly [z.ZodObject<{
-        status: z.ZodLiteral<"succeeded">;
-    }, z.core.$strip>, z.ZodObject<{
-        failure: z.ZodType<import("./errors").AutomationErrorValue, import("./errors").AutomationErrorValue, z.core.$ZodTypeInternals<import("./errors").AutomationErrorValue, import("./errors").AutomationErrorValue>>;
-        status: z.ZodLiteral<"failed">;
-    }, z.core.$strip>]>>, 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>;
@@ -2474,17 +2463,8 @@ export declare const runtimeContract: {
         logIndex: z.ZodNumber;
         message: z.ZodString;
         sensitivity: z.ZodOptional<z.ZodCustom<SensitivityMask, SensitivityMask>>;
-        spanIndex: z.ZodOptional<z.ZodNumber>;
         timestamp: z.ZodDate;
     }, z.core.$strip>, z.ZodVoid, Record<never, never>, Record<never, never>>;
-    startTraceSpan: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
-        attributes: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec/rpc").CodecEnvelope, import("@automate.ax/codec/rpc").CodecEnvelope>>;
-        name: z.ZodString;
-        sensitivity: z.ZodOptional<z.ZodCustom<SensitivityMask, SensitivityMask>>;
-        parentSpanIndex: z.ZodOptional<z.ZodNumber>;
-        spanIndex: z.ZodNumber;
-        startedAt: z.ZodDate;
-    }, z.core.$strip>, z.ZodVoid, Record<never, never>, Record<never, never>>;
     sendEmail: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodIntersection<z.ZodObject<{
         headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         replyTo: z.ZodOptional<z.ZodEmail>;

package/dist/runtime.js

@@ -14,11 +14,9 @@ export const AUTOMATION_DELAY_ENTRYPOINT_PREFIX = `${AUTOMATION_INVOCATION_RESER
 export const AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX = `${AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX}generate-image:`;
 export const CALLBACK_PROTECTION_QUERY_PARAMETER = "_axCallback";
 export const AUTOMATION_LOG_MAX_ENTRIES = 1_000;
-export const AUTOMATION_TRACE_MAX_SPANS = 250;
 export const AUTOMATION_OBSERVABILITY_MAX_FIELDS = 64;
 export const AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES = 64 * 1_024;
 export const AUTOMATION_LOG_MAX_MESSAGE_LENGTH = 16_384;
-export const AUTOMATION_TRACE_MAX_NAME_LENGTH = 256;
 const OUTCOME_SEQUENCE_SCHEMA = z.number().int().positive();
 const HOOK_SCOPE_PATH_SCHEMA = z.number().int().nonnegative().array();
 export const runtimeObservabilityFieldsSchema = z
@@ -29,11 +27,6 @@ const LOG_INDEX_SCHEMA = z
     .int()
     .min(0)
     .max(AUTOMATION_LOG_MAX_ENTRIES - 1);
-const TRACE_SPAN_INDEX_SCHEMA = z
-    .number()
-    .int()
-    .min(0)
-    .max(AUTOMATION_TRACE_MAX_SPANS - 1);
 /** Runtime-validated structural policy for author-visible value projection. */
 export const sensitivityMaskSchema = z.custom(isSensitivityMask, { message: "Invalid structural sensitivity mask" });
 const AUTOMATION_INVOCATION_RUN_AT_SCHEMA = z.union([
@@ -891,20 +884,6 @@ export const runtimeContract = {
     completeActionAttempt: oc
         .input(ACTION_ATTEMPT_COMPLETION_TRANSPORT_SCHEMA)
         .output(z.void()),
-    completeTraceSpan: oc
-        .input(z
-        .object({
-        completedAt: z.date(),
-        spanIndex: TRACE_SPAN_INDEX_SCHEMA,
-    })
-        .and(z.union([
-        z.object({ status: z.literal("succeeded") }),
-        z.object({
-            failure: automationErrorSchema,
-            status: z.literal("failed"),
-        }),
-    ])))
-        .output(z.void()),
     generate: oc
         .input(RUNTIME_GENERATION_INPUT_SCHEMA)
         .output(RUNTIME_GENERATION_RESULT_SCHEMA),
@@ -919,6 +898,7 @@ export const runtimeContract = {
         .output(automationInvocationOutputSchema),
     load: oc.output(z.object({
         context: RUNTIME_RUN_CONTEXT_SCHEMA,
+        /** @deprecated Retained for deployed runtime protocol 2 bundles. */
         finalAttempt: z.boolean(),
         targetAction: TARGET_ACTION_TRANSPORT_SCHEMA.optional(),
     })),
@@ -958,20 +938,9 @@ export const runtimeContract = {
         logIndex: LOG_INDEX_SCHEMA,
         message: z.string().min(1).max(AUTOMATION_LOG_MAX_MESSAGE_LENGTH),
         sensitivity: sensitivityMaskSchema.optional(),
-        spanIndex: TRACE_SPAN_INDEX_SCHEMA.optional(),
         timestamp: z.date(),
     }))
         .output(z.void()),
-    startTraceSpan: oc
-        .input(z.object({
-        attributes: codecEnvelopeSchema.optional(),
-        name: z.string().min(1).max(AUTOMATION_TRACE_MAX_NAME_LENGTH),
-        sensitivity: sensitivityMaskSchema.optional(),
-        parentSpanIndex: TRACE_SPAN_INDEX_SCHEMA.optional(),
-        spanIndex: TRACE_SPAN_INDEX_SCHEMA,
-        startedAt: z.date(),
-    }))
-        .output(z.void()),
     sendEmail: oc
         .input(z
         .object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/api-contract",
-  "version": "0.96.0",
+  "version": "0.97.0",
   "description": "Public oRPC contract for the Automate.ax API.",
   "license": "MIT",
   "repository": {
@@ -31,8 +31,8 @@
   },
   "dependencies": {
     "@ai-sdk/gateway": "4.0.46",
-    "@automate.ax/codec": "0.96.0",
-    "@automate.ax/integration-contracts": "0.96.0",
+    "@automate.ax/codec": "0.97.0",
+    "@automate.ax/integration-contracts": "0.97.0",
     "@orpc/contract": "1.15.0",
     "fast-json-stable-stringify": "^2.1.0",
     "zod": "^4.3.6"

package/src/execution-data.ts

@@ -2,6 +2,11 @@ import { oc } from "@orpc/contract"
 import { z } from "zod"
 
 export const EXECUTION_DATASET_VERSION = 8
+const NEXT_EXECUTION_DATASET_VERSION = 9
+
+/** @deprecated Retained until execution dataset version 8 clients are retired. */
+export const LEGACY_TRACE_SPANS_EXECUTION_DATASET_RESOURCE =
+  "trace-spans" as const
 
 export const executionDatasetResourceSchema = z.enum([
   "projects",
@@ -19,7 +24,7 @@ export const executionDatasetResourceSchema = z.enum([
   "signal-decisions",
   "logs",
   "outputs",
-  "trace-spans",
+  LEGACY_TRACE_SPANS_EXECUTION_DATASET_RESOURCE,
 ])
 
 export const executionDatasetScopeSchema = z.object({
@@ -44,7 +49,10 @@ export const executionDatasetManifestSchema = z.object({
       url: z.url(),
     })
     .array(),
-  schemaVersion: z.literal(EXECUTION_DATASET_VERSION),
+  schemaVersion: z.union([
+    z.literal(EXECUTION_DATASET_VERSION),
+    z.literal(NEXT_EXECUTION_DATASET_VERSION),
+  ]),
   scope: executionDatasetScopeSchema,
 })
 

package/src/index.ts

@@ -50,8 +50,6 @@ export {
   AUTOMATION_LOG_MAX_MESSAGE_LENGTH,
   AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES,
   AUTOMATION_OBSERVABILITY_MAX_FIELDS,
-  AUTOMATION_TRACE_MAX_NAME_LENGTH,
-  AUTOMATION_TRACE_MAX_SPANS,
   DEFAULT_GATEWAY_IMAGE_MODEL_ID,
   DEFAULT_GATEWAY_MODEL_ID,
   DEFAULT_ACTION_MAX_ATTEMPTS,

package/src/runtime.ts

@@ -27,12 +27,10 @@ export const AUTOMATION_IMAGE_GENERATION_ENTRYPOINT_PREFIX =
   `${AUTOMATION_INVOCATION_RESERVED_ENTRYPOINT_PREFIX}generate-image:` as const
 export const CALLBACK_PROTECTION_QUERY_PARAMETER = "_axCallback"
 export const AUTOMATION_LOG_MAX_ENTRIES = 1_000
-export const AUTOMATION_TRACE_MAX_SPANS = 250
 export const AUTOMATION_OBSERVABILITY_MAX_FIELDS = 64
 export const AUTOMATION_OBSERVABILITY_MAX_ENCODED_BYTES = 64 * 1_024
 
 export const AUTOMATION_LOG_MAX_MESSAGE_LENGTH = 16_384
-export const AUTOMATION_TRACE_MAX_NAME_LENGTH = 256
 
 const OUTCOME_SEQUENCE_SCHEMA = z.number().int().positive()
 const HOOK_SCOPE_PATH_SCHEMA = z.number().int().nonnegative().array()
@@ -48,11 +46,6 @@ const LOG_INDEX_SCHEMA = z
   .int()
   .min(0)
   .max(AUTOMATION_LOG_MAX_ENTRIES - 1)
-const TRACE_SPAN_INDEX_SCHEMA = z
-  .number()
-  .int()
-  .min(0)
-  .max(AUTOMATION_TRACE_MAX_SPANS - 1)
 
 /** Runtime-validated structural policy for author-visible value projection. */
 export const sensitivityMaskSchema = z.custom<SensitivityMask>(
@@ -1081,24 +1074,6 @@ export const runtimeContract = {
   completeActionAttempt: oc
     .input(ACTION_ATTEMPT_COMPLETION_TRANSPORT_SCHEMA)
     .output(z.void()),
-  completeTraceSpan: oc
-    .input(
-      z
-        .object({
-          completedAt: z.date(),
-          spanIndex: TRACE_SPAN_INDEX_SCHEMA,
-        })
-        .and(
-          z.union([
-            z.object({ status: z.literal("succeeded") }),
-            z.object({
-              failure: automationErrorSchema,
-              status: z.literal("failed"),
-            }),
-          ]),
-        ),
-    )
-    .output(z.void()),
   generate: oc
     .input(RUNTIME_GENERATION_INPUT_SCHEMA)
     .output(RUNTIME_GENERATION_RESULT_SCHEMA),
@@ -1114,6 +1089,8 @@ export const runtimeContract = {
   load: oc.output(
     z.object({
       context: RUNTIME_RUN_CONTEXT_SCHEMA,
+
+      /** @deprecated Retained for deployed runtime protocol 2 bundles. */
       finalAttempt: z.boolean(),
       targetAction: TARGET_ACTION_TRANSPORT_SCHEMA.optional(),
     }),
@@ -1163,23 +1140,10 @@ export const runtimeContract = {
         logIndex: LOG_INDEX_SCHEMA,
         message: z.string().min(1).max(AUTOMATION_LOG_MAX_MESSAGE_LENGTH),
         sensitivity: sensitivityMaskSchema.optional(),
-        spanIndex: TRACE_SPAN_INDEX_SCHEMA.optional(),
         timestamp: z.date(),
       }),
     )
     .output(z.void()),
-  startTraceSpan: oc
-    .input(
-      z.object({
-        attributes: codecEnvelopeSchema.optional(),
-        name: z.string().min(1).max(AUTOMATION_TRACE_MAX_NAME_LENGTH),
-        sensitivity: sensitivityMaskSchema.optional(),
-        parentSpanIndex: TRACE_SPAN_INDEX_SCHEMA.optional(),
-        spanIndex: TRACE_SPAN_INDEX_SCHEMA,
-        startedAt: z.date(),
-      }),
-    )
-    .output(z.void()),
   sendEmail: oc
     .input(
       z