@finalai/agents 0.13.0 → 0.15.0

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

@@ -1,8 +1,4 @@
 import type { AgentValueCodecIface } from "./agent-input.mjs";
 import { type ChannelSourceOf } from "./channels.mjs";
-import type { HttpIface } from "./http.mjs";
-import type { LocalComputeIface, LocalHostSocketIface } from "./local-host.mjs";
 export declare const defaultAgentCodec: AgentValueCodecIface;
 export declare const defaultChannelSourceOf: ChannelSourceOf;
-export declare const defaultLocalCompute: () => LocalComputeIface;
-export declare const defaultLocalHostDial: (http: HttpIface) => (path: string, signal?: AbortSignal) => Promise<LocalHostSocketIface>;

package/dist/modules/agent-client/defaults.mjs

@@ -1,9 +1,6 @@
-import { connectSandboxClient } from "@finalai/agent-provider/sandbox/client";
-import { frameChannelFromWebSocket } from "@finalai/agent-provider/sandbox/wire";
 import * as z from "zod";
 import { noChannelSource } from "./channels.mjs";
 import { clientError, ClientErrorCode } from "./errors.mjs";
-import { LOCAL_HOST_SUBPROTOCOL } from "./local-host-protocol.mjs";
 const agentValueSchema = z.custom(
   (value) => typeof value === "object" && value != null && "require" in value && "name" in value,
   "Not an agent: define it with defineAgent, or fetch it with project.agents.get"
@@ -22,56 +19,8 @@ const defaultAgentCodec = {
   inProcessCodeOf: async (agent) => (await import("@finalai/agent-definition")).inProcessCodeOf(agentValueOf(agent))
 };
 const defaultChannelSourceOf = noChannelSource;
-const defaultLocalCompute = () => ({
-  sandbox: async () => {
-    const { createLocalSandbox } = await import("@finalai/final-agent-provider/sandboxes/local");
-    return createLocalSandbox({ root: globalThis.process.cwd() });
-  },
-  openSandbox: (endpoint) => connectSandboxClient({
-    url: endpoint.url,
-    token: endpoint.token,
-    expiresAt: endpoint.expiresAt
-  })
-});
-const defaultLocalHostDial = (http) => async (path, signal) => {
-  const url = http.url(path);
-  url.protocol = url.protocol === "http:" ? "ws:" : "wss:";
-  const headers = await http.headers();
-  const { WebSocket } = await import("ws");
-  signal?.throwIfAborted();
-  const socket = new WebSocket(url, [LOCAL_HOST_SUBPROTOCOL], { headers });
-  let tcp = null;
-  let referenced = true;
-  socket.on("upgrade", (response) => {
-    tcp = response.socket;
-    if (!referenced) tcp.unref();
-  });
-  const { channel, opened } = frameChannelFromWebSocket(socket);
-  const onAbort = () => socket.terminate();
-  signal?.addEventListener("abort", onAbort, { once: true });
-  try {
-    await opened;
-  } finally {
-    signal?.removeEventListener("abort", onAbort);
-  }
-  return {
-    ...channel,
-    keepAlive: {
-      ref: () => {
-        referenced = true;
-        tcp?.ref();
-      },
-      unref: () => {
-        referenced = false;
-        tcp?.unref();
-      }
-    }
-  };
-};
 export {
   defaultAgentCodec,
-  defaultChannelSourceOf,
-  defaultLocalCompute,
-  defaultLocalHostDial
+  defaultChannelSourceOf
 };
 //# sourceMappingURL=defaults.mjs.map

package/dist/modules/agent-client/defaults.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/defaults.ts"],
-  "sourcesContent": ["import type { AgentIface } from '@finalai/agent-definition';\nimport { connectSandboxClient } from '@finalai/agent-provider/sandbox/client';\nimport { frameChannelFromWebSocket } from '@finalai/agent-provider/sandbox/wire';\nimport * as z from 'zod';\nimport type { AgentValueCodecIface } from \"./agent-input.mjs\";\nimport { noChannelSource, type ChannelSourceOf } from \"./channels.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\nimport type { HttpIface } from \"./http.mjs\";\nimport { LOCAL_HOST_SUBPROTOCOL } from \"./local-host-protocol.mjs\";\nimport type { LocalComputeIface, LocalHostSocketIface } from \"./local-host.mjs\";\n\n// What `createClient` uses unless a seam replaces it.\n\nconst agentValueSchema = z.custom<AgentIface>(\n  (value) => typeof value === 'object' && value != null && 'require' in value && 'name' in value,\n  'Not an agent: define it with defineAgent, or fetch it with project.agents.get',\n);\n\nconst agentValueOf = (agent: object): AgentIface => {\n  const value = agentValueSchema.safeParse(agent);\n  if (value.success) return value.data;\n  throw clientError({\n    message: value.error.issues[0]?.message ?? 'Not an agent',\n    status: 0,\n    code: ClientErrorCode.InvalidRequest,\n  });\n};\n\n// Loaded on first use, so browser bundles of the client leave the authoring\n// code (and its source parser) out until an agent value is started.\nexport const defaultAgentCodec: AgentValueCodecIface = {\n  documentOf: async (agent) =>\n    (await import('@finalai/agent-definition')).documentOf(agentValueOf(agent)),\n  inProcessCodeOf: async (agent) =>\n    (await import('@finalai/agent-definition')).inProcessCodeOf(agentValueOf(agent)),\n};\n\nexport const defaultChannelSourceOf: ChannelSourceOf = noChannelSource;\n\n// The model's files and shell are this process's working directory, as for a\n// coding agent run on this machine. Loaded on use: it needs Node.\nexport const defaultLocalCompute = (): LocalComputeIface => ({\n  sandbox: async () => {\n    const { createLocalSandbox } = await import('@finalai/final-agent-provider/sandboxes/local');\n    return createLocalSandbox({ root: globalThis.process.cwd() });\n  },\n  openSandbox: (endpoint) =>\n    connectSandboxClient({\n      url: endpoint.url,\n      token: endpoint.token,\n      expiresAt: endpoint.expiresAt,\n    }),\n});\n\n// The local host socket is dialed from Node with the client's own headers. It\n// keeps the process alive only while the host starts or is in use (see\n// LocalHostKeepAliveIface), so a script that is done exits and the platform\n// reports its tools and compute as unavailable.\nexport const defaultLocalHostDial =\n  (http: HttpIface) =>\n  async (path: string, signal?: AbortSignal): Promise<LocalHostSocketIface> => {\n    const url = http.url(path);\n    url.protocol = url.protocol === 'http:' ? 'ws:' : 'wss:';\n    const headers = await http.headers();\n    const { WebSocket } = await import('ws');\n    signal?.throwIfAborted();\n    const socket = new WebSocket(url, [LOCAL_HOST_SUBPROTOCOL], { headers });\n    let tcp: { ref: () => unknown; unref: () => unknown } | null = null;\n    let referenced = true;\n    socket.on('upgrade', (response) => {\n      tcp = response.socket;\n      if (!referenced) tcp.unref();\n    });\n    const { channel, opened } = frameChannelFromWebSocket(socket);\n    // Aborting while the socket opens tears it down, which rejects `opened`.\n    const onAbort = () => socket.terminate();\n    signal?.addEventListener('abort', onAbort, { once: true });\n    try {\n      await opened;\n    } finally {\n      signal?.removeEventListener('abort', onAbort);\n    }\n    return {\n      ...channel,\n      keepAlive: {\n        ref: () => {\n          referenced = true;\n          tcp?.ref();\n        },\n        unref: () => {\n          referenced = false;\n          tcp?.unref();\n        },\n      },\n    };\n  };\n"],
-  "mappings": "AACA,SAAS,4BAA4B;AACrC,SAAS,iCAAiC;AAC1C,YAAY,OAAO;AAEnB,SAAS,uBAA6C;AACtD,SAAS,aAAa,uBAAuB;AAE7C,SAAS,8BAA8B;AAKvC,MAAM,mBAAmB,EAAE;AAAA,EACzB,CAAC,UAAU,OAAO,UAAU,YAAY,SAAS,QAAQ,aAAa,SAAS,UAAU;AAAA,EACzF;AACF;AAEA,MAAM,eAAe,CAAC,UAA8B;AAClD,QAAM,QAAQ,iBAAiB,UAAU,KAAK;AAC9C,MAAI,MAAM,QAAS,QAAO,MAAM;AAChC,QAAM,YAAY;AAAA,IAChB,SAAS,MAAM,MAAM,OAAO,CAAC,GAAG,WAAW;AAAA,IAC3C,QAAQ;AAAA,IACR,MAAM,gBAAgB;AAAA,EACxB,CAAC;AACH;AAIO,MAAM,oBAA0C;AAAA,EACrD,YAAY,OAAO,WAChB,MAAM,OAAO,2BAA2B,GAAG,WAAW,aAAa,KAAK,CAAC;AAAA,EAC5E,iBAAiB,OAAO,WACrB,MAAM,OAAO,2BAA2B,GAAG,gBAAgB,aAAa,KAAK,CAAC;AACnF;AAEO,MAAM,yBAA0C;AAIhD,MAAM,sBAAsB,OAA0B;AAAA,EAC3D,SAAS,YAAY;AACnB,UAAM,EAAE,mBAAmB,IAAI,MAAM,OAAO,+CAA+C;AAC3F,WAAO,mBAAmB,EAAE,MAAM,WAAW,QAAQ,IAAI,EAAE,CAAC;AAAA,EAC9D;AAAA,EACA,aAAa,CAAC,aACZ,qBAAqB;AAAA,IACnB,KAAK,SAAS;AAAA,IACd,OAAO,SAAS;AAAA,IAChB,WAAW,SAAS;AAAA,EACtB,CAAC;AACL;AAMO,MAAM,uBACX,CAAC,SACD,OAAO,MAAc,WAAwD;AAC3E,QAAM,MAAM,KAAK,IAAI,IAAI;AACzB,MAAI,WAAW,IAAI,aAAa,UAAU,QAAQ;AAClD,QAAM,UAAU,MAAM,KAAK,QAAQ;AACnC,QAAM,EAAE,UAAU,IAAI,MAAM,OAAO,IAAI;AACvC,UAAQ,eAAe;AACvB,QAAM,SAAS,IAAI,UAAU,KAAK,CAAC,sBAAsB,GAAG,EAAE,QAAQ,CAAC;AACvE,MAAI,MAA2D;AAC/D,MAAI,aAAa;AACjB,SAAO,GAAG,WAAW,CAAC,aAAa;AACjC,UAAM,SAAS;AACf,QAAI,CAAC,WAAY,KAAI,MAAM;AAAA,EAC7B,CAAC;AACD,QAAM,EAAE,SAAS,OAAO,IAAI,0BAA0B,MAAM;AAE5D,QAAM,UAAU,MAAM,OAAO,UAAU;AACvC,UAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;AACzD,MAAI;AACF,UAAM;AAAA,EACR,UAAE;AACA,YAAQ,oBAAoB,SAAS,OAAO;AAAA,EAC9C;AACA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,WAAW;AAAA,MACT,KAAK,MAAM;AACT,qBAAa;AACb,aAAK,IAAI;AAAA,MACX;AAAA,MACA,OAAO,MAAM;AACX,qBAAa;AACb,aAAK,MAAM;AAAA,MACb;AAAA,IACF;AAAA,EACF;AACF;",
+  "sourcesContent": ["import type { AgentIface } from '@finalai/agent-definition';\nimport * as z from 'zod';\nimport type { AgentValueCodecIface } from \"./agent-input.mjs\";\nimport { noChannelSource, type ChannelSourceOf } from \"./channels.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\n\n// What `createClient` uses unless a seam replaces it, in every runtime.\n\nconst agentValueSchema = z.custom<AgentIface>(\n  (value) => typeof value === 'object' && value != null && 'require' in value && 'name' in value,\n  'Not an agent: define it with defineAgent, or fetch it with project.agents.get',\n);\n\nconst agentValueOf = (agent: object): AgentIface => {\n  const value = agentValueSchema.safeParse(agent);\n  if (value.success) return value.data;\n  throw clientError({\n    message: value.error.issues[0]?.message ?? 'Not an agent',\n    status: 0,\n    code: ClientErrorCode.InvalidRequest,\n  });\n};\n\n// Loaded on first use, so browser bundles of the client leave the authoring\n// code (and its source parser) out until an agent value is started.\nexport const defaultAgentCodec: AgentValueCodecIface = {\n  documentOf: async (agent) =>\n    (await import('@finalai/agent-definition')).documentOf(agentValueOf(agent)),\n  inProcessCodeOf: async (agent) =>\n    (await import('@finalai/agent-definition')).inProcessCodeOf(agentValueOf(agent)),\n};\n\nexport const defaultChannelSourceOf: ChannelSourceOf = noChannelSource;\n"],
+  "mappings": "AACA,YAAY,OAAO;AAEnB,SAAS,uBAA6C;AACtD,SAAS,aAAa,uBAAuB;AAI7C,MAAM,mBAAmB,EAAE;AAAA,EACzB,CAAC,UAAU,OAAO,UAAU,YAAY,SAAS,QAAQ,aAAa,SAAS,UAAU;AAAA,EACzF;AACF;AAEA,MAAM,eAAe,CAAC,UAA8B;AAClD,QAAM,QAAQ,iBAAiB,UAAU,KAAK;AAC9C,MAAI,MAAM,QAAS,QAAO,MAAM;AAChC,QAAM,YAAY;AAAA,IAChB,SAAS,MAAM,MAAM,OAAO,CAAC,GAAG,WAAW;AAAA,IAC3C,QAAQ;AAAA,IACR,MAAM,gBAAgB;AAAA,EACxB,CAAC;AACH;AAIO,MAAM,oBAA0C;AAAA,EACrD,YAAY,OAAO,WAChB,MAAM,OAAO,2BAA2B,GAAG,WAAW,aAAa,KAAK,CAAC;AAAA,EAC5E,iBAAiB,OAAO,WACrB,MAAM,OAAO,2BAA2B,GAAG,gBAAgB,aAAa,KAAK,CAAC;AACnF;AAEO,MAAM,yBAA0C;",
   "names": []
 }

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

