@stigmer/react 0.0.68 → 0.0.70

package/demo/__tests__/samples.test.js

@@ -0,0 +1,152 @@
+import { describe, it, expect } from "vitest";
+import { ExecutionPhase, MessageType, ToolCallStatus, ExecutionArtifactKind } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/enum_pb";
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import { samples } from "../samples";
+describe("samples", () => {
+    describe("session", () => {
+        it("creates a session with defaults", () => {
+            const s = samples.session();
+            expect(s.apiVersion).toBe("agentic.stigmer.ai/v1");
+            expect(s.kind).toBe("Session");
+            expect(s.metadata?.name).toBe("demo-session");
+            expect(s.metadata?.org).toBe("demo");
+            expect(s.spec?.subject).toBe("Demo conversation");
+        });
+        it("applies overrides", () => {
+            const s = samples.session({ name: "my-chat", subject: "Custom topic", org: "acme" });
+            expect(s.metadata?.name).toBe("my-chat");
+            expect(s.metadata?.org).toBe("acme");
+            expect(s.spec?.subject).toBe("Custom topic");
+        });
+    });
+    describe("agent", () => {
+        it("creates an agent with defaults", () => {
+            const a = samples.agent();
+            expect(a.kind).toBe("Agent");
+            expect(a.metadata?.name).toBe("Demo Agent");
+            expect(a.spec?.description).toContain("sample agent");
+        });
+        it("derives slug from name override", () => {
+            const a = samples.agent({ name: "My Custom Agent" });
+            expect(a.metadata?.slug).toBe("my-custom-agent");
+        });
+    });
+    describe("agentExecution", () => {
+        it("creates a completed execution with default messages", () => {
+            const ex = samples.agentExecution();
+            expect(ex.kind).toBe("AgentExecution");
+            expect(ex.status?.phase).toBe(ExecutionPhase.EXECUTION_COMPLETED);
+            expect(ex.status?.messages.length).toBeGreaterThanOrEqual(2);
+        });
+        it("uses provided phase and messages", () => {
+            const msgs = [
+                samples.humanMessage("test input"),
+                samples.aiMessage("test response"),
+            ];
+            const ex = samples.agentExecution({
+                phase: ExecutionPhase.EXECUTION_IN_PROGRESS,
+                messages: msgs,
+            });
+            expect(ex.status?.phase).toBe(ExecutionPhase.EXECUTION_IN_PROGRESS);
+            expect(ex.status?.messages).toHaveLength(2);
+            expect(ex.status?.messages[0].content).toBe("test input");
+        });
+    });
+    describe("skill", () => {
+        it("creates a skill with SKILL.md content", () => {
+            const sk = samples.skill();
+            expect(sk.kind).toBe("Skill");
+            expect(sk.spec?.skillMd).toContain("# Demo Skill");
+        });
+        it("applies custom skillMd", () => {
+            const sk = samples.skill({ skillMd: "# My Skill\nCustom content" });
+            expect(sk.spec?.skillMd).toContain("# My Skill");
+        });
+    });
+    describe("mcpServer", () => {
+        it("creates an MCP server with defaults", () => {
+            const m = samples.mcpServer();
+            expect(m.kind).toBe("McpServer");
+            expect(m.metadata?.name).toBe("Demo MCP Server");
+        });
+    });
+    describe("environment", () => {
+        it("creates an environment with defaults", () => {
+            const e = samples.environment();
+            expect(e.kind).toBe("Environment");
+            expect(e.metadata?.name).toBe("demo-env");
+        });
+    });
+    describe("agentInstance", () => {
+        it("creates an agent instance referencing demo agent", () => {
+            const ai = samples.agentInstance();
+            expect(ai.kind).toBe("AgentInstance");
+            expect(ai.spec?.agentId).toContain("agt-");
+        });
+    });
+    describe("message primitives", () => {
+        it("humanMessage has correct type", () => {
+            const msg = samples.humanMessage("Hello");
+            expect(msg.type).toBe(MessageType.MESSAGE_HUMAN);
+            expect(msg.content).toBe("Hello");
+            expect(msg.timestamp).toBeTruthy();
+        });
+        it("aiMessage has correct type and optional tool calls", () => {
+            const tc = samples.toolCall("web-search", "results here");
+            const msg = samples.aiMessage("Here are the results", [tc]);
+            expect(msg.type).toBe(MessageType.MESSAGE_AI);
+            expect(msg.toolCalls).toHaveLength(1);
+            expect(msg.toolCalls[0].name).toBe("web-search");
+        });
+        it("toolCall is completed with a result", () => {
+            const tc = samples.toolCall("lookup-order", '{"orderId": "123"}');
+            expect(tc.status).toBe(ToolCallStatus.TOOL_CALL_COMPLETED);
+            expect(tc.name).toBe("lookup-order");
+            expect(tc.result).toBe('{"orderId": "123"}');
+        });
+        it("artifact defaults to FILE kind", () => {
+            const a = samples.artifact("report.md");
+            expect(a.name).toBe("report.md");
+            expect(a.kind).toBe(ExecutionArtifactKind.FILE);
+            expect(a.storageKey).toContain("demo-artifact-");
+        });
+    });
+    describe("list responses", () => {
+        it("sessionList wraps sessions", () => {
+            const list = samples.sessionList();
+            expect(list.entries).toHaveLength(1);
+            expect(list.totalPages).toBe(1);
+        });
+        it("sessionList accepts custom entries", () => {
+            const sessions = [
+                samples.session({ name: "s1" }),
+                samples.session({ name: "s2" }),
+            ];
+            const list = samples.sessionList(sessions);
+            expect(list.entries).toHaveLength(2);
+        });
+        it("agentExecutionList wraps executions", () => {
+            const list = samples.agentExecutionList();
+            expect(list.entries).toHaveLength(1);
+            expect(list.totalPages).toBe(1);
+        });
+        it("searchResponse wraps search results", () => {
+            const resp = samples.searchResponse();
+            expect(resp.entries).toHaveLength(1);
+            expect(resp.totalCount).toBe(1);
+            expect(resp.totalPages).toBe(1);
+        });
+        it("searchResult accepts overrides", () => {
+            const r = samples.searchResult({
+                kind: ApiResourceKind.skill,
+                name: "My Skill",
+                slug: "my-skill",
+                org: "acme",
+            });
+            expect(r.kind).toBe(ApiResourceKind.skill);
+            expect(r.name).toBe("My Skill");
+            expect(r.qualifiedSlug).toBe("acme/my-skill");
+        });
+    });
+});
+//# sourceMappingURL=samples.test.js.map

