@geotechcli/core 0.4.20 → 0.4.22

package/dist/agents/runtime-fallbacks.js

@@ -0,0 +1,87 @@
+import { buildGeotechnicalFallbackAnswer, buildGeotechnicalPreflightAnswer, } from './intake.js';
+export function isHostedBetaUnavailable(message) {
+    const normalized = message.toLowerCase();
+    return (normalized.includes('provider is busy') ||
+        normalized.includes('rate limit') ||
+        normalized.includes('timed out') ||
+        normalized.includes('upstream request failed') ||
+        normalized.includes('retry in about') ||
+        normalized.includes('hosted beta ai request failed') ||
+        normalized.includes('hosted beta upstream returned no content') ||
+        normalized.includes('empty completion') ||
+        normalized.includes('fetch failed'));
+}
+export function getHostedFallbackMode(message) {
+    const normalized = message.toLowerCase();
+    if (normalized.includes('timed out') ||
+        normalized.includes('timeout budget') ||
+        normalized.includes('warming up') ||
+        normalized.includes('modal.com gpu')) {
+        return 'warming_timeout';
+    }
+    return 'temporary';
+}
+function extractNumericValue(query, pattern) {
+    const match = query.match(pattern);
+    return match ? Number(match[1]) : null;
+}
+export function buildDeterministicPreflightAnswer(userQuery, config, sessionContext) {
+    return buildGeotechnicalPreflightAnswer(userQuery, config, sessionContext);
+}
+export function buildDeterministicFallbackAnswer(userQuery, sessionContext, mode = 'temporary') {
+    const normalized = userQuery.toLowerCase();
+    const fallbackLead = mode === 'warming_timeout'
+        ? 'Hosted model on Modal.com GPU is warming up or exceeded the current timeout budget, so the agent switched to deterministic fallback reasoning instead of returning no analysis.'
+        : 'Hosted beta was temporarily unavailable, so the agent switched to deterministic fallback reasoning instead of returning no analysis.';
+    const intakeFallback = buildGeotechnicalFallbackAnswer(userQuery, sessionContext);
+    if (intakeFallback) {
+        return intakeFallback;
+    }
+    if (/(tbm|epb|slurry|shield|tunnel boring)/.test(normalized)) {
+        const rpm = extractNumericValue(normalized, /(\d+(?:\.\d+)?)\s*rpm/);
+        const thrust = extractNumericValue(normalized, /(\d+(?:\.\d+)?)\s*k\s*n/);
+        const diameter = extractNumericValue(normalized, /(\d+(?:\.\d+)?)\s*m\s*(?:diameter|tbm|tunnel)/) ??
+            extractNumericValue(normalized, /(\d+(?:\.\d+)?)\s*m\b/);
+        const hasSoftGround = /(clay|silt|sand|soft ground|soft soil)/.test(normalized);
+        const hasRockInputs = /(ucs|rqd|cai|joint spacing|jointspacing)/.test(normalized);
+        const lines = [
+            fallbackLead,
+            '',
+            'Engineering assessment:',
+        ];
+        if (hasSoftGround || normalized.includes('epb')) {
+            lines.push('- The ground description points to soft-ground tunnelling, so EPB remains the appropriate screening-level machine class.');
+        }
+        if (rpm != null) {
+            lines.push(`- Provided cutterhead speed: ${rpm} rpm.`);
+        }
+        if (thrust != null) {
+            lines.push(`- Provided thrust: ${thrust} kN.`);
+        }
+        lines.push('');
+        lines.push('Deterministic limitation:');
+        if (diameter == null) {
+            lines.push('- Tunnel / TBM diameter is not provided, which is required for any defensible advance-rate estimate.');
+        }
+        if (hasSoftGround && !hasRockInputs) {
+            lines.push('- The current built-in TBM performance engine in geotechCLI is a rock disc-cutter model requiring diameter, UCS, and RQD-type inputs. It does not yet include a validated EPB-in-clay penetration model.');
+        }
+        else if (!hasRockInputs) {
+            lines.push('- The current built-in TBM performance engine needs rock-mechanics inputs such as UCS and RQD before it can calculate penetration rate.');
+        }
+        lines.push('- RPM and thrust alone are not sufficient for a validated penetration-rate calculation in soft ground without diameter plus material/operational parameters.');
+        lines.push('');
+        lines.push('Next best deterministic path in geotechCLI:');
+        lines.push('- Use `geotech tunnel tbm-select --diameter <m> --ground soft_ground` for a machine-class recommendation.');
+        lines.push('- Use `geotech tunnel tbm-predict --diameter <m> --ucs <MPa> --rqd <percent> ...` only for the existing rock-TBM predictor.');
+        lines.push('- If you want EPB soft-ground penetration screening in-clay, that needs a new validated deterministic model to be added to the toolset.');
+        return lines.join('\n');
+    }
+    return [
+        mode === 'warming_timeout'
+            ? 'Hosted model on Modal.com GPU is warming up or exceeded the current timeout budget, and this request does not currently have a direct deterministic fallback in geotechCLI.'
+            : 'Hosted beta was temporarily unavailable, and this request does not currently have a direct deterministic fallback in geotechCLI.',
+        'Retry shortly, or reformulate the task as one of the built-in deterministic commands so the CLI can continue without the hosted model.',
+    ].join('\n\n');
+}
+//# sourceMappingURL=runtime-fallbacks.js.map