@@ -1,33 +1,2 @@
-export * from '@finalai/agent-protocol/agent-platform';
-export { Capability, FilesAccess, ScreenAccess, ShellAccess, type CapabilityAccess, } from '@finalai/agent-protocol';
-export { AcpAuthMode, type AcpApiIface, type AcpConnectArgsIface } from "./acp.mjs";
-export { createTextCollector, isUserMessageFor, sessionUpdateOf, textOf, turnEndOf, type AcpSessionUpdateIface, type TurnEndIface, } from "./acp-frames.mjs";
-export type { AgentInput, AgentValue, AgentValueCodecIface } from "./agent-input.mjs";
-export type { ActorOptionIface, ChannelAppsApiIface, ChannelBindingsApiIface, ChannelSourceIface, ChannelSourceOf, ChannelTicketsApiIface, IdentityLinksApiIface, InstallChannelArgsIface, ProjectChannelsApiIface, PublishChannelArgsIface, UpdateChannelBindingArgsIface, } from "./channels.mjs";
-export { DEFAULT_AGENTS_HOST, createClient, type AgentClientIface, type AgentsApiIface, type AppApiIface, type CreateClientOptionsIface, type DecisionsApiIface, type InferenceApiIface, type PeopleApiIface, type PlatformIdentityApiIface, type RealtimeApiIface, } from "./client.mjs";
-export { CollectionEventKind, CollectionResyncReason, type CollectionEvent, type CollectionEventsOptionsIface, type CollectionResyncEventIface, } from "./collection-events.mjs";
-export { ConfigOptionCategory, configSelectFor, configSelectsOf, type ConfigSelectChoiceIface, type ConfigSelectIface, type SessionConfigOptionIface, } from "./config-options.mjs";
-export type { EnumInput, SignalOptionsIface } from "./context.mjs";
-export type { ConversationChannelRoutesApiIface, ConversationContextApiIface, ConversationContextEntryInputIface, ConversationDecisionsApiIface, ConversationInputsApiIface, ConversationLabelsApiIface, ConversationReadGrantsApiIface, ConversationResourcesIface, ResourceSubscriptionsApiIface, SendInputArgsIface, } from "./conversation-resources.mjs";
-export { TURN_OPEN_SESSION_STATES, isNewerMessageVersion, messageVersionOf, type MessageVersionIface, } from "./conversations.mjs";
-export type { ConversationAgentTurnIface, ConversationEvent, ConversationEventMetaIface, ConversationEventsOptionsIface, ConversationHandleIface, ConversationsApiIface, CreateConversationArgsIface, ListMessagesOptionsIface, OpenedConversationIface, ParticipantCreateInput, ParticipantsApiIface, ProjectConversationsApiIface, SandboxFileContentArgsIface, SandboxFileContentRequestIface, SendMessageOptionsIface, SentMessageIface, UploadAttachmentArgsIface, } from "./conversations.mjs";
-export { AgentClientErrorName, ClientErrorCode, DecisionErrorReason, clientError, decisionError, isClientError, isDecisionError, isRealtimeSubscriptionError, isRequirementsUnmetError, isTerminalRealtimeError, isTurnRejectedError, realtimeSubscriptionError, requirementsUnmetError, turnRejectedError, type AgentClientError, type ClientErrorIface, type DecisionErrorIface, type RealtimeSubscriptionErrorIface, type RequirementsUnmetErrorIface, type TurnRejectedErrorIface, } from "./errors.mjs";
-export { EVENTS_POLL_INTERVAL_MS, type EventsApiIface, type EventSubscriptionsApiIface, type ListEventsOptionsIface, type StreamEventsOptionsIface, } from "./events.mjs";
-export { defaultStreamTiming, type StreamTimingIface } from "./frame-stream.mjs";
-export type { AgentClientAuth, FetchIface, HeadersOption } from "./http.mjs";
-export type { AcpAdaptersApiIface, DefinitionSelectorIface, HarnessesApiIface, SubscriptionAllowancesApiIface, } from "./harnesses.mjs";
-export type { IntegrationsApiIface } from "./integrations.mjs";
-export { SessionLiveEventKind, type SessionLiveEvent } from "./live-stream.mjs";
-export type { LocalComputeIface } from "./local-host.mjs";
-export type { OAuthClientsApiIface, SignInReturnOriginsApiIface } from "./oauth-clients.mjs";
-export type { ProjectClientIface } from "./project.mjs";
-export type { AgentSelectorIface, ProjectAgentsApiIface } from "./project-agents.mjs";
-export type { ProjectApiKeysApiIface, ProjectMembersApiIface, ProjectResourceApiIface, ProjectsApiIface, } from "./projects.mjs";
-export type { ProjectPublisherApiIface, PublicNamesApiIface, PublisherHandleIface, PublishersApiIface, } from "./publishers.mjs";
-export { provideDocumentOf, resourceIdOf, type ProvideIface, type ProvidePatchIface, type ResourceRef, type ResourceRefIface, } from "./provide.mjs";
-export { createGatewayRealtimeTransport, type GatewayConnect, type GatewayConnectionIface, type GatewayRealtimeTransportOptionsIface, type RealtimeSubscribeOptionsIface, type RealtimeTransportFrameIface, type RealtimeTransportIface, } from "./realtime.mjs";
-export { SANDBOX_FILE_URI_SCHEME, createSandboxFileUri, parseSandboxFileUri, type SandboxFileTargetIface, } from "./sandbox-uri.mjs";
-export type { SandboxProvidersApiIface } from "./sandbox-providers.mjs";
-export type { CreateSandboxOptionsIface, SandboxEnvironmentValueIface, SandboxHandleIface, SandboxOwnerIface, SandboxSetupRefIface, SandboxSetupsApiIface, SandboxesApiIface, } from "./sandboxes.mjs";
-export type { ProjectSchedulesApiIface } from "./schedules.mjs";
-export type { CreateSessionArgsIface, CreatedSessionIface, ForkSessionOptionsIface, ProjectSessionsApiIface, RespondArgs, SendOptionsIface, SessionHandleIface, SessionsApiIface, StreamOptionsIface, TurnHandleIface, TurnResultIface, } from "./sessions.mjs";
+export * from "./api.mjs";
+export { createClient } from "./node.mjs";

