oui-spec 0.8.0 → 0.10.0

package/dist/react/index.d.cts

@@ -1,8 +1,8 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { e as OUIActionResult } from '../types-D4czecOw.cjs';
-import { f as SurfaceRuntime, e as SurfaceForm, D as DefinedSurface } from '../surface-runtime-bXSSONF4.cjs';
-import '../websocket-EzQq1mxO.cjs';
+import { e as OUIActionResult } from '../types-DLOa7CWj.cjs';
+import { f as SurfaceRuntime, e as SurfaceForm, D as DefinedSurface } from '../surface-runtime-DCPEz_JF.cjs';
+import '../websocket-CoSpb5nB.cjs';
 
 interface SurfaceRuntimeProviderProps {
     /** A runtime in either form (§7.3.8). */

package/dist/react/index.d.ts

@@ -1,8 +1,8 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
-import { e as OUIActionResult } from '../types-D4czecOw.js';
-import { f as SurfaceRuntime, e as SurfaceForm, D as DefinedSurface } from '../surface-runtime-BsRS0EV1.js';
-import '../websocket-BcWDNt_V.js';
+import { e as OUIActionResult } from '../types-DLOa7CWj.js';
+import { f as SurfaceRuntime, e as SurfaceForm, D as DefinedSurface } from '../surface-runtime-B6NED8eV.js';
+import '../websocket-Bf7xMzs1.js';
 
 interface SurfaceRuntimeProviderProps {
     /** A runtime in either form (§7.3.8). */

package/dist/spec/index.cjs

@@ -1,140 +1,140 @@
 'use strict';
 
-var chunk63T6SSPP_cjs = require('../chunk-63T6SSPP.cjs');
+var chunkOJ6Y2WWS_cjs = require('../chunk-OJ6Y2WWS.cjs');
 
 
 
 Object.defineProperty(exports, "ARGS_HASH_PATTERN", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.ARGS_HASH_PATTERN; }
+  get: function () { return chunkOJ6Y2WWS_cjs.ARGS_HASH_PATTERN; }
 });
 Object.defineProperty(exports, "DEFINITION_HASH_HEX", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.DEFINITION_HASH_HEX; }
+  get: function () { return chunkOJ6Y2WWS_cjs.DEFINITION_HASH_HEX; }
 });
 Object.defineProperty(exports, "FIT_LIST_STEPS", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.FIT_LIST_STEPS; }
+  get: function () { return chunkOJ6Y2WWS_cjs.FIT_LIST_STEPS; }
 });
 Object.defineProperty(exports, "FIT_TEXT_CHARS", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.FIT_TEXT_CHARS; }
+  get: function () { return chunkOJ6Y2WWS_cjs.FIT_TEXT_CHARS; }
 });
 Object.defineProperty(exports, "INDEX_DESCRIPTION_CHARS", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.INDEX_DESCRIPTION_CHARS; }
+  get: function () { return chunkOJ6Y2WWS_cjs.INDEX_DESCRIPTION_CHARS; }
 });
 Object.defineProperty(exports, "INDEX_INPUT_CHARS", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.INDEX_INPUT_CHARS; }
+  get: function () { return chunkOJ6Y2WWS_cjs.INDEX_INPUT_CHARS; }
 });
 Object.defineProperty(exports, "INDEX_INPUT_PROPERTIES", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.INDEX_INPUT_PROPERTIES; }
+  get: function () { return chunkOJ6Y2WWS_cjs.INDEX_INPUT_PROPERTIES; }
 });
 Object.defineProperty(exports, "OUI_DESCRIBE_ACTION", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.OUI_DESCRIBE_ACTION; }
+  get: function () { return chunkOJ6Y2WWS_cjs.OUI_DESCRIBE_ACTION; }
 });
 Object.defineProperty(exports, "OUI_EFFECT_ACCESS", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.OUI_EFFECT_ACCESS; }
