@sequenceholdings/agent-spec 0.1.1 → 0.1.3

package/dist/input-schema.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+const inputFieldSchema = z
+    .object({
+    name: z
+        .string()
+        .min(1)
+        .regex(/^[A-Za-z_][A-Za-z0-9_]*$/, 'name must be a valid identifier'),
+    label: z.string().optional(),
+    description: z.string().optional(),
+    type: z.enum(['string', 'text', 'number', 'boolean', 'enum']),
+    required: z.boolean().optional(),
+    default: z.union([z.string(), z.number(), z.boolean()]).optional(),
+    enum: z.array(z.string()).optional(),
+    placeholder: z.string().optional(),
+})
+    .superRefine((field, context) => {
+    if (field.type === 'enum') {
+        if (field.enum === undefined || field.enum.length === 0) {
+            context.addIssue({
+                code: 'custom',
+                path: ['enum'],
+                message: 'enum fields require at least one option',
+            });
+        }
+        if (field.default !== undefined &&
+            (typeof field.default !== 'string' ||
+                !field.enum?.includes(field.default))) {
+            context.addIssue({
+                code: 'custom',
+                path: ['default'],
+                message: 'default must be one of the declared enum options',
+            });
+        }
+        return;
+    }
+    if (field.default === undefined)
+        return;
+    const expected = field.type === 'number'
+        ? 'number'
+        : field.type === 'boolean'
+            ? 'boolean'
+            : 'string';
+    if (typeof field.default !== expected) {
+        context.addIssue({
+            code: 'custom',
+            path: ['default'],
+            message: `default for ${field.type} fields must be a ${expected}`,
+        });
+    }
+});
+export const inputSchemaSchema = z
+    .object({ fields: z.array(inputFieldSchema) })
+    .refine((schema) => new Set(schema.fields.map((field) => field.name)).size ===
+    schema.fields.length, {
+    path: ['fields'],
+    message: 'fields[].name must be unique within an inputSchema',
+});

package/dist/voice-access.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import { type VoiceScope } from './voice-common.js';
+export declare const voiceParticipantPolicySchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    environmentId: z.ZodString;
+    revision: z.ZodNumber;
+    participantPrincipalIds: z.ZodArray<z.ZodString>;
+    operatorPrincipalIds: z.ZodArray<z.ZodString>;
+    updatedByPrincipalId: z.ZodString;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type VoiceParticipantPolicy = z.infer<typeof voiceParticipantPolicySchema>;
+export declare function isVoiceContextEligible({ featureEnabled, scope, eligibleScope }: {
+    featureEnabled: boolean;
+    scope: VoiceScope;
+    eligibleScope: unknown;
+}): boolean;
+export declare const voiceOutboundDestinationSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    environmentId: z.ZodString;
+    destinationId: z.ZodString;
+    staffPrincipalId: z.ZodString;
+    phoneNumberE164: z.ZodString;
+    registeredByPrincipalId: z.ZodString;
+    verifiedAt: z.ZodISODateTime;
+    enabled: z.ZodBoolean;
+}, z.core.$strict>;
+export type VoiceOutboundDestination = z.infer<typeof voiceOutboundDestinationSchema>;
+export declare const voiceEnvironmentBindingsSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    environmentId: z.ZodString;
+    runtimeAccountId: z.ZodString;
+    syntheticNamespaceRef: z.ZodString;
+    elevenLabsWorkspaceId: z.ZodString;
+    elevenLabsCredentialRef: z.ZodString;
+    twilioSubaccountSid: z.ZodString;
+    twilioCredentialRef: z.ZodString;
+    twilioRecordingEnabled: z.ZodLiteral<false>;
+}, z.core.$strict>;
+export type VoiceEnvironmentBindings = z.infer<typeof voiceEnvironmentBindingsSchema>;

