@ohos-ports/genkit 1.42.0-beta.0

package/lib/beta.js

@@ -0,0 +1,88 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var beta_exports = {};
+__export(beta_exports, {
+  AgentError: () => import_agent.AgentError,
+  AgentInitSchema: () => import_ai.AgentInitSchema,
+  AgentInputSchema: () => import_ai.AgentInputSchema,
+  AgentOutputSchema: () => import_ai.AgentOutputSchema,
+  AgentStreamChunkSchema: () => import_ai.AgentStreamChunkSchema,
+  AsyncTaskQueue: () => import_async.AsyncTaskQueue,
+  FileSessionStore: () => import_genkit_beta.FileSessionStore,
+  GenkitBeta: () => import_genkit_beta.GenkitBeta,
+  InMemorySessionStore: () => import_genkit_beta.InMemorySessionStore,
+  InMemoryStreamManager: () => import_core.InMemoryStreamManager,
+  Session: () => import_session.Session,
+  SessionRunner: () => import_genkit_beta.SessionRunner,
+  StreamNotFoundError: () => import_core.StreamNotFoundError,
+  applyPatch: () => import_genkit_beta.applyPatch,
+  diff: () => import_genkit_beta.diff,
+  genkit: () => import_genkit_beta.genkit,
+  lazy: () => import_async.lazy,
+  remoteAgent: () => import_agent.remoteAgent
+});
+module.exports = __toCommonJS(beta_exports);
+var import_ai = require("@genkit-ai/ai");
+var import_session = require("@genkit-ai/ai/session");
+var import_agent = require("./client/agent.js");
+var import_core = require("@genkit-ai/core");
+var import_async = require("@genkit-ai/core/async");
+__reExport(beta_exports, require("./common.js"), module.exports);
+var import_genkit_beta = require("./genkit-beta.js");
+/**
+ * @license
+ *
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentError,
+  AgentInitSchema,
+  AgentInputSchema,
+  AgentOutputSchema,
+  AgentStreamChunkSchema,
+  AsyncTaskQueue,
+  FileSessionStore,
+  GenkitBeta,
+  InMemorySessionStore,
+  InMemoryStreamManager,
+  Session,
+  SessionRunner,
+  StreamNotFoundError,
+  applyPatch,
+  diff,
+  genkit,
+  lazy,
+  remoteAgent,
+  ...require("./common.js")
+});
+//# sourceMappingURL=beta.js.map

package/lib/beta.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/beta.ts"],"sourcesContent":["/**\n * @license\n *\n * Copyright 2025 Google LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Beta features including interrupts, stream managers, and the experimental\n * {@link GenkitBeta} class.\n *\n * ```ts\n * import { genkit } from 'genkit/beta';\n * ```\n *\n * @module beta\n */\n\nexport {\n  AgentInitSchema,\n  AgentInputSchema,\n  AgentOutputSchema,\n  AgentStreamChunkSchema,\n  type AgentInit,\n  type AgentInput,\n  type AgentOutput,\n} from '@genkit-ai/ai';\nexport { Session, type Artifact } from '@genkit-ai/ai/session';\nexport {\n  AgentError,\n  remoteAgent,\n  type AgentAPI,\n  type AgentChat,\n  type AgentChunk,\n  type AgentInterrupt,\n  type AgentResponse,\n  type AgentTurn,\n  type DetachedTask,\n  type RemoteAgentOptions,\n} from './client/agent.js';\n\nexport type { AgentFinishReason } from './client/types.js';\n\nexport {\n  InMemoryStreamManager,\n  StreamNotFoundError,\n  type ActionStreamInput,\n  type ActionStreamSubscriber,\n  type StreamManager,\n} from '@genkit-ai/core';\nexport { AsyncTaskQueue, lazy } from '@genkit-ai/core/async';\nexport * from './common.js';\nexport {\n  FileSessionStore,\n  GenkitBeta,\n  InMemorySessionStore,\n  SessionRunner,\n  applyPatch,\n  diff,\n  genkit,\n  type Agent,\n  type AgentFn,\n  type AgentStreamChunk,\n  type ClientTransform,\n  type GenkitBetaOptions,\n  type JsonPatch,\n  type JsonPatchOperation,\n  type SessionSnapshot,\n  type SessionSnapshotInput,\n  type SessionState,\n  type SessionStore,\n  type SessionStoreOptions,\n  type SnapshotMutator,\n} from './genkit-beta.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA6BA,gBAQO;AACP,qBAAuC;AACvC,mBAWO;AAIP,kBAMO;AACP,mBAAqC;AACrC,yBAAc,wBA9Dd;AA+DA,yBAqBO;AApFP;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;","names":[]}