+  get: function () { return chunkOJ6Y2WWS_cjs.OUI_EFFECT_ACCESS; }
 });
 Object.defineProperty(exports, "OUI_EFFECT_KINDS", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.OUI_EFFECT_KINDS; }
+  get: function () { return chunkOJ6Y2WWS_cjs.OUI_EFFECT_KINDS; }
 });
 Object.defineProperty(exports, "OUI_PROTOCOL_EVENTS", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.OUI_PROTOCOL_EVENTS; }
+  get: function () { return chunkOJ6Y2WWS_cjs.OUI_PROTOCOL_EVENTS; }
 });
 Object.defineProperty(exports, "OUI_READ_ACTION", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.OUI_READ_ACTION; }
+  get: function () { return chunkOJ6Y2WWS_cjs.OUI_READ_ACTION; }
 });
 Object.defineProperty(exports, "OUI_RUNTIME_SURFACE", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.OUI_RUNTIME_SURFACE; }
+  get: function () { return chunkOJ6Y2WWS_cjs.OUI_RUNTIME_SURFACE; }
 });
 Object.defineProperty(exports, "argsHash", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.argsHash; }
+  get: function () { return chunkOJ6Y2WWS_cjs.argsHash; }
 });
 Object.defineProperty(exports, "atPointer", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.atPointer; }
+  get: function () { return chunkOJ6Y2WWS_cjs.atPointer; }
 });
 Object.defineProperty(exports, "canonicalJson", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.canonicalJson; }
+  get: function () { return chunkOJ6Y2WWS_cjs.canonicalJson; }
 });
 Object.defineProperty(exports, "constantOf", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.constantOf; }
+  get: function () { return chunkOJ6Y2WWS_cjs.constantOf; }
 });
 Object.defineProperty(exports, "definitionHash", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.definitionHash; }
+  get: function () { return chunkOJ6Y2WWS_cjs.definitionHash; }
 });
 Object.defineProperty(exports, "discriminatorOf", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.discriminatorOf; }
+  get: function () { return chunkOJ6Y2WWS_cjs.discriminatorOf; }
 });
 Object.defineProperty(exports, "effectAccess", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.effectAccess; }
+  get: function () { return chunkOJ6Y2WWS_cjs.effectAccess; }
 });
 Object.defineProperty(exports, "firstSentence", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.firstSentence; }
+  get: function () { return chunkOJ6Y2WWS_cjs.firstSentence; }
 });
 Object.defineProperty(exports, "fitObservations", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.fitObservations; }
+  get: function () { return chunkOJ6Y2WWS_cjs.fitObservations; }
 });
 Object.defineProperty(exports, "indexEntry", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.indexEntry; }
+  get: function () { return chunkOJ6Y2WWS_cjs.indexEntry; }
 });
 Object.defineProperty(exports, "jsonBytes", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.jsonBytes; }
+  get: function () { return chunkOJ6Y2WWS_cjs.jsonBytes; }
 });
 Object.defineProperty(exports, "pointerStep", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.pointerStep; }
+  get: function () { return chunkOJ6Y2WWS_cjs.pointerStep; }
 });
 Object.defineProperty(exports, "pointerSteps", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.pointerSteps; }
+  get: function () { return chunkOJ6Y2WWS_cjs.pointerSteps; }
 });
 Object.defineProperty(exports, "requiresApproval", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.requiresApproval; }
+  get: function () { return chunkOJ6Y2WWS_cjs.requiresApproval; }
 });
 Object.defineProperty(exports, "sortedJson", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.sortedJson; }
+  get: function () { return chunkOJ6Y2WWS_cjs.sortedJson; }
 });
 Object.defineProperty(exports, "summarizeInput", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.summarizeInput; }
+  get: function () { return chunkOJ6Y2WWS_cjs.summarizeInput; }
 });
 Object.defineProperty(exports, "surfaceIndex", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.surfaceIndex; }