package/dist/voice-access.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { voiceIdSchema, voiceRevisionSchema, voiceScopeSchema, voiceTimestampSchema } from './voice-common.js';
+const principalIdsSchema = z.array(voiceIdSchema).max(200)
+    .refine((ids) => new Set(ids).size === ids.length, 'Duplicate principal ID');
+export const voiceParticipantPolicySchema = voiceScopeSchema.extend({
+    revision: voiceRevisionSchema,
+    participantPrincipalIds: principalIdsSchema,
+    operatorPrincipalIds: principalIdsSchema,
+    updatedByPrincipalId: voiceIdSchema,
+    updatedAt: voiceTimestampSchema,
+}).refine((policy) => policy.operatorPrincipalIds.every((id) => policy.participantPrincipalIds.includes(id)), { path: ['operatorPrincipalIds'], message: 'Operators must also be explicit participants' });
+export function isVoiceContextEligible({ featureEnabled, scope, eligibleScope }) {
+    if (!featureEnabled)
+        return false;
+    const parsed = voiceScopeSchema.safeParse(eligibleScope);
+    return parsed.success && parsed.data.tenantId === scope.tenantId && parsed.data.environmentId === scope.environmentId;
+}
+export const voiceOutboundDestinationSchema = voiceScopeSchema.extend({
+    destinationId: voiceIdSchema,
+    staffPrincipalId: voiceIdSchema,
+    phoneNumberE164: z.string().regex(/^\+[1-9]\d{1,14}$/),
+    registeredByPrincipalId: voiceIdSchema,
+    verifiedAt: voiceTimestampSchema,
+    enabled: z.boolean(),
+});
+export const voiceEnvironmentBindingsSchema = voiceScopeSchema.extend({
+    runtimeAccountId: voiceIdSchema,
+    syntheticNamespaceRef: voiceIdSchema,
+    elevenLabsWorkspaceId: voiceIdSchema,
+    elevenLabsCredentialRef: voiceIdSchema,
+    twilioSubaccountSid: voiceIdSchema,
+    twilioCredentialRef: voiceIdSchema,
+    twilioRecordingEnabled: z.literal(false),
+});

package/dist/voice-actions-contracts.d.ts

