@made-by-moonlight/athene-core 0.9.1

package/dist/utils/session-from-metadata.js

@@ -0,0 +1,87 @@
+import { parseCanonicalLifecycle, deriveLegacyStatus } from '../lifecycle-state.js';
+import { createActivitySignal } from '../activity-signal.js';
+import { AGENT_REPORT_METADATA_KEYS } from '../agent-report.js';
+import { dedupePrInfos, parsePrFromUrl } from './pr.js';
+import { safeJsonParse, validateStatus } from './validation.js';
+
+function deriveDefaultActivitySignal(options) {
+    if (options.activitySignal) {
+        return options.activitySignal;
+    }
+    if (options.activity === undefined || options.activity === null) {
+        return createActivitySignal("unavailable");
+    }
+    return createActivitySignal("valid", {
+        activity: options.activity,
+        timestamp: options.lastActivityAt,
+        source: options.activity === "exited" ? "runtime" : "native",
+    });
+}
+function sessionFromMetadata(sessionId, meta, options = {}) {
+    const runtimeHandle = options.runtimeHandle !== undefined
+        ? options.runtimeHandle
+        : meta["runtimeHandle"]
+            ? safeJsonParse(meta["runtimeHandle"])
+            : null;
+    const lifecycle = parseCanonicalLifecycle(meta, {
+        sessionId,
+        status: options.status ?? validateStatus(meta["status"]),
+        runtimeHandle,
+        createdAt: options.createdAt,
+        sessionKind: options.sessionKind,
+    });
+    const status = options.status ?? deriveLegacyStatus(lifecycle);
+    const prUrl = lifecycle.pr.url ?? meta["pr"];
+    const prIsDraft = meta[AGENT_REPORT_METADATA_KEYS.PR_IS_DRAFT] === "true";
+    // Build a PRInfo object from a single URL string.
+    // isDraft defaults to false for secondary PRs — only the primary PR carries the flag.
+    const buildPRInfo = (url, isDraft = false, lifecyclePrNumber) => {
+        const parsed = parsePrFromUrl(url);
+        return {
+            number: parsed?.number || lifecyclePrNumber || 0,
+            url,
+            title: "",
+            owner: parsed?.owner ?? "",
+            repo: parsed?.repo ?? "",
+            branch: meta["branch"] ?? "",
+            baseBranch: "",
+            isDraft,
+        };
+    };
+    // Build prs[] from metadata.
+    // New sessions write "prs" as comma-separated URLs for all PRs.
+    // Old sessions only have a single "pr" field — wrap it for backwards compat.
+    const prsRaw = meta["prs"];
+    const lifecyclePrNumber = lifecycle.pr.number ?? null;
+    const parsedPrs = prsRaw
+        ? prsRaw
+            .split(",")
+            .map((u, i) => buildPRInfo(u.trim(), i === 0 ? prIsDraft : false, i === 0 ? lifecyclePrNumber : null))
+            .filter((p) => Boolean(p.url))
+        : prUrl
+            ? [buildPRInfo(prUrl, prIsDraft, lifecyclePrNumber)]
+            : [];
+    const prs = dedupePrInfos(parsedPrs);
+    return {
+        id: sessionId,
+        projectId: meta["project"] ?? options.projectId ?? "",
+        status,
+        activity: options.activity ?? null,
+        activitySignal: deriveDefaultActivitySignal(options),
+        lifecycle,
+        branch: meta["branch"] || null,
+        issueId: meta["issue"] || null,
+        pr: prs[0] ?? null,
+        prs,
+        workspacePath: meta["worktree"] || options.workspacePathFallback || null,
+        runtimeHandle: lifecycle.runtime.handle ?? runtimeHandle,
+        agentInfo: meta["summary"] ? { summary: meta["summary"], agentSessionId: null } : null,
+        createdAt: meta["createdAt"] ? new Date(meta["createdAt"]) : (options.createdAt ?? new Date()),
+        lastActivityAt: options.lastActivityAt ?? new Date(),
+        restoredAt: options.restoredAt ?? (meta["restoredAt"] ? new Date(meta["restoredAt"]) : undefined),
+        metadata: meta,
+    };
+}
+
+export { sessionFromMetadata };
+//# sourceMappingURL=session-from-metadata.js.map