package/dist/modules/agent-client/index.mjs

@@ -1,112 +1,6 @@
-export * from "@finalai/agent-protocol/agent-platform";
-import {
-  Capability,
-  FilesAccess,
-  ScreenAccess,
-  ShellAccess
-} from "@finalai/agent-protocol";
-import { AcpAuthMode } from "./acp.mjs";
-import {
-  createTextCollector,
-  isUserMessageFor,
-  sessionUpdateOf,
-  textOf,
-  turnEndOf
-} from "./acp-frames.mjs";
-import {
-  DEFAULT_AGENTS_HOST,
-  createClient
-} from "./client.mjs";
-import {
-  CollectionEventKind,
-  CollectionResyncReason
-} from "./collection-events.mjs";
-import {
-  ConfigOptionCategory,
-  configSelectFor,
-  configSelectsOf
-} from "./config-options.mjs";
-import {
-  TURN_OPEN_SESSION_STATES,
-  isNewerMessageVersion,
-  messageVersionOf
-} from "./conversations.mjs";
-import {
-  AgentClientErrorName,
-  ClientErrorCode,
-  DecisionErrorReason,
-  clientError,
-  decisionError,
-  isClientError,
-  isDecisionError,
-  isRealtimeSubscriptionError,
-  isRequirementsUnmetError,
-  isTerminalRealtimeError,
-  isTurnRejectedError,
-  realtimeSubscriptionError,
-  requirementsUnmetError,
-  turnRejectedError
-} from "./errors.mjs";
-import {
-  EVENTS_POLL_INTERVAL_MS
-} from "./events.mjs";
-import { defaultStreamTiming } from "./frame-stream.mjs";
-import { SessionLiveEventKind } from "./live-stream.mjs";
-import {
-  provideDocumentOf,
-  resourceIdOf
-} from "./provide.mjs";
-import {
-  createGatewayRealtimeTransport
-} from "./realtime.mjs";
-import {
-  SANDBOX_FILE_URI_SCHEME,
-  createSandboxFileUri,
-  parseSandboxFileUri
-} from "./sandbox-uri.mjs";
+export * from "./api.mjs";
+import { createClient } from "./node.mjs";
 export {
-  AcpAuthMode,
-  AgentClientErrorName,
-  Capability,
-  ClientErrorCode,
-  CollectionEventKind,
-  CollectionResyncReason,
-  ConfigOptionCategory,
-  DEFAULT_AGENTS_HOST,
-  DecisionErrorReason,
-  EVENTS_POLL_INTERVAL_MS,
-  FilesAccess,
-  SANDBOX_FILE_URI_SCHEME,
-  ScreenAccess,
-  SessionLiveEventKind,
-  ShellAccess,
-  TURN_OPEN_SESSION_STATES,
-  clientError,
-  configSelectFor,
-  configSelectsOf,
-  createClient,
-  createGatewayRealtimeTransport,
-  createSandboxFileUri,
-  createTextCollector,
-  decisionError,
-  defaultStreamTiming,
-  isClientError,
-  isDecisionError,
-  isNewerMessageVersion,
-  isRealtimeSubscriptionError,
-  isRequirementsUnmetError,
-  isTerminalRealtimeError,
-  isTurnRejectedError,
-  isUserMessageFor,
-  messageVersionOf,
-  parseSandboxFileUri,
-  provideDocumentOf,
-  realtimeSubscriptionError,
-  requirementsUnmetError,
-  resourceIdOf,
-  sessionUpdateOf,
-  textOf,
-  turnEndOf,
-  turnRejectedError
+  createClient
 };
 //# sourceMappingURL=index.mjs.map

