@sixb/core 0.0.1

package/dist/actions/index.js

@@ -0,0 +1,73 @@
+// @bun
+import {
+  ActionReadRecorder,
+  ActionRegistry,
+  ActionsRuntime,
+  commitActionEdits,
+  createActionReadFacade,
+  defineAction,
+  findActionEditCommit,
+  optional,
+  param,
+  runActionValidators
+} from "../chunk-dhmj53mx.js";
+import {
+  ActionDefinitionError,
+  ActionEditCommitError,
+  coerceActionParamsToTyped,
+  isActionDefinition,
+  isGlobalActionDefinition,
+  isObjectActionDefinition,
+  requestAction,
+  requestActionAndWait,
+  waitForActionRun
+} from "../chunk-jdwx7vzs.js";
+import"../chunk-yvef9xwc.js";
+import"../chunk-aebzcsxr.js";
+import"../chunk-q4qzq0ea.js";
+import"../chunk-xqbtf4wn.js";
+import"../chunk-50kv63vj.js";
+import"../chunk-6wetht33.js";
+import"../chunk-mx84y05q.js";
+import"../chunk-45tw90k7.js";
+import"../chunk-wxhdnwh4.js";
+import"../chunk-9dzba0f2.js";
+import"../chunk-p6r5g77m.js";
+import"../chunk-ry24jbr1.js";
+import"../chunk-1evzqhks.js";
+import"../chunk-t72dvahb.js";
+import"../chunk-tsk2bxs3.js";
+import"../chunk-04b07a9q.js";
+import"../chunk-dktq02ne.js";
+import"../chunk-yt8wphsx.js";
+import"../chunk-k41ajtz7.js";
+import"../chunk-4pycxcj3.js";
+import"../chunk-dcgrzj1t.js";
+import"../chunk-xwnf87e1.js";
+import"../chunk-0fygrz37.js";
+import"../chunk-btpe64e4.js";
+import"../chunk-1vffvydj.js";
+import"../chunk-y64skrwp.js";
+export {
+  waitForActionRun,
+  runActionValidators,
+  requestActionAndWait,
+  requestAction,
+  param,
+  optional,
+  isObjectActionDefinition,
+  isGlobalActionDefinition,
+  isActionDefinition,
+  findActionEditCommit,
+  defineAction,
+  createActionReadFacade,
+  commitActionEdits,
+  coerceActionParamsToTyped,
+  ActionsRuntime,
+  ActionRegistry,
+  ActionReadRecorder,
+  ActionEditCommitError,
+  ActionDefinitionError
+};
+
+//# debugId=03E3743A295F221464756E2164756E21

package/dist/actions/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "03E3743A295F221464756E2164756E21",
+  "names": []
+}

package/dist/actions/read-facade.d.ts

@@ -0,0 +1,56 @@
+import type { EffectiveLinkSnapshot, OntologyLinkRef, OntologyObjectRef } from "../materializer";
+import type { ObjectTypeWithPropertyTokens } from "../ontology/tokens";
+import type { ObjectSetListInput } from "../runtime/types";
+import type { ObjectLinkRow, ObjectRow } from "../storage";
+import type { ActionReadDependencies } from "./commit-edits";
+import type { ActionReadFacade } from "./types";
+export type ActionReadObjectSetSource = {
+    get(id: string): Promise<unknown>;
+    query(): unknown;
+    list(input?: ObjectSetListInput): Promise<unknown>;
+    byId(id: string): {
+        get(): Promise<unknown>;
+        listLinks(link?: {
+            readonly id: string;
+        }): Promise<unknown>;
+    };
+};
+/**
+ * Records the exact state an Action handler observed while reading.
+ *
+ * A handler that reads one dependency twice keeps the first observation: the commit must fail when
+ * current state no longer matches what the decision was made against, and the later read may already
+ * reflect the handler's own intent. Arbitrary query phantoms stay out of this release — `query()` and
+ * `list()` results are not turned into dependencies.
+ */
+export declare class ActionReadRecorder {
+    private readonly objects;
+    private readonly links;
+    private readonly linkScopes;
+    /** Records a concrete object read, including exact absence. */
+    observeObject(ref: OntologyObjectRef, row: ObjectRow | null): void;
+    /**
+     * Records the complete `(source, linkId)` scopes a link listing observed.
+     *
+     * `linkIds` names every scope the read covered so an empty scope is recorded as an empty
+     * fingerprint rather than being silently omitted.
+     */
+    observeLinkScopes(source: OntologyObjectRef, linkIds: readonly string[], rows: readonly ObjectLinkRow[]): void;
+    /** Records a concrete link read, including exact absence. */
+    observeLink(ref: OntologyLinkRef, snapshot: EffectiveLinkSnapshot | null): void;
+    dependencies(): ActionReadDependencies;
+}
+export interface ActionReadFacadeOptions {
+    /** Records what the handler observed, so the commit can be fenced against it. */
+    readonly recorder: ActionReadRecorder;
+    /**
+     * Every link the object type carries, inherited links included.
+     *
+     * Inheritance is resolved by the Ontology registry, not by the imported definition, so an
+     * `extends` type would otherwise report only its own links and drop inherited ones from the
+     * recorded scopes.
+     */
+    readonly resolveLinkIds: (objectTypeId: string) => readonly string[];
+}
+export declare function createActionReadFacade(createObjectSet: <const TObjectType extends ObjectTypeWithPropertyTokens>(objectType: TObjectType) => ActionReadObjectSetSource, options?: ActionReadFacadeOptions): ActionReadFacade;
+//# sourceMappingURL=read-facade.d.ts.map

