@standardagents/builder 0.40.0 → 0.40.2

package/dist/plugin.d.ts

@@ -1,5 +1,14 @@
 import { PluginOption } from 'vite';
 
+interface DeviceApprovalBrand {
+    /** Customer-facing product or instance name. */
+    name: string;
+    /** Optional short explanation shown before the user connects the device. */
+    description?: string;
+    /** Optional safe HTTPS or root-relative image URL. */
+    logoUrl?: string;
+}
+
 interface AgentPluginOptions {
     compatibilityDate?: string;
     toolsDir?: string;
@@ -17,8 +26,10 @@ interface AgentPluginOptions {
      * @example ['my-custom-provider', '@company/custom-openai']
      */
     providers?: string[];
+    /** Presentation used by the built-in device sign-in confirmation page. */
+    deviceApproval?: DeviceApprovalBrand;
 }
 declare function agentbuilder(options?: AgentPluginOptions): PluginOption[];
 declare const builder: typeof agentbuilder;
 
-export { type AgentPluginOptions, agentbuilder, builder };
+export { type AgentPluginOptions, type DeviceApprovalBrand, agentbuilder, builder };

package/dist/plugin.js

@@ -8077,7 +8077,8 @@ async function loadVirtualModule(id, context) {
     effectsDir,
     installedProviders,
     rou3Code,
-    hmr
+    hmr,
+    deviceApproval
   } = context;
   if (id === RESOLVED_VIRTUAL_TOOLS_ID) {
     const tools = await scanToolsDirectory(toolsDir);
@@ -8141,6 +8142,7 @@ export const config = {
   providersDir: "${relativeProvidersDir}",
   promptsDir: "${relativePromptsDir}",
   agentsDir: "${relativeAgentsDir}",
+  deviceApproval: ${JSON.stringify(deviceApproval ?? null)},
 };`;
   }
   if (id === RESOLVED_VIRTUAL_MODELS_ID) {
@@ -8500,8 +8502,50 @@ function applyPluginEnvironmentConfig(config) {
   }
 }
 
+// src/plugin/device-approval.ts
+function requiredText(value, field, maxLength) {
+  if (typeof value !== "string" || !value.trim() || value.trim().length > maxLength) {
+    throw new Error(`deviceApproval.${field} must be a non-empty string of ${maxLength} characters or fewer`);
+  }
+  return value.trim();
+}
+function optionalText(value, field, maxLength) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  if (typeof value !== "string" || !value.trim() || value.trim().length > maxLength) {
+    throw new Error(`deviceApproval.${field} must be a string of ${maxLength} characters or fewer`);
+  }
+  return value.trim();
+}
+function safeLogoUrl(value) {
+  const logoUrl = optionalText(value, "logoUrl", 2048);
+  if (!logoUrl) return void 0;
+  if (logoUrl.startsWith("/") && !logoUrl.startsWith("//") && !logoUrl.includes("#") && !logoUrl.includes("\\")) {
+    return logoUrl;
+  }
+  try {
+    const parsed = new URL(logoUrl);
+    if (parsed.protocol !== "https:" || parsed.username || parsed.password || parsed.hash) throw new Error();
+    return parsed.toString();
+  } catch {
+    throw new Error("deviceApproval.logoUrl must be a safe HTTPS or root-relative URL");
+  }
+}
+function normalizeDeviceApprovalBrand(value) {
+  if (value === void 0) return void 0;
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error("deviceApproval must be an object");
+  }
+  const normalized = { name: requiredText(value.name, "name", 100) };
+  const description = optionalText(value.description, "description", 280);
+  const logoUrl = safeLogoUrl(value.logoUrl);
+  if (description) normalized.description = description;
+  if (logoUrl) normalized.logoUrl = logoUrl;
+  return normalized;
+}
+
 // src/plugin.ts
 function agentbuilder(options = {}) {
+  const deviceApproval = normalizeDeviceApprovalBrand(options.deviceApproval);
   const toolsDir = options.toolsDir ? path9__default.resolve(process.cwd(), options.toolsDir) : path9__default.resolve(process.cwd(), "agents/tools");
   const hooksDir = options.hooksDir ? path9__default.resolve(process.cwd(), options.hooksDir) : path9__default.resolve(process.cwd(), "agents/hooks");
   const threadApiDir = options.apiDir ? path9__default.resolve(process.cwd(), options.apiDir) : path9__default.resolve(process.cwd(), "agents/api");
@@ -8592,7 +8636,8 @@ export { CodeExecutionBridge, DurableAgentBuilder, DurableThread, ThreadWatchdog
     effectsDir,
     installedProviders,
     rou3Code,
-    hmr
+    hmr,
+    deviceApproval
   };
   const devMiddlewareContext = {
     toolsDir,