@@ -0,0 +1,423 @@
+import { z } from 'zod';
+export declare const voiceActionAuthoritySubjectSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"verified_resource">;
+    resource: z.ZodObject<{
+        kind: z.ZodString;
+        id: z.ZodString;
+    }, z.core.$strict>;
+    verificationId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"unverified">;
+}, z.core.$strict>], "kind">;
+export type VoiceActionAuthoritySubject = z.infer<typeof voiceActionAuthoritySubjectSchema>;
+export declare const voiceActionIntentBindingSchema: z.ZodObject<{
+    intentId: z.ZodString;
+    subject: z.ZodObject<{
+        tenantId: z.ZodString;
+        environmentId: z.ZodString;
+        agentId: z.ZodString;
+        sessionId: z.ZodString;
+        releaseId: z.ZodString;
+    }, z.core.$strict>;
+    actionAlias: z.ZodString;
+    authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"verified_resource">;
+        resource: z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strict>;
+        verificationId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"unverified">;
+    }, z.core.$strict>], "kind">;
+    argumentDigest: z.ZodString;
+}, z.core.$strict>;
+export type VoiceActionIntentBinding = z.infer<typeof voiceActionIntentBindingSchema>;
+export declare const voicePrepareActionRequestSchema: z.ZodObject<{
+    binding: z.ZodObject<{
+        intentId: z.ZodString;
+        subject: z.ZodObject<{
+            tenantId: z.ZodString;
+            environmentId: z.ZodString;
+            agentId: z.ZodString;
+            sessionId: z.ZodString;
+            releaseId: z.ZodString;
+        }, z.core.$strict>;
+        actionAlias: z.ZodString;
+        authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"verified_resource">;
+            resource: z.ZodObject<{
+                kind: z.ZodString;
+                id: z.ZodString;
+            }, z.core.$strict>;
+            verificationId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"unverified">;
+        }, z.core.$strict>], "kind">;
+        argumentDigest: z.ZodString;
+    }, z.core.$strict>;
+    confirmationSummary: z.ZodString;
+    preparedAt: z.ZodISODateTime;
+    expiresAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type VoicePrepareActionRequest = z.infer<typeof voicePrepareActionRequestSchema>;
+export declare const voiceConfirmActionRequestSchema: z.ZodObject<{
+    binding: z.ZodObject<{
+        intentId: z.ZodString;
+        subject: z.ZodObject<{
+            tenantId: z.ZodString;
+            environmentId: z.ZodString;
+            agentId: z.ZodString;
+            sessionId: z.ZodString;
+            releaseId: z.ZodString;
+        }, z.core.$strict>;
+        actionAlias: z.ZodString;
+        authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"verified_resource">;
+            resource: z.ZodObject<{
+                kind: z.ZodString;
+                id: z.ZodString;
+            }, z.core.$strict>;
+            verificationId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"unverified">;
+        }, z.core.$strict>], "kind">;
+        argumentDigest: z.ZodString;
+    }, z.core.$strict>;
+    requestedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type VoiceConfirmActionRequest = z.infer<typeof voiceConfirmActionRequestSchema>;
+export declare const voiceCancelActionRequestSchema: z.ZodObject<{
+    binding: z.ZodObject<{
+        intentId: z.ZodString;
+        subject: z.ZodObject<{
+            tenantId: z.ZodString;
+            environmentId: z.ZodString;
+            agentId: z.ZodString;
+            sessionId: z.ZodString;
+            releaseId: z.ZodString;
+        }, z.core.$strict>;
+        actionAlias: z.ZodString;
+        authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"verified_resource">;
+            resource: z.ZodObject<{
+                kind: z.ZodString;
+                id: z.ZodString;
+            }, z.core.$strict>;
+            verificationId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"unverified">;
+        }, z.core.$strict>], "kind">;
+        argumentDigest: z.ZodString;
+    }, z.core.$strict>;
+    requestedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type VoiceCancelActionRequest = z.infer<typeof voiceCancelActionRequestSchema>;
+export declare const voicePreparedActionIntentSchema: z.ZodObject<{
+    intentId: z.ZodString;
+    subject: z.ZodObject<{
+        tenantId: z.ZodString;
+        environmentId: z.ZodString;
+        agentId: z.ZodString;
+        sessionId: z.ZodString;
+        releaseId: z.ZodString;
+    }, z.core.$strict>;
+    actionAlias: z.ZodString;
+    authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"verified_resource">;
+        resource: z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strict>;
+        verificationId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"unverified">;
+    }, z.core.$strict>], "kind">;
+    argumentDigest: z.ZodString;
+    state: z.ZodLiteral<"prepared">;
+    confirmationSummary: z.ZodString;
+    preparedAt: z.ZodISODateTime;
+    expiresAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type VoicePreparedActionIntent = z.infer<typeof voicePreparedActionIntentSchema>;
+export declare const voiceUncertainActionIntentSchema: z.ZodObject<{
+    intentId: z.ZodString;
+    subject: z.ZodObject<{
+        tenantId: z.ZodString;
+        environmentId: z.ZodString;
+        agentId: z.ZodString;
+        sessionId: z.ZodString;
+        releaseId: z.ZodString;
+    }, z.core.$strict>;
+    actionAlias: z.ZodString;
+    authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"verified_resource">;
+        resource: z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strict>;
+        verificationId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"unverified">;
+    }, z.core.$strict>], "kind">;
+    argumentDigest: z.ZodString;
+    state: z.ZodLiteral<"uncertain">;
+    confirmationSummary: z.ZodString;
+    preparedAt: z.ZodISODateTime;
+    expiresAt: z.ZodISODateTime;
+    dispatchAttemptId: z.ZodString;
+    uncertainAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type VoiceUncertainActionIntent = z.infer<typeof voiceUncertainActionIntentSchema>;
+export declare const voiceCommittedActionReceiptSchema: z.ZodObject<{
+    intentId: z.ZodString;
+    subject: z.ZodObject<{
+        tenantId: z.ZodString;
+        environmentId: z.ZodString;
+        agentId: z.ZodString;
+        sessionId: z.ZodString;
+        releaseId: z.ZodString;
+    }, z.core.$strict>;
+    actionAlias: z.ZodString;
+    authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"verified_resource">;
+        resource: z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strict>;
+        verificationId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"unverified">;
+    }, z.core.$strict>], "kind">;
+    argumentDigest: z.ZodString;
+    state: z.ZodLiteral<"committed">;
+    receiptId: z.ZodString;
+    resultDigest: z.ZodString;
+    resultStatus: z.ZodString;
+    committedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type VoiceCommittedActionReceipt = z.infer<typeof voiceCommittedActionReceiptSchema>;
+export declare const voiceCancelledActionReceiptSchema: z.ZodObject<{
+    intentId: z.ZodString;
+    subject: z.ZodObject<{
+        tenantId: z.ZodString;
+        environmentId: z.ZodString;
+        agentId: z.ZodString;
+        sessionId: z.ZodString;
+        releaseId: z.ZodString;
+    }, z.core.$strict>;
+    actionAlias: z.ZodString;
+    authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"verified_resource">;
+        resource: z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strict>;
+        verificationId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"unverified">;
+    }, z.core.$strict>], "kind">;
+    argumentDigest: z.ZodString;
+    state: z.ZodLiteral<"cancelled">;
+    cancellationReceiptId: z.ZodString;
+    cancellationResolution: z.ZodEnum<{
+        local_before_dispatch: "local_before_dispatch";
+        confirmed_not_committed: "confirmed_not_committed";
+    }>;
+    cancelledAt: z.ZodISODateTime;
+}, z.core.$strict>;
+export type VoiceCancelledActionReceipt = z.infer<typeof voiceCancelledActionReceiptSchema>;
+export declare const voiceActionIntentStateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    intentId: z.ZodString;
+    subject: z.ZodObject<{
+        tenantId: z.ZodString;
+        environmentId: z.ZodString;
+        agentId: z.ZodString;
+        sessionId: z.ZodString;
+        releaseId: z.ZodString;
+    }, z.core.$strict>;
+    actionAlias: z.ZodString;
+    authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"verified_resource">;
+        resource: z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strict>;
+        verificationId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"unverified">;
+    }, z.core.$strict>], "kind">;
+    argumentDigest: z.ZodString;
+    state: z.ZodLiteral<"prepared">;
+    confirmationSummary: z.ZodString;
+    preparedAt: z.ZodISODateTime;
+    expiresAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    intentId: z.ZodString;
+    subject: z.ZodObject<{
+        tenantId: z.ZodString;
+        environmentId: z.ZodString;
+        agentId: z.ZodString;
+        sessionId: z.ZodString;
+        releaseId: z.ZodString;
+    }, z.core.$strict>;
+    actionAlias: z.ZodString;
+    authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"verified_resource">;
+        resource: z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strict>;
+        verificationId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"unverified">;
+    }, z.core.$strict>], "kind">;
+    argumentDigest: z.ZodString;
+    state: z.ZodLiteral<"uncertain">;
+    confirmationSummary: z.ZodString;
+    preparedAt: z.ZodISODateTime;
+    expiresAt: z.ZodISODateTime;
+    dispatchAttemptId: z.ZodString;
+    uncertainAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    intentId: z.ZodString;
+    subject: z.ZodObject<{
+        tenantId: z.ZodString;
+        environmentId: z.ZodString;
+        agentId: z.ZodString;
+        sessionId: z.ZodString;
+        releaseId: z.ZodString;
+    }, z.core.$strict>;
+    actionAlias: z.ZodString;
+    authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"verified_resource">;
+        resource: z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strict>;
+        verificationId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"unverified">;
+    }, z.core.$strict>], "kind">;
+    argumentDigest: z.ZodString;
+    state: z.ZodLiteral<"committed">;
+    receiptId: z.ZodString;
+    resultDigest: z.ZodString;
+    resultStatus: z.ZodString;
+    committedAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    intentId: z.ZodString;
+    subject: z.ZodObject<{
+        tenantId: z.ZodString;
+        environmentId: z.ZodString;
+        agentId: z.ZodString;
+        sessionId: z.ZodString;
+        releaseId: z.ZodString;
+    }, z.core.$strict>;
+    actionAlias: z.ZodString;
+    authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"verified_resource">;
+        resource: z.ZodObject<{
+            kind: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strict>;
+        verificationId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"unverified">;
+    }, z.core.$strict>], "kind">;
+    argumentDigest: z.ZodString;
+    state: z.ZodLiteral<"cancelled">;
+    cancellationReceiptId: z.ZodString;
+    cancellationResolution: z.ZodEnum<{
+        local_before_dispatch: "local_before_dispatch";
+        confirmed_not_committed: "confirmed_not_committed";
+    }>;
+    cancelledAt: z.ZodISODateTime;
+}, z.core.$strict>], "state">;
+export type VoiceActionIntentState = z.infer<typeof voiceActionIntentStateSchema>;
+export declare const voiceActionIntentTransitionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    dispatchAttemptId: z.ZodString;
+    binding: z.ZodObject<{
+        intentId: z.ZodString;
+        subject: z.ZodObject<{
+            tenantId: z.ZodString;
+            environmentId: z.ZodString;
+            agentId: z.ZodString;
+            sessionId: z.ZodString;
+            releaseId: z.ZodString;
+        }, z.core.$strict>;
+        actionAlias: z.ZodString;
+        authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"verified_resource">;
+            resource: z.ZodObject<{
+                kind: z.ZodString;
+                id: z.ZodString;
+            }, z.core.$strict>;
+            verificationId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"unverified">;
+        }, z.core.$strict>], "kind">;
+        argumentDigest: z.ZodString;
+    }, z.core.$strict>;
+    occurredAt: z.ZodISODateTime;
+    kind: z.ZodLiteral<"mark_uncertain">;
+}, z.core.$strict>, z.ZodObject<{
+    receiptId: z.ZodString;
+    resultDigest: z.ZodString;
+    resultStatus: z.ZodString;
+    binding: z.ZodObject<{
+        intentId: z.ZodString;
+        subject: z.ZodObject<{
+            tenantId: z.ZodString;
+            environmentId: z.ZodString;
+            agentId: z.ZodString;
+            sessionId: z.ZodString;
+            releaseId: z.ZodString;
+        }, z.core.$strict>;
+        actionAlias: z.ZodString;
+        authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"verified_resource">;
+            resource: z.ZodObject<{
+                kind: z.ZodString;
+                id: z.ZodString;
+            }, z.core.$strict>;
+            verificationId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"unverified">;
+        }, z.core.$strict>], "kind">;
+        argumentDigest: z.ZodString;
+    }, z.core.$strict>;
+    occurredAt: z.ZodISODateTime;
+    kind: z.ZodLiteral<"commit">;
+}, z.core.$strict>, z.ZodObject<{
+    cancellationReceiptId: z.ZodString;
+    resolution: z.ZodEnum<{
+        local_before_dispatch: "local_before_dispatch";
+        confirmed_not_committed: "confirmed_not_committed";
+    }>;
+    binding: z.ZodObject<{
+        intentId: z.ZodString;
+        subject: z.ZodObject<{
+            tenantId: z.ZodString;
+            environmentId: z.ZodString;
+            agentId: z.ZodString;
+            sessionId: z.ZodString;
+            releaseId: z.ZodString;
+        }, z.core.$strict>;
+        actionAlias: z.ZodString;
+        authoritySubject: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"verified_resource">;
+            resource: z.ZodObject<{
+                kind: z.ZodString;
+                id: z.ZodString;
+            }, z.core.$strict>;
+            verificationId: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"unverified">;
+        }, z.core.$strict>], "kind">;
+        argumentDigest: z.ZodString;
+    }, z.core.$strict>;
+    occurredAt: z.ZodISODateTime;
+    kind: z.ZodLiteral<"cancel">;
+}, z.core.$strict>], "kind">;
+export type VoiceActionIntentTransition = z.infer<typeof voiceActionIntentTransitionSchema>;