package/dist/actions/read-facade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-facade.d.ts","sourceRoot":"","sources":["../../src/actions/read-facade.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,qBAAqB,EAIrB,eAAe,EACf,iBAAiB,EAClB,MAAM,iBAAiB,CAAA;AAExB,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAuB,MAAM,SAAS,CAAA;AAEpE,MAAM,MAAM,yBAAyB,GAAG;IACtC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACjC,KAAK,IAAI,OAAO,CAAA;IAChB,IAAI,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAClD,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG;QAChB,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;QACvB,SAAS,CAAC,IAAI,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;KAC5D,CAAA;CACF,CAAA;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IACpE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAChE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA+C;IAE1E,+DAA+D;IAC/D,aAAa,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAiBlE;;;;;OAKG;IACH,iBAAiB,CACf,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,IAAI,EAAE,SAAS,aAAa,EAAE,GAC7B,IAAI;IAkCP,6DAA6D;IAC7D,WAAW,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI;IAS/E,YAAY,IAAI,sBAAsB;CAOvC;AAED,MAAM,WAAW,uBAAuB;IACtC,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAA;IACrC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,CAAA;CACrE;AAED,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,CAAC,KAAK,CAAC,WAAW,SAAS,4BAA4B,EACtE,UAAU,EAAE,WAAW,KACpB,yBAAyB,EAC9B,OAAO,CAAC,EAAE,uBAAuB,GAChC,gBAAgB,CAYlB"}

package/dist/actions/registry.d.ts