package/lib/beta.mjs

@@ -0,0 +1,64 @@
+/**
+ * @license
+ *
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import {
+  AgentInitSchema,
+  AgentInputSchema,
+  AgentOutputSchema,
+  AgentStreamChunkSchema
+} from "@genkit-ai/ai";
+import { Session } from "@genkit-ai/ai/session";
+import {
+  AgentError,
+  remoteAgent
+} from "./client/agent.mjs";
+import {
+  InMemoryStreamManager,
+  StreamNotFoundError
+} from "@genkit-ai/core";
+import { AsyncTaskQueue, lazy } from "@genkit-ai/core/async";
+export * from "./common.mjs";
+import {
+  FileSessionStore,
+  GenkitBeta,
+  InMemorySessionStore,
+  SessionRunner,
+  applyPatch,
+  diff,
+  genkit
+} from "./genkit-beta.mjs";
+export {
+  AgentError,
+  AgentInitSchema,
+  AgentInputSchema,
+  AgentOutputSchema,
+  AgentStreamChunkSchema,
+  AsyncTaskQueue,
+  FileSessionStore,
+  GenkitBeta,
+  InMemorySessionStore,
+  InMemoryStreamManager,
+  Session,
+  SessionRunner,
+  StreamNotFoundError,
+  applyPatch,
+  diff,
+  genkit,
+  lazy,
+  remoteAgent
+};
+//# sourceMappingURL=beta.mjs.map

package/lib/beta.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/beta.ts"],"sourcesContent":["/**\n * @license\n *\n * Copyright 2025 Google LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/**\n * Beta features including interrupts, stream managers, and the experimental\n * {@link GenkitBeta} class.\n *\n * ```ts\n * import { genkit } from 'genkit/beta';\n * ```\n *\n * @module beta\n */\n\nexport {\n  AgentInitSchema,\n  AgentInputSchema,\n  AgentOutputSchema,\n  AgentStreamChunkSchema,\n  type AgentInit,\n  type AgentInput,\n  type AgentOutput,\n} from '@genkit-ai/ai';\nexport { Session, type Artifact } from '@genkit-ai/ai/session';\nexport {\n  AgentError,\n  remoteAgent,\n  type AgentAPI,\n  type AgentChat,\n  type AgentChunk,\n  type AgentInterrupt,\n  type AgentResponse,\n  type AgentTurn,\n  type DetachedTask,\n  type RemoteAgentOptions,\n} from './client/agent.mjs';\n\nexport type { AgentFinishReason } from './client/types.mjs';\n\nexport {\n  InMemoryStreamManager,\n  StreamNotFoundError,\n  type ActionStreamInput,\n  type ActionStreamSubscriber,\n  type StreamManager,\n} from '@genkit-ai/core';\nexport { AsyncTaskQueue, lazy } from '@genkit-ai/core/async';\nexport * from './common.mjs';\nexport {\n  FileSessionStore,\n  GenkitBeta,\n  InMemorySessionStore,\n  SessionRunner,\n  applyPatch,\n  diff,\n  genkit,\n  type Agent,\n  type AgentFn,\n  type AgentStreamChunk,\n  type ClientTransform,\n  type GenkitBetaOptions,\n  type JsonPatch,\n  type JsonPatchOperation,\n  type SessionSnapshot,\n  type SessionSnapshotInput,\n  type SessionState,\n  type SessionStore,\n  type SessionStoreOptions,\n  type SnapshotMutator,\n} from './genkit-beta.mjs';\n"],"mappings":"AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA6BA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,SAAS,eAA8B;AACvC;AAAA,EACE;AAAA,EACA;AAAA,OASK;AAIP;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AACP,SAAS,gBAAgB,YAAY;AACrC,cAAc;AACd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAcK;","names":[]}

package/lib/client/agent.d.mts

