@sequenceholdings/agent-spec 0.1.2 → 0.1.4

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']),
+    }),
+]);

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

@@ -0,0 +1,52 @@
+import { type VoiceActionIntentBinding, type VoiceActionIntentState, type VoiceActionIntentTransition, type VoiceCommittedActionReceipt, type VoicePrepareActionRequest, type VoicePreparedActionIntent } from './voice-actions-contracts.js';
+export type PrepareVoiceActionIntentResult = {
+    outcome: 'prepared';
+    state: VoicePreparedActionIntent;
+} | {
+    outcome: 'retry';
+    state: VoiceActionIntentState;
+} | {
+    outcome: 'conflict';
+    reason: 'intent_binding_conflict';
+};
+export declare function prepareVoiceActionIntent({ request, existing }: {
+    request: VoicePrepareActionRequest;
+    existing: VoiceActionIntentState | null;
+}): PrepareVoiceActionIntentResult;
+export type VoiceActionConfirmationDecision = {
+    decision: 'dispatch';
+} | {
+    decision: 'reconcile';
+    reason: 'uncertain_outcome';
+} | {
+    decision: 'return_receipt';
+    receipt: VoiceCommittedActionReceipt;
+} | {
+    decision: 'conflict';
+    reason: 'intent_binding_conflict';
+} | {
+    decision: 'denied';
+    reason: 'intent_cancelled' | 'intent_expired';
+};
+export declare function decideVoiceActionConfirmation({ state, binding, now }: {
+    state: VoiceActionIntentState;
+    binding: VoiceActionIntentBinding;
+    now: string;
+}): VoiceActionConfirmationDecision;
+export type TransitionVoiceActionIntentResult = {
+    outcome: 'transitioned';
+    state: VoiceActionIntentState;
+} | {
+    outcome: 'retry';
+    state: VoiceActionIntentState;
+} | {
+    outcome: 'conflict';
+    reason: 'intent_binding_conflict' | 'terminal_receipt_conflict';
+} | {
+    outcome: 'denied';
+    reason: 'intent_expired' | 'terminal_intent' | 'uncertain_requires_reconciliation';
+};
+export declare function transitionVoiceActionIntent({ state, transition }: {
+    state: VoiceActionIntentState;
+    transition: VoiceActionIntentTransition;
+}): TransitionVoiceActionIntentResult;