package/dist/voice-actions-contracts.js

@@ -0,0 +1,95 @@
+import { z } from 'zod';
+import { voiceHashSchema, voiceIdSchema, voiceLocalKeySchema, voiceTimestampSchema, } from './voice-common.js';
+import { voiceCallSubjectSchema, voiceResourceReferenceSchema } from './voice-authority-contracts.js';
+export const voiceActionAuthoritySubjectSchema = z.discriminatedUnion('kind', [
+    z.strictObject({
+        kind: z.literal('verified_resource'),
+        resource: voiceResourceReferenceSchema,
+        verificationId: voiceIdSchema,
+    }),
+    z.strictObject({ kind: z.literal('unverified') }),
+]);
+export const voiceActionIntentBindingSchema = z.strictObject({
+    intentId: voiceIdSchema,
+    subject: voiceCallSubjectSchema,
+    actionAlias: voiceLocalKeySchema,
+    authoritySubject: voiceActionAuthoritySubjectSchema,
+    argumentDigest: voiceHashSchema,
+});
+export const voicePrepareActionRequestSchema = z
+    .strictObject({
+    binding: voiceActionIntentBindingSchema,
+    confirmationSummary: z.string().trim().min(1).max(2_000),
+    preparedAt: voiceTimestampSchema,
+    expiresAt: voiceTimestampSchema,
+})
+    .superRefine((request, context) => {
+    if (Date.parse(request.expiresAt) <= Date.parse(request.preparedAt)) {
+        context.addIssue({
+            code: 'custom', path: ['expiresAt'],
+            message: 'action intent expiry must be after preparation',
+        });
+    }
+});
+export const voiceConfirmActionRequestSchema = z.strictObject({
+    binding: voiceActionIntentBindingSchema,
+    requestedAt: voiceTimestampSchema,
+});
+export const voiceCancelActionRequestSchema = z.strictObject({
+    binding: voiceActionIntentBindingSchema,
+    requestedAt: voiceTimestampSchema,
+});
+export const voicePreparedActionIntentSchema = voiceActionIntentBindingSchema.extend({
+    state: z.literal('prepared'),
+    confirmationSummary: z.string().trim().min(1).max(2_000),
+    preparedAt: voiceTimestampSchema,
+    expiresAt: voiceTimestampSchema,
+});
+export const voiceUncertainActionIntentSchema = voiceActionIntentBindingSchema.extend({
+    state: z.literal('uncertain'),
+    confirmationSummary: z.string().trim().min(1).max(2_000),
+    preparedAt: voiceTimestampSchema,
+    expiresAt: voiceTimestampSchema,
+    dispatchAttemptId: voiceIdSchema,
+    uncertainAt: voiceTimestampSchema,
+});
+export const voiceCommittedActionReceiptSchema = voiceActionIntentBindingSchema.extend({
+    state: z.literal('committed'),
+    receiptId: voiceIdSchema,
+    resultDigest: voiceHashSchema,
+    resultStatus: voiceIdSchema,
+    committedAt: voiceTimestampSchema,
+});
+export const voiceCancelledActionReceiptSchema = voiceActionIntentBindingSchema.extend({
+    state: z.literal('cancelled'),
+    cancellationReceiptId: voiceIdSchema,
+    cancellationResolution: z.enum(['local_before_dispatch', 'confirmed_not_committed']),
+    cancelledAt: voiceTimestampSchema,
+});
+export const voiceActionIntentStateSchema = z.discriminatedUnion('state', [
+    voicePreparedActionIntentSchema,
+    voiceUncertainActionIntentSchema,
+    voiceCommittedActionReceiptSchema,
+    voiceCancelledActionReceiptSchema,
+]);
+const transitionBase = {
+    binding: voiceActionIntentBindingSchema,
+    occurredAt: voiceTimestampSchema,
+};
+export const voiceActionIntentTransitionSchema = z.discriminatedUnion('kind', [
+    z.strictObject({
+        kind: z.literal('mark_uncertain'), ...transitionBase,
+        dispatchAttemptId: voiceIdSchema,
+    }),
+    z.strictObject({
+        kind: z.literal('commit'), ...transitionBase,
+        receiptId: voiceIdSchema,
+        resultDigest: voiceHashSchema,
+        resultStatus: voiceIdSchema,
+    }),
+    z.strictObject({
+        kind: z.literal('cancel'), ...transitionBase,
+        cancellationReceiptId: voiceIdSchema,
+        resolution: z.enum(['local_before_dispatch', 'confirmed_not_committed']),
+    }),
+]);