@@ -0,0 +1,52 @@
+import { AgentAPI } from '@genkit-ai/ai/agent-core';
+export { AgentAPI, AgentChat, AgentChunk, AgentError, AgentInterrupt, AgentResponse, AgentTurn, DetachedTask } from '@genkit-ai/ai/agent-core';
+export { JsonPatch, applyPatch } from '@genkit-ai/ai/json-patch';
+
+/**
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * Options for {@link remoteAgent}.
+ */
+interface RemoteAgentOptions {
+    /** Required. The agent endpoint. */
+    url: string;
+    /** Optional. Defaults to `${url}/getSnapshot`. */
+    getSnapshotUrl?: string;
+    /** Optional. Defaults to `${url}/abort`. */
+    abortUrl?: string;
+    /** Optional. Static headers, or a function called per request. */
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+    /** Optional. Declares server- vs client-managed state; inferred otherwise. */
+    stateManagement?: 'server' | 'client';
+}
+/**
+ * Creates a typed client for talking to a Genkit agent over HTTP.
+ *
+ * ```ts
+ * import { remoteAgent } from 'genkit/beta/client';
+ *
+ * const agent = remoteAgent<WeatherState>({
+ *   url: '/api/weatherAgent',
+ * });
+ * const chat = agent.chat();
+ * const res = await chat.send('Weather in Tokyo?').response;
+ * console.log(res.text);
+ * ```
+ */
+declare function remoteAgent<State = unknown>(options: RemoteAgentOptions): AgentAPI<State>;
+
+export { type RemoteAgentOptions, remoteAgent };

package/lib/client/agent.d.ts

@@ -0,0 +1,52 @@
+import { AgentAPI } from '@genkit-ai/ai/agent-core';
+export { AgentAPI, AgentChat, AgentChunk, AgentError, AgentInterrupt, AgentResponse, AgentTurn, DetachedTask } from '@genkit-ai/ai/agent-core';
+export { JsonPatch, applyPatch } from '@genkit-ai/ai/json-patch';
+
+/**
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * Options for {@link remoteAgent}.
+ */
+interface RemoteAgentOptions {
+    /** Required. The agent endpoint. */
+    url: string;
+    /** Optional. Defaults to `${url}/getSnapshot`. */
+    getSnapshotUrl?: string;
+    /** Optional. Defaults to `${url}/abort`. */
+    abortUrl?: string;
+    /** Optional. Static headers, or a function called per request. */
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+    /** Optional. Declares server- vs client-managed state; inferred otherwise. */
+    stateManagement?: 'server' | 'client';
+}
+/**
+ * Creates a typed client for talking to a Genkit agent over HTTP.
+ *
+ * ```ts
+ * import { remoteAgent } from 'genkit/beta/client';
+ *
+ * const agent = remoteAgent<WeatherState>({
+ *   url: '/api/weatherAgent',
+ * });
+ * const chat = agent.chat();
+ * const res = await chat.send('Weather in Tokyo?').response;
+ * console.log(res.text);
+ * ```
+ */
+declare function remoteAgent<State = unknown>(options: RemoteAgentOptions): AgentAPI<State>;
+
+export { type RemoteAgentOptions, remoteAgent };

package/lib/client/agent.js

@@ -0,0 +1,90 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var agent_exports = {};
+__export(agent_exports, {
+  AgentError: () => import_agent_core2.AgentError,
+  applyPatch: () => import_json_patch.applyPatch,
+  remoteAgent: () => remoteAgent
+});
+module.exports = __toCommonJS(agent_exports);
+var import_agent_core = require("@genkit-ai/ai/agent-core");
+var import_client = require("./client.js");
+var import_agent_core2 = require("@genkit-ai/ai/agent-core");
+var import_json_patch = require("@genkit-ai/ai/json-patch");
+function remoteAgent(options) {
+  const { url } = options;
+  const getSnapshotUrl = options.getSnapshotUrl ?? `${url}/getSnapshot`;
+  const abortUrl = options.abortUrl ?? `${url}/abort`;
+  const resolveHeaders = async () => {
+    if (!options.headers) return void 0;
+    if (typeof options.headers === "function") {
+      return options.headers();
+    }
+    return options.headers;
+  };
+  const transport = {
+    stateManagement: options.stateManagement,
+    runTurn(input, init, opts) {
+      const started = (async () => {
+        const headers = await resolveHeaders();
+        return (0, import_client.streamFlow)({
+          url,
+          input,
+          init,
+          headers,
+          abortSignal: opts.abortSignal
+        });
+      })();
+      const output = (async () => {
+        const { output: output2 } = await started;
+        return output2;
+      })();
+      const stream = (async function* () {
+        const { stream: rawStream } = await started;
+        yield* rawStream;
+      })();
+      return { stream, output };
+    },
+    async getSnapshot(lookup) {
+      const headers = await resolveHeaders();
+      return (0, import_client.runFlow)({
+        url: getSnapshotUrl,
+        input: lookup,
+        headers
+      });
+    },
+    async abort(snapshotId) {
+      const headers = await resolveHeaders();
+      const result = await (0, import_client.runFlow)({
+        url: abortUrl,
+        input: { snapshotId },
+        headers
+      });
+      return result?.status;
+    }
+  };
+  return (0, import_agent_core.createAgentAPI)(transport);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AgentError,
+  applyPatch,
+  remoteAgent
+});
+//# sourceMappingURL=agent.js.map

