@adobe/data 0.9.22 → 0.9.24

package/dist/ecs/database/database.d.ts

@@ -10,7 +10,7 @@ import { Components } from "../store/components.js";
 import { ArchetypeComponents } from "../store/archetype-components.js";
 import { RequiredComponents } from "../required-components.js";
 import { EntitySelectOptions } from "../store/entity-select-options.js";
-import { Service } from "../../service/service.js";
+import type { Service } from "../../service/index.js";
 import { createDatabase } from "./public/create-database.js";
 import { ResourceSchemas } from "../resource-schemas.js";
 import { ComponentSchemas } from "../component-schemas.js";

package/dist/ecs/persistence-service/persistence-service.d.ts

@@ -1,4 +1,4 @@
-import { Service } from "../../service/service.js";
+import type { Service } from "../../service/index.js";
 export interface PersistenceService extends Service {
     save(fileId?: string): Promise<void>;
     load(fileId?: string): Promise<void>;

package/dist/ecs/undo-redo-service/undo-redo-service.d.ts

@@ -1,6 +1,6 @@
 import { Observe } from "../../observe/index.js";
 import { TransactionResult } from "../database/transactional-store/transactional-store.js";
-import { Service } from "../../service/service.js";
+import type { Service } from "../../service/index.js";
 export interface UndoRedoService<C = unknown> extends Service {
     undoStack: Observe<TransactionResult<C>[]>;
     undoStackIndex: Observe<number>;

package/dist/internal/data-view-32/data-view-32.d.ts

@@ -1,5 +1 @@
-export interface DataView32 {
-    readonly f32: Float32Array;
-    readonly u32: Uint32Array;
-    readonly i32: Int32Array;
-}
+export type { DataView32 } from "../../typed-buffer/data-view-32.js";

package/dist/internal/data-view-32/data-view-32.js

@@ -1,2 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
 export {};
 //# sourceMappingURL=data-view-32.js.map

package/dist/internal/data-view-32/data-view-32.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-view-32.js","sourceRoot":"","sources":["../../../src/internal/data-view-32/data-view-32.ts"],"names":[],"mappings":""}
+{"version":3,"file":"data-view-32.js","sourceRoot":"","sources":["../../../src/internal/data-view-32/data-view-32.ts"],"names":[],"mappings":"AAAA,uDAAuD"}

package/dist/service/agentic-service/action-error.d.ts

@@ -0,0 +1 @@
+export type ActionError = string;

package/dist/service/agentic-service/action-error.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export {};
+//# sourceMappingURL=action-error.js.map

package/dist/service/agentic-service/action-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-error.js","sourceRoot":"","sources":["../../../src/service/agentic-service/action-error.ts"],"names":[],"mappings":"AAAA,uDAAuD"}

package/dist/service/agentic-service/action.d.ts

@@ -0,0 +1,7 @@
+import { Schema } from "../../schema/index.js";
+import type { ActionError } from "./action-error.js";
+export type Action<S extends Schema | false = Schema> = {
+    description: string;
+    schema: S;
+    execute: Schema.ToType<S> extends void ? (() => Promise<void | ActionError> | void) : ((state: Schema.ToType<S>) => Promise<void | ActionError> | void);
+};

package/dist/service/agentic-service/action.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export {};
+//# sourceMappingURL=action.js.map

package/dist/service/agentic-service/action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../../../src/service/agentic-service/action.ts"],"names":[],"mappings":"AAAA,uDAAuD"}

package/dist/service/agentic-service/agentic-service.d.ts

@@ -0,0 +1,21 @@
+import { Observe } from "../../observe/index.js";
+import type { Service } from "../index.js";
+import type { Action } from "./action.js";
+import type { ActionError } from "./action-error.js";
+import type { State } from "./state.js";
+/**
+ * An agentic service provides a set of valid states and actions
+ * which are conditionally available based upon the current state.
+ * This is designed to serve as a foundation for agentic systems.
+ * An MCP or other agentic protocol could be built upon this service interface.
+ */
+export interface AgenticService extends Service {
+    states: Observe<{
+        [key: string]: State;
+    }>;
+    actions: Observe<{
+        [key: string]: Action;
+    }>;
+    execute: (action: string, input: unknown) => Promise<void | ActionError>;
+}
+export * as AgenticService from "./public.js";

package/dist/service/agentic-service/agentic-service.js

@@ -0,0 +1,3 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export * as AgenticService from "./public.js";
+//# sourceMappingURL=agentic-service.js.map

package/dist/service/agentic-service/agentic-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentic-service.js","sourceRoot":"","sources":["../../../src/service/agentic-service/agentic-service.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAsBvD,OAAO,KAAK,cAAc,MAAM,aAAa,CAAC"}

package/dist/service/agentic-service/create-from-config.d.ts

@@ -0,0 +1,45 @@
+import { Observe } from "../../observe/index.js";
+import { Schema } from "../../schema/index.js";
+import { AgenticService } from "./agentic-service.js";
+/** State declaration: has top-level `type` (JSON Schema) + `description` */
+type StateDeclaration<S extends Schema & {
+    type: string;
+} = Schema & {
+    type: string;
+}> = S & {
+    description: string;
+};
+/** Action declaration: `description`, optional `input` schema, no `type` */
+type ActionDeclaration<I extends Schema | false | undefined = undefined> = {
+    description: string;
+    input?: I;
+    type?: never;
+};
+type DeclarationEntry = StateDeclaration | ActionDeclaration<Schema | false | undefined>;
+type Declarations = Record<string, DeclarationEntry>;
+type ConditionalFromDeclarations<D extends Declarations> = Partial<{
+    [K in keyof D]: Observe<boolean>;
+}>;
+/**
+ * Creates an AgenticService from a config with interface, implementation, and optional conditional.
+ *
+ * Interface: flat map of states (have `type`) and actions (have `description`, optional `input`).
+ * Implementation: same keys, states → Observe<...>, actions → (input?) => ...
+ * Conditional: optional per-key Observe<boolean> for enablement.
+ */
+export declare function create<const D extends Declarations>(config: {
+    description: string;
+    interface: D;
+    implementation: ImplementationFromDeclarations<D>;
+    conditional?: ConditionalFromDeclarations<D>;
+}): AgenticService.AgenticService;
+/** Implementation map derived from interface: states → Observe, actions → execute fn */
+export type ImplementationFromDeclarations<D extends Declarations> = {
+    [K in keyof D]: D[K] extends {
+        type: string;
+    } ? Observe<Schema.ToType<D[K]>> : D[K] extends {
+        input: infer I extends Schema | false;
+    } ? ExecuteFromSchema<I> : ExecuteFromSchema<false>;
+};
+type ExecuteFromSchema<S extends Schema | false> = S extends false ? (() => Promise<void | AgenticService.Error> | void) : ((input: Schema.ToType<S>) => Promise<void | AgenticService.Error> | void);
+export {};

package/dist/service/agentic-service/create-from-config.js

@@ -0,0 +1,85 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Observe } from "../../observe/index.js";
+function isStateDeclaration(entry) {
+    return "type" in entry && typeof entry.type === "string";
+}
+function getActionSchema(entry) {
+    if (isStateDeclaration(entry))
+        return false;
+    const actionEntry = entry;
+    return actionEntry.input ?? false;
+}
+/**
+ * Creates an AgenticService from a config with interface, implementation, and optional conditional.
+ *
+ * Interface: flat map of states (have `type`) and actions (have `description`, optional `input`).
+ * Implementation: same keys, states → Observe<...>, actions → (input?) => ...
+ * Conditional: optional per-key Observe<boolean> for enablement.
+ */
+export function create(config) {
+    const { interface: iface, implementation, conditional } = config;
+    const alwaysEnabled = Observe.fromConstant(true);
+    const stateKeys = [];
+    const actionKeys = [];
+    const stateSchemas = {};
+    const actionMeta = {};
+    for (const [key, entry] of Object.entries(iface)) {
+        if (isStateDeclaration(entry)) {
+            stateKeys.push(key);
+            stateSchemas[key] = entry;
+        }
+        else {
+            actionKeys.push(key);
+            const a = entry;
+            actionMeta[key] = {
+                description: a.description,
+                schema: getActionSchema(entry),
+                execute: implementation[key],
+            };
+        }
+    }
+    const perStateObservables = {};
+    for (const key of stateKeys) {
+        const valueObs = implementation[key];
+        const enabledObs = conditional?.[key] ?? alwaysEnabled;
+        perStateObservables[key] = Observe.fromProperties({
+            enabled: enabledObs,
+            value: valueObs,
+        });
+    }
+    const enabledObservables = {};
+    for (const key of actionKeys) {
+        enabledObservables[key] = conditional?.[key] ?? alwaysEnabled;
+    }
+    const states = Observe.withMap(Observe.fromProperties(perStateObservables), (raw) => {
+        const result = {};
+        for (const [key, entry] of Object.entries(raw)) {
+            const { enabled, value } = entry;
+            if (enabled) {
+                result[key] = { schema: stateSchemas[key], value };
+            }
+        }
+        return result;
+    });
+    const actions = Observe.withMap(Observe.fromProperties(enabledObservables), (enabledMap) => {
+        const result = {};
+        for (const [key, enabled] of Object.entries(enabledMap)) {
+            if (!enabled)
+                continue;
+            const meta = actionMeta[key];
+            if (meta)
+                result[key] = meta;
+        }
+        return result;
+    });
+    let currentActions = {};
+    actions((a) => { currentActions = a; });
+    const execute = async (actionName, input) => {
+        const entry = currentActions[actionName];
+        if (!entry)
+            return `Action "${actionName}" is not available`;
+        return entry.execute(input);
+    };
+    return { serviceName: "agentic-service", states, actions, execute };
+}
+//# sourceMappingURL=create-from-config.js.map

package/dist/service/agentic-service/create-from-config.js.map

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

package/dist/service/agentic-service/create.d.ts

@@ -0,0 +1,45 @@
+import { Observe } from "../../observe/index.js";
+import { Schema } from "../../schema/index.js";
+import { AgenticService } from "./agentic-service.js";
+/** State declaration: has top-level `type` (JSON Schema) + `description` */
+type StateDeclaration<S extends Schema & {
+    type: string;
+} = Schema & {
+    type: string;
+}> = S & {
+    description: string;
+};
+/** Action declaration: `description`, optional `input` schema, no `type` */
+type ActionDeclaration<I extends Schema | false | undefined = undefined> = {
+    description: string;
+    input?: I;
+    type?: never;
+};
+type DeclarationEntry = StateDeclaration | ActionDeclaration<Schema | false | undefined>;
+type Declarations = Record<string, DeclarationEntry>;
+type ConditionalFromDeclarations<D extends Declarations> = Partial<{
+    [K in keyof D]: Observe<boolean>;
+}>;
+/**
+ * Creates an AgenticService from a config with interface, implementation, and optional conditional.
+ *
+ * Interface: flat map of states (have `type`) and actions (have `description`, optional `input`).
+ * Implementation: same keys, states → Observe<...>, actions → (input?) => ...
+ * Conditional: optional per-key Observe<boolean> for enablement.
+ */
+export declare function create<const D extends Declarations>(config: {
+    description: string;
+    interface: D;
+    implementation: ImplementationFromDeclarations<D>;
+    conditional?: ConditionalFromDeclarations<D>;
+}): AgenticService.AgenticService;
+/** Implementation map derived from interface: states → Observe, actions → execute fn */
+export type ImplementationFromDeclarations<D extends Declarations> = {
+    [K in keyof D]: D[K] extends {
+        type: string;
+    } ? Observe<Schema.ToType<D[K]>> : D[K] extends {
+        input: infer I extends Schema | false;
+    } ? ExecuteFromSchema<I> : ExecuteFromSchema<false>;
+};
+type ExecuteFromSchema<S extends Schema | false> = S extends false ? (() => Promise<void | AgenticService.ActionError> | void) : ((input: Schema.ToType<S>) => Promise<void | AgenticService.ActionError> | void);
+export {};

package/dist/service/agentic-service/create.interface-first-spike.type-test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/service/agentic-service/create.interface-first-spike.type-test.js

@@ -0,0 +1,119 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Observe } from "../../observe/index.js";
+import { createFromConfig, } from "./create-from-config.js";
+const iface = {
+    health: {
+        type: "number",
+        description: "Current health points",
+    },
+    stats: {
+        type: "object",
+        description: "Current player stats",
+        properties: {
+            hp: { type: "number" },
+            label: { type: "string" },
+        },
+        required: ["hp"],
+        additionalProperties: false,
+    },
+    heal: {
+        description: "Increase health by amount",
+        input: { type: "number" },
+    },
+    configure: {
+        description: "Configure stats",
+        input: {
+            type: "object",
+            properties: {
+                hp: { type: "number" },
+                label: { type: "string" },
+            },
+            required: ["hp"],
+            additionalProperties: false,
+        },
+    },
+    reset: {
+        description: "Reset values",
+    },
+};
+createFromConfig({
+    description: "Player health and actions for agentic access",
+    declaration: iface,
+    implementation: {
+        health: Observe.fromConstant(42),
+        stats: Observe.fromConstant({ hp: 100, label: "ok" }),
+        heal: (input) => {
+        },
+        configure: (input) => {
+        },
+        reset: () => { },
+    },
+    conditional: {
+        health: Observe.fromConstant(true),
+        heal: Observe.fromConstant(false),
+    },
+});
+createFromConfig({
+    description: "Player health and actions for agentic access",
+    declaration: iface,
+    implementation: {
+        // @ts-expect-error - health state requires Observe<number>
+        health: Observe.fromConstant("wrong"),
+        stats: Observe.fromConstant({ hp: 100 }),
+        heal: (input) => { },
+        configure: (input) => { },
+        reset: () => { },
+    },
+});
+createFromConfig({
+    description: "Player health and actions for agentic access",
+    declaration: iface,
+    implementation: {
+        health: Observe.fromConstant(100),
+        stats: Observe.fromConstant({ hp: 100 }),
+        // @ts-expect-error - heal input schema requires number
+        heal: (input) => { },
+        configure: (input) => { },
+        reset: () => { },
+    },
+});
+createFromConfig({
+    description: "Player health and actions for agentic access",
+    declaration: iface,
+    implementation: {
+        health: Observe.fromConstant(100),
+        stats: Observe.fromConstant({ hp: 100 }),
+        heal: (input) => { },
+        configure: (input) => { },
+        // @ts-expect-error - reset action has no input schema
+        reset: (input) => { },
+    },
+});
+createFromConfig({
+    description: "Player health and actions for agentic access",
+    declaration: iface,
+    // @ts-expect-error - implementation must include every definition key
+    implementation: {
+        health: Observe.fromConstant(100),
+        stats: Observe.fromConstant({ hp: 100 }),
+        heal: (input) => { },
+        configure: (input) => { },
+    },
+});
+createFromConfig({
+    description: "Player health and actions for agentic access",
+    declaration: iface,
+    implementation: {
+        health: Observe.fromConstant(100),
+        stats: Observe.fromConstant({ hp: 100 }),
+        heal: (input) => { },
+        configure: (input) => { },
+        reset: () => { },
+    },
+    conditional: {
+        health: Observe.fromConstant(true),
+        // @ts-expect-error - conditional values must be Observe<boolean>
+        heal: Observe.fromConstant(1),
+    },
+});
+//# sourceMappingURL=create.interface-first-spike.type-test.js.map

