@ixo/flow-work 0.6.0 → 0.7.0

package/dist/bounded.d.ts

@@ -0,0 +1,18 @@
+export * from './bounded-protocol.js';
+export * from './bounded-codec.js';
+export * from './bounded-contracts.js';
+export * from './bounded-definitions.js';
+export * from './durable-store.js';
+export * from './durable-input.js';
+export * from './durable-listener.js';
+export * from './gateway-client.js';
+export * from './execution-service.js';
+export * from './provider-journal.js';
+export * from './capability-adapter.js';
+export * from './work-authority.js';
+export * from './execution-rpc.js';
+export * from './external-catalog.js';
+export { buildDelegationValidator, type DelegationValidator } from './ucan.js';
+export { findCapability, type FlowWorkCapability, type FlowWorkInputApi, type FlowWorkInvocationContext, } from './capability.js';
+export { z } from 'zod';
+//# sourceMappingURL=bounded.d.ts.map

package/dist/bounded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded.d.ts","sourceRoot":"","sources":["../src/bounded.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,wBAAwB,EAAE,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EACL,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,GAC/B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/dist/bounded.js

@@ -0,0 +1,18 @@
+export * from './bounded-protocol.js';
+export * from './bounded-codec.js';
+export * from './bounded-contracts.js';
+export * from './bounded-definitions.js';
+export * from './durable-store.js';
+export * from './durable-input.js';
+export * from './durable-listener.js';
+export * from './gateway-client.js';
+export * from './execution-service.js';
+export * from './provider-journal.js';
+export * from './capability-adapter.js';
+export * from './work-authority.js';
+export * from './execution-rpc.js';
+export * from './external-catalog.js';
+export { buildDelegationValidator } from './ucan.js';
+export { findCapability, } from './capability.js';
+export { z } from 'zod';
+//# sourceMappingURL=bounded.js.map

package/dist/bounded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded.js","sourceRoot":"","sources":["../src/bounded.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,OAAO,EAAE,wBAAwB,EAA4B,MAAM,WAAW,CAAC;AAC/E,OAAO,EACL,cAAc,GAIf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC"}

package/dist/capability-adapter.d.ts

@@ -0,0 +1,6 @@
+import type { FlowWorkCapability, FlowWorkInvocationContext } from './capability.js';
+import type { DurableCapability } from './durable-listener.js';
+import type { BoundedJson, ExecutionResult } from './bounded-protocol.js';
+/** The domain adapter supplies an explicit readback handler; legacy handlers are never replayed implicitly. */
+export declare function adaptDurableCapability(capability: FlowWorkCapability, recover: (inputs: BoundedJson, context: FlowWorkInvocationContext) => Promise<ExecutionResult>, outcomes?: (output: BoundedJson) => BoundedJson): DurableCapability;
+//# sourceMappingURL=capability-adapter.d.ts.map

package/dist/capability-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-adapter.d.ts","sourceRoot":"","sources":["../src/capability-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG1E,+GAA+G;AAC/G,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,kBAAkB,EAC9B,OAAO,EAAE,CACP,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,eAAe,CAAC,EAC7B,QAAQ,GAAE,CAAC,MAAM,EAAE,WAAW,KAAK,WAAsB,GACxD,iBAAiB,CAwDnB"}