package/lib/client/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/agent.ts"],"sourcesContent":["/**\n * Copyright 2026 Google LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  createAgentAPI,\n  type AgentAPI,\n  type AgentTransport,\n  type SnapshotLookup,\n} from '@genkit-ai/ai/agent-core';\n\nimport type {\n  AgentInit,\n  AgentInput,\n  AgentOutput,\n  AgentStreamChunk,\n} from '@genkit-ai/ai';\nimport type { SessionSnapshot } from '@genkit-ai/ai/session';\nimport { runFlow, streamFlow } from './client.js';\n\n// Re-export the transport-agnostic agent-client surface so existing imports\n// from `genkit/beta/client` keep working.\nexport {\n  AgentError,\n  type AgentAPI,\n  type AgentChat,\n  type AgentChunk,\n  type AgentInterrupt,\n  type AgentResponse,\n  type AgentTurn,\n  type DetachedTask,\n} from '@genkit-ai/ai/agent-core';\n\n// Re-export the JSON Patch helper so apps can apply a chunk's `customPatch` to\n// their own locally tracked copy of the agent's custom state.\nexport { applyPatch, type JsonPatch } from '@genkit-ai/ai/json-patch';\n\n/**\n * Options for {@link remoteAgent}.\n */\nexport interface RemoteAgentOptions {\n  /** Required. The agent endpoint. */\n  url: string;\n  /** Optional. Defaults to `${url}/getSnapshot`. */\n  getSnapshotUrl?: string;\n  /** Optional. Defaults to `${url}/abort`. */\n  abortUrl?: string;\n  /** Optional. Static headers, or a function called per request. */\n  headers?:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>);\n  /** Optional. Declares server- vs client-managed state; inferred otherwise. */\n  stateManagement?: 'server' | 'client';\n}\n\n// ---------------------------------------------------------------------------\n// remoteAgent factory\n// ---------------------------------------------------------------------------\n\n/**\n * Creates a typed client for talking to a Genkit agent over HTTP.\n *\n * ```ts\n * import { remoteAgent } from 'genkit/beta/client';\n *\n * const agent = remoteAgent<WeatherState>({\n *   url: '/api/weatherAgent',\n * });\n * const chat = agent.chat();\n * const res = await chat.send('Weather in Tokyo?').response;\n * console.log(res.text);\n * ```\n */\nexport function remoteAgent<State = unknown>(\n  options: RemoteAgentOptions\n): AgentAPI<State> {\n  const { url } = options;\n  const getSnapshotUrl = options.getSnapshotUrl ?? `${url}/getSnapshot`;\n  const abortUrl = options.abortUrl ?? `${url}/abort`;\n\n  const resolveHeaders = async (): Promise<\n    Record<string, string> | undefined\n  > => {\n    if (!options.headers) return undefined;\n    if (typeof options.headers === 'function') {\n      return options.headers();\n    }\n    return options.headers;\n  };\n\n  const transport: AgentTransport = {\n    stateManagement: options.stateManagement,\n\n    runTurn(\n      input: AgentInput,\n      init: AgentInit,\n      opts: { abortSignal: AbortSignal }\n    ) {\n      // Kick off the request lazily so headers can be resolved asynchronously.\n      const started = (async () => {\n        const headers = await resolveHeaders();\n        return streamFlow<AgentOutput, AgentStreamChunk, AgentInit>({\n          url,\n          input,\n          init,\n          headers,\n          abortSignal: opts.abortSignal,\n        });\n      })();\n\n      const output = (async () => {\n        const { output } = await started;\n        return output;\n      })();\n\n      const stream = (async function* (): AsyncIterable<AgentStreamChunk> {\n        const { stream: rawStream } = await started;\n        yield* rawStream;\n      })();\n\n      return { stream, output };\n    },\n\n    async getSnapshot(lookup: SnapshotLookup) {\n      const headers = await resolveHeaders();\n      return runFlow<SessionSnapshot<State> | undefined>({\n        url: getSnapshotUrl,\n        input: lookup,\n        headers,\n      });\n    },\n\n    async abort(snapshotId: string) {\n      const headers = await resolveHeaders();\n      const result = await runFlow<{\n        snapshotId: string;\n        status?: SessionSnapshot['status'];\n      }>({\n        url: abortUrl,\n        input: { snapshotId },\n        headers,\n      });\n      return result?.status;\n    },\n  };\n\n  return createAgentAPI<State>(transport);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,wBAKO;AASP,oBAAoC;AAIpC,IAAAA,qBASO;AAIP,wBAA2C;AAsCpC,SAAS,YACd,SACiB;AACjB,QAAM,EAAE,IAAI,IAAI;AAChB,QAAM,iBAAiB,QAAQ,kBAAkB,GAAG,GAAG;AACvD,QAAM,WAAW,QAAQ,YAAY,GAAG,GAAG;AAE3C,QAAM,iBAAiB,YAElB;AACH,QAAI,CAAC,QAAQ,QAAS,QAAO;AAC7B,QAAI,OAAO,QAAQ,YAAY,YAAY;AACzC,aAAO,QAAQ,QAAQ;AAAA,IACzB;AACA,WAAO,QAAQ;AAAA,EACjB;AAEA,QAAM,YAA4B;AAAA,IAChC,iBAAiB,QAAQ;AAAA,IAEzB,QACE,OACA,MACA,MACA;AAEA,YAAM,WAAW,YAAY;AAC3B,cAAM,UAAU,MAAM,eAAe;AACrC,mBAAO,0BAAqD;AAAA,UAC1D;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA,aAAa,KAAK;AAAA,QACpB,CAAC;AAAA,MACH,GAAG;AAEH,YAAM,UAAU,YAAY;AAC1B,cAAM,EAAE,QAAAC,QAAO,IAAI,MAAM;AACzB,eAAOA;AAAA,MACT,GAAG;AAEH,YAAM,UAAU,mBAAoD;AAClE,cAAM,EAAE,QAAQ,UAAU,IAAI,MAAM;AACpC,eAAO;AAAA,MACT,GAAG;AAEH,aAAO,EAAE,QAAQ,OAAO;AAAA,IAC1B;AAAA,IAEA,MAAM,YAAY,QAAwB;AACxC,YAAM,UAAU,MAAM,eAAe;AACrC,iBAAO,uBAA4C;AAAA,QACjD,KAAK;AAAA,QACL,OAAO;AAAA,QACP;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IAEA,MAAM,MAAM,YAAoB;AAC9B,YAAM,UAAU,MAAM,eAAe;AACrC,YAAM,SAAS,UAAM,uBAGlB;AAAA,QACD,KAAK;AAAA,QACL,OAAO,EAAE,WAAW;AAAA,QACpB;AAAA,MACF,CAAC;AACD,aAAO,QAAQ;AAAA,IACjB;AAAA,EACF;AAEA,aAAO,kCAAsB,SAAS;AACxC;","names":["import_agent_core","output"]}

