@aexol/spectral 0.9.229 → 0.9.231

package/dist/relay/wizard-login.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard-login.d.ts","sourceRoot":"","sources":["../../src/relay/wizard-login.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EACF,YAAY,GACZ,oBAAoB,GACpB,SAAS,GACT,WAAW,GACX,iBAAiB,GACjB,qBAAqB,GACrB,cAAc,GACd,QAAQ,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuUD,wBAAsB,gBAAgB,CAAC,SAAS,SAAY,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuBxF"}

package/dist/relay/wizard-login.js

@@ -0,0 +1,419 @@
+/**
+ * Wizard login flow (CLI side).
+ *
+ * Starts the `@aexol/wizard-spectral` login subprocess on behalf of
+ * `POST /api/wizard/login` (routed by `relay/routing.ts`). Extracted from
+ * `relay/dispatcher.ts` — the dispatcher re-exports `startWizardLogin` and
+ * `WizardLoginResult` so existing imports keep working.
+ */
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { homedir } from "node:os";
+import { dirname, isAbsolute, join } from "node:path";
+const WIZARD_PACKAGE_NAME = "@aexol/wizard-spectral";
+const WIZARD_CLI_BIN_NAME = "spectral-wizard";
+const WIZARD_LOGIN_STARTUP_TIMEOUT_MS = 5_000;
+const requireForWizard = createRequire(import.meta.url);
+let activeWizardLoginRun = null;
+let activeWizardLoginStartPromise = null;
+function getActiveWizardLoginRun() {
+    const run = activeWizardLoginRun;
+    if (!run)
+        return null;
+    if (run.child.exitCode !== null || run.child.killed) {
+        activeWizardLoginRun = null;
+        return null;
+    }
+    return run;
+}
+function toSafeErrorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    if (typeof error === "string")
+        return error;
+    return "Unknown error";
+}
+function asRecord(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    return value;
+}
+function findWizardPackageJsonFromEntry(entryPath) {
+    let current = dirname(entryPath);
+    for (let depth = 0; depth < 8; depth += 1) {
+        const candidate = join(current, "package.json");
+        if (existsSync(candidate)) {
+            try {
+                const packageJson = JSON.parse(readFileSync(candidate, "utf8"));
+                if (asRecord(packageJson)?.name === WIZARD_PACKAGE_NAME)
+                    return candidate;
+            }
+            catch {
+                // Keep walking upward; malformed metadata is handled by the final reader.
+            }
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return undefined;
+}
+function resolveWizardPackageJsonPath() {
+    try {
+        return { ok: true, path: requireForWizard.resolve(`${WIZARD_PACKAGE_NAME}/package.json`) };
+    }
+    catch (error) {
+        try {
+            const entryPath = requireForWizard.resolve(WIZARD_PACKAGE_NAME);
+            const packageJsonPath = findWizardPackageJsonFromEntry(entryPath);
+            if (packageJsonPath)
+                return { ok: true, path: packageJsonPath };
+        }
+        catch {
+            // Fall through to the original package-unavailable message.
+        }
+        return {
+            ok: false,
+            message: `${WIZARD_PACKAGE_NAME} is not available on this machine: ${toSafeErrorMessage(error)}`,
+        };
+    }
+}
+function readWizardPackageJson(packageJsonPath) {
+    try {
+        return { ok: true, json: JSON.parse(readFileSync(packageJsonPath, "utf8")) };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            message: `Could not read ${WIZARD_PACKAGE_NAME} package metadata: ${toSafeErrorMessage(error)}`,
+        };
+    }
+}
+function getWizardBinRelativePath(packageJson) {
+    const pkg = asRecord(packageJson);
+    const bin = pkg?.bin;
+    if (typeof bin === "string" && bin.trim())
+        return bin;
+    const binRecord = asRecord(bin);
+    const namedBin = binRecord?.[WIZARD_CLI_BIN_NAME];
+    return typeof namedBin === "string" && namedBin.trim() ? namedBin : undefined;
+}
+function findWindowsBinShim(packageRoot) {
+    let current = packageRoot;
+    for (let depth = 0; depth < 8; depth += 1) {
+        const candidate = join(current, "node_modules", ".bin", `${WIZARD_CLI_BIN_NAME}.cmd`);
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return undefined;
+}
+function resolveWizardBinCommand() {
+    const packageJsonPath = resolveWizardPackageJsonPath();
+    if (!packageJsonPath.ok)
+        return packageJsonPath;
+    const packageJson = readWizardPackageJson(packageJsonPath.path);
+    if (!packageJson.ok)
+        return packageJson;
+    const binRelativePath = getWizardBinRelativePath(packageJson.json);
+    if (!binRelativePath) {
+        return {
+            ok: false,
+            message: `${WIZARD_PACKAGE_NAME} is installed but does not expose a ${WIZARD_CLI_BIN_NAME} bin.`,
+        };
+    }
+    const packageRoot = dirname(packageJsonPath.path);
+    const packageBinPath = isAbsolute(binRelativePath)
+        ? binRelativePath
+        : join(packageRoot, binRelativePath);
+    if (process.platform === "win32") {
+        const cmdShim = findWindowsBinShim(packageRoot);
+        if (cmdShim) {
+            return {
+                ok: true,
+                bin: { command: cmdShim, argsPrefix: [] },
+            };
+        }
+    }
+    return {
+        ok: true,
+        bin: { command: packageBinPath, argsPrefix: [] },
+    };
+}
+function collectWizardTools(value) {
+    if (Array.isArray(value))
+        return value;
+    const record = asRecord(value);
+    const tools = record?.tools;
+    return Array.isArray(tools) ? tools : [];
+}
+function findWizardStatusTool(tools) {
+    for (const tool of tools) {
+        const record = asRecord(tool);
+        if (record?.name !== "wizard_status" || typeof record.execute !== "function") {
+            continue;
+        }
+        return {
+            execute: record.execute,
+        };
+    }
+    return null;
+}
+function normalizeWizardAuthStatus(value) {
+    const normalized = value.trim().toLowerCase().replace(/[\s-]+/g, "_");
+    if (normalized === "configured" ||
+        normalized === "authenticated" ||
+        normalized === "ready" ||
+        normalized === "ok" ||
+        normalized === "connected") {
+        return "configured";
+    }
+    if (normalized === "missing_auth" ||
+        normalized === "auth_missing" ||
+        normalized === "needs_auth" ||
+        normalized === "not_authenticated" ||
+        normalized === "unauthenticated" ||
+        normalized === "not_configured") {
+        return "missing_auth";
+    }
+    return "unknown";
+}
+function parseWizardAuthStatusFromObject(record) {
+    for (const key of ["status", "authStatus", "state"]) {
+        const raw = record[key];
+        if (typeof raw !== "string")
+            continue;
+        const status = normalizeWizardAuthStatus(raw);
+        if (status !== "unknown")
+            return status;
+    }
+    for (const key of ["configured", "authenticated", "isAuthenticated", "hasAuth"]) {
+        const raw = record[key];
+        if (typeof raw === "boolean")
+            return raw ? "configured" : "missing_auth";
+    }
+    return "unknown";
+}
+function parseWizardAuthStatus(statusOutput) {
+    const candidates = [statusOutput];
+    const outputRecord = asRecord(statusOutput);
+    if (outputRecord) {
+        candidates.push(outputRecord.details, outputRecord.data, outputRecord.result);
+    }
+    for (const candidate of candidates) {
+        const record = asRecord(candidate);
+        if (!record)
+            continue;
+        const status = parseWizardAuthStatusFromObject(record);
+        if (status !== "unknown")
+            return status;
+    }
+    return "unknown";
+}
+async function checkWizardAuthStatus(directory) {
+    let importedModule;
+    try {
+        importedModule = await import(__rewriteRelativeImportExtension(WIZARD_PACKAGE_NAME));
+    }
+    catch (error) {
+        return {
+            status: "package_unavailable",
+            message: `${WIZARD_PACKAGE_NAME} is not available on this machine: ${toSafeErrorMessage(error)}`,
+        };
+    }
+    const buildSpectralTools = asRecord(importedModule)?.buildSpectralTools;
+    if (typeof buildSpectralTools !== "function") {
+        return {
+            status: "unknown",
+            message: "Wizard status API is unavailable; starting login.",
+        };
+    }
+    try {
+        const tools = collectWizardTools(await buildSpectralTools());
+        const statusTool = findWizardStatusTool(tools);
+        if (!statusTool) {
+            return {
+                status: "unknown",
+                message: "Wizard status tool is unavailable; starting login.",
+            };
+        }
+        const status = parseWizardAuthStatus(await statusTool.execute("wizard-ui-login-status", { directory }));
+        return {
+            status,
+            message: status === "configured"
+                ? "Wizard is already authenticated."
+                : "Wizard authentication is missing; starting login.",
+        };
+    }
+    catch (error) {
+        return {
+            status: "unknown",
+            message: `Could not check Wizard auth status; starting login: ${toSafeErrorMessage(error)}`,
+        };
+    }
+}
+function wizardLoginResult(status, message, run) {
+    return {
+        status,
+        packageName: WIZARD_PACKAGE_NAME,
+        message,
+        loginUrl: run?.loginUrl,
+        startedAt: run?.startedAt,
+    };
+}
+function extractLoginUrl(text) {
+    const matches = text.match(/https?:\/\/[^\s"'<>]+/g) ?? [];
+    for (const raw of matches) {
+        const candidate = raw.replace(/[),.;]+$/, "");
+        if (isSafeLoginUrl(candidate))
+            return candidate;
+    }
+    return undefined;
+}
+function isSafeLoginUrl(value) {
+    try {
+        const url = new URL(value);
+        if (url.protocol !== "https:" && url.protocol !== "http:")
+            return false;
+        const forbiddenQueryKeys = new Set([
+            "access_token",
+            "id_token",
+            "refresh_token",
+            "token",
+            "jwt",
+            "code",
+        ]);
+        for (const key of url.searchParams.keys()) {
+            if (forbiddenQueryKeys.has(key.toLowerCase()))
+                return false;
+        }
+        if (/(^|[#&])(access_token|id_token|refresh_token|token|jwt|code)=/i.test(url.hash)) {
+            return false;
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function startWizardLogin(directory = homedir()) {
+    const existing = getActiveWizardLoginRun();
+    if (existing) {
+        return wizardLoginResult("already_running", existing.loginUrl
+            ? "Wizard login is already running. Complete the browser flow."
+            : "Wizard login is already running. Complete the browser flow if it has opened.", existing);
+    }
+    if (activeWizardLoginStartPromise)
+        return await activeWizardLoginStartPromise;
+    const startPromise = startWizardLoginInternal(directory);
+    activeWizardLoginStartPromise = startPromise;
+    try {
+        return await startPromise;
+    }
+    finally {
+        if (activeWizardLoginStartPromise === startPromise) {
+            activeWizardLoginStartPromise = null;
+        }
+    }
+}
+async function startWizardLoginInternal(directory) {
+    const authStatus = await checkWizardAuthStatus(directory);
+    if (authStatus.status === "configured") {
+        return {
+            status: "configured",
+            packageName: WIZARD_PACKAGE_NAME,
+            message: "Wizard is already authenticated; no login needed.",
+        };
+    }
+    if (authStatus.status === "package_unavailable") {
+        return {
+            status: "package_unavailable",
+            packageName: WIZARD_PACKAGE_NAME,
+            message: authStatus.message,
+        };
+    }
+    const existing = getActiveWizardLoginRun();
+    if (existing) {
+        return wizardLoginResult("already_running", existing.loginUrl
+            ? "Wizard login is already running. Complete the browser flow."
+            : "Wizard login is already running. Complete the browser flow if it has opened.", existing);
+    }
+    const bin = resolveWizardBinCommand();
+    if (!bin.ok) {
+        return {
+            status: "package_unavailable",
+            packageName: WIZARD_PACKAGE_NAME,
+            message: bin.message,
+        };
+    }
+    const child = spawn(bin.bin.command, [...bin.bin.argsPrefix, "login"], {
+        stdio: ["ignore", "pipe", "pipe"],
+        env: process.env,
+        cwd: directory,
+    });
+    const run = { child, startedAt: Date.now() };
+    activeWizardLoginRun = run;
+    return await new Promise((resolve) => {
+        let settled = false;
+        let timeout;
+        const finish = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            resolve(result);
+        };
+        const onData = (chunk) => {
+            if (run.loginUrl)
+                return;
+            const loginUrl = extractLoginUrl(chunk.toString("utf8"));
+            if (!loginUrl)
+                return;
+            run.loginUrl = loginUrl;
+            finish(wizardLoginResult("login_url_observed", "Wizard login started. Complete the browser flow to finish authentication.", run));
+        };
+        const onError = (error) => {
+            if (activeWizardLoginRun === run)
+                activeWizardLoginRun = null;
+            child.stdout?.off("data", onData);
+            child.stderr?.off("data", onData);
+            finish({
+                status: "spawn_failed",
+                packageName: WIZARD_PACKAGE_NAME,
+                message: `Could not start Wizard login: ${toSafeErrorMessage(error)}`,
+            });
+        };
+        const onExit = (code, signal) => {
+            if (activeWizardLoginRun === run)
+                activeWizardLoginRun = null;
+            child.stdout?.off("data", onData);
+            child.stderr?.off("data", onData);
+            const exitLabel = signal ? `signal ${signal}` : `code ${code ?? "unknown"}`;
+            const completed = code === 0 && signal === null;
+            finish(wizardLoginResult(completed ? "completed" : "exited", completed
+                ? "Wizard login completed."
+                : `Wizard login exited before emitting a login URL (${exitLabel}).`, run));
+        };
+        timeout = setTimeout(() => {
+            finish(wizardLoginResult("started", "Wizard login started. Complete the browser flow if it has opened.", run));
+        }, WIZARD_LOGIN_STARTUP_TIMEOUT_MS);
+        child.stdout?.on("data", onData);
+        child.stderr?.on("data", onData);
+        child.once("error", onError);
+        child.once("exit", onExit);
+    });
+}

package/dist/sdk/agent-core/agent-loop.d.ts

@@ -3,7 +3,8 @@
  * Transforms to Message[] only at the LLM call boundary.
  */
 import { EventStream } from "../ai/index.js";
-import type { AgentContext, AgentEvent, AgentLoopConfig, AgentMessage, AgentTool, AgentToolCall, StreamFn } from "./types.js";
+import type { AgentContext, AgentEvent, AgentLoopConfig, AgentMessage, StreamFn } from "./types.js";
+export { hasMissingRequiredArguments } from "./tool-execution.js";
 export type AgentEventSink = (event: AgentEvent) => Promise<void> | void;
 /**
  * Start an agent loop with a new prompt message.
@@ -21,12 +22,4 @@ export declare function agentLoop(prompts: AgentMessage[], context: AgentContext
 export declare function agentLoopContinue(context: AgentContext, config: AgentLoopConfig, signal?: AbortSignal, streamFn?: StreamFn): EventStream<AgentEvent, AgentMessage[]>;
 export declare function runAgentLoop(prompts: AgentMessage[], context: AgentContext, config: AgentLoopConfig, emit: AgentEventSink, signal?: AbortSignal, streamFn?: StreamFn): Promise<AgentMessage[]>;
 export declare function runAgentLoopContinue(context: AgentContext, config: AgentLoopConfig, emit: AgentEventSink, signal?: AbortSignal, streamFn?: StreamFn): Promise<AgentMessage[]>;
-/**
- * Detects whether a tool call is missing any required parameter, indicating the
- * provider truncated the response before the tool arguments were fully emitted.
- * Used together with `stopReason === "length"` to short-circuit tool validation
- * when a streamed tool call is incomplete (which would otherwise throw
- * `Validation failed ... You provided: {}`).
- */
-export declare function hasMissingRequiredArguments(tool: AgentTool<any>, toolCall: AgentToolCall): boolean;
 //# sourceMappingURL=agent-loop.d.ts.map

package/dist/sdk/agent-core/agent-loop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../../../src/sdk/agent-core/agent-loop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,WAAW,EAWZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,eAAe,EACf,YAAY,EACZ,SAAS,EACT,aAAa,EAEb,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAiCzE;;;GAGG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,CA2BzC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,CAkCzC;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,cAAc,EACpB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,YAAY,EAAE,CAAC,CAgBzB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,cAAc,EACpB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,YAAY,EAAE,CAAC,CAiBzB;AAkyBD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAYlG"}
+{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../../../src/sdk/agent-core/agent-loop.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,WAAW,EAUZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,eAAe,EACf,YAAY,EACZ,QAAQ,EACT,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAkCzE;;;GAGG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,CA2BzC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,WAAW,CAAC,UAAU,EAAE,YAAY,EAAE,CAAC,CAkCzC;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,cAAc,EACpB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,YAAY,EAAE,CAAC,CAgBzB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,cAAc,EACpB,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,QAAQ,GAClB,OAAO,CAAC,YAAY,EAAE,CAAC,CAiBzB"}