package/dist/capability-adapter.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { bounded, resultSchema } from './bounded-protocol.js';
+/** The domain adapter supplies an explicit readback handler; legacy handlers are never replayed implicitly. */
+export function adaptDurableCapability(capability, recover, outcomes = () => []) {
+    const contextFor = (ctx) => {
+        const b = ctx.binding;
+        return {
+            invocationId: b.invocationId,
+            operationId: b.admission.operationId,
+            managerDid: b.managerDid,
+            capability: b.capability,
+            actionType: b.actionType,
+            nodeId: b.admission.stepId,
+            resource: b.resource,
+            inputHash: b.admission.inputDigest,
+            attempt: b.attempt,
+            deadline: b.deadline,
+            contractCaveats: b.contractCaveats,
+            audience: b.helperDid,
+            delegation: ctx.delegation,
+            input: {
+                request: async (params) => {
+                    const { signal, ...request } = params;
+                    signal?.throwIfAborted();
+                    const configured = b.contractCaveats.inputResponders;
+                    const responders = z
+                        .array(z.string().min(1))
+                        .min(1)
+                        .max(32)
+                        .parse(configured);
+                    return ctx.input.request(ctx.work, {
+                        protocolVersion: 1,
+                        ...request,
+                        invocationId: b.invocationId,
+                        deadline: Math.min(params.deadline ?? b.deadline, b.deadline),
+                    }, responders);
+                },
+            },
+        };
+    };
+    return {
+        can: capability.can,
+        actionType: capability.actionType,
+        inputSchema: capability.inputSchema,
+        outputSchema: capability.outputSchema ?? z.record(z.string(), z.unknown()),
+        invoke: async (inputs, ctx) => {
+            const output = await capability.handler(inputs, contextFor(ctx));
+            return {
+                output: output,
+                outcomes: outcomes(output),
+            };
+        },
+        readback: async (inputs, ctx) => bounded(resultSchema, await recover(inputs, contextFor(ctx))),
+    };
+}
+//# sourceMappingURL=capability-adapter.js.map

package/dist/capability-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-adapter.js","sourceRoot":"","sources":["../src/capability-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE9D,+GAA+G;AAC/G,MAAM,UAAU,sBAAsB,CACpC,UAA8B,EAC9B,OAG6B,EAC7B,WAAiD,GAAG,EAAE,CAAC,EAAE;IAEzD,MAAM,UAAU,GAAG,CAAC,GAAmB,EAA6B,EAAE;QACpE,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;QACtB,OAAO;YACL,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,WAAW,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW;YACpC,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM;YAC1B,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW;YAClC,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,eAAe,EAAE,CAAC,CAAC,eAAe;YAClC,QAAQ,EAAE,CAAC,CAAC,SAAS;YACrB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,KAAK,EAAE;gBACL,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;oBACxB,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC;oBACtC,MAAM,EAAE,cAAc,EAAE,CAAC;oBACzB,MAAM,UAAU,GAAG,CAAC,CAAC,eAAe,CAAC,eAAe,CAAC;oBACrD,MAAM,UAAU,GAAG,CAAC;yBACjB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;yBACxB,GAAG,CAAC,CAAC,CAAC;yBACN,GAAG,CAAC,EAAE,CAAC;yBACP,KAAK,CAAC,UAAU,CAAC,CAAC;oBACrB,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CACtB,GAAG,CAAC,IAAI,EACR;wBACE,eAAe,EAAE,CAAC;wBAClB,GAAG,OAAO;wBACV,YAAY,EAAE,CAAC,CAAC,YAAY;wBAC5B,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC;qBAC9D,EACD,UAAU,CACF,CAAC;gBACb,CAAC;aACF;SACF,CAAC;IACJ,CAAC,CAAC;IACF,OAAO;QACL,GAAG,EAAE,UAAU,CAAC,GAAG;QACnB,UAAU,EAAE,UAAU,CAAC,UAAU;QACjC,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,YAAY,EAAE,UAAU,CAAC,YAAY,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAC1E,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;YACjE,OAAO;gBACL,MAAM,EAAE,MAAqB;gBAC7B,QAAQ,EAAE,QAAQ,CAAC,MAAqB,CAAC;aAC1C,CAAC;QACJ,CAAC;QACD,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAC9B,OAAO,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;KAChE,CAAC;AACJ,CAAC"}

package/dist/capability.d.ts

