@lostgradient/weft 0.9.0 → 0.11.0

package/dist/server/json-rpc-dispatch.d.ts

@@ -5,8 +5,8 @@
  * body, resolves each request via `executeOperation`, and produces the
  * wire-level response shape.
  *
- * Track 8 design decision 13: batches dispatch SEQUENTIALLY in request
- * order. Response order matches request order by construction —
+ * The stable JSON-RPC operation-catalog contract mandates sequential dispatch
+ * in request order. Response order matches request order by construction —
  * notifications are dropped from the response array, so the returned
  * indices are the non-notification request indices.
  *

package/dist/server/json-rpc-parse.d.ts

@@ -3,7 +3,7 @@
  * parsed JSON) and returns a discriminated-union `ParseResult` that
  * describes what the transport should dispatch.
  *
- * Track 8 design decisions this parser enforces:
+ * The stable JSON-RPC operation-catalog contract enforces:
  *   - `params` MUST be absent or a JSON object. Array-form positional
  *     params are rejected with `InvalidRequest` (-32600). This matches
  *     OpenRPC's `paramStructure: "by-name"` contract and eliminates a

package/dist/server/json-rpc-protocol.d.ts

@@ -10,8 +10,8 @@
  *   - Runtime stdio session (`stdio-session.ts`, Phase 13)
  *
  * Reserved-spec error codes (-32700..-32603) keep their JSON-RPC 2.0
- * meanings. Weft domain codes live in the -32010..-32099 band per
- * Track 8 design decision 4.
+ * meanings. Weft domain codes live in the -32010..-32099 band; this stable
+ * error-code allocation preserves compatibility across JSON-RPC transports.
  */
 /** Literal `"2.0"` — the only `jsonrpc` version this runtime accepts. */
 export declare const JSON_RPC_VERSION: "2.0";

package/dist/server/json-rpc-websocket.d.ts

@@ -5,7 +5,7 @@
  * that binds the authenticated principal at upgrade time and reuses it
  * for every frame. The session:
  *   - Parses incoming frames as single JSON-RPC requests (batches over
- *     WS are rejected per Track 8 design decision 13).
+ *     WS are rejected per stable operation-catalog contract).
  *   - Dispatches `weft.workflows.subscribe` / `weft.workflows.unsubscribe`
  *     as first-class session primitives against the `WorkflowEventFeed`.
  *   - Delegates all other methods to the standard `dispatchJsonRpc`.

package/dist/server/operation-fault.d.ts

@@ -30,7 +30,9 @@
  * adapters never branch on `data === undefined`. This uniformity is what
  * lets the exhaustive switch in `extractFaultDataPayload` stay small.
  *
- * See Track 8 design decision 4.
+ * The stable fault model with transport-neutral code, message, and typed
+ * `data` payload forms the basis of cross-transport parity: every fault is
+ * serialized consistently across REST and JSON-RPC transports.
  */
 import type { FaultCode } from '../core/fault-code.ts';
 import type { WeftErrorCode } from '../core/weft-error.ts';

package/dist/server/operations/async-activity.js

@@ -41,7 +41,7 @@ export const completeAsyncActivityOperation = defineOperation({
   name: "weft.activities.complete",
   mcpExposable: !1,
   summary: "Complete a deferred activity by task token",
-  description: 'Resolve an out-of-band ("async") activity with a result, resuming its parked workflow as though the activity had returned that result inline. Requires the durable task token announced through the `activity:async-pending` event. Faults with NotFound when the token is unknown or already completed/failed (tokens are single-use), and InvalidParams when the result exceeds the payload size limit.',
+  description: 'Resolve an out-of-band ("async") activity with a result, resuming its parked workflow as though the activity had returned that result inline. Requires the durable task token announced through the `activity:async-pending` event. Faults with NotFound when the token is unknown or already completed/failed (tokens are single-use), and InvalidParams when the result exceeds the payload size limit. ' + "A success response is durable \u2014 the completion is persisted before the operation " + "returns, and a crash afterward cannot lose it. A failed call leaves the token completable, so treat storage-side faults as retryable.",
   destructive: !0,
   tags: ["Activities"],
   inputSchema: completeAsyncActivityInput,
@@ -63,7 +63,7 @@ export const completeAsyncActivityOperation = defineOperation({
   name: "weft.activities.fail",
   mcpExposable: !1,
   summary: "Fail a deferred activity by task token",
-  description: 'Fail an out-of-band ("async") activity, throwing the supplied error into its ' + "parked workflow at the deferred step \u2014 identical to an inline activity that threw, " + "so the workflow\u2019s own try/catch and retry policy apply unchanged. Requires the " + "durable task token from the `activity:async-pending` event. Faults with NotFound when the token is unknown or already completed/failed (tokens are single-use), and InvalidParams when the failure message exceeds the payload size limit.",
+  description: 'Fail an out-of-band ("async") activity, throwing the supplied error into its ' + "parked workflow at the deferred step \u2014 identical to an inline activity that threw, " + "so the workflow\u2019s own try/catch and retry policy apply unchanged. Requires the " + "durable task token from the `activity:async-pending` event. Faults with NotFound when the token is unknown or already completed/failed (tokens are single-use), and InvalidParams when the failure message exceeds the payload size limit. " + "A success response is durable \u2014 the failure outcome is persisted before the " + "operation returns, and a crash afterward cannot lose it. A failed call leaves the token completable, so treat storage-side faults as retryable.",
   destructive: !0,
   tags: ["Activities"],
   inputSchema: failAsyncActivityInput,

package/dist/server/principal.d.ts

@@ -9,12 +9,12 @@
  * Credential *validation* (signature verification, expiry, revocation, format
  * checks) is the transport edge's responsibility — these factories assume the
  * inputs they receive describe a credential that has already been accepted.
+ * This stable principal model ensures consistent authentication across all
+ * transport layers.
  *
  * The discriminator string for API keys is `'api-key'` (kebab-case) to match
  * the existing `AuthMethod` literal in `authentication.ts`. Keep them aligned;
  * the bridge from `AuthResult` to `Principal` relies on byte-identical strings.
- *
- * See Track 8 design decisions 3 and 10.
  */
 import { type AuthorizationScope } from './authorization-scope.ts';
 /**

package/dist/server/stdio-session.d.ts

@@ -2,10 +2,10 @@
  * Runtime JSON-RPC stdio session.
  *
  * `runStdioSession({ input, output, admission, registry, engine, feed, ... })`
- * drives the `weft rpc-stdio` CLI subcommand (Track 8 design decision
- * 19). It reads newline-delimited JSON frames from `input`, runs each
- * through the same `createJsonRpcWebSocketSession` session the WS
- * adapter uses, and writes responses to `output`.
+ * drives the `weft rpc-stdio` CLI subcommand. It implements the stable
+ * JSON-RPC stdio transport: reading newline-delimited JSON frames from
+ * `input`, running each through the JSON-RPC dispatcher, and writing
+ * responses to `output`.
  *
  * Admission is mandatory:
  *   - `{ kind: 'startup-token', token }` — the first frame must be a