rea-agents 4.0.1 → 5.0.0

package/dist/domain/errors.js

@@ -1,324 +0,0 @@
-import { hopperStartupFailure, } from "./hopperStartupFailure.js";
-export { hopperStartupFailure, };
-export { projectAnalysisError } from "./analysisErrorProjection.js";
-/** Stable tags exposed by safe analysis-error projections. */
-const ANALYSIS_ERROR_TAGS = [
-    "AnalysisProtocolError",
-    "AnalysisInputError",
-    "AnalysisOutputError",
-    "AnalysisCapabilityUnavailableError",
-    "AnalysisCancelledError",
-    "AnalysisTimeoutError",
-    "ProviderSelectionError",
-    "ProviderAdapterError",
-    "BrowserObservationError",
-    "ArtifactOperationError",
-    "ProcessCaptureError",
-    "EvidenceIntegrityError",
-    "EvidenceFileError",
-    "UnknownRegistryError",
-    "HopperTimeoutError",
-    "HopperCancelledError",
-    "HopperProtocolError",
-    "HopperRemoteError",
-    "HopperProcessError",
-    "HopperStartError",
-    "ConfigurationError",
-    "NoBinaryOpenError",
-    "BinaryTargetError",
-];
-/** Base class for expected analysis, provider, and session failures. */
-export class AnalysisError extends Error {
-    userMessage = undefined;
-    userCategory = undefined;
-    cleanupIncomplete = false;
-    cleanupResources = [];
-}
-/** Base class for failures produced specifically by the Hopper provider. */
-export class HopperError extends AnalysisError {
-}
-/** Provider-neutral invalid analysis input or output at an application boundary. */
-export class AnalysisProtocolError extends AnalysisError {
-    _tag = "AnalysisProtocolError";
-}
-/** Caller input failed provider-neutral application parsing. */
-export class AnalysisInputError extends AnalysisError {
-    operation;
-    issues;
-    _tag = "AnalysisInputError";
-    constructor(operation, options, issues = []) {
-        super(`Invalid analysis input for ${operation}`, options);
-        this.operation = operation;
-        this.issues = issues;
-    }
-}
-/** Provider output failed provider-neutral application parsing. */
-export class AnalysisOutputError extends AnalysisError {
-    operation;
-    reason;
-    _tag = "AnalysisOutputError";
-    constructor(operation, reason, options) {
-        super(`Invalid analysis output for ${operation}: ${reason}`, options);
-        this.operation = operation;
-        this.reason = reason;
-    }
-}
-/** Selected provider cannot execute a declared analysis operation. */
-export class AnalysisCapabilityUnavailableError extends AnalysisError {
-    providerId;
-    operation;
-    reason;
-    _tag = "AnalysisCapabilityUnavailableError";
-    constructor(providerId, operation, reason) {
-        super(`Provider ${providerId} cannot execute ${operation}: ${reason}`);
-        this.providerId = providerId;
-        this.operation = operation;
-        this.reason = reason;
-    }
-}
-/** Caller cancellation won before provider-neutral work completed. */
-export class AnalysisCancelledError extends AnalysisError {
-    operation;
-    _tag = "AnalysisCancelledError";
-    constructor(operation) {
-        super(`Analysis operation was cancelled: ${operation}`);
-        this.operation = operation;
-    }
-}
-/** Provider-neutral operation exceeded its declared execution deadline. */
-export class AnalysisTimeoutError extends AnalysisError {
-    operation;
-    timeoutMs;
-    _tag = "AnalysisTimeoutError";
-    constructor(operation, timeoutMs) {
-        super(`Analysis operation timed out after ${String(timeoutMs)}ms: ${operation}`);
-        this.operation = operation;
-        this.timeoutMs = timeoutMs;
-    }
-}
-/** No configured provider can satisfy a requested operation or target binding. */
-export class ProviderSelectionError extends AnalysisError {
-    _tag = "ProviderSelectionError";
-    operation;
-    reason;
-    requestedProviderId;
-    candidateIds;
-    rejections;
-    userMessage;
-    constructor(options) {
-        const operation = options.operation ?? "open_binary";
-        super(providerSelectionDiagnostic(options));
-        this.operation = operation;
-        this.reason = options.reason;
-        this.requestedProviderId = options.requestedProviderId;
-        this.candidateIds = [...options.candidateIds];
-        this.rejections = [...(options.rejections ?? [])].map((rejection) => ({
-            ...rejection,
-            diagnostics: structuredClone(rejection.diagnostics),
-        }));
-        this.userMessage = providerSelectionUserMessage(options);
-    }
-}
-const providerSelectionDiagnostic = (options) => {
-    const candidates = options.candidateIds.length === 0
-        ? "none"
-        : options.candidateIds.join(", ");
-    return `Analysis provider selection failed (${options.reason}) for ${options.requestedProviderId}; candidates: ${candidates}`;
-};
-const providerSelectionUserMessage = (options) => {
-    switch (options.reason) {
-        case "ambiguous":
-            return "Multiple analysis providers support this target. Choose one with provider_id, --provider, or REA_ANALYSIS_PROVIDER.";
-        case "unknown_provider":
-            return `The requested analysis provider is unknown. Choose one of: ${options.candidateIds.join(", ") || "no configured providers"}.`;
-        case "provider_unavailable":
-            return "The selected analysis provider is unavailable. Review the reported local diagnostics or run `rea doctor`, then retry.";
-        case "target_unsupported":
-            return "The selected analysis provider does not support this target. Choose another provider or open a supported extracted binary.";
-        case "invalid_options":
-            return "The analysis provider selection or open options are invalid. Correct them and try again.";
-    }
-};
-/** A provider adapter failed outside its more precise typed variants. */
-export class ProviderAdapterError extends AnalysisError {
-    providerId;
-    operation;
-    _tag = "ProviderAdapterError";
-    diagnostics;
-    constructor(providerId, operation, options = {}) {
-        super(`Provider ${providerId} adapter failed during ${operation}`, options);
-        this.providerId = providerId;
-        this.operation = operation;
-        this.diagnostics =
-            options.diagnostics === undefined
-                ? undefined
-                : structuredClone(options.diagnostics);
-    }
-}
-/** A bounded passive browser observation failed at its CDP boundary. */
-export class BrowserObservationError extends AnalysisError {
-    operation;
-    reason;
-    _tag = "BrowserObservationError";
-    cleanupIncomplete;
-    cleanupResources;
-    userCategory;
-    constructor(operation, reason, options) {
-        super(`Browser observation ${operation} failed: ${reason}`, options);
-        this.operation = operation;
-        this.reason = reason;
-        this.cleanupIncomplete = reason === "cleanup_failed";
-        this.cleanupResources =
-            reason === "cleanup_failed" ? ["browser_transport"] : [];
-        this.userCategory =
-            reason === "cancelled" || options?.cause instanceof AnalysisCancelledError
-                ? "cancelled"
-                : undefined;
-    }
-}
-/** Artifact inventory or extraction failed a typed safety boundary. */
-export class ArtifactOperationError extends AnalysisError {
-    operation;
-    reason;
-    artifactDetails;
-    _tag = "ArtifactOperationError";
-    constructor(operation, reason, artifactDetails) {
-        super(artifactDetails === undefined
-            ? `Artifact ${operation} failed: ${reason}`
-            : `Artifact ${operation} failed: ${reason} at ${artifactDetails.logicalPath} (declared_sha256=${artifactDetails.declaredSha256 ?? "unavailable"}, calculated_sha256=${artifactDetails.calculatedSha256 ?? "unavailable"}, unpacked=${String(artifactDetails.unpacked)})`);
-        this.operation = operation;
-        this.reason = reason;
-        this.artifactDetails = artifactDetails;
-    }
-}
-/** Evidence identity, schema, or bundle manifests failed integrity checks. */
-export class EvidenceIntegrityError extends AnalysisError {
-    _tag = "EvidenceIntegrityError";
-}
-/** A session Evidence reference is missing or has the wrong semantic identity. */
-export class EvidenceReferenceError extends EvidenceIntegrityError {
-    evidenceId;
-    reason;
-    expected;
-    actual;
-    constructor(evidenceId, reason, expected, actual) {
-        super(`Evidence reference ${reason}: ${evidenceId}`);
-        this.evidenceId = evidenceId;
-        this.reason = reason;
-        this.expected = expected;
-        this.actual = actual;
-    }
-}
-/** Evidence bundle filesystem access failed within the configured policy. */
-export class EvidenceFileError extends AnalysisError {
-    operation;
-    reason;
-    _tag = "EvidenceFileError";
-    constructor(operation, reason, options) {
-        super(`Evidence bundle ${operation} failed: ${reason}`, options);
-        this.operation = operation;
-        this.reason = reason;
-    }
-}
-/** Residual-unknown mutation failed a lifecycle, reference, or CAS invariant. */
-export class UnknownRegistryError extends AnalysisError {
-    reason;
-    _tag = "UnknownRegistryError";
-    constructor(reason, options) {
-        super(`Residual unknown registry mutation failed: ${reason}`, options);
-        this.reason = reason;
-    }
-}
-/** Hopper did not respond within the configured operation deadline. */
-export class HopperTimeoutError extends HopperError {
-    timeoutMs;
-    operation;
-    requestId;
-    providerState;
-    _tag = "HopperTimeoutError";
-    constructor(timeoutMs, operation, requestId, providerState = "not_started") {
-        super(`Hopper ${operation === undefined ? "startup" : operation} timed out after ${String(timeoutMs)}ms`);
-        this.timeoutMs = timeoutMs;
-        this.operation = operation;
-        this.requestId = requestId;
-        this.providerState = providerState;
-    }
-}
-/** The caller cancelled a Hopper operation before it completed. */
-export class HopperCancelledError extends HopperError {
-    _tag = "HopperCancelledError";
-    constructor() {
-        super("Hopper operation was cancelled");
-    }
-}
-/** Hopper returned bytes or JSON that do not satisfy the NDJSON RPC contract. */
-export class HopperProtocolError extends HopperError {
-    _tag = "HopperProtocolError";
-}
-export class HopperRemoteError extends HopperError {
-    code;
-    safeMessage;
-    _tag = "HopperRemoteError";
-    diagnosticType;
-    operation;
-    requestId;
-    constructor(code, safeMessage, context = {}) {
-        super(`Hopper request failed (${String(code)}): ${safeMessage}`);
-        this.code = code;
-        this.safeMessage = safeMessage;
-        this.diagnosticType = context.diagnosticType ?? "remote";
-        this.operation = context.operation;
-        this.requestId = context.requestId;
-    }
-}
-/** The owned Hopper bridge stopped before its client was closed. */
-export class HopperProcessError extends HopperError {
-    exitCode;
-    diagnostic;
-    operation;
-    requestId;
-    _tag = "HopperProcessError";
-    failureCode;
-    userMessage;
-    constructor(exitCode, diagnostic, operation, requestId) {
-        super(`Hopper bridge stopped unexpectedly with code ${String(exitCode)}`);
-        this.exitCode = exitCode;
-        this.diagnostic = diagnostic;
-        this.operation = operation;
-        this.requestId = requestId;
-        const failure = hopperStartupFailure(exitCode);
-        this.failureCode = failure?.code;
-        this.userMessage = failure?.message;
-    }
-}
-/** Hopper or the repository bridge could not be started. */
-export class HopperStartError extends HopperError {
-    _tag = "HopperStartError";
-    userMessage;
-    ownerRunId;
-    constructor(options) {
-        super("Hopper application bridge could not be started", options);
-        this.userMessage = options?.userMessage;
-        this.ownerRunId = options?.ownerRunId;
-    }
-}
-/** Runtime configuration could not be parsed safely. */
-export class ConfigurationError extends AnalysisError {
-    _tag = "ConfigurationError";
-}
-/** No app or binary session exists for an analysis request. */
-export class NoBinaryOpenError extends AnalysisError {
-    _tag = "NoBinaryOpenError";
-    constructor() {
-        super("No app is open. Ask the user which app to investigate, then call open_binary with its local path.");
-    }
-}
-/** A supplied target path could not be safely opened as a supported app or binary. */
-export class BinaryTargetError extends AnalysisError {
-    path;
-    _tag = "BinaryTargetError";
-    constructor(path, reason, options) {
-        super(`Cannot open artifact: ${reason}`, options);
-        this.path = path;
-    }
-}

