@orion-agents/orion-code 0.1.2 → 0.1.4-2

package/dist/runtime/subagents/tool.js

@@ -16,6 +16,7 @@ exports.createSubtaskTool = createSubtaskTool;
 exports.summarizeBatchForModel = summarizeBatchForModel;
 const tool_1 = require("../../framework/tool");
 const supervisor_1 = require("./supervisor");
+const research_contract_1 = require("./research-contract");
 const ROLE_VALUES = ['research', 'review', 'test-investigate'];
 const SUBTASK_PARAMETERS = {
     type: 'object',
@@ -26,9 +27,19 @@ const SUBTASK_PARAMETERS = {
             items: {
                 type: 'object',
                 properties: {
-                    role: { type: 'string', enum: ['research', 'review', 'test-investigate'], description: 'Investigation role.' },
-                    objective: { type: 'string', description: 'A bounded, independently-investigable question. Must be specific enough to produce a verifiable conclusion.' },
-                    reason: { type: 'string', description: 'Why this is independently delegable and not a serial dependency.' },
+                    role: {
+                        type: 'string',
+                        enum: ['research', 'review', 'test-investigate'],
+                        description: 'Investigation role.',
+                    },
+                    objective: {
+                        type: 'string',
+                        description: 'A bounded, independently-investigable question. Must be specific enough to produce a verifiable conclusion.',
+                    },
+                    reason: {
+                        type: 'string',
+                        description: 'Why this is independently delegable and not a serial dependency.',
+                    },
                     scope: {
                         type: 'object',
                         properties: {
@@ -38,11 +49,28 @@ const SUBTASK_PARAMETERS = {
                     },
                     contextHints: { type: 'array', items: { type: 'string' } },
                     expectedOutput: { type: 'string' },
+                    research: {
+                        type: 'object',
+                        description: 'Research-only capability. Defaults to local. web/mixed requires parent network approval.',
+                        properties: {
+                            mode: { type: 'string', enum: ['local', 'web', 'mixed'] },
+                            domains: { type: 'array', items: { type: 'string' } },
+                            freshness: { type: 'string', enum: ['any', 'recent', 'as_of'] },
+                            asOf: { type: 'string' },
+                            maxSources: { type: 'number' },
+                            maxFetchBytes: { type: 'number' },
+                            maxDurationMs: { type: 'number' },
+                        },
+                    },
                 },
                 required: ['role', 'objective', 'reason'],
             },
         },
-        execution: { type: 'string', enum: ['parallel', 'serial'], description: 'parallel (default) or serial.' },
+        execution: {
+            type: 'string',
+            enum: ['parallel', 'serial'],
+            description: 'parallel (default) or serial.',
+        },
     },
     required: ['tasks'],
 };
@@ -52,6 +80,60 @@ const SUBTASK_DESCRIPTION = [
     'Do NOT use for: single-file reads, simple greps, serial step-by-step work, or anything requiring edits/commands (children cannot edit or run commands).',
     'Each child returns a JSON result with summary, findings (with evidence), files, suggested commands (not executed), verification steps, and risks.',
 ].join(' ');
+function coerceResearchCapability(value, role) {
+    if (value === undefined)
+        return undefined;
+    if (role !== 'research' || !value || typeof value !== 'object' || Array.isArray(value)) {
+        return null;
+    }
+    const raw = value;
+    const capability = {};
+    if (raw.mode !== undefined) {
+        if (raw.mode !== 'local' && raw.mode !== 'web' && raw.mode !== 'mixed')
+            return null;
+        capability.mode = raw.mode;
+    }
+    if (raw.domains !== undefined) {
+        if (!Array.isArray(raw.domains) || raw.domains.some(domain => typeof domain !== 'string')) {
+            return null;
+        }
+        const domains = raw.domains.map(domain => domain.trim()).filter(Boolean);
+        if (domains.length !== raw.domains.length)
+            return null;
+        capability.domains = domains;
+    }
+    if (raw.freshness !== undefined) {
+        if (raw.freshness !== 'any' && raw.freshness !== 'recent' && raw.freshness !== 'as_of') {
+            return null;
+        }
+        capability.freshness = raw.freshness;
+    }
+    if (raw.asOf !== undefined) {
+        if (typeof raw.asOf !== 'string' || !raw.asOf.trim())
+            return null;
+        capability.asOf = raw.asOf.trim();
+    }
+    const budgets = [
+        ['maxSources', research_contract_1.RESEARCH_HARD_LIMITS.maxSources],
+        ['maxFetchBytes', research_contract_1.RESEARCH_HARD_LIMITS.maxFetchBytes],
+        ['maxDurationMs', research_contract_1.RESEARCH_HARD_LIMITS.maxDurationMs],
+    ];
+    for (const [name, limits] of budgets) {
+        const rawValue = raw[name];
+        if (rawValue === undefined)
+            continue;
+        if (typeof rawValue !== 'number' ||
+            !Number.isSafeInteger(rawValue) ||
+            rawValue < limits.min ||
+            rawValue > limits.max) {
+            return null;
+        }
+        capability[name] = rawValue;
+    }
+    if (capability.freshness === 'as_of' && !capability.asOf)
+        return null;
+    return capability;
+}
 /** Coerce model-provided args into a validated SubtaskRequest. */
 function coerceSubtaskRequest(args) {
     const tasksRaw = args.tasks;
@@ -72,8 +154,12 @@ function coerceSubtaskRequest(args) {
         const packet = { role: role, objective, reason };
         if (obj.scope && typeof obj.scope === 'object') {
             const scope = obj.scope;
-            const paths = Array.isArray(scope.paths) ? scope.paths.filter((p) => typeof p === 'string') : undefined;
-            const symbols = Array.isArray(scope.symbols) ? scope.symbols.filter((s) => typeof s === 'string') : undefined;
+            const paths = Array.isArray(scope.paths)
+                ? scope.paths.filter((p) => typeof p === 'string')
+                : undefined;
+            const symbols = Array.isArray(scope.symbols)
+                ? scope.symbols.filter((s) => typeof s === 'string')
+                : undefined;
             if (paths || symbols)
                 packet.scope = { paths, symbols };
         }
@@ -82,6 +168,11 @@ function coerceSubtaskRequest(args) {
         }
         if (typeof obj.expectedOutput === 'string')
             packet.expectedOutput = obj.expectedOutput;
+        const research = coerceResearchCapability(obj.research, packet.role);
+        if (research === null)
+            return null;
+        if (research !== undefined)
+            packet.research = research;
         // Drop any caller-provided `id`: runtime generates authoritative ids.
         tasks.push(packet);
     }
@@ -100,7 +191,27 @@ function createSubtaskTool(supervisorDeps) {
         isReadOnly: () => true,
         isConcurrencySafe: () => false,
         isDestructive: () => false,
-        checkPermissions: () => ({ behavior: 'allow', reason: 'subtask is read-only orchestration; policy gate authorizes each child' }),
+        isFileEdit: () => false,
+        checkPermissions: args => {
+            const request = coerceSubtaskRequest(args);
+            if (!request) {
+                return {
+                    behavior: 'allow',
+                    reason: 'invalid subtask contract cannot execute or reach an external capability',
+                };
+            }
+            const external = request.tasks.some(task => task.role === 'research' &&
+                (task.research?.mode === 'web' || task.research?.mode === 'mixed'));
+            return external
+                ? {
+                    behavior: 'ask',
+                    reason: 'Research requests external WebSearch/WebFetch access; child MCP and write tools remain denied.',
+                }
+                : {
+                    behavior: 'allow',
+                    reason: 'local subtask is read-only orchestration; policy gate authorizes each child',
+                };
+        },
         async execute(args, context) {
             const request = coerceSubtaskRequest(args);
             if (!request) {
@@ -128,7 +239,12 @@ function createSubtaskTool(supervisorDeps) {
                     // partial data by serializing a safe subset.
                     serialized = JSON.stringify({
                         batchId: batch.batchId,
-                        results: batch.results.map(r => ({ ...r, findings: [], commands: [], verification: [] })),
+                        results: batch.results.map(r => ({
+                            ...r,
+                            findings: [],
+                            commands: [],
+                            verification: [],
+                        })),
                         aggregateUsage: batch.aggregateUsage,
                         _serializationError: String(jsonErr instanceof Error ? jsonErr.message : jsonErr),
                     });
@@ -137,7 +253,11 @@ function createSubtaskTool(supervisorDeps) {
                     success: !outcome.rejected,
                     output: serialized,
                     summary: compact,
-                    metadata: { batchId: batch.batchId, rejected: outcome.rejected, rejectReason: outcome.rejectReason },
+                    metadata: {
+                        batchId: batch.batchId,
+                        rejected: outcome.rejected,
+                        rejectReason: outcome.rejectReason,
+                    },
                 };
             }
             catch (err) {

package/dist/runtime/subagents/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../src/runtime/subagents/tool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../src/runtime/subagents/tool.ts"],"names":[],"mappings":"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"}

package/dist/runtime/subagents/types.d.ts

@@ -77,6 +77,24 @@ export interface SubtaskScope {
     /** Symbols / identifiers the child should focus on. */
     symbols?: string[];
 }
+/**
+ * Root-owned research capability requested for a research subtask.
+ *
+ * The default is local-only. `web` and `mixed` are declarative requests: they
+ * do not grant network access by themselves. The parent `subtask` permission
+ * gate must approve the call before the Supervisor may invoke the dedicated
+ * WebSearch/WebFetch adapter.
+ */
+export interface SubtaskResearchCapability {
+    mode?: import('./research-types').ResearchMode;
+    /** Narrower domain policy for external sources. */
+    domains?: string[];
+    freshness?: 'any' | 'recent' | 'as_of';
+    asOf?: string;
+    maxSources?: number;
+    maxFetchBytes?: number;
+    maxDurationMs?: number;
+}
 export interface SubtaskPacket {
     /** Caller-proposed id. Runtime generates the authoritative id and ignores this. */
     id?: string;
@@ -90,6 +108,8 @@ export interface SubtaskPacket {
     contextHints?: string[];
     /** What a good result looks like. */
     expectedOutput?: string;
+    /** Additive research contract. Valid only when `role` is `research`. */
+    research?: SubtaskResearchCapability;
 }
 export interface SubtaskRequest {
     tasks: SubtaskPacket[];

package/dist/runtime/subagents/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8EAA8E;AAC9E,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,QAAQ,GAAG,kBAAkB,CAAC;AAEtE,4EAA4E;AAC5E,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,CAAC;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAC3B,QAAQ,GACR,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,GACX,WAAW,GACX,UAAU,CAAC;AAEf,MAAM,WAAW,cAAc;IAC7B,8GAA8G;IAC9G,IAAI,EAAE,YAAY,CAAC;IACnB,kEAAkE;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,eAAe,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,uBAAuB,EAAE,MAAM,CAAC;IAChC,yEAAyE;IACzE,uBAAuB,EAAE,MAAM,CAAC;IAChC,qDAAqD;IACrD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,eAAO,MAAM,uBAAuB,EAAE,cAUrC,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQlB,CAAC;AAEX,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,OAAO,kBAAkB,EAAE,YAAY,CAAC;IAC/C,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,mFAAmF;IACnF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,YAAY,CAAC;IACnB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,yBAAyB,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,4DAA4D;IAC5D,SAAS,EAAE,UAAU,GAAG,QAAQ,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,mBAAmB,EAAE,YAOjC,CAAC;AAEF,6FAA6F;AAC7F,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY;CAKjD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,QAAQ,EAAE,KAAK,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;AAElG,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,cAAc,EAAE,YAAY,CAAC;CAC9B;AAED,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,YAAY,CAgBpE"}

package/dist/runtime/subagents/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/runtime/subagents/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AA+KH,0CAgBC;AAnJY,QAAA,uBAAuB,GAAmB;IACrD,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,CAAC;IACd,eAAe,EAAE,CAAC;IAClB,eAAe,EAAE,CAAC;IAClB,uBAAuB,EAAE,CAAC;IAC1B,uBAAuB,EAAE,EAAE;IAC3B,mBAAmB,EAAE,EAAE;IACvB,SAAS,EAAE,MAAO;IAClB,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,kBAAkB,CAAC;CAClD,CAAC;AAEF,iEAAiE;AACpD,QAAA,eAAe,GAAG;IAC7B,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;IAC/B,eAAe,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;IACnC,eAAe,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACpC,uBAAuB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IAC5C,uBAAuB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IAC5C,mBAAmB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACxC,SAAS,EAAE,EAAE,GAAG,EAAE,IAAK,EAAE,GAAG,EAAE,MAAO,EAAE;CAC/B,CAAC;AA0CE,QAAA,mBAAmB,GAAiB;IAC/C,aAAa,EAAE,CAAC;IAChB,SAAS,EAAE,CAAC;IACZ,YAAY,EAAE,CAAC;IACf,gBAAgB,EAAE,CAAC;IACnB,UAAU,EAAE,CAAC;IACb,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF,6FAA6F;AAC7F,MAAa,qBAAsB,SAAQ,KAAK;IAG9C,YAAY,OAAe,EAAE,KAAmB;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAClD,CAAC;CACF;AARD,sDAQC;AAkDD,SAAgB,eAAe,CAAC,MAAsB;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAC7B,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,aAAa,EAAE,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa;QAClD,SAAS,EAAE,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS;QACtC,YAAY,EAAE,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY;QAC/C,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB;QAC3D,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;QACzC,aAAa,EAAE,GAAG,CAAC,aAAa,KAAK,IAAI,IAAI,CAAC,CAAC,aAAa,KAAK,IAAI;KACtE,CAAC,EACF,EAAE,GAAG,2BAAmB,EAAE,CAC3B,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,EAAE,CAAC;QAC5E,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/runtime/subagents/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAoMH,0CAgBC;AAxKY,QAAA,uBAAuB,GAAmB;IACrD,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,CAAC;IACd,eAAe,EAAE,CAAC;IAClB,eAAe,EAAE,CAAC;IAClB,uBAAuB,EAAE,CAAC;IAC1B,uBAAuB,EAAE,EAAE;IAC3B,mBAAmB,EAAE,EAAE;IACvB,SAAS,EAAE,MAAO;IAClB,KAAK,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,kBAAkB,CAAC;CAClD,CAAC;AAEF,iEAAiE;AACpD,QAAA,eAAe,GAAG;IAC7B,WAAW,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;IAC/B,eAAe,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;IACnC,eAAe,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACpC,uBAAuB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IAC5C,uBAAuB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IAC5C,mBAAmB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACxC,SAAS,EAAE,EAAE,GAAG,EAAE,IAAK,EAAE,GAAG,EAAE,MAAO,EAAE;CAC/B,CAAC;AA+DE,QAAA,mBAAmB,GAAiB;IAC/C,aAAa,EAAE,CAAC;IAChB,SAAS,EAAE,CAAC;IACZ,YAAY,EAAE,CAAC;IACf,gBAAgB,EAAE,CAAC;IACnB,UAAU,EAAE,CAAC;IACb,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF,6FAA6F;AAC7F,MAAa,qBAAsB,SAAQ,KAAK;IAG9C,YAAY,OAAe,EAAE,KAAmB;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAClD,CAAC;CACF;AARD,sDAQC;AAkDD,SAAgB,eAAe,CAAC,MAAsB;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAC7B,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,aAAa,EAAE,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa;QAClD,SAAS,EAAE,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS;QACtC,YAAY,EAAE,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY;QAC/C,gBAAgB,EAAE,GAAG,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB;QAC3D,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;QACzC,aAAa,EAAE,GAAG,CAAC,aAAa,KAAK,IAAI,IAAI,CAAC,CAAC,aAAa,KAAK,IAAI;KACtE,CAAC,EACF,EAAE,GAAG,2BAAmB,EAAE,CAC3B,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,EAAE,CAAC;QAC5E,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/runtime/subagents/web-research-adapter.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Web research adapter (v0.1.4, P0-R2).
+ *
+ * Normalizes the read-only web tooling into the Research schema. It does NOT
+ * re-implement SSRF / DNS / redirect / body / abort guards - it reuses the
+ * lexical guard from `src/tools/web` for selection-time pre-checks and delegates
+ * the full per-hop guard (DNS rebinding, redirect chains, Content-Length,
+ * abort) to whatever `fetch` dependency the caller injects (the default is the
+ * real `webFetchTool`, which already enforces all of it).
+ *
+ * Hard rules (from the plan):
+ *  - Only specialized WebSearch / WebFetch capability; no generic MCP.
+ *  - Provider fallback changes the *provider* only - it never drops a source's
+ *    status or writes a failure as a success.
+ *  - A security gate failure yields a `blocked` / `failed` source with a
+ *    structured `failureReason`. It never throws and never masquerades as a hit.
+ *  - The adapter is pure with respect to deps, so the whole search -> select ->
+ *    fetch -> hash pipeline is testable without network.
+ */
+import type { ResearchRequest, ResearchSource } from './research-types';
+/** Normalized search hit as produced by an injected search dependency. */
+export interface RawSearchResult {
+    query: string;
+    /** Provider that returned this hit (e.g. 'websearch-mcp', 'tavily', 'ddg'). */
+    provider: string;
+    title: string;
+    url: string;
+    snippet?: string;
+    /**
+     * Status of the *search* step for this hit. A blocked/error hit is recorded as
+     * a blocked/failed source and is never fetched.
+     */
+    status: 'ok' | 'blocked' | 'error';
+    failureReason?: string;
+}
+/** Normalized fetch outcome as produced by an injected fetch dependency. */
+export interface RawFetchResult {
+    url: string;
+    status: 'ok' | 'blocked' | 'error';
+    /** Retrieved content (already converted to markdown by the real web tool). */
+    content?: string;
+    /** URL after redirects - use this as canonicalUrl so citations are stable. */
+    finalUrl?: string;
+    /** Bytes of the raw body (used for the per-packet byte budget). */
+    bytes?: number;
+    redirects?: string[];
+    failureReason?: string;
+}
+export interface WebResearchDeps {
+    /** Search provider chain. May perform internal provider fallback. */
+    search: (query: string, limit: number, signal?: AbortSignal) => Promise<RawSearchResult[]>;
+    /** Fetch a single URL. Default wraps the real WebFetch tool (full guard set). */
+    fetch: (url: string, prompt?: string, signal?: AbortSignal) => Promise<RawFetchResult>;
+    /** Selection-time domain allowlist; when set, only matching hosts pass. */
+    allowedDomains?: string[];
+    /** Overridable clock for deterministic tests. */
+    now?: () => Date;
+}
+export interface WebResearchResult {
+    /** Sources actually collected (retrieved / partial / failed / blocked). */
+    sources: ResearchSource[];
+    /** URLs that passed selection but were skipped due to budget/timeout. Redacted. */
+    skipped: string[];
+    /** URLs rejected by the security / domain gate. Redacted. */
+    blocked: string[];
+    /** Provider recorded for the (last) successful search. */
+    provider: string | null;
+    bytesFetched: number;
+    durationMs: number;
+    truncatedDueToBytes: boolean;
+    timedOut: boolean;
+    /** Parent turn cancellation, distinct from the adapter's own deadline. */
+    aborted: boolean;
+    notes: string[];
+}
+/**
+ * Run a controlled web research pass for a `web`/`mixed` request.
+ *
+ * Pipeline: validate mode -> search -> select (SSRF + domain gate, capped at
+ * maxSources) -> fetch (byte budget + overall duration budget) -> emit sources.
+ * Security-gate failures become `blocked`/`failed` sources; they never throw
+ * and never become `retrieved`.
+ */
+export declare function runWebResearch(request: ResearchRequest, deps: WebResearchDeps, parentAbortSignal?: AbortSignal): Promise<WebResearchResult>;
+//# sourceMappingURL=web-research-adapter.d.ts.map

package/dist/runtime/subagents/web-research-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-research-adapter.d.ts","sourceRoot":"","sources":["../../../src/runtime/subagents/web-research-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAgB,MAAM,kBAAkB,CAAC;AAEtF,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC;IACnC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC3F,iFAAiF;IACjF,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IACvF,2EAA2E;IAC3E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,mFAAmF;IACnF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAoDD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,eAAe,EACxB,IAAI,EAAE,eAAe,EACrB,iBAAiB,CAAC,EAAE,WAAW,GAC9B,OAAO,CAAC,iBAAiB,CAAC,CA0O5B"}