@finalai/final-agent-provider 0.10.1 → 0.11.0

package/dist/modules/provider/index.mjs

@@ -0,0 +1,13 @@
+import {
+  defineHarnessProvider
+} from "@finalai/agent-definition/authoring";
+import { GENERAL_HARNESS_PROVIDER_SOURCE } from "./general.bundle.mjs";
+import { REQUIRED_FINAL_EXTENSIONS } from "./general.mjs";
+const GENERAL_HARNESS_PROVIDER = defineHarnessProvider({
+  source: GENERAL_HARNESS_PROVIDER_SOURCE
+});
+export {
+  GENERAL_HARNESS_PROVIDER,
+  REQUIRED_FINAL_EXTENSIONS
+};
+//# sourceMappingURL=index.mjs.map

package/dist/modules/provider/index.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/provider/index.ts"],
+  "sourcesContent": ["import {\n  defineHarnessProvider,\n  type DefinedHarnessProviderIface,\n} from '@finalai/agent-definition/authoring';\nimport { GENERAL_HARNESS_PROVIDER_SOURCE } from \"./general.bundle.mjs\";\n\nexport { REQUIRED_FINAL_EXTENSIONS } from \"./general.mjs\";\n\n// The general harness provider as one self-contained module, ready to run on\n// a serverless runtime like any other harness provider's code.\nexport const GENERAL_HARNESS_PROVIDER: DefinedHarnessProviderIface = defineHarnessProvider({\n  source: GENERAL_HARNESS_PROVIDER_SOURCE,\n});\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,OAEK;AACP,SAAS,uCAAuC;AAEhD,SAAS,iCAAiC;AAInC,MAAM,2BAAwD,sBAAsB;AAAA,EACzF,QAAQ;AACV,CAAC;",
+  "names": []
+}

package/dist/modules/sandboxes/access.d.mts

@@ -0,0 +1,34 @@
+export interface FinalPlatformAccessIface {
+    baseUrl: string;
+    token: string;
+}
+export type ComputersAccessIface = (args: {
+    organizationId: string;
+    projectId: string;
+    refresh: boolean;
+}) => Promise<FinalPlatformAccessIface | null>;
+export type DeviceAccessIface = (args: {
+    organizationId: string;
+    projectId: string | null;
+    actingUserId: string | null;
+    refresh: boolean;
+}) => Promise<FinalPlatformAccessIface | null>;
+export interface ComputersApiCredentialsIface {
+    computersAccess(args?: {
+        refresh?: boolean;
+    }): Promise<FinalPlatformAccessIface | null>;
+}
+export interface DeviceApiCredentialsIface {
+    deviceAccess(args?: {
+        actingUserId?: string | null;
+        refresh?: boolean;
+    }): Promise<FinalPlatformAccessIface | null>;
+}
+export declare const computersCredentialsFor: (access: ComputersAccessIface | undefined, scope: {
+    organizationId: string;
+    projectId: string;
+}) => ComputersApiCredentialsIface;
+export declare const deviceCredentialsFor: (access: DeviceAccessIface | undefined, scope: {
+    organizationId: string;
+    projectId: string | null;
+}) => DeviceApiCredentialsIface;

package/dist/modules/sandboxes/access.mjs

@@ -0,0 +1,15 @@
+const computersCredentialsFor = (access, scope) => ({
+  computersAccess: async (args) => access == null ? null : access({ ...scope, refresh: args?.refresh === true })
+});
+const deviceCredentialsFor = (access, scope) => ({
+  deviceAccess: async (args) => access == null ? null : access({
+    ...scope,
+    actingUserId: args?.actingUserId ?? null,
+    refresh: args?.refresh === true
+  })
+});
+export {
+  computersCredentialsFor,
+  deviceCredentialsFor
+};
+//# sourceMappingURL=access.mjs.map