@@ -21,6 +21,8 @@ export interface FlowWorkInputApi {
  * to a single flow node.
  */
 export interface FlowWorkInvocationContext {
+    /** Bounded execution identity; stable across attempts and receipt recovery. */
+    operationId?: string;
     /** Unique id of this invocation — stable across redelivery. */
     invocationId: string;
     /** DID of the manager authenticated by the exact UCAN invoker binding. */

package/dist/capability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,CAAC,SAAS,qBAAqB,EACrC,MAAM,EAAE,OAAO,CAAC,sBAAsB,EAAE;QAAE,QAAQ,EAAE,CAAC,CAAA;KAAE,CAAC,GACvD,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,yBAAyB;IACxC,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IACtE,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACzB;;;;;OAKG;IACH,OAAO,EAAE,CACP,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EACvB,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED,wBAAgB,cAAc,CAC5B,YAAY,EAAE,SAAS,kBAAkB,EAAE,EAC3C,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,kBAAkB,GAAG,SAAS,CAIhC"}
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,CAAC,SAAS,qBAAqB,EACrC,MAAM,EAAE,OAAO,CAAC,sBAAsB,EAAE;QAAE,QAAQ,EAAE,CAAC,CAAA;KAAE,CAAC,GACvD,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,yBAAyB;IACxC,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB,CAAC,MAAM,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO;IACtE,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC;IACzB;;;;;OAKG;IACH,OAAO,EAAE,CACP,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EACvB,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,OAAO,CAAC,CAAC;CACvB;AAED,wBAAgB,cAAc,CAC5B,YAAY,EAAE,SAAS,kBAAkB,EAAE,EAC3C,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,kBAAkB,GAAG,SAAS,CAIhC"}

package/dist/capability.js.map

@@ -1 +1 @@
-{"version":3,"file":"capability.js","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAmGA,MAAM,UAAU,cAAc,CAC5B,YAA2C,EAC3C,GAAW,EACX,UAAkB;IAElB,OAAO,YAAY,CAAC,IAAI,CACtB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,UAAU,KAAK,UAAU,CAChE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAqGA,MAAM,UAAU,cAAc,CAC5B,YAA2C,EAC3C,GAAW,EACX,UAAkB;IAElB,OAAO,YAAY,CAAC,IAAI,CACtB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,UAAU,KAAK,UAAU,CAChE,CAAC;AACJ,CAAC"}

package/dist/durable-input.d.ts

@@ -0,0 +1,18 @@
+import { type BoundedWorkEvent, type GatewayEvent, type BoundedJson } from './bounded-protocol.js';
+import { DurableWorkStore, type StoredWork } from './durable-store.js';
+export declare class InputPending extends Error {
+    readonly requestKey: string;
+    constructor(requestKey: string);
+}
+export declare class DurableInput {
+    private readonly store;
+    private readonly now;
+    constructor(store: DurableWorkStore, now?: () => number);
+    request(work: StoredWork, requestValue: unknown, responders: string[]): BoundedJson;
+    private pending;
+    deliveryId(work: StoredWork, requestKey: string): string;
+    accept(work: StoredWork, event: GatewayEvent, content: Extract<BoundedWorkEvent, {
+        phase: 'input_response';
+    }>): void;
+}
+//# sourceMappingURL=durable-input.d.ts.map

package/dist/durable-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-input.d.ts","sourceRoot":"","sources":["../src/durable-input.ts"],"names":[],"mappings":"AAKA,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGvE,qBAAa,YAAa,SAAQ,KAAK;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAAlB,UAAU,EAAE,MAAM;CAGxC;AACD,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBADH,KAAK,EAAE,gBAAgB,EACvB,GAAG,eAAW;IAEjC,OAAO,CACL,IAAI,EAAE,UAAU,EAChB,YAAY,EAAE,OAAO,EACrB,UAAU,EAAE,MAAM,EAAE,GACnB,WAAW;IA2Ed,OAAO,CAAC,OAAO;IAGf,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAGxD,MAAM,CACJ,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAAE,KAAK,EAAE,gBAAgB,CAAA;KAAE,CAAC,GAC9D,IAAI;CA6ER"}

package/dist/durable-input.js

@@ -0,0 +1,126 @@
+import { z } from 'zod';
+import { flowWorkInputRequestSchema, flowWorkInputResponseSchema, } from './input.js';
+import { bounded, same, text, parse, EVENT_TYPES, } from './bounded-protocol.js';
+export class InputPending extends Error {
+    requestKey;
+    constructor(requestKey) {
+        super('INPUT_PENDING');
+        this.requestKey = requestKey;
+    }
+}
+export class DurableInput {
+    store;
+    now;
+    constructor(store, now = Date.now) {
+        this.store = store;
+        this.now = now;
+    }
+    request(work, requestValue, responders) {
+        const request = bounded(flowWorkInputRequestSchema, requestValue);
+        if (!request.deadline ||
+            request.deadline > work.binding.deadline ||
+            request.invocationId !== work.binding.invocationId)
+            throw new Error('INPUT_REQUEST_BINDING_MISMATCH');
+        const deadline = request.deadline;
+        if (!responders.length ||
+            responders.length > 32 ||
+            new Set(responders).size !== responders.length)
+            throw new Error('INVALID_RESPONDER_POLICY');
+        if (request.target?.matrixUserId &&
+            !responders.includes(request.target.matrixUserId))
+            throw new Error('INPUT_TARGET_MISMATCH');
+        // DID-only selection requires an authenticated host resolution to concrete Matrix users.
+        if (request.target?.did && !request.target.matrixUserId)
+            throw new Error('INPUT_TARGET_RESOLUTION_REQUIRED');
+        return (this.store.storage.transactionSync(() => {
+            this.store.assertCurrent(work);
+            const prior = this.store.storage.sql
+                .exec('SELECT * FROM helper_input WHERE work_key=? AND request_key=?', work.key, request.requestKey)
+                .toArray()[0];
+            if (prior) {
+                if (prior.body !== text(request) ||
+                    prior.responders !== text(responders) ||
+                    prior.binding !== text(work.binding))
+                    throw new Error('INPUT_REQUEST_CONFLICT');
+                if (prior.response !== null)
+                    return parse(z.custom(() => true), String(prior.response));
+            }
+            else {
+                this.store.storage.sql.exec(`INSERT INTO helper_input VALUES (?,?,?,?,?,?,NULL,NULL,NULL)`, work.key, request.requestKey, text(work.binding), text(request), text(responders), deadline);
+                this.store.enqueue(this.deliveryId(work, request.requestKey), work, EVENT_TYPES.input_request, {
+                    phase: 'input_request',
+                    binding: work.binding,
+                    requestKey: request.requestKey,
+                    request: request,
+                    responders,
+                    deadline: request.deadline,
+                });
+            }
+            if (deadline <= this.now())
+                return { status: 'expired', deadline };
+            // Return outside the transaction before suspending the domain handler.
+            return null;
+        }) ?? this.pending(request.requestKey));
+    }
+    pending(key) {
+        throw new InputPending(key);
+    }
+    deliveryId(work, requestKey) {
+        return `input:${work.binding.invocationId}:${work.binding.attempt}:${requestKey}`;
+    }
+    accept(work, event, content) {
+        this.store.assertCurrent(work);
+        const prior = this.store.storage.sql
+            .exec('SELECT * FROM helper_input WHERE work_key=? AND request_key=?', work.key, content.requestKey)
+            .toArray()[0];
+        if (!prior ||
+            !same(work.binding, content.binding) ||
+            prior.binding !== text(content.binding) ||
+            prior.event_id !== content.requestEventId)
+            throw new Error('INPUT_RELATION_MISMATCH');
+        if (this.now() >= Number(prior.deadline) ||
+            event.originServerTs >= Number(prior.deadline))
+            throw new Error('INPUT_DEADLINE_EXPIRED');
+        const responders = parse(z.array(z.string()), String(prior.responders));
+        if (!responders.includes(event.sender))
+            throw new Error('INPUT_RESPONDER_DENIED');
+        const request = parse(flowWorkInputRequestSchema, String(prior.body));
+        const response = bounded(flowWorkInputResponseSchema, content.response);
+        if (response.invocationId !== work.binding.invocationId ||
+            response.requestKey !== content.requestKey ||
+            response.template !== request.template ||
+            response['m.relates_to'].event_id !== content.requestEventId)
+            throw new Error('INPUT_RESPONSE_MISMATCH');
+        if (request.template === 'select' &&
+            response.template === 'select' &&
+            !request.options.some((o) => o.id === response.optionId))
+            throw new Error('INPUT_OPTION_INVALID');
+        if (request.template === 'entity-select' &&
+            response.template === 'entity-select' &&
+            !request.options.some((o) => o.id === response.entityId))
+            throw new Error('INPUT_OPTION_INVALID');
+        if (request.template === 'text' && response.template === 'text') {
+            if (response.text.length < (request.minLength ?? 1) ||
+                response.text.length > (request.maxLength ?? 8192))
+                throw new Error('INPUT_TEXT_INVALID');
+            // Arbitrary regular expressions are not safe in the bounded execution lane.
+            if (request.pattern)
+                throw new Error('INPUT_PATTERN_REQUIRES_VALIDATOR');
+        }
+        const outcome = {
+            status: 'answered',
+            response,
+            requestEventId: content.requestEventId,
+            responseEventId: event.eventId,
+            sender: event.sender,
+            respondedAtMs: event.originServerTs,
+            fromHistory: true,
+        };
+        if (prior.response !== null &&
+            (prior.response_event !== event.eventId ||
+                prior.response !== text(outcome)))
+            throw new Error('INPUT_RESPONSE_CONFLICT');
+        this.store.storage.sql.exec('UPDATE helper_input SET response=?,response_event=? WHERE work_key=? AND request_key=?', text(outcome), event.eventId, work.key, content.requestKey);
+    }
+}
+//# sourceMappingURL=durable-input.js.map

package/dist/durable-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-input.js","sourceRoot":"","sources":["../src/durable-input.ts"],"names":[],"mappings":"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"}

package/dist/durable-listener.d.ts

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+import { type BoundedJson, type BoundedWorkBinding, type ExecutionResult, type GatewayEvent } from './bounded-protocol.js';
+import { DurableWorkStore, type StoredWork } from './durable-store.js';
+import { DurableInput } from './durable-input.js';
+import { GatewayClient } from './gateway-client.js';
+import type { DelegationValidator } from './ucan.js';
+export interface DurableCapability {
+    can: string;
+    actionType: string;
+    inputSchema: z.ZodType;
+    outputSchema: z.ZodType;
+    invoke(inputs: BoundedJson, context: DurableContext): Promise<{
+        output: BoundedJson;
+        outcomes: BoundedJson;
+    } | ExecutionResult>;
+    readback(inputs: BoundedJson, context: DurableContext): Promise<ExecutionResult>;
+}
+export interface DurableContext {
+    binding: BoundedWorkBinding;
+    delegation: string;
+    input: DurableInput;
+    work: StoredWork;
+}
+export interface WorkAuthority {
+    /** Check current epoch, execution grant, eligibility, revision, actor, and helper routing at the trusted definition service. */
+    authorize(binding: BoundedWorkBinding): Promise<{
+        expiresAt: number;
+        stateVersion: number;
+        grantDigest: string;
+    }>;
+}
+export declare class DurableWorkListener {
+    private readonly options;
+    readonly input: DurableInput;
+    constructor(options: {
+        store: DurableWorkStore;
+        gateway: GatewayClient;
+        oracleDid: string;
+        matrixUserId: string;
+        capabilities: readonly DurableCapability[];
+        validateDelegation: DelegationValidator;
+        authority: WorkAuthority;
+        now?: () => number;
+    });
+    private now;
+    authorize(binding: BoundedWorkBinding, delegation: string): Promise<DurableCapability>;
+    consume(event: GatewayEvent): Promise<void>;
+    private enqueueReady;
+    advance(work: StoredWork): Promise<void>;
+    private enqueueReceipt;
+    flush(): Promise<void>;
+    /** One bounded delivery per turn. Persist accepted state before the gateway acknowledgement. */
+    tick(): Promise<void>;
+}
+//# sourceMappingURL=durable-listener.d.ts.map

package/dist/durable-listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-listener.d.ts","sourceRoot":"","sources":["../src/durable-listener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAUL,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC;IACxB,MAAM,CACJ,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,WAAW,CAAA;KAAE,GAAG,eAAe,CAAC,CAAC;IAC7E,QAAQ,CACN,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7B;AACD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;CAClB;AACD,MAAM,WAAW,aAAa;IAC5B,gIAAgI;IAChI,SAAS,CACP,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9E;AACD,qBAAa,mBAAmB;IAG5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAF1B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;gBAEV,OAAO,EAAE;QACxB,KAAK,EAAE,gBAAgB,CAAC;QACxB,OAAO,EAAE,aAAa,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAAC;QAC3C,kBAAkB,EAAE,mBAAmB,CAAC;QACxC,SAAS,EAAE,aAAa,CAAC;QACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;KACpB;IAIH,OAAO,CAAC,GAAG;IAGL,SAAS,CACb,OAAO,EAAE,kBAAkB,EAC3B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAuCvB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDjD,OAAO,CAAC,YAAY;IAYd,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA4D9C,OAAO,CAAC,cAAc;IAahB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B5B,gGAAgG;IAC1F,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAU5B"}

package/dist/durable-listener.js

@@ -0,0 +1,202 @@
+import { bounded, eventSchema, resultSchema, EVENT_TYPES, grantCaveats, hash, same, parse, } from './bounded-protocol.js';
+import { DurableInput } from './durable-input.js';
+export class DurableWorkListener {
+    options;
+    input;
+    constructor(options) {
+        this.options = options;
+        this.input = new DurableInput(options.store, () => this.now());
+    }
+    now() {
+        return this.options.now?.() ?? Date.now();
+    }
+    async authorize(binding, delegation) {
+        const { oracleDid, matrixUserId, capabilities, authority, validateDelegation, } = this.options;
+        if (binding.helperDid !== oracleDid ||
+            binding.helperMatrixId !== matrixUserId ||
+            binding.deadline <= this.now())
+            throw new Error('HELPER_AUTHORITY_DENIED');
+        const capability = capabilities.find((c) => c.can === binding.capability && c.actionType === binding.actionType);
+        if (!capability)
+            throw new Error('CAPABILITY_NOT_DECLARED');
+        const grant = await validateDelegation(delegation);
+        if (!grant.ok ||
+            grant.invokerDid !== binding.managerDid ||
+            grant.capability?.can !== binding.capability ||
+            grant.capability.with !== binding.resource ||
+            !same(grant.capability.nb, grantCaveats(binding)) ||
+            !grant.expiration ||
+            grant.expiration * 1000 < binding.deadline)
+            throw new Error('DOMAIN_GRANT_DENIED');
+        const authorized = await authority.authorize(binding);
+        if (authorized.expiresAt <= this.now() ||
+            authorized.stateVersion !== binding.admission.stateVersion ||
+            authorized.grantDigest !== binding.admission.grantDigest)
+            throw new Error('EXECUTION_AUTHORITY_DENIED');
+        return capability;
+    }
+    async consume(event) {
+        const { store } = this.options;
+        const fingerprint = await hash(event);
+        if (store.seen(event.eventId, fingerprint))
+            return;
+        const content = bounded(eventSchema, event.content);
+        const binding = content.binding;
+        if (!event.encrypted ||
+            event.roomId !== binding.admission.roomId ||
+            event.type !== EVENT_TYPES[content.phase])
+            throw new Error('EVENT_BINDING_MISMATCH');
+        const key = store.key(binding);
+        if (content.phase === 'assign') {
+            if (event.sender !== binding.managerMatrixId)
+                throw new Error('SENDER_UNTRUSTED');
+            await this.authorize(binding, content.delegation);
+            store.storage.transactionSync(() => {
+                const work = store.assign(binding, content.delegation, event.eventId);
+                this.enqueueReady(work);
+                store.markSeen(event.eventId, fingerprint);
+            });
+            return;
+        }
+        const work = store.read(key);
+        if (!work || !same(work.binding, binding))
+            throw new Error('ASSIGNMENT_MISSING');
+        if (content.phase === 'invoke') {
+            if (event.sender !== binding.managerMatrixId ||
+                content.requestEventId !== work.readyEvent)
+                throw new Error('INVOKE_RELATION_MISMATCH');
+            if ((await hash(content.inputs)) !== binding.admission.inputDigest)
+                throw new Error('INPUT_DIGEST_MISMATCH');
+            await this.authorize(binding, work.delegation);
+            store.storage.transactionSync(() => {
+                const accepted = store.accept(work, content.inputs, event.eventId);
+                if (accepted.result && accepted.result.outcome !== 'needs_verification')
+                    this.enqueueReceipt(accepted, accepted.result);
+                store.markSeen(event.eventId, fingerprint);
+            });
+        }
+        else if (content.phase === 'input_response') {
+            store.storage.transactionSync(() => {
+                this.input.accept(work, event, content);
+                store.markSeen(event.eventId, fingerprint);
+            });
+        }
+        else
+            throw new Error('UNEXPECTED_HELPER_EVENT');
+    }
+    enqueueReady(work) {
+        this.options.store.enqueue(`ready:${work.binding.invocationId}:${work.binding.attempt}`, work, EVENT_TYPES.ready, {
+            phase: 'ready',
+            binding: work.binding,
+            requestEventId: work.assignEvent,
+        });
+    }
+    async advance(work) {
+        const { store } = this.options;
+        if (!work.invokeEvent || work.inputs === null) {
+            if (!work.readyEvent)
+                this.enqueueReady(work);
+            return;
+        }
+        if (work.result && work.result.outcome !== 'needs_verification') {
+            this.enqueueReceipt(work, work.result);
+            return;
+        }
+        let capability;
+        try {
+            capability = await this.authorize(work.binding, work.delegation);
+        }
+        catch {
+            return;
+        } // Current read authority is absent. Retain the durable uncertain state.
+        const context = {
+            binding: work.binding,
+            delegation: work.delegation,
+            input: this.input,
+            work,
+        };
+        let inputs;
+        try {
+            inputs = bounded(capability.inputSchema, work.inputs);
+        }
+        catch {
+            if (work.state === 'accepted') {
+                const result = {
+                    outcome: 'failed_before_effect',
+                    error: { code: 'ACTION_INPUT_INVALID' },
+                };
+                store.storage.transactionSync(() => {
+                    store.finish(work, result);
+                    this.enqueueReceipt(work, result);
+                });
+            }
+            return;
+        }
+        const first = store.arm(work);
+        let result;
+        try {
+            if (first) {
+                const invoked = await capability.invoke(inputs, context);
+                result =
+                    'outcome' in invoked ? invoked : { outcome: 'succeeded', ...invoked };
+            }
+            else
+                result = await capability.readback(inputs, context);
+            result = bounded(resultSchema, result);
+            if (result.outcome === 'succeeded')
+                bounded(capability.outputSchema, result.output);
+            // A readback adapter may prove a durable pre-effect rejection, such as a declined approval.
+            // An exception never supplies that proof and always remains uncertain.
+        }
+        catch {
+            result = { outcome: 'needs_verification' };
+        }
+        store.storage.transactionSync(() => {
+            store.finish(work, result);
+            if (result.outcome !== 'needs_verification')
+                this.enqueueReceipt(work, result);
+        });
+    }
+    enqueueReceipt(work, result) {
+        this.options.store.enqueue(`receipt:${work.binding.invocationId}:${work.binding.attempt}`, work, EVENT_TYPES.receipt, {
+            phase: 'receipt',
+            binding: work.binding,
+            requestEventId: work.invokeEvent,
+            result,
+        });
+    }
+    async flush() {
+        const { store, gateway } = this.options;
+        for (const delivery of store.deliveries()) {
+            const content = parse(eventSchema, String(delivery.content));
+            const eventId = await gateway.send({
+                transactionId: String(delivery.id),
+                roomId: String(delivery.room_id),
+                type: String(delivery.type),
+                content: content,
+                epoch: Number(delivery.epoch),
+            });
+            store.storage.transactionSync(() => {
+                store.delivered(String(delivery.id), eventId);
+                const work = store.read(String(delivery.work_key));
+                if (content.phase === 'ready' && same(work.binding, content.binding))
+                    store.ready(work, eventId);
+                if (content.phase === 'input_request')
+                    store.storage.sql.exec('UPDATE helper_input SET event_id=? WHERE work_key=? AND request_key=?', eventId, work.key, content.requestKey);
+            });
+        }
+    }
+    /** One bounded delivery per turn. Persist accepted state before the gateway acknowledgement. */
+    async tick() {
+        await this.flush();
+        const page = await this.options.gateway.read();
+        for (const event of page.events) {
+            await this.consume(event);
+            await this.options.gateway.ack(event.eventId);
+        }
+        for (const work of this.options.store.pending())
+            await this.advance(work);
+        await this.flush();
+    }
+}
+//# sourceMappingURL=durable-listener.js.map

package/dist/durable-listener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-listener.js","sourceRoot":"","sources":["../src/durable-listener.ts"],"names":[],"mappings":"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"}

package/dist/durable-store.d.ts

@@ -0,0 +1,43 @@
+import { type BoundedWorkBinding, type BoundedJson, type ExecutionResult } from './bounded-protocol.js';
+/** Structurally compatible with the runtime-core SQL port and Durable Object storage. */
+export interface WorkSql {
+    sql: {
+        exec<T extends Record<string, string | number | null | ArrayBuffer>>(query: string, ...args: (string | number | null)[]): {
+            toArray(): T[];
+        };
+    };
+    transactionSync<T>(body: () => T): T;
+}
+type Row = Record<string, string | number | null | ArrayBuffer>;
+export type WorkState = 'assigned' | 'ready' | 'accepted' | 'armed' | 'needs_verification' | 'complete';
+export interface StoredWork {
+    key: string;
+    binding: BoundedWorkBinding;
+    delegation: string;
+    assignEvent: string;
+    readyEvent: string | null;
+    invokeEvent: string | null;
+    inputs: BoundedJson | null;
+    state: WorkState;
+    result: ExecutionResult | null;
+}
+export declare class DurableWorkStore {
+    readonly storage: WorkSql;
+    constructor(storage: WorkSql);
+    key(binding: BoundedWorkBinding): string;
+    read(key: string): StoredWork | null;
+    assign(binding: BoundedWorkBinding, delegation: string, eventId: string): StoredWork;
+    assertCurrent(work: StoredWork): void;
+    ready(work: StoredWork, eventId: string): void;
+    accept(work: StoredWork, inputs: BoundedJson, eventId: string): StoredWork;
+    arm(work: StoredWork): boolean;
+    finish(work: StoredWork, result: ExecutionResult): void;
+    pending(limit?: number): StoredWork[];
+    enqueue(id: string, work: StoredWork, type: string, content: BoundedJson): void;
+    deliveries(limit?: number): Row[];
+    delivered(id: string, eventId: string): void;
+    seen(eventId: string, fingerprint: string): boolean;
+    markSeen(eventId: string, fingerprint: string): void;
+}
+export {};
+//# sourceMappingURL=durable-store.d.ts.map

package/dist/durable-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-store.d.ts","sourceRoot":"","sources":["../src/durable-store.ts"],"names":[],"mappings":"AACA,OAAO,EAOL,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,yFAAyF;AACzF,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE;QACH,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,WAAW,CAAC,EACjE,KAAK,EAAE,MAAM,EACb,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,GAClC;YAAE,OAAO,IAAI,CAAC,EAAE,CAAA;SAAE,CAAC;KACvB,CAAC;IACF,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CACtC;AACD,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,WAAW,CAAC,CAAC;AAChE,MAAM,MAAM,SAAS,GACjB,UAAU,GACV,OAAO,GACP,UAAU,GACV,OAAO,GACP,oBAAoB,GACpB,UAAU,CAAC;AACf,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,kBAAkB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CAChC;AAED,qBAAa,gBAAgB;IACf,QAAQ,CAAC,OAAO,EAAE,OAAO;gBAAhB,OAAO,EAAE,OAAO;IA8BrC,GAAG,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM;IAGxC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAmBpC,MAAM,CACJ,OAAO,EAAE,kBAAkB,EAC3B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,UAAU;IA4Db,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAerC,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAU9C,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU;IAgB1E,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAW9B,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI;IAmBvD,OAAO,CAAC,KAAK,SAAI,GAAG,UAAU,EAAE;IA+BhC,OAAO,CACL,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,GACnB,IAAI;IAsBP,UAAU,CAAC,KAAK,SAAI,GAAG,GAAG,EAAE;IAU5B,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAY5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAWnD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;CAOrD"}