@zq-silk/yui 0.11.2 → 0.12.0

package/dist/lifecycle/contextBudgetRollover.js

@@ -1,81 +0,0 @@
-import { enqueueWork } from "../coordination/workMailboxQueue.js";
-import { validateRoleSessionSet } from "../executor/agentExecutor.js";
-import { createTaskEvent } from "../event/taskEvent.js";
-import { RUNTIME_CLEANUP_REQUIRED_REASON, runtimeLifecycleTarget } from "../runtime/lifecycleReservation.js";
-/**
- * Issue 04 (context token budget): retires one native Session generation that
- * crossed the hard context budget so the next Leader wake starts a fresh
- * generation. This is a controlled rollover, not a failure: the durable Task
- * records are the checkpoint, the bounded context snapshot re-establishes
- * working context for the new generation, and the retired Session is kept in
- * history as `stopped` with an auditable event. The Controller separately
- * owns verified process cleanup through the runtime cleanup lane.
- */
-export const CONTEXT_BUDGET_ROLLOVER_REASON = "context-budget-hard-limit";
-export function rolloverTaskRoleSessionForContextBudget(store, taskId, roleName, evidence, now) {
-    const task = store.getTask(taskId);
-    if (task === null)
-        throw new Error(`Task not found: ${taskId}.`);
-    if (task.status !== "active") {
-        throw new Error(`Task is not active: ${task.id}/${task.status}.`);
-    }
-    const role = store.getRole(task.id, roleName);
-    if (role === null)
-        throw new Error(`Role not found: ${task.id}/${roleName}.`);
-    const set = store.getTaskRoleSessionSet(task.id, role.name);
-    const current = set?.sessions[set.activeAgentId];
-    if (set === null || set === undefined || current === undefined) {
-        // No live generation to retire; the caller can launch fresh directly.
-        return null;
-    }
-    const timestamp = now.toISOString();
-    const reason = `${CONTEXT_BUDGET_ROLLOVER_REASON} (peak ${evidence.peakTokens} >= hard ${evidence.hardTokens} tokens)`;
-    enqueueWork(store, runtimeLifecycleTarget({ scope: "task", taskId: task.id, roleName: role.name }), RUNTIME_CLEANUP_REQUIRED_REASON, now, [{ type: "task", id: task.id }]);
-    const retired = retireStoppedTaskRoleSession(set, timestamp);
-    store.saveTaskRoleSessionSet(retired);
-    const eventId = store.nextEventId(task.id);
-    store.saveEvent(task.id, createTaskEvent(eventId, task.id, "runtime.role-session-reset", {
-        roleName: role.name,
-        reason,
-        peakTokens: String(evidence.peakTokens),
-        hardTokens: String(evidence.hardTokens),
-        ...(current.nativeSessionId === undefined
-            ? {}
-            : { nativeSessionId: current.nativeSessionId }),
-        ...(current.launchId === undefined ? {} : { launchId: current.launchId })
-    }, now));
-    return Object.freeze({
-        taskId: task.id,
-        roleName: role.name,
-        eventId,
-        ...(current.nativeSessionId === undefined
-            ? {}
-            : { retiredNativeSessionId: current.nativeSessionId }),
-        ...(current.launchId === undefined ? {} : { retiredLaunchId: current.launchId })
-    });
-}
-/**
- * Retires the current generation to history as `stopped` (not `broken`:
- * a budget rollover is not a Session failure) and clears the Turn fence so
- * the next launch is a fresh generation.
- */
-function retireStoppedTaskRoleSession(set, timestamp) {
-    validateRoleSessionSet(set);
-    const current = set.sessions[set.activeAgentId];
-    const sessions = { ...set.sessions };
-    delete sessions[set.activeAgentId];
-    const history = current === undefined
-        ? set.history
-        : [
-            ...(set.history ?? []),
-            { ...current, status: "stopped", updatedAt: timestamp }
-        ];
-    return validateRoleSessionSet({
-        ...set,
-        sessions,
-        ...(history === undefined ? {} : { history }),
-        inFlight: null,
-        providerBinding: null,
-        updatedAt: timestamp
-    });
-}

package/dist/scheduler/operatorNotification.js

@@ -1,59 +0,0 @@
-export const CURRENT_OPERATOR_NOTIFICATION_SCHEMA_VERSION = 1;
-export function createLeaderRecoveryNotification(taskId, message, now, existing) {
-    const timestamp = now.toISOString();
-    return {
-        schemaVersion: CURRENT_OPERATOR_NOTIFICATION_SCHEMA_VERSION,
-        taskId: requiredText(taskId, "Task id"),
-        type: "leader-recovery-failed",
-        message: requiredText(message, "Operator notification message"),
-        createdAt: existing?.type === "leader-recovery-failed"
-            ? existing.createdAt
-            : timestamp,
-        updatedAt: timestamp
-    };
-}
-export function createTaskTerminalNotification(taskId, status, by, summary, now) {
-    const timestamp = now.toISOString();
-    return {
-        schemaVersion: CURRENT_OPERATOR_NOTIFICATION_SCHEMA_VERSION,
-        taskId: requiredText(taskId, "Task id"),
-        type: "task-terminal",
-        status,
-        by,
-        summary: requiredText(summary, "Task terminal summary"),
-        createdAt: timestamp,
-        updatedAt: timestamp
-    };
-}
-export function createLeaderStallNotification(taskId, runId, progressAt, evidenceKey, now, existing) {
-    const timestamp = now.toISOString();
-    const previous = existing?.type === "leader-stalled"
-        && existing.runId === runId
-        && existing.progressAt === progressAt
-        ? existing
-        : undefined;
-    return {
-        schemaVersion: CURRENT_OPERATOR_NOTIFICATION_SCHEMA_VERSION,
-        taskId: requiredText(taskId, "Task id"),
-        type: "leader-stalled",
-        message: requiredText([
-            `Leader Run ${runId} is truly stalled for Task ${taskId}.`,
-            `lastProgressAt=${progressAt}`,
-            `classification=truly-stalled`,
-            `evidence=${evidenceKey}`,
-            "Inspect the Task context and decide whether to continue, reset, retry, change Agent, or request user input; Controller performed no automatic action."
-        ].join(" "), "Operator notification message"),
-        runId: requiredText(runId, "Leader Run id"),
-        progressAt: requiredText(progressAt, "Leader progress timestamp"),
-        classification: "truly-stalled",
-        evidenceKey: requiredText(evidenceKey, "Leader stall evidence"),
-        createdAt: previous?.createdAt ?? timestamp,
-        updatedAt: timestamp
-    };
-}
-function requiredText(value, label) {
-    const normalized = value.trim();
-    if (normalized.length === 0)
-        throw new Error(`${label} is required.`);
-    return normalized;
-}