package/dist/domain/javascriptAstValues.js

@@ -1,13 +0,0 @@
-import * as t from "@babel/types";
-/** Read an identifier or literal property name without evaluating syntax. */
-export const propertyName = (node) => {
-    if (t.isIdentifier(node))
-        return node.name;
-    if (t.isStringLiteral(node) || t.isNumericLiteral(node))
-        return String(node.value);
-    return "";
-};
-/** Read a property name only when its syntax commits to one exact key. */
-export const semanticStaticPropertyName = (property, computed) => computed && !t.isStringLiteral(property) && !t.isNumericLiteral(property)
-    ? ""
-    : propertyName(property);

package/dist/domain/javascriptSemanticTraversal.js

@@ -1,30 +0,0 @@
-import * as t from "@babel/types";
-/**
- * Visit every Babel AST node in deterministic source-tree order.
- *
- * `ancestors` runs outermost-first and ends with the direct parent. Callers
- * need it whenever meaning depends on where a node sits, not just what its
- * immediate parent is — a binding inside `catch ({message})` or `({a} = o)`
- * has an ObjectProperty parent, so the parent alone cannot say whether the
- * identifier declares a binding or is assigned to.
- */
-export const traverseJavaScriptAst = (root, visitor) => {
-    const visit = (node, parent, ancestors) => {
-        visitor.enter(node, parent, ancestors);
-        for (const child of childNodes(node))
-            visit(child, node, [...ancestors, node]);
-        visitor.exit?.(node, parent);
-    };
-    visit(root, null, []);
-};
-const childNodes = (node) => {
-    const keys = t.VISITOR_KEYS[node.type] ?? [];
-    return keys.flatMap((key) => {
-        const value = Reflect.get(node, key);
-        if (t.isNode(value))
-            return [value];
-        if (!Array.isArray(value))
-            return [];
-        return value.filter((item) => t.isNode(item));
-    });
-};

package/dist/native/NativeHostCapabilities.js

@@ -1,23 +0,0 @@
-/** Apply native host restrictions to portable provider discovery metadata. */
-export const nativeHostCapabilities = (capabilities, platform = process.platform) => {
-    if (platform === "darwin")
-        return capabilities;
-    return capabilities.map((capability) => {
-        if (capability.provider.id === "native-macos")
-            return {
-                ...capability,
-                available: false,
-                availabilityCode: "unsupported_host",
-                reason: "Native macOS utilities require macOS.",
-            };
-        if (capability.provider.id === "rea-artifact-graph" &&
-            capability.operation === "inspect_asset_catalog")
-            return {
-                ...capability,
-                available: false,
-                availabilityCode: "unsupported_host",
-                reason: "Apple asset catalogs require macOS assetutil.",
-            };
-        return capability;
-    });
-};