package/dist/modules/agent-client/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/index.ts"],
-  "sourcesContent": ["// `@finalai/agents/client`: the agent platform client SDK.\n// Wire types come from `@finalai/agent-protocol/agent-platform`, re-exported\n// here so consumers need one import.\n\nexport * from '@finalai/agent-protocol/agent-platform';\nexport {\n  Capability,\n  FilesAccess,\n  ScreenAccess,\n  ShellAccess,\n  type CapabilityAccess,\n} from '@finalai/agent-protocol';\nexport { AcpAuthMode, type AcpApiIface, type AcpConnectArgsIface } from \"./acp.mjs\";\nexport {\n  createTextCollector,\n  isUserMessageFor,\n  sessionUpdateOf,\n  textOf,\n  turnEndOf,\n  type AcpSessionUpdateIface,\n  type TurnEndIface,\n} from \"./acp-frames.mjs\";\nexport type { AgentInput, AgentValue, AgentValueCodecIface } from \"./agent-input.mjs\";\nexport type {\n  ActorOptionIface,\n  ChannelAppsApiIface,\n  ChannelBindingsApiIface,\n  ChannelSourceIface,\n  ChannelSourceOf,\n  ChannelTicketsApiIface,\n  IdentityLinksApiIface,\n  InstallChannelArgsIface,\n  ProjectChannelsApiIface,\n  PublishChannelArgsIface,\n  UpdateChannelBindingArgsIface,\n} from \"./channels.mjs\";\nexport {\n  DEFAULT_AGENTS_HOST,\n  createClient,\n  type AgentClientIface,\n  type AgentsApiIface,\n  type AppApiIface,\n  type CreateClientOptionsIface,\n  type DecisionsApiIface,\n  type InferenceApiIface,\n  type PeopleApiIface,\n  type PlatformIdentityApiIface,\n  type RealtimeApiIface,\n} from \"./client.mjs\";\nexport {\n  CollectionEventKind,\n  CollectionResyncReason,\n  type CollectionEvent,\n  type CollectionEventsOptionsIface,\n  type CollectionResyncEventIface,\n} from \"./collection-events.mjs\";\nexport {\n  ConfigOptionCategory,\n  configSelectFor,\n  configSelectsOf,\n  type ConfigSelectChoiceIface,\n  type ConfigSelectIface,\n  type SessionConfigOptionIface,\n} from \"./config-options.mjs\";\nexport type { EnumInput, SignalOptionsIface } from \"./context.mjs\";\nexport type {\n  ConversationChannelRoutesApiIface,\n  ConversationContextApiIface,\n  ConversationContextEntryInputIface,\n  ConversationDecisionsApiIface,\n  ConversationInputsApiIface,\n  ConversationLabelsApiIface,\n  ConversationReadGrantsApiIface,\n  ConversationResourcesIface,\n  ResourceSubscriptionsApiIface,\n  SendInputArgsIface,\n} from \"./conversation-resources.mjs\";\nexport {\n  TURN_OPEN_SESSION_STATES,\n  isNewerMessageVersion,\n  messageVersionOf,\n  type MessageVersionIface,\n} from \"./conversations.mjs\";\nexport type {\n  ConversationAgentTurnIface,\n  ConversationEvent,\n  ConversationEventMetaIface,\n  ConversationEventsOptionsIface,\n  ConversationHandleIface,\n  ConversationsApiIface,\n  CreateConversationArgsIface,\n  ListMessagesOptionsIface,\n  OpenedConversationIface,\n  ParticipantCreateInput,\n  ParticipantsApiIface,\n  ProjectConversationsApiIface,\n  SandboxFileContentArgsIface,\n  SandboxFileContentRequestIface,\n  SendMessageOptionsIface,\n  SentMessageIface,\n  UploadAttachmentArgsIface,\n} from \"./conversations.mjs\";\nexport {\n  AgentClientErrorName,\n  ClientErrorCode,\n  DecisionErrorReason,\n  clientError,\n  decisionError,\n  isClientError,\n  isDecisionError,\n  isRealtimeSubscriptionError,\n  isRequirementsUnmetError,\n  isTerminalRealtimeError,\n  isTurnRejectedError,\n  realtimeSubscriptionError,\n  requirementsUnmetError,\n  turnRejectedError,\n  type AgentClientError,\n  type ClientErrorIface,\n  type DecisionErrorIface,\n  type RealtimeSubscriptionErrorIface,\n  type RequirementsUnmetErrorIface,\n  type TurnRejectedErrorIface,\n} from \"./errors.mjs\";\nexport {\n  EVENTS_POLL_INTERVAL_MS,\n  type EventsApiIface,\n  type EventSubscriptionsApiIface,\n  type ListEventsOptionsIface,\n  type StreamEventsOptionsIface,\n} from \"./events.mjs\";\nexport { defaultStreamTiming, type StreamTimingIface } from \"./frame-stream.mjs\";\nexport type { AgentClientAuth, FetchIface, HeadersOption } from \"./http.mjs\";\nexport type {\n  AcpAdaptersApiIface,\n  DefinitionSelectorIface,\n  HarnessesApiIface,\n  SubscriptionAllowancesApiIface,\n} from \"./harnesses.mjs\";\nexport type { IntegrationsApiIface } from \"./integrations.mjs\";\nexport { SessionLiveEventKind, type SessionLiveEvent } from \"./live-stream.mjs\";\nexport type { LocalComputeIface } from \"./local-host.mjs\";\nexport type { OAuthClientsApiIface, SignInReturnOriginsApiIface } from \"./oauth-clients.mjs\";\nexport type { ProjectClientIface } from \"./project.mjs\";\nexport type { AgentSelectorIface, ProjectAgentsApiIface } from \"./project-agents.mjs\";\nexport type {\n  ProjectApiKeysApiIface,\n  ProjectMembersApiIface,\n  ProjectResourceApiIface,\n  ProjectsApiIface,\n} from \"./projects.mjs\";\nexport type {\n  ProjectPublisherApiIface,\n  PublicNamesApiIface,\n  PublisherHandleIface,\n  PublishersApiIface,\n} from \"./publishers.mjs\";\nexport {\n  provideDocumentOf,\n  resourceIdOf,\n  type ProvideIface,\n  type ProvidePatchIface,\n  type ResourceRef,\n  type ResourceRefIface,\n} from \"./provide.mjs\";\nexport {\n  createGatewayRealtimeTransport,\n  type GatewayConnect,\n  type GatewayConnectionIface,\n  type GatewayRealtimeTransportOptionsIface,\n  type RealtimeSubscribeOptionsIface,\n  type RealtimeTransportFrameIface,\n  type RealtimeTransportIface,\n} from \"./realtime.mjs\";\nexport {\n  SANDBOX_FILE_URI_SCHEME,\n  createSandboxFileUri,\n  parseSandboxFileUri,\n  type SandboxFileTargetIface,\n} from \"./sandbox-uri.mjs\";\nexport type { SandboxProvidersApiIface } from \"./sandbox-providers.mjs\";\nexport type {\n  CreateSandboxOptionsIface,\n  SandboxEnvironmentValueIface,\n  SandboxHandleIface,\n  SandboxOwnerIface,\n  SandboxSetupRefIface,\n  SandboxSetupsApiIface,\n  SandboxesApiIface,\n} from \"./sandboxes.mjs\";\nexport type { ProjectSchedulesApiIface } from \"./schedules.mjs\";\nexport type {\n  CreateSessionArgsIface,\n  CreatedSessionIface,\n  ForkSessionOptionsIface,\n  ProjectSessionsApiIface,\n  RespondArgs,\n  SendOptionsIface,\n  SessionHandleIface,\n  SessionsApiIface,\n  StreamOptionsIface,\n  TurnHandleIface,\n  TurnResultIface,\n} from \"./sessions.mjs\";\n"],
-  "mappings": "AAIA,cAAc;AACd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,mBAA+D;AACxE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAeP;AAAA,EACE;AAAA,EACA;AAAA,OAUK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAcP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAoBP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAOK;AACP;AAAA,EACE;AAAA,OAKK;AACP,SAAS,2BAAmD;AAS5D,SAAS,4BAAmD;AAiB5D;AAAA,EACE;AAAA,EACA;AAAA,OAKK;AACP;AAAA,EACE;AAAA,OAOK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;",
+  "sourcesContent": ["// `@finalai/agents/client`: the agent platform client SDK, as Node resolves it.\n// Browsers, React Native and Workers resolve portable.ts: the same exports.\n\nexport * from \"./api.mjs\";\nexport { createClient } from \"./node.mjs\";\n"],
+  "mappings": "AAGA,cAAc;AACd,SAAS,oBAAoB;",
   "names": []
 }

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

