@finalai/agents 0.11.0 → 0.12.0

package/dist/modules/agent-client/local-host.mjs

@@ -0,0 +1,200 @@
+import { DEFAULT_CAPABILITY_ACCESS } from "@finalai/agent-protocol";
+import {
+  CodeLineType,
+  serveInProcessCode
+} from "@finalai/agent-provider/code-host";
+import { sandboxGrantFor } from "@finalai/agent-provider/sandbox/grant";
+import { serveSandboxHandle } from "@finalai/agent-provider/sandbox/server";
+import {
+  createHostPeer,
+  LOCAL_HOST_PROTOCOL_VERSION,
+  localHostCodeRunParamsSchema,
+  localHostHelloResultSchema,
+  LocalHostMethod,
+  localHostSecretResultSchema,
+  localHostPath,
+  splitLocalHostChannel
+} from "./local-host-protocol.mjs";
+const runToCompletion = async (args) => {
+  const invocation = localHostCodeRunParamsSchema.safeParse(args.params);
+  if (!invocation.success)
+    return { type: CodeLineType.Error, message: `invalid invocation: ${invocation.error.message}` };
+  for await (const line of args.run(invocation.data, {
+    signal: args.signal,
+    secrets: args.secrets
+  })) {
+    if (line.type === CodeLineType.Progress) {
+      args.onProgress(line.label == null ? { data: line.data } : line);
+      continue;
+    }
+    return line;
+  }
+  return { type: CodeLineType.Error, message: "the code ended without a result" };
+};
+const untilAborted = (promise, signal) => {
+  if (signal == null) return promise;
+  return new Promise((resolve, reject) => {
+    const onAbort = () => reject(abortReason(signal));
+    if (signal.aborted) {
+      onAbort();
+      return;
+    }
+    signal.addEventListener("abort", onAbort, { once: true });
+    promise.then(resolve, reject).finally(() => signal.removeEventListener("abort", onAbort));
+  });
+};
+const abortReason = (signal) => signal.reason instanceof Error ? signal.reason : new Error("local host opening was aborted");
+const keepAliveHolds = (keepAlive) => {
+  let holds = 0;
+  return () => {
+    if (holds === 0) keepAlive?.ref();
+    holds += 1;
+    let released = false;
+    return () => {
+      if (released) return;
+      released = true;
+      holds -= 1;
+      if (holds === 0) keepAlive?.unref();
+    };
+  };
+};
+const holdingWhileBusy = (sandbox, hold) => new Proxy(sandbox, {
+  get: (target, property) => {
+    const value = Reflect.get(target, property);
+    if (typeof value !== "function") return value;
+    return (...args) => {
+      const release = hold();
+      let result;
+      try {
+        result = Reflect.apply(value, target, args);
+      } catch (cause) {
+        release();
+        throw cause;
+      }
+      void Promise.resolve(result).then((settled) => {
+        if (property !== "spawn" || typeof settled !== "object" || settled == null) return;
+        const wait = Reflect.get(settled, "wait");
+        if (typeof wait === "function") return Reflect.apply(wait, settled, []);
+      }).catch(() => void 0).finally(release);
+      return result;
+    };
+  }
+});
+const openLocalHost = async (args) => {
+  const signal = args.signal;
+  signal?.throwIfAborted();
+  const dialing = args.dial(localHostPath(args.projectId), signal);
+  const socket = await untilAborted(dialing, signal).catch((cause) => {
+    void dialing.then(
+      (late) => late.close(1e3, "aborted"),
+      () => void 0
+    );
+    throw cause;
+  });
+  const hold = keepAliveHolds(socket.keepAlive);
+  const starting = hold();
+  let sandbox = null;
+  let stopping = null;
+  const stopSandbox = () => stopping ??= sandbox?.stop().catch(() => void 0) ?? Promise.resolve();
+  try {
+    const channels = splitLocalHostChannel(socket);
+    const code = args.agent.code;
+    const document = args.agent.document;
+    const run = code == null ? null : serveInProcessCode(code, { openSandbox: args.compute.openSandbox });
+    if (args.capabilities.length > 0) {
+      const served = await args.compute.sandbox();
+      sandbox = served;
+      signal?.throwIfAborted();
+      const grant = sandboxGrantFor({
+        capabilities: args.capabilities,
+        required: {
+          ...Object.fromEntries(
+            args.capabilities.map((capability) => [
+              capability,
+              { access: DEFAULT_CAPABILITY_ACCESS[capability] }
+            ])
+          ),
+          ...args.agent.document.require.compute
+        }
+      });
+      serveSandboxHandle({
+        sandbox: holdingWhileBusy(served, hold),
+        authorize: async () => ({ expiresAt: null }),
+        access: { grant, lifecycle: false }
+      }).attach(channels.sandbox);
+    }
+    const peer = createHostPeer({
+      channel: channels.host,
+      onRequest: async (method, context) => {
+        if (method !== LocalHostMethod.CodeRun || run == null)
+          throw new Error(`this process does not answer ${method}`);
+        const release = hold();
+        try {
+          return await runToCompletion({
+            run,
+            params: context.params,
+            signal: context.signal,
+            // Asked of the platform for this call; only names the agent lists.
+            secrets: {
+              get: async (name) => {
+                if (!document.secrets.includes(name))
+                  throw new Error(`${name} is not one of the secrets this agent lists`);
+                return localHostSecretResultSchema.parse(
+                  await peer.request(LocalHostMethod.CodeSecret, { requestId: context.id, name })
+                ).value;
+              }
+            },
+            onProgress: (progress) => peer.notify(LocalHostMethod.CodeProgress, {
+              requestId: context.id,
+              data: JSON.parse(JSON.stringify(progress.data ?? null)),
+              ...progress.label == null ? {} : { label: progress.label }
+            })
+          });
+        } finally {
+          release();
+        }
+      }
+    });
+    void peer.closed.then(stopSandbox);
+    const hello = localHostHelloResultSchema.safeParse(
+      await untilAborted(
+        peer.request(LocalHostMethod.Hello, {
+          protocolVersion: LOCAL_HOST_PROTOCOL_VERSION,
+          owner: { kind: args.owner.kind, ...args.owner.id == null ? {} : { id: args.owner.id } },
+          agent: args.agent.hash,
+          capabilities: args.capabilities,
+          tools: code == null ? [] : Object.keys(code.tools),
+          hooks: code == null ? [] : Object.keys(code.hooks),
+          approvals: code == null ? [] : Object.keys(code.approvals).filter((name) => document.tools[name] != null)
+        }),
+        signal
+      )
+    );
+    if (!hello.success) {
+      peer.close(1002, "bad hello");
+      throw new Error(
+        `The platform answered the local host hello unexpectedly: ${hello.error.message}`
+      );
+    }
+    if (args.capabilities.length > 0 && hello.data.sandboxId == null) {
+      peer.close(1002, "no sandbox id");
+      throw new Error("The platform did not name the sandbox this process serves");
+    }
+    return {
+      hostId: hello.data.hostId,
+      ownerId: hello.data.owner.id,
+      sandboxId: hello.data.sandboxId,
+      closed: peer.closed,
+      close: () => peer.close(1e3, "client closed"),
+      established: starting
+    };
+  } catch (cause) {
+    socket.close(1e3, "local host failed to open");
+    void stopSandbox();
+    throw cause;
+  }
+};
+export {
+  openLocalHost
+};
+//# sourceMappingURL=local-host.mjs.map