package/dist/modules/sandboxes/access.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/sandboxes/access.ts"],
+  "sourcesContent": ["// Access to Final's Computers and Device APIs. It is configuration of the\n// `computer` and `device` providers (and of workspace Device egress), supplied\n// by whoever runs them, never part of the generic provider context.\n\nexport interface FinalPlatformAccessIface {\n  // The API origin; requests go to `<baseUrl>/v1/...`.\n  baseUrl: string;\n  token: string;\n}\n\n// Computers API access for one project's sandboxes. `refresh` asks for a new\n// token after the API rejected the last one. Null: none granted.\nexport type ComputersAccessIface = (args: {\n  organizationId: string;\n  projectId: string;\n  refresh: boolean;\n}) => Promise<FinalPlatformAccessIface | null>;\n\n// Device API access acting for `actingUserId` (null: service access for\n// workspace networking). Null: none granted.\nexport type DeviceAccessIface = (args: {\n  organizationId: string;\n  projectId: string | null;\n  actingUserId: string | null;\n  refresh: boolean;\n}) => Promise<FinalPlatformAccessIface | null>;\n\n// The per-call form the API clients ask before each request.\nexport interface ComputersApiCredentialsIface {\n  computersAccess(args?: { refresh?: boolean }): Promise<FinalPlatformAccessIface | null>;\n}\n\nexport interface DeviceApiCredentialsIface {\n  deviceAccess(args?: {\n    actingUserId?: string | null;\n    refresh?: boolean;\n  }): Promise<FinalPlatformAccessIface | null>;\n}\n\nexport const computersCredentialsFor = (\n  access: ComputersAccessIface | undefined,\n  scope: { organizationId: string; projectId: string },\n): ComputersApiCredentialsIface => ({\n  computersAccess: async (args) =>\n    access == null ? null : access({ ...scope, refresh: args?.refresh === true }),\n});\n\nexport const deviceCredentialsFor = (\n  access: DeviceAccessIface | undefined,\n  scope: { organizationId: string; projectId: string | null },\n): DeviceApiCredentialsIface => ({\n  deviceAccess: async (args) =>\n    access == null\n      ? null\n      : access({\n          ...scope,\n          actingUserId: args?.actingUserId ?? null,\n          refresh: args?.refresh === true,\n        }),\n});\n"],
+  "mappings": "AAuCO,MAAM,0BAA0B,CACrC,QACA,WACkC;AAAA,EAClC,iBAAiB,OAAO,SACtB,UAAU,OAAO,OAAO,OAAO,EAAE,GAAG,OAAO,SAAS,MAAM,YAAY,KAAK,CAAC;AAChF;AAEO,MAAM,uBAAuB,CAClC,QACA,WAC+B;AAAA,EAC/B,cAAc,OAAO,SACnB,UAAU,OACN,OACA,OAAO;AAAA,IACL,GAAG;AAAA,IACH,cAAc,MAAM,gBAAgB;AAAA,IACpC,SAAS,MAAM,YAAY;AAAA,EAC7B,CAAC;AACT;",
+  "names": []
+}

package/dist/modules/sandboxes/computer.d.mts

@@ -1,25 +1,17 @@
-import { SandboxAccess, type JsonValue } from '@finalai/agent-provider';
-import { type SandboxNetworkingExtensionIface, SandboxCapability, type NetworkSandboxSessionIface, type SandboxProviderIface } from '@finalai/agent-provider/sandbox';
+import { NetworkPolicy, type JsonValue } from '@finalai/agent-provider';
+import { SandboxCapability, type NetworkPolicyIface, type NetworkSandboxSessionIface, type SandboxNetworkingExtensionIface, type SandboxProviderIface, type SandboxSetupIface } from '@finalai/agent-provider/sandbox';
 import * as z from 'zod';
 import { type ComputersApiConfigIface } from "./computers-api.mjs";
-import { ComputerWorkspacePolicy } from "./environment.mjs";
-import { type GuideCommandIface } from "./workspace-setup.mjs";
-export declare const computerWorkspaceName: (options: {
-    bindingId: string;
-    conversationId: string | null;
-    target: string;
-    conversationWorkspace: boolean;
-}) => Promise<string>;
+import { type ComputerBuildIface } from "./environment.mjs";
 export type { ComputersApiConfigIface } from "./computers-api.mjs";