@@ -1,4 +1,4 @@
-import { type CompleteSignInResponseIface, type CreateIntegrationRequestIface, type IntegrationIface, type IntegrationListIface, type StartSignInResponseIface } from '@finalai/agent-protocol/agent-platform';
+import { type CompleteSignInResponseIface, type CreateIntegrationRequestIface, type IntegrationIface, type IntegrationListIface, type StartSignInResponseIface, type UpdateIntegrationRequestIface } from '@finalai/agent-protocol/agent-platform';
 import { type ClientContextIface, type SignalOptionsIface } from "./context.mjs";
 export interface IntegrationsApiIface {
     /** Names are unique in a project. Returns the integration; pass it in `provide.integrations`. */
@@ -12,6 +12,10 @@ export interface IntegrationsApiIface {
         cursor?: string;
         limit?: number;
     }) => Promise<IntegrationListIface>;
+    /** Changes it in place: the id, and so every `provide` naming it, stays. */
+    update: (args: {
+        id: string;
+    } & UpdateIntegrationRequestIface & SignalOptionsIface) => Promise<IntegrationIface>;
     delete: (args: {
         id: string;
     } & SignalOptionsIface) => Promise<void>;

package/dist/modules/agent-client/integrations.mjs

@@ -6,7 +6,8 @@ import {
   integrationSchema,
   okResponseSchema,
   startSignInRequestSchema,
-  startSignInResponseSchema
+  startSignInResponseSchema,
+  updateIntegrationRequestSchema
 } from "@finalai/agent-protocol/agent-platform";
 import { encodePath } from "./context.mjs";
 import { clientError, ClientErrorCode } from "./errors.mjs";
@@ -54,6 +55,13 @@ const createIntegrationsApi = (args) => {
       response: integrationListSchema,
       signal: options?.signal
     }),