package/lib/client/agent.mjs

@@ -0,0 +1,68 @@
+import {
+  createAgentAPI
+} from "@genkit-ai/ai/agent-core";
+import { runFlow, streamFlow } from "./client.mjs";
+import {
+  AgentError
+} from "@genkit-ai/ai/agent-core";
+import { applyPatch } from "@genkit-ai/ai/json-patch";
+function remoteAgent(options) {
+  const { url } = options;
+  const getSnapshotUrl = options.getSnapshotUrl ?? `${url}/getSnapshot`;
+  const abortUrl = options.abortUrl ?? `${url}/abort`;
+  const resolveHeaders = async () => {
+    if (!options.headers) return void 0;
+    if (typeof options.headers === "function") {
+      return options.headers();
+    }
+    return options.headers;
+  };
+  const transport = {
+    stateManagement: options.stateManagement,
+    runTurn(input, init, opts) {
+      const started = (async () => {
+        const headers = await resolveHeaders();
+        return streamFlow({
+          url,
+          input,
+          init,
+          headers,
+          abortSignal: opts.abortSignal
+        });
+      })();
+      const output = (async () => {
+        const { output: output2 } = await started;
+        return output2;
+      })();
+      const stream = (async function* () {
+        const { stream: rawStream } = await started;
+        yield* rawStream;
+      })();
+      return { stream, output };
+    },
+    async getSnapshot(lookup) {
+      const headers = await resolveHeaders();
+      return runFlow({
+        url: getSnapshotUrl,
+        input: lookup,
+        headers
+      });
+    },
+    async abort(snapshotId) {
+      const headers = await resolveHeaders();
+      const result = await runFlow({
+        url: abortUrl,
+        input: { snapshotId },
+        headers
+      });
+      return result?.status;
+    }
+  };
+  return createAgentAPI(transport);
+}
+export {
+  AgentError,
+  applyPatch,
+  remoteAgent
+};
+//# sourceMappingURL=agent.mjs.map

