@geotechcli/core 0.2.0 → 0.4.0

package/dist/agents/evidence.js

@@ -0,0 +1,302 @@
+import { randomUUID } from 'node:crypto';
+import { saveNamedDataset, loadProject } from '../storage/index.js';
+import { ensureScenarioCaseFile, loadLatestScenarioArtifacts, saveScenarioCaseFile, } from './case-file.js';
+const EVIDENCE_KIND = 'scenario-evidence';
+function nowIso() {
+    return new Date().toISOString();
+}
+function evidenceDatasetName(scenarioId, evidenceId) {
+    return `scenario-evidence:${scenarioId}:${evidenceId}`;
+}
+function normalizeKeyPart(value) {
+    return value.trim().toLowerCase();
+}
+function evidenceKey(classValue, label, source) {
+    return `${normalizeKeyPart(classValue)}|${normalizeKeyPart(label)}|${normalizeKeyPart(source)}`;
+}
+function uniqueStrings(values) {
+    return [...new Set(values.filter(Boolean))];
+}
+function isEvidenceReference(value) {
+    return Boolean(value)
+        && typeof value === 'object'
+        && 'evidenceId' in value
+        && 'class' in value
+        && 'label' in value
+        && 'source' in value;
+}
+function collectNestedEvidenceRefs(value) {
+    if (!value || typeof value !== 'object') {
+        return [];
+    }
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => collectNestedEvidenceRefs(item));
+    }
+    const record = value;
+    const ownRefs = Array.isArray(record.evidenceRefs)
+        ? record.evidenceRefs.filter((item) => isEvidenceReference(item))
+        : [];
+    return [
+        ...ownRefs,
+        ...Object.values(record).flatMap((item) => collectNestedEvidenceRefs(item)),
+    ];
+}
+function uniqueEvidenceRefs(refs) {
+    const seen = new Set();
+    const output = [];
+    for (const ref of refs) {
+        const key = `${ref.evidenceId}|${ref.class}|${ref.label}|${ref.source}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        output.push(ref);
+    }
+    return output;
+}
+function toEvidenceRef(record) {
+    return {
+        evidenceId: record.evidenceId,
+        class: record.class,
+        label: record.label,
+        source: record.source,
+        ...(record.summary ? { summary: record.summary } : {}),
+    };
+}
+function artifactDatasetName(scenarioId, artifactType, version) {
+    return `scenario-artifact:${scenarioId}:${artifactType}:v${version}`;
+}
+export function loadEvidenceRecord(projectId, scenarioId, evidenceId) {
+    const project = loadProject(projectId);
+    const direct = project.namedDatasets[evidenceDatasetName(scenarioId, evidenceId)]?.data;
+    if (direct && typeof direct === 'object') {
+        return direct;
+    }
+    const prefix = `scenario-evidence:${scenarioId}:`;
+    for (const [name, dataset] of Object.entries(project.namedDatasets)) {
+        if (!name.startsWith(prefix))
+            continue;
+        const data = dataset.data;
+        if (data && typeof data === 'object' && data.evidenceId === evidenceId) {
+            return data;
+        }
+    }
+    return null;
+}
+export function listEvidenceRecords(projectId, scenarioId) {
+    const project = loadProject(projectId);
+    const prefix = `scenario-evidence:${scenarioId}:`;
+    return Object.entries(project.namedDatasets)
+        .filter(([name]) => name.startsWith(prefix))
+        .map(([, dataset]) => dataset.data)
+        .filter((value) => Boolean(value) && typeof value === 'object')
+        .sort((left, right) => (left.class.localeCompare(right.class)
+        || left.label.localeCompare(right.label)
+        || left.source.localeCompare(right.source)));
+}
+function saveEvidenceDataset(projectId, scenarioId, record, source = 'evidence') {
+    const datasetName = evidenceDatasetName(scenarioId, record.evidenceId);
+    saveNamedDataset(projectId, {
+        name: datasetName,
+        kind: EVIDENCE_KIND,
+        data: record,
+        source,
+    });
+    return datasetName;
+}
+export function persistEvidenceRecord(options) {
+    const caseFile = ensureScenarioCaseFile(options.projectId, options.scenarioId, options.scenarioId);
+    const key = evidenceKey(options.class, options.label, options.source);
+    const existingDatasetName = caseFile.evidenceIndex[key];
+    if (existingDatasetName) {
+        const project = loadProject(options.projectId);
+        const existing = project.namedDatasets[existingDatasetName]?.data;
+        if (existing && typeof existing === 'object') {
+            const merged = {
+                ...existing,
+                summary: existing.summary ?? options.summary,
+                detail: existing.detail ?? options.detail,
+                tags: uniqueStrings([
+                    ...(existing.tags ?? []),
+                    ...(options.tags ?? []),
+                ]),
+                linkedArtifactIds: uniqueStrings([
+                    ...(existing.linkedArtifactIds ?? []),
+                    ...(options.linkedArtifactIds ?? []),
+                ]),
+                metadata: {
+                    ...(existing.metadata ?? {}),
+                    ...(options.metadata ?? {}),
+                },
+            };
+            saveEvidenceDataset(options.projectId, options.scenarioId, merged, options.provenanceSource.agent);
+            return merged;
+        }
+    }
+    const record = {
+        evidenceId: options.evidenceId ?? randomUUID(),
+        projectId: options.projectId,
+        scenarioId: options.scenarioId,
+        class: options.class,
+        label: options.label,
+        source: options.source,
+        summary: options.summary,
+        detail: options.detail,
+        tags: uniqueStrings(options.tags ?? []),
+        linkedArtifactIds: uniqueStrings(options.linkedArtifactIds ?? []),
+        provenance: {
+            createdAt: nowIso(),
+            derivedFrom: [...(options.linkedArtifactIds ?? [])],
+            source: options.provenanceSource,
+        },
+        metadata: options.metadata,
+    };
+    const datasetName = saveEvidenceDataset(options.projectId, options.scenarioId, record, options.provenanceSource.agent);
+    saveScenarioCaseFile(options.projectId, options.scenarioId, {
+        ...caseFile,
+        evidenceDatasetRefs: uniqueStrings([...(caseFile.evidenceDatasetRefs ?? []), datasetName]),
+        evidenceIndex: {
+            ...(caseFile.evidenceIndex ?? {}),
+            [key]: datasetName,
+        },
+    }, options.provenanceSource.agent);
+    return record;
+}
+function inferFromGroundModel(payload, artifact) {
+    const output = [];
+    if (payload.summary) {
+        output.push({
+            class: 'Derived',
+            label: 'Ground model summary',
+            source: 'artifact:ground-model',
+            summary: payload.summary,
+            tags: ['ground-model'],
+            linkedArtifactIds: [artifact.artifactId],
+            metadata: { artifactType: artifact.artifactType, version: artifact.version },
+        });
+    }
+    for (const stratum of payload.strata ?? []) {
+        output.push({
+            class: 'Derived',
+            label: `Stratum ${stratum.fromM}m-${stratum.toM}m: ${stratum.material}`,
+            source: 'artifact:ground-model',
+            summary: stratum.description ?? stratum.material,
+            detail: stratum.uscsSymbol ? `USCS: ${stratum.uscsSymbol}` : undefined,
+            tags: ['ground-model', 'stratum'],
+            linkedArtifactIds: [artifact.artifactId],
+            metadata: {
+                fromM: stratum.fromM,
+                toM: stratum.toM,
+                material: stratum.material,
+                uscsSymbol: stratum.uscsSymbol,
+            },
+        });
+    }
+    return output;
+}
+function inferFromAssumptions(payload, artifact) {
+    return (payload.assumptions ?? []).map((assumption) => ({
+        class: 'Assumed',
+        label: assumption.statement,
+        source: 'artifact:assumptions',
+        summary: assumption.basis,
+        detail: `Impact: ${assumption.impact}`,
+        tags: ['assumption', assumption.category],
+        linkedArtifactIds: [artifact.artifactId],
+        metadata: {
+            category: assumption.category,
+            impact: assumption.impact,
+        },
+    }));
+}
+function inferFromResults(payload, artifact) {
+    return (payload.records ?? []).map((record) => ({
+        class: 'Computed',
+        label: record.label,
+        source: `artifact:${record.toolName || 'results'}`,
+        summary: record.interpretation,
+        detail: record.metrics.length > 0
+            ? record.metrics
+                .map((metric) => `${metric.name}: ${metric.value}${metric.units ? ` ${metric.units}` : ''}`)
+                .join('; ')
+            : undefined,
+        tags: ['results', record.toolName],
+        linkedArtifactIds: [artifact.artifactId],
+        metadata: {
+            toolName: record.toolName,
+            method: record.method,
+            metricCount: record.metrics.length,
+        },
+    }));
+}
+function inferArtifactEvidence(artifact) {
+    switch (artifact.artifactType) {
+        case 'ground-model':
+            return inferFromGroundModel(artifact.payload, artifact);
+        case 'assumptions':
+            return inferFromAssumptions(artifact.payload, artifact);
+        case 'results':
+            return inferFromResults(artifact.payload, artifact);
+        default:
+            return [];
+    }
+}
+function persistArtifactEvidenceRefs(projectId, scenarioId, artifact, refs) {
+    const mergedArtifact = {
+        ...artifact,
+        evidenceRefs: uniqueEvidenceRefs([...(artifact.evidenceRefs ?? []), ...refs]),
+    };
+    saveNamedDataset(projectId, {
+        name: artifactDatasetName(scenarioId, artifact.artifactType, artifact.version),
+        kind: 'scenario-artifact',
+        data: mergedArtifact,
+        source: mergedArtifact.provenance.source.agent,
+    });
+}
+export function persistArtifactEvidence(projectId, scenarioId, artifact) {
+    const explicitRefs = uniqueEvidenceRefs([
+        ...(artifact.evidenceRefs ?? []),
+        ...collectNestedEvidenceRefs(artifact.payload),
+    ]);
+    const persisted = explicitRefs.map((reference) => persistEvidenceRecord({
+        projectId,
+        scenarioId,
+        evidenceId: reference.evidenceId,
+        class: reference.class,
+        label: reference.label,
+        source: reference.source,
+        summary: reference.summary,
+        linkedArtifactIds: [artifact.artifactId],
+        provenanceSource: artifact.provenance.source,
+        metadata: { artifactType: artifact.artifactType, version: artifact.version, explicit: true },
+    }));
+    for (const inferred of inferArtifactEvidence(artifact)) {
+        persisted.push(persistEvidenceRecord({
+            projectId,
+            scenarioId,
+            provenanceSource: artifact.provenance.source,
+            ...inferred,
+        }));
+    }
+    const refs = uniqueEvidenceRefs(persisted.map(toEvidenceRef));
+    if (refs.length > 0) {
+        persistArtifactEvidenceRefs(projectId, scenarioId, artifact, refs);
+    }
+    return persisted;
+}
+export function persistCaseFileEvidence(projectId, scenarioId) {
+    const artifacts = loadLatestScenarioArtifacts(projectId, scenarioId);
+    const persisted = [];
+    for (const artifact of Object.values(artifacts)) {
+        if (!artifact)
+            continue;
+        persisted.push(...persistArtifactEvidence(projectId, scenarioId, artifact));
+    }
+    const byId = new Map();
+    for (const record of persisted) {
+        byId.set(record.evidenceId, record);
+    }
+    return [...byId.values()].sort((left, right) => (left.class.localeCompare(right.class)
+        || left.label.localeCompare(right.label)
+        || left.source.localeCompare(right.source)));
+}
+//# sourceMappingURL=evidence.js.map

package/dist/agents/evidence.js.map

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

package/dist/agents/orchestrator.js

@@ -31,19 +31,19 @@ const AGENTS = [
         systemPrompt: `You are a specialist foundation engineer. You design shallow and deep foundations, analyze pile capacity (static and dynamic), evaluate group effects, design pile caps, and perform serviceability checks. Reference API RP 2GEO, FHWA, and relevant building codes.`,
     },
 ];
-const ORCHESTRATOR_SYSTEM = `You are the geotechCLI Orchestrator. You decompose complex geotechnical engineering tasks into sub-tasks for specialized agents.
-
-Available agents:
-${AGENTS.map((a) => `- ${a.tag}: ${a.name}`).join('\n')}
-
-Instructions:
-1. Analyze the user's task and determine which agent(s) to call.
-2. To call an agent, output EXACTLY this JSON block:
-\`\`\`json
-{"action":"call_agent","agent":"@geo-agent","query":"your specific question"}
-\`\`\`
-3. Call one agent at a time. Wait for results before proceeding.
-4. After gathering all needed information, write a final comprehensive engineering report in markdown. Do NOT include any JSON block in the final report.
+const ORCHESTRATOR_SYSTEM = `You are the geotechCLI Orchestrator. You decompose complex geotechnical engineering tasks into sub-tasks for specialized agents.
+
+Available agents:
+${AGENTS.map((a) => `- ${a.tag}: ${a.name}`).join('\n')}
+
+Instructions:
+1. Analyze the user's task and determine which agent(s) to call.
+2. To call an agent, output EXACTLY this JSON block:
+\`\`\`json
+{"action":"call_agent","agent":"@geo-agent","query":"your specific question"}
+\`\`\`
+3. Call one agent at a time. Wait for results before proceeding.
+4. After gathering all needed information, write a final comprehensive engineering report in markdown. Do NOT include any JSON block in the final report.
 5. Always include numerical results, applicable standards, and recommendations.`;
 export async function runMultiAgentTask(task, config, onLog, maxIterations = 6) {
     onLog({

package/dist/agents/sandbox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/agents/sandbox.ts"],"names":[],"mappings":"AAsEA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAMD,wBAAgB,eAAe,IAAI,MAAM,CAKxC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,MAAM,GAAG,OAAgB,EAC/B,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,YAAY,CAqFd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,YAAY,CAE1F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,YAAY,CAE3F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CA4DlE"}
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/agents/sandbox.ts"],"names":[],"mappings":"AAsEA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA6BD,wBAAgB,eAAe,IAAI,MAAM,CAKxC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,MAAM,GAAG,OAAgB,EAC/B,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,YAAY,CAkGd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,YAAY,CAE1F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,YAAY,CAE3F;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAkFlE"}

package/dist/agents/sandbox.js

@@ -11,7 +11,7 @@
 //   - Paths outside allowed zones (even via symlink resolution)
 //   - /etc, /var, /usr, /proc, /sys, /dev system directories
 // ---------------------------------------------------------------------------
-import { resolve, sep } from 'node:path';
+import { dirname, resolve, sep } from 'node:path';
 import { homedir } from 'node:os';
 import { existsSync, mkdirSync, realpathSync } from 'node:fs';
 // ---------------------------------------------------------------------------
@@ -58,6 +58,24 @@ const BLOCKED_SYSTEM_PREFIXES = [
     'C:\\Windows',
     'C:\\Program Files',
 ];
+function normalizeForPrefixCheck(value) {
+    return value.replace(/\\/g, '/').toLowerCase();
+}
+function isWithinAllowedZones(targetPath, allowedZones) {
+    return allowedZones.some((zone) => targetPath.startsWith(zone + sep) || targetPath === zone);
+}
+function findNearestExistingParent(targetPath) {
+    let current = dirname(targetPath);
+    let previous = '';
+    while (current !== previous) {
+        if (existsSync(current)) {
+            return current;
+        }
+        previous = current;
+        current = dirname(current);
+    }
+    return existsSync(current) ? current : null;
+}
 // ---------------------------------------------------------------------------
 // Ensure workspace exists
 // ---------------------------------------------------------------------------
@@ -87,7 +105,6 @@ export function getWorkspaceDir() {
  */
 export function validatePath(targetPath, mode = 'read', extraAllowed) {
     const resolved = resolve(targetPath);
-    const normalizeForPrefixCheck = (value) => value.replace(/\\/g, '/').toLowerCase();
     const normalizedInput = normalizeForPrefixCheck(targetPath);
     const normalizedResolved = normalizeForPrefixCheck(resolved);
     // --- 1. Block system directories ---
@@ -132,9 +149,7 @@ export function validatePath(targetPath, mode = 'read', extraAllowed) {
     ].map((z) => resolve(z));
     // For read: allow CWD, workspace, and extra
     // For write: allow CWD and workspace only
-    const isInAllowedZone = allowedZones.some((zone) => {
-        return resolved.startsWith(zone + sep) || resolved === zone;
-    });
+    const isInAllowedZone = isWithinAllowedZones(resolved, allowedZones);
     if (!isInAllowedZone) {
         return {
             safe: false,
@@ -146,7 +161,7 @@ export function validatePath(targetPath, mode = 'read', extraAllowed) {
     if (existsSync(resolved)) {
         try {
             const realPath = realpathSync(resolved);
-            const realInAllowed = allowedZones.some((zone) => realPath.startsWith(zone + sep) || realPath === zone);
+            const realInAllowed = isWithinAllowedZones(realPath, allowedZones);
             if (!realInAllowed) {
                 return {
                     safe: false,
@@ -159,6 +174,24 @@ export function validatePath(targetPath, mode = 'read', extraAllowed) {
             // Can't resolve symlink — proceed with caution (file may not exist yet for writes)
         }
     }
+    if (mode === 'write' && !existsSync(resolved)) {
+        const nearestExistingParent = findNearestExistingParent(resolved);
+        if (nearestExistingParent) {
+            try {
+                const realParent = realpathSync(nearestExistingParent);
+                if (!isWithinAllowedZones(realParent, allowedZones)) {
+                    return {
+                        safe: false,
+                        resolved,
+                        error: `Access denied: parent symlink resolves to "${realParent}" which is outside allowed directories.`,
+                    };
+                }
+            }
+            catch {
+                // Keep the earlier prefix and zone checks if parent realpath cannot be resolved.
+            }
+        }
+    }
     return { safe: true, resolved };
 }
 /**
@@ -179,40 +212,20 @@ export function validateWritePath(targetPath, extraAllowed) {
  */
 export function validateShellCommand(command) {
     const trimmed = command.trim();
-    const firstWord = trimmed.split(/\s+/)[0];
+    const parts = trimmed.split(/\s+/);
+    const firstWord = parts[0];
     // Allowed read-only commands
     const allowedCommands = ['ls', 'cat', 'head', 'tail', 'wc', 'find', 'grep', 'file', 'stat', 'du', 'pwd', 'echo'];
-    // Python: only with .py file, no -c/-m flags
-    if (firstWord === 'python' || firstWord === 'python3') {
-        const parts = trimmed.split(/\s+/);
-        const dangerousFlags = ['-c', '-m', '--command', '-W', '-X'];
-        const hasDangerousFlag = parts.some((p) => dangerousFlags.includes(p));
-        const hasScriptFile = parts.some((p) => p.endsWith('.py'));
-        if (hasDangerousFlag) {
-            return {
-                safe: false,
-                resolved: trimmed,
-                error: `Python flag "${parts.find((p) => dangerousFlags.includes(p))}" is blocked. Only "python script.py" is allowed.`,
-            };
-        }
-        if (!hasScriptFile) {
-            return {
-                safe: false,
-                resolved: trimmed,
-                error: 'Python must be invoked with a .py script file. Interactive/inline execution is blocked.',
-            };
-        }
-    }
-    else if (!allowedCommands.includes(firstWord)) {
+    if (!allowedCommands.includes(firstWord)) {
         return {
             safe: false,
             resolved: trimmed,
-            error: `Command "${firstWord}" not allowed. Permitted: ${allowedCommands.join(', ')}, python <script.py>`,
+            error: `Command "${firstWord}" not allowed. Permitted: ${allowedCommands.join(', ')}`,
         };
     }
     // Block dangerous operators in any command
     const blockedOperators = [
-        '>', '>>', '|', '&&', '||', ';', '$(', '`',
+        '<', '>', '>>', '|', '&&', '||', ';', '$(', '`',
         'sudo', 'chmod', 'chown', 'chgrp',
         'rm ', 'rm\t', 'rmdir',
         'mv ', 'mv\t',
@@ -230,6 +243,46 @@ export function validateShellCommand(command) {
             };
         }
     }
+    if (firstWord === 'find') {
+        const blockedFindPredicates = ['-exec', '-execdir', '-ok', '-delete'];
+        for (const token of parts.slice(1)) {
+            if (blockedFindPredicates.some((predicate) => token === predicate || token.startsWith(predicate))) {
+                return {
+                    safe: false,
+                    resolved: trimmed,
+                    error: `Command contains blocked find predicate "${token}". Command execution and destructive find operations are not allowed.`,
+                };
+            }
+        }
+    }
+    const nonOptionTokens = parts.slice(1).filter((token) => !token.startsWith('-'));
+    const validatePathToken = (token) => {
+        if (/^\d+$/.test(token)) {
+            return null;
+        }
+        const pathCheck = validateReadPath(token);
+        return pathCheck.safe ? null : pathCheck;
+    };
+    let pathTokens = [];
+    if (['ls', 'cat', 'head', 'tail', 'wc', 'file', 'stat', 'du'].includes(firstWord)) {
+        pathTokens = nonOptionTokens;
+    }
+    else if (firstWord === 'grep') {
+        pathTokens = nonOptionTokens.slice(1);
+    }
+    else if (firstWord === 'find' && nonOptionTokens.length > 0) {
+        pathTokens = [nonOptionTokens[0]];
+    }
+    for (const token of pathTokens) {
+        const pathCheck = validatePathToken(token);
+        if (pathCheck && !pathCheck.safe) {
+            return {
+                safe: false,
+                resolved: trimmed,
+                error: `Command path "${token}" is not allowed. ${pathCheck.error}`,
+            };
+        }
+    }
     return { safe: true, resolved: trimmed };
 }
 //# sourceMappingURL=sandbox.js.map

package/dist/agents/sandbox.js.map

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

package/dist/agents/swarm.d.ts

@@ -21,5 +21,7 @@ export interface SwarmSession {
     corrections: string[];
 }
 export type SwarmCallback = (step: SwarmStep) => void;
+export declare function getAllowedToolsForAgent(agent: SwarmStep['agent']): readonly string[];
+export declare function isToolAllowedForAgent(agent: SwarmStep['agent'], toolName: string): boolean;
 export declare function runSwarm(task: string, config: LLMConfig, onStep: SwarmCallback, sessionContext?: Record<string, unknown>): Promise<SwarmSession>;
 //# sourceMappingURL=swarm.d.ts.map

package/dist/agents/swarm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../src/agents/swarm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAsB,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAK3D,OAAO,uBAAuB,CAAC;AAC/B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,iBAAiB,CAAC;AAEzB,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,cAAc,GAAG,gBAAgB,GAAG,YAAY,GAAG,UAAU,CAAC;IACrE,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzG,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;AAiUtD,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,EACrB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,OAAO,CAAC,YAAY,CAAC,CA+KvB"}
+{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../src/agents/swarm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAsB,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAK3D,OAAO,uBAAuB,CAAC;AAC/B,OAAO,mBAAmB,CAAC;AAC3B,OAAO,iBAAiB,CAAC;AAEzB,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,cAAc,GAAG,gBAAgB,GAAG,YAAY,GAAG,UAAU,CAAC;IACrE,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;IACzG,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;AA+CtD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,SAAS,MAAM,EAAE,CAEpF;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1F;AAoSD,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,aAAa,EACrB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,OAAO,CAAC,YAAY,CAAC,CA+KvB"}