@pasko70/pibo 1.11.1 → 1.11.3

package/dist/loops/store.js

@@ -87,6 +87,18 @@ function parseRunAccounting(json) {
     }
 }
 function runAccountingJson(accounting) { return accounting ? JSON.stringify(accounting) : null; }
+function parseSessionErrorDetails(json) {
+    if (!json)
+        return undefined;
+    try {
+        const value = JSON.parse(json);
+        return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function sessionErrorDetailsJson(details) { return details ? JSON.stringify(details) : null; }
 function normalizeJobState(state, mode, enabled, createdAt) {
     if (mode !== 'goal')
         return state;
@@ -105,7 +117,8 @@ function jobFromRow(row) {
 function runFromRow(row) {
     const resources = parseResourceMetadata(row.resource_json);
     const accounting = parseRunAccounting(row.accounting_json);
-    return { id: row.id, jobId: row.job_id, piboSessionId: row.pibo_session_id ?? undefined, status: row.status, reason: row.reason ?? undefined, error: row.error ?? undefined, startedAt: row.started_at ?? undefined, completedAt: row.completed_at ?? undefined, ...(accounting ? { accounting } : {}), ...(resources ? { resources } : {}), createdAt: row.created_at, updatedAt: row.updated_at };
+    const errorDetails = parseSessionErrorDetails(row.error_details_json);
+    return { id: row.id, jobId: row.job_id, piboSessionId: row.pibo_session_id ?? undefined, status: row.status, reason: row.reason ?? undefined, error: row.error ?? undefined, ...(errorDetails ? { errorDetails } : {}), messageEventId: row.message_event_id ?? undefined, messageState: row.message_state ?? undefined, startedAt: row.started_at ?? undefined, completedAt: row.completed_at ?? undefined, ...(accounting ? { accounting } : {}), ...(resources ? { resources } : {}), createdAt: row.created_at, updatedAt: row.updated_at };
 }
 function mergeResourceMetadata(jobResources, runResources) {
     if (!jobResources && !runResources)
@@ -142,6 +155,7 @@ function goalStatus(job) {
         return undefined;
     return job.state.goalStatus ?? (job.enabled ? 'active' : 'paused');
 }
+function isTerminalGoalStatus(status) { return status === 'complete' || status === 'blocked' || status === 'budget_limited'; }
 function normalizeModelOverride(value) {
     if (value === undefined || value === null)
         return undefined;
@@ -294,16 +308,89 @@ export class PiboLoopStore {
         const row = this.db.prepare("SELECT * FROM pibo_ralph_jobs WHERE loop_mode = 'goal' AND json_extract(state_json, '$.lastPiboSessionId') = ? ORDER BY created_at DESC LIMIT 1").get(piboSessionId);
         return row ? jobFromRow(row) : undefined;
     }
+    listGoalsForSession(piboSessionId) {
+        return this.db.prepare("SELECT * FROM pibo_ralph_jobs WHERE loop_mode = 'goal' AND json_extract(state_json, '$.lastPiboSessionId') = ? ORDER BY created_at DESC").all(piboSessionId).map(jobFromRow);
+    }
+    getSessionGoalOwner(piboSessionId) {
+        return this.listGoalsForSession(piboSessionId).find((job) => {
+            if ((goalStatus(job) ?? 'paused') !== 'complete')
+                return true;
+            return Boolean(this.db.prepare("SELECT 1 FROM pibo_ralph_runs WHERE job_id = ? AND status = 'running' LIMIT 1").get(job.id));
+        });
+    }
+    createSessionGoal(input, now = new Date()) {
+        this.db.exec('BEGIN IMMEDIATE');
+        try {
+            const owner = this.getSessionGoalOwner(input.initialPiboSessionId);
+            if (owner)
+                throw new Error(`cannot create a new goal because this Pibo Session has an unfinished goal or in-flight run owned by ${owner.id}`);
+            const job = this.createJob({ ...input, mode: 'goal', enabled: true }, now);
+            this.db.exec('COMMIT');
+            return job;
+        }
+        catch (error) {
+            this.db.exec('ROLLBACK');
+            throw error;
+        }
+    }
+    reopenGoal(id, input, now = new Date()) {
+        const actorId = input.actorId.trim();
+        if (!actorId)
+            throw new Error('reopen actorId is required');
+        this.db.exec('BEGIN IMMEDIATE');
+        try {
+            const job = this.getJob(id);
+            if (!job || job.mode !== 'goal')
+                throw new Error('Goal not found');
+            const previousStatus = goalStatus(job) ?? (job.enabled ? 'active' : 'paused');
+            if (job.enabled || !['complete', 'blocked', 'budget_limited'].includes(previousStatus))
+                throw new Error('Only a disabled terminal Goal can be reopened');
+            const piboSessionId = job.state.lastPiboSessionId;
+            if (!piboSessionId)
+                throw new Error('Goal cannot be reopened because it has no originating Pibo Session');
+            if (this.db.prepare("SELECT 1 FROM pibo_ralph_runs WHERE job_id = ? AND status = 'running' LIMIT 1").get(job.id))
+                throw new Error('Goal cannot be reopened while a Loop run is active or queued');
+            const competitor = this.listGoalsForSession(piboSessionId).find((candidate) => {
+                if (candidate.id === job.id)
+                    return false;
+                if ((goalStatus(candidate) ?? 'paused') !== 'complete')
+                    return true;
+                return Boolean(this.db.prepare("SELECT 1 FROM pibo_ralph_runs WHERE job_id = ? AND status = 'running' LIMIT 1").get(candidate.id));
+            });
+            if (competitor)
+                throw new Error(`Goal cannot be reopened because ${competitor.id} owns the Pibo Session`);
+            const timestamp = nowIso(now);
+            const fact = {
+                id: `rfact_${randomUUID()}`,
+                jobId: job.id,
+                piboSessionId,
+                type: 'pibo.loop.goal-reopened',
+                source: 'pibo',
+                payload: { actorId, previousStatus, previousGoalEndedAt: job.state.goalEndedAt ?? null, confirmation: 'confirm-terminal-reopen' },
+                createdAt: timestamp,
+            };
+            this.db.prepare('INSERT INTO pibo_ralph_run_facts (id, job_id, run_id, pibo_session_id, type, source, payload_json, created_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?)').run(fact.id, fact.jobId, null, piboSessionId, fact.type, fact.source, JSON.stringify(fact.payload), fact.createdAt);
+            const state = { ...job.state, goalStatus: 'active', goalEndedAt: undefined, stopRequestedAt: undefined, cancelRequestedAt: undefined, runningAt: undefined };
+            this.db.prepare('UPDATE pibo_ralph_jobs SET enabled = 1, state_json = ?, updated_at = ? WHERE id = ?').run(JSON.stringify(state), timestamp, job.id);
+            this.db.exec('COMMIT');
+            return this.getJob(id);
+        }
+        catch (error) {
+            this.db.exec('ROLLBACK');
+            throw error;
+        }
+    }
     updateGoalStatus(id, status, now = new Date()) {
         const job = this.getJob(id);
         if (!job || job.mode !== 'goal')
             return undefined;
+        const currentStatus = goalStatus(job);
+        if (currentStatus === status)
+            return job;
+        if (isTerminalGoalStatus(currentStatus))
+            throw new Error(`Cannot change terminal goal status from ${currentStatus} to ${status}`);
         const timestamp = nowIso(now);
-        const state = { ...job.state, goalStatus: status, runningAt: job.state.runningAt };
-        if (job.state.runningAt)
-            delete state.goalEndedAt;
-        else
-            state.goalEndedAt = timestamp;
+        const state = { ...job.state, goalStatus: status, goalEndedAt: job.state.goalEndedAt ?? timestamp, runningAt: job.state.runningAt };
         this.db.prepare('UPDATE pibo_ralph_jobs SET enabled = 0, state_json = ?, updated_at = ? WHERE id = ?').run(JSON.stringify(state), timestamp, id);
         return this.getJob(id);
     }
@@ -323,8 +410,8 @@ export class PiboLoopStore {
             goalStatus: budgetLimited ? 'budget_limited' : currentStatus,
         };
         const timestamp = nowIso(now);
-        if (budgetLimited && !job.state.runningAt)
-            state.goalEndedAt = timestamp;
+        if (budgetLimited)
+            state.goalEndedAt = job.state.goalEndedAt ?? timestamp;
         this.db.prepare('UPDATE pibo_ralph_jobs SET enabled = ?, state_json = ?, updated_at = ? WHERE id = ?').run(budgetLimited ? 0 : job.enabled ? 1 : 0, JSON.stringify(state), timestamp, id);
         return this.getJob(id);
     }
@@ -409,6 +496,10 @@ export class PiboLoopStore {
                 delete state.goalEndedAt;
                 state.stopRequestedAt = undefined;
                 state.cancelRequestedAt = undefined;
+                state.lastFailure = undefined;
+                state.nextAttemptAt = undefined;
+                state.retryBackoffMs = undefined;
+                state.consecutiveErrors = 0;
             }
             else {
                 state.goalStatus = currentGoalStatus === 'active' ? 'paused' : currentGoalStatus;
@@ -441,7 +532,26 @@ export class PiboLoopStore {
         const row = this.db.prepare('SELECT * FROM pibo_ralph_runs WHERE id = ?').get(input.runId);
         return row ? runFromRow(row) : undefined;
     }
-    removeJob(id) { const result = this.db.prepare('DELETE FROM pibo_ralph_jobs WHERE id = ?').run(id); return Number(result.changes ?? 0) > 0; }
+    removeJob(id) {
+        this.db.exec('BEGIN IMMEDIATE');
+        try {
+            if (!this.getJob(id)) {
+                this.db.exec('COMMIT');
+                return false;
+            }
+            if (this.db.prepare("SELECT 1 FROM pibo_ralph_runs WHERE job_id = ? AND status = 'running' LIMIT 1").get(id))
+                throw new Error('Loop job has an active run; cancel it before removal');
+            this.db.prepare('DELETE FROM pibo_ralph_run_facts WHERE job_id = ?').run(id);
+            this.db.prepare('DELETE FROM pibo_ralph_runs WHERE job_id = ?').run(id);
+            const result = this.db.prepare('DELETE FROM pibo_ralph_jobs WHERE id = ?').run(id);
+            this.db.exec('COMMIT');
+            return Number(result.changes ?? 0) > 0;
+        }
+        catch (error) {
+            this.db.exec('ROLLBACK');
+            throw error;
+        }
+    }
     listRuns(input = {}) {
         const clauses = [];
         const values = [];
@@ -452,6 +562,24 @@ export class PiboLoopStore {
         const where = clauses.length ? `WHERE ${clauses.join(' AND ')}` : '';
         return this.db.prepare(`SELECT * FROM pibo_ralph_runs ${where} ORDER BY created_at DESC LIMIT ?`).all(...values, Math.max(1, Math.min(input.limit ?? 100, 500))).map(runFromRow);
     }
+    getRun(id) {
+        const row = this.db.prepare('SELECT * FROM pibo_ralph_runs WHERE id = ?').get(id);
+        return row ? runFromRow(row) : undefined;
+    }
+    getRunByMessageEventId(eventId) {
+        const row = this.db.prepare('SELECT * FROM pibo_ralph_runs WHERE message_event_id = ?').get(eventId);
+        return row ? runFromRow(row) : undefined;
+    }
+    attachRunMessage(jobId, runId, eventId, now = new Date()) {
+        const timestamp = nowIso(now);
+        const result = this.db.prepare("UPDATE pibo_ralph_runs SET message_event_id = ?, message_state = 'queued', updated_at = ? WHERE id = ? AND job_id = ? AND status = 'running'").run(eventId, timestamp, runId, jobId);
+        return Number(result.changes ?? 0) > 0 ? this.getRun(runId) : undefined;
+    }
+    updateRunMessageState(eventId, state, now = new Date()) {
+        const timestamp = nowIso(now);
+        const result = this.db.prepare('UPDATE pibo_ralph_runs SET message_state = ?, updated_at = ? WHERE message_event_id = ?').run(state, timestamp, eventId);
+        return Number(result.changes ?? 0) > 0 ? this.getRunByMessageEventId(eventId) : undefined;
+    }
     reserveRun(id, now = new Date()) { this.updateJob(id, { enabled: true }, now); return this.reserveJob(id, now); }
     reserveDueRuns(limit, now = new Date()) {
         const rows = this.db.prepare('SELECT * FROM pibo_ralph_jobs WHERE enabled = 1 ORDER BY updated_at ASC').all();
@@ -504,11 +632,41 @@ export class PiboLoopStore {
             return;
         const completedIterations = (job.state.completedIterations ?? 0) + 1;
         const reachedMaxIterations = job.maxIterations !== undefined && completedIterations >= job.maxIterations;
-        const terminalGoalStatus = job.mode === 'goal' && ['complete', 'blocked', 'budget_limited'].includes(goalStatus(job) ?? '');
+        const currentGoalStatus = goalStatus(job);
+        const nextGoalStatus = job.mode === 'goal' ? isTerminalGoalStatus(currentGoalStatus) ? currentGoalStatus : input.goalStatus ?? currentGoalStatus : undefined;
+        const terminalGoalStatus = job.mode === 'goal' && isTerminalGoalStatus(nextGoalStatus);
         const shouldDisable = terminalGoalStatus || reachedMaxIterations || input.stopAfterRun === true || input.stopEvaluation?.finalAction === 'stop-after-run' || input.stopEvaluation?.finalAction === 'cancel-current-run';
-        const state = { ...job.state, runningAt: undefined, completedIterations, lastRunAt: timestamp, lastRunId: input.runId, lastStatus: input.status === 'error' ? 'error' : input.status === 'cancelled' ? 'cancelled' : 'ok', lastError: input.error, lastPiboSessionId: input.piboSessionId ?? job.state.lastPiboSessionId, consecutiveErrors: input.status === 'error' ? (job.state.consecutiveErrors ?? 0) + 1 : 0, conditionStates: input.conditionStates ?? job.state.conditionStates, lastStopEvaluation: input.stopEvaluation ?? job.state.lastStopEvaluation, ...(terminalGoalStatus ? { goalEndedAt: job.state.goalEndedAt ?? timestamp } : {}) };
-        this.db.prepare('UPDATE pibo_ralph_runs SET status = ?, pibo_session_id = COALESCE(?, pibo_session_id), reason = ?, error = ?, completed_at = ?, updated_at = ? WHERE id = ?').run(input.status, input.piboSessionId ?? null, input.reason ?? input.stopEvaluation?.reason ?? null, input.error ?? null, timestamp, timestamp, input.runId);
-        this.db.prepare('UPDATE pibo_ralph_jobs SET enabled = ?, state_json = ?, updated_at = ? WHERE id = ?').run(shouldDisable ? 0 : job.enabled ? 1 : 0, JSON.stringify(state), timestamp, job.id);
+        const state = {
+            ...job.state,
+            runningAt: undefined,
+            completedIterations,
+            lastRunAt: timestamp,
+            lastRunId: input.runId,
+            lastStatus: input.status === 'error' ? 'error' : input.status === 'cancelled' ? 'cancelled' : 'ok',
+            lastError: input.error,
+            lastFailure: input.status === 'error' ? input.failure : undefined,
+            nextAttemptAt: input.status === 'error' ? input.failure?.nextAttemptAt : undefined,
+            retryBackoffMs: input.status === 'error' ? input.failure?.retryBackoffMs : undefined,
+            lastPiboSessionId: input.piboSessionId ?? job.state.lastPiboSessionId,
+            consecutiveErrors: input.status === 'error' ? (job.state.consecutiveErrors ?? 0) + 1 : 0,
+            conditionStates: input.conditionStates ?? job.state.conditionStates,
+            lastStopEvaluation: input.stopEvaluation ?? job.state.lastStopEvaluation,
+            ...(nextGoalStatus ? { goalStatus: nextGoalStatus } : {}),
+            ...(terminalGoalStatus ? { goalEndedAt: job.state.goalEndedAt ?? timestamp } : {}),
+        };
+        this.db.exec('BEGIN IMMEDIATE');
+        try {
+            this.db.prepare("UPDATE pibo_ralph_runs SET status = ?, pibo_session_id = COALESCE(?, pibo_session_id), reason = ?, error = ?, error_details_json = ?, message_state = CASE WHEN message_state = 'invalidated' THEN message_state ELSE 'finished' END, completed_at = ?, updated_at = ? WHERE id = ?").run(input.status, input.piboSessionId ?? null, input.reason ?? input.stopEvaluation?.reason ?? null, input.error ?? null, sessionErrorDetailsJson(input.errorDetails), timestamp, timestamp, input.runId);
+            this.db.prepare('UPDATE pibo_ralph_jobs SET enabled = ?, state_json = ?, updated_at = ? WHERE id = ?').run(shouldDisable ? 0 : job.enabled ? 1 : 0, JSON.stringify(state), timestamp, job.id);
+            this.db.exec('COMMIT');
+        }
+        catch (error) {
+            try {
+                this.db.exec('ROLLBACK');
+            }
+            catch { /* ignore rollback failure */ }
+            throw error;
+        }
     }
     appendRunFact(input) {
         if (!input.jobId.trim())
@@ -574,6 +732,10 @@ export class PiboLoopStore {
                 this.db.exec('COMMIT');
                 return undefined;
             }
+            if (job.state.nextAttemptAt && job.state.nextAttemptAt > timestamp) {
+                this.db.exec('COMMIT');
+                return undefined;
+            }
             if (job.mode === 'goal' && job.tokenBudget !== undefined) {
                 const remaining = Math.max(0, job.tokenBudget - (job.state.tokensUsed ?? 0));
                 if (remaining <= (job.tokenReserve ?? 0)) {
@@ -584,7 +746,7 @@ export class PiboLoopStore {
                 }
             }
             const run = this.createRunLocked(job, timestamp);
-            const state = { ...job.state, runningAt: timestamp, lastRunAt: timestamp, lastRunId: run.id };
+            const state = { ...job.state, runningAt: timestamp, lastRunAt: timestamp, lastRunId: run.id, nextAttemptAt: undefined, retryBackoffMs: undefined };
             this.updateJobStateLocked(job.id, state, timestamp);
             this.db.exec('COMMIT');
             return { job: { ...job, state, updatedAt: timestamp }, run };
@@ -605,9 +767,26 @@ export class PiboLoopStore {
         this.ensureJobColumn('resource_json', 'TEXT');
         this.ensureRunColumn('resource_json', 'TEXT');
         this.ensureRunColumn('accounting_json', 'TEXT');
+        this.ensureRunColumn('error_details_json', 'TEXT');
+        this.ensureRunColumn('message_event_id', 'TEXT');
+        this.ensureRunColumn('message_state', 'TEXT');
+        this.db.exec('CREATE UNIQUE INDEX IF NOT EXISTS idx_pibo_ralph_runs_message_event ON pibo_ralph_runs(message_event_id) WHERE message_event_id IS NOT NULL');
+        this.repairOrphanedChildren();
     }
     createFreshSchema() {
-        this.db.exec(`CREATE TABLE IF NOT EXISTS pibo_ralph_jobs (id TEXT PRIMARY KEY, loop_mode TEXT NOT NULL DEFAULT 'goal', name TEXT NOT NULL, description TEXT, enabled INTEGER NOT NULL, target_json TEXT NOT NULL, profile TEXT NOT NULL, prompt TEXT NOT NULL, max_iterations INTEGER, token_budget INTEGER, token_reserve INTEGER, runtime_options_json TEXT, stop_policy_json TEXT, resource_json TEXT, state_json TEXT NOT NULL, created_at TEXT NOT NULL, updated_at TEXT NOT NULL); CREATE INDEX IF NOT EXISTS idx_pibo_ralph_jobs_enabled ON pibo_ralph_jobs(enabled, updated_at DESC); CREATE TABLE IF NOT EXISTS pibo_ralph_runs (id TEXT PRIMARY KEY, job_id TEXT NOT NULL, pibo_session_id TEXT, status TEXT NOT NULL, reason TEXT, error TEXT, accounting_json TEXT, resource_json TEXT, started_at TEXT, completed_at TEXT, created_at TEXT NOT NULL, updated_at TEXT NOT NULL); CREATE INDEX IF NOT EXISTS idx_pibo_ralph_runs_job_created ON pibo_ralph_runs(job_id, created_at DESC); CREATE TABLE IF NOT EXISTS pibo_ralph_run_facts (id TEXT PRIMARY KEY, job_id TEXT NOT NULL, run_id TEXT, pibo_session_id TEXT, type TEXT NOT NULL, source TEXT NOT NULL, payload_json TEXT NOT NULL, created_at TEXT NOT NULL); CREATE INDEX IF NOT EXISTS idx_pibo_ralph_facts_job_created ON pibo_ralph_run_facts(job_id, created_at DESC); CREATE INDEX IF NOT EXISTS idx_pibo_ralph_facts_run_type ON pibo_ralph_run_facts(run_id, type, created_at DESC);`);
+        this.db.exec(`CREATE TABLE IF NOT EXISTS pibo_ralph_jobs (id TEXT PRIMARY KEY, loop_mode TEXT NOT NULL DEFAULT 'goal', name TEXT NOT NULL, description TEXT, enabled INTEGER NOT NULL, target_json TEXT NOT NULL, profile TEXT NOT NULL, prompt TEXT NOT NULL, max_iterations INTEGER, token_budget INTEGER, token_reserve INTEGER, runtime_options_json TEXT, stop_policy_json TEXT, resource_json TEXT, state_json TEXT NOT NULL, created_at TEXT NOT NULL, updated_at TEXT NOT NULL); CREATE INDEX IF NOT EXISTS idx_pibo_ralph_jobs_enabled ON pibo_ralph_jobs(enabled, updated_at DESC); CREATE TABLE IF NOT EXISTS pibo_ralph_runs (id TEXT PRIMARY KEY, job_id TEXT NOT NULL REFERENCES pibo_ralph_jobs(id) ON DELETE CASCADE, pibo_session_id TEXT, status TEXT NOT NULL, reason TEXT, error TEXT, error_details_json TEXT, message_event_id TEXT, message_state TEXT, accounting_json TEXT, resource_json TEXT, started_at TEXT, completed_at TEXT, created_at TEXT NOT NULL, updated_at TEXT NOT NULL); CREATE INDEX IF NOT EXISTS idx_pibo_ralph_runs_job_created ON pibo_ralph_runs(job_id, created_at DESC); CREATE TABLE IF NOT EXISTS pibo_ralph_run_facts (id TEXT PRIMARY KEY, job_id TEXT NOT NULL REFERENCES pibo_ralph_jobs(id) ON DELETE CASCADE, run_id TEXT, pibo_session_id TEXT, type TEXT NOT NULL, source TEXT NOT NULL, payload_json TEXT NOT NULL, created_at TEXT NOT NULL); CREATE INDEX IF NOT EXISTS idx_pibo_ralph_facts_job_created ON pibo_ralph_run_facts(job_id, created_at DESC); CREATE INDEX IF NOT EXISTS idx_pibo_ralph_facts_run_type ON pibo_ralph_run_facts(run_id, type, created_at DESC);`);
+    }
+    repairOrphanedChildren() {
+        this.db.exec('BEGIN IMMEDIATE');
+        try {
+            this.db.exec('DELETE FROM pibo_ralph_run_facts WHERE NOT EXISTS (SELECT 1 FROM pibo_ralph_jobs WHERE pibo_ralph_jobs.id = pibo_ralph_run_facts.job_id)');
+            this.db.exec('DELETE FROM pibo_ralph_runs WHERE NOT EXISTS (SELECT 1 FROM pibo_ralph_jobs WHERE pibo_ralph_jobs.id = pibo_ralph_runs.job_id)');
+            this.db.exec('COMMIT');
+        }
+        catch (error) {
+            this.db.exec('ROLLBACK');
+            throw error;
+        }
     }
     ensureJobColumn(name, definition) {
         const columns = this.tableColumns('pibo_ralph_jobs');
@@ -634,9 +813,42 @@ export class PiboLoopStore {
             tokensUsed: 0,
             overshootTokens: 0,
         } : undefined;
-        const run = { id: job.mode === 'ralph' ? `rrun_${randomUUID()}` : `lrun_${randomUUID()}`, jobId: job.id, status: 'running', startedAt: timestamp, ...(accounting ? { accounting } : {}), ...(job.resources ? { resources: job.resources } : {}), createdAt: timestamp, updatedAt: timestamp };
-        this.db.prepare('INSERT INTO pibo_ralph_runs (id, job_id, pibo_session_id, status, reason, error, accounting_json, resource_json, started_at, completed_at, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)').run(run.id, run.jobId, null, run.status, null, null, runAccountingJson(run.accounting), resourceMetadataJson(run.resources), run.startedAt ?? null, null, run.createdAt, run.updatedAt);
+        const run = { id: job.mode === 'ralph' ? `rrun_${randomUUID()}` : `lrun_${randomUUID()}`, jobId: job.id, status: 'running', messageState: 'reserved', startedAt: timestamp, ...(accounting ? { accounting } : {}), ...(job.resources ? { resources: job.resources } : {}), createdAt: timestamp, updatedAt: timestamp };
+        this.db.prepare('INSERT INTO pibo_ralph_runs (id, job_id, pibo_session_id, status, reason, error, error_details_json, message_event_id, message_state, accounting_json, resource_json, started_at, completed_at, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)').run(run.id, run.jobId, null, run.status, null, null, null, null, 'reserved', runAccountingJson(run.accounting), resourceMetadataJson(run.resources), run.startedAt ?? null, null, run.createdAt, run.updatedAt);
         return run;
     }
 }
 export function createDefaultPiboLoopStore(options = {}) { return new PiboLoopStore(options); }
+export function createLoopMessagePreflight(options = {}) {
+    return (event) => {
+        if (event.provenance?.kind !== 'loop-run')
+            return { allowed: true };
+        const store = createDefaultPiboLoopStore(options);
+        try {
+            const { jobId, runId } = event.provenance;
+            const job = store.getJob(jobId);
+            const run = store.getRun(runId);
+            const status = job?.mode === 'goal' ? goalStatus(job) ?? (job.enabled ? 'active' : 'paused') : undefined;
+            const allowed = Boolean(job
+                && run
+                && run.jobId === jobId
+                && run.status === 'running'
+                && run.messageEventId === event.id
+                && (!run.piboSessionId || run.piboSessionId === event.piboSessionId)
+                && job.enabled
+                && job.state.runningAt
+                && job.state.lastRunId === runId
+                && (job.mode !== 'goal' || status === 'active'));
+            if (allowed)
+                return { allowed: true };
+            return {
+                allowed: false,
+                code: 'loop_continuation_invalidated',
+                reason: `Loop continuation ${runId} is no longer authorized for job ${jobId}${status ? ` (${status})` : ''}`,
+            };
+        }
+        finally {
+            store.close();
+        }
+    };
+}

package/dist/loops/tools.js

@@ -27,6 +27,30 @@ function requireSessionContext(context) {
         profileName: context.profileName?.trim() || 'base',
     };
 }
+function resolveGoalForTurn(store, context, piboSessionId) {
+    const activeMessage = context.getActiveMessage?.();
+    const provenance = activeMessage?.provenance;
+    if (provenance?.kind !== 'loop-run')
+        return store.getSessionGoalOwner(piboSessionId) ?? store.getLatestGoalForSession(piboSessionId);
+    const run = store.getRun(provenance.runId);
+    if (!run || run.jobId !== provenance.jobId || run.piboSessionId !== piboSessionId || run.messageEventId !== activeMessage?.id) {
+        throw new Error('cannot resolve goal because this turn has stale or invalid Loop provenance');
+    }
+    const job = store.getJob(provenance.jobId);
+    if (!job || job.mode !== 'goal')
+        throw new Error('cannot resolve goal because the originating Goal no longer exists');
+    return job;
+}
+function requireExplicitGoalCreationAuthority(context) {
+    const activeMessage = context.getActiveMessage?.();
+    if (!activeMessage)
+        return;
+    if (activeMessage.provenance?.kind === 'loop-run')
+        throw new Error('automatic Loop continuations cannot create replacement goals');
+    if (activeMessage.source !== 'user' && activeMessage.source !== 'ui' && activeMessage.source !== 'actor') {
+        throw new Error('create_goal requires a fresh explicit user or actor turn');
+    }
+}
 function positiveInteger(value, field) {
     if (value === undefined)
         return undefined;
@@ -57,6 +81,8 @@ function goalPayload(job) {
         elapsedWallClockSeconds: goalElapsedWallClockSeconds(job),
         goalStartedAt: job.state.goalStartedAt ?? null,
         goalEndedAt: job.state.goalEndedAt ?? null,
+        nextAttemptAt: job.state.nextAttemptAt ?? null,
+        failure: job.state.lastFailure ?? null,
         wallClockIncludesPausedTime: true,
     };
 }
@@ -85,7 +111,7 @@ function createGetGoalTool(context, options) {
             try {
                 const { piboSessionId } = requireSessionContext(context);
                 return await withStore(options, (store) => {
-                    const job = store.getLatestGoalForSession(piboSessionId);
+                    const job = resolveGoalForTurn(store, context, piboSessionId);
                     return toolResult({ ok: true, goal: job ? goalPayload(job) : null });
                 });
             }
@@ -109,19 +135,14 @@ function createCreateGoalTool(context, options) {
         async execute(_toolCallId, params) {
             try {
                 const session = requireSessionContext(context);
+                requireExplicitGoalCreationAuthority(context);
                 const objective = params.objective?.trim();
                 if (!objective)
                     throw new Error('objective is required');
                 const tokenBudget = positiveInteger(params.token_budget, 'token_budget');
                 const tokenReserve = nonNegativeInteger(params.token_reserve, 'token_reserve');
                 return await withStore(options, (store) => {
-                    const existing = store.getLatestGoalForSession(session.piboSessionId);
-                    if (existing && effectiveGoalStatus(existing) !== 'complete') {
-                        throw new Error('cannot create a new goal because this Pibo Session has an unfinished goal; complete the existing goal first');
-                    }
-                    const job = store.createJob({
-                        mode: 'goal',
-                        enabled: true,
+                    const job = store.createSessionGoal({
                         target: session.piboRoomId ? { kind: 'room', roomId: session.piboRoomId } : { kind: 'default-chat' },
                         profile: session.profileName,
                         prompt: objective,
@@ -154,7 +175,7 @@ function createUpdateGoalTool(context, options) {
                     throw new Error('status must be complete or blocked');
                 const status = params.status;
                 return await withStore(options, (store) => {
-                    const existing = store.getLatestGoalForSession(piboSessionId);
+                    const existing = resolveGoalForTurn(store, context, piboSessionId);
                     if (!existing)
                         throw new Error('cannot update goal because this Pibo Session has no goal');
                     const job = store.updateGoalStatus(existing.id, status);

package/dist/reliability/store.js

@@ -500,7 +500,7 @@ export class PiboReliabilityStore {
 				) VALUES (?, 'tool', ?, 'running', ?, 0, ?, ?, NULL, NULL, NULL, NULL, ?, ?, NULL, ?, ?, ?, ?, ?, NULL, ?)
 			`)
             .run(runId, input.controllerPiboSessionId, input.completionPolicy, input.toolName, `${input.toolName} run is running.`, timestamp, timestamp, job.jobId, input.retryable ? 1 : 0, maxAttempts, input.timeoutMs ?? null, timeoutAt ?? null, input.serviceWarning ?? null);
-        this.claimJob(job.jobId, `run-registry:${process.pid}`, 24 * 60 * 60 * 1000);
+        this.claimJob(job.jobId, input.workerId ?? `run-registry:${process.pid}`, 24 * 60 * 60 * 1000);
         return this.requireRun(runId);
     }
     updateRun(runId, patch) {
@@ -572,14 +572,27 @@ export class PiboReliabilityStore {
         const result = this.db.prepare(`DELETE FROM pibo_runs WHERE run_id IN (${placeholders})`).run(...ids);
         return Number(result.changes ?? 0);
     }
-    recoverInterruptedRuns() {
+    recoverInterruptedRuns(workerId = `run-registry:${process.pid}`) {
         const rows = this.db.prepare("SELECT * FROM pibo_runs WHERE status = 'running'").all();
         const recovered = [];
         const timestamp = now();
         for (const row of rows) {
-            if (row.job_id && this.hasUnexpiredJobClaim(row.job_id, timestamp))
+            if (row.job_id && this.hasUnexpiredJobClaim(row.job_id, timestamp, workerId))
                 continue;
             const run = runFromRow(row);
+            if (run.timeoutAt && run.timeoutAt <= timestamp) {
+                const error = `Run deadline ${run.timeoutAt} elapsed before the interrupted runtime recovered.`;
+                if (run.jobId)
+                    this.moveLiveJobToDead(run.jobId, error, "timeout", timestamp);
+                recovered.push(this.updateRun(run.runId, {
+                    status: "timed_out",
+                    error,
+                    timeoutPhase: "lifetime",
+                    summary: `${run.toolName} run started successfully, then reached its configured timeout.`,
+                    completedAt: timestamp,
+                }) ?? run);
+                continue;
+            }
             if (run.retryable && run.maxAttempts > 1) {
                 if (run.jobId)
                     this.releaseJobForRetry(run.jobId, timestamp);
@@ -653,16 +666,17 @@ export class PiboReliabilityStore {
         for (const row of expired)
             this.moveJobToDead(row, row.last_error ?? "Job expired.", "expired", timestamp);
     }
-    hasUnexpiredJobClaim(jobId, timestamp) {
+    hasUnexpiredJobClaim(jobId, timestamp, workerId) {
         const row = this.db
             .prepare(`
 				SELECT job_id FROM pibo_jobs
 				WHERE job_id = ?
 					AND state = 'running'
+					AND worker_id = ?
 					AND claim_expires_at IS NOT NULL
 					AND claim_expires_at > ?
 			`)
-            .get(jobId, timestamp);
+            .get(jobId, workerId, timestamp);
         return row !== undefined;
     }
     releaseJobForRetry(jobId, timestamp) {

package/dist/runs/registry.js

@@ -46,14 +46,16 @@ export class PiboRunRegistry {
     runs = new Map();
     waiters = new Map();
     listeners = new Set();
+    workerId;
     subscribe(listener) {
         this.listeners.add(listener);
         return () => this.listeners.delete(listener);
     }
     constructor(options = {}) {
         this.options = options;
+        this.workerId = options.workerId ?? `run-registry:${process.pid}:${randomUUID()}`;
         if (this.options.store) {
-            this.options.store.recoverInterruptedRuns();
+            this.options.store.recoverInterruptedRuns(this.workerId);
             for (const record of this.options.store.listRuns({ includeConsumed: true, includeDetached: true })) {
                 this.runs.set(record.runId, recordFromStored(record));
             }
@@ -71,6 +73,7 @@ export class PiboRunRegistry {
                 maxAttempts: input.maxAttempts ?? 1,
                 timeoutMs: input.timeoutMs,
                 serviceWarning: input.serviceWarning,
+                workerId: this.workerId,
             });
             const record = recordFromStored(stored);
             this.runs.set(record.runId, record);
@@ -112,7 +115,7 @@ export class PiboRunRegistry {
         this.finish(record);
         this.options.store?.updateRun(runId, record);
         if (record.jobId)
-            this.options.store?.ack(record.jobId, `run-registry:${process.pid}`);
+            this.options.store?.ack(record.jobId, this.workerId);
         const output = snapshot(record);
         this.notify({ type: "run_changed", run: output, previousStatus });
         return output;
@@ -128,7 +131,7 @@ export class PiboRunRegistry {
         this.finish(record);
         this.options.store?.updateRun(runId, record);
         if (record.jobId)
-            this.options.store?.fail(record.jobId, `run-registry:${process.pid}`, error);
+            this.options.store?.fail(record.jobId, this.workerId, error);
         const output = snapshot(record);
         this.notify({ type: "run_changed", run: output, previousStatus, reason: error });
         return output;
@@ -147,7 +150,7 @@ export class PiboRunRegistry {
         this.finish(record);
         this.options.store?.updateRun(runId, record);
         if (record.jobId)
-            this.options.store?.fail(record.jobId, `run-registry:${process.pid}`, error);
+            this.options.store?.fail(record.jobId, this.workerId, error);
         const output = snapshot(record);
         this.notify({ type: "run_changed", run: output, previousStatus, reason: error });
         return output;
@@ -227,7 +230,7 @@ export class PiboRunRegistry {
             record.summary = `${record.toolName} run cancelled.`;
             this.finish(record);
             if (record.jobId)
-                this.options.store?.fail(record.jobId, `run-registry:${process.pid}`, "Run was cancelled.");
+                this.options.store?.fail(record.jobId, this.workerId, "Run was cancelled.");
         }
         record.consumed = true;
         record.updatedAt = now();
@@ -247,6 +250,25 @@ export class PiboRunRegistry {
         this.notify({ type: "run_acknowledged", run: output });
         return output;
     }
+    suppressNotification(controllerPiboSessionId, runId) {
+        const record = this.requireRunForController(controllerPiboSessionId, runId);
+        record.acknowledgedStatus = record.status;
+        record.updatedAt = now();
+        this.options.store?.updateRun(runId, record);
+        return snapshot(record);
+    }
+    suppressControllerNotifications(controllerPiboSessionId) {
+        const suppressed = [];
+        for (const record of this.runs.values()) {
+            if (record.controllerPiboSessionId !== controllerPiboSessionId || record.completionPolicy !== "tracked")
+                continue;
+            record.acknowledgedStatus = record.status;
+            record.updatedAt = now();
+            this.options.store?.updateRun(record.runId, record);
+            suppressed.push(snapshot(record));
+        }
+        return suppressed;
+    }
     createNotification(controllerPiboSessionId, options = {}) {
         const records = [...this.runs.values()].filter((record) => this.needsNotification(record, controllerPiboSessionId, options));
         if (records.length === 0)
@@ -292,7 +314,7 @@ export class PiboRunRegistry {
             this.finish(record);
             this.options.store?.updateRun(record.runId, record);
             if (record.jobId)
-                this.options.store?.fail(record.jobId, `run-registry:${process.pid}`, reason);
+                this.options.store?.fail(record.jobId, this.workerId, reason);
             const output = snapshot(record);
             this.notify({ type: "run_changed", run: output, previousStatus: "running", reason });
             cancelled.push(output);
@@ -311,7 +333,7 @@ export class PiboRunRegistry {
             this.finish(record);
             this.options.store?.updateRun(record.runId, record);
             if (record.jobId)
-                this.options.store?.fail(record.jobId, `run-registry:${process.pid}`, reason);
+                this.options.store?.fail(record.jobId, this.workerId, reason);
             const output = snapshot(record);
             this.notify({ type: "run_changed", run: output, previousStatus: "running", reason });
             cancelled.push(output);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pasko70/pibo",
-  "version": "1.11.1",
+  "version": "1.11.3",
   "type": "module",
   "imports": {
     "vscode": "./src/apps/chat-vscode/extension/src/vscode-shim.js"