@roll-agent/core 0.14.1 → 0.16.0

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

@@ -107,17 +107,17 @@ export declare const BrowserInstanceStatusDiagnosticSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     mode: "managed-cdp" | "remote-cdp" | "existing-session";
     id: string;
+    profile: {
+        exists: boolean;
+        writable: boolean;
+        userDataDir?: string | undefined;
+    };
     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;
@@ -126,17 +126,17 @@ export declare const BrowserInstanceStatusDiagnosticSchema: z.ZodObject<{
 }, {
     mode: "managed-cdp" | "remote-cdp" | "existing-session";
     id: string;
+    profile: {
+        exists: boolean;
+        writable: boolean;
+        userDataDir?: string | undefined;
+    };
     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;
@@ -251,17 +251,17 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         mode: "managed-cdp" | "remote-cdp" | "existing-session";
         id: string;
+        profile: {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        };
         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;
@@ -270,17 +270,17 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
     }, {
         mode: "managed-cdp" | "remote-cdp" | "existing-session";
         id: string;
+        profile: {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        };
         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;
@@ -295,17 +295,17 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
     instances?: {
         mode: "managed-cdp" | "remote-cdp" | "existing-session";
         id: string;
+        profile: {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        };
         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;
@@ -339,17 +339,17 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
     instances?: {
         mode: "managed-cdp" | "remote-cdp" | "existing-session";
         id: string;
+        profile: {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        };
         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;

package/dist/config/schema.d.ts

@@ -93,6 +93,72 @@ export declare const runtimeCompactionConfigSchema: z.ZodObject<{
     keepRecentTokens?: number | undefined;
 }>;
 export declare const runtimeThinkingLevels: readonly ["off", "low", "medium", "high"];
+export declare const runtimeShellSessionConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    maxSessions: z.ZodDefault<z.ZodNumber>;
+    defaultYieldMs: z.ZodDefault<z.ZodNumber>;
+    maxOutputTokens: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    maxOutputTokens: number;
+    enabled: boolean;
+    maxSessions: number;
+    defaultYieldMs: number;
+}, {
+    maxOutputTokens?: number | undefined;
+    enabled?: boolean | undefined;
+    maxSessions?: number | undefined;
+    defaultYieldMs?: number | undefined;
+}>;
+export declare const runtimeShellConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    autoApproveSafe: z.ZodDefault<z.ZodBoolean>;
+    defaultTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    maxTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    maxCaptureBytes: z.ZodDefault<z.ZodNumber>;
+    maxModelOutputChars: z.ZodDefault<z.ZodNumber>;
+    session: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        maxSessions: z.ZodDefault<z.ZodNumber>;
+        defaultYieldMs: z.ZodDefault<z.ZodNumber>;
+        maxOutputTokens: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxOutputTokens: number;
+        enabled: boolean;
+        maxSessions: number;
+        defaultYieldMs: number;
+    }, {
+        maxOutputTokens?: number | undefined;
+        enabled?: boolean | undefined;
+        maxSessions?: number | undefined;
+        defaultYieldMs?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    autoApproveSafe: boolean;
+    defaultTimeoutMs: number;
+    maxTimeoutMs: number;
+    maxCaptureBytes: number;
+    maxModelOutputChars: number;
+    session: {
+        maxOutputTokens: number;
+        enabled: boolean;
+        maxSessions: number;
+        defaultYieldMs: number;
+    };
+}, {
+    enabled?: boolean | undefined;
+    autoApproveSafe?: boolean | undefined;
+    defaultTimeoutMs?: number | undefined;
+    maxTimeoutMs?: number | undefined;
+    maxCaptureBytes?: number | undefined;
+    maxModelOutputChars?: number | undefined;
+    session?: {
+        maxOutputTokens?: number | undefined;
+        enabled?: boolean | undefined;
+        maxSessions?: number | undefined;
+        defaultYieldMs?: number | undefined;
+    } | undefined;
+}>;
 export declare const runtimeConfigSchema: z.ZodObject<{
     provider: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
@@ -130,7 +196,71 @@ export declare const runtimeConfigSchema: z.ZodObject<{
         keepRecentTurns?: number | undefined;
         keepRecentTokens?: number | undefined;
     }>>;
+    shell: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        autoApproveSafe: z.ZodDefault<z.ZodBoolean>;
+        defaultTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        maxTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        maxCaptureBytes: z.ZodDefault<z.ZodNumber>;
+        maxModelOutputChars: z.ZodDefault<z.ZodNumber>;
+        session: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            maxSessions: z.ZodDefault<z.ZodNumber>;
+            defaultYieldMs: z.ZodDefault<z.ZodNumber>;
+            maxOutputTokens: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            maxOutputTokens: number;
+            enabled: boolean;
+            maxSessions: number;
+            defaultYieldMs: number;
+        }, {
+            maxOutputTokens?: number | undefined;
+            enabled?: boolean | undefined;
+            maxSessions?: number | undefined;
+            defaultYieldMs?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        autoApproveSafe: boolean;
+        defaultTimeoutMs: number;
+        maxTimeoutMs: number;
+        maxCaptureBytes: number;
+        maxModelOutputChars: number;
+        session: {
+            maxOutputTokens: number;
+            enabled: boolean;
+            maxSessions: number;
+            defaultYieldMs: number;
+        };
+    }, {
+        enabled?: boolean | undefined;
+        autoApproveSafe?: boolean | undefined;
+        defaultTimeoutMs?: number | undefined;
+        maxTimeoutMs?: number | undefined;
+        maxCaptureBytes?: number | undefined;
+        maxModelOutputChars?: number | undefined;
+        session?: {
+            maxOutputTokens?: number | undefined;
+            enabled?: boolean | undefined;
+            maxSessions?: number | undefined;
+            defaultYieldMs?: number | undefined;
+        } | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
+    shell: {
+        enabled: boolean;
+        autoApproveSafe: boolean;
+        defaultTimeoutMs: number;
+        maxTimeoutMs: number;
+        maxCaptureBytes: number;
+        maxModelOutputChars: number;
+        session: {
+            maxOutputTokens: number;
+            enabled: boolean;
+            maxSessions: number;
+            defaultYieldMs: number;
+        };
+    };
     maxSteps: number;
     turnTimeoutMs: number;
     threadsDir: string;
@@ -150,6 +280,20 @@ export declare const runtimeConfigSchema: z.ZodObject<{
     provider?: string | undefined;
     contextWindow?: number | undefined;
 }, {
+    shell?: {
+        enabled?: boolean | undefined;
+        autoApproveSafe?: boolean | undefined;
+        defaultTimeoutMs?: number | undefined;
+        maxTimeoutMs?: number | undefined;
+        maxCaptureBytes?: number | undefined;
+        maxModelOutputChars?: number | undefined;
+        session?: {
+            maxOutputTokens?: number | undefined;
+            enabled?: boolean | undefined;
+            maxSessions?: number | undefined;
+            defaultYieldMs?: number | undefined;
+        } | undefined;
+    } | undefined;
     model?: string | undefined;
     provider?: string | undefined;
     maxSteps?: number | undefined;
@@ -169,6 +313,14 @@ export declare const runtimeConfigSchema: z.ZodObject<{
         keepRecentTokens?: number | undefined;
     } | undefined;
 }>;
+export declare const skillsConfigSchema: z.ZodObject<{
+    /** 额外的 skill 目录（canonical `.agents/skills` 之外的补充来源）。 */
+    dirs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    dirs: string[];
+}, {
+    dirs?: string[] | undefined;
+}>;
 export declare const agentsConfigSchema: z.ZodObject<{
     dataDir: z.ZodString;
     /** per-agent 环境变量：键为 agent name，值为 key-value 对 */
@@ -613,7 +765,71 @@ export declare const rollConfigSchema: z.ZodObject<{
             keepRecentTurns?: number | undefined;
             keepRecentTokens?: number | undefined;
         }>>;
+        shell: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            autoApproveSafe: z.ZodDefault<z.ZodBoolean>;
+            defaultTimeoutMs: z.ZodDefault<z.ZodNumber>;
+            maxTimeoutMs: z.ZodDefault<z.ZodNumber>;
+            maxCaptureBytes: z.ZodDefault<z.ZodNumber>;
+            maxModelOutputChars: z.ZodDefault<z.ZodNumber>;
+            session: z.ZodDefault<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                maxSessions: z.ZodDefault<z.ZodNumber>;
+                defaultYieldMs: z.ZodDefault<z.ZodNumber>;
+                maxOutputTokens: z.ZodDefault<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                maxOutputTokens: number;
+                enabled: boolean;
+                maxSessions: number;
+                defaultYieldMs: number;
+            }, {
+                maxOutputTokens?: number | undefined;
+                enabled?: boolean | undefined;
+                maxSessions?: number | undefined;
+                defaultYieldMs?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            autoApproveSafe: boolean;
+            defaultTimeoutMs: number;
+            maxTimeoutMs: number;
+            maxCaptureBytes: number;
+            maxModelOutputChars: number;
+            session: {
+                maxOutputTokens: number;
+                enabled: boolean;
+                maxSessions: number;
+                defaultYieldMs: number;
+            };
+        }, {
+            enabled?: boolean | undefined;
+            autoApproveSafe?: boolean | undefined;
+            defaultTimeoutMs?: number | undefined;
+            maxTimeoutMs?: number | undefined;
+            maxCaptureBytes?: number | undefined;
+            maxModelOutputChars?: number | undefined;
+            session?: {
+                maxOutputTokens?: number | undefined;
+                enabled?: boolean | undefined;
+                maxSessions?: number | undefined;
+                defaultYieldMs?: number | undefined;
+            } | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
+        shell: {
+            enabled: boolean;
+            autoApproveSafe: boolean;
+            defaultTimeoutMs: number;
+            maxTimeoutMs: number;
+            maxCaptureBytes: number;
+            maxModelOutputChars: number;
+            session: {
+                maxOutputTokens: number;
+                enabled: boolean;
+                maxSessions: number;
+                defaultYieldMs: number;
+            };
+        };
         maxSteps: number;
         turnTimeoutMs: number;
         threadsDir: string;
@@ -633,6 +849,20 @@ export declare const rollConfigSchema: z.ZodObject<{
         provider?: string | undefined;
         contextWindow?: number | undefined;
     }, {
+        shell?: {
+            enabled?: boolean | undefined;
+            autoApproveSafe?: boolean | undefined;
+            defaultTimeoutMs?: number | undefined;
+            maxTimeoutMs?: number | undefined;
+            maxCaptureBytes?: number | undefined;
+            maxModelOutputChars?: number | undefined;
+            session?: {
+                maxOutputTokens?: number | undefined;
+                enabled?: boolean | undefined;
+                maxSessions?: number | undefined;
+                defaultYieldMs?: number | undefined;
+            } | undefined;
+        } | undefined;
         model?: string | undefined;
         provider?: string | undefined;
         maxSteps?: number | undefined;
@@ -652,6 +882,14 @@ export declare const rollConfigSchema: z.ZodObject<{
             keepRecentTokens?: number | undefined;
         } | undefined;
     }>>;
+    skills: z.ZodDefault<z.ZodObject<{
+        /** 额外的 skill 目录（canonical `.agents/skills` 之外的补充来源）。 */
+        dirs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        dirs: string[];
+    }, {
+        dirs?: string[] | undefined;
+    }>>;
     agents: z.ZodObject<{
         dataDir: z.ZodString;
         /** per-agent 环境变量：键为 agent name，值为 key-value 对 */
@@ -909,6 +1147,9 @@ export declare const rollConfigSchema: z.ZodObject<{
         llmModel?: string | undefined;
         confirmThreshold?: number | undefined;
     };
+    skills: {
+        dirs: string[];
+    };
     browser: {
         instances: Record<string, {
             mode: "managed-cdp" | "remote-cdp" | "existing-session";
@@ -943,6 +1184,20 @@ export declare const rollConfigSchema: z.ZodObject<{
         }>;
     };
     runtime: {
+        shell: {
+            enabled: boolean;
+            autoApproveSafe: boolean;
+            defaultTimeoutMs: number;
+            maxTimeoutMs: number;
+            maxCaptureBytes: number;
+            maxModelOutputChars: number;
+            session: {
+                maxOutputTokens: number;
+                enabled: boolean;
+                maxSessions: number;
+                defaultYieldMs: number;
+            };
+        };
         maxSteps: number;
         turnTimeoutMs: number;
         threadsDir: string;
@@ -989,6 +1244,9 @@ export declare const rollConfigSchema: z.ZodObject<{
         preferOffline?: boolean | undefined;
         networkTimeoutMs?: number | undefined;
     } | undefined;
+    skills?: {
+        dirs?: string[] | undefined;
+    } | undefined;
     browser?: {
         defaultInstance?: string | undefined;
         instances?: Record<string, {
@@ -1015,6 +1273,20 @@ export declare const rollConfigSchema: z.ZodObject<{
         }> | undefined;
     } | undefined;
     runtime?: {
+        shell?: {
+            enabled?: boolean | undefined;
+            autoApproveSafe?: boolean | undefined;
+            defaultTimeoutMs?: number | undefined;
+            maxTimeoutMs?: number | undefined;
+            maxCaptureBytes?: number | undefined;
+            maxModelOutputChars?: number | undefined;
+            session?: {
+                maxOutputTokens?: number | undefined;
+                enabled?: boolean | undefined;
+                maxSessions?: number | undefined;
+                defaultYieldMs?: number | undefined;
+            } | undefined;
+        } | undefined;
         model?: string | undefined;
         provider?: string | undefined;
         maxSteps?: number | undefined;
@@ -1037,6 +1309,7 @@ export declare const rollConfigSchema: z.ZodObject<{
 }>;
 export type RollConfig = z.infer<typeof rollConfigSchema>;
 export type RuntimeConfig = z.infer<typeof runtimeConfigSchema>;
+export type SkillsConfig = z.infer<typeof skillsConfigSchema>;
 export type RuntimeApprovalConfig = z.infer<typeof runtimeApprovalConfigSchema>;
 export type BrowserConfig = z.infer<typeof browserConfigSchema>;
 export type InstallConfig = z.infer<typeof installConfigSchema>;

package/dist/config/schema.js

@@ -1 +1 @@
-import{z as e}from"zod";const t=["zhipin","yupao"],o=["managed-cdp","remote-cdp","existing-session"],n=["chrome","chromium","msedge"],i=["guarded","auto","deny"],r=["auto","confirm","deny"],a=["summarize","truncate"],s=e.string().trim().regex(/^#[\da-fA-F]{6}$/,"profileColor must be a hex RGB color such as #2563EB").transform(e=>e.toUpperCase());export const browserWindowBoundsSchema=e.object({x:e.number().int().optional(),y:e.number().int().optional(),width:e.number().int().positive().optional(),height:e.number().int().positive().optional()});export const providerConfigSchema=e.object({apiKey:e.string(),baseUrl:e.string().optional()});export const llmConfigSchema=e.object({defaultProvider:e.string(),defaultModel:e.string(),providers:e.record(e.string(),providerConfigSchema)});export const askConfigSchema=e.object({llmModel:e.string().optional(),confirmThreshold:e.number().optional()});export const runtimeApprovalConfigSchema=e.object({default:e.enum(i).default("guarded"),overrides:e.record(e.string(),e.enum(r)).default({})});export const runtimeCompactionConfigSchema=e.object({enabled:e.boolean().default(!0),strategy:e.enum(a).default("summarize"),threshold:e.number().min(.1).max(.95).default(.75),keepRecentTurns:e.number().int().min(1).default(4),keepRecentTokens:e.number().int().min(1).default(32e3)});export const runtimeThinkingLevels=["off","low","medium","high"];export const runtimeConfigSchema=e.object({provider:e.string().optional(),model:e.string().optional(),maxSteps:e.number().int().min(1).default(80),turnTimeoutMs:e.number().int().min(1e4).default(3e5),threadsDir:e.string().default("~/.roll-agent/threads"),contextWindow:e.number().int().min(1).optional(),thinkingLevel:e.enum(runtimeThinkingLevels).default("medium"),approval:runtimeApprovalConfigSchema.default({}),compaction:runtimeCompactionConfigSchema.default({})});export const agentsConfigSchema=e.object({dataDir:e.string(),env:e.record(e.string(),e.record(e.string(),e.string())).optional()});export const installConfigSchema=e.object({registry:e.string().trim().url().optional(),fetchRetries:e.number().int().min(0).max(10).default(3),preferOffline:e.boolean().default(!1),networkTimeoutMs:e.number().int().min(1e4).default(12e4)});export const browserInstanceConfigSchema=e.object({platform:e.enum(t).optional(),mode:e.enum(o).default("managed-cdp"),headless:e.boolean().optional(),cdpUrl:e.string().optional(),cdpHost:e.string().default("127.0.0.1"),cdpPort:e.number().int().min(1).max(65535).optional(),channel:e.enum(n).default("chrome"),executablePath:e.string().optional(),userDataDir:e.string().trim().min(1),sessionsDir:e.string().trim().min(1).optional(),args:e.array(e.string()).optional(),profileName:e.string().trim().min(1).optional(),profileColor:s.optional(),windowBounds:browserWindowBoundsSchema.optional(),trackingAgentId:e.string().trim().min(1).optional()}).superRefine((t,o)=>{"managed-cdp"===t.mode&&void 0===t.cdpPort&&o.addIssue({code:e.ZodIssueCode.custom,path:["cdpPort"],message:"managed-cdp browser instance requires cdpPort"}),"remote-cdp"!==t.mode&&"existing-session"!==t.mode||void 0!==t.cdpUrl||o.addIssue({code:e.ZodIssueCode.custom,path:["cdpUrl"],message:`${t.mode} browser instance requires cdpUrl`})});export const browserConfigSchema=e.object({defaultInstance:e.string().trim().min(1).optional(),instances:e.record(e.string(),browserInstanceConfigSchema).default({})}).superRefine((t,o)=>{const n=Object.entries(t.instances);void 0!==t.defaultInstance&&void 0===t.instances[t.defaultInstance]&&o.addIssue({code:e.ZodIssueCode.custom,path:["defaultInstance"],message:`defaultInstance "${t.defaultInstance}" is not declared in browser.instances`});const i=new Map,r=new Map;for(const[t,a]of n){if(void 0!==a.cdpPort){const n=i.get(a.cdpPort);void 0!==n?o.addIssue({code:e.ZodIssueCode.custom,path:["instances",t,"cdpPort"],message:`cdpPort ${String(a.cdpPort)} is already used by browser instance "${n}"`}):i.set(a.cdpPort,t)}const n=r.get(a.userDataDir);void 0!==n?o.addIssue({code:e.ZodIssueCode.custom,path:["instances",t,"userDataDir"],message:`userDataDir is already used by browser instance "${n}"`}):r.set(a.userDataDir,t)}});export const rollConfigSchema=e.object({llm:llmConfigSchema,ask:askConfigSchema,runtime:runtimeConfigSchema.default({}),agents:agentsConfigSchema,install:installConfigSchema.default({}),browser:browserConfigSchema.default({})});
+import{z as e}from"zod";const t=["zhipin","yupao"],n=["managed-cdp","remote-cdp","existing-session"],o=["chrome","chromium","msedge"],i=["guarded","auto","deny"],a=["auto","confirm","deny"],r=["summarize","truncate"],s=e.string().trim().regex(/^#[\da-fA-F]{6}$/,"profileColor must be a hex RGB color such as #2563EB").transform(e=>e.toUpperCase());export const browserWindowBoundsSchema=e.object({x:e.number().int().optional(),y:e.number().int().optional(),width:e.number().int().positive().optional(),height:e.number().int().positive().optional()});export const providerConfigSchema=e.object({apiKey:e.string(),baseUrl:e.string().optional()});export const llmConfigSchema=e.object({defaultProvider:e.string(),defaultModel:e.string(),providers:e.record(e.string(),providerConfigSchema)});export const askConfigSchema=e.object({llmModel:e.string().optional(),confirmThreshold:e.number().optional()});export const runtimeApprovalConfigSchema=e.object({default:e.enum(i).default("guarded"),overrides:e.record(e.string(),e.enum(a)).default({})});export const runtimeCompactionConfigSchema=e.object({enabled:e.boolean().default(!0),strategy:e.enum(r).default("summarize"),threshold:e.number().min(.1).max(.95).default(.75),keepRecentTurns:e.number().int().min(1).default(4),keepRecentTokens:e.number().int().min(1).default(32e3)});export const runtimeThinkingLevels=["off","low","medium","high"];export const runtimeShellSessionConfigSchema=e.object({enabled:e.boolean().default(!1),maxSessions:e.number().int().min(1).max(64).default(8),defaultYieldMs:e.number().int().min(250).max(3e4).default(1e4),maxOutputTokens:e.number().int().min(256).default(1e4)});export const runtimeShellConfigSchema=e.object({enabled:e.boolean().default(!1),autoApproveSafe:e.boolean().default(!0),defaultTimeoutMs:e.number().int().min(1e3).max(6e5).default(1e4),maxTimeoutMs:e.number().int().min(1e3).max(6e5).default(6e5),maxCaptureBytes:e.number().int().min(16384).default(1048576),maxModelOutputChars:e.number().int().min(1e3).default(16e3),session:runtimeShellSessionConfigSchema.default({})});export const runtimeConfigSchema=e.object({provider:e.string().optional(),model:e.string().optional(),maxSteps:e.number().int().min(1).default(80),turnTimeoutMs:e.number().int().min(1e4).default(3e5),threadsDir:e.string().default("~/.roll-agent/threads"),contextWindow:e.number().int().min(1).optional(),thinkingLevel:e.enum(runtimeThinkingLevels).default("medium"),approval:runtimeApprovalConfigSchema.default({}),compaction:runtimeCompactionConfigSchema.default({}),shell:runtimeShellConfigSchema.default({})});export const skillsConfigSchema=e.object({dirs:e.array(e.string().trim().min(1)).default([])});export const agentsConfigSchema=e.object({dataDir:e.string(),env:e.record(e.string(),e.record(e.string(),e.string())).optional()});export const installConfigSchema=e.object({registry:e.string().trim().url().optional(),fetchRetries:e.number().int().min(0).max(10).default(3),preferOffline:e.boolean().default(!1),networkTimeoutMs:e.number().int().min(1e4).default(12e4)});export const browserInstanceConfigSchema=e.object({platform:e.enum(t).optional(),mode:e.enum(n).default("managed-cdp"),headless:e.boolean().optional(),cdpUrl:e.string().optional(),cdpHost:e.string().default("127.0.0.1"),cdpPort:e.number().int().min(1).max(65535).optional(),channel:e.enum(o).default("chrome"),executablePath:e.string().optional(),userDataDir:e.string().trim().min(1),sessionsDir:e.string().trim().min(1).optional(),args:e.array(e.string()).optional(),profileName:e.string().trim().min(1).optional(),profileColor:s.optional(),windowBounds:browserWindowBoundsSchema.optional(),trackingAgentId:e.string().trim().min(1).optional()}).superRefine((t,n)=>{"managed-cdp"===t.mode&&void 0===t.cdpPort&&n.addIssue({code:e.ZodIssueCode.custom,path:["cdpPort"],message:"managed-cdp browser instance requires cdpPort"}),"remote-cdp"!==t.mode&&"existing-session"!==t.mode||void 0!==t.cdpUrl||n.addIssue({code:e.ZodIssueCode.custom,path:["cdpUrl"],message:`${t.mode} browser instance requires cdpUrl`})});export const browserConfigSchema=e.object({defaultInstance:e.string().trim().min(1).optional(),instances:e.record(e.string(),browserInstanceConfigSchema).default({})}).superRefine((t,n)=>{const o=Object.entries(t.instances);void 0!==t.defaultInstance&&void 0===t.instances[t.defaultInstance]&&n.addIssue({code:e.ZodIssueCode.custom,path:["defaultInstance"],message:`defaultInstance "${t.defaultInstance}" is not declared in browser.instances`});const i=new Map,a=new Map;for(const[t,r]of o){if(void 0!==r.cdpPort){const o=i.get(r.cdpPort);void 0!==o?n.addIssue({code:e.ZodIssueCode.custom,path:["instances",t,"cdpPort"],message:`cdpPort ${String(r.cdpPort)} is already used by browser instance "${o}"`}):i.set(r.cdpPort,t)}const o=a.get(r.userDataDir);void 0!==o?n.addIssue({code:e.ZodIssueCode.custom,path:["instances",t,"userDataDir"],message:`userDataDir is already used by browser instance "${o}"`}):a.set(r.userDataDir,t)}});export const rollConfigSchema=e.object({llm:llmConfigSchema,ask:askConfigSchema,runtime:runtimeConfigSchema.default({}),skills:skillsConfigSchema.default({}),agents:agentsConfigSchema,install:installConfigSchema.default({}),browser:browserConfigSchema.default({})});

package/dist/mcp/client-manager.js

@@ -1 +1 @@
-import{Client as n}from"@modelcontextprotocol/sdk/client/index.js";import{StdioClientTransport as t}from"@modelcontextprotocol/sdk/client/stdio.js";import{StreamableHTTPClientTransport as e}from"@modelcontextprotocol/sdk/client/streamableHttp.js";import{registerSamplingHandler as o}from"./sampling-handler.js";const s=3e4,i="--disable-warning=ExperimentalWarning";export function buildStdioChildEnv(n){const t=n?{...process.env,...n}:{};return{...t,NODE_OPTIONS:r(t.NODE_OPTIONS,i),ROLL_AGENT_LOG_LEVEL:t.ROLL_AGENT_LOG_LEVEL??"warn",PYTHONUTF8:t.PYTHONUTF8??"1",PYTHONIOENCODING:t.PYTHONIOENCODING??"utf-8"}}function r(n,t){const e=n?.trim();if(!e)return t;const o=e.split(/\s+/);return o.includes("--no-warnings")||o.includes(t)?e:`${e} ${t}`}export function shouldSuppressStdioChildStderrLine(n){const t=n.trim();return t.includes("ExperimentalWarning:")||t.startsWith("(Use `node --trace-warnings")||/\[INFO\s*\]\s*\[[^\]]+\]\s*MCP Server running on stdio$/.test(t)}function c(n,e,o){const s=new t({command:n.command,args:[...n.args??[]],cwd:e,env:buildStdioChildEnv(o),stderr:"pipe"});return l(s),s}function l(n){const t=n.stderr;if(!t)return;let e="";const o=n=>{shouldSuppressStdioChildStderrLine(n)||process.stderr.write(`${n}\n`)};t.on("data",n=>{e+=n.toString();const t=e.split(/\r?\n/);e=t.pop()??"";for(const n of t)o(n)}),t.on("end",()=>{e.length>0&&(o(e),e="")})}export class McpClientManager{connections=new Map;async connect(t,i,r,l={}){const a=this.connections.get(t);if(a)return a.client;const d=l.timeoutMs??s,p=l.samplingModel?{sampling:{}}:{},m=new n({name:`roll-client-${t}`,version:"0.0.1"},{capabilities:p});l.samplingModel&&o(m,l.samplingModel);const u="streamable-http"===i.type?new e(new URL(i.endpoint)):c(i,r,l.env),h=m.connect(u);let O;const g=new Promise((n,e)=>{O=setTimeout(()=>e(new Error(`Connection to "${t}" timed out after ${d}ms`)),d)});try{await Promise.race([h,g])}catch(n){throw await m.close().catch(()=>{}),n}finally{clearTimeout(O)}return this.connections.set(t,{client:m,transportType:i.type}),m}async disconnect(n){const t=this.connections.get(n);t&&(await t.client.close(),this.connections.delete(n))}async disconnectAll(){const n=[...this.connections.keys()];await Promise.all(n.map(n=>this.disconnect(n)))}isConnected(n){return this.connections.has(n)}}
+import{Client as n}from"@modelcontextprotocol/sdk/client/index.js";import{StdioClientTransport as t}from"@modelcontextprotocol/sdk/client/stdio.js";import{StreamableHTTPClientTransport as e}from"@modelcontextprotocol/sdk/client/streamableHttp.js";import{registerSamplingHandler as o}from"./sampling-handler.js";const s=3e4,i="--disable-warning=ExperimentalWarning";export function buildStdioChildEnv(n){const t={...process.env,...n??{}};return{...t,NODE_OPTIONS:r(t.NODE_OPTIONS,i),ROLL_AGENT_LOG_LEVEL:t.ROLL_AGENT_LOG_LEVEL??"warn",PYTHONUTF8:t.PYTHONUTF8??"1",PYTHONIOENCODING:t.PYTHONIOENCODING??"utf-8"}}function r(n,t){const e=n?.trim();if(!e)return t;const o=e.split(/\s+/);return o.includes("--no-warnings")||o.includes(t)?e:`${e} ${t}`}export function shouldSuppressStdioChildStderrLine(n){const t=n.trim();return t.includes("ExperimentalWarning:")||t.startsWith("(Use `node --trace-warnings")||/\[INFO\s*\]\s*\[[^\]]+\]\s*MCP Server running on stdio$/.test(t)}function c(n,e,o){const s=new t({command:n.command,args:[...n.args??[]],cwd:e,env:buildStdioChildEnv(o),stderr:"pipe"});return l(s),s}function l(n){const t=n.stderr;if(!t)return;let e="";const o=n=>{shouldSuppressStdioChildStderrLine(n)||process.stderr.write(`${n}\n`)};t.on("data",n=>{e+=n.toString();const t=e.split(/\r?\n/);e=t.pop()??"";for(const n of t)o(n)}),t.on("end",()=>{e.length>0&&(o(e),e="")})}export class McpClientManager{connections=new Map;async connect(t,i,r,l={}){const a=this.connections.get(t);if(a)return a.client;const d=l.timeoutMs??s,p=l.samplingModel?{sampling:{}}:{},m=new n({name:`roll-client-${t}`,version:"0.0.1"},{capabilities:p});l.samplingModel&&o(m,l.samplingModel);const u="streamable-http"===i.type?new e(new URL(i.endpoint)):c(i,r,l.env),h=m.connect(u);let O;const g=new Promise((n,e)=>{O=setTimeout(()=>e(new Error(`Connection to "${t}" timed out after ${d}ms`)),d)});try{await Promise.race([h,g])}catch(n){throw await m.close().catch(()=>{}),n}finally{clearTimeout(O)}return this.connections.set(t,{client:m,transportType:i.type}),m}async disconnect(n){const t=this.connections.get(n);t&&(await t.client.close(),this.connections.delete(n))}async disconnectAll(){const n=[...this.connections.keys()];await Promise.all(n.map(n=>this.disconnect(n)))}isConnected(n){return this.connections.has(n)}}

package/dist/registry/catalog-discovery.d.ts

@@ -0,0 +1,30 @@
+import type { AgentCatalogEntry } from "./catalog.ts";
+import type { RollConfig } from "../config/schema.ts";
+export interface CatalogCacheFile {
+    readonly checkedAt: number;
+    readonly registry: string;
+    readonly entries: readonly AgentCatalogEntry[];
+}
+export interface DiscoveredPackageInfo {
+    readonly description?: string;
+    readonly hasRollAgentManifest: boolean;
+}
+export interface DiscoveryCommandOptions {
+    readonly registry?: string;
+    readonly timeoutMs: number;
+}
+export interface ResolveCatalogCollaborators {
+    readonly searchScopePackages?: (options: DiscoveryCommandOptions) => Promise<readonly string[]>;
+    readonly fetchPackageInfo?: (packageName: string, options: DiscoveryCommandOptions) => Promise<DiscoveredPackageInfo | undefined>;
+    readonly readCache?: () => CatalogCacheFile | undefined;
+    readonly writeCache?: (cache: CatalogCacheFile) => void;
+    readonly now?: () => number;
+}
+export interface ResolveCatalogOptions {
+    readonly allowNetwork?: boolean;
+    readonly forceRefresh?: boolean;
+    readonly registry?: string;
+    readonly timeoutMs?: number;
+    readonly collaborators?: ResolveCatalogCollaborators;
+}
+export declare function resolveAgentCatalog(config?: RollConfig, options?: ResolveCatalogOptions): Promise<readonly AgentCatalogEntry[]>;

package/dist/registry/catalog-discovery.js

@@ -0,0 +1 @@
+import{existsSync as t,mkdirSync as e,readFileSync as r,writeFileSync as n}from"node:fs";import{homedir as o}from"node:os";import{dirname as i,resolve as s}from"node:path";import{npmViewNetworkArgs as a,runPackageManager as c}from"../cli/utils/package-manager.js";import{getAgentCatalog as u}from"./catalog.js";const f="@roll-agent/",l=864e5,g=1e4,m=100;export async function resolveAgentCatalog(t,e={}){const r=u(t),n=e.collaborators??{},o=n.readCache??j,i=n.writeCache??S,s=n.now??Date.now,a=e.registry??"",c=o(),f=c?.registry===a?c:void 0;if(!e.forceRefresh&&f&&s()-f.checkedAt<l)return d(r,f.entries);if(!(e.allowNetwork??1))return d(r,f?.entries??[]);const g=await p(r,e,n);return void 0===g?d(r,f?.entries??[]):(i({checkedAt:s(),registry:a,entries:g}),d(r,g))}async function p(t,e,r){const n=r.searchScopePackages??N,o=r.fetchPackageInfo??k,i={...e.registry?{registry:e.registry}:{},timeoutMs:e.timeoutMs??g};let s;try{s=await n(i)}catch{return}const a=new Set(t.map(t=>t.packageName)),c=[...new Set(s)].filter(t=>t.startsWith(f)&&!a.has(t)),u=[];for(const t of c){let e;try{e=await o(t,i)}catch{continue}e?.hasRollAgentManifest&&u.push(h(t,e.description))}return u}function y(t){const e=t.slice(12),r=e.endsWith("-agent")?e.slice(0,-6):e;return r.length>0?r:e}function h(t,e){const r=e?.trim()??"";return{shortName:y(t),packageName:t,skillName:t.slice(12),description:r.length>0?r:t,requiredEnv:[]}}function d(t,e){const r=new Set(t.map(t=>t.packageName)),n=new Set(t.map(t=>t.shortName)),o=[...t];for(const t of e){if(r.has(t.packageName))continue;let e=t.shortName;n.has(e)&&(e=t.packageName.slice(12)),n.has(e)||(o.push(e===t.shortName?t:{...t,shortName:e}),r.add(t.packageName),n.add(e))}return o}async function N(t){const e=a({...t.registry?{registry:t.registry}:{}}),{stdout:r}=await c({command:"npm",args:["search",f.slice(0,-1),"--json",`--searchlimit=${String(m)}`,...e]},{timeout:t.timeoutMs}),n=r.trim();if(0===n.length)return[];const o=JSON.parse(n);return Array.isArray(o)?o.flatMap(t=>"object"==typeof t&&null!==t&&"name"in t&&"string"==typeof t.name?[t.name]:[]):[]}async function k(t,e){const r=a({...e.registry?{registry:e.registry}:{}}),{stdout:n}=await c({command:"npm",args:["view",t,"name","description","rollAgent","--json",...r]},{timeout:e.timeoutMs}),o=n.trim();if(0===o.length)return;const i=JSON.parse(o);if("object"!=typeof i||null===i)return;const s=i;return{..."string"==typeof s.description?{description:s.description}:{},hasRollAgentManifest:"object"==typeof s.rollAgent&&null!==s.rollAgent}}function w(){return s(o(),".roll-agent","catalog-cache.json")}function A(t){if("object"!=typeof t||null===t)return!1;const e=t;return"string"==typeof e.shortName&&"string"==typeof e.packageName&&"string"==typeof e.skillName&&"string"==typeof e.description&&Array.isArray(e.requiredEnv)&&e.requiredEnv.every(t=>"string"==typeof t)}function v(t){if("object"!=typeof t||null===t)return!1;const e=t;return"number"==typeof e.checkedAt&&"string"==typeof e.registry&&Array.isArray(e.entries)&&e.entries.every(t=>A(t))}function j(){const e=w();if(t(e))try{const t=JSON.parse(r(e,"utf-8"));return v(t)?t:void 0}catch{return}}function S(r){try{const o=w(),s=i(o);t(s)||e(s,{recursive:!0}),n(o,JSON.stringify(r),"utf-8")}catch{}}

package/dist/registry/catalog.d.ts

@@ -0,0 +1,42 @@
+import type { RollConfig } from "../config/schema.ts";
+export interface AgentCatalogEntry {
+    readonly shortName: string;
+    readonly packageName: string;
+    readonly skillName: string;
+    readonly description: string;
+    readonly requiredEnv: readonly string[];
+    readonly minCoreVersion?: string;
+}
+export declare const OFFICIAL_AGENT_CATALOG: readonly [{
+    readonly shortName: "browser-use";
+    readonly packageName: "@roll-agent/browser-use-agent";
+    readonly skillName: "browser-use-agent";
+    readonly description: "浏览器操控 Agent。控制浏览器操作招聘平台：读取消息、发送签名回复、筛选候选人，并提供通用 AX snapshot 与元素点击/输入能力。";
+    readonly requiredEnv: readonly ["REPLY_AUTHORITY_URL", "REPLY_AUTHORITY_BEARER_TOKEN", "REPLY_AUTHORITY_KEYS_URL", "RECRUITMENT_EVENTS_DEFAULT_AGENT_ID", "RECRUITMENT_EVENTS_API_TOKEN"];
+}, {
+    readonly shortName: "smart-reply";
+    readonly packageName: "@roll-agent/smart-reply-agent";
+    readonly skillName: "smart-reply-agent";
+    readonly description: "招聘智能回复 Agent。根据候选人消息和上下文，向 Reply Authority Service 请求已签名回复。";
+    readonly requiredEnv: readonly ["REPLY_AUTHORITY_URL", "REPLY_AUTHORITY_BEARER_TOKEN"];
+}, {
+    readonly shortName: "reply-policy-tuner";
+    readonly packageName: "@roll-agent/reply-policy-tuner-agent";
+    readonly skillName: "reply-policy-tuner-agent";
+    readonly description: "策略 RSI 编排 Agent（Reply Policy Tuner）。评估、编排与更新招聘回复策略，update 带 evaluate 门禁，与 browser-use 协同使用。";
+    readonly requiredEnv: readonly ["REPLY_AUTHORITY_URL", "REPLY_AUTHORITY_BEARER_TOKEN"];
+}, {
+    readonly shortName: "octopus";
+    readonly packageName: "@roll-agent/octopus-agent";
+    readonly skillName: "octopus-agent";
+    readonly description: "丸子 Agent（Octopus）。把自然语言问题转换为只读 SQL，并通过 Sponge MCP Server 校验和执行。";
+    readonly requiredEnv: readonly ["SPONGE_MCP_BASE_URL", "SPONGE_MCP_ACCESS_TOKEN"];
+}];
+export type OfficialAgentShortName = (typeof OFFICIAL_AGENT_CATALOG)[number]["shortName"];
+export declare function getAgentCatalog(_config?: RollConfig): readonly AgentCatalogEntry[];
+export interface CatalogEntryMatch {
+    readonly entry: AgentCatalogEntry;
+    readonly versionSpec?: string;
+}
+export declare function findCatalogEntry(catalog: readonly AgentCatalogEntry[], input: string): CatalogEntryMatch | undefined;
+export declare function catalogPackageSpec(entry: AgentCatalogEntry, versionSpec?: string): string;

package/dist/registry/catalog.js

@@ -0,0 +1 @@
+import{parsePackageName as e}from"./source.js";export const OFFICIAL_AGENT_CATALOG=[{shortName:"browser-use",packageName:"@roll-agent/browser-use-agent",skillName:"browser-use-agent",description:"浏览器操控 Agent。控制浏览器操作招聘平台：读取消息、发送签名回复、筛选候选人，并提供通用 AX snapshot 与元素点击/输入能力。",requiredEnv:["REPLY_AUTHORITY_URL","REPLY_AUTHORITY_BEARER_TOKEN","REPLY_AUTHORITY_KEYS_URL","RECRUITMENT_EVENTS_DEFAULT_AGENT_ID","RECRUITMENT_EVENTS_API_TOKEN"]},{shortName:"smart-reply",packageName:"@roll-agent/smart-reply-agent",skillName:"smart-reply-agent",description:"招聘智能回复 Agent。根据候选人消息和上下文，向 Reply Authority Service 请求已签名回复。",requiredEnv:["REPLY_AUTHORITY_URL","REPLY_AUTHORITY_BEARER_TOKEN"]},{shortName:"reply-policy-tuner",packageName:"@roll-agent/reply-policy-tuner-agent",skillName:"reply-policy-tuner-agent",description:"策略 RSI 编排 Agent（Reply Policy Tuner）。评估、编排与更新招聘回复策略，update 带 evaluate 门禁，与 browser-use 协同使用。",requiredEnv:["REPLY_AUTHORITY_URL","REPLY_AUTHORITY_BEARER_TOKEN"]},{shortName:"octopus",packageName:"@roll-agent/octopus-agent",skillName:"octopus-agent",description:"丸子 Agent（Octopus）。把自然语言问题转换为只读 SQL，并通过 Sponge MCP Server 校验和执行。",requiredEnv:["SPONGE_MCP_BASE_URL","SPONGE_MCP_ACCESS_TOKEN"]}];export function getAgentCatalog(e){return OFFICIAL_AGENT_CATALOG}export function findCatalogEntry(t,r){const a=r.trim();if(0===a.length)return;const n=e(a),o=a.length>n.length?a.slice(n.length+1):void 0,l=o&&o.length>0?o:void 0,E=t.find(e=>e.shortName===n||e.packageName===n||e.skillName===n);return E?{entry:E,...l?{versionSpec:l}:{}}:void 0}export function catalogPackageSpec(e,t){return t?`${e.packageName}@${t}`:e.packageName}

package/dist/registry/discovery.js

@@ -1 +1 @@
-import{readFileSync as t,existsSync as r,realpathSync as n}from"node:fs";import{readJsonFile as e}from"./json-file.js";import{resolve as o,sep as i}from"node:path";import a from"gray-matter";import{z as s}from"zod";import{parse as p}from"yaml";import{createDefaultRuntimeForTransport as d}from"../types/agent.js";const l="SKILL.md",m="package.json",c=s.object({name:s.string().min(1),purpose:s.string().optional(),example:s.string().optional(),default:s.string().optional()}),u=s.object({required:s.array(c).optional(),optional:s.array(c).optional()});export function discoverAgent(n){const e=o(n),i=o(e,l);if(!r(i))throw new Error(`SKILL.md not found in ${e}`);const s=t(i,"utf-8"),{data:p,content:m}=a(s),c=b(e),u=p,f=u.name,h=u.description;if("string"!=typeof f||0===f.length)throw new Error(`SKILL.md missing required field "name" in ${i}`);if("string"!=typeof h||0===h.length)throw new Error(`SKILL.md missing required field "description" in ${i}`);const w=u.metadata??{},$={};for(const[t,r]of Object.entries(w))$[t]=String(r);const L="string"==typeof u.license?u.license:void 0,S="string"==typeof u.compatibility?u.compatibility:void 0,I=g(e,$,i),k={name:f,description:h,...L?{license:L}:{},...S?{compatibility:S}:{},metadata:$,...I?{env:I}:{}},q=c?v(c):void 0;if(q&&j($)){if(!E(y($),q.transport))throw new Error(`Conflicting runtime metadata in ${i}: package.json#rollAgent and SKILL.md metadata disagree`)}const A=q?.transport??y($);return{skill:k,transport:A,runtime:q?.runtime??d(A),skillPath:i,skillBody:m.trim()}}function f(t,r){if(void 0===t)return;const n=u.safeParse(t);if(!n.success){const t=n.error.issues.map(t=>`${t.path.length>0?`env.${t.path.join(".")}`:"env"}: ${t.message}`).join("; ");throw new Error(`SKILL.md has invalid "env" declaration in ${r}: ${t}`)}const e=n.data;return e.required||e.optional?{...e.required?{required:e.required.map(w)}:{},...e.optional?{optional:e.optional.map(w)}:{}}:void 0}function g(e,i,a){const s=i["roll-env-file"];if(!s)return;const d=o(e,s);if(!h(e,d))throw new Error(`SKILL.md roll-env-file must stay within agent directory: ${a}`);if(!r(d))throw new Error(`SKILL.md roll-env-file not found: ${d}`);const l=n(e),m=n(d);if(!h(l,m))throw new Error(`SKILL.md roll-env-file must stay within agent directory: ${a}`);let c;try{c=p(t(m,"utf-8"))}catch(t){throw new Error(`Failed to parse roll-env-file for ${a}: ${t instanceof Error?t.message:String(t)}`)}return f(c,m)}function h(t,r){return r===t||r.startsWith(`${t}${i}`)}function w(t){return{name:t.name,...t.purpose?{purpose:t.purpose}:{},...t.example?{example:t.example}:{},...t.default?{default:t.default}:{}}}function y(t){if("streamable-http"===("streamable-http"===t["roll-transport"]?"streamable-http":"stdio")){const r=t["roll-endpoint"];if(!r)throw new Error('SKILL.md declares streamable-http transport but missing "roll-endpoint"');return{type:"streamable-http",endpoint:r}}const r=(t["roll-command"]??"node --experimental-strip-types src/index.ts").split(/\s+/),n=r[0],e=r.slice(1);if(!n)throw new Error("Invalid roll-command in SKILL.md");return e.length>0?{type:"stdio",command:n,args:e}:{type:"stdio",command:n}}function b(t){const n=o(t,m);if(!r(n))return;let i;try{i=e(n)}catch{throw new Error(`Invalid package.json in ${t}`)}if(!k(i)||!k(i.rollAgent))return;const a=i.rollAgent,s=k(a.runtime)?a.runtime:void 0;if(!s)throw new Error(`package.json#rollAgent.runtime is required in ${n}`);const p={runtime:{ownership:S(s.ownership)??"",transport:S(s.transport)??""}};if(k(a.start)){const t=S(a.start.command),r=I(a.start.args);(t||r)&&(p.start={...t?{command:t}:{},...r?{args:r}:{}})}if(k(a.endpoint)){const t=S(a.endpoint.url),r=S(a.endpoint.path),n="number"==typeof a.endpoint.port?a.endpoint.port:void 0;(t||r||void 0!==n)&&(p.endpoint={...t?{url:t}:{},...r?{path:r}:{},...void 0!==n?{port:n}:{}})}if(k(a.setup)&&k(a.setup.playwright)){const t=I(a.setup.playwright.browsers);t&&t.length>0&&(p.setup={playwright:{browsers:t}})}return p}function v(t){const{ownership:r,transport:n}=t.runtime;if("on-demand"===r&&"stdio"===n){const r=t.start?.command;if(!r)throw new Error("package.json#rollAgent.start.command is required for stdio runtime");const n=t.start?.args;return{transport:n?{type:"stdio",command:r,args:n}:{type:"stdio",command:r},runtime:{ownership:"on-demand"}}}if("core-managed"===r&&"streamable-http"===n){const r=t.start?.command,n=$(t),e=t.endpoint?.path,o=t.endpoint?.port;if(!r||!e||void 0===o)throw new Error("package.json#rollAgent for core-managed streamable-http requires start.command, endpoint.path and endpoint.port");const i=t.start?.args,a=t.setup?.playwright?.browsers;return{transport:{type:"streamable-http",endpoint:n},runtime:{ownership:"core-managed",start:i?{command:r,args:i}:{command:r},endpoint:{path:e,port:o},...a&&a.length>0?{setup:{playwright:{browsers:a}}}:{}}}}if("external-managed"===r&&"streamable-http"===n)return{transport:{type:"streamable-http",endpoint:$(t)},runtime:{ownership:"external-managed"}};throw new Error(`Unsupported package.json#rollAgent runtime combination: ${r}/${n}`)}function $(t){const r=t.endpoint?.url;if(r)return r;const n=t.endpoint?.path,e=t.endpoint?.port;if(!n||void 0===e)throw new Error("package.json#rollAgent.streamable-http requires endpoint.url or endpoint.path + endpoint.port");return L(n,e)}function L(t,r){const n=t.startsWith("/")?t:`/${t}`;return`http://127.0.0.1:${String(r)}${n}`}function j(t){return"string"==typeof t["roll-transport"]||"string"==typeof t["roll-endpoint"]||"string"==typeof t["roll-command"]}function E(t,r){if(t.type!==r.type)return!1;if("streamable-http"===t.type&&"streamable-http"===r.type)return t.endpoint===r.endpoint;if("stdio"!==t.type||"stdio"!==r.type)return!1;const n=t.args??[],e=r.args??[];return t.command===r.command&&n.join("\0")===e.join("\0")}function S(t){return"string"==typeof t&&t.length>0?t:void 0}function I(t){if(!Array.isArray(t))return;const r=t.filter(t=>"string"==typeof t);return r.length>0?r:void 0}function k(t){return"object"==typeof t&&null!==t}
+import{readFileSync as t,existsSync as r,realpathSync as n}from"node:fs";import{readJsonFile as e}from"./json-file.js";import{resolve as o,sep as i}from"node:path";import a from"gray-matter";import{z as s}from"zod";import{parse as p}from"yaml";import{createDefaultRuntimeForTransport as l}from"../types/agent.js";const d="SKILL.md",m="package.json",c=s.object({name:s.string().min(1),purpose:s.string().optional(),example:s.string().optional(),default:s.string().optional()}),u=s.object({required:s.array(c).optional(),optional:s.array(c).optional()}),f=s.object({required:s.boolean().optional(),purpose:s.string().optional(),example:s.string().optional(),default:s.string().optional()}),h=s.object({env:s.record(f).optional()});export function discoverAgent(n){const e=o(n),i=o(e,d);if(!r(i))throw new Error(`SKILL.md not found in ${e}`);const s=t(i,"utf-8"),{data:p,content:m}=a(s),c=j(e),u=p,f=u.name,h=u.description;if("string"!=typeof f||0===f.length)throw new Error(`SKILL.md missing required field "name" in ${i}`);if("string"!=typeof h||0===h.length)throw new Error(`SKILL.md missing required field "description" in ${i}`);const g=u.metadata??{},w={};for(const[t,r]of Object.entries(g))w[t]=String(r);const v="string"==typeof u.license?u.license:void 0,b="string"==typeof u.compatibility?u.compatibility:void 0,$=y(e,w,i),S={name:f,description:h,...v?{license:v}:{},...b?{compatibility:b}:{},metadata:w,...$?{env:$}:{}},I=c?E(c):void 0;if(I&&q(w)){if(!x(L(w),I.transport))throw new Error(`Conflicting runtime metadata in ${i}: package.json#rollAgent and SKILL.md metadata disagree`)}const K=I?.transport??L(w);return{skill:S,transport:K,runtime:I?.runtime??l(K),skillPath:i,skillBody:m.trim()}}function g(t,r){if(void 0===t)return;if(A(t)&&"env"in t)return w(t,r);const n=u.safeParse(t);if(!n.success){const t=n.error.issues.map(t=>`${t.path.length>0?`env.${t.path.join(".")}`:"env"}: ${t.message}`).join("; ");throw new Error(`SKILL.md has invalid "env" declaration in ${r}: ${t}`)}const e=n.data;return e.required||e.optional?{...e.required?{required:e.required.map(b)}:{},...e.optional?{optional:e.optional.map(b)}:{}}:void 0}function w(t,r){const n=h.safeParse(t);if(!n.success){const t=n.error.issues.map(t=>`${t.path.length>0?t.path.join("."):"env"}: ${t.message}`).join("; ");throw new Error(`SKILL.md has invalid "env" declaration in ${r}: ${t}`)}const e=n.data.env;if(!e)return;const o=[],i=[];for(const[t,n]of Object.entries(e)){if(0===t.length)throw new Error(`SKILL.md has invalid "env" declaration in ${r}: env key is empty`);const e=$(t,n);!0===n.required?o.push(e):i.push(e)}return 0!==o.length||0!==i.length?{...o.length>0?{required:o}:{},...i.length>0?{optional:i}:{}}:void 0}function y(e,i,a){const s=i["roll-env-file"];if(!s)return;const l=o(e,s);if(!v(e,l))throw new Error(`SKILL.md roll-env-file must stay within agent directory: ${a}`);if(!r(l))throw new Error(`SKILL.md roll-env-file not found: ${l}`);const d=n(e),m=n(l);if(!v(d,m))throw new Error(`SKILL.md roll-env-file must stay within agent directory: ${a}`);let c;try{c=p(t(m,"utf-8"))}catch(t){throw new Error(`Failed to parse roll-env-file for ${a}: ${t instanceof Error?t.message:String(t)}`)}return g(c,m)}function v(t,r){return r===t||r.startsWith(`${t}${i}`)}function b(t){return{name:t.name,...t.purpose?{purpose:t.purpose}:{},...t.example?{example:t.example}:{},...t.default?{default:t.default}:{}}}function $(t,r){return{name:t,...r.purpose?{purpose:r.purpose}:{},...r.example?{example:r.example}:{},...r.default?{default:r.default}:{}}}function L(t){if("streamable-http"===("streamable-http"===t["roll-transport"]?"streamable-http":"stdio")){const r=t["roll-endpoint"];if(!r)throw new Error('SKILL.md declares streamable-http transport but missing "roll-endpoint"');return{type:"streamable-http",endpoint:r}}const r=(t["roll-command"]??"node --experimental-strip-types src/index.ts").split(/\s+/),n=r[0],e=r.slice(1);if(!n)throw new Error("Invalid roll-command in SKILL.md");return e.length>0?{type:"stdio",command:n,args:e}:{type:"stdio",command:n}}function j(t){const n=o(t,m);if(!r(n))return;let i;try{i=e(n)}catch{throw new Error(`Invalid package.json in ${t}`)}if(!A(i)||!A(i.rollAgent))return;const a=i.rollAgent,s=A(a.runtime)?a.runtime:void 0;if(!s)throw new Error(`package.json#rollAgent.runtime is required in ${n}`);const p={runtime:{ownership:K(s.ownership)??"",transport:K(s.transport)??""}};if(A(a.start)){const t=K(a.start.command),r=k(a.start.args);(t||r)&&(p.start={...t?{command:t}:{},...r?{args:r}:{}})}if(A(a.endpoint)){const t=K(a.endpoint.url),r=K(a.endpoint.path),n="number"==typeof a.endpoint.port?a.endpoint.port:void 0;(t||r||void 0!==n)&&(p.endpoint={...t?{url:t}:{},...r?{path:r}:{},...void 0!==n?{port:n}:{}})}if(A(a.setup)&&A(a.setup.playwright)){const t=k(a.setup.playwright.browsers);t&&t.length>0&&(p.setup={playwright:{browsers:t}})}return p}function E(t){const{ownership:r,transport:n}=t.runtime;if("on-demand"===r&&"stdio"===n){const r=t.start?.command;if(!r)throw new Error("package.json#rollAgent.start.command is required for stdio runtime");const n=t.start?.args;return{transport:n?{type:"stdio",command:r,args:n}:{type:"stdio",command:r},runtime:{ownership:"on-demand"}}}if("core-managed"===r&&"streamable-http"===n){const r=t.start?.command,n=S(t),e=t.endpoint?.path,o=t.endpoint?.port;if(!r||!e||void 0===o)throw new Error("package.json#rollAgent for core-managed streamable-http requires start.command, endpoint.path and endpoint.port");const i=t.start?.args,a=t.setup?.playwright?.browsers;return{transport:{type:"streamable-http",endpoint:n},runtime:{ownership:"core-managed",start:i?{command:r,args:i}:{command:r},endpoint:{path:e,port:o},...a&&a.length>0?{setup:{playwright:{browsers:a}}}:{}}}}if("external-managed"===r&&"streamable-http"===n)return{transport:{type:"streamable-http",endpoint:S(t)},runtime:{ownership:"external-managed"}};throw new Error(`Unsupported package.json#rollAgent runtime combination: ${r}/${n}`)}function S(t){const r=t.endpoint?.url;if(r)return r;const n=t.endpoint?.path,e=t.endpoint?.port;if(!n||void 0===e)throw new Error("package.json#rollAgent.streamable-http requires endpoint.url or endpoint.path + endpoint.port");return I(n,e)}function I(t,r){const n=t.startsWith("/")?t:`/${t}`;return`http://127.0.0.1:${String(r)}${n}`}function q(t){return"string"==typeof t["roll-transport"]||"string"==typeof t["roll-endpoint"]||"string"==typeof t["roll-command"]}function x(t,r){if(t.type!==r.type)return!1;if("streamable-http"===t.type&&"streamable-http"===r.type)return t.endpoint===r.endpoint;if("stdio"!==t.type||"stdio"!==r.type)return!1;const n=t.args??[],e=r.args??[];return t.command===r.command&&n.join("\0")===e.join("\0")}function K(t){return"string"==typeof t&&t.length>0?t:void 0}function k(t){if(!Array.isArray(t))return;const r=t.filter(t=>"string"==typeof t);return r.length>0?r:void 0}function A(t){return"object"==typeof t&&null!==t}