@superblocksteam/vite-plugin-file-sync 2.0.123 → 2.0.124-next.1

package/dist/ai-service/agent/tools/build-install-packages.js

@@ -1,7 +1,9 @@
 import fs from "node:fs/promises";
 import path from "node:path";
 import z from "zod";
+import { isProtectedCorePackage, PROTECTED_CORE_PACKAGES, } from "@superblocksteam/library-shared/types";
 import { getErrorMeta, getLogger } from "../../../util/logger.js";
+import { NpmInstallBlocked } from "../../types.js";
 import { createToolFactory, ToolCategory } from "../tools2/types.js";
 async function readPackageJson(appRootDirPath) {
     try {
@@ -13,6 +15,169 @@ async function readPackageJson(appRootDirPath) {
         return null;
     }
 }
+/** Sanitize a string before interpolating it into the agent-facing message.
+ *
+ *  Package specs and registry hosts originate from npm's error.detail /
+ *  error.summary — i.e. attacker-controllable for a hostile or misbehaving
+ *  registry. Without sanitization, a value containing backticks/newlines
+ *  could break out of the surrounding markdown code-span (or fake one),
+ *  letting the registry inject instructions into the agent's read context.
+ *
+ *  Three transforms, applied in order:
+ *    - Strip ASCII control chars + newlines so injected line breaks can't
+ *      forge a new "instruction" paragraph.
+ *    - Strip backticks so the value can't terminate the surrounding span or
+ *      introduce a fenced block.
+ *    - Cap length so a multi-KB payload can't push downstream context out
+ *      of the window. 100 chars accommodates the longest realistic scoped
+ *      spec (`@some-org/some-package@1.2.3-rc.4+sha.abc1234`) with room. */
+const SAFE_INTERP_MAX_LEN = 100;
+function sanitizeForAgentMessage(value) {
+    // eslint-disable-next-line no-control-regex -- intentional: scrubbing CR/LF/control chars
+    const stripped = value.replace(/[`\u0000-\u001F\u007F]/g, "");
+    return stripped.length > SAFE_INTERP_MAX_LEN
+        ? `${stripped.slice(0, SAFE_INTERP_MAX_LEN)}…`
+        : stripped;
+}
+/** Whether `host` (already lowercased downstream by the URL parser, but we
+ *  re-lowercase for defence) is one of the public npmjs.org registry hosts.
+ *
+ *  `registry.npmjs.org` is the de facto URL npm uses in cloud-edit, SaaS,
+ *  on-prem-without-private-registry, and the baked-in dev-server `.npmrc`.
+ *  Legacy `npmjs.org` redirects to it but can still appear in error
+ *  summaries from older npm clients. Anything else (Artifactory, GHPR,
+ *  Verdaccio, a customer-hosted mirror) counts as a private host. */
+function isPublicNpmHost(host) {
+    if (!host)
+        return false;
+    const h = host.toLowerCase();
+    return (h === "registry.npmjs.org" || h === "npmjs.org" || h.endsWith(".npmjs.org"));
+}
+/**
+ * Render a `NpmInstallBlocked` into an actionable one-paragraph message for
+ * the agent, plus the discriminator that selected the message branch. The
+ * structured `error` field carries the canonical inputs; this string is what
+ * the model reads first.
+ *
+ * Branch selection (see `NpmInstallBlockedMessageVariant`):
+ *
+ *   - `unreachable_escalation` — `registry_unreachable` + zero configured
+ *     rows + host is npmjs (or unknown). Covers both the SaaS "npmjs is down"
+ *     case and the airgapped "egress is blocked and no private registry is
+ *     wired up" case with one hybrid message, because the dev-server cannot
+ *     distinguish them from the error alone.
+ *   - `private_mirror_hint` — `not_in_registry` + at least one configured
+ *     row + host is private. Appends "an org admin may need to mirror this
+ *     package" because that's an actionable escalation on a private
+ *     registry; same hint on npmjs would be misleading.
+ *   - `default` — every other combination, including all
+ *     `registry_auth_failed` failures.
+ *
+ * Exported so the matrix can be unit-tested directly without round-tripping
+ * through the AppShell + npm exec mock.
+ */
+export function buildBlockedMessage(err) {
+    const safeHost = err.registryHost
+        ? sanitizeForAgentMessage(err.registryHost)
+        : "";
+    const host = safeHost ? ` (registry: ${safeHost})` : "";
+    const packagesPhrase = err.packages.length > 0
+        ? err.packages.map((p) => `\`${sanitizeForAgentMessage(p)}\``).join(", ")
+        : "the requested package";
+    // Core-package guard (APPS-4527): when the blocked set contains a
+    // protected core dependency (`@superblocksteam/*`, react, react-router,
+    // vite, …), Clark must not "fix" the failure by removing or refactoring
+    // the app away from it — the dev server, bundle builder, and runtime all
+    // require these. The only remediation is mirroring into the registry.
+    const protectedCorePackageGuidance = err.packages.some((p) => isProtectedCorePackage(p))
+        ? ` One or more of these are core app dependencies (\`@superblocksteam/*\` packages, ${PROTECTED_CORE_PACKAGES.join(", ")}). Never suggest uninstalling, replacing, or refactoring the app away from a core dependency; an org admin must make it available in the registry.`
+        : "";
+    // Tri-state: `undefined` means "no client wired in" (test fixtures, judge
+    // runner) and is treated as `true` — there is no escalation path to
+    // recommend if we don't know the deployment has a private-registry seam.
+    const hasRows = err.hasAnyRegistryConfigured !== false;
+    const hostIsPublic = isPublicNpmHost(err.registryHost);
+    const hostIsKnown = !!err.registryHost;
+    const errorCode = err.npmErrorCode;
+    switch (err.reason) {
+        case "not_in_registry": {
+            const privateHostWithRows = hostIsKnown && !hostIsPublic && hasRows;
+            if (privateHostWithRows) {
+                // Private host + rows present: the customer is on a private registry
+                // and this 404 most likely means the package isn't mirrored yet (or
+                // is genuinely missing). Append an actionable escalation pointing at
+                // the org admin without naming the registry URL or any token-bearing
+                // details — non-admin users still get something they can do.
+                return {
+                    variant: "private_mirror_hint",
+                    message: `The npm registry${host} returned 404 for ${packagesPhrase}. This may be a typo, an unpublished package, or a package that has not been mirrored into your private registry. Stop and confirm with the user before trying a different package — and if the package name is correct, an org admin may need to mirror it into your private registry.${protectedCorePackageGuidance}`,
+                };
+            }
+            // Mode-agnostic default: covers SaaS (npmjs → typo / unpublished /
+            // renamed), private host with no rows (degenerate EE ephemeral case),
+            // and unknown host (parser couldn't extract a URL).
+            return {
+                variant: "default",
+                message: `The npm registry${host} returned 404 for ${packagesPhrase}. This may be a typo, an unpublished or renamed package, or — if a private registry is configured — a package that has not been mirrored. Stop and confirm with the user before trying a different package.${protectedCorePackageGuidance}`,
+            };
+        }
+        case "registry_unreachable": {
+            // Escalation hint applies only when (a) we know zero rows are
+            // configured AND (b) the host npm attempted is npmjs.org or unknown
+            // (no host extracted from the error). When the host is a private
+            // registry the customer already has one wired up — telling them to
+            // configure one would be misleading.
+            const hostQualifiesForEscalation = !hostIsKnown || hostIsPublic;
+            const noRowsConfigured = err.hasAnyRegistryConfigured === false;
+            if (hostQualifiesForEscalation && noRowsConfigured) {
+                return {
+                    variant: "unreachable_escalation",
+                    message: `The npm registry${host} could not be reached (${errorCode ?? "network error"}). This may be a temporary outage of npmjs.org, or — if this deployment cannot reach public npm — egress may be blocked. Alternative packages will not help — stop and report this to the user. If this deployment is intended to use a private npm registry, ask an org admin to configure one in Org Settings → Package Registry.`,
+                };
+            }
+            // Subreason-specific hint (APPS-4381): the parser narrows the failure
+            // to dns / network / proxy / timeout where it can, so the operator
+            // gets a directed next step instead of the four-cause grab-bag. The
+            // hint is appended to the existing multi-cause sentence — keeping the
+            // structure stable lets existing model-eval prompts continue matching
+            // on the "could not be reached" / "alternative packages will not help"
+            // anchors that the rest of the test surface pins.
+            const subreasonHint = (() => {
+                switch (err.subreason) {
+                    case "dns":
+                        return " The registry hostname could not be resolved (DNS); the corporate or container DNS resolver may not see this host.";
+                    case "network":
+                        return " The TCP connection was refused or reset; a firewall, egress filter, or routing rule may be blocking the registry.";
+                    case "proxy":
+                        return " An HTTP proxy refused the request; the proxy URL, credentials, or NO_PROXY rules may be misconfigured.";
+                    case "timeout":
+                        return " The request timed out; the network path to the registry is slow or the registry is hung.";
+                    default:
+                        return "";
+                }
+            })();
+            // Revised default: drop the "transient" framing — unreachable can
+            // equally be DNS misconfig, an auth gateway rejecting the request at
+            // the network layer, expired credentials, or a misrouted scope. The
+            // common thread is "alternative packages will not help; surface this
+            // up the stack."
+            return {
+                variant: "default",
+                message: `The npm registry${host} could not be reached (${errorCode ?? "network error"}). This may be a registry outage, a network or auth misconfiguration, expired credentials at the network layer, or a misrouted scope.${subreasonHint} Alternative packages will not help — stop and report the failure to the user.`,
+            };
+        }
+        case "registry_auth_failed":
+            return {
+                variant: "default",
+                message: `The configured npm registry${host} rejected the authentication credentials (${errorCode ?? "auth error"}). This requires an administrator to fix the registry token. Stop and report the failure rather than trying alternative packages.`,
+            };
+        case "tls_failed":
+            return {
+                variant: "default",
+                message: `The TLS handshake with the npm registry${host} failed (${errorCode ?? "TLS error"}). Common causes: an untrusted private CA the registry serves, a self-signed certificate, or an expired certificate. An administrator must install the registry's CA bundle (e.g. via NODE_EXTRA_CA_CERTS or the npm cafile config) or rotate the expired certificate. Alternative packages will not help — stop and report the failure to the user.`,
+            };
+    }
+}
 function detectVersionChanges(packages, currentPackageJson) {
     if (!currentPackageJson)
         return [];
@@ -100,11 +265,63 @@ export const buildInstallPackagesToolFactory = createToolFactory("build_installP
                 }
             }
             catch (error) {
+                // Surface registry-blocked failures as a structured tool result so
+                // the agent can reason about the reason (404 vs auth vs network)
+                // on the same conversation turn, instead of letting the error
+                // bubble up to agent-planning's POST_PROCESSING_ERRORED branch
+                // (which only emits a raw stderr `debug()` message).
+                if (error instanceof NpmInstallBlocked) {
+                    // `warn` (not `info`) because operators want this to surface in
+                    // standard `level>=warn` alert queries: a blocked install is a
+                    // handled, recoverable condition (the agent gets structured
+                    // guidance) but operationally important to track. `error` would
+                    // overstate severity since the agent loop is not crashing, and
+                    // would force the strict `ErrorMeta` shape that drops the
+                    // structured `toJSON()` payload operators actually want to
+                    // facet on. Per APPS-4179 AC this is the single log line for
+                    // the structured error.
+                    //
+                    // `messageVariant` joins the toJSON projection so a downstream
+                    // Datadog/Loki facet can distinguish the row-aware branches
+                    // (`private_mirror_hint`, `unreachable_escalation`) from the
+                    // default advice without re-deriving the matrix from the raw
+                    // inputs. AppShell.classifyNpmExecError emits the same data
+                    // points as llmobs span tags; the warn log is the structured
+                    // counterpart that survives outside of trace sampling.
+                    const { message, variant } = buildBlockedMessage(error);
+                    getLogger().warn("Install blocked by registry condition", {
+                        ...error.toJSON(),
+                        messageVariant: variant,
+                    });
+                    return {
+                        ok: false,
+                        error: error.toJSON(),
+                        message,
+                    };
+                }
                 getLogger().error("Error installing packages", getErrorMeta(error));
                 throw error;
             }
         },
         getSummary: (input, output) => {
+            // Blocked-install result is the failure path: surface the reason
+            // instead of pretending the install succeeded.
+            if (output && "ok" in output && output.ok === false) {
+                const blockedOutput = `Blocked: ${output.error.reason}`;
+                // Mirror the success branch: omit the `input` field on the no-args
+                // install path (runPackageManagerInstall) so the summary doesn't
+                // render `"0 packages: "` with a dangling colon.
+                if (input.packages && input.packages.length > 0) {
+                    const names = input.packages.map((p) => p.name).join(", ");
+                    return {
+                        input: `${input.packages.length} package${input.packages.length === 1 ? "" : "s"}: ${names}`,
+                        output: blockedOutput,
+                    };
+                }
+                return {
+                    output: blockedOutput,
+                };
+            }
             if (input.packages && input.packages.length > 0) {
                 const names = input.packages.map((p) => p.name).join(", ");
                 const versionWarning = output.versionChanges?.length

package/dist/ai-service/agent/tools/build-install-packages.js.map

@@ -1 +1 @@
-{"version":3,"file":"build-install-packages.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-install-packages.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"build-install-packages.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-install-packages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,EACL,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGlE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKnD,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAcrE,KAAK,UAAU,eAAe,CAC5B,cAAsB;IAEtB,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;4EAe4E;AAC5E,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAChC,SAAS,uBAAuB,CAAC,KAAa;IAC5C,0FAA0F;IAC1F,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IAC9D,OAAO,QAAQ,CAAC,MAAM,GAAG,mBAAmB;QAC1C,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,GAAG;QAC9C,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC;AAED;;;;;;;qEAOqE;AACrE,SAAS,eAAe,CAAC,IAAwB;IAC/C,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,OAAO,CACL,CAAC,KAAK,oBAAoB,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAC5E,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAA0B;IAI5D,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY;QAC/B,CAAC,CAAC,uBAAuB,CAAC,GAAG,CAAC,YAAY,CAAC;QAC3C,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,eAAe,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxD,MAAM,cAAc,GAClB,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QACrB,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,uBAAuB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACzE,CAAC,CAAC,uBAAuB,CAAC;IAC9B,kEAAkE;IAClE,wEAAwE;IACxE,wEAAwE;IACxE,yEAAyE;IACzE,sEAAsE;IACtE,MAAM,4BAA4B,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3D,sBAAsB,CAAC,CAAC,CAAC,CAC1B;QACC,CAAC,CAAC,qFAAqF,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,oJAAoJ;QAC7Q,CAAC,CAAC,EAAE,CAAC;IACP,0EAA0E;IAC1E,oEAAoE;IACpE,yEAAyE;IACzE,MAAM,OAAO,GAAG,GAAG,CAAC,wBAAwB,KAAK,KAAK,CAAC;IACvD,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;IACvC,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC;IAEnC,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;QACnB,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,MAAM,mBAAmB,GAAG,WAAW,IAAI,CAAC,YAAY,IAAI,OAAO,CAAC;YACpE,IAAI,mBAAmB,EAAE,CAAC;gBACxB,qEAAqE;gBACrE,oEAAoE;gBACpE,qEAAqE;gBACrE,qEAAqE;gBACrE,6DAA6D;gBAC7D,OAAO;oBACL,OAAO,EAAE,qBAAqB;oBAC9B,OAAO,EAAE,mBAAmB,IAAI,qBAAqB,cAAc,0RAA0R,4BAA4B,EAAE;iBAC5X,CAAC;YACJ,CAAC;YACD,mEAAmE;YACnE,sEAAsE;YACtE,oDAAoD;YACpD,OAAO;gBACL,OAAO,EAAE,SAAS;gBAClB,OAAO,EAAE,mBAAmB,IAAI,qBAAqB,cAAc,8MAA8M,4BAA4B,EAAE;aAChT,CAAC;QACJ,CAAC;QACD,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,8DAA8D;YAC9D,oEAAoE;YACpE,iEAAiE;YACjE,mEAAmE;YACnE,qCAAqC;YACrC,MAAM,0BAA0B,GAAG,CAAC,WAAW,IAAI,YAAY,CAAC;YAChE,MAAM,gBAAgB,GAAG,GAAG,CAAC,wBAAwB,KAAK,KAAK,CAAC;YAChE,IAAI,0BAA0B,IAAI,gBAAgB,EAAE,CAAC;gBACnD,OAAO;oBACL,OAAO,EAAE,wBAAwB;oBACjC,OAAO,EAAE,mBAAmB,IAAI,0BAA0B,SAAS,IAAI,eAAe,qUAAqU;iBAC5Z,CAAC;YACJ,CAAC;YACD,sEAAsE;YACtE,mEAAmE;YACnE,oEAAoE;YACpE,sEAAsE;YACtE,sEAAsE;YACtE,uEAAuE;YACvE,kDAAkD;YAClD,MAAM,aAAa,GAAG,CAAC,GAAW,EAAE;gBAClC,QAAQ,GAAG,CAAC,SAAS,EAAE,CAAC;oBACtB,KAAK,KAAK;wBACR,OAAO,oHAAoH,CAAC;oBAC9H,KAAK,SAAS;wBACZ,OAAO,oHAAoH,CAAC;oBAC9H,KAAK,OAAO;wBACV,OAAO,yGAAyG,CAAC;oBACnH,KAAK,SAAS;wBACZ,OAAO,2FAA2F,CAAC;oBACrG;wBACE,OAAO,EAAE,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;YACL,kEAAkE;YAClE,qEAAqE;YACrE,oEAAoE;YACpE,qEAAqE;YACrE,iBAAiB;YACjB,OAAO;gBACL,OAAO,EAAE,SAAS;gBAClB,OAAO,EAAE,mBAAmB,IAAI,0BAA0B,SAAS,IAAI,eAAe,wIAAwI,aAAa,gFAAgF;aAC5T,CAAC;QACJ,CAAC;QACD,KAAK,sBAAsB;YACzB,OAAO;gBACL,OAAO,EAAE,SAAS;gBAClB,OAAO,EAAE,8BAA8B,IAAI,6CAA6C,SAAS,IAAI,YAAY,mIAAmI;aACrP,CAAC;QACJ,KAAK,YAAY;YACf,OAAO;gBACL,OAAO,EAAE,SAAS;gBAClB,OAAO,EAAE,0CAA0C,IAAI,YAAY,SAAS,IAAI,WAAW,sVAAsV;aAClb,CAAC;IACN,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAC3B,QAAkE,EAClE,kBAAsC;IAEtC,IAAI,CAAC,kBAAkB;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,IAAI,KAAK,CAAC;QAC/B,MAAM,cAAc,GAAG,KAAK;YAC1B,CAAC,CAAC,kBAAkB,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;YAChD,CAAC,CAAC,kBAAkB,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEhD,IAAI,cAAc,IAAI,GAAG,CAAC,OAAO,IAAI,cAAc,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;YACpE,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,UAAU,EAAE,cAAc;gBAC1B,UAAU,EAAE,GAAG,CAAC,OAAO;gBACvB,KAAK;aACN,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,+BAA+B,GAAG,iBAAiB,CAC9D,uBAAuB,EACvB,CAAC,EACC,KAAK,EACL,QAAQ,GAIT,EAAE,EAAE;IACH,OAAO;QACL,QAAQ,EAAE,YAAY,CAAC,OAAO;QAC9B,WAAW,EAAE;;;;;;;;;KASd;QACC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC;iBACR,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;gBACP,IAAI,EAAE,CAAC;qBACJ,MAAM,EAAE;qBACR,QAAQ,CACP,uDAAuD,CACxD;gBACH,OAAO,EAAE,CAAC;qBACP,MAAM,EAAE;qBACR,QAAQ,EAAE;qBACV,QAAQ,CACP,gGAAgG,CACjG;gBACH,GAAG,EAAE,CAAC;qBACH,OAAO,EAAE;qBACT,QAAQ,EAAE;qBACV,QAAQ,CACP,2DAA2D,CAC5D;aACJ,CAAC,CACH;iBACA,QAAQ,EAAE;iBACV,QAAQ,CACP,iHAAiH,CAClH;SACJ,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC9B,IAAI,CAAC;gBACH,uCAAuC;gBACvC,MAAM,QAAQ,CAAC,cAAc,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAC;gBACpE,IAAI,MAAc,CAAC;gBACnB,IAAI,cAAc,GAAwB,EAAE,CAAC;gBAE7C,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACpC,MAAM,kBAAkB,GAAG,MAAM,eAAe,CAC9C,QAAQ,CAAC,QAAQ,CAAC,cAAc,CACjC,CAAC;oBACF,cAAc,GAAG,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;oBAEpE,oCAAoC;oBACpC,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,uBAAuB,CACtD,QAAQ,EACR,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CACtC,CAAC;oBAEF,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAChE,IAAI,OAAO,GAAG,oCAAoC,YAAY,EAAE,CAAC;oBAEjE,wCAAwC;oBACxC,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC9B,MAAM,aAAa,GAAG,cAAc;6BACjC,GAAG,CACF,CAAC,MAAM,EAAE,EAAE,CACT,OAAO,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,UAAU,MAAM,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CACnG;6BACA,IAAI,CAAC,IAAI,CAAC,CAAC;wBACd,OAAO,IAAI,kCAAkC,aAAa,wIAAwI,CAAC;oBACrM,CAAC;oBAED,OAAO;wBACL,MAAM;wBACN,OAAO;wBACP,cAAc;qBACf,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,oCAAoC;oBACpC,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,wBAAwB,CACvD,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,CACtC,CAAC;oBACF,OAAO;wBACL,MAAM;wBACN,OAAO,EAAE,kDAAkD;qBAC5D,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,mEAAmE;gBACnE,iEAAiE;gBACjE,8DAA8D;gBAC9D,+DAA+D;gBAC/D,qDAAqD;gBACrD,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;oBACvC,gEAAgE;oBAChE,+DAA+D;oBAC/D,4DAA4D;oBAC5D,gEAAgE;oBAChE,+DAA+D;oBAC/D,0DAA0D;oBAC1D,2DAA2D;oBAC3D,6DAA6D;oBAC7D,wBAAwB;oBACxB,EAAE;oBACF,+DAA+D;oBAC/D,4DAA4D;oBAC5D,6DAA6D;oBAC7D,6DAA6D;oBAC7D,4DAA4D;oBAC5D,6DAA6D;oBAC7D,uDAAuD;oBACvD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;oBACxD,SAAS,EAAE,CAAC,IAAI,CAAC,uCAAuC,EAAE;wBACxD,GAAG,KAAK,CAAC,MAAM,EAAE;wBACjB,cAAc,EAAE,OAAO;qBACxB,CAAC,CAAC;oBACH,OAAO;wBACL,EAAE,EAAE,KAAK;wBACT,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE;wBACrB,OAAO;qBACR,CAAC;gBACJ,CAAC;gBACD,SAAS,EAAE,CAAC,KAAK,CAAC,2BAA2B,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;gBACpE,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAC5B,iEAAiE;YACjE,+CAA+C;YAC/C,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,MAAM,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;gBACpD,MAAM,aAAa,GAAG,YAAY,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxD,mEAAmE;gBACnE,iEAAiE;gBACjE,iDAAiD;gBACjD,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAChD,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC3D,OAAO;wBACL,KAAK,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,WAAW,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,EAAE;wBAC5F,MAAM,EAAE,aAAa;qBACtB,CAAC;gBACJ,CAAC;gBACD,OAAO;oBACL,MAAM,EAAE,aAAa;iBACtB,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChD,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC3D,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,EAAE,MAAM;oBAClD,CAAC,CAAC,KAAK,MAAM,CAAC,cAAc,CAAC,MAAM,kBAAkB,MAAM,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG;oBACrG,CAAC,CAAC,EAAE,CAAC;gBACP,OAAO;oBACL,KAAK,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,WAAW,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,EAAE;oBAC5F,MAAM,EAAE,YAAY,cAAc,EAAE;iBACrC,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,MAAM,EAAE,sBAAsB;aAC/B,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC,CACF,CAAC"}

package/dist/ai-service/agent/tools/build-lookup-npm-package.d.ts

@@ -0,0 +1,28 @@
+import type { NpmPackageLookup, NpmPackageLookupResult } from "../../app-interface/npm-package-lookup.js";
+import type { Clark } from "../../state-machine/clark-fsm.js";
+import type { ClarkStateHandlerParams } from "../../state-machine/clark-fsm.js";
+/**
+ * The `NpmPackageLookup` instance is OWNED BY `AiService` and surfaced via
+ * `services.npmPackageLookup` — a single process-lifetime instance shared
+ * across every `buildTools()` call. An earlier revision of this file
+ * constructed `new NpmPackageLookup(...)` inside the factory body itself,
+ * which produced a fresh lookup (and a fresh `ObservableGauge` callback
+ * registration for `superblocks.npm.lookup.cache_size`) on every LLM
+ * generation turn. `ToolRegistry.clear()` does not dispose tool resources,
+ * so the OTel API's strong reference to the callback kept the old cache
+ * alive for the process lifetime and produced multiple
+ * same-instrument/same-attribute observations per collection cycle.
+ *
+ * Tests inject their own lookup via `deps.lookup` to keep the cache hermetic
+ * across cases.
+ */
+export interface BuildLookupNpmPackageDeps {
+    clark: Clark;
+    services: ClarkStateHandlerParams;
+    /** Test seam: inject a NpmPackageLookup with mocked fetch / clock. */
+    lookup?: NpmPackageLookup;
+}
+export declare const buildLookupNpmPackageToolFactory: import("../tools2/types.js").ToolFactory<BuildLookupNpmPackageDeps, import("../tools2/types.js").Tool<{
+    name: string;
+}, NpmPackageLookupResult>>;
+//# sourceMappingURL=build-lookup-npm-package.d.ts.map

package/dist/ai-service/agent/tools/build-lookup-npm-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-lookup-npm-package.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-lookup-npm-package.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAGhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,uBAAuB,CAAC;IAClC,sEAAsE;IACtE,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AAgBD,eAAO,MAAM,gCAAgC;;2BAmE5C,CAAC"}

package/dist/ai-service/agent/tools/build-lookup-npm-package.js

@@ -0,0 +1,78 @@
+import z from "zod";
+import { createToolFactory, ToolCategory } from "../tools2/types.js";
+/**
+ * Lightweight npm-package-name validation. The package metadata endpoint
+ * tolerates a lot of garbage on the path (most non-200s map to
+ * `not_in_registry`), and `encodePackagePath` already neutralises hostile
+ * characters in the URL, but rejecting obviously-invalid inputs at the
+ * schema boundary keeps tool summaries clean and avoids paying for a 404
+ * round trip on inputs that no npm install would ever accept.
+ *
+ * Roughly matches npm's `validate-npm-package-name` "valid for new packages"
+ * rules: optional `@scope/` prefix, each segment starts with `[a-z0-9]`,
+ * then `[a-z0-9._-]`, and the full string is ≤ 214 characters.
+ */
+const NPM_PACKAGE_NAME = /^(@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
+export const buildLookupNpmPackageToolFactory = createToolFactory("build_lookupNpmPackage", (deps) => {
+    const lookup = deps.lookup ?? deps.services.npmPackageLookup;
+    return {
+        category: ToolCategory.GENERAL,
+        readOnly: true,
+        description: `
+      Look up an npm package in the registry Clark's install path will hit. Use this BEFORE running 'npm install' to:
+      - verify the package exists (catches typos, hallucinated names, unpublished/deprecated packages)
+      - pick a recent version from 'recent_versions' (npm picks versions Clark might not have seen)
+
+      Always call this for any package you have not just looked up in the same session. It runs against whichever registry 'npm install' would use — including the public npm registry when no private registry is configured — so the answer matches what the install will actually do.
+
+      Inputs:
+      - name: the npm package name. Plain ('react', 'lodash') or scoped ('@types/node'). No version, no range — version selection is the agent's responsibility after reading 'recent_versions'.
+
+      Output:
+      - available: true iff the registry returned 200 for the package.
+      - mode: 'private' | 'public-npm' | 'fail-closed'. 'private' = the operator's configured per-org registry answered. 'public-npm' = npmjs.org answered (no private registry was configured, or a scoped name had no scope mapping). 'fail-closed' = the lookup was not performed because the private-registry config is in a hard-fail auth or unreachable state; treat as "do not install" and surface the configuration problem.
+      - reason: when available=false, one of 'not_in_registry' | 'registry_auth_failed' | 'registry_unreachable'. Same taxonomy as the install tool's blocked result.
+      - registry_host: the host that answered. Empty string when mode='fail-closed' (no lookup ran).
+      - latest_version: the registry's 'dist-tags.latest' when available.
+      - recent_versions: up to 30 recent published versions (newest first by publish time when available), so you can pin to a specific version without another tool call.
+
+      Reading the result:
+      - mode='public-npm' + reason='registry_unreachable' is the classic egress-blocked signal: the operator's network blocks npmjs.org and they have not configured a private registry. Tell the user; do not retry.
+      - mode='private' + reason='registry_unreachable' means the per-org private registry is down or unreachable. Tell the user; do not retry.
+      - mode='fail-closed' means we deliberately did not call out; surface a configuration / auth issue with the operator's private-registry setup.
+      - reason='not_in_registry' means the name is wrong, deprecated/unpublished, or not mirrored. Pick a different package; do not retry the same name.
+      - reason='registry_auth_failed' means a token problem against a private registry; the install will fail the same way until the operator fixes credentials.
+
+      Notes:
+      - This tool never installs anything; it only queries the registry.
+      - Successful lookups and 'not_in_registry' results are cached per-process for ~60s. Transient failures ('registry_auth_failed', 'registry_unreachable') are not cached, so a retry will hit the registry again.
+    `,
+        inputSchema: z.object({
+            name: z
+                .string()
+                .min(1, "package name is required")
+                .max(214, "package name must be 214 characters or fewer (npm spec)")
+                .regex(NPM_PACKAGE_NAME, "must be a valid npm package name (e.g. 'react' or '@scope/name', lowercase, no version specifier)")
+                .describe("Package name to look up (e.g. 'react', '@types/node')"),
+        }),
+        execute: async ({ name }) => {
+            return await lookup.lookup(name);
+        },
+        getSummary: (input, output) => {
+            if (output.available) {
+                const latest = output.latest_version
+                    ? ` (latest: ${output.latest_version})`
+                    : "";
+                return {
+                    input: input.name,
+                    output: `available via ${output.mode}${latest}`,
+                };
+            }
+            return {
+                input: input.name,
+                output: `unavailable via ${output.mode}: ${output.reason ?? "unknown"}`,
+            };
+        },
+    };
+});
+//# sourceMappingURL=build-lookup-npm-package.js.map

package/dist/ai-service/agent/tools/build-lookup-npm-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-lookup-npm-package.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-lookup-npm-package.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAQpB,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAwBrE;;;;;;;;;;;GAWG;AACH,MAAM,gBAAgB,GAAG,kDAAkD,CAAC;AAE5E,MAAM,CAAC,MAAM,gCAAgC,GAAG,iBAAiB,CAC/D,wBAAwB,EACxB,CAAC,IAA+B,EAAE,EAAE;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAC7D,OAAO;QACL,QAAQ,EAAE,YAAY,CAAC,OAAO;QAC9B,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA4Bd;QACC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC;iBAClC,GAAG,CAAC,GAAG,EAAE,yDAAyD,CAAC;iBACnE,KAAK,CACJ,gBAAgB,EAChB,mGAAmG,CACpG;iBACA,QAAQ,CAAC,uDAAuD,CAAC;SACrE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAmC,EAAE;YAC3D,OAAO,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QACD,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAC5B,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc;oBAClC,CAAC,CAAC,aAAa,MAAM,CAAC,cAAc,GAAG;oBACvC,CAAC,CAAC,EAAE,CAAC;gBACP,OAAO;oBACL,KAAK,EAAE,KAAK,CAAC,IAAI;oBACjB,MAAM,EAAE,iBAAiB,MAAM,CAAC,IAAI,GAAG,MAAM,EAAE;iBAChD,CAAC;YACJ,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,MAAM,EAAE,mBAAmB,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,IAAI,SAAS,EAAE;aACxE,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC,CACF,CAAC"}

package/dist/ai-service/agent/tools/build-manage-checklist.d.ts

@@ -21,12 +21,12 @@ export declare const buildManageChecklistToolFactory: import("../tools2/types.js
     clark: Clark;
     services: ClarkStateHandlerParams;
 }, import("../tools2/types.js").Tool<{
-    action: "add" | "get" | "update" | "clear";
-    status?: "failed" | "pending" | "cancelled" | "completed" | "in_progress" | undefined;
+    action: "get" | "add" | "update" | "clear";
+    status?: "pending" | "cancelled" | "failed" | "completed" | "in_progress" | undefined;
     content?: string | undefined;
-    itemId?: string | undefined;
-    failureReason?: string | undefined;
     clearOnFinalize?: boolean | undefined;
+    failureReason?: string | undefined;
+    itemId?: string | undefined;
 }, {
     success: boolean;
     action: string;

package/dist/ai-service/agent/tools/build-navigate-preview.d.ts

@@ -0,0 +1,16 @@
+import type { Clark, ClarkStateHandlerParams } from "../../state-machine/clark-fsm.js";
+export interface NavigatePreviewToolOutput {
+    message: string;
+    path: string;
+    success: boolean;
+}
+export declare const buildNavigatePreviewToolFactory: import("../tools2/types.js").ToolFactory<{
+    clark: Clark;
+    services: ClarkStateHandlerParams;
+}, import("../tools2/types.js").Tool<{
+    path: string;
+    hash?: string | undefined;
+    queryParams?: Record<string, string> | undefined;
+    routeParams?: Record<string, string> | undefined;
+}, NavigatePreviewToolOutput>>;
+//# sourceMappingURL=build-navigate-preview.d.ts.map

package/dist/ai-service/agent/tools/build-navigate-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-navigate-preview.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-navigate-preview.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,KAAK,EACL,uBAAuB,EACxB,MAAM,kCAAkC,CAAC;AAO1C,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,+BAA+B;WAErB,KAAK;cAAY,uBAAuB;;;;;;8BAiF9D,CAAC"}

package/dist/ai-service/agent/tools/build-navigate-preview.js

@@ -0,0 +1,68 @@
+import z from "zod";
+import { createToolFactory, PermissionLevel, ToolCategory, } from "../tools2/types.js";
+export const buildNavigatePreviewToolFactory = createToolFactory("build_navigatePreview", ({ clark }) => {
+    return {
+        category: ToolCategory.DEBUG,
+        defaultPermission: PermissionLevel.ALLOW,
+        description: `
+Navigate the app preview to a route path. Does not capture a screenshot.
+
+Use before \`build_captureScreenshot\` when you need visual verification on a route other than the one currently displayed.
+
+For dynamic routes (e.g. \`/users/:userId\`), pass \`routeParams\` when known; missing params default to \`TEST_VALUE_1\`, \`TEST_VALUE_2\`, etc.
+`,
+        execute: async ({ hash, path, queryParams, routeParams, }) => {
+            const logger = clark.logger;
+            logger.info(`[build_navigatePreview] Navigating preview to ${path}`);
+            if (!clark.context.peer) {
+                const error = "Editor client not available - cannot navigate preview";
+                logger.error(`[build_navigatePreview] ${error}`);
+                throw new Error(error);
+            }
+            const response = await clark.context.peer.call.aiNavigatePreviewRoute({
+                hash,
+                path,
+                queryParams,
+                routeParams,
+            });
+            if (!response?.success) {
+                const error = response?.error ?? `Failed to navigate preview to ${path}`;
+                logger.error(`[build_navigatePreview] ${error}`);
+                throw new Error(error);
+            }
+            const resolvedPath = response.path ?? path;
+            return {
+                message: `Successfully navigated preview to ${resolvedPath}`,
+                path: resolvedPath,
+                success: true,
+            };
+        },
+        getActionName: () => ({
+            future: "navigate the app preview to a route",
+            past: "navigated the app preview to a route",
+            present: "navigating the app preview to a route",
+        }),
+        getSummary: ({ path }) => ({
+            output: `Navigated preview to ${path}`,
+        }),
+        inputSchema: z.object({
+            hash: z
+                .string()
+                .optional()
+                .describe("Optional URL hash to append after navigation."),
+            path: z
+                .string()
+                .describe("Route path to navigate to (for example, '/feedback' or '/users/:userId')."),
+            queryParams: z
+                .record(z.string())
+                .optional()
+                .describe("Optional query string parameters for the route."),
+            routeParams: z
+                .record(z.string())
+                .optional()
+                .describe("Optional route params for dynamic segments (for example, { userId: '123' })."),
+        }),
+        readOnly: true,
+    };
+});
+//# sourceMappingURL=build-navigate-preview.js.map

package/dist/ai-service/agent/tools/build-navigate-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-navigate-preview.js","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/build-navigate-preview.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAMpB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,GACb,MAAM,oBAAoB,CAAC;AAQ5B,MAAM,CAAC,MAAM,+BAA+B,GAAG,iBAAiB,CAC9D,uBAAuB,EACvB,CAAC,EAAE,KAAK,EAAuD,EAAE,EAAE;IACjE,OAAO;QACL,QAAQ,EAAE,YAAY,CAAC,KAAK;QAC5B,iBAAiB,EAAE,eAAe,CAAC,KAAK;QACxC,WAAW,EAAE;;;;;;CAMlB;QACK,OAAO,EAAE,KAAK,EAAE,EACd,IAAI,EACJ,IAAI,EACJ,WAAW,EACX,WAAW,GACZ,EAAsC,EAAE;YACvC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YAE5B,MAAM,CAAC,IAAI,CAAC,iDAAiD,IAAI,EAAE,CAAC,CAAC;YAErE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,uDAAuD,CAAC;gBACtE,MAAM,CAAC,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC;gBACpE,IAAI;gBACJ,IAAI;gBACJ,WAAW;gBACX,WAAW;aACZ,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;gBACvB,MAAM,KAAK,GACT,QAAQ,EAAE,KAAK,IAAI,iCAAiC,IAAI,EAAE,CAAC;gBAC7D,MAAM,CAAC,KAAK,CAAC,2BAA2B,KAAK,EAAE,CAAC,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;YACzB,CAAC;YAED,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC;YAE3C,OAAO;gBACL,OAAO,EAAE,qCAAqC,YAAY,EAAE;gBAC5D,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;YACpB,MAAM,EAAE,qCAAqC;YAC7C,IAAI,EAAE,sCAAsC;YAC5C,OAAO,EAAE,uCAAuC;SACjD,CAAC;QACF,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YACzB,MAAM,EAAE,wBAAwB,IAAI,EAAE;SACvC,CAAC;QACF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,+CAA+C,CAAC;YAC5D,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CACP,2EAA2E,CAC5E;YACH,WAAW,EAAE,CAAC;iBACX,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBAClB,QAAQ,EAAE;iBACV,QAAQ,CAAC,iDAAiD,CAAC;YAC9D,WAAW,EAAE,CAAC;iBACX,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;iBAClB,QAAQ,EAAE;iBACV,QAAQ,CACP,8EAA8E,CAC/E;SACJ,CAAC;QACF,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC,CACF,CAAC"}

package/dist/ai-service/agent/tools/build-write-file.d.ts

@@ -4,8 +4,8 @@ export declare const buildWriteFileToolFactory: import("../tools2/types.js").Too
     clark: Clark;
     services: Pick<ClarkStateHandlerParams, "appShell" | "features">;
 }, import("../tools2/types.js").Tool<{
-    filePath: string;
     content: string;
+    filePath: string;
 }, {
     filePath: string;
     contentLength: number;

package/dist/ai-service/agent/tools/databases/dev-database.d.ts

@@ -30,7 +30,7 @@ declare const createDevDatabaseInputSchema: z.ZodObject<{
         migrationDirectory: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         logicalName: string;
-        engine: "snowflake" | "lakebase" | "postgres" | "snowflake_postgres";
+        engine: "snowflake" | "postgres" | "lakebase" | "snowflake_postgres";
         version?: string | undefined;
         sizing?: Record<string, unknown> | undefined;
         extensions?: string[] | undefined;
@@ -38,7 +38,7 @@ declare const createDevDatabaseInputSchema: z.ZodObject<{
         migrationDirectory?: string | undefined;
     }, {
         logicalName: string;
-        engine: "snowflake" | "lakebase" | "postgres" | "snowflake_postgres";
+        engine: "snowflake" | "postgres" | "lakebase" | "snowflake_postgres";
         version?: string | undefined;
         sizing?: Record<string, unknown> | undefined;
         extensions?: string[] | undefined;
@@ -49,7 +49,7 @@ declare const createDevDatabaseInputSchema: z.ZodObject<{
     environmentName: string;
     requirement: {
         logicalName: string;
-        engine: "snowflake" | "lakebase" | "postgres" | "snowflake_postgres";
+        engine: "snowflake" | "postgres" | "lakebase" | "snowflake_postgres";
         version?: string | undefined;
         sizing?: Record<string, unknown> | undefined;
         extensions?: string[] | undefined;
@@ -60,7 +60,7 @@ declare const createDevDatabaseInputSchema: z.ZodObject<{
     environmentName: string;
     requirement: {
         logicalName: string;
-        engine: "snowflake" | "lakebase" | "postgres" | "snowflake_postgres";
+        engine: "snowflake" | "postgres" | "lakebase" | "snowflake_postgres";
         version?: string | undefined;
         sizing?: Record<string, unknown> | undefined;
         extensions?: string[] | undefined;
@@ -73,7 +73,7 @@ export declare const createDevDbToolFactory: import("../../tools2/types.js").Too
     environmentName: string;
     requirement: {
         logicalName: string;
-        engine: "snowflake" | "lakebase" | "postgres" | "snowflake_postgres";
+        engine: "snowflake" | "postgres" | "lakebase" | "snowflake_postgres";
         version?: string | undefined;
         sizing?: Record<string, unknown> | undefined;
         extensions?: string[] | undefined;
@@ -84,8 +84,8 @@ export declare const createDevDbToolFactory: import("../../tools2/types.js").Too
     bindingKey: string;
     connectionMetadata: Record<string, string | number | boolean> | undefined;
     integrationId: string | undefined;
-    lifecycleState: "ready" | "failed" | "pending" | "cancelled" | "provisioning" | "migrating" | "retiring";
-    migrationState: "failed" | "pending" | "migrated";
+    lifecycleState: "ready" | "pending" | "cancelled" | "failed" | "provisioning" | "migrating" | "retiring";
+    migrationState: "pending" | "failed" | "migrated";
     requestId: string;
 }>>;
 export declare const getDevDbProgressToolFactory: import("../../tools2/types.js").ToolFactory<DevDatabaseToolDeps, import("../../tools2/types.js").Tool<{
@@ -95,8 +95,8 @@ export declare const getDevDbProgressToolFactory: import("../../tools2/types.js"
     bindingKey: string;
     connectionMetadata: Record<string, string | number | boolean> | undefined;
     integrationId: string | undefined;
-    lifecycleState: "ready" | "failed" | "pending" | "cancelled" | "provisioning" | "migrating" | "retiring";
-    migrationState: "failed" | "pending" | "migrated";
+    lifecycleState: "ready" | "pending" | "cancelled" | "failed" | "provisioning" | "migrating" | "retiring";
+    migrationState: "pending" | "failed" | "migrated";
     requestId: string;
 }>>;
 export type { DevDatabaseTransportRequest };

package/dist/ai-service/agent/tools/index.d.ts

@@ -1,4 +1,5 @@
 export { buildInstallPackagesToolFactory } from "./build-install-packages.js";
+export { buildLookupNpmPackageToolFactory } from "./build-lookup-npm-package.js";
 export { buildCopyDirectoryToolFactory } from "./build-copy-directory.js";
 export { buildCopyFileToolFactory } from "./build-copy-file.js";
 export { buildWriteFileToolFactory } from "./build-write-file.js";
@@ -9,6 +10,7 @@ export { buildListFilesToolFactory } from "./build-list-files.js";
 export { buildDebugToolFactory } from "./build-debug.js";
 export { clearErrorCacheToolFactory } from "./clear-error-cache.js";
 export { buildCaptureScreenshotToolFactory } from "./build-capture-screenshot.js";
+export { buildNavigatePreviewToolFactory } from "./build-navigate-preview.js";
 export { buildFinalizeToolFactory } from "./build-finalize.js";
 export { buildManageChecklistToolFactory } from "./build-manage-checklist.js";
 export { buildDeleteFileToolFactory, checkDeleteFilePermissions, } from "./build-delete-file.js";

package/dist/ai-service/agent/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,iCAAiC,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EACL,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,gCAAgC,EAAE,MAAM,4CAA4C,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,+BAA+B,EAAE,MAAM,4CAA4C,CAAC;AAC7F,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai-service/agent/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,gCAAgC,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,iCAAiC,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EACL,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EACL,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,6BAA6B,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,gCAAgC,EAAE,MAAM,4CAA4C,CAAC;AAC9F,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,+BAA+B,EAAE,MAAM,2CAA2C,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAE,+BAA+B,EAAE,MAAM,4CAA4C,CAAC;AAC7F,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,+BAA+B,CAAC"}

package/dist/ai-service/agent/tools/index.js

@@ -1,4 +1,5 @@
 export { buildInstallPackagesToolFactory } from "./build-install-packages.js";
+export { buildLookupNpmPackageToolFactory } from "./build-lookup-npm-package.js";
 export { buildCopyDirectoryToolFactory } from "./build-copy-directory.js";
 export { buildCopyFileToolFactory } from "./build-copy-file.js";
 export { buildWriteFileToolFactory } from "./build-write-file.js";
@@ -9,6 +10,7 @@ export { buildListFilesToolFactory } from "./build-list-files.js";
 export { buildDebugToolFactory } from "./build-debug.js";
 export { clearErrorCacheToolFactory } from "./clear-error-cache.js";
 export { buildCaptureScreenshotToolFactory } from "./build-capture-screenshot.js";
+export { buildNavigatePreviewToolFactory } from "./build-navigate-preview.js";
 export { buildFinalizeToolFactory } from "./build-finalize.js";
 export { buildManageChecklistToolFactory } from "./build-manage-checklist.js";
 export { buildDeleteFileToolFactory, checkDeleteFilePermissions, } from "./build-delete-file.js";