@@ -0,0 +1,17 @@
+import type { ObjectType } from "../ontology";
+import type { OntologyRegistry } from "../ontology/registry";
+import type { ActionDefinition, ObjectActionDefinition } from "./types";
+export declare class ActionRegistry {
+    private readonly ontology;
+    private readonly byId;
+    private readonly globalActions;
+    private readonly byTargetId;
+    constructor(actions: readonly ActionDefinition[], ontology: OntologyRegistry);
+    private validatePhases;
+    list(): readonly ActionDefinition[];
+    getById(id: string): ActionDefinition | null;
+    getGlobalActions(): readonly ActionDefinition[];
+    getActionsForType(type: ObjectType): readonly ObjectActionDefinition[];
+    private getInheritanceDuplicate;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/actions/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/actions/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAM5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAGvE,qBAAa,cAAc;IAOvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsC;IAC3D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8C;gBAGvE,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACnB,QAAQ,EAAE,gBAAgB;IAuC7C,OAAO,CAAC,cAAc;IActB,IAAI,IAAI,SAAS,gBAAgB,EAAE;IAInC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAI5C,gBAAgB,IAAI,SAAS,gBAAgB,EAAE;IAI/C,iBAAiB,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,sBAAsB,EAAE;IAiBtE,OAAO,CAAC,uBAAuB;CAmChC"}

package/dist/actions/request.d.ts

@@ -0,0 +1,37 @@
+import type { SixbRuntimeContext } from "../runtime/types";
+import { type ActionRunRecord } from "../storage";
+import type { ActionSubject } from "./types";
+export interface RequestActionResult {
+    readonly runId: string;
+    readonly queuedAt: string;
+    readonly jobId?: string;
+    readonly created: boolean;
+}
+export interface RequestActionOptions {
+    readonly runId?: string;
+    readonly signal?: AbortSignal;
+}
+export interface RequestActionAndWaitOptions extends RequestActionOptions {
+    readonly timeoutMs?: number;
+    readonly onRequested?: (runId: string) => void | Promise<void>;
+}
+export interface RequestActionInput {
+    readonly actionId: string;
+    readonly subject?: ActionSubject;
+    readonly params?: Record<string, unknown>;
+    readonly runId?: string;
+    readonly signal?: AbortSignal;
+}
+export interface RequestActionAndWaitInput extends RequestActionInput {
+    readonly timeoutMs?: number;
+    readonly onRequested?: (runId: string) => void | Promise<void>;
+}
+export interface WaitForActionRunInput {
+    readonly runId: string;
+    readonly timeoutMs?: number;
+    readonly signal?: AbortSignal;
+}
+export declare function requestAction(runtime: SixbRuntimeContext, input: RequestActionInput): Promise<RequestActionResult>;
+export declare function requestActionAndWait(runtime: SixbRuntimeContext, input: RequestActionAndWaitInput): Promise<ActionRunRecord>;
+export declare function waitForActionRun(runtime: SixbRuntimeContext, input: WaitForActionRunInput): Promise<ActionRunRecord>;
+//# sourceMappingURL=request.d.ts.map

package/dist/actions/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../../src/actions/request.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAGL,KAAK,eAAe,EAKrB,MAAM,YAAY,CAAA;AAEnB,OAAO,KAAK,EAAoB,aAAa,EAAE,MAAM,SAAS,CAAA;AAQ9D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,MAAM,WAAW,2BAA4B,SAAQ,oBAAoB;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAED,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/D;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAC9B;AAmBD,wBAAsB,aAAa,CACjC,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CAmF9B;AA4ED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,eAAe,CAAC,CAc1B;AAED,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,kBAAkB,EAC3B,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAgG1B"}

package/dist/actions/run-id.d.ts

@@ -0,0 +1,3 @@
+export declare function createActionRunId(runId: string | undefined): string;
+export declare function createActionRunIdempotencyKey(projectId: string, runId: string): string;
+//# sourceMappingURL=run-id.d.ts.map

package/dist/actions/run-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-id.d.ts","sourceRoot":"","sources":["../../src/actions/run-id.ts"],"names":[],"mappings":"AAGA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CASnE;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtF"}

package/dist/actions/runtime.d.ts

@@ -0,0 +1,11 @@
+import type { SixbRuntimeContext } from "../runtime/types";
+import type { ActionRunRecord } from "../storage";
+import { type RequestActionAndWaitInput, type RequestActionInput, type RequestActionResult, type WaitForActionRunInput } from "./request";
+export declare class ActionsRuntime {
+    private readonly runtime;
+    constructor(runtime: SixbRuntimeContext);
+    request(input: RequestActionInput): Promise<RequestActionResult>;
+    waitFor(input: WaitForActionRunInput): Promise<ActionRunRecord>;
+    requestAndWait(input: RequestActionAndWaitInput): Promise<ActionRunRecord>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/actions/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/actions/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAGxB,KAAK,qBAAqB,EAE3B,MAAM,WAAW,CAAA;AAElB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAEhC,OAAO,EAAE,kBAAkB;IAIvC,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAIhE,OAAO,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAI/D,cAAc,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,eAAe,CAAC;CAG3E"}

package/dist/actions/types/context.d.ts

@@ -0,0 +1,147 @@
+import type { BlobStorage } from "../../blob-storage";
+import type { ConnectorAdapter, ConnectorClient, ConnectorDefinition } from "../../connectors";
+import type { RecordEditsContext } from "../../edits";
+import type { Logger } from "../../logging";
+import type { EffectiveLinkChange, EffectiveObjectChange, OntologyOperationOutcome } from "../../materializer";
+import type { ObjectType, ValueType } from "../../ontology";
+import type { LinkToken, ObjectTypeWithPropertyTokens } from "../../ontology/tokens";
+import type { ListResult, ObjectQueryBuilder, ObjectSetListInput, TwinObject } from "../../runtime/types";
+import type { ActionPrimitiveSchemaValues } from "./params";
+export type ActionTargetObject<TObjectType extends ObjectType = ObjectType, _TValueTypes extends readonly ValueType[] = readonly ValueType[]> = {
+    readonly primaryId: string;
+    readonly objectTypeId: TObjectType["id"];
+    readonly properties: ActionTargetPropertyBag<TObjectType>;
+    readonly createdAt: Date;
+    readonly updatedAt: Date;
+};
+type ActionTargetPropertyBag<TObjectType extends ObjectType> = TObjectType extends {
+    readonly p: infer TPropertyTokens;
+} ? string extends keyof TPropertyTokens ? Record<string, unknown> : {
+    readonly [K in keyof TPropertyTokens]: InferActionSnapshotPropertyValue<TPropertyTokens[K]>;
+} : Record<string, unknown>;
+type InferActionSnapshotPropertyValue<TPropertyToken> = TPropertyToken extends {
+    readonly property: {
+        readonly schema: infer TSchema;
+    };
+} ? TPropertyToken extends {
+    readonly property: {
+        readonly nullable: true;
+    };
+} ? InferActionSnapshotSchemaValue<TSchema> | null : InferActionSnapshotSchemaValue<TSchema> : unknown;
+type InferActionSnapshotSchemaValue<TSchema> = TSchema extends keyof ActionPrimitiveSchemaValues ? ActionPrimitiveSchemaValues[TSchema] : TSchema extends {
+    readonly type: "enum";
+    readonly values: readonly (infer TValue)[];
+} ? TValue : unknown;
+export type ActionSubject = {
+    readonly kind: "none";
+} | ActionObjectSubject;
+export type ActionObjectSubject<TObjectType extends ObjectType = ObjectType> = {
+    readonly kind: "object";
+    readonly objectTypeId: TObjectType["id"];
+    readonly primaryId: string;
+};
+export type ActionBinding<TObjectType extends ObjectType = ObjectType> = {
+    readonly kind: "global";
+} | {
+    readonly kind: "object";
+    readonly objectType: TObjectType;
+};
+type ActionLinkTokenForObjectType<TObjectType extends ObjectTypeWithPropertyTokens> = LinkToken<TObjectType["id"], TObjectType["links"][number]["id"], TObjectType["links"][number]["targetObjectTypeId"], TObjectType["links"][number]>;
+export interface ActionRunPhaseInfo {
+    readonly id: string;
+    readonly startedAt: Date;
+    readonly idempotencyKey: string;
+}
+export interface ActionReadObjectByIdHandle<TObjectType extends ObjectTypeWithPropertyTokens, TValueTypes extends readonly ValueType[]> {
+    get(): Promise<TwinObject<TObjectType, TValueTypes> | null>;
+    listLinks(link?: ActionLinkTokenForObjectType<TObjectType>): Promise<readonly {
+        readonly linkId: string;
+        readonly targetTypeId: string;
+        readonly targetId: string;
+        readonly properties?: Readonly<Record<string, unknown>>;
+    }[]>;
+}
+export interface ActionReadObjectSet<TObjectType extends ObjectTypeWithPropertyTokens, TValueTypes extends readonly ValueType[], TRegisteredObjectTypes extends ObjectTypeWithPropertyTokens = TObjectType> {
+    get(id: string): Promise<TwinObject<TObjectType, TValueTypes> | null>;
+    query(): ObjectQueryBuilder<TObjectType, TRegisteredObjectTypes, TValueTypes>;
+    list(input?: ObjectSetListInput): Promise<ListResult<TwinObject<TObjectType, TValueTypes>>>;
+    byId(id: string): ActionReadObjectByIdHandle<TObjectType, TValueTypes>;
+}
+export interface ActionReadFacade<TValueTypes extends readonly ValueType[] = readonly ValueType[]> {
+    objects<const TObjectType extends ObjectTypeWithPropertyTokens>(objectType: TObjectType): ActionReadObjectSet<TObjectType, TValueTypes, ObjectTypeWithPropertyTokens>;
+}
+export interface ActionTelemetryObjectSet<_TObjectType extends ObjectTypeWithPropertyTokens, _TValueTypes extends readonly ValueType[]> {
+    appendTelemetryBatch(items: readonly {
+        id: string;
+        properties: Readonly<Record<string, unknown>>;
+        at?: Date;
+    }[]): Promise<void>;
+}
+/** Immutable blob operations available to action writeback and effects handlers. */
+export type ActionBlobContext = Pick<BlobStorage, "put" | "open" | "stat">;
+export interface ActionRuntimeFacade<TValueTypes extends readonly ValueType[] = readonly ValueType[]> {
+    readonly blobs: ActionBlobContext;
+    objects<const TObjectType extends ObjectTypeWithPropertyTokens>(objectType: TObjectType): ActionTelemetryObjectSet<TObjectType, TValueTypes>;
+    connector<TAdapter extends ConnectorAdapter>(definition: ConnectorDefinition<string, TAdapter>): Promise<ConnectorClient<TAdapter>>;
+}
+/**
+ * The authoritative ontology commit the run's edits produced.
+ *
+ * Domain events are already durable outbox facts, so effects consume this persisted result rather
+ * than reconstructed event drafts.
+ */
+export interface ActionPhaseCommit {
+    readonly commitId: string;
+    readonly created: boolean;
+    readonly outcomes: readonly OntologyOperationOutcome[];
+    readonly changes: {
+        readonly objects: readonly EffectiveObjectChange[];
+        readonly links: readonly EffectiveLinkChange[];
+    };
+    readonly committedAt: Date;
+}
+export interface BaseActionPhaseContext<TParams extends Record<string, unknown>> {
+    readonly run: ActionRunPhaseInfo;
+    readonly params: TParams;
+    readonly subject: ActionSubject;
+    readonly signal: AbortSignal;
+    readonly logger: Logger;
+}
+export interface GlobalActionValidationContext<TParams extends Record<string, unknown>> extends BaseActionPhaseContext<TParams> {
+}
+export interface ActionValidationContext<TObjectType extends ObjectTypeWithPropertyTokens, TParams extends Record<string, unknown>> extends BaseActionPhaseContext<TParams> {
+    readonly target: ActionTargetObject<TObjectType>;
+}
+export interface GlobalActionWritebackContext<TParams extends Record<string, unknown>> extends BaseActionPhaseContext<TParams> {
+    readonly sixb: ActionRuntimeFacade;
+    readonly read: ActionReadFacade;
+}
+export interface ActionWritebackContext<TObjectType extends ObjectTypeWithPropertyTokens, TParams extends Record<string, unknown>> extends BaseActionPhaseContext<TParams> {
+    readonly sixb: ActionRuntimeFacade;
+    readonly target: ActionTargetObject<TObjectType>;
+    readonly read: ActionReadFacade;
+}
+export interface GlobalActionEditsContext<TParams extends Record<string, unknown>, TWriteback> extends BaseActionPhaseContext<TParams> {
+    readonly objects: RecordEditsContext["objects"];
+    readonly read: ActionReadFacade;
+    readonly writeback: TWriteback;
+}
+export interface ActionEditsContext<TObjectType extends ObjectTypeWithPropertyTokens, TParams extends Record<string, unknown>, TWriteback> extends Omit<BaseActionPhaseContext<TParams>, "subject"> {
+    readonly subject: ActionObjectSubject<TObjectType>;
+    readonly objects: RecordEditsContext["objects"];
+    readonly read: ActionReadFacade;
+    readonly writeback: TWriteback;
+}
+export interface GlobalActionEffectsContext<TParams extends Record<string, unknown>, TWriteback> extends BaseActionPhaseContext<TParams> {
+    readonly sixb: ActionRuntimeFacade;
+    readonly commit: ActionPhaseCommit;
+    readonly writeback: TWriteback;
+}
+export interface ActionEffectsContext<TObjectType extends ObjectTypeWithPropertyTokens, TParams extends Record<string, unknown>, TWriteback> extends Omit<BaseActionPhaseContext<TParams>, "subject"> {
+    readonly subject: ActionObjectSubject<TObjectType>;
+    readonly sixb: ActionRuntimeFacade;
+    readonly commit: ActionPhaseCommit;
+    readonly writeback: TWriteback;
+}
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/actions/types/context.d.ts.map

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

package/dist/actions/types/definitions.d.ts

@@ -0,0 +1,67 @@
+import type { ObjectTypeWithPropertyTokens } from "../../ontology/tokens";
+import type { ActionEditsHandler, ActionEffectsHandler, ActionNoResultHandlerResult, ActionValidator, ActionWritebackHandler, ActionWritebackValue, GlobalActionEditsHandler, GlobalActionEffectsHandler, GlobalActionValidator, GlobalActionWritebackHandler } from "./handlers";
+import type { ActionParamsConfig, InferActionParams } from "./params";
+export interface BaseActionDefinition<TId extends string = string, TParams extends ActionParamsConfig = ActionParamsConfig> {
+    readonly kind: "action";
+    readonly id: TId;
+    readonly params: TParams;
+    readonly description?: string;
+}
+export interface GlobalActionPhaseDefinitions<TWriteback = unknown> {
+    readonly validate: readonly GlobalActionValidator<Record<string, unknown>>[];
+    readonly writeback?: GlobalActionWritebackHandler<Record<string, unknown>, TWriteback>;
+    readonly edits?: GlobalActionEditsHandler<Record<string, unknown>, TWriteback>;
+    readonly effects?: GlobalActionEffectsHandler<Record<string, unknown>, TWriteback>;
+}
+export interface ObjectActionPhaseDefinitions<TWriteback = unknown> {
+    readonly validate: readonly ActionValidator<ObjectTypeWithPropertyTokens, Record<string, unknown>>[];
+    readonly writeback?: ActionWritebackHandler<ObjectTypeWithPropertyTokens, Record<string, unknown>, TWriteback>;
+    readonly edits?: ActionEditsHandler<ObjectTypeWithPropertyTokens, Record<string, unknown>, TWriteback>;
+    readonly effects?: ActionEffectsHandler<ObjectTypeWithPropertyTokens, Record<string, unknown>, TWriteback>;
+}
+export interface GlobalActionDefinition<TId extends string = string, TParams extends ActionParamsConfig = ActionParamsConfig, _TWriteback = unknown> extends BaseActionDefinition<TId, TParams> {
+    readonly binding: {
+        readonly kind: "global";
+    };
+    readonly phases: GlobalActionPhaseDefinitions;
+}
+export interface ObjectActionDefinition<TId extends string = string, TObjectType extends ObjectTypeWithPropertyTokens = ObjectTypeWithPropertyTokens, TParams extends ActionParamsConfig = ActionParamsConfig, _TWriteback = unknown> extends BaseActionDefinition<TId, TParams> {
+    readonly binding: {
+        readonly kind: "object";
+        readonly objectType: TObjectType;
+    };
+    readonly phases: ObjectActionPhaseDefinitions;
+}
+export type ActionDefinition<TId extends string = string, TObjectType extends ObjectTypeWithPropertyTokens = ObjectTypeWithPropertyTokens, TParams extends ActionParamsConfig = ActionParamsConfig, TWriteback = unknown> = GlobalActionDefinition<TId, TParams, TWriteback> | ObjectActionDefinition<TId, TObjectType, TParams, TWriteback>;
+export interface GlobalActionAfterWritebackBuilder<TId extends string, TParams extends ActionParamsConfig, TWriteback> extends GlobalActionDefinition<TId, TParams, TWriteback> {
+    edits<const TResult extends ActionNoResultHandlerResult>(handler: GlobalActionEditsHandler<InferActionParams<TParams>, ActionWritebackValue<TWriteback>, TResult>): GlobalActionAfterEditsBuilder<TId, TParams, ActionWritebackValue<TWriteback>>;
+}
+export interface ObjectActionAfterWritebackBuilder<TId extends string, TObjectType extends ObjectTypeWithPropertyTokens, TParams extends ActionParamsConfig, TWriteback> extends ObjectActionDefinition<TId, TObjectType, TParams, TWriteback> {
+    edits<const TResult extends ActionNoResultHandlerResult>(handler: ActionEditsHandler<TObjectType, InferActionParams<TParams>, ActionWritebackValue<TWriteback>, TResult>): ObjectActionAfterEditsBuilder<TId, TObjectType, TParams, ActionWritebackValue<TWriteback>>;
+}
+export interface GlobalActionAfterEditsBuilder<TId extends string, TParams extends ActionParamsConfig, TWriteback> extends GlobalActionDefinition<TId, TParams, TWriteback> {
+    effects<const TResult extends ActionNoResultHandlerResult>(handler: GlobalActionEffectsHandler<InferActionParams<TParams>, TWriteback, TResult>): GlobalActionDefinition<TId, TParams, TWriteback>;
+}
+export interface ObjectActionAfterEditsBuilder<TId extends string, TObjectType extends ObjectTypeWithPropertyTokens, TParams extends ActionParamsConfig, TWriteback> extends ObjectActionDefinition<TId, TObjectType, TParams, TWriteback> {
+    effects<const TResult extends ActionNoResultHandlerResult>(handler: ActionEffectsHandler<TObjectType, InferActionParams<TParams>, TWriteback, TResult>): ObjectActionDefinition<TId, TObjectType, TParams, TWriteback>;
+}
+export interface GlobalActionPhaseBuilder<TId extends string, TParams extends ActionParamsConfig> {
+    validate(validator: GlobalActionValidator<InferActionParams<TParams>>): GlobalActionPhaseBuilder<TId, TParams>;
+    writeback<const TResult>(handler: GlobalActionWritebackHandler<InferActionParams<TParams>, TResult>): GlobalActionAfterWritebackBuilder<TId, TParams, TResult>;
+    edits<const TResult extends ActionNoResultHandlerResult>(handler: GlobalActionEditsHandler<InferActionParams<TParams>, undefined, TResult>): GlobalActionAfterEditsBuilder<TId, TParams, undefined>;
+}
+export interface ObjectActionPhaseBuilder<TId extends string, TObjectType extends ObjectTypeWithPropertyTokens, TParams extends ActionParamsConfig> {
+    validate(validator: ActionValidator<TObjectType, InferActionParams<TParams>>): ObjectActionPhaseBuilder<TId, TObjectType, TParams>;
+    writeback<const TResult>(handler: ActionWritebackHandler<TObjectType, InferActionParams<TParams>, TResult>): ObjectActionAfterWritebackBuilder<TId, TObjectType, TParams, TResult>;
+    edits<const TResult extends ActionNoResultHandlerResult>(handler: ActionEditsHandler<TObjectType, InferActionParams<TParams>, undefined, TResult>): ObjectActionAfterEditsBuilder<TId, TObjectType, TParams, undefined>;
+}
+export interface GlobalActionParamsBuilder<TId extends string> {
+    params<const TParams extends ActionParamsConfig>(params: TParams): GlobalActionPhaseBuilder<TId, TParams>;
+}
+export interface ObjectActionParamsBuilder<TId extends string, TObjectType extends ObjectTypeWithPropertyTokens> {
+    params<const TParams extends ActionParamsConfig>(params: TParams): ObjectActionPhaseBuilder<TId, TObjectType, TParams>;
+}
+export interface ActionBuilder<TId extends string> extends GlobalActionParamsBuilder<TId> {
+    on<const TObjectType extends ObjectTypeWithPropertyTokens>(objectType: TObjectType): ObjectActionParamsBuilder<TId, TObjectType>;
+}
+//# sourceMappingURL=definitions.d.ts.map

package/dist/actions/types/definitions.d.ts.map

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

package/dist/actions/types/handlers.d.ts

@@ -0,0 +1,19 @@
+import type { ObjectTypeWithPropertyTokens } from "../../ontology/tokens";
+import type { ActionEditsContext, ActionEffectsContext, ActionValidationContext, ActionWritebackContext, GlobalActionEditsContext, GlobalActionEffectsContext, GlobalActionValidationContext, GlobalActionWritebackContext } from "./context";
+type MaybePromise<T> = T | Promise<T>;
+type VoidResult = ReturnType<() => void>;
+export type ActionNoResultHandlerResult = VoidResult | Promise<VoidResult>;
+export type ActionValidationFailure = {
+    readonly error: string;
+};
+export type GlobalActionValidator<TParams extends Record<string, unknown>> = (ctx: GlobalActionValidationContext<TParams>) => void | ActionValidationFailure | Promise<void> | Promise<ActionValidationFailure | undefined>;
+export type ActionValidator<TObjectType extends ObjectTypeWithPropertyTokens, TParams extends Record<string, unknown>> = (ctx: ActionValidationContext<TObjectType, TParams>) => void | ActionValidationFailure | Promise<void> | Promise<ActionValidationFailure | undefined>;
+export type GlobalActionWritebackHandler<TParams extends Record<string, unknown>, TResult> = (ctx: GlobalActionWritebackContext<TParams>) => MaybePromise<TResult>;
+export type ActionWritebackHandler<TObjectType extends ObjectTypeWithPropertyTokens, TParams extends Record<string, unknown>, TResult> = (ctx: ActionWritebackContext<TObjectType, TParams>) => MaybePromise<TResult>;
+export type GlobalActionEditsHandler<TParams extends Record<string, unknown>, TWriteback, TResult extends ActionNoResultHandlerResult = ActionNoResultHandlerResult> = (ctx: GlobalActionEditsContext<TParams, TWriteback>) => TResult;
+export type ActionEditsHandler<TObjectType extends ObjectTypeWithPropertyTokens, TParams extends Record<string, unknown>, TWriteback, TResult extends ActionNoResultHandlerResult = ActionNoResultHandlerResult> = (ctx: ActionEditsContext<TObjectType, TParams, TWriteback>) => TResult;
+export type GlobalActionEffectsHandler<TParams extends Record<string, unknown>, TWriteback, TResult extends ActionNoResultHandlerResult = ActionNoResultHandlerResult> = (ctx: GlobalActionEffectsContext<TParams, TWriteback>) => TResult;
+export type ActionEffectsHandler<TObjectType extends ObjectTypeWithPropertyTokens, TParams extends Record<string, unknown>, TWriteback, TResult extends ActionNoResultHandlerResult = ActionNoResultHandlerResult> = (ctx: ActionEffectsContext<TObjectType, TParams, TWriteback>) => TResult;
+export type ActionWritebackValue<TResult> = [Awaited<TResult>] extends [VoidResult] ? null : Awaited<TResult>;
+export {};
+//# sourceMappingURL=handlers.d.ts.map

package/dist/actions/types/handlers.d.ts.map

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

package/dist/actions/types/params.d.ts

@@ -0,0 +1,45 @@
+import type { DecimalValue, InferSchemaOrRef, ObjectRef, ObjectRefSchema, SchemaOrRef, ValueType } from "../../ontology";
+import type { QuantitativeTypeId } from "../../ontology/units";
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+export interface ActionParamConfig {
+    readonly schema: SchemaOrRef;
+    readonly required?: boolean;
+    readonly nullable?: boolean;
+    readonly description?: string;
+    readonly semanticType?: QuantitativeTypeId;
+}
+export type ActionParamsConfig = Record<string, ActionParamConfig>;
+type RequiredParamKeys<TParams extends ActionParamsConfig> = {
+    [K in keyof TParams]-?: TParams[K]["required"] extends true ? K : never;
+}[keyof TParams];
+type OptionalParamKeys<TParams extends ActionParamsConfig> = Exclude<keyof TParams, RequiredParamKeys<TParams>>;
+/**
+ * Action params normalize "date" / "timestamp" schemas to `Date` (the wider
+ * `InferSchema` form returns `Date | string` to keep storage layers permissive).
+ * Handlers see the validated value, so narrowing to `Date` is sound here.
+ */
+export type ActionPrimitiveSchemaValues = {
+    string: string;
+    uuid: string;
+    boolean: boolean;
+    integer: number;
+    double: number;
+    decimal: DecimalValue;
+    date: Date;
+    timestamp: Date;
+};
+type InferActionStructuredParamValue<TSchema extends SchemaOrRef, TValueTypes extends readonly ValueType[]> = TSchema extends {
+    type: "enum";
+    values: readonly (infer TValue)[];
+} ? TValue : TSchema extends ObjectRefSchema<infer TObjectTypeId> ? ObjectRef<TObjectTypeId> : InferSchemaOrRef<TSchema, TValueTypes>;
+type InferActionParamSchemaValue<TSchema extends SchemaOrRef, TValueTypes extends readonly ValueType[] = []> = TSchema extends keyof ActionPrimitiveSchemaValues ? ActionPrimitiveSchemaValues[TSchema] : InferActionStructuredParamValue<TSchema, TValueTypes>;
+type InferActionParamValue<TParam extends ActionParamConfig, TValueTypes extends readonly ValueType[] = []> = TParam["nullable"] extends true ? InferActionParamSchemaValue<TParam["schema"], TValueTypes> | null : InferActionParamSchemaValue<TParam["schema"], TValueTypes>;
+export type InferActionParams<TParams extends ActionParamsConfig, TValueTypes extends readonly ValueType[] = []> = string extends keyof TParams ? Record<string, unknown> : Simplify<{
+    [K in RequiredParamKeys<TParams>]: InferActionParamValue<TParams[K], TValueTypes>;
+} & {
+    [K in OptionalParamKeys<TParams>]?: InferActionParamValue<TParams[K], TValueTypes>;
+}>;
+export {};
+//# sourceMappingURL=params.d.ts.map

package/dist/actions/types/params.d.ts.map

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

package/dist/actions/types.d.ts

@@ -0,0 +1,5 @@
+export type * from "./types/context";
+export type * from "./types/definitions";
+export type * from "./types/handlers";
+export type * from "./types/params";
+//# sourceMappingURL=types.d.ts.map

package/dist/actions/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/actions/types.ts"],"names":[],"mappings":"AAAA,mBAAmB,iBAAiB,CAAA;AACpC,mBAAmB,qBAAqB,CAAA;AACxC,mBAAmB,kBAAkB,CAAA;AACrC,mBAAmB,gBAAgB,CAAA"}

package/dist/actions/validation.d.ts

@@ -0,0 +1,33 @@
+import { type ValueType } from "../ontology";
+import type { ObjectTypeWithPropertyTokens } from "../ontology/tokens";
+import type { ActionRunParams } from "../storage/action-runs";
+import type { ActionDefinition, ActionParamsConfig, ActionSubject, GlobalActionDefinition, ObjectActionDefinition } from "./types";
+interface ActionValidationRuntime {
+    readonly ontology: {
+        getValueTypesById(): ReadonlyMap<string, ValueType>;
+        resolveObjectType(objectTypeId: string): ObjectTypeWithPropertyTokens;
+    };
+    readonly actionRegistry: {
+        getActionsForType(objectType: ObjectTypeWithPropertyTokens): readonly ObjectActionDefinition[];
+    };
+}
+export declare function assertNonEmpty(value: string, field: string): void;
+export declare function isActionDefinition(value: unknown): value is ActionDefinition;
+export declare function isGlobalActionDefinition(value: ActionDefinition): value is GlobalActionDefinition;
+export declare function isObjectActionDefinition(value: ActionDefinition): value is ObjectActionDefinition;
+export declare function normalizeActionParams(runtime: Pick<ActionValidationRuntime, "ontology">, paramsConfig: ActionParamsConfig, params: Record<string, unknown>, pathPrefix: string): ActionRunParams;
+/**
+ * Re-hydrate stored action params for the handler-facing surface. Params are
+ * normalized to JSON (e.g. `date`/`timestamp` -> ISO string) for storage; action
+ * handler types promise `Date` for those, so this converts them back before the
+ * handler runs. `objectRef` params pass through unchanged.
+ */
+export declare function coerceActionParamsToTyped(paramsConfig: ActionParamsConfig, params: Record<string, unknown>, valueTypesById: ReadonlyMap<string, ValueType>): Record<string, unknown>;
+export declare function validateActionSubject(action: ActionDefinition, subject: ActionSubject): void;
+export declare function resolveObjectActionSubject(params: {
+    readonly runtime: ActionValidationRuntime;
+    readonly action: ObjectActionDefinition;
+    readonly subject: ActionSubject;
+}): ObjectTypeWithPropertyTokens;
+export {};
+//# sourceMappingURL=validation.d.ts.map

package/dist/actions/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/actions/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,KAAK,SAAS,EAA4B,MAAM,aAAa,CAAA;AAExF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAA;AAGtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACb,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,SAAS,CAAA;AAEhB,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,QAAQ,EAAE;QACjB,iBAAiB,IAAI,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QACnD,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,4BAA4B,CAAA;KACtE,CAAA;IACD,QAAQ,CAAC,cAAc,EAAE;QACvB,iBAAiB,CAAC,UAAU,EAAE,4BAA4B,GAAG,SAAS,sBAAsB,EAAE,CAAA;KAC/F,CAAA;CACF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIjE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAQ5E;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,KAAK,IAAI,sBAAsB,CAEjG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,KAAK,IAAI,sBAAsB,CAEjG;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,IAAI,CAAC,uBAAuB,EAAE,UAAU,CAAC,EAClD,YAAY,EAAE,kBAAkB,EAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,GACjB,eAAe,CAgDjB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,kBAAkB,EAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,GAC7C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAI5F;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,QAAQ,CAAC,OAAO,EAAE,uBAAuB,CAAA;IACzC,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAA;IACvC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;CAChC,GAAG,4BAA4B,CAe/B"}