package/dist/modules/agent-client/local-host.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/local-host.ts"],
+  "sourcesContent": ["import { DEFAULT_CAPABILITY_ACCESS, type Capability } from '@finalai/agent-protocol';\nimport {\n  CodeLineType,\n  serveInProcessCode,\n  type CodeRunIface,\n  type CodeSandboxEndpointIface,\n  type CodeSecretsIface,\n} from '@finalai/agent-provider/code-host';\nimport type { SandboxClientIface } from '@finalai/agent-provider/sandbox/client';\nimport { sandboxGrantFor } from '@finalai/agent-provider/sandbox/grant';\nimport { serveSandboxHandle } from '@finalai/agent-provider/sandbox/server';\nimport type { NetworkSandboxSessionIface } from '@finalai/agent-provider/sandbox/types';\nimport type { FrameChannelIface } from '@finalai/agent-provider/sandbox/wire';\nimport type { ResolvedAgentIface } from \"./agent-input.mjs\";\nimport {\n  createHostPeer,\n  LOCAL_HOST_PROTOCOL_VERSION,\n  localHostCodeRunParamsSchema,\n  localHostHelloResultSchema,\n  LocalHostMethod,\n  localHostSecretResultSchema,\n  localHostPath,\n  splitLocalHostChannel,\n  type LocalHostCodeResultIface,\n  type LocalHostOwnerIface,\n} from \"./local-host-protocol.mjs\";\n\n// The client's side of a local host connection (local-host-protocol.ts): it\n// serves the agent's `files` and `shell` from this process and answers the\n// platform's calls to the agent's in-process code. When the connection ends\n// the session carries on; the platform reports this process's tools and\n// compute as unavailable until a connection resumes them.\n\nexport interface LocalComputeIface {\n  /** The sandbox this process serves `files` and `shell` from. */\n  sandbox: () => Promise<NetworkSandboxSessionIface>;\n  /** Connects `ctx.sandbox(capability)` in in-process code to a sandbox endpoint. */\n  openSandbox: (endpoint: CodeSandboxEndpointIface) => Promise<SandboxClientIface>;\n}\n\n/**\n * Whether the socket keeps this Node process alive. The connection holds it\n * while it starts and while the platform is using it (a code call, a sandbox\n * operation, a running command), and lets an idle script exit.\n */\nexport interface LocalHostKeepAliveIface {\n  ref: () => void;\n  unref: () => void;\n}\n\nexport interface LocalHostSocketIface extends FrameChannelIface {\n  /** Absent: the socket's lifetime is not this process's concern. */\n  keepAlive?: LocalHostKeepAliveIface;\n}\n\nexport interface OpenLocalHostArgsIface {\n  /** Opens the socket at an API path (`/v1/projects/:id/local-hosts`), referenced. */\n  dial: (path: string, signal?: AbortSignal) => Promise<LocalHostSocketIface>;\n  projectId: string;\n  owner: LocalHostOwnerIface;\n  agent: ResolvedAgentIface;\n  /** Capabilities served from this process; may be empty. */\n  capabilities: Capability[];\n  compute: LocalComputeIface;\n  /** Abandons opening: the connection closes and whatever it started stops. */\n  signal?: AbortSignal;\n}\n\nexport interface LocalHostIface {\n  hostId: string;\n  /** The session or conversation id the platform reserved or confirmed. */\n  ownerId: string;\n  /** What names this process's compute in `provide.compute`; null when it serves none. */\n  sandboxId: string | null;\n  closed: Promise<{ code: number; reason: string }>;\n  close: () => void;\n  /**\n   * The session or conversation it serves exists: the socket stops keeping\n   * the process alive while nothing uses it.\n   */\n  established: () => void;\n}\n\nconst runToCompletion = async (args: {\n  run: CodeRunIface;\n  params: unknown;\n  signal: AbortSignal;\n  secrets: CodeSecretsIface;\n  onProgress: (progress: { data: unknown; label?: string }) => void;\n}): Promise<LocalHostCodeResultIface> => {\n  const invocation = localHostCodeRunParamsSchema.safeParse(args.params);\n  if (!invocation.success)\n    return { type: CodeLineType.Error, message: `invalid invocation: ${invocation.error.message}` };\n  for await (const line of args.run(invocation.data, {\n    signal: args.signal,\n    secrets: args.secrets,\n  })) {\n    if (line.type === CodeLineType.Progress) {\n      args.onProgress(line.label == null ? { data: line.data } : line);\n      continue;\n    }\n    return line;\n  }\n  return { type: CodeLineType.Error, message: 'the code ended without a result' };\n};\n\n// `promise`, or the signal's reason once it aborts first.\nconst untilAborted = <T>(promise: Promise<T>, signal: AbortSignal | undefined): Promise<T> => {\n  if (signal == null) return promise;\n  return new Promise<T>((resolve, reject) => {\n    const onAbort = () => reject(abortReason(signal));\n    if (signal.aborted) {\n      onAbort();\n      return;\n    }\n    signal.addEventListener('abort', onAbort, { once: true });\n    promise.then(resolve, reject).finally(() => signal.removeEventListener('abort', onAbort));\n  });\n};\n\nconst abortReason = (signal: AbortSignal): Error =>\n  signal.reason instanceof Error ? signal.reason : new Error('local host opening was aborted');\n\n// Counts what needs the process alive; the socket is referenced while any does.\nconst keepAliveHolds = (keepAlive: LocalHostKeepAliveIface | undefined) => {\n  let holds = 0;\n  return (): (() => void) => {\n    if (holds === 0) keepAlive?.ref();\n    holds += 1;\n    let released = false;\n    return () => {\n      if (released) return;\n      released = true;\n      holds -= 1;\n      if (holds === 0) keepAlive?.unref();\n    };\n  };\n};\n\n// The served sandbox, holding the process alive while an operation runs and,\n// for a spawned command, until it exits.\nconst holdingWhileBusy = <T extends object>(sandbox: T, hold: () => () => void): T =>\n  new Proxy(sandbox, {\n    get: (target, property) => {\n      const value: unknown = Reflect.get(target, property);\n      if (typeof value !== 'function') return value;\n      return (...args: unknown[]): unknown => {\n        const release = hold();\n        let result: unknown;\n        try {\n          result = Reflect.apply(value, target, args);\n        } catch (cause) {\n          release();\n          throw cause;\n        }\n        void Promise.resolve(result)\n          .then((settled) => {\n            if (property !== 'spawn' || typeof settled !== 'object' || settled == null) return;\n            const wait = Reflect.get(settled, 'wait');\n            if (typeof wait === 'function') return Reflect.apply(wait, settled, []);\n          })\n          .catch(() => undefined)\n          .finally(release);\n        return result;\n      };\n    },\n  });\n\nexport const openLocalHost = async (args: OpenLocalHostArgsIface): Promise<LocalHostIface> => {\n  const signal = args.signal;\n  signal?.throwIfAborted();\n  const dialing = args.dial(localHostPath(args.projectId), signal);\n  const socket = await untilAborted(dialing, signal).catch((cause: unknown) => {\n    // A dial that ignores the signal still connects; close what it opens.\n    void dialing.then(\n      (late) => late.close(1000, 'aborted'),\n      () => undefined,\n    );\n    throw cause;\n  });\n\n  // Until the hello succeeds, a failure or an abort closes the socket and\n  // stops the sandbox; afterwards the sandbox stops when the socket closes.\n  const hold = keepAliveHolds(socket.keepAlive);\n  // Released once the caller has created what the host serves.\n  const starting = hold();\n  let sandbox: NetworkSandboxSessionIface | null = null;\n  let stopping: Promise<void> | null = null;\n  const stopSandbox = (): Promise<void> =>\n    (stopping ??= sandbox?.stop().catch(() => undefined) ?? Promise.resolve());\n  try {\n    const channels = splitLocalHostChannel(socket);\n    const code = args.agent.code;\n    const document = args.agent.document;\n    const run =\n      code == null ? null : serveInProcessCode(code, { openSandbox: args.compute.openSandbox });\n\n    if (args.capabilities.length > 0) {\n      const served = await args.compute.sandbox();\n      sandbox = served;\n      signal?.throwIfAborted();\n      // The agent's own access on what it requires; a capability served only\n      // so a native harness can run here (`shell`, to launch it) gets the\n      // access that takes.\n      const grant = sandboxGrantFor({\n        capabilities: args.capabilities,\n        required: {\n          ...Object.fromEntries(\n            args.capabilities.map((capability) => [\n              capability,\n              { access: DEFAULT_CAPABILITY_ACCESS[capability] },\n            ]),\n          ),\n          ...args.agent.document.require.compute,\n        },\n      });\n      // The socket itself is authenticated; every call on it is the platform's.\n      serveSandboxHandle({\n        sandbox: holdingWhileBusy(served, hold),\n        authorize: async () => ({ expiresAt: null }),\n        access: { grant, lifecycle: false },\n      }).attach(channels.sandbox);\n    }\n\n    const peer = createHostPeer({\n      channel: channels.host,\n      onRequest: async (method, context) => {\n        if (method !== LocalHostMethod.CodeRun || run == null)\n          throw new Error(`this process does not answer ${method}`);\n        const release = hold();\n        try {\n          return await runToCompletion({\n            run,\n            params: context.params,\n            signal: context.signal,\n            // Asked of the platform for this call; only names the agent lists.\n            secrets: {\n              get: async (name) => {\n                if (!document.secrets.includes(name))\n                  throw new Error(`${name} is not one of the secrets this agent lists`);\n                return localHostSecretResultSchema.parse(\n                  await peer.request(LocalHostMethod.CodeSecret, { requestId: context.id, name }),\n                ).value;\n              },\n            },\n            onProgress: (progress) =>\n              peer.notify(LocalHostMethod.CodeProgress, {\n                requestId: context.id,\n                data: JSON.parse(JSON.stringify(progress.data ?? null)),\n                ...(progress.label == null ? {} : { label: progress.label }),\n              }),\n          });\n        } finally {\n          release();\n        }\n      },\n    });\n    // Processes the model started here end with the connection; the session carries on.\n    void peer.closed.then(stopSandbox);\n\n    const hello = localHostHelloResultSchema.safeParse(\n      await untilAborted(\n        peer.request(LocalHostMethod.Hello, {\n          protocolVersion: LOCAL_HOST_PROTOCOL_VERSION,\n          owner: { kind: args.owner.kind, ...(args.owner.id == null ? {} : { id: args.owner.id }) },\n          agent: args.agent.hash,\n          capabilities: args.capabilities,\n          tools: code == null ? [] : Object.keys(code.tools),\n          hooks: code == null ? [] : Object.keys(code.hooks),\n          approvals:\n            code == null\n              ? []\n              : Object.keys(code.approvals).filter((name) => document.tools[name] != null),\n        }),\n        signal,\n      ),\n    );\n    if (!hello.success) {\n      peer.close(1002, 'bad hello');\n      throw new Error(\n        `The platform answered the local host hello unexpectedly: ${hello.error.message}`,\n      );\n    }\n    if (args.capabilities.length > 0 && hello.data.sandboxId == null) {\n      peer.close(1002, 'no sandbox id');\n      throw new Error('The platform did not name the sandbox this process serves');\n    }\n    return {\n      hostId: hello.data.hostId,\n      ownerId: hello.data.owner.id,\n      sandboxId: hello.data.sandboxId,\n      closed: peer.closed,\n      close: () => peer.close(1000, 'client closed'),\n      established: starting,\n    };\n  } catch (cause) {\n    // A no-op when a bad hello already closed it.\n    socket.close(1000, 'local host failed to open');\n    void stopSandbox();\n    throw cause;\n  }\n};\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/agent-client/oauth-clients.d.mts

@@ -0,0 +1,36 @@
+import { type CreateOAuthClientRequestIface, type OAuthClientIface, type ReturnOriginListIface } from '@finalai/agent-protocol/agent-platform';
+import { type ClientContextIface, type SignalOptionsIface } from "./context.mjs";
+export interface OAuthClientsApiIface {
+    /**
+     * Registers a client the project created with an authorization server. An
+     * OAuth integration names it with `auth.client`; its secret is a project
+     * secret by name.
+     */
+    create: (args: CreateOAuthClientRequestIface & SignalOptionsIface) => Promise<OAuthClientIface>;
+    /** The project's clients and its ancestors'. */
+    list: (options?: SignalOptionsIface) => Promise<OAuthClientIface[]>;
+    get: (args: {
+        id: string;
+    } & SignalOptionsIface) => Promise<OAuthClientIface>;
+    /** Refused with `in_use` while an integration names it. */
+    delete: (args: {
+        id: string;
+    } & SignalOptionsIface) => Promise<void>;
+}
+export interface SignInReturnOriginsApiIface {
+    /** The project's own origins and those it inherits. */
+    list: (options?: SignalOptionsIface) => Promise<ReturnOriginListIface['origins']>;
+    /**
+     * Replaces the project's own origins: `https://host[:port]`,
+     * `http://localhost[:port]` or an app scheme (`myapp://`).
+     */
+    set: (origins: readonly string[], options?: SignalOptionsIface) => Promise<ReturnOriginListIface['origins']>;
+}
+export declare const createOAuthClientsApi: (args: {
+    context: ClientContextIface;
+    projectId: string;
+}) => OAuthClientsApiIface;
+export declare const createSignInReturnOriginsApi: (args: {
+    context: ClientContextIface;
+    projectId: string;
+}) => SignInReturnOriginsApiIface;

package/dist/modules/agent-client/oauth-clients.mjs

@@ -0,0 +1,67 @@
+import {
+  createOAuthClientRequestSchema,
+  oauthClientListSchema,
+  oauthClientSchema,
+  okResponseSchema,
+  putReturnOriginsRequestSchema,
+  returnOriginListSchema
+} from "@finalai/agent-protocol/agent-platform";
+import { encodePath } from "./context.mjs";
+import { HttpMethod } from "./http.mjs";
+const createOAuthClientsApi = (args) => {
+  const { http } = args.context;
+  const path = (suffix = "") => `/v1/projects/${encodePath(args.projectId)}/oauth-clients${suffix}`;
+  return {
+    create: ({ signal, ...value }) => http.request({
+      method: HttpMethod.Post,
+      path: path(),
+      body: { schema: createOAuthClientRequestSchema, value },
+      response: oauthClientSchema,
+      signal
+    }),
+    list: async (options) => (await http.request({
+      method: HttpMethod.Get,
+      path: path(),
+      response: oauthClientListSchema,
+      signal: options?.signal
+    })).clients,
+    get: ({ id, signal }) => http.request({
+      method: HttpMethod.Get,
+      path: path(`/${encodePath(id)}`),
+      response: oauthClientSchema,
+      signal
+    }),
+    delete: async ({ id, signal }) => {
+      await http.request({
+        method: HttpMethod.Delete,
+        path: path(`/${encodePath(id)}`),
+        response: okResponseSchema,
+        signal
+      });
+    }
+  };
+};
+const createSignInReturnOriginsApi = (args) => {
+  const { http } = args.context;
+  const path = `/v1/projects/${encodePath(args.projectId)}/sign-in-return-origins`;
+  return {
+    list: async (options) => (await http.request({
+      method: HttpMethod.Get,
+      path,
+      response: returnOriginListSchema,
+      signal: options?.signal
+    })).origins,
+    set: async (origins, options) => (await http.request({
+      method: HttpMethod.Put,
+      path,
+      body: { schema: putReturnOriginsRequestSchema, value: { origins } },
+      response: returnOriginListSchema,
+      signal: options?.signal
+    })).origins
+  };
+};
+export {
+  createOAuthClientsApi,
+  createSignInReturnOriginsApi
+};
+//# sourceMappingURL=oauth-clients.mjs.map

package/dist/modules/agent-client/oauth-clients.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/oauth-clients.ts"],
+  "sourcesContent": ["import {\n  createOAuthClientRequestSchema,\n  oauthClientListSchema,\n  oauthClientSchema,\n  okResponseSchema,\n  putReturnOriginsRequestSchema,\n  returnOriginListSchema,\n  type CreateOAuthClientRequestIface,\n  type OAuthClientIface,\n  type ReturnOriginListIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { encodePath, type ClientContextIface, type SignalOptionsIface } from \"./context.mjs\";\nimport { HttpMethod } from \"./http.mjs\";\n\n// What a project brings for its integrations' sign-ins: its own OAuth clients,\n// and the origins a sign-in may return a person to.\n\nexport interface OAuthClientsApiIface {\n  /**\n   * Registers a client the project created with an authorization server. An\n   * OAuth integration names it with `auth.client`; its secret is a project\n   * secret by name.\n   */\n  create: (args: CreateOAuthClientRequestIface & SignalOptionsIface) => Promise<OAuthClientIface>;\n  /** The project's clients and its ancestors'. */\n  list: (options?: SignalOptionsIface) => Promise<OAuthClientIface[]>;\n  get: (args: { id: string } & SignalOptionsIface) => Promise<OAuthClientIface>;\n  /** Refused with `in_use` while an integration names it. */\n  delete: (args: { id: string } & SignalOptionsIface) => Promise<void>;\n}\n\nexport interface SignInReturnOriginsApiIface {\n  /** The project's own origins and those it inherits. */\n  list: (options?: SignalOptionsIface) => Promise<ReturnOriginListIface['origins']>;\n  /**\n   * Replaces the project's own origins: `https://host[:port]`,\n   * `http://localhost[:port]` or an app scheme (`myapp://`).\n   */\n  set: (\n    origins: readonly string[],\n    options?: SignalOptionsIface,\n  ) => Promise<ReturnOriginListIface['origins']>;\n}\n\nexport const createOAuthClientsApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n}): OAuthClientsApiIface => {\n  const { http } = args.context;\n  const path = (suffix = ''): string =>\n    `/v1/projects/${encodePath(args.projectId)}/oauth-clients${suffix}`;\n  return {\n    create: ({ signal, ...value }) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: path(),\n        body: { schema: createOAuthClientRequestSchema, value },\n        response: oauthClientSchema,\n        signal,\n      }),\n    list: async (options) =>\n      (\n        await http.request({\n          method: HttpMethod.Get,\n          path: path(),\n          response: oauthClientListSchema,\n          signal: options?.signal,\n        })\n      ).clients,\n    get: ({ id, signal }) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: path(`/${encodePath(id)}`),\n        response: oauthClientSchema,\n        signal,\n      }),\n    delete: async ({ id, signal }) => {\n      await http.request({\n        method: HttpMethod.Delete,\n        path: path(`/${encodePath(id)}`),\n        response: okResponseSchema,\n        signal,\n      });\n    },\n  };\n};\n\nexport const createSignInReturnOriginsApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n}): SignInReturnOriginsApiIface => {\n  const { http } = args.context;\n  const path = `/v1/projects/${encodePath(args.projectId)}/sign-in-return-origins`;\n  return {\n    list: async (options) =>\n      (\n        await http.request({\n          method: HttpMethod.Get,\n          path,\n          response: returnOriginListSchema,\n          signal: options?.signal,\n        })\n      ).origins,\n    set: async (origins, options) =>\n      (\n        await http.request({\n          method: HttpMethod.Put,\n          path,\n          body: { schema: putReturnOriginsRequestSchema, value: { origins } },\n          response: returnOriginListSchema,\n          signal: options?.signal,\n        })\n      ).origins,\n  };\n};\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,SAAS,kBAAoE;AAC7E,SAAS,kBAAkB;AAgCpB,MAAM,wBAAwB,CAAC,SAGV;AAC1B,QAAM,EAAE,KAAK,IAAI,KAAK;AACtB,QAAM,OAAO,CAAC,SAAS,OACrB,gBAAgB,WAAW,KAAK,SAAS,CAAC,iBAAiB,MAAM;AACnE,SAAO;AAAA,IACL,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,MAC1B,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,KAAK;AAAA,MACX,MAAM,EAAE,QAAQ,gCAAgC,MAAM;AAAA,MACtD,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AAAA,IACH,MAAM,OAAO,aAET,MAAM,KAAK,QAAQ;AAAA,MACjB,QAAQ,WAAW;AAAA,MACnB,MAAM,KAAK;AAAA,MACX,UAAU;AAAA,MACV,QAAQ,SAAS;AAAA,IACnB,CAAC,GACD;AAAA,IACJ,KAAK,CAAC,EAAE,IAAI,OAAO,MACjB,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC,EAAE;AAAA,MAC/B,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AAAA,IACH,QAAQ,OAAO,EAAE,IAAI,OAAO,MAAM;AAChC,YAAM,KAAK,QAAQ;AAAA,QACjB,QAAQ,WAAW;AAAA,QACnB,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC,EAAE;AAAA,QAC/B,UAAU;AAAA,QACV;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEO,MAAM,+BAA+B,CAAC,SAGV;AACjC,QAAM,EAAE,KAAK,IAAI,KAAK;AACtB,QAAM,OAAO,gBAAgB,WAAW,KAAK,SAAS,CAAC;AACvD,SAAO;AAAA,IACL,MAAM,OAAO,aAET,MAAM,KAAK,QAAQ;AAAA,MACjB,QAAQ,WAAW;AAAA,MACnB;AAAA,MACA,UAAU;AAAA,MACV,QAAQ,SAAS;AAAA,IACnB,CAAC,GACD;AAAA,IACJ,KAAK,OAAO,SAAS,aAEjB,MAAM,KAAK,QAAQ;AAAA,MACjB,QAAQ,WAAW;AAAA,MACnB;AAAA,MACA,MAAM,EAAE,QAAQ,+BAA+B,OAAO,EAAE,QAAQ,EAAE;AAAA,MAClE,UAAU;AAAA,MACV,QAAQ,SAAS;AAAA,IACnB,CAAC,GACD;AAAA,EACN;AACF;",
+  "names": []
+}

package/dist/modules/agent-client/project-agents.d.mts

@@ -0,0 +1,54 @@
+import { type AgentHistoryIface, type AgentInfoIface, type AgentListIface, type DefinitionVisibility, type PublishAgentResponseIface } from '@finalai/agent-protocol/agent-platform';
+import { type AgentInput, type AgentValueCodecIface } from "./agent-input.mjs";
+import { type ClientContextIface, type EnumInput, type SignalOptionsIface } from "./context.mjs";
+export type AgentSelectorIface = {
+    name: string;
+} | {
+    id: string;
+} | {
+    hash: string;
+};
+export interface ProjectAgentsApiIface {
+    /**
+     * One agent as data: by name, id, or content hash. A bare name resolves in
+     * this project and its ancestors; `handle/name` names a publisher's public agent.
+     */
+    get: (selector: AgentSelectorIface & SignalOptionsIface) => Promise<AgentInfoIface>;
+    /** Stores the agent's document by its content hash, naming nothing; returns the hash. */
+    store: (args: {
+        agent: AgentInput;
+    } & SignalOptionsIface) => Promise<{
+        hash: string;
+    }>;
+    /**
+     * Stores the agent's document and points `name` at its hash. `visibility:
+     * 'public'` also makes the name public under the project's publisher handle.
+     */
+    publish: (args: {
+        agent: AgentInput;
+        name: string;
+        visibility?: EnumInput<DefinitionVisibility>;
+    } & SignalOptionsIface) => Promise<PublishAgentResponseIface>;
+    /**
+     * Validates a document (the JSON `final-agents print` writes) and returns it
+     * as an agent, without calling the platform.
+     */
+    parse: (document: string | object) => Promise<AgentInfoIface>;
+    /** Every hash `name` has pointed at, newest first. */
+    history: (args: {
+        name: string;
+        cursor?: string;
+        limit?: number;
+    } & SignalOptionsIface) => Promise<AgentHistoryIface>;
+    /** The agents published in this project and those it inherits. */
+    list: (options?: SignalOptionsIface & {
+        cursor?: string;
+        limit?: number;
+    }) => Promise<AgentListIface>;
+}
+export declare const parseAgentDocument: (input: string | object) => Promise<AgentInfoIface>;
+export declare const createProjectAgentsApi: (args: {
+    context: ClientContextIface;
+    projectId: string;
+    codec: AgentValueCodecIface;
+}) => ProjectAgentsApiIface;

package/dist/modules/agent-client/project-agents.mjs

@@ -0,0 +1,111 @@
+import { jsonObjectSchema } from "@finalai/agent-protocol";
+import {
+  agentHistorySchema,
+  agentInfoSchema,
+  agentListSchema,
+  agentRequireViewSchema,
+  publishAgentRequestSchema,
+  publishAgentResponseSchema,
+  storeAgentDocumentRequestSchema,
+  storeAgentDocumentResponseSchema
+} from "@finalai/agent-protocol/agent-platform";
+import {
+  agentDocumentHash,
+  agentDocumentSchema,
+  inProcessCodeOf
+} from "@finalai/agent-provider/document";
+import { resolveAgentInput } from "./agent-input.mjs";
+import {
+  encodePath
+} from "./context.mjs";
+import { clientError, ClientErrorCode } from "./errors.mjs";
+import { HttpMethod } from "./http.mjs";
+const agentsPath = (projectId, suffix) => `/v1/projects/${encodePath(projectId)}/agents${suffix}`;
+const invalidDocument = (message) => clientError({ message, status: 0, code: ClientErrorCode.InvalidRequest });
+const parseAgentDocument = async (input) => {
+  let raw = input;
+  if (typeof input === "string") {
+    try {
+      raw = JSON.parse(input);
+    } catch {
+      throw invalidDocument("The agent document is not JSON");
+    }
+  }
+  const parsed = agentDocumentSchema.safeParse(raw);
+  if (!parsed.success)
+    throw invalidDocument(`The agent document is not valid: ${parsed.error.message}`);
+  const document = parsed.data;
+  return agentInfoSchema.parse({
+    id: null,
+    name: document.identity.name,
+    hash: await agentDocumentHash(document),
+    document: jsonObjectSchema.parse(JSON.parse(JSON.stringify(document))),
+    require: agentRequireViewSchema.parse(document.require),
+    inProcess: inProcessCodeOf(document),
+    publishedAt: null
+  });
+};
+const createProjectAgentsApi = (args) => {
+  const { http } = args.context;
+  const store = async ({ agent, signal }) => {
+    const resolved = await resolveAgentInput(agent, args.codec);
+    await http.request({
+      method: HttpMethod.Put,
+      path: agentsPath(args.projectId, "/documents"),
+      body: {
+        schema: storeAgentDocumentRequestSchema,
+        value: {
+          document: jsonObjectSchema.parse(JSON.parse(JSON.stringify(resolved.document))),
+          hash: resolved.hash
+        }
+      },
+      response: storeAgentDocumentResponseSchema,
+      signal
+    });
+    return { hash: resolved.hash };
+  };
+  return {
+    get: ({ signal, ...selector }) => http.request({
+      method: HttpMethod.Get,
+      path: agentsPath(args.projectId, "/lookup"),
+      query: {
+        name: "name" in selector ? selector.name : void 0,
+        id: "id" in selector ? selector.id : void 0,
+        hash: "hash" in selector ? selector.hash : void 0
+      },
+      response: agentInfoSchema,
+      signal
+    }),
+    store,
+    publish: async ({ agent, name, visibility, signal }) => {
+      const { hash } = await store({ agent, signal });
+      return http.request({
+        method: HttpMethod.Post,
+        path: agentsPath(args.projectId, "/publish"),
+        body: { schema: publishAgentRequestSchema, value: { name, hash, visibility } },
+        response: publishAgentResponseSchema,
+        signal
+      });
+    },
+    parse: parseAgentDocument,
+    history: ({ signal, ...query }) => http.request({
+      method: HttpMethod.Get,
+      path: agentsPath(args.projectId, "/history"),
+      query,
+      response: agentHistorySchema,
+      signal
+    }),
+    list: (options) => http.request({
+      method: HttpMethod.Get,
+      path: "/v1/agents",
+      query: { projectId: args.projectId, cursor: options?.cursor, limit: options?.limit },
+      response: agentListSchema,
+      signal: options?.signal
+    })
+  };
+};
+export {
+  createProjectAgentsApi,
+  parseAgentDocument
+};
+//# sourceMappingURL=project-agents.mjs.map

package/dist/modules/agent-client/project-agents.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/project-agents.ts"],
+  "sourcesContent": ["import { jsonObjectSchema } from '@finalai/agent-protocol';\nimport {\n  agentHistorySchema,\n  agentInfoSchema,\n  agentListSchema,\n  agentRequireViewSchema,\n  publishAgentRequestSchema,\n  publishAgentResponseSchema,\n  storeAgentDocumentRequestSchema,\n  storeAgentDocumentResponseSchema,\n  type AgentHistoryIface,\n  type AgentInfoIface,\n  type AgentListIface,\n  type DefinitionVisibility,\n  type PublishAgentResponseIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport {\n  agentDocumentHash,\n  agentDocumentSchema,\n  inProcessCodeOf,\n} from '@finalai/agent-provider/document';\nimport { resolveAgentInput, type AgentInput, type AgentValueCodecIface } from \"./agent-input.mjs\";\nimport {\n  encodePath,\n  type ClientContextIface,\n  type EnumInput,\n  type SignalOptionsIface,\n} from \"./context.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\nimport { HttpMethod } from \"./http.mjs\";\n\n// A project's agents: documents stored by content hash, and names pointing at\n// a hash. Nothing is built or deployed.\n\nexport type AgentSelectorIface = { name: string } | { id: string } | { hash: string };\n\nexport interface ProjectAgentsApiIface {\n  /**\n   * One agent as data: by name, id, or content hash. A bare name resolves in\n   * this project and its ancestors; `handle/name` names a publisher's public agent.\n   */\n  get: (selector: AgentSelectorIface & SignalOptionsIface) => Promise<AgentInfoIface>;\n  /** Stores the agent's document by its content hash, naming nothing; returns the hash. */\n  store: (args: { agent: AgentInput } & SignalOptionsIface) => Promise<{ hash: string }>;\n  /**\n   * Stores the agent's document and points `name` at its hash. `visibility:\n   * 'public'` also makes the name public under the project's publisher handle.\n   */\n  publish: (\n    args: {\n      agent: AgentInput;\n      name: string;\n      visibility?: EnumInput<DefinitionVisibility>;\n    } & SignalOptionsIface,\n  ) => Promise<PublishAgentResponseIface>;\n  /**\n   * Validates a document (the JSON `final-agents print` writes) and returns it\n   * as an agent, without calling the platform.\n   */\n  parse: (document: string | object) => Promise<AgentInfoIface>;\n  /** Every hash `name` has pointed at, newest first. */\n  history: (\n    args: { name: string; cursor?: string; limit?: number } & SignalOptionsIface,\n  ) => Promise<AgentHistoryIface>;\n  /** The agents published in this project and those it inherits. */\n  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number },\n  ) => Promise<AgentListIface>;\n}\n\nconst agentsPath = (projectId: string, suffix: string): string =>\n  `/v1/projects/${encodePath(projectId)}/agents${suffix}`;\n\nconst invalidDocument = (message: string) =>\n  clientError({ message, status: 0, code: ClientErrorCode.InvalidRequest });\n\nexport const parseAgentDocument = async (input: string | object): Promise<AgentInfoIface> => {\n  let raw: unknown = input;\n  if (typeof input === 'string') {\n    try {\n      raw = JSON.parse(input);\n    } catch {\n      throw invalidDocument('The agent document is not JSON');\n    }\n  }\n  const parsed = agentDocumentSchema.safeParse(raw);\n  if (!parsed.success)\n    throw invalidDocument(`The agent document is not valid: ${parsed.error.message}`);\n  const document = parsed.data;\n  return agentInfoSchema.parse({\n    id: null,\n    name: document.identity.name,\n    hash: await agentDocumentHash(document),\n    document: jsonObjectSchema.parse(JSON.parse(JSON.stringify(document))),\n    require: agentRequireViewSchema.parse(document.require),\n    inProcess: inProcessCodeOf(document),\n    publishedAt: null,\n  });\n};\n\nexport const createProjectAgentsApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n  codec: AgentValueCodecIface;\n}): ProjectAgentsApiIface => {\n  const { http } = args.context;\n  const store: ProjectAgentsApiIface['store'] = async ({ agent, signal }) => {\n    const resolved = await resolveAgentInput(agent, args.codec);\n    await http.request({\n      method: HttpMethod.Put,\n      path: agentsPath(args.projectId, '/documents'),\n      body: {\n        schema: storeAgentDocumentRequestSchema,\n        value: {\n          document: jsonObjectSchema.parse(JSON.parse(JSON.stringify(resolved.document))),\n          hash: resolved.hash,\n        },\n      },\n      response: storeAgentDocumentResponseSchema,\n      signal,\n    });\n    return { hash: resolved.hash };\n  };\n  return {\n    get: ({ signal, ...selector }) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: agentsPath(args.projectId, '/lookup'),\n        query: {\n          name: 'name' in selector ? selector.name : undefined,\n          id: 'id' in selector ? selector.id : undefined,\n          hash: 'hash' in selector ? selector.hash : undefined,\n        },\n        response: agentInfoSchema,\n        signal,\n      }),\n    store,\n    publish: async ({ agent, name, visibility, signal }) => {\n      const { hash } = await store({ agent, signal });\n      return http.request({\n        method: HttpMethod.Post,\n        path: agentsPath(args.projectId, '/publish'),\n        body: { schema: publishAgentRequestSchema, value: { name, hash, visibility } },\n        response: publishAgentResponseSchema,\n        signal,\n      });\n    },\n    parse: parseAgentDocument,\n    history: ({ signal, ...query }) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: agentsPath(args.projectId, '/history'),\n        query,\n        response: agentHistorySchema,\n        signal,\n      }),\n    list: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: '/v1/agents',\n        query: { projectId: args.projectId, cursor: options?.cursor, limit: options?.limit },\n        response: agentListSchema,\n        signal: options?.signal,\n      }),\n  };\n};\n"],
+  "mappings": "AAAA,SAAS,wBAAwB;AACjC;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,yBAAqE;AAC9E;AAAA,EACE;AAAA,OAIK;AACP,SAAS,aAAa,uBAAuB;AAC7C,SAAS,kBAAkB;AAyC3B,MAAM,aAAa,CAAC,WAAmB,WACrC,gBAAgB,WAAW,SAAS,CAAC,UAAU,MAAM;AAEvD,MAAM,kBAAkB,CAAC,YACvB,YAAY,EAAE,SAAS,QAAQ,GAAG,MAAM,gBAAgB,eAAe,CAAC;AAEnE,MAAM,qBAAqB,OAAO,UAAoD;AAC3F,MAAI,MAAe;AACnB,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI;AACF,YAAM,KAAK,MAAM,KAAK;AAAA,IACxB,QAAQ;AACN,YAAM,gBAAgB,gCAAgC;AAAA,IACxD;AAAA,EACF;AACA,QAAM,SAAS,oBAAoB,UAAU,GAAG;AAChD,MAAI,CAAC,OAAO;AACV,UAAM,gBAAgB,oCAAoC,OAAO,MAAM,OAAO,EAAE;AAClF,QAAM,WAAW,OAAO;AACxB,SAAO,gBAAgB,MAAM;AAAA,IAC3B,IAAI;AAAA,IACJ,MAAM,SAAS,SAAS;AAAA,IACxB,MAAM,MAAM,kBAAkB,QAAQ;AAAA,IACtC,UAAU,iBAAiB,MAAM,KAAK,MAAM,KAAK,UAAU,QAAQ,CAAC,CAAC;AAAA,IACrE,SAAS,uBAAuB,MAAM,SAAS,OAAO;AAAA,IACtD,WAAW,gBAAgB,QAAQ;AAAA,IACnC,aAAa;AAAA,EACf,CAAC;AACH;AAEO,MAAM,yBAAyB,CAAC,SAIV;AAC3B,QAAM,EAAE,KAAK,IAAI,KAAK;AACtB,QAAM,QAAwC,OAAO,EAAE,OAAO,OAAO,MAAM;AACzE,UAAM,WAAW,MAAM,kBAAkB,OAAO,KAAK,KAAK;AAC1D,UAAM,KAAK,QAAQ;AAAA,MACjB,QAAQ,WAAW;AAAA,MACnB,MAAM,WAAW,KAAK,WAAW,YAAY;AAAA,MAC7C,MAAM;AAAA,QACJ,QAAQ;AAAA,QACR,OAAO;AAAA,UACL,UAAU,iBAAiB,MAAM,KAAK,MAAM,KAAK,UAAU,SAAS,QAAQ,CAAC,CAAC;AAAA,UAC9E,MAAM,SAAS;AAAA,QACjB;AAAA,MACF;AAAA,MACA,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AACD,WAAO,EAAE,MAAM,SAAS,KAAK;AAAA,EAC/B;AACA,SAAO;AAAA,IACL,KAAK,CAAC,EAAE,QAAQ,GAAG,SAAS,MAC1B,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,WAAW,KAAK,WAAW,SAAS;AAAA,MAC1C,OAAO;AAAA,QACL,MAAM,UAAU,WAAW,SAAS,OAAO;AAAA,QAC3C,IAAI,QAAQ,WAAW,SAAS,KAAK;AAAA,QACrC,MAAM,UAAU,WAAW,SAAS,OAAO;AAAA,MAC7C;AAAA,MACA,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AAAA,IACH;AAAA,IACA,SAAS,OAAO,EAAE,OAAO,MAAM,YAAY,OAAO,MAAM;AACtD,YAAM,EAAE,KAAK,IAAI,MAAM,MAAM,EAAE,OAAO,OAAO,CAAC;AAC9C,aAAO,KAAK,QAAQ;AAAA,QAClB,QAAQ,WAAW;AAAA,QACnB,MAAM,WAAW,KAAK,WAAW,UAAU;AAAA,QAC3C,MAAM,EAAE,QAAQ,2BAA2B,OAAO,EAAE,MAAM,MAAM,WAAW,EAAE;AAAA,QAC7E,UAAU;AAAA,QACV;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IACA,OAAO;AAAA,IACP,SAAS,CAAC,EAAE,QAAQ,GAAG,MAAM,MAC3B,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,WAAW,KAAK,WAAW,UAAU;AAAA,MAC3C;AAAA,MACA,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AAAA,IACH,MAAM,CAAC,YACL,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM;AAAA,MACN,OAAO,EAAE,WAAW,KAAK,WAAW,QAAQ,SAAS,QAAQ,OAAO,SAAS,MAAM;AAAA,MACnF,UAAU;AAAA,MACV,QAAQ,SAAS;AAAA,IACnB,CAAC;AAAA,EACL;AACF;",
+  "names": []
+}