package/dist/utils/session-from-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-from-metadata.js","sources":["../../src/utils/session-from-metadata.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/utils/session-id.d.ts

@@ -0,0 +1,4 @@
+import type { SessionId } from "../types.js";
+export declare const SESSION_ID_COMPONENT_PATTERN: RegExp;
+export declare function assertValidSessionIdComponent(sessionId: SessionId, context?: string): void;
+//# sourceMappingURL=session-id.d.ts.map

package/dist/utils/session-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-id.d.ts","sourceRoot":"","sources":["../../src/utils/session-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,4BAA4B,QAAqB,CAAC;AAE/D,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,SAAS,EACpB,OAAO,SAAe,GACrB,IAAI,CAIN"}

package/dist/utils/session-id.js

@@ -0,0 +1,9 @@
+const SESSION_ID_COMPONENT_PATTERN = /^[a-zA-Z0-9_-]+$/;
+function assertValidSessionIdComponent(sessionId, context = "session ID") {
+    if (!SESSION_ID_COMPONENT_PATTERN.test(sessionId)) {
+        throw new Error(`Invalid ${context}: ${sessionId}`);
+    }
+}
+
+export { SESSION_ID_COMPONENT_PATTERN, assertValidSessionIdComponent };
+//# sourceMappingURL=session-id.js.map

package/dist/utils/session-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-id.js","sources":["../../src/utils/session-id.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEO,MAAM,4BAA4B,GAAG;SAE5B,6BAA6B,CAC3C,SAAoB,EACpB,OAAO,GAAG,YAAY,EAAA;IAEtB,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE;QACjD,MAAM,IAAI,KAAK,CAAC,CAAA,QAAA,EAAW,OAAO,CAAA,EAAA,EAAK,SAAS,CAAA,CAAE,CAAC;IACrD;AACF;;;;"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shared validation utilities.
+ */
+import type { SessionStatus } from "../types.js";
+/** Safely parse JSON, returning null on failure. */
+export declare function safeJsonParse<T>(str: string): T | null;
+/** Validate and normalize a status string. */
+export declare function validateStatus(raw: string | undefined): SessionStatus;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAwBjD,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAMtD;AAED,8CAA8C;AAC9C,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAKrE"}

package/dist/utils/validation.js

@@ -0,0 +1,45 @@
+/**
+ * Shared validation utilities.
+ */
+/** Valid session statuses for validation. */
+const VALID_STATUSES = new Set([
+    "spawning",
+    "working",
+    "detecting",
+    "pr_open",
+    "ci_failed",
+    "review_pending",
+    "changes_requested",
+    "approved",
+    "mergeable",
+    "merged",
+    "cleanup",
+    "needs_input",
+    "stuck",
+    "errored",
+    "killed",
+    "idle",
+    "done",
+    "terminated",
+]);
+/** Safely parse JSON, returning null on failure. */
+function safeJsonParse(str) {
+    try {
+        return JSON.parse(str);
+    }
+    catch {
+        return null;
+    }
+}
+/** Validate and normalize a status string. */
+function validateStatus(raw) {
+    // Bash scripts write "starting" — treat as "working"
+    if (raw === "starting")
+        return "working";
+    if (raw && VALID_STATUSES.has(raw))
+        return raw;
+    return "spawning";
+}
+
+export { safeJsonParse, validateStatus };
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sources":["../../src/utils/validation.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;AAEG;AAIH;AACA,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IAClD,UAAU;IACV,SAAS;IACT,WAAW;IACX,SAAS;IACT,WAAW;IACX,gBAAgB;IAChB,mBAAmB;IACnB,UAAU;IACV,WAAW;IACX,QAAQ;IACR,SAAS;IACT,aAAa;IACb,OAAO;IACP,SAAS;IACT,QAAQ;IACR,MAAM;IACN,MAAM;IACN,YAAY;AACb,CAAA,CAAC;AAEF;AACM,SAAU,aAAa,CAAI,GAAW,EAAA;AAC1C,IAAA,IAAI;AACF,QAAA,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM;IAC7B;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,IAAI;IACb;AACF;AAEA;AACM,SAAU,cAAc,CAAC,GAAuB,EAAA;;IAEpD,IAAI,GAAG,KAAK,UAAU;AAAE,QAAA,OAAO,SAAS;AACxC,IAAA,IAAI,GAAG,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC;AAAE,QAAA,OAAO,GAAoB;AAC/D,IAAA,OAAO,UAAU;AACnB;;;;"}

