opencode-subagent-magazine 1.5.2 → 1.6.0-beta.1

package/dist/core/kv.js

@@ -0,0 +1,30 @@
+export const KV_PREFIX = "subagent_magazine";
+export const SESSION_DATA_KEY = `${KV_PREFIX}.session_data`;
+/** Setting keys shared by V1/V2 (values are raw strings in KV). */
+export const SETTING_KEYS = {
+    lang: `${KV_PREFIX}.lang`,
+    maxEntries: `${KV_PREFIX}.max_entries`,
+    order: `${KV_PREFIX}.order`,
+    scrollMode: `${KV_PREFIX}.scroll_mode`,
+    open: `${KV_PREFIX}.open`,
+    ttlDays: `${KV_PREFIX}.ttl_days`,
+};
+export function loadSessionData(kv) {
+    try {
+        const raw = kv.get(SESSION_DATA_KEY, "{}");
+        return JSON.parse(String(raw));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveSessionData(kv, data) {
+    try {
+        kv.set(SESSION_DATA_KEY, JSON.stringify(data));
+    }
+    catch { }
+}
+export function readTTLDays(kv) {
+    const ttlDaysRaw = parseInt(String(kv.get(SETTING_KEYS.ttlDays, "3")), 10);
+    return Number.isNaN(ttlDaysRaw) ? 3 : ttlDaysRaw;
+}

package/dist/core/state-machine.d.ts

@@ -0,0 +1,17 @@
+import type { SubEntry, SubStatus } from "./types";
+import type { TodoStats } from "./usage";
+/** Final status decision when a child session settles (V1 `session.idle` semantics). */
+export declare function settleOnIdle(entry: SubEntry): SubStatus;
+/** Agent-name normalization used by the fallback matching chain. */
+export declare function normalizeAgent(s: string): string;
+/** Snapshot of usage values captured when a child session settles. */
+export interface SettleSnapshot {
+    tokens?: number;
+    cost?: number;
+    model?: string;
+    todo?: TodoStats;
+}
+/** Apply a settled status + usage backfill onto an entry (no-op preserving already-settled). */
+export declare function settleEntry(entry: SubEntry, targetStatus: SubStatus, nowTs: number, snap: SettleSnapshot, errorMsg?: string): SubEntry;
+/** Time-based scan heuristic: how old must a running entry be before assuming completion. */
+export declare const STALE_RUNNING_MS: number;

package/dist/core/state-machine.js

@@ -0,0 +1,27 @@
+/** Final status decision when a child session settles (V1 `session.idle` semantics). */
+export function settleOnIdle(entry) {
+    if (entry.status === "cancel_requested" && entry.abortAccepted)
+        return "cancelled";
+    return "done";
+}
+/** Agent-name normalization used by the fallback matching chain. */
+export function normalizeAgent(s) {
+    return s.toLowerCase().replace(/[^a-z0-9-]/g, "");
+}
+/** Apply a settled status + usage backfill onto an entry (no-op preserving already-settled). */
+export function settleEntry(entry, targetStatus, nowTs, snap, errorMsg) {
+    const alreadySettled = entry.status !== "running" && entry.status !== "cancel_requested";
+    const finalStatus = targetStatus === "error" ? "error" : settleOnIdle(entry);
+    return {
+        ...entry,
+        ...(alreadySettled ? {} : { status: finalStatus, endedAt: nowTs }),
+        tokens: entry.tokens ?? snap.tokens,
+        cost: entry.cost ?? snap.cost,
+        model: entry.model ?? snap.model,
+        todoTotal: entry.todoTotal ?? snap.todo?.total,
+        todoDone: entry.todoDone ?? snap.todo?.done,
+        error: errorMsg || entry.error,
+    };
+}
+/** Time-based scan heuristic: how old must a running entry be before assuming completion. */
+export const STALE_RUNNING_MS = 30 * 60 * 1000;

package/dist/core/types.d.ts

@@ -0,0 +1,51 @@
+import type { LangCode } from "../i18n";
+export type SubStatus = "running" | "done" | "error" | "cancel_requested" | "cancelled";
+export interface SubEntry {
+    id: string;
+    title: string;
+    agent: string;
+    prompt: string;
+    error?: string;
+    tokens?: number;
+    cost?: number;
+    status: SubStatus;
+    sessionId?: string;
+    startedAt: number;
+    endedAt?: number;
+    model?: string;
+    todoTotal?: number;
+    todoDone?: number;
+    cancelRequestedAt?: number;
+    abortAccepted?: boolean;
+    cancelReason?: "manual";
+}
+export type Lang = LangCode;
+export type SortOrder = "desc" | "asc";
+export type ScrollMode = "wheel" | "click";
+/** OpenCode built-in tool names that spawn sub-agents or delegate tasks. */
+export declare const SUBAGENT_TOOLS: Set<string>;
+export interface ChildRecord {
+    scroll: number;
+    expanded: string;
+    entries: SubEntry[];
+    clearedIds?: string[];
+}
+export interface SessionRecord {
+    ts: number;
+    entries: SubEntry[];
+    scroll: number;
+    expanded: string;
+    children: Record<string, ChildRecord>;
+    clearedIds?: string[];
+}
+export interface SharedSignals {
+    lang: () => Lang;
+    setLang: (l: Lang) => void;
+    maxEntries: () => number;
+    setMaxEntries: (n: number) => void;
+    sortOrder: () => SortOrder;
+    setSortOrder: (o: SortOrder) => void;
+    scrollMode: () => ScrollMode;
+    setScrollMode: (m: ScrollMode) => void;
+    sessionId: string;
+}

package/dist/core/types.js

@@ -0,0 +1,2 @@
+/** OpenCode built-in tool names that spawn sub-agents or delegate tasks. */
+export const SUBAGENT_TOOLS = new Set(["task", "subagent", "delegate", "call_omo_agent"]);

package/dist/core/usage.d.ts

@@ -0,0 +1,15 @@
+export interface TodoStats {
+    total: number;
+    done: number;
+}
+/**
+ * Data-source abstraction for per-session usage reads.
+ * V1 and V2 provide their own implementations backed by their respective
+ * client APIs; the state machine consumes only this surface.
+ */
+export interface UsageReader {
+    readSessionTokens(sid: string): number | undefined;
+    readSessionCost(sid: string): number | undefined;
+    readSessionModel(sid: string): string | undefined;
+    readSessionTodo(sid: string): TodoStats | undefined;
+}

package/dist/core/usage.js

@@ -0,0 +1 @@
+export {};