package/demo/__tests__/samples.test.js.map

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

package/demo/client.d.ts

@@ -0,0 +1,29 @@
+import type { Stigmer } from "@stigmer/sdk";
+import type { DemoScenario } from "./types";
+/**
+ * Create a `Stigmer`-compatible client backed by in-memory fixture data.
+ *
+ * The returned object is structurally identical to a real {@link Stigmer}
+ * instance — all 17 resource clients plus `search` and `github` — but
+ * every RPC resolves through a {@link DemoTransport} instead of a network
+ * connection. Pass it to `<StigmerProvider client={...}>` and all
+ * descendant hooks and components work without a live backend.
+ *
+ * RPCs that have no registered fixture throw a descriptive error
+ * identifying the missing key. Register fixtures in the
+ * {@link DemoScenario} to cover the RPCs your components need.
+ *
+ * @example
+ * ```tsx
+ * import { StigmerProvider } from "@stigmer/react";
+ * import { createDemoClient } from "@stigmer/react/demo";
+ *
+ * const client = createDemoClient({ fixtures: myScenarioFixtures });
+ *
+ * <StigmerProvider client={client}>
+ *   <App />
+ * </StigmerProvider>
+ * ```
+ */
+export declare function createDemoClient(scenario: DemoScenario): Stigmer;
+//# sourceMappingURL=client.d.ts.map

package/demo/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/demo/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAuB5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CA0BhE"}

package/demo/client.js