-export type { FinalPlatformAccessIface } from '@finalai/agent-provider/sandbox';
-export { COMPUTER_SANDBOX_SPECIFIER } from "./environment.mjs";
-export { computeComputerArtifactKey } from "./guide.mjs";
-export type { ComputerGuideVersionIface } from "./guide.mjs";
-export type { RepositoryCloneSourceIface } from "./workspace-setup.mjs";
+export type { FinalPlatformAccessIface } from "./access.mjs";
+export { COMPUTER_PROVIDER } from "./environment.mjs";
+export declare const WORKSPACE_ROOT = "/workspaces";
 export interface ComputerSandboxLogIface {
     (message: string, fields?: Record<string, string | number | boolean | null>): void;
 }
 export interface ComputerSandboxProviderConfigIface {
+    computersApiUrl: string;
     computersApi?: ComputersApiConfigIface;
     networking?: SandboxNetworkingExtensionIface;
     registryCredentialId?: string;
@@ -30,13 +22,10 @@ export interface ComputerSandboxProviderConfigIface {
         memoryMb?: number;
         diskGb?: number;
     };
-    idleTimeoutSeconds?: number;
     imageWaitMs?: number;
     imagePollMs?: number;
     buildWaitMs?: number;
     buildPollMs?: number;
-    shelveWaitMs?: number;
-    shelvePollMs?: number;
     runningWaitMs?: number;
     runningPollMs?: number;
     log?: ComputerSandboxLogIface;
@@ -64,47 +53,31 @@ declare const computerArtifactSchema: z.ZodObject<{
     }, z.core.$strip>], "kind">;
 }, z.core.$strip>;
 declare const computerStateSchema: z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    computerId: z.ZodString;
+    version: z.ZodLiteral<2>;
     computerName: z.ZodString;
-    workspace: z.ZodEnum<typeof ComputerWorkspacePolicy>;
-    access: z.ZodEnum<typeof SandboxAccess>;
-    guideVersionId: z.ZodNullable<z.ZodString>;
-    setupHash: z.ZodNullable<z.ZodString>;
-    setupPending: z.ZodDefault<z.ZodBoolean>;
-    workspaceId: z.ZodOptional<z.ZodString>;
-    networkPolicySaved: z.ZodOptional<z.ZodBoolean>;
+    computerId: z.ZodNullable<z.ZodString>;
+    network: z.ZodObject<{
+        mode: z.ZodEnum<typeof NetworkPolicy>;
+        allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    ports: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    networkPolicySaved: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strip>;
 export type ComputerSandboxArtifact = z.infer<typeof computerArtifactSchema>;
 export type ComputerSandboxState = z.infer<typeof computerStateSchema>;
-export interface ComputerSandboxDescriptionIface {
-    provider: 'computer';
-    computerId: string;
-    computerName: string;
-    workspaceRoot: string;
-    transport: string;
-    guide: {
-        slug: string;
-        number: number;
-    } | null;
-    repositories: {
-        alias: string;
-        path: string;
-        repository: string;
-    }[];
-    services: {
-        name: string;
-        readyUrl: string | null;
-    }[];
-    commands: GuideCommandIface[];
-    capabilities: SandboxCapability[];
-}
 export interface ComputerSandboxSessionIface extends NetworkSandboxSessionIface {
-    describe(): ComputerSandboxDescriptionIface;
     readonly capabilities: readonly SandboxCapability[];
 }
-export type ComputerSandboxProviderIface = SandboxProviderIface<JsonValue, JsonValue, ComputerSandboxArtifact, ComputerSandboxState, ComputerSandboxSessionIface>;
+export type ComputerSandboxProviderIface = SandboxProviderIface<JsonValue, ComputerSandboxArtifact, ComputerSandboxState, ComputerSandboxSessionIface>;
 export interface ComputerSandboxErrorIface extends Error {
     code: 'artifact_unavailable' | 'computer_gone' | 'computer_not_running' | 'invalid_environment' | 'build_failed';
 }
+export declare const computerNetworkPolicyOf: (setup: SandboxSetupIface | null) => NetworkPolicyIface;
+export declare const computerNameFor: (sandboxId: string) => Promise<string>;
+export declare const computerNeedsBuild: (build: ComputerBuildIface | undefined) => boolean;
+export declare const computeComputerArtifactKey: (inputs: {
+    image: string;
+    build: ComputerBuildIface | undefined;
+    diskGb: number | null;
+}) => Promise<string>;
 export declare const createComputerSandboxProvider: (config: ComputerSandboxProviderConfigIface) => ComputerSandboxProviderIface;