@roll-agent/core 0.7.0 → 0.8.0

package/dist/config/runtime-env.d.ts

@@ -17,16 +17,19 @@ export declare const BrowserSecurityDiagnosticSchema: z.ZodObject<{
     maxPageContentBytes: z.ZodNumber;
     maxSnapshotNodes: z.ZodNumber;
     actionPolicy: z.ZodEnum<["log", "deny", "confirm"]>;
+    foregroundPolicy: z.ZodDefault<z.ZodEnum<["when-minimized", "always", "never"]>>;
 }, "strip", z.ZodTypeAny, {
     domainAllowlist: string[];
     maxPageContentBytes: number;
     maxSnapshotNodes: number;
     actionPolicy: "log" | "deny" | "confirm";
+    foregroundPolicy: "never" | "when-minimized" | "always";
 }, {
     domainAllowlist: string[];
     maxPageContentBytes: number;
     maxSnapshotNodes: number;
     actionPolicy: "log" | "deny" | "confirm";
+    foregroundPolicy?: "never" | "when-minimized" | "always" | undefined;
 }>;
 export declare const BrowserUseToolPolicyDiagnosticSchema: z.ZodObject<{
     approvalTtlMs: z.ZodNumber;
@@ -58,6 +61,88 @@ export declare const BrowserUsePolicyWarningDiagnosticSchema: z.ZodObject<{
     code: string;
     message: string;
 }>;
+export declare const BrowserInstanceStatusDiagnosticSchema: z.ZodObject<{
+    id: z.ZodString;
+    platform: z.ZodOptional<z.ZodEnum<["zhipin", "yupao"]>>;
+    mode: z.ZodEnum<["managed-cdp", "remote-cdp", "existing-session"]>;
+    cdp: z.ZodObject<{
+        endpoint: z.ZodString;
+        port: z.ZodOptional<z.ZodNumber>;
+        versionReachable: z.ZodBoolean;
+        listReachable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        endpoint: string;
+        versionReachable: boolean;
+        listReachable: boolean;
+        port?: number | undefined;
+    }, {
+        endpoint: string;
+        versionReachable: boolean;
+        listReachable: boolean;
+        port?: number | undefined;
+    }>;
+    profile: z.ZodObject<{
+        userDataDir: z.ZodOptional<z.ZodString>;
+        exists: z.ZodBoolean;
+        writable: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        exists: boolean;
+        writable: boolean;
+        userDataDir?: string | undefined;
+    }, {
+        exists: boolean;
+        writable: boolean;
+        userDataDir?: string | undefined;
+    }>;
+    tracking: z.ZodObject<{
+        source: z.ZodEnum<["instance", "default-env", "missing"]>;
+        agentIdFingerprint: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: "instance" | "missing" | "default-env";
+        agentIdFingerprint?: string | undefined;
+    }, {
+        source: "instance" | "missing" | "default-env";
+        agentIdFingerprint?: string | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    mode: "managed-cdp" | "remote-cdp" | "existing-session";
+    id: string;
+    cdp: {
+        endpoint: string;
+        versionReachable: boolean;
+        listReachable: boolean;
+        port?: number | undefined;
+    };
+    profile: {
+        exists: boolean;
+        writable: boolean;
+        userDataDir?: string | undefined;
+    };
+    tracking: {
+        source: "instance" | "missing" | "default-env";
+        agentIdFingerprint?: string | undefined;
+    };
+    platform?: "zhipin" | "yupao" | undefined;
+}, {
+    mode: "managed-cdp" | "remote-cdp" | "existing-session";
+    id: string;
+    cdp: {
+        endpoint: string;
+        versionReachable: boolean;
+        listReachable: boolean;
+        port?: number | undefined;
+    };
+    profile: {
+        exists: boolean;
+        writable: boolean;
+        userDataDir?: string | undefined;
+    };
+    tracking: {
+        source: "instance" | "missing" | "default-env";
+        agentIdFingerprint?: string | undefined;
+    };
+    platform?: "zhipin" | "yupao" | undefined;
+}>;
 export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
     effectiveEnvSources: z.ZodRecord<z.ZodString, z.ZodObject<{
         present: z.ZodBoolean;
@@ -74,16 +159,19 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
         maxPageContentBytes: z.ZodNumber;
         maxSnapshotNodes: z.ZodNumber;
         actionPolicy: z.ZodEnum<["log", "deny", "confirm"]>;
+        foregroundPolicy: z.ZodDefault<z.ZodEnum<["when-minimized", "always", "never"]>>;
     }, "strip", z.ZodTypeAny, {
         domainAllowlist: string[];
         maxPageContentBytes: number;
         maxSnapshotNodes: number;
         actionPolicy: "log" | "deny" | "confirm";
+        foregroundPolicy: "never" | "when-minimized" | "always";
     }, {
         domainAllowlist: string[];
         maxPageContentBytes: number;
         maxSnapshotNodes: number;
         actionPolicy: "log" | "deny" | "confirm";
+        foregroundPolicy?: "never" | "when-minimized" | "always" | undefined;
     }>>;
     toolPolicy: z.ZodOptional<z.ZodObject<{
         approvalTtlMs: z.ZodNumber;
@@ -115,16 +203,121 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
         code: string;
         message: string;
     }>, "many">>;
+    defaultInstanceId: z.ZodOptional<z.ZodString>;
+    primaryInstanceId: z.ZodOptional<z.ZodString>;
+    instances: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        platform: z.ZodOptional<z.ZodEnum<["zhipin", "yupao"]>>;
+        mode: z.ZodEnum<["managed-cdp", "remote-cdp", "existing-session"]>;
+        cdp: z.ZodObject<{
+            endpoint: z.ZodString;
+            port: z.ZodOptional<z.ZodNumber>;
+            versionReachable: z.ZodBoolean;
+            listReachable: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            endpoint: string;
+            versionReachable: boolean;
+            listReachable: boolean;
+            port?: number | undefined;
+        }, {
+            endpoint: string;
+            versionReachable: boolean;
+            listReachable: boolean;
+            port?: number | undefined;
+        }>;
+        profile: z.ZodObject<{
+            userDataDir: z.ZodOptional<z.ZodString>;
+            exists: z.ZodBoolean;
+            writable: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        }, {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        }>;
+        tracking: z.ZodObject<{
+            source: z.ZodEnum<["instance", "default-env", "missing"]>;
+            agentIdFingerprint: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            source: "instance" | "missing" | "default-env";
+            agentIdFingerprint?: string | undefined;
+        }, {
+            source: "instance" | "missing" | "default-env";
+            agentIdFingerprint?: string | undefined;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "managed-cdp" | "remote-cdp" | "existing-session";
+        id: string;
+        cdp: {
+            endpoint: string;
+            versionReachable: boolean;
+            listReachable: boolean;
+            port?: number | undefined;
+        };
+        profile: {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        };
+        tracking: {
+            source: "instance" | "missing" | "default-env";
+            agentIdFingerprint?: string | undefined;
+        };
+        platform?: "zhipin" | "yupao" | undefined;
+    }, {
+        mode: "managed-cdp" | "remote-cdp" | "existing-session";
+        id: string;
+        cdp: {
+            endpoint: string;
+            versionReachable: boolean;
+            listReachable: boolean;
+            port?: number | undefined;
+        };
+        profile: {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        };
+        tracking: {
+            source: "instance" | "missing" | "default-env";
+            agentIdFingerprint?: string | undefined;
+        };
+        platform?: "zhipin" | "yupao" | undefined;
+    }>, "many">>;
 }, "strip", z.ZodTypeAny, {
     effectiveEnvSources: Record<string, {
         present: boolean;
         fingerprint?: string | undefined;
     }>;
+    instances?: {
+        mode: "managed-cdp" | "remote-cdp" | "existing-session";
+        id: string;
+        cdp: {
+            endpoint: string;
+            versionReachable: boolean;
+            listReachable: boolean;
+            port?: number | undefined;
+        };
+        profile: {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        };
+        tracking: {
+            source: "instance" | "missing" | "default-env";
+            agentIdFingerprint?: string | undefined;
+        };
+        platform?: "zhipin" | "yupao" | undefined;
+    }[] | undefined;
     security?: {
         domainAllowlist: string[];
         maxPageContentBytes: number;
         maxSnapshotNodes: number;
         actionPolicy: "log" | "deny" | "confirm";
+        foregroundPolicy: "never" | "when-minimized" | "always";
     } | undefined;
     toolPolicy?: {
         tools: Record<string, {
@@ -136,16 +329,39 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
         code: string;
         message: string;
     }[] | undefined;
+    defaultInstanceId?: string | undefined;
+    primaryInstanceId?: string | undefined;
 }, {
     effectiveEnvSources: Record<string, {
         present: boolean;
         fingerprint?: string | undefined;
     }>;
+    instances?: {
+        mode: "managed-cdp" | "remote-cdp" | "existing-session";
+        id: string;
+        cdp: {
+            endpoint: string;
+            versionReachable: boolean;
+            listReachable: boolean;
+            port?: number | undefined;
+        };
+        profile: {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        };
+        tracking: {
+            source: "instance" | "missing" | "default-env";
+            agentIdFingerprint?: string | undefined;
+        };
+        platform?: "zhipin" | "yupao" | undefined;
+    }[] | undefined;
     security?: {
         domainAllowlist: string[];
         maxPageContentBytes: number;
         maxSnapshotNodes: number;
         actionPolicy: "log" | "deny" | "confirm";
+        foregroundPolicy?: "never" | "when-minimized" | "always" | undefined;
     } | undefined;
     toolPolicy?: {
         tools: Record<string, {
@@ -157,11 +373,14 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
         code: string;
         message: string;
     }[] | undefined;
+    defaultInstanceId?: string | undefined;
+    primaryInstanceId?: string | undefined;
 }>;
 export type AgentRuntimeEnvDiagnosticPayload = z.infer<typeof AgentRuntimeEnvDiagnosticPayloadSchema>;
 export type BrowserSecurityDiagnostic = z.infer<typeof BrowserSecurityDiagnosticSchema>;
 export type BrowserUseToolPolicyDiagnostic = z.infer<typeof BrowserUseToolPolicyDiagnosticSchema>;
 export type BrowserUsePolicyWarningDiagnostic = z.infer<typeof BrowserUsePolicyWarningDiagnosticSchema>;
+export type BrowserInstanceStatusDiagnostic = z.infer<typeof BrowserInstanceStatusDiagnosticSchema>;
 export type AgentRuntimeEnvInspection = {
     readonly status: "verified";
     readonly toolName: DiagnosticToolName;

package/dist/config/runtime-env.js

@@ -1 +1 @@
-import{createHash as e}from"node:crypto";import{z as n}from"zod";export const DIAGNOSTIC_TOOL_CANDIDATES=["diagnostic_status","browser_status"];const t=new Set(DIAGNOSTIC_TOOL_CANDIDATES),i=/^[0-9a-f]{8}$/;export const EffectiveEnvSourceSchema=n.object({present:n.boolean(),fingerprint:n.string().regex(i).optional()});export const BrowserSecurityDiagnosticSchema=n.object({domainAllowlist:n.array(n.string()),maxPageContentBytes:n.number(),maxSnapshotNodes:n.number(),actionPolicy:n.enum(["log","deny","confirm"])});export const BrowserUseToolPolicyDiagnosticSchema=n.object({approvalTtlMs:n.number(),tools:n.record(n.object({policy:n.enum(["log","deny","confirm"])}))});export const BrowserUsePolicyWarningDiagnosticSchema=n.object({code:n.string(),message:n.string()});export const AgentRuntimeEnvDiagnosticPayloadSchema=n.object({effectiveEnvSources:n.record(EffectiveEnvSourceSchema),security:BrowserSecurityDiagnosticSchema.optional(),toolPolicy:BrowserUseToolPolicyDiagnosticSchema.optional(),policyWarnings:n.array(BrowserUsePolicyWarningDiagnosticSchema).optional()});export function shouldSkipRuntimeReadinessForTool(e){return t.has(e)}export function inspectAgentRuntimeEnvRequirements(e,n,t){const i=e.items.map(e=>{const i=n?.[e.name],r=void 0!==i;if("unverified"===t.status)return{...e,configuredInAgentsEnv:r,runtime:{verified:!1,reason:t.reason,message:t.message}};const o=t.payload.effectiveEnvSources[e.name];return o?.present?{...e,configuredInAgentsEnv:r,runtime:{verified:!0,present:!0,...void 0!==o.fingerprint?{fingerprint:o.fingerprint}:{},matchesAgentsEnv:void 0!==i&&void 0!==o.fingerprint&&s(i)===o.fingerprint}}:{...e,configuredInAgentsEnv:r,runtime:{verified:!0,present:!1}}});return{items:i,inspection:t,missingRequired:i.filter(e=>e.required&&r(e)),ephemeralItems:i.filter(o)}}export function summarizeAgentRuntimeEnvReport(e){if(e.missingRequired.length>0){const n=c(e.missingRequired);return"verified"===e.inspection.status?{status:"fail",message:`运行态缺失: ${n}`}:{status:"fail",message:`${a(e)}；${e.inspection.message}`}}if(e.ephemeralItems.length>0)return{status:"warn",message:`运行态漂移: ${c(e.ephemeralItems)}`};if("verified"===e.inspection.status)return{status:"ok",message:`声明的必填项已在运行态生效（${e.inspection.toolName}）`};const n=e.items.filter(e=>e.required&&"process.env"===e.source);return n.length>0?{status:"warn",message:`依赖当前 shell 环境: ${c(n)}；${e.inspection.message}`}:"diagnostic-tool-unavailable"===e.inspection.reason?{status:"ok",message:`声明的必填项已满足（${e.inspection.message}）`}:{status:"warn",message:`声明的必填项已满足；${e.inspection.message}`}}export function formatAgentEnvDeclarationSource(e){switch(e.source){case"agents.env":return"已配置于 agents.env";case"process.env":return"仅当前 shell 环境";case"default":return`默认值 (${e.default})`;case"missing":return"缺失"}}export function formatAgentRuntimeVerification(e){return"verified"===e.inspection.status?`已验证（${e.inspection.toolName}）`:`未校验（${e.inspection.message}）`}export function formatAgentEnvRuntimeStatus(e){if(e.runtime.verified)return e.runtime.present?e.runtime.matchesAgentsEnv?"✓ from yaml (stable)":e.configuredInAgentsEnv?"⚠ differs from yaml (ephemeral)":"⚠ from shell (ephemeral)":"default"===e.source?"未设置（使用默认值）":"process.env"===e.source?"✗ 当前运行 agent 未看到该变量":"✗ missing"}function s(n){return e("sha256").update(n).digest("hex").slice(0,8)}function r(e){return e.runtime.verified?!e.runtime.present&&"default"!==e.source:"missing"===e.source}function o(e){return e.runtime.verified&&e.runtime.present&&!e.runtime.matchesAgentsEnv}function a(e){return`缺少必填项: ${c(e.missingRequired)}`}function c(e){return e.map(e=>e.name).join(", ")}
+import{createHash as e}from"node:crypto";import{z as n}from"zod";export const DIAGNOSTIC_TOOL_CANDIDATES=["diagnostic_status","browser_status"];const t=new Set(DIAGNOSTIC_TOOL_CANDIDATES),i=/^[0-9a-f]{8}$/;export const EffectiveEnvSourceSchema=n.object({present:n.boolean(),fingerprint:n.string().regex(i).optional()});export const BrowserSecurityDiagnosticSchema=n.object({domainAllowlist:n.array(n.string()),maxPageContentBytes:n.number(),maxSnapshotNodes:n.number(),actionPolicy:n.enum(["log","deny","confirm"]),foregroundPolicy:n.enum(["when-minimized","always","never"]).default("when-minimized")});export const BrowserUseToolPolicyDiagnosticSchema=n.object({approvalTtlMs:n.number(),tools:n.record(n.object({policy:n.enum(["log","deny","confirm"])}))});export const BrowserUsePolicyWarningDiagnosticSchema=n.object({code:n.string(),message:n.string()});export const BrowserInstanceStatusDiagnosticSchema=n.object({id:n.string(),platform:n.enum(["zhipin","yupao"]).optional(),mode:n.enum(["managed-cdp","remote-cdp","existing-session"]),cdp:n.object({endpoint:n.string(),port:n.number().int().min(1).max(65535).optional(),versionReachable:n.boolean(),listReachable:n.boolean()}),profile:n.object({userDataDir:n.string().optional(),exists:n.boolean(),writable:n.boolean()}),tracking:n.object({source:n.enum(["instance","default-env","missing"]),agentIdFingerprint:n.string().regex(i).optional()})});export const AgentRuntimeEnvDiagnosticPayloadSchema=n.object({effectiveEnvSources:n.record(EffectiveEnvSourceSchema),security:BrowserSecurityDiagnosticSchema.optional(),toolPolicy:BrowserUseToolPolicyDiagnosticSchema.optional(),policyWarnings:n.array(BrowserUsePolicyWarningDiagnosticSchema).optional(),defaultInstanceId:n.string().optional(),primaryInstanceId:n.string().optional(),instances:n.array(BrowserInstanceStatusDiagnosticSchema).optional()});export function shouldSkipRuntimeReadinessForTool(e){return t.has(e)}export function inspectAgentRuntimeEnvRequirements(e,n,t){const i=e.items.map(e=>{const i=n?.[e.name],r=void 0!==i;if("unverified"===t.status)return{...e,configuredInAgentsEnv:r,runtime:{verified:!1,reason:t.reason,message:t.message}};const o=t.payload.effectiveEnvSources[e.name];return o?.present?{...e,configuredInAgentsEnv:r,runtime:{verified:!0,present:!0,...void 0!==o.fingerprint?{fingerprint:o.fingerprint}:{},matchesAgentsEnv:void 0!==i&&void 0!==o.fingerprint&&s(i)===o.fingerprint}}:{...e,configuredInAgentsEnv:r,runtime:{verified:!0,present:!1}}});return{items:i,inspection:t,missingRequired:i.filter(e=>e.required&&r(e)),ephemeralItems:i.filter(o)}}export function summarizeAgentRuntimeEnvReport(e){if(e.missingRequired.length>0){const n=c(e.missingRequired);return"verified"===e.inspection.status?{status:"fail",message:`运行态缺失: ${n}`}:{status:"fail",message:`${a(e)}；${e.inspection.message}`}}if(e.ephemeralItems.length>0)return{status:"warn",message:`运行态漂移: ${c(e.ephemeralItems)}`};if("verified"===e.inspection.status)return{status:"ok",message:`声明的必填项已在运行态生效（${e.inspection.toolName}）`};const n=e.items.filter(e=>e.required&&"process.env"===e.source);return n.length>0?{status:"warn",message:`依赖当前 shell 环境: ${c(n)}；${e.inspection.message}`}:"diagnostic-tool-unavailable"===e.inspection.reason?{status:"ok",message:`声明的必填项已满足（${e.inspection.message}）`}:{status:"warn",message:`声明的必填项已满足；${e.inspection.message}`}}export function formatAgentEnvDeclarationSource(e){switch(e.source){case"agents.env":return"已配置于 agents.env";case"process.env":return"仅当前 shell 环境";case"default":return`默认值 (${e.default})`;case"missing":return"缺失"}}export function formatAgentRuntimeVerification(e){return"verified"===e.inspection.status?`已验证（${e.inspection.toolName}）`:`未校验（${e.inspection.message}）`}export function formatAgentEnvRuntimeStatus(e){if(e.runtime.verified)return e.runtime.present?e.runtime.matchesAgentsEnv?"✓ from yaml (stable)":e.configuredInAgentsEnv?"⚠ differs from yaml (ephemeral)":"⚠ from shell (ephemeral)":"default"===e.source?"未设置（使用默认值）":"process.env"===e.source?"✗ 当前运行 agent 未看到该变量":"✗ missing"}function s(n){return e("sha256").update(n).digest("hex").slice(0,8)}function r(e){return e.runtime.verified?!e.runtime.present&&"default"!==e.source:"missing"===e.source}function o(e){return e.runtime.verified&&e.runtime.present&&!e.runtime.matchesAgentsEnv}function a(e){return`缺少必填项: ${c(e.missingRequired)}`}function c(e){return e.map(e=>e.name).join(", ")}