package/lib/client/agent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/agent.ts"],"sourcesContent":["/**\n * Copyright 2026 Google LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  createAgentAPI,\n  type AgentAPI,\n  type AgentTransport,\n  type SnapshotLookup,\n} from '@genkit-ai/ai/agent-core';\n\nimport type {\n  AgentInit,\n  AgentInput,\n  AgentOutput,\n  AgentStreamChunk,\n} from '@genkit-ai/ai';\nimport type { SessionSnapshot } from '@genkit-ai/ai/session';\nimport { runFlow, streamFlow } from './client.mjs';\n\n// Re-export the transport-agnostic agent-client surface so existing imports\n// from `genkit/beta/client` keep working.\nexport {\n  AgentError,\n  type AgentAPI,\n  type AgentChat,\n  type AgentChunk,\n  type AgentInterrupt,\n  type AgentResponse,\n  type AgentTurn,\n  type DetachedTask,\n} from '@genkit-ai/ai/agent-core';\n\n// Re-export the JSON Patch helper so apps can apply a chunk's `customPatch` to\n// their own locally tracked copy of the agent's custom state.\nexport { applyPatch, type JsonPatch } from '@genkit-ai/ai/json-patch';\n\n/**\n * Options for {@link remoteAgent}.\n */\nexport interface RemoteAgentOptions {\n  /** Required. The agent endpoint. */\n  url: string;\n  /** Optional. Defaults to `${url}/getSnapshot`. */\n  getSnapshotUrl?: string;\n  /** Optional. Defaults to `${url}/abort`. */\n  abortUrl?: string;\n  /** Optional. Static headers, or a function called per request. */\n  headers?:\n    | Record<string, string>\n    | (() => Record<string, string> | Promise<Record<string, string>>);\n  /** Optional. Declares server- vs client-managed state; inferred otherwise. */\n  stateManagement?: 'server' | 'client';\n}\n\n// ---------------------------------------------------------------------------\n// remoteAgent factory\n// ---------------------------------------------------------------------------\n\n/**\n * Creates a typed client for talking to a Genkit agent over HTTP.\n *\n * ```ts\n * import { remoteAgent } from 'genkit/beta/client';\n *\n * const agent = remoteAgent<WeatherState>({\n *   url: '/api/weatherAgent',\n * });\n * const chat = agent.chat();\n * const res = await chat.send('Weather in Tokyo?').response;\n * console.log(res.text);\n * ```\n */\nexport function remoteAgent<State = unknown>(\n  options: RemoteAgentOptions\n): AgentAPI<State> {\n  const { url } = options;\n  const getSnapshotUrl = options.getSnapshotUrl ?? `${url}/getSnapshot`;\n  const abortUrl = options.abortUrl ?? `${url}/abort`;\n\n  const resolveHeaders = async (): Promise<\n    Record<string, string> | undefined\n  > => {\n    if (!options.headers) return undefined;\n    if (typeof options.headers === 'function') {\n      return options.headers();\n    }\n    return options.headers;\n  };\n\n  const transport: AgentTransport = {\n    stateManagement: options.stateManagement,\n\n    runTurn(\n      input: AgentInput,\n      init: AgentInit,\n      opts: { abortSignal: AbortSignal }\n    ) {\n      // Kick off the request lazily so headers can be resolved asynchronously.\n      const started = (async () => {\n        const headers = await resolveHeaders();\n        return streamFlow<AgentOutput, AgentStreamChunk, AgentInit>({\n          url,\n          input,\n          init,\n          headers,\n          abortSignal: opts.abortSignal,\n        });\n      })();\n\n      const output = (async () => {\n        const { output } = await started;\n        return output;\n      })();\n\n      const stream = (async function* (): AsyncIterable<AgentStreamChunk> {\n        const { stream: rawStream } = await started;\n        yield* rawStream;\n      })();\n\n      return { stream, output };\n    },\n\n    async getSnapshot(lookup: SnapshotLookup) {\n      const headers = await resolveHeaders();\n      return runFlow<SessionSnapshot<State> | undefined>({\n        url: getSnapshotUrl,\n        input: lookup,\n        headers,\n      });\n    },\n\n    async abort(snapshotId: string) {\n      const headers = await resolveHeaders();\n      const result = await runFlow<{\n        snapshotId: string;\n        status?: SessionSnapshot['status'];\n      }>({\n        url: abortUrl,\n        input: { snapshotId },\n        headers,\n      });\n      return result?.status;\n    },\n  };\n\n  return createAgentAPI<State>(transport);\n}\n"],"mappings":"AAgBA;AAAA,EACE;AAAA,OAIK;AASP,SAAS,SAAS,kBAAkB;AAIpC;AAAA,EACE;AAAA,OAQK;AAIP,SAAS,kBAAkC;AAsCpC,SAAS,YACd,SACiB;AACjB,QAAM,EAAE,IAAI,IAAI;AAChB,QAAM,iBAAiB,QAAQ,kBAAkB,GAAG,GAAG;AACvD,QAAM,WAAW,QAAQ,YAAY,GAAG,GAAG;AAE3C,QAAM,iBAAiB,YAElB;AACH,QAAI,CAAC,QAAQ,QAAS,QAAO;AAC7B,QAAI,OAAO,QAAQ,YAAY,YAAY;AACzC,aAAO,QAAQ,QAAQ;AAAA,IACzB;AACA,WAAO,QAAQ;AAAA,EACjB;AAEA,QAAM,YAA4B;AAAA,IAChC,iBAAiB,QAAQ;AAAA,IAEzB,QACE,OACA,MACA,MACA;AAEA,YAAM,WAAW,YAAY;AAC3B,cAAM,UAAU,MAAM,eAAe;AACrC,eAAO,WAAqD;AAAA,UAC1D;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,UACA,aAAa,KAAK;AAAA,QACpB,CAAC;AAAA,MACH,GAAG;AAEH,YAAM,UAAU,YAAY;AAC1B,cAAM,EAAE,QAAAA,QAAO,IAAI,MAAM;AACzB,eAAOA;AAAA,MACT,GAAG;AAEH,YAAM,UAAU,mBAAoD;AAClE,cAAM,EAAE,QAAQ,UAAU,IAAI,MAAM;AACpC,eAAO;AAAA,MACT,GAAG;AAEH,aAAO,EAAE,QAAQ,OAAO;AAAA,IAC1B;AAAA,IAEA,MAAM,YAAY,QAAwB;AACxC,YAAM,UAAU,MAAM,eAAe;AACrC,aAAO,QAA4C;AAAA,QACjD,KAAK;AAAA,QACL,OAAO;AAAA,QACP;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IAEA,MAAM,MAAM,YAAoB;AAC9B,YAAM,UAAU,MAAM,eAAe;AACrC,YAAM,SAAS,MAAM,QAGlB;AAAA,QACD,KAAK;AAAA,QACL,OAAO,EAAE,WAAW;AAAA,QACpB;AAAA,MACF,CAAC;AACD,aAAO,QAAQ;AAAA,IACjB;AAAA,EACF;AAEA,SAAO,eAAsB,SAAS;AACxC;","names":["output"]}

