@made-by-moonlight/athene-core 0.9.1

package/dist/opencode-session-id.js

@@ -0,0 +1,12 @@
+const OPENCODE_SESSION_ID_RE = /^ses_[A-Za-z0-9_-]+$/;
+function asValidOpenCodeSessionId(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    return OPENCODE_SESSION_ID_RE.test(trimmed) ? trimmed : undefined;
+}
+
+export { asValidOpenCodeSessionId };
+//# sourceMappingURL=opencode-session-id.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-session-id.js","sources":["../src/opencode-session-id.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA,MAAM,sBAAsB,GAAG,sBAAsB;AAE/C,SAAU,wBAAwB,CAAC,KAAc,EAAA;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ;AAAE,QAAA,OAAO,SAAS;AAC/C,IAAA,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE;AAC5B,IAAA,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;AAAE,QAAA,OAAO,SAAS;AAC1C,IAAA,OAAO,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,SAAS;AACnE;;;;"}

package/dist/opencode-shared.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Shared opencode-child plumbing.
+ *
+ * This module exists for two reasons:
+ *
+ * 1. **Bounded /tmp blast radius** (issue #1046, PR #1478 review).
+ *    Bun-bundled binaries leak `.so`/`.dylib` files into the system temp
+ *    directory and never unlink them. Rather than sweeping all of `/tmp`
+ *    with a regex (which would touch other users' or other apps' Bun
+ *    artifacts), we point every `opencode` child at an AO-owned temp dir
+ *    via `TMPDIR`. The cli-side janitor then sweeps only that directory.
+ *
+ * 2. **Single shared cache for `opencode session list`.**
+ *    Both `@made-by-moonlight/athene-core` and the `agent-opencode` plugin previously
+ *    kept independent module-level caches. Per poll cycle the system
+ *    therefore spawned at least two `opencode session list` processes
+ *    instead of one. A single cache exported from core collapses them.
+ */
+/**
+ * Path that opencode children should treat as `TMPDIR`. Lives under the AO
+ * base dir so a stray sweep cannot touch unrelated files.
+ */
+export declare function getOpenCodeTmpDir(): string;
+/**
+ * Best-effort: create the AO-owned temp dir. Spawn paths call this before
+ * launching opencode so the child sees a real directory at `TMPDIR`.
+ *
+ * Synchronous because the spawn helpers are themselves synchronous in their
+ * env construction. Failures are swallowed — opencode will fall back to the
+ * OS default temp dir, which is the pre-PR behavior.
+ */
+export declare function ensureOpenCodeTmpDir(): string;
+/**
+ * Build the env passed to every spawned `opencode` child.
+ *
+ * Setting both `TMPDIR` and `TMP`/`TEMP` covers POSIX (TMPDIR) and Windows
+ * fallbacks. Bun honors `TMPDIR` for its embedded shared-library extraction.
+ */
+export declare function getOpenCodeChildEnv(extra?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+export interface OpenCodeSessionListEntry {
+    id: string;
+    title: string;
+    /** Raw `updated` field as emitted by opencode (string or number). */
+    updated?: string | number;
+    /** Normalized epoch ms, parsed from `updated`. */
+    updatedAt?: number;
+}
+/**
+ * TTL for the `opencode session list` cache.
+ *
+ * **Why 500ms.** The send-confirmation loop in `session-manager.sendMessage`
+ * polls at 500ms intervals up to 6 times (~3s total). The original PR sized
+ * the TTL to *cover* that window (3s), which made every loop iteration return
+ * the same cached snapshot — the `updatedAt > baselineUpdatedAt` delivery
+ * signal could not fire by construction. Sizing the TTL at 500ms means each
+ * poll iteration sees fresh data while still collapsing tight bursts (e.g.
+ * lifecycle poll + UI enrichment in the same tick) onto a single child.
+ * Concurrent callers always share the in-flight promise regardless of TTL.
+ */
+export declare const OPENCODE_SESSION_LIST_CACHE_TTL_MS = 500;
+/**
+ * Fetch the opencode session list, sharing both the cached snapshot and any
+ * in-flight request across all callers in core and plugins.
+ *
+ * Pass `forceRefresh: true` to bypass the TTL when a write is known to have
+ * just landed. Concurrent callers still collapse onto the in-flight promise.
+ */
+export declare function getCachedOpenCodeSessionList(options?: {
+    timeoutMs?: number;
+    forceRefresh?: boolean;
+}): Promise<OpenCodeSessionListEntry[]>;
+/**
+ * Drop any cached snapshot. Call this immediately after any code path that
+ * mutates opencode session state (delete, create) so that the next reader
+ * does not observe a stale entry.
+ */
+export declare function invalidateOpenCodeSessionListCache(): void;
+/** Test-only: clear the cache including any in-flight promise. */
+export declare function resetOpenCodeSessionListCache(): void;
+//# sourceMappingURL=opencode-shared.d.ts.map

package/dist/opencode-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-shared.d.ts","sourceRoot":"","sources":["../src/opencode-shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAmBH;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAI1C;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAS7C;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,GACxB,MAAM,CAAC,UAAU,CASnB;AAMD,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kCAAkC,MAAM,CAAC;AAoDtD;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAAC,OAAO,CAAC,EAAE;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC,CA8CtC;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,IAAI,IAAI,CAWzD;AAED,kEAAkE;AAClE,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}

package/dist/opencode-shared.js

@@ -0,0 +1,202 @@
+import { execFile } from 'node:child_process';
+import { mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { promisify } from 'node:util';
+import { getAoBaseDir } from './paths.js';
+import { safeJsonParse } from './utils/validation.js';
+import { asValidOpenCodeSessionId } from './opencode-session-id.js';
+
+/**
+ * Shared opencode-child plumbing.
+ *
+ * This module exists for two reasons:
+ *
+ * 1. **Bounded /tmp blast radius** (issue #1046, PR #1478 review).
+ *    Bun-bundled binaries leak `.so`/`.dylib` files into the system temp
+ *    directory and never unlink them. Rather than sweeping all of `/tmp`
+ *    with a regex (which would touch other users' or other apps' Bun
+ *    artifacts), we point every `opencode` child at an AO-owned temp dir
+ *    via `TMPDIR`. The cli-side janitor then sweeps only that directory.
+ *
+ * 2. **Single shared cache for `opencode session list`.**
+ *    Both `@made-by-moonlight/athene-core` and the `agent-opencode` plugin previously
+ *    kept independent module-level caches. Per poll cycle the system
+ *    therefore spawned at least two `opencode session list` processes
+ *    instead of one. A single cache exported from core collapses them.
+ */
+const execFileAsync = promisify(execFile);
+// -----------------------------------------------------------------------------
+// AO-owned temp dir for opencode children
+// -----------------------------------------------------------------------------
+let cachedOpenCodeTmpDir = null;
+/**
+ * Path that opencode children should treat as `TMPDIR`. Lives under the AO
+ * base dir so a stray sweep cannot touch unrelated files.
+ */
+function getOpenCodeTmpDir() {
+    if (cachedOpenCodeTmpDir)
+        return cachedOpenCodeTmpDir;
+    cachedOpenCodeTmpDir = join(getAoBaseDir(), ".bun-tmp");
+    return cachedOpenCodeTmpDir;
+}
+/**
+ * Best-effort: create the AO-owned temp dir. Spawn paths call this before
+ * launching opencode so the child sees a real directory at `TMPDIR`.
+ *
+ * Synchronous because the spawn helpers are themselves synchronous in their
+ * env construction. Failures are swallowed — opencode will fall back to the
+ * OS default temp dir, which is the pre-PR behavior.
+ */
+function ensureOpenCodeTmpDir() {
+    const dir = getOpenCodeTmpDir();
+    try {
+        mkdirSync(dir, { recursive: true });
+    }
+    catch {
+        // Best-effort. If creation fails opencode still works; we just leak to
+        // the system temp dir as before.
+    }
+    return dir;
+}
+/**
+ * Build the env passed to every spawned `opencode` child.
+ *
+ * Setting both `TMPDIR` and `TMP`/`TEMP` covers POSIX (TMPDIR) and Windows
+ * fallbacks. Bun honors `TMPDIR` for its embedded shared-library extraction.
+ */
+function getOpenCodeChildEnv(extra) {
+    const dir = ensureOpenCodeTmpDir();
+    return {
+        ...process.env,
+        TMPDIR: dir,
+        TMP: dir,
+        TEMP: dir,
+        ...extra,
+    };
+}
+/**
+ * TTL for the `opencode session list` cache.
+ *
+ * **Why 500ms.** The send-confirmation loop in `session-manager.sendMessage`
+ * polls at 500ms intervals up to 6 times (~3s total). The original PR sized
+ * the TTL to *cover* that window (3s), which made every loop iteration return
+ * the same cached snapshot — the `updatedAt > baselineUpdatedAt` delivery
+ * signal could not fire by construction. Sizing the TTL at 500ms means each
+ * poll iteration sees fresh data while still collapsing tight bursts (e.g.
+ * lifecycle poll + UI enrichment in the same tick) onto a single child.
+ * Concurrent callers always share the in-flight promise regardless of TTL.
+ */
+const OPENCODE_SESSION_LIST_CACHE_TTL_MS = 500;
+const OPENCODE_SESSION_LIST_DEFAULT_TIMEOUT_MS = 30_000;
+let sessionListCache = null;
+function parseUpdatedToEpochMs(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return value;
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    if (trimmed.length === 0)
+        return undefined;
+    if (/^\d+$/.test(trimmed)) {
+        const n = Number(trimmed);
+        return Number.isFinite(n) ? n : undefined;
+    }
+    const parsed = Date.parse(trimmed);
+    return Number.isNaN(parsed) ? undefined : parsed;
+}
+function parseSessionListStdout(stdout) {
+    const parsed = safeJsonParse(stdout);
+    if (!Array.isArray(parsed))
+        return [];
+    return parsed.flatMap((entry) => {
+        if (!entry || typeof entry !== "object")
+            return [];
+        const record = entry;
+        const id = asValidOpenCodeSessionId(record["id"]);
+        if (!id)
+            return [];
+        const title = typeof record["title"] === "string" ? record["title"] : "";
+        const rawUpdated = record["updated"];
+        const updated = typeof rawUpdated === "string" || typeof rawUpdated === "number"
+            ? rawUpdated
+            : undefined;
+        const updatedAt = parseUpdatedToEpochMs(rawUpdated);
+        return [
+            {
+                id,
+                title,
+                ...(updated !== undefined ? { updated } : {}),
+                ...(updatedAt !== undefined ? { updatedAt } : {}),
+            },
+        ];
+    });
+}
+/**
+ * Fetch the opencode session list, sharing both the cached snapshot and any
+ * in-flight request across all callers in core and plugins.
+ *
+ * Pass `forceRefresh: true` to bypass the TTL when a write is known to have
+ * just landed. Concurrent callers still collapse onto the in-flight promise.
+ */
+async function getCachedOpenCodeSessionList(options) {
+    const timeoutMs = options?.timeoutMs ?? OPENCODE_SESSION_LIST_DEFAULT_TIMEOUT_MS;
+    const forceRefresh = options?.forceRefresh ?? false;
+    const now = Date.now();
+    if (sessionListCache) {
+        if (sessionListCache.promise) {
+            // A fetch is already in flight — every caller waits on it, even if
+            // they wanted a refresh.
+            return sessionListCache.promise;
+        }
+        if (!forceRefresh &&
+            now - sessionListCache.timestamp < OPENCODE_SESSION_LIST_CACHE_TTL_MS) {
+            return sessionListCache.entries;
+        }
+    }
+    const promise = execFileAsync("opencode", ["session", "list", "--format", "json"], {
+        timeout: timeoutMs,
+        env: getOpenCodeChildEnv(),
+        // On Windows, execFile cannot resolve .cmd shim extensions without
+        // invoking the shell; windowsHide:true suppresses the conhost popup.
+        ...(process.platform === "win32" ? { shell: true, windowsHide: true } : {}),
+    })
+        .then(({ stdout }) => {
+        const entries = parseSessionListStdout(stdout);
+        if (sessionListCache?.promise === promise) {
+            sessionListCache = { entries, timestamp: Date.now() };
+        }
+        return entries;
+    })
+        .catch(() => {
+        if (sessionListCache?.promise === promise) {
+            sessionListCache = null;
+        }
+        return [];
+    });
+    sessionListCache = { entries: [], timestamp: now, promise };
+    return promise;
+}
+/**
+ * Drop any cached snapshot. Call this immediately after any code path that
+ * mutates opencode session state (delete, create) so that the next reader
+ * does not observe a stale entry.
+ */
+function invalidateOpenCodeSessionListCache() {
+    // If a fetch is currently in flight we leave it alone — its result is
+    // about to land and a fresh fetch on top of it would be wasted work.
+    // Subsequent callers will see a stale snapshot for at most one tick;
+    // this is acceptable because the in-flight result already reflects state
+    // captured after the mutation began.
+    if (sessionListCache?.promise) {
+        sessionListCache = { ...sessionListCache, timestamp: 0 };
+        return;
+    }
+    sessionListCache = null;
+}
+/** Test-only: clear the cache including any in-flight promise. */
+function resetOpenCodeSessionListCache() {
+    sessionListCache = null;
+}
+
+export { OPENCODE_SESSION_LIST_CACHE_TTL_MS, ensureOpenCodeTmpDir, getCachedOpenCodeSessionList, getOpenCodeChildEnv, getOpenCodeTmpDir, invalidateOpenCodeSessionListCache, resetOpenCodeSessionListCache };
+//# sourceMappingURL=opencode-shared.js.map

package/dist/opencode-shared.js.map

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

package/dist/orchestrator-prompt.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Orchestrator Prompt Generator - generates orchestrator prompt content.
+ *
+ * This is injected via `athene start` to provide orchestrator-specific context
+ * when the orchestrator agent runs.
+ */
+import type { OrchestratorConfig, ProjectConfig } from "./types.js";
+export interface OrchestratorPromptConfig {
+    config: OrchestratorConfig;
+    projectId: string;
+    project: ProjectConfig;
+}
+/**
+ * Generate orchestrator prompt content.
+ * Provides orchestrator agent with context about available commands,
+ * session management workflows, and project configuration.
+ */
+export declare function generateOrchestratorPrompt(opts: OrchestratorPromptConfig): string;
+//# sourceMappingURL=orchestrator-prompt.d.ts.map

package/dist/orchestrator-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-prompt.d.ts","sourceRoot":"","sources":["../src/orchestrator-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpE,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;CACxB;AAyKD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,wBAAwB,GAAG,MAAM,CAUjF"}

package/dist/orchestrator-prompt.js

@@ -0,0 +1,130 @@
+import orchestratorTemplate from './prompts/orchestrator.md.js';
+
+/**
+ * Orchestrator Prompt Generator - generates orchestrator prompt content.
+ *
+ * This is injected via `athene start` to provide orchestrator-specific context
+ * when the orchestrator agent runs.
+ */
+function buildAutomatedReactionsSection(project) {
+    const markdownBold = String.fromCharCode(42).repeat(2);
+    const bold = (text) => `${markdownBold}${text}${markdownBold}`;
+    const reactionLines = [];
+    for (const [event, reaction] of Object.entries(project.reactions ?? {})) {
+        if (reaction.auto && reaction.action === "send-to-agent") {
+            reactionLines.push(`- ${bold(event)}: Auto-sends instruction to agent (retries: ${reaction.retries ?? "none"}, escalates after: ${reaction.escalateAfter ?? "never"})`);
+            continue;
+        }
+        if (reaction.auto && reaction.action === "notify") {
+            reactionLines.push(`- ${bold(event)}: Notifies human (priority: ${reaction.priority ?? "info"})`);
+        }
+    }
+    if (reactionLines.length === 0) {
+        return "";
+    }
+    return reactionLines.join("\n");
+}
+function buildProjectSpecificRulesSection(project) {
+    const rules = project.orchestratorRules?.trim();
+    if (!rules) {
+        return "";
+    }
+    return rules;
+}
+function removeOptionalSectionBlocks(template, data) {
+    const templates = [
+        ["REPO_CONFIGURED_SECTION_START", "REPO_CONFIGURED_SECTION_END", data.repoConfiguredSection],
+        ["REPO_NOT_CONFIGURED_SECTION_START", "REPO_NOT_CONFIGURED_SECTION_END", data.repoNotConfiguredSection],
+        ["AUTOMATED_REACTIONS_SECTION_START", "AUTOMATED_REACTIONS_SECTION_END", data.automatedReactionsSection],
+        ["PROJECT_SPECIFIC_RULES_SECTION_START", "PROJECT_SPECIFIC_RULES_SECTION_END", data.projectSpecificRulesSection],
+    ];
+    let interpolated = template;
+    for (const [startKey, endKey, section] of templates) {
+        const startMarker = `{{${startKey}}}`;
+        const endMarker = `{{${endKey}}}`;
+        while (true) {
+            const start = interpolated.indexOf(startMarker);
+            const end = interpolated.indexOf(endMarker);
+            if (start === -1 && end === -1) {
+                break;
+            }
+            if (start === -1 || end === -1 || end < start) {
+                throw new Error(`Malformed optional section block: expected ${startMarker} before ${endMarker}`);
+            }
+            const fullStart = start;
+            const fullEnd = end + endMarker.length;
+            const blockContent = interpolated.slice(start + startMarker.length, end);
+            // Optional sections are flat by design. Reject nesting of the same block
+            // type so future template edits fail loudly instead of matching ambiguously.
+            if (blockContent.includes(startMarker)) {
+                throw new Error(`Nested optional section blocks are not supported: ${startMarker} before ${endMarker}`);
+            }
+            const replacement = section ? blockContent : "";
+            const before = interpolated.slice(0, fullStart);
+            const after = interpolated.slice(fullEnd);
+            interpolated = replacement
+                ? before + replacement + after
+                : collapseOptionalGap(before, after);
+        }
+    }
+    return interpolated;
+}
+function collapseOptionalGap(before, after) {
+    const trailingNewlines = before.match(/\n*$/)?.[0] ?? "";
+    const leadingNewlines = after.match(/^\n*/)?.[0] ?? "";
+    const totalNewlines = trailingNewlines.length + leadingNewlines.length;
+    const boundary = totalNewlines >= 2 ? "\n\n" : trailingNewlines + leadingNewlines;
+    return (before.slice(0, before.length - trailingNewlines.length) +
+        boundary +
+        after.slice(leadingNewlines.length));
+}
+function hasRenderDataKey(data, key) {
+    return Object.prototype.hasOwnProperty.call(data, key);
+}
+function createRenderData(opts) {
+    const { config, projectId, project } = opts;
+    const hasRepo = Boolean(project.repo);
+    return {
+        projectId,
+        projectName: project.name,
+        projectRepo: project.repo ?? "not configured",
+        projectDefaultBranch: project.defaultBranch,
+        projectSessionPrefix: project.sessionPrefix,
+        projectPath: project.path,
+        dashboardPort: String(config.port ?? 3000),
+        automatedReactionsSection: buildAutomatedReactionsSection(project),
+        projectSpecificRulesSection: buildProjectSpecificRulesSection(project),
+        repoConfiguredSection: hasRepo ? "true" : "",
+        repoNotConfiguredSection: hasRepo ? "" : "true",
+    };
+}
+function renderTemplate(template, data) {
+    const unresolvedPlaceholder = template
+        .replace(/\{\{([a-zA-Z0-9_]+)\}\}/g, "")
+        .match(/\{\{[^}]+\}\}/);
+    if (unresolvedPlaceholder) {
+        throw new Error(`Unresolved template placeholder: ${unresolvedPlaceholder[0]}`);
+    }
+    return template.replace(/\{\{([a-zA-Z0-9_]+)\}\}/g, (_match, rawKey) => {
+        if (!hasRenderDataKey(data, rawKey)) {
+            throw new Error(`Unresolved template placeholder: ${rawKey}`);
+        }
+        return data[rawKey];
+    });
+}
+function finalizeRenderedPrompt(prompt) {
+    return prompt.trim();
+}
+/**
+ * Generate orchestrator prompt content.
+ * Provides orchestrator agent with context about available commands,
+ * session management workflows, and project configuration.
+ */
+function generateOrchestratorPrompt(opts) {
+    const data = createRenderData(opts);
+    const templateWithOptionalSections = removeOptionalSectionBlocks(orchestratorTemplate.trim(), data);
+    return finalizeRenderedPrompt(renderTemplate(templateWithOptionalSections, data));
+}
+
+export { generateOrchestratorPrompt };
+//# sourceMappingURL=orchestrator-prompt.js.map

package/dist/orchestrator-prompt.js.map

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

package/dist/orchestrator-session-strategy.d.ts

@@ -0,0 +1,5 @@
+import type { ProjectConfig } from "./types.js";
+export type NormalizedOrchestratorSessionStrategy = "reuse" | "delete" | "ignore";
+export declare function getOrchestratorSessionId(project: Pick<ProjectConfig, "sessionPrefix">): string;
+export declare function normalizeOrchestratorSessionStrategy(strategy: ProjectConfig["orchestratorSessionStrategy"] | undefined): NormalizedOrchestratorSessionStrategy;
+//# sourceMappingURL=orchestrator-session-strategy.d.ts.map

package/dist/orchestrator-session-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-session-strategy.d.ts","sourceRoot":"","sources":["../src/orchestrator-session-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,MAAM,qCAAqC,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAElF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,GAAG,MAAM,CAE9F;AAED,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,aAAa,CAAC,6BAA6B,CAAC,GAAG,SAAS,GACjE,qCAAqC,CAIvC"}

package/dist/orchestrator-session-strategy.js

@@ -0,0 +1,13 @@
+function getOrchestratorSessionId(project) {
+    return `${project.sessionPrefix}-orchestrator`;
+}
+function normalizeOrchestratorSessionStrategy(strategy) {
+    if (strategy === "kill-previous" || strategy === "delete-new")
+        return "delete";
+    if (strategy === "ignore-new")
+        return "ignore";
+    return strategy ?? "reuse";
+}
+
+export { getOrchestratorSessionId, normalizeOrchestratorSessionStrategy };
+//# sourceMappingURL=orchestrator-session-strategy.js.map

package/dist/orchestrator-session-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator-session-strategy.js","sources":["../src/orchestrator-session-strategy.ts"],"sourcesContent":[null],"names":[],"mappings":"AAIM,SAAU,wBAAwB,CAAC,OAA6C,EAAA;AACpF,IAAA,OAAO,CAAA,EAAG,OAAO,CAAC,aAAa,eAAe;AAChD;AAEM,SAAU,oCAAoC,CAClD,QAAkE,EAAA;AAElE,IAAA,IAAI,QAAQ,KAAK,eAAe,IAAI,QAAQ,KAAK,YAAY;AAAE,QAAA,OAAO,QAAQ;IAC9E,IAAI,QAAQ,KAAK,YAAY;AAAE,QAAA,OAAO,QAAQ;IAC9C,OAAO,QAAQ,IAAI,OAAO;AAC5B;;;;"}

package/dist/paths.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Path utilities for the AO storage directory structure.
+ *
+ * V2 layout (projects/{projectId}/):
+ *   getProjectDir(projectId)          → ~/.agent-orchestrator/projects/{projectId}
+ *   getProjectSessionsDir(projectId)  → .../projects/{projectId}/sessions
+ *   getProjectWorktreesDir(projectId) → .../projects/{projectId}/worktrees
+ *   getOrchestratorPath(projectId)    → .../projects/{projectId}/orchestrator.json
+ *   getSessionPath(projectId, sid)    → .../projects/{projectId}/sessions/{sid}.json
+ *
+ * Legacy layout ({storageKey}/):
+ *   getProjectBaseDir(storageKey)     → ~/.agent-orchestrator/{storageKey}
+ *   getSessionsDir(storageKey)        → ~/.agent-orchestrator/{storageKey}/sessions
+ *   ... (deprecated, kept for migration only)
+ */
+/**
+ * Generate a 12-character hash from a config directory path.
+ *
+ * The hash is derived from dirname(configPath), which equals the project root
+ * directory when configPath is <project>/agent-orchestrator.yaml.
+ *
+ * Handles non-existent paths gracefully (e.g. synthesized paths in remote/
+ * Docker mode where no local config file exists) by falling back to
+ * resolve() when realpathSync fails.
+ */
+export declare function generateConfigHash(configPath: string): string;
+/**
+ * Generate project ID from project path (basename of the path).
+ * Example: ~/repos/integrator → "integrator"
+ *
+ * @deprecated New project registrations use generateExternalId() from global-config.ts.
+ */
+export declare function generateProjectId(projectPath: string): string;
+/**
+ * Generate session prefix from project ID using clean heuristics.
+ *
+ * Rules:
+ * 1. ≤4 chars: use as-is (lowercase)
+ * 2. CamelCase: extract uppercase letters (PyTorch → pt)
+ * 3. kebab/snake case: use initials (agent-orchestrator → ao)
+ * 4. Single word: first 3 chars (integrator → int)
+ */
+export declare function generateSessionPrefix(projectId: string): string;
+/** Get the project directory by project ID. */
+export declare function getProjectDir(projectId: string): string;
+/** Get the sessions directory for a project (workers only). */
+export declare function getProjectSessionsDir(projectId: string): string;
+/** Get the worktrees directory for a project. */
+export declare function getProjectWorktreesDir(projectId: string): string;
+/** Get the AO-local code review store directory for a project. */
+export declare function getProjectCodeReviewsDir(projectId: string): string;
+/** Get the feedback reports directory for a project (V2 layout). */
+export declare function getProjectFeedbackReportsDir(projectId: string): string;
+/** Get the orchestrator metadata file path for a project. */
+export declare function getOrchestratorPath(projectId: string): string;
+/** Get the session metadata file path (.json). */
+export declare function getSessionPath(projectId: string, sessionId: string): string;
+/**
+ * @deprecated Use getProjectDir(projectId) instead.
+ * Get the project base directory for a storage key.
+ * Format: ~/.agent-orchestrator/{storageKey}
+ */
+export declare function getProjectBaseDir(storageKey: string | undefined): string;
+/**
+ * Get the shared observability base directory for a config.
+ * Format: ~/.agent-orchestrator/{hash}-observability
+ */
+export declare function getObservabilityBaseDir(configPath: string): string;
+/**
+ * @deprecated Use getProjectSessionsDir(projectId) instead.
+ * Get the sessions directory for a project.
+ */
+export declare function getSessionsDir(storageKey: string | undefined): string;
+/**
+ * @deprecated Use getProjectWorktreesDir(projectId) instead.
+ * Get the worktrees directory for a project.
+ */
+export declare function getWorktreesDir(storageKey: string | undefined): string;
+/**
+ * @deprecated Use getProjectFeedbackReportsDir(projectId) instead.
+ * Get the feedback reports directory for a project.
+ */
+export declare function getFeedbackReportsDir(storageKey: string | undefined): string;
+/**
+ * @deprecated Legacy archive directory — archive system removed.
+ * Get the archive directory for a project (legacy: nested inside sessions/).
+ */
+export declare function getArchiveDir(storageKey: string | undefined): string;
+/**
+ * @deprecated No longer needed — collision detection by storageKey is removed.
+ * Get the .origin file path for a project.
+ */
+export declare function getOriginFilePath(storageKey: string | undefined): string;
+/**
+ * Generate user-facing session name.
+ * Format: {prefix}-{num}
+ * Example: "int-1", "ao-42"
+ */
+export declare function generateSessionName(prefix: string, num: number): string;
+/**
+ * @deprecated Session prefixes are globally unique — hash prefix is no longer needed.
+ * Use generateSessionName(prefix, num) instead (same output as the new tmux name).
+ *
+ * Generate tmux session name (legacy format with hash).
+ * Format: {storageKey}-{prefix}-{num}
+ * Example: "a3b4c5d6e7f8-int-1"
+ */
+export declare function generateTmuxName(storageKey: string | undefined, prefix: string, num: number): string;
+/**
+ * @deprecated Use parseTmuxNameV2 instead.
+ * Parse a legacy tmux session name (with hash prefix).
+ */
+export declare function parseTmuxName(tmuxName: string): {
+    hash: string;
+    prefix: string;
+    num: number;
+} | null;
+/**
+ * Parse a V2 tmux session name (no hash prefix, same as session name).
+ * Format: {prefix}-{num} e.g. "ao-84", "my-app-1"
+ * Prefix must match sessionPrefix validation: [a-zA-Z0-9_-]+
+ */
+export declare function parseTmuxNameV2(tmuxName: string): {
+    prefix: string;
+    num: number;
+} | null;
+/**
+ * Expand ~ to home directory.
+ */
+export declare function expandHome(filepath: string): string;
+/** Get the base AO directory (~/.agent-orchestrator/) */
+export declare function getAoBaseDir(): string;
+/** Get the portfolio directory (~/.agent-orchestrator/portfolio/) */
+export declare function getPortfolioDir(): string;
+/** Get the portfolio preferences file path */
+export declare function getPreferencesPath(): string;
+/** Get the portfolio registered projects file path */
+export declare function getRegisteredPath(): string;
+/**
+ * @deprecated No longer needed — storageKey and .origin collision detection are removed.
+ * Validate and store the .origin file for a project.
+ */
+export declare function validateAndStoreOrigin(configPath: string, storageKey: string): void;
+export declare function requireStorageKey(storageKey: string | undefined): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

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