@qoniai/qoni 0.4.3 → 0.5.0

package/dist/index.d.cts

@@ -601,6 +601,10 @@ interface Artifact {
     mime?: string;
     sizeBytes?: number;
     createdAt?: string;
+    /** Temporary signed storage URL; refresh after expiry. */
+    downloadUrl?: string;
+    expiresIn?: number;
+    refreshDownloadUrl?(): Promise<string>;
     content(): Promise<Uint8Array>;
 }
 /** Settled outcome of `run.wait()`. */
@@ -735,6 +739,15 @@ interface SnapshotAction {
 interface RunLimits {
     maxDurationMinutes?: number;
 }
+type BrowserbaseRegion = "us-west-2" | "us-east-1" | "eu-central-1" | "ap-southeast-1";
+interface BrowserProxyOptions {
+    /** Server-side proxy registry id. Credentials never enter the SDK call. */
+    proxyId?: string;
+    /** `off` uses datacenter egress; `all` proxies all requests; `scoped` uses admin patterns. */
+    mode?: "off" | "all" | "scoped";
+    /** Browserbase compute region. This is separate from the proxy's IP geography. */
+    region?: BrowserbaseRegion;
+}
 interface DoAnythingRunOptions {
     /** Delegation token — passed once here; the returned handle holds it. */
     token: string;
@@ -748,6 +761,8 @@ interface DoAnythingRunOptions {
      */
     session?: SessionRef;
     profileId?: string;
+    /** Applies when this run creates a new Browserbase session. */
+    browserProxy?: BrowserProxyOptions;
     keepAlive?: boolean;
     allowedActions?: string[];
     skills?: string[];
@@ -772,6 +787,10 @@ declare function createDoAnythingNamespace(transport: QoniTransport): {
      * not supplied.
      */
     attach: (runId: string, opts: DoAnythingAttachOptions) => Promise<RunHandle<DoAnythingEvent>>;
+    artifacts: (input: RuntimeTokenInput & {
+        runId: string;
+        signal?: AbortSignal;
+    }) => Promise<Artifact[]>;
     api: {
         createSession: <T = unknown>(input: RuntimeTokenInput & JsonObject) => Promise<QoniResponse<T>>;
         /**
@@ -817,6 +836,18 @@ declare function createDoAnythingNamespace(transport: QoniTransport): {
             sessionId: string;
             artifactId: string;
         }) => Promise<QoniResponse<T>>;
+        listArtifacts: <T = {
+            items: JsonObject[];
+        }>(input: RuntimeTokenInput & {
+            runId: string;
+            signal?: AbortSignal;
+        }) => Promise<QoniResponse<T>>;
+        artifactDownloadUrl: (input: RuntimeTokenInput & {
+            artifactId: string;
+        }) => Promise<QoniResponse<{
+            download_url: string;
+            expires_in: number;
+        }>>;
         readRecording: <T = unknown>(input: RuntimeTokenInput & {
             sessionId: string;
         }) => Promise<QoniResponse<T>>;
@@ -1364,4 +1395,4 @@ declare const QoniScopeBundles: {
     readonly TRACK: readonly ["webagent.track:read", "webagent.track:manage"];
 };
 
-export { type Action, type ActionKind, ActionKinds, type Artifact, type CaptureOptions, type ClarificationPayload, type CompleteDelegateAgentInput, type CompleteDelegateTokenInput, type ConfirmationPayload, type CoreRunEvent, type DeepResearchAttachOptions, type DeepResearchEvent, type DeepResearchRunOptions, type DelegateAgentInput, type DelegateAgentResponse, type DelegateAgentTokenResponse, type DelegateTokenInput, type DelegateTokenInteractiveInput, type DelegateTokenResponse, type DelegateTokenResult, type DelegateTokenSilentInput, type DelegateTokenSilentResponse, type DelegationMode, type DelegationTokenResponse, type DoAnythingAttachOptions, type DoAnythingEvent, type DoAnythingRunOptions, type DoAnythingSnapshot, type GenAuthAccessTokenInput, type GenAuthAdminToken, type GenAuthAdminTokenOverrideInput, type GenAuthDelegationIntrospectionInput, type GenAuthUserCreateBatchInput, type GenAuthUserCreateInput, type GenAuthUserDeleteBatchInput, type GenAuthUserGetBatchInput, type GenAuthUserGetInput, type GenAuthUserListInput, type GenAuthUserUpdateInput, type Interaction, type InteractionEvidence, InteractionHandle, type InteractionPayloadByType, type InteractionSite, type InteractionStatus, InteractionStatuses, type InteractionType, InteractionTypes, type InteractiveDelegationResponse, type JsonObject, type MonitorEvent, type MonitorEventsOptions, MonitorHandle, type MonitorRunsOptions, Qoni, QoniAuthError, QoniDelegationRequiredError, QoniError, type QoniErrorCode, type QoniErrorOptions, type QoniEvent, type QoniEventType, QoniEventTypes, type QoniMeta, type QoniOptions, QoniPermissionDeniedError, type QoniProduct, type QoniProductName, QoniProductScopes, QoniRateLimitError, type QoniResponse, type QoniRuntimeConfig, type QoniSSEEvent, QoniScopeBundles, QoniScopes, QoniTimeoutError, QoniTokenExpiredError, QoniUpstreamError, QoniValidationError, type RawRequestInput, type RunDoneData, type RunEvent, type RunEventsOptions, RunHandle, type RunImage, type RunLimits, type RunMessageData, type RunReconnectInfo, type RunResult, type RunScreenshotData, type RunStatus, type RunWaitOptions, type RuntimeTokenInput, type SessionRef, type SiteLoginPayload, type SnapshotAction, type SnapshotImage, type TakeControlPayload, type TokenInput, type TrackAttachOptions, type TrackCreateOptions, type WaitKind, type WaitPayload, type WebSearchAttachOptions, type WebSearchEvent, type WebSearchRunOptions, buildAuthorization, buildSignature, buildStringToSign };
+export { type Action, type ActionKind, ActionKinds, type Artifact, type BrowserProxyOptions, type BrowserbaseRegion, type CaptureOptions, type ClarificationPayload, type CompleteDelegateAgentInput, type CompleteDelegateTokenInput, type ConfirmationPayload, type CoreRunEvent, type DeepResearchAttachOptions, type DeepResearchEvent, type DeepResearchRunOptions, type DelegateAgentInput, type DelegateAgentResponse, type DelegateAgentTokenResponse, type DelegateTokenInput, type DelegateTokenInteractiveInput, type DelegateTokenResponse, type DelegateTokenResult, type DelegateTokenSilentInput, type DelegateTokenSilentResponse, type DelegationMode, type DelegationTokenResponse, type DoAnythingAttachOptions, type DoAnythingEvent, type DoAnythingRunOptions, type DoAnythingSnapshot, type GenAuthAccessTokenInput, type GenAuthAdminToken, type GenAuthAdminTokenOverrideInput, type GenAuthDelegationIntrospectionInput, type GenAuthUserCreateBatchInput, type GenAuthUserCreateInput, type GenAuthUserDeleteBatchInput, type GenAuthUserGetBatchInput, type GenAuthUserGetInput, type GenAuthUserListInput, type GenAuthUserUpdateInput, type Interaction, type InteractionEvidence, InteractionHandle, type InteractionPayloadByType, type InteractionSite, type InteractionStatus, InteractionStatuses, type InteractionType, InteractionTypes, type InteractiveDelegationResponse, type JsonObject, type MonitorEvent, type MonitorEventsOptions, MonitorHandle, type MonitorRunsOptions, Qoni, QoniAuthError, QoniDelegationRequiredError, QoniError, type QoniErrorCode, type QoniErrorOptions, type QoniEvent, type QoniEventType, QoniEventTypes, type QoniMeta, type QoniOptions, QoniPermissionDeniedError, type QoniProduct, type QoniProductName, QoniProductScopes, QoniRateLimitError, type QoniResponse, type QoniRuntimeConfig, type QoniSSEEvent, QoniScopeBundles, QoniScopes, QoniTimeoutError, QoniTokenExpiredError, QoniUpstreamError, QoniValidationError, type RawRequestInput, type RunDoneData, type RunEvent, type RunEventsOptions, RunHandle, type RunImage, type RunLimits, type RunMessageData, type RunReconnectInfo, type RunResult, type RunScreenshotData, type RunStatus, type RunWaitOptions, type RuntimeTokenInput, type SessionRef, type SiteLoginPayload, type SnapshotAction, type SnapshotImage, type TakeControlPayload, type TokenInput, type TrackAttachOptions, type TrackCreateOptions, type WaitKind, type WaitPayload, type WebSearchAttachOptions, type WebSearchEvent, type WebSearchRunOptions, buildAuthorization, buildSignature, buildStringToSign };

package/dist/index.d.ts

@@ -601,6 +601,10 @@ interface Artifact {
     mime?: string;
     sizeBytes?: number;
     createdAt?: string;
+    /** Temporary signed storage URL; refresh after expiry. */
+    downloadUrl?: string;
+    expiresIn?: number;
+    refreshDownloadUrl?(): Promise<string>;
     content(): Promise<Uint8Array>;
 }
 /** Settled outcome of `run.wait()`. */
@@ -735,6 +739,15 @@ interface SnapshotAction {
 interface RunLimits {
     maxDurationMinutes?: number;
 }
+type BrowserbaseRegion = "us-west-2" | "us-east-1" | "eu-central-1" | "ap-southeast-1";
+interface BrowserProxyOptions {
+    /** Server-side proxy registry id. Credentials never enter the SDK call. */
+    proxyId?: string;
+    /** `off` uses datacenter egress; `all` proxies all requests; `scoped` uses admin patterns. */
+    mode?: "off" | "all" | "scoped";
+    /** Browserbase compute region. This is separate from the proxy's IP geography. */
+    region?: BrowserbaseRegion;
+}
 interface DoAnythingRunOptions {
     /** Delegation token — passed once here; the returned handle holds it. */
     token: string;
@@ -748,6 +761,8 @@ interface DoAnythingRunOptions {
      */
     session?: SessionRef;
     profileId?: string;
+    /** Applies when this run creates a new Browserbase session. */
+    browserProxy?: BrowserProxyOptions;
     keepAlive?: boolean;
     allowedActions?: string[];
     skills?: string[];
@@ -772,6 +787,10 @@ declare function createDoAnythingNamespace(transport: QoniTransport): {
      * not supplied.
      */
     attach: (runId: string, opts: DoAnythingAttachOptions) => Promise<RunHandle<DoAnythingEvent>>;
+    artifacts: (input: RuntimeTokenInput & {
+        runId: string;
+        signal?: AbortSignal;
+    }) => Promise<Artifact[]>;
     api: {
         createSession: <T = unknown>(input: RuntimeTokenInput & JsonObject) => Promise<QoniResponse<T>>;
         /**
@@ -817,6 +836,18 @@ declare function createDoAnythingNamespace(transport: QoniTransport): {
             sessionId: string;
             artifactId: string;
         }) => Promise<QoniResponse<T>>;
+        listArtifacts: <T = {
+            items: JsonObject[];
+        }>(input: RuntimeTokenInput & {
+            runId: string;
+            signal?: AbortSignal;
+        }) => Promise<QoniResponse<T>>;
+        artifactDownloadUrl: (input: RuntimeTokenInput & {
+            artifactId: string;
+        }) => Promise<QoniResponse<{
+            download_url: string;
+            expires_in: number;
+        }>>;
         readRecording: <T = unknown>(input: RuntimeTokenInput & {
             sessionId: string;
         }) => Promise<QoniResponse<T>>;
@@ -1364,4 +1395,4 @@ declare const QoniScopeBundles: {
     readonly TRACK: readonly ["webagent.track:read", "webagent.track:manage"];
 };
 
-export { type Action, type ActionKind, ActionKinds, type Artifact, type CaptureOptions, type ClarificationPayload, type CompleteDelegateAgentInput, type CompleteDelegateTokenInput, type ConfirmationPayload, type CoreRunEvent, type DeepResearchAttachOptions, type DeepResearchEvent, type DeepResearchRunOptions, type DelegateAgentInput, type DelegateAgentResponse, type DelegateAgentTokenResponse, type DelegateTokenInput, type DelegateTokenInteractiveInput, type DelegateTokenResponse, type DelegateTokenResult, type DelegateTokenSilentInput, type DelegateTokenSilentResponse, type DelegationMode, type DelegationTokenResponse, type DoAnythingAttachOptions, type DoAnythingEvent, type DoAnythingRunOptions, type DoAnythingSnapshot, type GenAuthAccessTokenInput, type GenAuthAdminToken, type GenAuthAdminTokenOverrideInput, type GenAuthDelegationIntrospectionInput, type GenAuthUserCreateBatchInput, type GenAuthUserCreateInput, type GenAuthUserDeleteBatchInput, type GenAuthUserGetBatchInput, type GenAuthUserGetInput, type GenAuthUserListInput, type GenAuthUserUpdateInput, type Interaction, type InteractionEvidence, InteractionHandle, type InteractionPayloadByType, type InteractionSite, type InteractionStatus, InteractionStatuses, type InteractionType, InteractionTypes, type InteractiveDelegationResponse, type JsonObject, type MonitorEvent, type MonitorEventsOptions, MonitorHandle, type MonitorRunsOptions, Qoni, QoniAuthError, QoniDelegationRequiredError, QoniError, type QoniErrorCode, type QoniErrorOptions, type QoniEvent, type QoniEventType, QoniEventTypes, type QoniMeta, type QoniOptions, QoniPermissionDeniedError, type QoniProduct, type QoniProductName, QoniProductScopes, QoniRateLimitError, type QoniResponse, type QoniRuntimeConfig, type QoniSSEEvent, QoniScopeBundles, QoniScopes, QoniTimeoutError, QoniTokenExpiredError, QoniUpstreamError, QoniValidationError, type RawRequestInput, type RunDoneData, type RunEvent, type RunEventsOptions, RunHandle, type RunImage, type RunLimits, type RunMessageData, type RunReconnectInfo, type RunResult, type RunScreenshotData, type RunStatus, type RunWaitOptions, type RuntimeTokenInput, type SessionRef, type SiteLoginPayload, type SnapshotAction, type SnapshotImage, type TakeControlPayload, type TokenInput, type TrackAttachOptions, type TrackCreateOptions, type WaitKind, type WaitPayload, type WebSearchAttachOptions, type WebSearchEvent, type WebSearchRunOptions, buildAuthorization, buildSignature, buildStringToSign };
+export { type Action, type ActionKind, ActionKinds, type Artifact, type BrowserProxyOptions, type BrowserbaseRegion, type CaptureOptions, type ClarificationPayload, type CompleteDelegateAgentInput, type CompleteDelegateTokenInput, type ConfirmationPayload, type CoreRunEvent, type DeepResearchAttachOptions, type DeepResearchEvent, type DeepResearchRunOptions, type DelegateAgentInput, type DelegateAgentResponse, type DelegateAgentTokenResponse, type DelegateTokenInput, type DelegateTokenInteractiveInput, type DelegateTokenResponse, type DelegateTokenResult, type DelegateTokenSilentInput, type DelegateTokenSilentResponse, type DelegationMode, type DelegationTokenResponse, type DoAnythingAttachOptions, type DoAnythingEvent, type DoAnythingRunOptions, type DoAnythingSnapshot, type GenAuthAccessTokenInput, type GenAuthAdminToken, type GenAuthAdminTokenOverrideInput, type GenAuthDelegationIntrospectionInput, type GenAuthUserCreateBatchInput, type GenAuthUserCreateInput, type GenAuthUserDeleteBatchInput, type GenAuthUserGetBatchInput, type GenAuthUserGetInput, type GenAuthUserListInput, type GenAuthUserUpdateInput, type Interaction, type InteractionEvidence, InteractionHandle, type InteractionPayloadByType, type InteractionSite, type InteractionStatus, InteractionStatuses, type InteractionType, InteractionTypes, type InteractiveDelegationResponse, type JsonObject, type MonitorEvent, type MonitorEventsOptions, MonitorHandle, type MonitorRunsOptions, Qoni, QoniAuthError, QoniDelegationRequiredError, QoniError, type QoniErrorCode, type QoniErrorOptions, type QoniEvent, type QoniEventType, QoniEventTypes, type QoniMeta, type QoniOptions, QoniPermissionDeniedError, type QoniProduct, type QoniProductName, QoniProductScopes, QoniRateLimitError, type QoniResponse, type QoniRuntimeConfig, type QoniSSEEvent, QoniScopeBundles, QoniScopes, QoniTimeoutError, QoniTokenExpiredError, QoniUpstreamError, QoniValidationError, type RawRequestInput, type RunDoneData, type RunEvent, type RunEventsOptions, RunHandle, type RunImage, type RunLimits, type RunMessageData, type RunReconnectInfo, type RunResult, type RunScreenshotData, type RunStatus, type RunWaitOptions, type RuntimeTokenInput, type SessionRef, type SiteLoginPayload, type SnapshotAction, type SnapshotImage, type TakeControlPayload, type TokenInput, type TrackAttachOptions, type TrackCreateOptions, type WaitKind, type WaitPayload, type WebSearchAttachOptions, type WebSearchEvent, type WebSearchRunOptions, buildAuthorization, buildSignature, buildStringToSign };

package/dist/index.js

@@ -1146,6 +1146,34 @@ var PLATFORM_DECIDED_RUN_OPTIONS = [
   "outputSchema",
   "cacheScript"
 ];
+var BROWSERBASE_REGIONS = /* @__PURE__ */ new Set([
+  "us-west-2",
+  "us-east-1",
+  "eu-central-1",
+  "ap-southeast-1"
+]);
+function validateBrowserProxyOptions(value) {
+  if (value === void 0) return;
+  if (!isJsonObject(value)) {
+    throw new QoniValidationError("browserProxy must be an object");
+  }
+  const allowed = /* @__PURE__ */ new Set(["proxyId", "mode", "region"]);
+  const extras = Object.keys(value).filter((key) => !allowed.has(key));
+  if (extras.length > 0) {
+    throw new QoniValidationError(
+      `browserProxy does not accept ${extras.join(", ")} \u2014 credentials stay server-side`
+    );
+  }
+  if (value.proxyId !== void 0 && (typeof value.proxyId !== "string" || !/^[a-z0-9][a-z0-9._-]{0,63}$/.test(value.proxyId))) {
+    throw new QoniValidationError("browserProxy.proxyId is invalid");
+  }
+  if (value.mode !== void 0 && !["off", "all", "scoped"].includes(String(value.mode))) {
+    throw new QoniValidationError("browserProxy.mode must be off, all, or scoped");
+  }
+  if (value.region !== void 0 && (typeof value.region !== "string" || !BROWSERBASE_REGIONS.has(value.region))) {
+    throw new QoniValidationError("browserProxy.region is not supported");
+  }
+}
 function createDoAnythingNamespace(transport) {
   const api = {
     createSession: (input) => transport.webAgentJson("POST", "/do_anything/sessions", input.token, {
@@ -1214,6 +1242,18 @@ function createDoAnythingNamespace(transport) {
         requiredScopes: ["webagent.do_anything:read"]
       }
     ),
+    listArtifacts: (input) => transport.webAgentJson(
+      "GET",
+      `/do_anything/runs/${encodeURIComponent(input.runId)}/artifacts`,
+      input.token,
+      { signal: input.signal, requiredScopes: ["webagent.do_anything:read"] }
+    ),
+    artifactDownloadUrl: (input) => transport.webAgentJson(
+      "GET",
+      `/do_anything/artifacts/${encodeURIComponent(input.artifactId)}/download-url`,
+      input.token,
+      { requiredScopes: ["webagent.do_anything:read"] }
+    ),
     readRecording: (input) => transport.webAgentJson(
       "GET",
       `/do_anything/sessions/${encodeURIComponent(input.sessionId)}/recording`,
@@ -1223,8 +1263,42 @@ function createDoAnythingNamespace(transport) {
       }
     )
   };
+  async function artifacts(input) {
+    const { data } = await api.listArtifacts(input);
+    if (!isJsonObject(data) || !Array.isArray(data.items)) {
+      throw new QoniValidationError("artifact list response requires items");
+    }
+    return data.items.map((item) => {
+      if (!isJsonObject(item) || typeof item.id !== "string" || !item.id) {
+        throw new QoniValidationError("artifact requires a nonempty id");
+      }
+      const id = item.id;
+      const artifact = {
+        id,
+        name: typeof item.name === "string" ? item.name : void 0,
+        mime: typeof item.mime_type === "string" ? item.mime_type : void 0,
+        sizeBytes: typeof item.size_bytes === "number" ? item.size_bytes : void 0,
+        createdAt: typeof item.created_at === "string" ? item.created_at : void 0,
+        downloadUrl: typeof item.download_url === "string" ? item.download_url : void 0,
+        expiresIn: typeof item.expires_in === "number" ? item.expires_in : void 0,
+        content: async () => (await transport.webAgentBytes(
+          `/do_anything/artifacts/${encodeURIComponent(id)}/blob`,
+          input.token,
+          { requiredScopes: ["webagent.do_anything:read"] }
+        )).bytes,
+        refreshDownloadUrl: async () => {
+          const { data: link } = await api.artifactDownloadUrl({ token: input.token, artifactId: id });
+          artifact.downloadUrl = link.download_url;
+          artifact.expiresIn = link.expires_in;
+          return link.download_url;
+        }
+      };
+      return artifact;
+    });
+  }
   function buildOps(token, runId, capture) {
     return {
+      listArtifacts: (signal) => artifacts({ token, runId, signal }),
       getDetail: async (signal) => asRecord2((await api.getRun({ token, runId, signal })).data),
       streamEvents: (opts) => api.events({
         token,
@@ -1262,6 +1336,7 @@ function createDoAnythingNamespace(transport) {
       if (!prompt || typeof prompt !== "string") {
         throw new QoniValidationError("doAnything.run requires a prompt string");
       }
+      validateBrowserProxyOptions(rest.browserProxy);
       const unsupported = PLATFORM_DECIDED_RUN_OPTIONS.filter(
         (key) => rest[key] !== void 0
       );
@@ -1303,6 +1378,7 @@ function createDoAnythingNamespace(transport) {
       await handle.status();
       return handle;
     },
+    artifacts,
     api
   };
 }
@@ -1312,8 +1388,13 @@ function normalizeDoAnythingRunInput(input) {
     profileId: "profile_id",
     keepAlive: "keep_alive",
     allowedActions: "allowed_actions",
-    maxDurationMinutes: "max_duration_minutes"
+    maxDurationMinutes: "max_duration_minutes",
+    browserProxy: "browser_proxy"
   });
+  const browserProxy = body.browser_proxy;
+  if (isJsonObject(browserProxy)) {
+    body.browser_proxy = renameKeys2(browserProxy, { proxyId: "proxy_id" });
+  }
   return body;
 }
 function normalizeDoAnythingInterveneInput(input) {