@@ -0,0 +1,52 @@
+import { AgentClient, AgentExecutionClient, AgentInstanceClient, ApiKeyClient, EnvironmentClient, ExecutionContextClient, GitHubClient, IamPolicyClient, IdentityAccountClient, IdentityProviderClient, McpServerClient, OrganizationClient, ProjectClient, SearchClient, SessionClient, SkillClient, WorkflowClient, WorkflowExecutionClient, WorkflowInstanceClient, } from "@stigmer/sdk";
+import { DemoTransport } from "./transport";
+/**
+ * Create a `Stigmer`-compatible client backed by in-memory fixture data.
+ *
+ * The returned object is structurally identical to a real {@link Stigmer}
+ * instance — all 17 resource clients plus `search` and `github` — but
+ * every RPC resolves through a {@link DemoTransport} instead of a network
+ * connection. Pass it to `<StigmerProvider client={...}>` and all
+ * descendant hooks and components work without a live backend.
+ *
+ * RPCs that have no registered fixture throw a descriptive error
+ * identifying the missing key. Register fixtures in the
+ * {@link DemoScenario} to cover the RPCs your components need.
+ *
+ * @example
+ * ```tsx
+ * import { StigmerProvider } from "@stigmer/react";
+ * import { createDemoClient } from "@stigmer/react/demo";
+ *
+ * const client = createDemoClient({ fixtures: myScenarioFixtures });
+ *
+ * <StigmerProvider client={client}>
+ *   <App />
+ * </StigmerProvider>
+ * ```
+ */
+export function createDemoClient(scenario) {
+    const transport = new DemoTransport(scenario.fixtures);
+    return {
+        agent: new AgentClient(transport),
+        agentExecution: new AgentExecutionClient(transport),
+        agentInstance: new AgentInstanceClient(transport),
+        apiKey: new ApiKeyClient(transport),
+        environment: new EnvironmentClient(transport),
+        executionContext: new ExecutionContextClient(transport),
+        iamPolicy: new IamPolicyClient(transport),
+        identityAccount: new IdentityAccountClient(transport),
+        identityProvider: new IdentityProviderClient(transport),
+        mcpServer: new McpServerClient(transport),
+        organization: new OrganizationClient(transport),
+        project: new ProjectClient(transport),
+        session: new SessionClient(transport),
+        skill: new SkillClient(transport),
+        workflow: new WorkflowClient(transport),
+        workflowExecution: new WorkflowExecutionClient(transport),
+        workflowInstance: new WorkflowInstanceClient(transport),
+        search: new SearchClient(transport),
+        github: new GitHubClient(transport),
+    };
+}
+//# sourceMappingURL=client.js.map

package/demo/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/demo/client.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAsB;IACrD,MAAM,SAAS,GAAG,IAAI,aAAa,CACjC,QAAQ,CAAC,QAAQ,CACM,CAAC;IAE1B,OAAO;QACL,KAAK,EAAE,IAAI,WAAW,CAAC,SAAS,CAAC;QACjC,cAAc,EAAE,IAAI,oBAAoB,CAAC,SAAS,CAAC;QACnD,aAAa,EAAE,IAAI,mBAAmB,CAAC,SAAS,CAAC;QACjD,MAAM,EAAE,IAAI,YAAY,CAAC,SAAS,CAAC;QACnC,WAAW,EAAE,IAAI,iBAAiB,CAAC,SAAS,CAAC;QAC7C,gBAAgB,EAAE,IAAI,sBAAsB,CAAC,SAAS,CAAC;QACvD,SAAS,EAAE,IAAI,eAAe,CAAC,SAAS,CAAC;QACzC,eAAe,EAAE,IAAI,qBAAqB,CAAC,SAAS,CAAC;QACrD,gBAAgB,EAAE,IAAI,sBAAsB,CAAC,SAAS,CAAC;QACvD,SAAS,EAAE,IAAI,eAAe,CAAC,SAAS,CAAC;QACzC,YAAY,EAAE,IAAI,kBAAkB,CAAC,SAAS,CAAC;QAC/C,OAAO,EAAE,IAAI,aAAa,CAAC,SAAS,CAAC;QACrC,OAAO,EAAE,IAAI,aAAa,CAAC,SAAS,CAAC;QACrC,KAAK,EAAE,IAAI,WAAW,CAAC,SAAS,CAAC;QACjC,QAAQ,EAAE,IAAI,cAAc,CAAC,SAAS,CAAC;QACvC,iBAAiB,EAAE,IAAI,uBAAuB,CAAC,SAAS,CAAC;QACzD,gBAAgB,EAAE,IAAI,sBAAsB,CAAC,SAAS,CAAC;QACvD,MAAM,EAAE,IAAI,YAAY,CAAC,SAAS,CAAC;QACnC,MAAM,EAAE,IAAI,YAAY,CAAC,SAAS,CAAC;KACzB,CAAC;AACf,CAAC"}