+    update: ({ id, signal, ...value }) => http.request({
+      method: HttpMethod.Patch,
+      path: integrationPath(id),
+      body: { schema: updateIntegrationRequestSchema, value },
+      response: integrationSchema,
+      signal
+    }),
     delete: async ({ id, signal }) => {
       await http.request({
         method: HttpMethod.Delete,

package/dist/modules/agent-client/integrations.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/integrations.ts"],
-  "sourcesContent": ["import {\n  completeSignInRequestSchema,\n  completeSignInResponseSchema,\n  createIntegrationRequestSchema,\n  integrationListSchema,\n  integrationSchema,\n  okResponseSchema,\n  startSignInRequestSchema,\n  startSignInResponseSchema,\n  type CompleteSignInResponseIface,\n  type CreateIntegrationRequestIface,\n  type IntegrationIface,\n  type IntegrationListIface,\n  type StartSignInResponseIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { encodePath, type ClientContextIface, type SignalOptionsIface } from \"./context.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\nimport { HttpMethod } from \"./http.mjs\";\n\n// Integrations (sources of tools: MCP servers, Final's gateway among them),\n// scoped to one project.\n\nexport interface IntegrationsApiIface {\n  /** Names are unique in a project. Returns the integration; pass it in `provide.integrations`. */\n  create: (args: CreateIntegrationRequestIface & SignalOptionsIface) => Promise<IntegrationIface>;\n  get: (\n    selector: ({ name: string } | { id: string }) & SignalOptionsIface,\n  ) => Promise<IntegrationIface>;\n  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number },\n  ) => Promise<IntegrationListIface>;\n  delete: (args: { id: string } & SignalOptionsIface) => Promise<void>;\n  /**\n   * Starts the caller's own sign-in: an authorization URL to open. Pass the\n   * sign-in decision's id to resolve it when the sign-in completes.\n   */\n  signIn: (\n    args: { id: string; returnUrl?: string; decisionId?: string } & SignalOptionsIface,\n  ) => Promise<StartSignInResponseIface>;\n  /** Activates a sign-in with the `state` and `code` the provider redirected with. */\n  completeSignIn: (\n    args: { state: string; code: string } & SignalOptionsIface,\n  ) => Promise<CompleteSignInResponseIface>;\n  /** Forgets the caller's own sign-in. */\n  signOut: (args: { id: string } & SignalOptionsIface) => Promise<void>;\n}\n\nconst projectPath = (projectId: string, suffix: string): string =>\n  `/v1/projects/${encodePath(projectId)}${suffix}`;\n\nexport const createIntegrationsApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n}): IntegrationsApiIface => {\n  const { http } = args.context;\n  const integrationPath = (id: string, suffix = '') =>\n    projectPath(args.projectId, `/integrations/${encodePath(id)}${suffix}`);\n  return {\n    create: ({ signal, ...value }) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: projectPath(args.projectId, '/integrations'),\n        body: { schema: createIntegrationRequestSchema, value },\n        response: integrationSchema,\n        signal,\n      }),\n    get: async ({ signal, ...selector }) => {\n      if ('id' in selector)\n        return http.request({\n          method: HttpMethod.Get,\n          path: integrationPath(selector.id),\n          response: integrationSchema,\n          signal,\n        });\n      const { integrations } = await http.request({\n        method: HttpMethod.Get,\n        path: projectPath(args.projectId, '/integrations'),\n        query: { name: selector.name },\n        response: integrationListSchema,\n        signal,\n      });\n      const found = integrations.find((integration) => integration.name === selector.name);\n      if (found == null)\n        throw clientError({\n          message: `No integration named ${selector.name} in this project`,\n          status: 404,\n          code: ClientErrorCode.NotFound,\n        });\n      return found;\n    },\n    list: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: projectPath(args.projectId, '/integrations'),\n        query: { cursor: options?.cursor, limit: options?.limit },\n        response: integrationListSchema,\n        signal: options?.signal,\n      }),\n    delete: async ({ id, signal }) => {\n      await http.request({\n        method: HttpMethod.Delete,\n        path: integrationPath(id),\n        response: okResponseSchema,\n        signal,\n      });\n    },\n    signIn: ({ id, signal, ...value }) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: integrationPath(id, '/sign-in'),\n        body: { schema: startSignInRequestSchema, value },\n        response: startSignInResponseSchema,\n        signal,\n      }),\n    completeSignIn: ({ signal, ...value }) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: '/v1/sign-ins/complete',\n        body: { schema: completeSignInRequestSchema, value },\n        response: completeSignInResponseSchema,\n        signal,\n      }),\n    signOut: async ({ id, signal }) => {\n      await http.request({\n        method: HttpMethod.Delete,\n        path: integrationPath(id, '/sign-in'),\n        response: okResponseSchema,\n        signal,\n      });\n    },\n  };\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  completeSignInRequestSchema,\n  completeSignInResponseSchema,\n  createIntegrationRequestSchema,\n  integrationListSchema,\n  integrationSchema,\n  okResponseSchema,\n  startSignInRequestSchema,\n  startSignInResponseSchema,\n  updateIntegrationRequestSchema,\n  type CompleteSignInResponseIface,\n  type CreateIntegrationRequestIface,\n  type IntegrationIface,\n  type IntegrationListIface,\n  type StartSignInResponseIface,\n  type UpdateIntegrationRequestIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { encodePath, type ClientContextIface, type SignalOptionsIface } from \"./context.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\nimport { HttpMethod } from \"./http.mjs\";\n\n// Integrations (sources of tools: MCP servers, Final's gateway among them),\n// scoped to one project.\n\nexport interface IntegrationsApiIface {\n  /** Names are unique in a project. Returns the integration; pass it in `provide.integrations`. */\n  create: (args: CreateIntegrationRequestIface & SignalOptionsIface) => Promise<IntegrationIface>;\n  get: (\n    selector: ({ name: string } | { id: string }) & SignalOptionsIface,\n  ) => Promise<IntegrationIface>;\n  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number },\n  ) => Promise<IntegrationListIface>;\n  /** Changes it in place: the id, and so every `provide` naming it, stays. */\n  update: (\n    args: { id: string } & UpdateIntegrationRequestIface & SignalOptionsIface,\n  ) => Promise<IntegrationIface>;\n  delete: (args: { id: string } & SignalOptionsIface) => Promise<void>;\n  /**\n   * Starts the caller's own sign-in: an authorization URL to open. Pass the\n   * sign-in decision's id to resolve it when the sign-in completes.\n   */\n  signIn: (\n    args: { id: string; returnUrl?: string; decisionId?: string } & SignalOptionsIface,\n  ) => Promise<StartSignInResponseIface>;\n  /** Activates a sign-in with the `state` and `code` the provider redirected with. */\n  completeSignIn: (\n    args: { state: string; code: string } & SignalOptionsIface,\n  ) => Promise<CompleteSignInResponseIface>;\n  /** Forgets the caller's own sign-in. */\n  signOut: (args: { id: string } & SignalOptionsIface) => Promise<void>;\n}\n\nconst projectPath = (projectId: string, suffix: string): string =>\n  `/v1/projects/${encodePath(projectId)}${suffix}`;\n\nexport const createIntegrationsApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n}): IntegrationsApiIface => {\n  const { http } = args.context;\n  const integrationPath = (id: string, suffix = '') =>\n    projectPath(args.projectId, `/integrations/${encodePath(id)}${suffix}`);\n  return {\n    create: ({ signal, ...value }) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: projectPath(args.projectId, '/integrations'),\n        body: { schema: createIntegrationRequestSchema, value },\n        response: integrationSchema,\n        signal,\n      }),\n    get: async ({ signal, ...selector }) => {\n      if ('id' in selector)\n        return http.request({\n          method: HttpMethod.Get,\n          path: integrationPath(selector.id),\n          response: integrationSchema,\n          signal,\n        });\n      const { integrations } = await http.request({\n        method: HttpMethod.Get,\n        path: projectPath(args.projectId, '/integrations'),\n        query: { name: selector.name },\n        response: integrationListSchema,\n        signal,\n      });\n      const found = integrations.find((integration) => integration.name === selector.name);\n      if (found == null)\n        throw clientError({\n          message: `No integration named ${selector.name} in this project`,\n          status: 404,\n          code: ClientErrorCode.NotFound,\n        });\n      return found;\n    },\n    list: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: projectPath(args.projectId, '/integrations'),\n        query: { cursor: options?.cursor, limit: options?.limit },\n        response: integrationListSchema,\n        signal: options?.signal,\n      }),\n    update: ({ id, signal, ...value }) =>\n      http.request({\n        method: HttpMethod.Patch,\n        path: integrationPath(id),\n        body: { schema: updateIntegrationRequestSchema, value },\n        response: integrationSchema,\n        signal,\n      }),\n    delete: async ({ id, signal }) => {\n      await http.request({\n        method: HttpMethod.Delete,\n        path: integrationPath(id),\n        response: okResponseSchema,\n        signal,\n      });\n    },\n    signIn: ({ id, signal, ...value }) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: integrationPath(id, '/sign-in'),\n        body: { schema: startSignInRequestSchema, value },\n        response: startSignInResponseSchema,\n        signal,\n      }),\n    completeSignIn: ({ signal, ...value }) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: '/v1/sign-ins/complete',\n        body: { schema: completeSignInRequestSchema, value },\n        response: completeSignInResponseSchema,\n        signal,\n      }),\n    signOut: async ({ id, signal }) => {\n      await http.request({\n        method: HttpMethod.Delete,\n        path: integrationPath(id, '/sign-in'),\n        response: okResponseSchema,\n        signal,\n      });\n    },\n  };\n};\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -0,0 +1,2 @@
+import { type AgentClientIface, type CreateClientOptionsIface } from "./client.mjs";
+export declare const createClient: (options: CreateClientOptionsIface) => AgentClientIface;

package/dist/modules/agent-client/node.mjs

@@ -0,0 +1,62 @@
+import { connectSandboxClient } from "@finalai/agent-provider/sandbox/client";
+import { frameChannelFromWebSocket } from "@finalai/agent-provider/sandbox/wire";
+import {
+  createClientFor
+} from "./client.mjs";
+import { LOCAL_HOST_SUBPROTOCOL } from "./local-host-protocol.mjs";
+const nodeLocalCompute = () => ({
+  sandbox: async () => {
+    const { createLocalSandbox } = await import("@finalai/final-agent-provider/sandboxes/local");
+    return createLocalSandbox({ root: globalThis.process.cwd() });
+  },
+  openSandbox: (endpoint) => connectSandboxClient({
+    url: endpoint.url,
+    token: endpoint.token,
+    expiresAt: endpoint.expiresAt
+  })
+});
+const nodeLocalHostDial = (http) => async (path, signal) => {
+  const url = http.url(path);
+  url.protocol = url.protocol === "http:" ? "ws:" : "wss:";
+  const headers = await http.headers();
+  const { WebSocket } = await import("ws");
+  signal?.throwIfAborted();
+  const socket = new WebSocket(url, [LOCAL_HOST_SUBPROTOCOL], { headers });
+  let tcp = null;
+  let referenced = true;
+  socket.on("upgrade", (response) => {
+    tcp = response.socket;
+    if (!referenced) tcp.unref();
+  });
+  const { channel, opened } = frameChannelFromWebSocket(socket);
+  const onAbort = () => socket.terminate();
+  signal?.addEventListener("abort", onAbort, { once: true });
+  try {
+    await opened;
+  } finally {
+    signal?.removeEventListener("abort", onAbort);
+  }
+  return {
+    ...channel,
+    keepAlive: {
+      ref: () => {
+        referenced = true;
+        tcp?.ref();
+      },
+      unref: () => {
+        referenced = false;
+        tcp?.unref();
+      }
+    }
+  };
+};
+const nodeRuntime = {
+  localCompute: true,
+  compute: nodeLocalCompute,
+  dial: nodeLocalHostDial
+};
+const createClient = (options) => createClientFor(nodeRuntime, options);
+export {
+  createClient
+};
+//# sourceMappingURL=node.mjs.map

package/dist/modules/agent-client/node.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/node.ts"],
+  "sourcesContent": ["import { connectSandboxClient } from '@finalai/agent-provider/sandbox/client';\nimport { frameChannelFromWebSocket } from '@finalai/agent-provider/sandbox/wire';\nimport {\n  createClientFor,\n  type AgentClientIface,\n  type ClientRuntimeIface,\n  type CreateClientOptionsIface,\n} from \"./client.mjs\";\nimport type { HttpIface } from \"./http.mjs\";\nimport { LOCAL_HOST_SUBPROTOCOL } from \"./local-host-protocol.mjs\";\nimport type { LocalComputeIface, LocalHostSocketIface } from \"./local-host.mjs\";\n\n// `createClient` in Node: the package's default export condition. Browsers and\n// React Native resolve `./portable` instead, which imports none of this.\n\n// The model's files and shell are this process's working directory, as for a\n// coding agent run on this machine. Loaded on use: it needs Node.\nconst nodeLocalCompute = (): LocalComputeIface => ({\n  sandbox: async () => {\n    const { createLocalSandbox } = await import('@finalai/final-agent-provider/sandboxes/local');\n    return createLocalSandbox({ root: globalThis.process.cwd() });\n  },\n  openSandbox: (endpoint) =>\n    connectSandboxClient({\n      url: endpoint.url,\n      token: endpoint.token,\n      expiresAt: endpoint.expiresAt,\n    }),\n});\n\n// The local host socket is dialed from Node with the client's own headers. It\n// keeps the process alive only while the host starts or is in use (see\n// LocalHostKeepAliveIface), so a script that is done exits and the platform\n// reports its tools and compute as unavailable.\nconst nodeLocalHostDial =\n  (http: HttpIface) =>\n  async (path: string, signal?: AbortSignal): Promise<LocalHostSocketIface> => {\n    const url = http.url(path);\n    url.protocol = url.protocol === 'http:' ? 'ws:' : 'wss:';\n    const headers = await http.headers();\n    const { WebSocket } = await import('ws');\n    signal?.throwIfAborted();\n    const socket = new WebSocket(url, [LOCAL_HOST_SUBPROTOCOL], { headers });\n    let tcp: { ref: () => unknown; unref: () => unknown } | null = null;\n    let referenced = true;\n    socket.on('upgrade', (response) => {\n      tcp = response.socket;\n      if (!referenced) tcp.unref();\n    });\n    const { channel, opened } = frameChannelFromWebSocket(socket);\n    // Aborting while the socket opens tears it down, which rejects `opened`.\n    const onAbort = () => socket.terminate();\n    signal?.addEventListener('abort', onAbort, { once: true });\n    try {\n      await opened;\n    } finally {\n      signal?.removeEventListener('abort', onAbort);\n    }\n    return {\n      ...channel,\n      keepAlive: {\n        ref: () => {\n          referenced = true;\n          tcp?.ref();\n        },\n        unref: () => {\n          referenced = false;\n          tcp?.unref();\n        },\n      },\n    };\n  };\n\nconst nodeRuntime: ClientRuntimeIface = {\n  localCompute: true,\n  compute: nodeLocalCompute,\n  dial: nodeLocalHostDial,\n};\n\nexport const createClient = (options: CreateClientOptionsIface): AgentClientIface =>\n  createClientFor(nodeRuntime, options);\n"],
+  "mappings": "AAAA,SAAS,4BAA4B;AACrC,SAAS,iCAAiC;AAC1C;AAAA,EACE;AAAA,OAIK;AAEP,SAAS,8BAA8B;AAQvC,MAAM,mBAAmB,OAA0B;AAAA,EACjD,SAAS,YAAY;AACnB,UAAM,EAAE,mBAAmB,IAAI,MAAM,OAAO,+CAA+C;AAC3F,WAAO,mBAAmB,EAAE,MAAM,WAAW,QAAQ,IAAI,EAAE,CAAC;AAAA,EAC9D;AAAA,EACA,aAAa,CAAC,aACZ,qBAAqB;AAAA,IACnB,KAAK,SAAS;AAAA,IACd,OAAO,SAAS;AAAA,IAChB,WAAW,SAAS;AAAA,EACtB,CAAC;AACL;AAMA,MAAM,oBACJ,CAAC,SACD,OAAO,MAAc,WAAwD;AAC3E,QAAM,MAAM,KAAK,IAAI,IAAI;AACzB,MAAI,WAAW,IAAI,aAAa,UAAU,QAAQ;AAClD,QAAM,UAAU,MAAM,KAAK,QAAQ;AACnC,QAAM,EAAE,UAAU,IAAI,MAAM,OAAO,IAAI;AACvC,UAAQ,eAAe;AACvB,QAAM,SAAS,IAAI,UAAU,KAAK,CAAC,sBAAsB,GAAG,EAAE,QAAQ,CAAC;AACvE,MAAI,MAA2D;AAC/D,MAAI,aAAa;AACjB,SAAO,GAAG,WAAW,CAAC,aAAa;AACjC,UAAM,SAAS;AACf,QAAI,CAAC,WAAY,KAAI,MAAM;AAAA,EAC7B,CAAC;AACD,QAAM,EAAE,SAAS,OAAO,IAAI,0BAA0B,MAAM;AAE5D,QAAM,UAAU,MAAM,OAAO,UAAU;AACvC,UAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;AACzD,MAAI;AACF,UAAM;AAAA,EACR,UAAE;AACA,YAAQ,oBAAoB,SAAS,OAAO;AAAA,EAC9C;AACA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,WAAW;AAAA,MACT,KAAK,MAAM;AACT,qBAAa;AACb,aAAK,IAAI;AAAA,MACX;AAAA,MACA,OAAO,MAAM;AACX,qBAAa;AACb,aAAK,MAAM;AAAA,MACb;AAAA,IACF;AAAA,EACF;AACF;AAEF,MAAM,cAAkC;AAAA,EACtC,cAAc;AAAA,EACd,SAAS;AAAA,EACT,MAAM;AACR;AAEO,MAAM,eAAe,CAAC,YAC3B,gBAAgB,aAAa,OAAO;",
+  "names": []
+}

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

@@ -0,0 +1,83 @@
+import { type AddAllowedEndpointRequestIface, type AllowedEndpointIface, type BudgetIface, type ChatGptSubscriptionChallengeIface, type ChatGptSubscriptionPollIface, type ConnectApiKeyRequestIface, type ConnectClaudeSubscriptionRequestIface, type CreateBudgetRequestIface, type CreateModelCredentialGrantRequestIface, type ModelCredentialGrantIface, type ModelCredentialIface, type OrganizationAgentPolicyIface, type PlatformSpendingRestrictionsIface, type StartChatGptSubscriptionRequestIface, type UpdateModelCredentialRequestIface, type UpdateOrganizationAgentPolicyRequestIface, type UpdatePlatformSpendingRestrictionsRequestIface } from '@finalai/agent-protocol/agent-platform';
+import { type ClientContextIface, type SignalOptionsIface } from "./context.mjs";
+export interface ModelCredentialGrantsApiIface {
+    list: (args: {
+        credentialId: string;
+    } & SignalOptionsIface) => Promise<ModelCredentialGrantIface[]>;
+    /** Shares the credential with a project or a member; idempotent per grantee. */
+    create: (args: {
+        credentialId: string;
+    } & CreateModelCredentialGrantRequestIface & SignalOptionsIface) => Promise<ModelCredentialGrantIface>;
+    revoke: (args: {
+        credentialId: string;
+        grantId: string;
+    } & SignalOptionsIface) => Promise<void>;
+}
+/** The subscriptions and API keys the caller's projects run models with. */
+export interface ModelCredentialsApiIface {
+    /** The caller's credentials; with `projectId`, that project's and those it inherits. */
+    list: (options?: {
+        projectId?: string;
+    } & SignalOptionsIface) => Promise<ModelCredentialIface[]>;
+    connectApiKey: (args: ConnectApiKeyRequestIface & SignalOptionsIface) => Promise<ModelCredentialIface>;
+    connectClaudeSubscription: (args: ConnectClaudeSubscriptionRequestIface & SignalOptionsIface) => Promise<ModelCredentialIface>;
+    /** Starts a device-code sign-in; poll it with the returned `state`. */
+    startChatGptSubscription: (args: StartChatGptSubscriptionRequestIface & SignalOptionsIface) => Promise<ChatGptSubscriptionChallengeIface>;
+    pollChatGptSubscription: (args: {
+        state: string;
+    } & SignalOptionsIface) => Promise<ChatGptSubscriptionPollIface>;
+    /** The owner's settings (an editor of the credential's project). */
+    update: (args: {
+        credentialId: string;
+    } & UpdateModelCredentialRequestIface & SignalOptionsIface) => Promise<ModelCredentialIface>;
+    /** Clears a subscription's remembered limit after the vendor reset it. */
+    resetUsage: (args: {
+        credentialId: string;
+    } & SignalOptionsIface) => Promise<ModelCredentialIface>;
+    disconnect: (args: {
+        credentialId: string;
+    } & SignalOptionsIface) => Promise<void>;
+    /** Who else may use a credential (its managers only). */
+    grants: ModelCredentialGrantsApiIface;
+}
+/** Spend limits; organization admins write them. */
+export interface BudgetsApiIface {
+    list: (options?: SignalOptionsIface) => Promise<BudgetIface[]>;
+    create: (args: CreateBudgetRequestIface & SignalOptionsIface) => Promise<BudgetIface>;
+    update: (args: {
+        budgetId: string;
+    } & CreateBudgetRequestIface & SignalOptionsIface) => Promise<BudgetIface>;
+    delete: (args: {
+        budgetId: string;
+    } & SignalOptionsIface) => Promise<void>;
+}
+/** The organization's provider gates and turn limits; organization admins update it. */
+export interface OrganizationPolicyApiIface {
+    get: (options?: SignalOptionsIface) => Promise<OrganizationAgentPolicyIface>;
+    update: (args: UpdateOrganizationAgentPolicyRequestIface & SignalOptionsIface) => Promise<OrganizationAgentPolicyIface>;
+}
+/** Who may spend the platform's own metered inference; organization admins update it. */
+export interface SpendingRestrictionsApiIface {
+    get: (options?: SignalOptionsIface) => Promise<PlatformSpendingRestrictionsIface>;
+    update: (args: UpdatePlatformSpendingRestrictionsRequestIface & SignalOptionsIface) => Promise<PlatformSpendingRestrictionsIface>;
+}
+/** The caller's organization: model credentials, budgets and policies. */
+export interface OrganizationApiIface {
+    modelCredentials: ModelCredentialsApiIface;
+    budgets: BudgetsApiIface;
+    policy: OrganizationPolicyApiIface;
+    spendingRestrictions: SpendingRestrictionsApiIface;
+}
+/** Where a project lets its secrets go beyond model vendors' own APIs; its admins change it. */
+export interface AllowedEndpointsApiIface {
+    list: (options?: SignalOptionsIface) => Promise<AllowedEndpointIface[]>;
+    add: (args: AddAllowedEndpointRequestIface & SignalOptionsIface) => Promise<AllowedEndpointIface>;
+    remove: (args: {
+        endpointId: string;
+    } & SignalOptionsIface) => Promise<void>;
+}
+export declare const createOrganizationApi: (context: ClientContextIface) => OrganizationApiIface;
+export declare const createAllowedEndpointsApi: (args: {
+    context: ClientContextIface;
+    projectId: string;
+}) => AllowedEndpointsApiIface;