+  get: function () { return chunkOJ6Y2WWS_cjs.surfaceIndex; }
 });
 Object.defineProperty(exports, "surfacesHash", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.surfacesHash; }
+  get: function () { return chunkOJ6Y2WWS_cjs.surfacesHash; }
 });
 Object.defineProperty(exports, "utf8Length", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.utf8Length; }
+  get: function () { return chunkOJ6Y2WWS_cjs.utf8Length; }
 });
 Object.defineProperty(exports, "withoutTitleLeadIn", {
   enumerable: true,
-  get: function () { return chunk63T6SSPP_cjs.withoutTitleLeadIn; }
+  get: function () { return chunkOJ6Y2WWS_cjs.withoutTitleLeadIn; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/spec/index.d.cts

@@ -1,5 +1,5 @@
-import { r as OUISurface, t as OUISurfaceIndex, J as JSONSchema, O as OUIAction, b as OUIActionIndexEntry, n as OUIObservationSnapshot, k as OUIFitCut } from '../types-D4czecOw.cjs';
-export { A as ARGS_HASH_PATTERN, a as OUIActionApproval, c as OUIActionPolling, d as OUIActionRequest, e as OUIActionResult, f as OUIActivation, g as OUIApprovalGrant, h as OUIClientSnapshot, i as OUIEffectKind, j as OUIFit, l as OUIIndexSnapshot, m as OUIObservation, o as OUIObservationUpdate, p as OUIProtocolEvent, q as OUIResultDelivery, s as OUISurfaceDeregistration, u as OUISurfaceRegistration, v as OUISurfaceSnapshot, w as OUI_EFFECT_ACCESS, x as OUI_EFFECT_KINDS, y as OUI_PROTOCOL_EVENTS, z as argsHash, B as canonicalJson, C as effectAccess, D as requiresApproval } from '../types-D4czecOw.cjs';
+import { r as OUISurface, t as OUISurfaceIndex, J as JSONSchema, O as OUIAction, b as OUIActionIndexEntry, n as OUIObservationSnapshot, k as OUIFitCut } from '../types-DLOa7CWj.cjs';
+export { A as ARGS_HASH_PATTERN, a as OUIActionApproval, c as OUIActionPolling, d as OUIActionRequest, e as OUIActionResult, f as OUIActivation, g as OUIApprovalGrant, h as OUIClientSnapshot, i as OUIEffectKind, j as OUIFit, l as OUIIndexSnapshot, m as OUIObservation, o as OUIObservationUpdate, p as OUIProtocolEvent, q as OUIResultDelivery, s as OUISurfaceDeregistration, u as OUISurfaceRegistration, v as OUISurfaceSnapshot, w as OUI_EFFECT_ACCESS, x as OUI_EFFECT_KINDS, y as OUI_PROTOCOL_EVENTS, z as argsHash, B as canonicalJson, C as effectAccess, D as requiresApproval } from '../types-DLOa7CWj.cjs';
 
 /**
  * The identity of a set of surfaces, for an answer that need not repeat them

package/dist/spec/index.d.ts

@@ -1,5 +1,5 @@
-import { r as OUISurface, t as OUISurfaceIndex, J as JSONSchema, O as OUIAction, b as OUIActionIndexEntry, n as OUIObservationSnapshot, k as OUIFitCut } from '../types-D4czecOw.js';
-export { A as ARGS_HASH_PATTERN, a as OUIActionApproval, c as OUIActionPolling, d as OUIActionRequest, e as OUIActionResult, f as OUIActivation, g as OUIApprovalGrant, h as OUIClientSnapshot, i as OUIEffectKind, j as OUIFit, l as OUIIndexSnapshot, m as OUIObservation, o as OUIObservationUpdate, p as OUIProtocolEvent, q as OUIResultDelivery, s as OUISurfaceDeregistration, u as OUISurfaceRegistration, v as OUISurfaceSnapshot, w as OUI_EFFECT_ACCESS, x as OUI_EFFECT_KINDS, y as OUI_PROTOCOL_EVENTS, z as argsHash, B as canonicalJson, C as effectAccess, D as requiresApproval } from '../types-D4czecOw.js';
+import { r as OUISurface, t as OUISurfaceIndex, J as JSONSchema, O as OUIAction, b as OUIActionIndexEntry, n as OUIObservationSnapshot, k as OUIFitCut } from '../types-DLOa7CWj.js';
+export { A as ARGS_HASH_PATTERN, a as OUIActionApproval, c as OUIActionPolling, d as OUIActionRequest, e as OUIActionResult, f as OUIActivation, g as OUIApprovalGrant, h as OUIClientSnapshot, i as OUIEffectKind, j as OUIFit, l as OUIIndexSnapshot, m as OUIObservation, o as OUIObservationUpdate, p as OUIProtocolEvent, q as OUIResultDelivery, s as OUISurfaceDeregistration, u as OUISurfaceRegistration, v as OUISurfaceSnapshot, w as OUI_EFFECT_ACCESS, x as OUI_EFFECT_KINDS, y as OUI_PROTOCOL_EVENTS, z as argsHash, B as canonicalJson, C as effectAccess, D as requiresApproval } from '../types-DLOa7CWj.js';
 
 /**
  * The identity of a set of surfaces, for an answer that need not repeat them

package/dist/spec/index.js

@@ -1,3 +1,3 @@
-export { ARGS_HASH_PATTERN, DEFINITION_HASH_HEX, FIT_LIST_STEPS, FIT_TEXT_CHARS, INDEX_DESCRIPTION_CHARS, INDEX_INPUT_CHARS, INDEX_INPUT_PROPERTIES, OUI_DESCRIBE_ACTION, OUI_EFFECT_ACCESS, OUI_EFFECT_KINDS, OUI_PROTOCOL_EVENTS, OUI_READ_ACTION, OUI_RUNTIME_SURFACE, argsHash, atPointer, canonicalJson, constantOf, definitionHash, discriminatorOf, effectAccess, firstSentence, fitObservations, indexEntry, jsonBytes, pointerStep, pointerSteps, requiresApproval, sortedJson, summarizeInput, surfaceIndex, surfacesHash, utf8Length, withoutTitleLeadIn } from '../chunk-JRXQLNUL.js';
+export { ARGS_HASH_PATTERN, DEFINITION_HASH_HEX, FIT_LIST_STEPS, FIT_TEXT_CHARS, INDEX_DESCRIPTION_CHARS, INDEX_INPUT_CHARS, INDEX_INPUT_PROPERTIES, OUI_DESCRIBE_ACTION, OUI_EFFECT_ACCESS, OUI_EFFECT_KINDS, OUI_PROTOCOL_EVENTS, OUI_READ_ACTION, OUI_RUNTIME_SURFACE, argsHash, atPointer, canonicalJson, constantOf, definitionHash, discriminatorOf, effectAccess, firstSentence, fitObservations, indexEntry, jsonBytes, pointerStep, pointerSteps, requiresApproval, sortedJson, summarizeInput, surfaceIndex, surfacesHash, utf8Length, withoutTitleLeadIn } from '../chunk-JOWXACVF.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{surface-runtime-BsRS0EV1.d.ts → surface-runtime-B6NED8eV.d.ts}

@@ -1,5 +1,5 @@
-import { i as OUIEffectKind, J as JSONSchema, c as OUIActionPolling, f as OUIActivation, r as OUISurface, l as OUIIndexSnapshot, v as OUISurfaceSnapshot, d as OUIActionRequest, e as OUIActionResult, g as OUIApprovalGrant } from './types-D4czecOw.js';
-import { S as SocketLike, e as OUITransportConfig } from './websocket-BcWDNt_V.js';
+import { i as OUIEffectKind, J as JSONSchema, c as OUIActionPolling, f as OUIActivation, r as OUISurface, l as OUIIndexSnapshot, v as OUISurfaceSnapshot, d as OUIActionRequest, e as OUIActionResult, g as OUIApprovalGrant } from './types-DLOa7CWj.js';
+import { S as SocketLike, e as OUITransportConfig } from './websocket-Bf7xMzs1.js';
 
 /**
  * Nominal branding for values OUI must construct itself.
@@ -47,10 +47,18 @@ interface ActionPollingConfig<TContext = unknown> extends OUIActionPolling {
      * Called on each poll interval. Receives the dispatch result from the handler
      * plus the current context. Return { done: true, data } to stop polling,
      * or { done: false, data } to continue.
+     *
+     * Work that ended in failure returns { done: true, data, error }: the final
+     * result is then a failure (§7.3.3) carrying `error`, with `data` kept, so
+     * the agent never records failed work as a success.
      */
     resolve?: (dispatchResult: unknown, context: TContext) => Promise<{
         done: boolean;
         data: unknown;
+        error?: {
+            code: string;
+            message: string;
+        };
     }>;
 }
 /**
@@ -206,11 +214,13 @@ interface SurfaceRuntimeOptions {
     dedupeWindow?: number;
     /**
      * Decides whether a request that arrived on the socket may run at all. A
-     * refused request is neither run nor answered, and is logged.
+     * refused request is not run: its sender gets a receipt saying it was
+     * received and not accepted, and the refusal is logged.
      *
      * The server should be the only sender of action requests, but a client can
-     * also check that a request is one it expects: for example, only while its
-     * agent has a turn in progress. Requests passed to `execute` directly are
+     * also check that a request is one it expects: for example, only for the
+     * turn its agent is running now (the request's `turnId`), so a request sent
+     * late by a stopped turn does not run. Requests passed to `execute` directly are
      * not checked; they come from the application itself.
      */
     accept?: (request: OUIActionRequest) => boolean;

package/dist/{surface-runtime-bXSSONF4.d.cts → surface-runtime-DCPEz_JF.d.cts}

@@ -1,5 +1,5 @@
-import { i as OUIEffectKind, J as JSONSchema, c as OUIActionPolling, f as OUIActivation, r as OUISurface, l as OUIIndexSnapshot, v as OUISurfaceSnapshot, d as OUIActionRequest, e as OUIActionResult, g as OUIApprovalGrant } from './types-D4czecOw.cjs';
-import { S as SocketLike, e as OUITransportConfig } from './websocket-EzQq1mxO.cjs';
+import { i as OUIEffectKind, J as JSONSchema, c as OUIActionPolling, f as OUIActivation, r as OUISurface, l as OUIIndexSnapshot, v as OUISurfaceSnapshot, d as OUIActionRequest, e as OUIActionResult, g as OUIApprovalGrant } from './types-DLOa7CWj.cjs';
+import { S as SocketLike, e as OUITransportConfig } from './websocket-CoSpb5nB.cjs';
 
 /**
  * Nominal branding for values OUI must construct itself.
@@ -47,10 +47,18 @@ interface ActionPollingConfig<TContext = unknown> extends OUIActionPolling {
      * Called on each poll interval. Receives the dispatch result from the handler
      * plus the current context. Return { done: true, data } to stop polling,
      * or { done: false, data } to continue.
+     *
+     * Work that ended in failure returns { done: true, data, error }: the final
+     * result is then a failure (§7.3.3) carrying `error`, with `data` kept, so
+     * the agent never records failed work as a success.
      */
     resolve?: (dispatchResult: unknown, context: TContext) => Promise<{
         done: boolean;
         data: unknown;
+        error?: {
+            code: string;
+            message: string;
+        };
     }>;
 }
 /**
@@ -206,11 +214,13 @@ interface SurfaceRuntimeOptions {
     dedupeWindow?: number;
     /**
      * Decides whether a request that arrived on the socket may run at all. A
-     * refused request is neither run nor answered, and is logged.
+     * refused request is not run: its sender gets a receipt saying it was
+     * received and not accepted, and the refusal is logged.
      *
      * The server should be the only sender of action requests, but a client can
-     * also check that a request is one it expects: for example, only while its
-     * agent has a turn in progress. Requests passed to `execute` directly are
+     * also check that a request is one it expects: for example, only for the
+     * turn its agent is running now (the request's `turnId`), so a request sent
+     * late by a stopped turn does not run. Requests passed to `execute` directly are
      * not checked; they come from the application itself.
      */
     accept?: (request: OUIActionRequest) => boolean;

package/dist/transport/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkROGKEMLL_cjs = require('../chunk-ROGKEMLL.cjs');
-var chunk5UUJ3F7C_cjs = require('../chunk-5UUJ3F7C.cjs');
+var chunk2FFUDX2L_cjs = require('../chunk-2FFUDX2L.cjs');
 
 
 
@@ -11,7 +11,7 @@ Object.defineProperty(exports, "createDirectTransportPair", {
 });
 Object.defineProperty(exports, "createWebSocketTransport", {
   enumerable: true,
-  get: function () { return chunk5UUJ3F7C_cjs.createWebSocketTransport; }
+  get: function () { return chunk2FFUDX2L_cjs.createWebSocketTransport; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/transport/index.d.cts

@@ -1,6 +1,6 @@
-import { d as OUITransport } from '../websocket-EzQq1mxO.cjs';
-export { O as OUIAcknowledgment, a as OUIActionHandler, b as OUIObservationHandler, c as OUIResultHandler, e as OUITransportConfig, S as SocketLike, f as createWebSocketTransport } from '../websocket-EzQq1mxO.cjs';
-import '../types-D4czecOw.cjs';
+import { d as OUITransport } from '../websocket-CoSpb5nB.cjs';
+export { O as OUIAcknowledgment, a as OUIActionHandler, b as OUIObservationHandler, c as OUIResultHandler, e as OUITransportConfig, S as SocketLike, f as createWebSocketTransport } from '../websocket-CoSpb5nB.cjs';
+import '../types-DLOa7CWj.cjs';
 
 /**
  * Direct transport — for same-process communication.

package/dist/transport/index.d.ts

@@ -1,6 +1,6 @@
-import { d as OUITransport } from '../websocket-BcWDNt_V.js';
-export { O as OUIAcknowledgment, a as OUIActionHandler, b as OUIObservationHandler, c as OUIResultHandler, e as OUITransportConfig, S as SocketLike, f as createWebSocketTransport } from '../websocket-BcWDNt_V.js';
-import '../types-D4czecOw.js';
+import { d as OUITransport } from '../websocket-Bf7xMzs1.js';
+export { O as OUIAcknowledgment, a as OUIActionHandler, b as OUIObservationHandler, c as OUIResultHandler, e as OUITransportConfig, S as SocketLike, f as createWebSocketTransport } from '../websocket-Bf7xMzs1.js';
+import '../types-DLOa7CWj.js';
 
 /**
  * Direct transport — for same-process communication.

package/dist/transport/index.js

@@ -1,4 +1,4 @@
 export { createDirectTransportPair } from '../chunk-IIZ6HL2L.js';
-export { createWebSocketTransport } from '../chunk-R3SGP2UY.js';
+export { createWebSocketTransport } from '../chunk-NXDPC3KW.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{types-D4czecOw.d.ts → types-DLOa7CWj.d.cts}

@@ -311,6 +311,15 @@ interface OUIActionRequest {
     params: Record<string, unknown>;
     /** Timestamp of the request */
     timestamp: number;
+    /**
+     * The turn of the agent's work this request belongs to. A client that runs
+     * one turn at a time accepts a request only for its current turn (`accept`),
+     * so a request sent late by a turn the person has stopped or superseded does
+     * not run under their newer instruction. Optional: an agent runtime that
+     * does not know of turns sends none, and a client then applies whatever rule
+     * it had without it.
+     */
+    turnId?: string;
     /**
      * The user's approval this request runs on, for an action that needs one.
      * The surface runtime runs such an action only when this matches a grant

package/dist/{types-D4czecOw.d.cts → types-DLOa7CWj.d.ts}

@@ -311,6 +311,15 @@ interface OUIActionRequest {
     params: Record<string, unknown>;
     /** Timestamp of the request */
     timestamp: number;
+    /**
+     * The turn of the agent's work this request belongs to. A client that runs
+     * one turn at a time accepts a request only for its current turn (`accept`),
+     * so a request sent late by a turn the person has stopped or superseded does
+     * not run under their newer instruction. Optional: an agent runtime that
+     * does not know of turns sends none, and a client then applies whatever rule
+     * it had without it.
+     */
+    turnId?: string;
     /**
      * The user's approval this request runs on, for an action that needs one.
      * The surface runtime runs such an action only when this matches a grant

package/dist/{websocket-BcWDNt_V.d.ts → websocket-Bf7xMzs1.d.ts}

@@ -1,4 +1,4 @@
-import { d as OUIActionRequest, e as OUIActionResult, o as OUIObservationUpdate, r as OUISurface } from './types-D4czecOw.js';
+import { d as OUIActionRequest, e as OUIActionResult, o as OUIObservationUpdate, r as OUISurface } from './types-DLOa7CWj.js';
 
 /**
  * OUI Transport — the wire protocol between agent runtime and surfaces.

package/dist/{websocket-EzQq1mxO.d.cts → websocket-CoSpb5nB.d.cts}

@@ -1,4 +1,4 @@
-import { d as OUIActionRequest, e as OUIActionResult, o as OUIObservationUpdate, r as OUISurface } from './types-D4czecOw.cjs';
+import { d as OUIActionRequest, e as OUIActionResult, o as OUIObservationUpdate, r as OUISurface } from './types-DLOa7CWj.cjs';
 
 /**
  * OUI Transport — the wire protocol between agent runtime and surfaces.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oui-spec",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "OUI — The OpenUI Specification. A machine-readable contract for agent-controllable user interfaces.",
   "keywords": [
     "oui",

package/spec/OUI-SPEC-v0.1.md

@@ -608,6 +608,7 @@ When the agent invokes an action, the runtime sends an `action:request`:
 - `params` MUST conform to the action's declared `input` schema
 - The agent runtime SHOULD validate `params` before sending; the surface MUST validate upon receipt
 - `knownSurfaces` (OPTIONAL) is the `surfacesHash` of the client's surfaces that the agent runtime already holds, from the client's snapshot (§7.3.5) or an earlier result. A runtime that holds the client's surfaces SHOULD send it (§7.3.4).
+- `turnId` (OPTIONAL) names the turn of the agent's work the request belongs to. An agent runtime whose work is divided into turns that a person can stop SHOULD send it. A client MAY refuse a request whose `turnId` is not its current turn; a refused request is not run, and its receipt (§7.3.7) says it was received and not accepted. A client MUST NOT refuse a request only because it carries no `turnId`.
 
 #### 7.3.2 Action Result (Success)
 
@@ -655,6 +656,7 @@ When the agent invokes an action, the runtime sends an `action:request`:
 - If `success` is `false`, the `error` field MUST be present
 - If `success` is `true`, the `error` field MUST NOT be present
 - An async action's acknowledgment result MUST set `interim: true`; its final result MUST set `interim: false`
+- An async action whose work failed MUST send its final result as a failure (`success: false`, with `error`); it MAY keep the work's own report in `data`
 
 #### 7.3.4 The Client's State After an Action