package/demo/fixtures.d.ts

@@ -0,0 +1,190 @@
+import { ApiResourceKind } from "@stigmer/protos/ai/stigmer/commons/apiresource/apiresourcekind/api_resource_kind_pb";
+import type { DemoScenario, FixtureEntry, StreamFixtureHandler, UnaryFixtureHandler } from "./types";
+/**
+ * A fixture specification returned by fixture entry helpers.
+ *
+ * Pass one or more specs to {@link buildScenario} to construct a
+ * {@link DemoScenario} ready for {@link createDemoClient}.
+ *
+ * The `searchResourceKind` field is set automatically by search-backed
+ * helpers (`fixtures.agent.list`, `fixtures.skill.list`,
+ * `fixtures.mcpServer.list`). Do not set it manually.
+ */
+export interface FixtureSpec {
+    readonly key: string;
+    readonly entry: FixtureEntry;
+    readonly searchResourceKind?: ApiResourceKind;
+}
+/**
+ * Fixture entry helpers mirroring the `Stigmer` SDK client shape.
+ *
+ * Each method wraps a user-provided handler into a {@link FixtureSpec}
+ * that {@link buildScenario} assembles into a {@link DemoScenario}.
+ *
+ * Method names match the SDK client methods (e.g. `fixtures.session.get`
+ * mirrors `client.session.get`). JSDoc on each method documents which
+ * React hooks consume that RPC.
+ *
+ * @example
+ * ```ts
+ * import { fixtures, buildScenario, createDemoClient } from "@stigmer/react/demo";
+ *
+ * const scenario = buildScenario(
+ *   fixtures.session.get(() => mySession),
+ *   fixtures.agentExecution.listBySession(() => myExecutionList),
+ *   fixtures.agentExecution.subscribe(() => [snapshot1, snapshot2]),
+ * );
+ * const client = createDemoClient(scenario);
+ * ```
+ */
+export declare const fixtures: {
+    readonly session: {
+        /** Hooks: `useSession`, `useSessionConversation` */
+        readonly get: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useSessionList` */
+        readonly list: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useCreateSession`, `useTriggerApprovalPolicySession` */
+        readonly create: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useUpdateSession`, `useSessionConversation` */
+        readonly update: (handler: UnaryFixtureHandler) => FixtureSpec;
+    };
+    readonly agentExecution: {
+        /** Hooks: `useCreateAgentExecution`, `useTriggerApprovalPolicySession` */
+        readonly create: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useSessionExecutions`, `useSessionConversation` */
+        readonly listBySession: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /**
+         * Hooks: `useExecutionStream`, `useSessionConversation`
+         *
+         * The handler returns an **array** of `AgentExecution` snapshots that
+         * the transport yields as a server stream.
+         */
+        readonly subscribe: (handler: StreamFixtureHandler) => FixtureSpec;
+        /** Hooks: `useSubmitApproval`, `useSessionConversation` */
+        readonly submitApproval: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useArtifactContent`, `useDetectSkillPackage` */
+        readonly getArtifactContent: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useAttachments`, `useTriggerApprovalPolicySession` */
+        readonly uploadAttachment: (handler: UnaryFixtureHandler) => FixtureSpec;
+    };
+    readonly agent: {
+        /** Hooks: `useAgentRefFromSession` */
+        readonly get: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useAgent`, `useCreateSession`, `useAgentSetup`, `useTriggerApprovalPolicySession` */
+        readonly getByReference: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useDefaultAgent` */
+        readonly getDefault: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /**
+         * Hooks: `useAgentList`, `useAgentSearch`, `useAgentCount`
+         *
+         * Routes through `SearchService` — use {@link buildScenario} to avoid
+         * key collisions with `fixtures.skill.list` and `fixtures.mcpServer.list`.
+         */
+        readonly list: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useApplyResource` */
+        readonly apply: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useUpdateVisibility` (when kind is Agent) */
+        readonly updateVisibility: (handler: UnaryFixtureHandler) => FixtureSpec;
+    };
+    readonly skill: {
+        /** Hooks: `useSkill` */
+        readonly getByReference: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /**
+         * Hooks: `useSkillList`, `useSkillSearch`, `useSkillCount`
+         *
+         * Routes through `SearchService` — use {@link buildScenario} to avoid
+         * key collisions with `fixtures.agent.list` and `fixtures.mcpServer.list`.
+         */
+        readonly list: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useApplyResource` (when kind is Skill) */
+        readonly pushFromExecutionArtifact: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useUpdateVisibility` (when kind is Skill) */
+        readonly updateVisibility: (handler: UnaryFixtureHandler) => FixtureSpec;
+    };
+    readonly mcpServer: {
+        /** Hooks: `useMcpServer`, `useMcpServerSetup` */
+        readonly getByReference: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /**
+         * Hooks: `useMcpServerList`, `useMcpServerSearch`, `useMcpServerCount`
+         *
+         * Routes through `SearchService` — use {@link buildScenario} to avoid
+         * key collisions with `fixtures.agent.list` and `fixtures.skill.list`.
+         */
+        readonly list: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useDiscoverCapabilities` */
+        readonly discoverCapabilities: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useApplyResource` (when kind is McpServer) */
+        readonly apply: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useUpdateVisibility` (when kind is McpServer) */
+        readonly updateVisibility: (handler: UnaryFixtureHandler) => FixtureSpec;
+    };
+    readonly environment: {
+        /** Components: `EnvironmentVariableEditor` */
+        readonly get: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useEnvironment` */
+        readonly getByReference: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useEnvironmentList`, `usePersonalEnvironment`, `useTriggerApprovalPolicySession` */
+        readonly list: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useCreateEnvironment`, `usePersonalEnvironment` */
+        readonly create: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useUpdateEnvironment` */
+        readonly update: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useUpdateEnvironmentVariables`, `usePersonalEnvironment` */
+        readonly updateVariables: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useRemoveEnvironmentVariables`, `usePersonalEnvironment` */
+        readonly removeVariables: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useRevealSecretValue`, `useGitHubConnection` */
+        readonly getSecretValue: (handler: UnaryFixtureHandler) => FixtureSpec;
+    };
+    readonly agentInstance: {
+        /** Hooks: `useAgentRefFromSession` */
+        readonly get: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useAgentInstance` */
+        readonly getByReference: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useAgentInstanceList`, `useAgentSetup`, `useTriggerApprovalPolicySession` */
+        readonly list: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useCreateAgentInstance`, `usePersonalAgentInstance`, `useAgentSetup`, `useTriggerApprovalPolicySession` */
+        readonly create: (handler: UnaryFixtureHandler) => FixtureSpec;
+    };
+    readonly organization: {
+        /** Hooks: `useCreateOrganization` */
+        readonly create: (handler: UnaryFixtureHandler) => FixtureSpec;
+    };
+    readonly apiKey: {
+        /** Hooks: `useApiKeyList` */
+        readonly findAll: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useCreateApiKey` */
+        readonly create: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useDeleteApiKey` */
+        readonly delete: (handler: UnaryFixtureHandler) => FixtureSpec;
+    };
+    readonly github: {
+        /** Hooks: `useGitHubConnection` */
+        readonly getOAuthAuthorizeUrl: (handler: UnaryFixtureHandler) => FixtureSpec;
+        /** Hooks: `useGitHubConnection` */
+        readonly exchangeOAuthCode: (handler: UnaryFixtureHandler) => FixtureSpec;
+    };
+};
+/**
+ * Assemble {@link FixtureSpec} entries into a {@link DemoScenario}.
+ *
+ * This is the recommended way to construct scenarios because it correctly
+ * merges search-backed list fixtures (`agent.list`, `skill.list`,
+ * `mcpServer.list`) that share the same underlying `SearchService` RPC.
+ * Using `new Map([...])` directly with these helpers would cause silent
+ * key collisions where the last entry wins.
+ *
+ * @example
+ * ```ts
+ * import { fixtures, buildScenario, createDemoClient } from "@stigmer/react/demo";
+ *
+ * const scenario = buildScenario(
+ *   fixtures.session.get(() => mySession),
+ *   fixtures.agent.list(() => myAgentSearchResponse),
+ *   fixtures.skill.list(() => mySkillSearchResponse),
+ * );
+ * const client = createDemoClient(scenario);
+ * ```
+ */
+export declare function buildScenario(...specs: FixtureSpec[]): DemoScenario;
+//# sourceMappingURL=fixtures.d.ts.map

package/demo/fixtures.d.ts.map

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