package/dist/modules/agent-client/project.d.mts

@@ -0,0 +1,43 @@
+import { type ChannelBindingsApiIface, type ChannelSourceOf, type ProjectChannelsApiIface } from "./channels.mjs";
+import { type ClientContextIface } from "./context.mjs";
+import { type ProjectConversationsApiIface } from "./conversations.mjs";
+import { type EventsApiIface, type EventSubscriptionsApiIface } from "./events.mjs";
+import { type AcpAdaptersApiIface, type HarnessesApiIface } from "./harnesses.mjs";
+import { type IntegrationsApiIface } from "./integrations.mjs";
+import { type OAuthClientsApiIface, type SignInReturnOriginsApiIface } from "./oauth-clients.mjs";
+import { type ProjectAgentsApiIface } from "./project-agents.mjs";
+import { type ProjectResourceApiIface } from "./projects.mjs";
+import { type ProjectPublisherApiIface, type PublicNamesApiIface } from "./publishers.mjs";
+import { type SandboxProvidersApiIface } from "./sandbox-providers.mjs";
+import { type SandboxesApiIface, type SandboxSetupsApiIface } from "./sandboxes.mjs";
+import { type ProjectSessionsApiIface } from "./sessions.mjs";
+import type { AgentStartDepsIface } from "./start.mjs";
+export interface ProjectClientIface extends ProjectResourceApiIface {
+    readonly id: string;
+    sessions: ProjectSessionsApiIface;
+    conversations: ProjectConversationsApiIface;
+    agents: ProjectAgentsApiIface;
+    sandboxes: SandboxesApiIface;
+    sandboxSetups: SandboxSetupsApiIface;
+    integrations: IntegrationsApiIface;
+    harnesses: HarnessesApiIface;
+    acpAdapters: AcpAdaptersApiIface;
+    channels: ProjectChannelsApiIface & ChannelBindingsApiIface;
+    /** The event feed for this project and those below it. */
+    events: EventsApiIface;
+    /** Pushes this project's feed to a URL (`webhooks:write`, project admin). */
+    eventSubscriptions: EventSubscriptionsApiIface;
+    sandboxProviders: SandboxProvidersApiIface;
+    oauthClients: OAuthClientsApiIface;
+    signInReturnOrigins: SignInReturnOriginsApiIface;
+    /** The project's publisher handle. */
+    publisher: ProjectPublisherApiIface;
+    /** Which of the project's names resolve as `handle/name` from any organization. */
+    publicNames: PublicNamesApiIface;
+}
+export declare const createProjectClient: (args: {
+    context: ClientContextIface;
+    start: AgentStartDepsIface;
+    channelSourceOf: ChannelSourceOf;
+    projectId: string;
+}) => ProjectClientIface;