package/dist/agents/runtime-fallbacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-fallbacks.js","sourceRoot":"","sources":["../../src/agents/runtime-fallbacks.ts"],"names":[],"mappings":"AACA,OAAO,EACL,+BAA+B,EAC/B,gCAAgC,GACjC,MAAM,aAAa,CAAC;AAIrB,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,CACL,UAAU,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACvC,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC;QACjC,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC;QAChC,UAAU,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAC9C,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACrC,UAAU,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QACpD,UAAU,CAAC,QAAQ,CAAC,0CAA0C,CAAC;QAC/D,UAAU,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACvC,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,CACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACzC,IACE,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC;QAChC,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QACrC,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC;QACjC,UAAU,CAAC,QAAQ,CAAC,eAAe,CAAC,EACpC,CAAC;QACD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa,EAAE,OAAe;IACzD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,SAAiB,EACjB,MAAiB,EACjB,cAAwC;IAExC,OAAO,gCAAgC,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,SAAiB,EACjB,cAAwC,EACxC,OAA2B,WAAW;IAEtC,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,YAAY,GAChB,IAAI,KAAK,iBAAiB;QACxB,CAAC,CAAC,iLAAiL;QACnL,CAAC,CAAC,sIAAsI,CAAC;IAE7I,MAAM,cAAc,GAAG,+BAA+B,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAClF,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,IAAI,uCAAuC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7D,MAAM,GAAG,GAAG,mBAAmB,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,mBAAmB,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;QAC1E,MAAM,QAAQ,GACZ,mBAAmB,CAAC,UAAU,EAAE,+CAA+C,CAAC;YAChF,mBAAmB,CAAC,UAAU,EAAE,uBAAuB,CAAC,CAAC;QAC3D,MAAM,aAAa,GAAG,wCAAwC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChF,MAAM,aAAa,GAAG,0CAA0C,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAElF,MAAM,KAAK,GAAG;YACZ,YAAY;YACZ,EAAE;YACF,yBAAyB;SAC1B,CAAC;QAEF,IAAI,aAAa,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,KAAK,CAAC,IAAI,CAAC,0HAA0H,CAAC,CAAC;QACzI,CAAC;QACD,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,gCAAgC,GAAG,OAAO,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,sBAAsB,MAAM,MAAM,CAAC,CAAC;QACjD,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAExC,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,sGAAsG,CAAC,CAAC;QACrH,CAAC;QACD,IAAI,aAAa,IAAI,CAAC,aAAa,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC,0MAA0M,CAAC,CAAC;QACzN,CAAC;aAAM,IAAI,CAAC,aAAa,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,yIAAyI,CAAC,CAAC;QACxJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,8JAA8J,CAAC,CAAC;QAC3K,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,2GAA2G,CAAC,CAAC;QACxH,KAAK,CAAC,IAAI,CAAC,6HAA6H,CAAC,CAAC;QAC1I,KAAK,CAAC,IAAI,CAAC,yIAAyI,CAAC,CAAC;QAEtJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO;QACL,IAAI,KAAK,iBAAiB;YACxB,CAAC,CAAC,6KAA6K;YAC/K,CAAC,CAAC,kIAAkI;QACtI,wIAAwI;KACzI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC"}

package/dist/agents/sandbox.d.ts

@@ -3,32 +3,13 @@ export interface SandboxCheck {
     resolved: string;
     error?: string;
 }
+export declare function validateEnumerationPath(targetPath: string, extraAllowed?: string[]): SandboxCheck;
 export declare function ensureWorkspace(): string;
 export declare function getWorkspaceDir(): string;
-/**
- * Validate that a path is inside an allowed zone and does not target
- * sensitive files. Call this BEFORE any read/write/list operation.
- *
- * Allowed zones:
- *   - process.cwd() and its children
- *   - WORKSPACE_DIR and its children
- *   - Any additional directories passed in `extraAllowed`
- *
- * For WRITE operations, pass mode='write' to additionally block
- * the config directory itself (only workspace subdir is writable).
- */
 export declare function validatePath(targetPath: string, mode?: 'read' | 'write', extraAllowed?: string[]): SandboxCheck;
-/**
- * Convenience: validate for reading.
- */
 export declare function validateReadPath(targetPath: string, extraAllowed?: string[]): SandboxCheck;
-/**
- * Convenience: validate for writing.
- */
 export declare function validateWritePath(targetPath: string, extraAllowed?: string[]): SandboxCheck;
-/**
- * Validate a shell command for safety.
- * Returns the sanitized command or an error.
- */
-export declare function validateShellCommand(command: string): SandboxCheck;
+export declare function validateShellCommand(command: string, options?: {
+    cwd?: string;
+}): SandboxCheck;
 //# sourceMappingURL=sandbox.d.ts.map

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;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"}
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/agents/sandbox.ts"],"names":[],"mappings":"AAgFA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgGD,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,YAAY,CAejG;AAMD,wBAAgB,eAAe,IAAI,MAAM,CAKxC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAMD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,MAAM,GAAG,OAAgB,EAC/B,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,YAAY,CAiHd;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,YAAY,CAE1F;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,YAAY,CAE3F;AAMD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,YAAY,CAiW9F"}