package/dist/utils.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Shared utility functions for agent-orchestrator plugins.
+ */
+import type { OrchestratorConfig } from "./types.js";
+/**
+ * Shell-safe escaping for the platform's default shell.
+ *
+ * - Unix (/bin/sh): wraps in single quotes, escapes embedded ' as '\''
+ * - Windows (PowerShell): wraps in single quotes, escapes embedded ' as ''
+ */
+export declare function shellEscape(arg: string): string;
+/**
+ * Escape a string for safe interpolation inside AppleScript double-quoted strings.
+ * Handles backslashes and double quotes which would otherwise break or inject.
+ */
+export declare function escapeAppleScript(s: string): string;
+/**
+ * Validate that a URL starts with http:// or https://.
+ * Throws with a descriptive error including the plugin label if invalid.
+ */
+export declare function validateUrl(url: string, label: string): void;
+/**
+ * Conservative subset of git `check-ref-format` rules for branch-like names.
+ * Used before passing tracker-supplied names to `git worktree` / `checkout -b`.
+ *
+ * Slashes are allowed (e.g. `feature/foo-bar`).
+ */
+export declare function isGitBranchNameSafe(name: string): boolean;
+/**
+ * Returns true if an HTTP status code should be retried.
+ * Retry only 429 (rate-limit) and 5xx (server) failures.
+ */
+export declare function isRetryableHttpStatus(status: number): boolean;
+/**
+ * Normalize retry config from plugin config with sane defaults.
+ */
+export declare function normalizeRetryConfig(config: Record<string, unknown> | undefined, defaults?: {
+    retries: number;
+    retryDelayMs: number;
+}): {
+    retries: number;
+    retryDelayMs: number;
+};
+/**
+ * Read the last entry from a JSONL file.
+ * Reads backwards from end of file — pure Node.js, no external binaries.
+ *
+ * @param filePath - Path to the JSONL file
+ * @returns Object containing the last entry's `type`, nested `payload.type` (Codex shape),
+ *          top-level `subtype` and `level` (Claude `system`-entry shape), and the file mtime.
+ *          Returns null if the file is empty or unreadable.
+ */
+export declare function readLastJsonlEntry(filePath: string): Promise<{
+    lastType: string | null;
+    payloadType: string | null;
+    lastSubtype: string | null;
+    lastLevel: string | null;
+    modifiedAt: Date;
+} | null>;
+/**
+ * Given a session ID and the orchestrator config, find which project it belongs
+ * to by matching session prefixes.
+ */
+export declare function resolveProjectIdForSessionId(config: OrchestratorConfig, sessionId: string): string | undefined;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO/C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI5D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAgBzD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAC3C,QAAQ,GAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAuC,GACvF;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAQ3C;AAkDD;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAClE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,IAAI,CAAC;CAClB,GAAG,IAAI,CAAC,CA8BR;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAQpB"}

package/dist/utils.js