package/lib/client/client.d.mts

@@ -0,0 +1,80 @@
+/**
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Invoke and stream response from a deployed flow.
+ *
+ * For example:
+ *
+ * ```js
+ * import { streamFlow } from 'genkit/beta/client';
+ *
+ * const response = streamFlow({
+ *   url: 'https://my-flow-deployed-url',
+ *   input: 'foo',
+ * });
+ * for await (const chunk of response.stream) {
+ *   console.log(chunk);
+ * }
+ * console.log(await response.output);
+ * ```
+ */
+declare function streamFlow<O = any, S = any, Init = any>({ url, input, init, streamId, headers, abortSignal, }: {
+    /** URL of the deployed flow. */
+    url: string;
+    /** Flow input. */
+    input?: any;
+    /** Initialization data for the action. */
+    init?: Init;
+    /** Stream ID to connect to. */
+    streamId?: string;
+    /** A map of HTTP headers to be added to the HTTP call. */
+    headers?: Record<string, string>;
+    /** Abort signal to abort the request. */
+    abortSignal?: AbortSignal;
+}): {
+    readonly output: Promise<O>;
+    readonly stream: AsyncIterable<S>;
+    readonly streamId: Promise<string | null>;
+};
+/**
+ * Invoke a deployed flow over HTTP(s).
+ *
+ * For example:
+ *
+ * ```js
+ * import { runFlow } from 'genkit/beta/client';
+ *
+ * const response = await runFlow({
+ *   url: 'https://my-flow-deployed-url',
+ *   input: 'foo',
+ * });
+ * console.log(await response);
+ * ```
+ */
+declare function runFlow<O = any, Init = any>({ url, input, init, headers, abortSignal, }: {
+    /** URL of the deployed flow. */
+    url: string;
+    /** Flow input. */
+    input?: any;
+    /** Initialization data for the action. */
+    init?: Init;
+    /** A map of HTTP headers to be added to the HTTP call. */
+    headers?: Record<string, string>;
+    /** Abort signal to abort the request. */
+    abortSignal?: AbortSignal;
+}): Promise<O>;
+
+export { runFlow, streamFlow };