package/dist/service/agentic-service/create.interface-first-spike.type-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.interface-first-spike.type-test.js","sourceRoot":"","sources":["../../../src/service/agentic-service/create.interface-first-spike.type-test.ts"],"names":[],"mappings":"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"}

package/dist/service/agentic-service/create.js

@@ -0,0 +1,85 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Observe } from "../../observe/index.js";
+function isStateDeclaration(entry) {
+    return "type" in entry && typeof entry.type === "string";
+}
+function getActionSchema(entry) {
+    if (isStateDeclaration(entry))
+        return false;
+    const actionEntry = entry;
+    return actionEntry.input ?? false;
+}
+/**
+ * Creates an AgenticService from a config with interface, implementation, and optional conditional.
+ *
+ * Interface: flat map of states (have `type`) and actions (have `description`, optional `input`).
+ * Implementation: same keys, states → Observe<...>, actions → (input?) => ...
+ * Conditional: optional per-key Observe<boolean> for enablement.
+ */
+export function create(config) {
+    const { interface: iface, implementation, conditional } = config;
+    const alwaysEnabled = Observe.fromConstant(true);
+    const stateKeys = [];
+    const actionKeys = [];
+    const stateSchemas = {};
+    const actionMeta = {};
+    for (const [key, entry] of Object.entries(iface)) {
+        if (isStateDeclaration(entry)) {
+            stateKeys.push(key);
+            stateSchemas[key] = entry;
+        }
+        else {
+            actionKeys.push(key);
+            const a = entry;
+            actionMeta[key] = {
+                description: a.description,
+                schema: getActionSchema(entry),
+                execute: implementation[key],
+            };
+        }
+    }
+    const perStateObservables = {};
+    for (const key of stateKeys) {
+        const valueObs = implementation[key];
+        const enabledObs = conditional?.[key] ?? alwaysEnabled;
+        perStateObservables[key] = Observe.fromProperties({
+            enabled: enabledObs,
+            value: valueObs,
+        });
+    }
+    const enabledObservables = {};
+    for (const key of actionKeys) {
+        enabledObservables[key] = conditional?.[key] ?? alwaysEnabled;
+    }
+    const states = Observe.withMap(Observe.fromProperties(perStateObservables), (raw) => {
+        const result = {};
+        for (const [key, entry] of Object.entries(raw)) {
+            const { enabled, value } = entry;
+            if (enabled) {
+                result[key] = { schema: stateSchemas[key], value };
+            }
+        }
+        return result;
+    });
+    const actions = Observe.withMap(Observe.fromProperties(enabledObservables), (enabledMap) => {
+        const result = {};
+        for (const [key, enabled] of Object.entries(enabledMap)) {
+            if (!enabled)
+                continue;
+            const meta = actionMeta[key];
+            if (meta)
+                result[key] = meta;
+        }
+        return result;
+    });
+    let currentActions = {};
+    actions((a) => { currentActions = a; });
+    const execute = async (actionName, input) => {
+        const entry = currentActions[actionName];
+        if (!entry)
+            return `Action "${actionName}" is not available`;
+        return entry.execute(input);
+    };
+    return { serviceName: "agentic-service", states, actions, execute };
+}
+//# sourceMappingURL=create.js.map

package/dist/service/agentic-service/create.js.map

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

package/dist/service/agentic-service/create.test.d.ts

@@ -0,0 +1 @@
+export {};