@@ -0,0 +1,189 @@
+import { stat, open } from 'node:fs/promises';
+import { isWindows } from './platform.js';
+
+/**
+ * Shared utility functions for agent-orchestrator plugins.
+ */
+/**
+ * Shell-safe escaping for the platform's default shell.
+ *
+ * - Unix (/bin/sh): wraps in single quotes, escapes embedded ' as '\''
+ * - Windows (PowerShell): wraps in single quotes, escapes embedded ' as ''
+ */
+function shellEscape(arg) {
+    if (isWindows()) {
+        // PowerShell: single-quoted strings use '' for embedded single quotes
+        return "'" + arg.replace(/'/g, "''") + "'";
+    }
+    // POSIX sh: single-quoted strings use '\'' for embedded single quotes
+    return "'" + arg.replace(/'/g, "'\\''") + "'";
+}
+/**
+ * Escape a string for safe interpolation inside AppleScript double-quoted strings.
+ * Handles backslashes and double quotes which would otherwise break or inject.
+ */
+function escapeAppleScript(s) {
+    return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+/**
+ * Validate that a URL starts with http:// or https://.
+ * Throws with a descriptive error including the plugin label if invalid.
+ */
+function validateUrl(url, label) {
+    if (!url.startsWith("https://") && !url.startsWith("http://")) {
+        throw new Error(`[${label}] Invalid url: must be http(s), got "${url}"`);
+    }
+}
+/**
+ * Conservative subset of git `check-ref-format` rules for branch-like names.
+ * Used before passing tracker-supplied names to `git worktree` / `checkout -b`.
+ *
+ * Slashes are allowed (e.g. `feature/foo-bar`).
+ */
+function isGitBranchNameSafe(name) {
+    if (!name)
+        return false;
+    if (name === "@" || name.startsWith(".") || name.endsWith(".") || name.endsWith("/"))
+        return false;
+    if (name.endsWith(".lock"))
+        return false;
+    if (name.includes(".."))
+        return false;
+    if (name.includes("//"))
+        return false;
+    if (name.includes("/."))
+        return false;
+    if (name.includes("@{"))
+        return false;
+    if (name.startsWith("/"))
+        return false;
+    for (let i = 0; i < name.length; i++) {
+        const c = name.charCodeAt(i);
+        if (c <= 0x1f || c === 0x7f)
+            return false;
+    }
+    // Space and git-forbidden punctuation (see git-check-ref-format)
+    if (/[\s~^:?*[\\]/.test(name))
+        return false;
+    return true;
+}
+/**
+ * Returns true if an HTTP status code should be retried.
+ * Retry only 429 (rate-limit) and 5xx (server) failures.
+ */
+function isRetryableHttpStatus(status) {
+    return status === 429 || status >= 500;
+}
+/**
+ * Normalize retry config from plugin config with sane defaults.
+ */
+function normalizeRetryConfig(config, defaults = { retries: 2, retryDelayMs: 1000 }) {
+    const rawRetries = config?.retries;
+    const rawDelay = config?.retryDelayMs;
+    const retries = Number.isFinite(rawRetries) ? Math.max(0, rawRetries ?? 0) : defaults.retries;
+    const retryDelayMs = Number.isFinite(rawDelay) && (rawDelay ?? -1) >= 0
+        ? rawDelay
+        : defaults.retryDelayMs;
+    return { retries, retryDelayMs };
+}
+/**
+ * Read the last line from a file by reading backwards from the end.
+ * Pure Node.js — no external binaries. Handles any file size.
+ */
+async function readLastLine(filePath) {
+    const CHUNK = 4096;
+    const fh = await open(filePath, "r");
+    try {
+        const { size } = await fh.stat();
+        if (size === 0)
+            return null;
+        // Read backwards in chunks, accumulating raw buffers to avoid
+        // corrupting multi-byte UTF-8 characters at chunk boundaries.
+        const chunks = [];
+        let totalBytes = 0;
+        let pos = size;
+        while (pos > 0) {
+            const readSize = Math.min(CHUNK, pos);
+            pos -= readSize;
+            const chunk = Buffer.alloc(readSize);
+            await fh.read(chunk, 0, readSize, pos);
+            chunks.unshift(chunk);
+            totalBytes += readSize;
+            // Convert all accumulated bytes to string at once (safe for multi-byte)
+            const tail = Buffer.concat(chunks, totalBytes).toString("utf-8");
+            // Find the last non-empty line
+            const lines = tail.split("\n");
+            for (let i = lines.length - 1; i >= 0; i--) {
+                const line = lines[i].trim();
+                if (line) {
+                    // If i > 0, we have a complete line (there's a newline before it)
+                    // If i === 0 and pos === 0, we've read the whole file — line is complete
+                    // If i === 0 and pos > 0, the line may be truncated — keep reading
+                    if (i > 0 || pos === 0)
+                        return line;
+                }
+            }
+        }
+        const tail = Buffer.concat(chunks, totalBytes).toString("utf-8");
+        return tail.trim() || null;
+    }
+    finally {
+        await fh.close();
+    }
+}
+/**
+ * Read the last entry from a JSONL file.
+ * Reads backwards from end of file — pure Node.js, no external binaries.
+ *
+ * @param filePath - Path to the JSONL file
+ * @returns Object containing the last entry's `type`, nested `payload.type` (Codex shape),
+ *          top-level `subtype` and `level` (Claude `system`-entry shape), and the file mtime.
+ *          Returns null if the file is empty or unreadable.
+ */
+async function readLastJsonlEntry(filePath) {
+    try {
+        const [line, fileStat] = await Promise.all([readLastLine(filePath), stat(filePath)]);
+        if (!line)
+            return null;
+        const parsed = JSON.parse(line);
+        if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+            const obj = parsed;
+            const lastType = typeof obj.type === "string" ? obj.type : null;
+            const lastSubtype = typeof obj.subtype === "string" ? obj.subtype : null;
+            const lastLevel = typeof obj.level === "string" ? obj.level : null;
+            let payloadType = null;
+            if (typeof obj.payload === "object" && obj.payload !== null && !Array.isArray(obj.payload)) {
+                const payload = obj.payload;
+                if (typeof payload.type === "string")
+                    payloadType = payload.type;
+            }
+            return { lastType, payloadType, lastSubtype, lastLevel, modifiedAt: fileStat.mtime };
+        }
+        return {
+            lastType: null,
+            payloadType: null,
+            lastSubtype: null,
+            lastLevel: null,
+            modifiedAt: fileStat.mtime,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Given a session ID and the orchestrator config, find which project it belongs
+ * to by matching session prefixes.
+ */
+function resolveProjectIdForSessionId(config, sessionId) {
+    for (const [projectId, project] of Object.entries(config.projects)) {
+        const prefix = project.sessionPrefix;
+        if (sessionId === prefix || sessionId.startsWith(`${prefix}-`)) {
+            return projectId;
+        }
+    }
+    return undefined;
+}
+
+export { escapeAppleScript, isGitBranchNameSafe, isRetryableHttpStatus, normalizeRetryConfig, readLastJsonlEntry, resolveProjectIdForSessionId, shellEscape, validateUrl };
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/dist/version-compare.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Channel-aware semver comparison for the AO release pipeline.
+ *
+ * Lives in core (not the CLI) because both the CLI's update-check and the
+ * dashboard's `/api/version` route compare versions and must stay in lockstep.
+ * Keeping the implementation here means there is exactly one tested copy.
+ *
+ * Spec: release-process.html §07 (Auto-update mechanics).
+ */
+import type { UpdateChannel } from "./global-config.js";
+export declare function isVersionOutdatedForChannel(current: string, latest: string, channel: UpdateChannel): boolean;
+/**
+ * Returns true if `current` is an older version than `latest`.
+ *
+ * Compares numeric major/minor/patch first, then handles prereleases:
+ *   - When base versions are equal:
+ *       prerelease vs stable     → prerelease is OLDER (`0.5.0-nightly < 0.5.0`)
+ *       prerelease vs prerelease → compare the prerelease identifiers
+ *                                  segment-by-segment (numeric or lexical),
+ *                                  so `0.5.0-nightly-abc < 0.5.0-nightly-def`
+ *                                  works for SHA-suffixed snapshots.
+ *
+ * Channel-aware comparison happens at the *cache layer* (callers only cache
+ * the tag they're tracking), so this function just answers: is current < latest?
+ */
+export declare function isVersionOutdated(current: string, latest: string): boolean;
+//# sourceMappingURL=version-compare.d.ts.map

package/dist/version-compare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-compare.d.ts","sourceRoot":"","sources":["../src/version-compare.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACrB,OAAO,CAYT;AAUD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAiB1E"}

package/dist/version-compare.js

@@ -0,0 +1,121 @@
+/**
+ * Channel-aware semver comparison for the AO release pipeline.
+ *
+ * Lives in core (not the CLI) because both the CLI's update-check and the
+ * dashboard's `/api/version` route compare versions and must stay in lockstep.
+ * Keeping the implementation here means there is exactly one tested copy.
+ *
+ * Spec: release-process.html §07 (Auto-update mechanics).
+ */
+function isVersionOutdatedForChannel(current, latest, channel) {
+    if (channel === "nightly") {
+        const currentParsed = parseVersion(current);
+        const latestParsed = parseVersion(latest);
+        if (isNightlyPrerelease(currentParsed.prerelease) &&
+            isNightlyPrerelease(latestParsed.prerelease)) {
+            return current !== latest;
+        }
+    }
+    return isVersionOutdated(current, latest);
+}
+function isNightlyPrerelease(prerelease) {
+    return (prerelease === "nightly" ||
+        prerelease?.startsWith("nightly-") === true ||
+        prerelease?.startsWith("nightly.") === true);
+}
+/**
+ * Returns true if `current` is an older version than `latest`.
+ *
+ * Compares numeric major/minor/patch first, then handles prereleases:
+ *   - When base versions are equal:
+ *       prerelease vs stable     → prerelease is OLDER (`0.5.0-nightly < 0.5.0`)
+ *       prerelease vs prerelease → compare the prerelease identifiers
+ *                                  segment-by-segment (numeric or lexical),
+ *                                  so `0.5.0-nightly-abc < 0.5.0-nightly-def`
+ *                                  works for SHA-suffixed snapshots.
+ *
+ * Channel-aware comparison happens at the *cache layer* (callers only cache
+ * the tag they're tracking), so this function just answers: is current < latest?
+ */
+function isVersionOutdated(current, latest) {
+    const c = parseVersion(current);
+    const l = parseVersion(latest);
+    for (let i = 0; i < 3; i++) {
+        const cp = c.parts[i] ?? 0;
+        const lp = l.parts[i] ?? 0;
+        if (Number.isNaN(cp) || Number.isNaN(lp))
+            return false;
+        if (cp < lp)
+            return true;
+        if (cp > lp)
+            return false;
+    }
+    // Numeric base equal — compare prerelease tags.
+    if (!c.prerelease && !l.prerelease)
+        return false;
+    if (c.prerelease && !l.prerelease)
+        return true; // prerelease < stable
+    if (!c.prerelease && l.prerelease)
+        return false; // stable > prerelease
+    return comparePrereleaseSegments(c.prerelease ?? "", l.prerelease ?? "") < 0;
+}
+function parseVersion(version) {
+    const [base, ...rest] = version.split("-");
+    const prerelease = rest.length > 0 ? rest.join("-") : undefined;
+    return {
+        parts: (base ?? "").split(".").map(Number),
+        prerelease,
+    };
+}
+/**
+ * Compare two prerelease identifiers segment-by-segment.
+ * Returns -1 if a < b, 0 if equal, 1 if a > b.
+ *
+ * Rules:
+ *   - Numeric segments compare numerically (`rc.1` < `rc.2`).
+ *   - Numeric < non-numeric (`0.5.0-1` < `0.5.0-alpha`).
+ *   - Longer prerelease wins when all shared segments are equal
+ *     (`0.5.0-nightly` < `0.5.0-nightly.1`).
+ *   - **Differing non-numeric segments → treat current as older.** Git SHAs
+ *     are uniformly random hex, so a lexical compare (`'f' < '0'`) gives the
+ *     wrong answer ~50% of the time for snapshot tags like `nightly-<sha>`.
+ *     The cache layer always carries the registry's CURRENT dist-tag, so a
+ *     mismatch here means the installed copy is behind by construction —
+ *     return -1 unconditionally for non-numeric differences so the update
+ *     banner surfaces. (Caveat: this would over-fire if a user manually
+ *     installed `0.5.0-beta` when the registry only has `0.5.0-alpha`. AO's
+ *     release pipeline only emits SHA-suffixed nightly prereleases, so the
+ *     scenario doesn't occur in practice.)
+ */
+function comparePrereleaseSegments(a, b) {
+    const aSeg = a.split(".");
+    const bSeg = b.split(".");
+    const max = Math.max(aSeg.length, bSeg.length);
+    for (let i = 0; i < max; i++) {
+        const ax = aSeg[i];
+        const bx = bSeg[i];
+        if (ax === undefined)
+            return -1;
+        if (bx === undefined)
+            return 1;
+        const aNum = /^\d+$/.test(ax);
+        const bNum = /^\d+$/.test(bx);
+        if (aNum && bNum) {
+            const an = Number(ax);
+            const bn = Number(bx);
+            if (an !== bn)
+                return an < bn ? -1 : 1;
+        }
+        else if (aNum !== bNum) {
+            return aNum ? -1 : 1; // numeric < non-numeric
+        }
+        else if (ax !== bx) {
+            // Both non-numeric and differ. Cannot reliably order — return "older."
+            return -1;
+        }
+    }
+    return 0;
+}
+
+export { isVersionOutdated, isVersionOutdatedForChannel };
+//# sourceMappingURL=version-compare.js.map

package/dist/version-compare.js.map

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

package/dist/windows-pty-registry.d.ts

@@ -0,0 +1,27 @@
+export interface WindowsPtyHostEntry {
+    sessionId: string;
+    ptyHostPid: number;
+    pipePath: string;
+    registeredAt: string;
+}
+/**
+ * Add (or replace) an entry for a freshly-spawned pty-host.
+ * If a stale entry for the same `sessionId` exists, it's overwritten.
+ */
+export declare function registerWindowsPtyHost(entry: Omit<WindowsPtyHostEntry, "registeredAt">): void;
+/**
+ * Remove an entry by `sessionId`. No-op if absent.
+ */
+export declare function unregisterWindowsPtyHost(sessionId: string): void;
+/**
+ * Read all live entries, auto-pruning entries whose PID is no longer alive.
+ * The on-disk file is rewritten if any entries were pruned.
+ */
+export declare function getWindowsPtyHosts(): WindowsPtyHostEntry[];
+/**
+ * Best-effort: delete the entire registry file. Used for tests and recovery.
+ */
+export declare function clearWindowsPtyHostRegistry(): void;
+/** Exported for tests. */
+export declare function __getWindowsPtyRegistryFile(): string;
+//# sourceMappingURL=windows-pty-registry.d.ts.map

package/dist/windows-pty-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-pty-registry.d.ts","sourceRoot":"","sources":["../src/windows-pty-registry.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAiDD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,cAAc,CAAC,GAAG,IAAI,CAI7F;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAKhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,EAAE,CAK1D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AAED,0BAA0B;AAC1B,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD"}