package/lib/client/client.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Invoke and stream response from a deployed flow.
+ *
+ * For example:
+ *
+ * ```js
+ * import { streamFlow } from 'genkit/beta/client';
+ *
+ * const response = streamFlow({
+ *   url: 'https://my-flow-deployed-url',
+ *   input: 'foo',
+ * });
+ * for await (const chunk of response.stream) {
+ *   console.log(chunk);
+ * }
+ * console.log(await response.output);
+ * ```
+ */
+declare function streamFlow<O = any, S = any, Init = any>({ url, input, init, streamId, headers, abortSignal, }: {
+    /** URL of the deployed flow. */
+    url: string;
+    /** Flow input. */
+    input?: any;
+    /** Initialization data for the action. */
+    init?: Init;
+    /** Stream ID to connect to. */
+    streamId?: string;
+    /** A map of HTTP headers to be added to the HTTP call. */
+    headers?: Record<string, string>;
+    /** Abort signal to abort the request. */
+    abortSignal?: AbortSignal;
+}): {
+    readonly output: Promise<O>;
+    readonly stream: AsyncIterable<S>;
+    readonly streamId: Promise<string | null>;
+};
+/**
+ * Invoke a deployed flow over HTTP(s).
+ *
+ * For example:
+ *
+ * ```js
+ * import { runFlow } from 'genkit/beta/client';
+ *
+ * const response = await runFlow({
+ *   url: 'https://my-flow-deployed-url',
+ *   input: 'foo',
+ * });
+ * console.log(await response);
+ * ```
+ */
+declare function runFlow<O = any, Init = any>({ url, input, init, headers, abortSignal, }: {
+    /** URL of the deployed flow. */
+    url: string;
+    /** Flow input. */
+    input?: any;
+    /** Initialization data for the action. */
+    init?: Init;
+    /** A map of HTTP headers to be added to the HTTP call. */
+    headers?: Record<string, string>;
+    /** Abort signal to abort the request. */
+    abortSignal?: AbortSignal;
+}): Promise<O>;
+
+export { runFlow, streamFlow };