@adobe/data 0.9.28 → 0.9.30

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

@@ -0,0 +1,5 @@
+import type { AgenticService } from "./agentic-service.js";
+/** Map of link key → agentic service. In a separate file so declaration emit does not use a private name (TS4033/TS4049). */
+export type AgenticServiceLinks = {
+    [key: string]: AgenticService;
+};

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

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

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

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

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

@@ -2,15 +2,16 @@ 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 { AgenticServiceLinks } from "./agentic-service-links.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.
+ * Optional links expose other agentic services (e.g. parent, children)
+ * for navigation or delegation. Designed as a foundation for agentic
+ * systems; MCP or other agentic protocols can be built on this interface.
  */
 export interface AgenticService extends Service {
-    description: Observe<string>;
     states: Observe<{
         [key: string]: State;
     }>;
@@ -18,5 +19,7 @@ export interface AgenticService extends Service {
         [key: string]: Action;
     }>;
     execute: (action: string, input: unknown) => Promise<void | ActionError>;
+    /** When set, observable map of links to other agentic services (key → AgenticService). */
+    links?: Observe<AgenticServiceLinks>;
 }
 export * as AgenticService from "./public.js";

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

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

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

@@ -1,21 +1,24 @@
 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 & {
+/** State declaration: kind + schema for value + description */
+type StateDeclaration<S extends Schema = Schema> = {
+    type: "state";
+    schema: S;
     description: string;
 };
-/** Action declaration: `description`, optional `input` schema, no `type` */
+/** Action declaration: kind + description + optional input schema */
 type ActionDeclaration<I extends Schema | false | undefined = undefined> = {
+    type: "action";
     description: string;
     input?: I;
-    type?: never;
 };
-type DeclarationEntry = StateDeclaration | ActionDeclaration<Schema | false | undefined>;
+/** Link declaration: kind + optional description */
+type LinkDeclaration = {
+    type: "link";
+    description?: string;
+};
+type DeclarationEntry = StateDeclaration | ActionDeclaration<Schema | false | undefined> | LinkDeclaration;
 type Declarations = Record<string, DeclarationEntry>;
 type ConditionalFromDeclarations<D extends Declarations> = Partial<{
     [K in keyof D]: Observe<boolean>;
@@ -23,9 +26,11 @@ type ConditionalFromDeclarations<D extends Declarations> = Partial<{
 /**
  * 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.
+ * Interface: flat map of declarations. Each entry has type "state" | "action" | "link":
+ * - state: { type: "state", schema, description } → implementation: Observe<value>
+ * - action: { type: "action", description, input? } → implementation: (input?) => ...
+ * - link: { type: "link", description? } → implementation: AgenticService | Observe<AgenticService>
+ * Conditional: optional per-key Observe<boolean> for enablement (applies to states, actions, and links).
  */
 export declare function create<const D extends Declarations>(config: {
     description: string;
@@ -33,13 +38,17 @@ export declare function create<const D extends Declarations>(config: {
     implementation: ImplementationFromDeclarations<D>;
     conditional?: ConditionalFromDeclarations<D>;
 }): AgenticService;
-/** Implementation map derived from interface: states → Observe, actions → execute fn */
+/** Implementation map derived from interface: state → Observe, action → execute fn, link → AgenticService | Observe<AgenticService> */
 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: "state";
+        schema: infer S extends Schema;
+    } ? Observe<Schema.ToType<S>> : D[K] extends {
+        type: "action";
+        input?: infer I extends Schema | false | undefined;
+    } ? ExecuteFromSchema<I extends undefined ? false : I> : D[K] extends {
+        type: "link";
+    } ? AgenticService | Observe<AgenticService> : never;
 };
 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.js

@@ -1,42 +1,41 @@
 // © 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;
+    return entry.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.
+ * Interface: flat map of declarations. Each entry has type "state" | "action" | "link":
+ * - state: { type: "state", schema, description } → implementation: Observe<value>
+ * - action: { type: "action", description, input? } → implementation: (input?) => ...
+ * - link: { type: "link", description? } → implementation: AgenticService | Observe<AgenticService>
+ * Conditional: optional per-key Observe<boolean> for enablement (applies to states, actions, and links).
  */
 export function create(config) {
     const { interface: iface, implementation, conditional } = config;
     const alwaysEnabled = Observe.fromConstant(true);
     const stateKeys = [];
     const actionKeys = [];
+    const linkKeys = [];
     const stateSchemas = {};
     const actionMeta = {};
     for (const [key, entry] of Object.entries(iface)) {
-        if (isStateDeclaration(entry)) {
+        if (entry.type === "state") {
             stateKeys.push(key);
-            stateSchemas[key] = entry;
+            stateSchemas[key] = entry.schema;
         }
-        else {
+        else if (entry.type === "action") {
             actionKeys.push(key);
-            const a = entry;
             actionMeta[key] = {
-                description: a.description,
+                description: entry.description,
                 schema: getActionSchema(entry),
                 execute: implementation[key],
             };
         }
+        else if (entry.type === "link") {
+            linkKeys.push(key);
+        }
     }
     const perStateObservables = {};
     for (const key of stateKeys) {
@@ -51,6 +50,14 @@ export function create(config) {
     for (const key of actionKeys) {
         enabledObservables[key] = conditional?.[key] ?? alwaysEnabled;
     }
+    const implRecord = implementation;
+    const perLinkObservables = {};
+    for (const key of linkKeys) {
+        const raw = implRecord[key];
+        const linkObs = typeof raw === "function" ? raw : Observe.fromConstant(raw);
+        const enabledObs = conditional?.[key] ?? alwaysEnabled;
+        perLinkObservables[key] = Observe.withMap(Observe.fromProperties({ enabled: enabledObs, value: linkObs }), (x) => x);
+    }
     const states = Observe.withMap(Observe.fromProperties(perStateObservables), (raw) => {
         const result = {};
         for (const [key, entry] of Object.entries(raw)) {
@@ -80,6 +87,23 @@ export function create(config) {
             return `Action "${actionName}" is not available`;
         return entry.execute(input);
     };
-    return { serviceName: "agentic-service", states, actions, execute, description: Observe.fromConstant(config.description) };
+    const links = linkKeys.length > 0
+        ? Observe.withMap(Observe.fromProperties(perLinkObservables), (raw) => {
+            const result = {};
+            for (const [key, entry] of Object.entries(raw)) {
+                const { enabled, value } = entry;
+                if (enabled && value)
+                    result[key] = value;
+            }
+            return result;
+        })
+        : undefined;
+    return {
+        serviceName: "agentic-service",
+        states,
+        actions,
+        execute,
+        ...(links !== undefined && { links }),
+    };
 }
 //# sourceMappingURL=create.js.map

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

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

@@ -19,7 +19,7 @@ describe("AgenticService.create", () => {
             create({
                 description: "Test",
                 interface: {
-                    currentHealth: { type: "number", description: "Health" },
+                    currentHealth: { type: "state", schema: { type: "number" }, description: "Health" },
                 },
                 implementation: {
                     currentHealth: db.observe.resources.health,
@@ -32,7 +32,7 @@ describe("AgenticService.create", () => {
             create({
                 description: "Test",
                 interface: {
-                    playerName: { type: "string", description: "Name" },
+                    playerName: { type: "state", schema: { type: "string" }, description: "Name" },
                 },
                 implementation: {
                     playerName: db.observe.resources.name,
@@ -45,8 +45,8 @@ describe("AgenticService.create", () => {
             create({
                 description: "Test",
                 interface: {
-                    currentHealth: { type: "number", description: "Health" },
-                    playerName: { type: "string", description: "Name" },
+                    currentHealth: { type: "state", schema: { type: "number" }, description: "Health" },
+                    playerName: { type: "state", schema: { type: "string" }, description: "Name" },
                 },
                 implementation: {
                     currentHealth: db.observe.resources.health,
@@ -58,7 +58,7 @@ describe("AgenticService.create", () => {
             create({
                 description: "Test",
                 interface: {
-                    setHealth: { description: "Set health", input: { type: "number" } },
+                    setHealth: { type: "action", description: "Set health", input: { type: "number" } },
                 },
                 implementation: {
                     setHealth: async (_input) => { },
@@ -69,7 +69,7 @@ describe("AgenticService.create", () => {
             create({
                 description: "Test",
                 interface: {
-                    reset: { description: "Reset to defaults" },
+                    reset: { type: "action", description: "Reset to defaults" },
                 },
                 implementation: {
                     reset: async () => { },
@@ -81,14 +81,17 @@ describe("AgenticService.create", () => {
                 description: "Test",
                 interface: {
                     stats: {
-                        type: "object",
-                        description: "Stats",
-                        properties: {
-                            hp: { type: "number" },
-                            label: { type: "string" },
+                        type: "state",
+                        schema: {
+                            type: "object",
+                            properties: {
+                                hp: { type: "number" },
+                                label: { type: "string" },
+                            },
+                            required: ["hp"],
+                            additionalProperties: false,
                         },
-                        required: ["hp"],
-                        additionalProperties: false,
+                        description: "Stats",
                     },
                 },
                 implementation: {
@@ -101,6 +104,7 @@ describe("AgenticService.create", () => {
                 description: "Test",
                 interface: {
                     configure: {
+                        type: "action",
                         description: "Configure",
                         input: {
                             type: "object",
@@ -122,8 +126,8 @@ describe("AgenticService.create", () => {
             create({
                 description: "Test",
                 interface: {
-                    heal: { description: "Heal", input: { type: "number" } },
-                    reset: { description: "Reset" },
+                    heal: { type: "action", description: "Heal", input: { type: "number" } },
+                    reset: { type: "action", description: "Reset" },
                 },
                 implementation: {
                     heal: async (_amount) => { },
@@ -135,8 +139,8 @@ describe("AgenticService.create", () => {
             create({
                 description: "Test",
                 interface: {
-                    sync: { description: "Sync" },
-                    syncWithInput: { description: "Sync with input", input: { type: "number" } },
+                    sync: { type: "action", description: "Sync" },
+                    syncWithInput: { type: "action", description: "Sync with input", input: { type: "number" } },
                 },
                 implementation: {
                     sync: () => { },
@@ -149,8 +153,8 @@ describe("AgenticService.create", () => {
             create({
                 description: "Test",
                 interface: {
-                    health: { type: "number", description: "Health" },
-                    heal: { description: "Heal", input: { type: "number" } },
+                    health: { type: "state", schema: { type: "number" }, description: "Health" },
+                    heal: { type: "action", description: "Heal", input: { type: "number" } },
                 },
                 implementation: {
                     health: db.observe.resources.health,
@@ -169,13 +173,107 @@ describe("AgenticService.create", () => {
             expect(service.serviceName).toBe("agentic-service");
         });
     });
+    describe("links", () => {
+        it("should expose links observable when link is declared in interface", () => {
+            const child = create({
+                description: "Child",
+                interface: {},
+                implementation: {},
+            });
+            const service = create({
+                description: "Parent",
+                interface: { child: { type: "link", description: "Child service" } },
+                implementation: { child },
+            });
+            expect(service.links).toBeDefined();
+            const received = [];
+            service.links((l) => received.push({ ...l }));
+            expect(received).toHaveLength(1);
+            expect(received[0]).toEqual({ child });
+        });
+        it("should omit links when links config is omitted", () => {
+            const service = create({
+                description: "Test",
+                interface: {},
+                implementation: {},
+            });
+            expect(service.links).toBeUndefined();
+        });
+        it("should support Observe<AgenticService> per link for dynamic link target", () => {
+            const child = create({
+                description: "Child",
+                interface: {},
+                implementation: {},
+            });
+            const service = create({
+                description: "Parent",
+                interface: { child: { type: "link" } },
+                implementation: { child: Observe.fromConstant(child) },
+            });
+            expect(service.links).toBeDefined();
+            const received = [];
+            service.links((l) => received.push({ ...l }));
+            expect(received).toHaveLength(1);
+            expect(received[0]).toEqual({ child });
+        });
+        it("should omit link when conditional is false", () => {
+            const child = create({
+                description: "Child",
+                interface: {},
+                implementation: {},
+            });
+            const service = create({
+                description: "Parent",
+                interface: { child: { type: "link" } },
+                implementation: { child },
+                conditional: { child: Observe.fromConstant(false) },
+            });
+            expect(service.links).toBeDefined();
+            const received = [];
+            service.links((l) => received.push({ ...l }));
+            expect(received).toHaveLength(1);
+            expect(received[0]).toEqual({});
+        });
+        it("should update links when conditional changes", () => {
+            const child = create({
+                description: "Child",
+                interface: {},
+                implementation: {},
+            });
+            const [enabledObs, setEnabled] = Observe.createState(true);
+            const service = create({
+                description: "Parent",
+                interface: { child: { type: "link" } },
+                implementation: { child },
+                conditional: { child: enabledObs },
+            });
+            const received = [];
+            service.links((l) => received.push({ ...l }));
+            expect(received).toHaveLength(1);
+            expect(received[0]).toEqual({ child });
+            setEnabled(false);
+            expect(received).toHaveLength(2);
+            expect(received[1]).toEqual({});
+            setEnabled(true);
+            expect(received).toHaveLength(3);
+            expect(received[2]).toEqual({ child });
+        });
+        it("should have links undefined when no link keys in interface", () => {
+            const service = create({
+                description: "Test",
+                interface: {},
+                implementation: {},
+            });
+            expect(service.links).toBeUndefined();
+        });
+    });
     describe("conditional defaults", () => {
         it("should default state enabled to always true when omitted", async () => {
             const db = createTestDb();
             const service = create({
                 description: "Test",
                 interface: {
-                    health: { type: "number", description: "Health" },
+                    health: { type: "state", schema: { type: "number" }, description: "Health" },
                 },
                 implementation: {
                     health: db.observe.resources.health,
@@ -189,7 +287,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    heal: { description: "Heal", input: { type: "number" } },
+                    heal: { type: "action", description: "Heal", input: { type: "number" } },
                 },
                 implementation: {
                     heal: async () => { },
@@ -205,7 +303,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    currentHealth: { type: "number", description: "Health" },
+                    currentHealth: { type: "state", schema: { type: "number" }, description: "Health" },
                 },
                 implementation: {
                     currentHealth: db.observe.resources.health,
@@ -213,7 +311,7 @@ describe("AgenticService.create", () => {
             });
             const states = await Observe.toPromise(service.states);
             expect(states).toHaveProperty("currentHealth");
-            expect(states.currentHealth.schema).toEqual({ type: "number", description: "Health" });
+            expect(states.currentHealth.schema).toEqual({ type: "number" });
             expect(states.currentHealth.value).toBe(100);
         });
         it("should omit disabled states", async () => {
@@ -221,8 +319,8 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    visible: { type: "number", description: "Visible" },
-                    hidden: { type: "string", description: "Hidden" },
+                    visible: { type: "state", schema: { type: "number" }, description: "Visible" },
+                    hidden: { type: "state", schema: { type: "string" }, description: "Hidden" },
                 },
                 implementation: {
                     visible: db.observe.resources.health,
@@ -243,7 +341,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    health: { type: "number", description: "Health" },
+                    health: { type: "state", schema: { type: "number" }, description: "Health" },
                 },
                 implementation: {
                     health: db.observe.resources.health,
@@ -263,7 +361,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    health: { type: "number", description: "Health" },
+                    health: { type: "state", schema: { type: "number" }, description: "Health" },
                 },
                 implementation: {
                     health: healthObserve,
@@ -281,7 +379,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    heal: { description: "Heal player", input: { type: "number" } },
+                    heal: { type: "action", description: "Heal player", input: { type: "number" } },
                 },
                 implementation: {
                     heal: async (_amount) => { },
@@ -297,8 +395,8 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    available: { description: "Available", input: { type: "number" } },
-                    unavailable: { description: "Unavailable" },
+                    available: { type: "action", description: "Available", input: { type: "number" } },
+                    unavailable: { type: "action", description: "Unavailable" },
                 },
                 implementation: {
                     available: async () => { },
@@ -318,7 +416,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    heal: { description: "Heal", input: { type: "number" } },
+                    heal: { type: "action", description: "Heal", input: { type: "number" } },
                 },
                 implementation: {
                     heal: async () => { },
@@ -338,7 +436,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    setHealth: { description: "Set health", input: { type: "number" } },
+                    setHealth: { type: "action", description: "Set health", input: { type: "number" } },
                 },
                 implementation: {
                     setHealth: async (input) => { received = input; },
@@ -353,7 +451,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    reset: { description: "Reset" },
+                    reset: { type: "action", description: "Reset" },
                 },
                 implementation: {
                     reset: async () => { called = true; },
@@ -367,7 +465,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    sync: { description: "Sync" },
+                    sync: { type: "action", description: "Sync" },
                 },
                 implementation: {
                     sync: () => { called = true; },
@@ -380,7 +478,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    heal: { description: "Heal", input: { type: "number" } },
+                    heal: { type: "action", description: "Heal", input: { type: "number" } },
                 },
                 implementation: {
                     heal: async () => { },
@@ -403,7 +501,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    fail: { description: "Fail" },
+                    fail: { type: "action", description: "Fail" },
                 },
                 implementation: {
                     fail: async () => "something went wrong",
@@ -418,7 +516,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    heal: { description: "Heal", input: { type: "number" } },
+                    heal: { type: "action", description: "Heal", input: { type: "number" } },
                 },
                 implementation: {
                     heal: async () => { called = true; },
@@ -443,8 +541,8 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    health: { type: "number", description: "Health" },
-                    name: { type: "string", description: "Name" },
+                    health: { type: "state", schema: { type: "number" }, description: "Health" },
+                    name: { type: "state", schema: { type: "string" }, description: "Name" },
                 },
                 implementation: {
                     health: db.observe.resources.health,
@@ -470,8 +568,8 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    heal: { description: "Heal", input: { type: "number" } },
-                    reset: { description: "Reset" },
+                    heal: { type: "action", description: "Heal", input: { type: "number" } },
+                    reset: { type: "action", description: "Reset" },
                 },
                 implementation: {
                     heal: async () => { },
@@ -498,7 +596,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    heal: { description: "Heal", input: { type: "number" } },
+                    heal: { type: "action", description: "Heal", input: { type: "number" } },
                 },
                 implementation: {
                     heal: async (input) => { received = input; },
@@ -513,7 +611,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    reset: { description: "Reset" },
+                    reset: { type: "action", description: "Reset" },
                 },
                 implementation: {
                     reset: async () => { called = true; },
@@ -527,7 +625,7 @@ describe("AgenticService.create", () => {
             const service = create({
                 description: "Test",
                 interface: {
-                    fail: { description: "Fail" },
+                    fail: { type: "action", description: "Fail" },
                 },
                 implementation: {
                     fail: async () => "bound error",