@jungjaehoon/mama-os 0.51.2 → 0.52.0

package/dist/operator/procedure-store.js

@@ -0,0 +1,368 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcedureStore = void 0;
+exports.procedureScopeKey = procedureScopeKey;
+const node_crypto_1 = require("node:crypto");
+const operator_procedures_js_1 = require("../db/migrations/operator-procedures.js");
+/** Stable scope identity for durable trigger references, independent of logical procedure ID. */
+function procedureScopeKey(scope) {
+    return (0, node_crypto_1.createHash)('sha256')
+        .update(JSON.stringify([scope.ownerScope, scope.projectId]))
+        .digest('hex');
+}
+function stable(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map(stable).join(',')}]`;
+    }
+    if (value !== null && typeof value === 'object') {
+        return `{${Object.entries(value)
+            .filter(([, v]) => v !== undefined)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([k, v]) => `${JSON.stringify(k)}:${stable(v)}`)
+            .join(',')}}`;
+    }
+    return JSON.stringify(value);
+}
+function hash(value) {
+    return (0, node_crypto_1.createHash)('sha256').update(stable(value)).digest('hex');
+}
+function required(value, name) {
+    if (typeof value !== 'string' || !value.trim()) {
+        throw new Error(`procedure ${name} required`);
+    }
+}
+/** TG-03/TG-05/TG-06: authorized heads, immutable instructions and receipt observations. */
+class ProcedureStore {
+    db;
+    constructor(db) {
+        this.db = db;
+        db.pragma('busy_timeout = 5000');
+        (0, operator_procedures_js_1.applyOperatorProceduresMigration)(db);
+    }
+    /** Keep projection file publication serialized with every canonical writer. */
+    withWriteTransaction(work) {
+        return this.db.transaction(work, 'immediate')();
+    }
+    authorized(head, access) {
+        const channels = head.channel_ids_json === null ? undefined : JSON.parse(head.channel_ids_json);
+        return (head.owner_scope === access.ownerScope &&
+            head.project_id === access.projectId &&
+            (!channels || (access.channelId !== undefined && channels.includes(access.channelId))));
+    }
+    head(id, access) {
+        const row = this.db
+            .prepare('SELECT * FROM operator_procedures WHERE id = ? AND owner_scope = ? AND project_id = ?')
+            .get(id, access.ownerScope, access.projectId);
+        return row && this.authorized(row, access) ? row : null;
+    }
+    revision(id, revision, access) {
+        const row = this.db
+            .prepare('SELECT record_json FROM operator_procedure_revisions WHERE procedure_id = ? AND revision = ? AND owner_scope = ? AND project_id = ?')
+            .get(id, revision, access.ownerScope, access.projectId);
+        return row ? JSON.parse(row.record_json) : null;
+    }
+    list(access) {
+        const heads = this.db
+            .prepare("SELECT * FROM operator_procedures WHERE owner_scope = ? AND project_id = ? AND status = 'active' ORDER BY id")
+            .all(access.ownerScope, access.projectId);
+        return heads
+            .filter((head) => this.authorized(head, access))
+            .map((head) => {
+            const record = this.revision(head.id, head.revision, access);
+            if (!record) {
+                throw new Error('procedure head revision missing');
+            }
+            return record;
+        });
+    }
+    read(id, access, revision) {
+        const head = this.head(id, access);
+        if (!head || head.status !== 'active') {
+            return null;
+        }
+        return this.revision(id, revision ?? head.revision, access);
+    }
+    history(id, access) {
+        if (!this.head(id, access)) {
+            return [];
+        }
+        return this.db
+            .prepare('SELECT record_json FROM operator_procedure_revisions WHERE procedure_id = ? AND owner_scope = ? AND project_id = ? ORDER BY revision')
+            .all(id, access.ownerScope, access.projectId).map((row) => JSON.parse(row.record_json));
+    }
+    retry(correctionId, intentHash, access) {
+        const row = this.db
+            .prepare('SELECT record_json, intent_hash FROM operator_procedure_revisions WHERE owner_scope = ? AND project_id = ? AND correction_id = ?')
+            .get(access.ownerScope, access.projectId, correctionId);
+        if (!row) {
+            return null;
+        }
+        const record = JSON.parse(row.record_json);
+        if (!this.head(record.id, access)) {
+            throw new Error('procedure unavailable');
+        }
+        if (row.intent_hash !== intentHash) {
+            throw new Error('procedure correction conflict');
+        }
+        return record;
+    }
+    append(record, intentHash) {
+        this.db
+            .prepare('INSERT INTO operator_procedure_revisions (procedure_id, revision, owner_scope, project_id, correction_id, intent_hash, record_json) VALUES (?, ?, ?, ?, ?, ?, ?)')
+            .run(record.id, record.revision, record.scope.ownerScope, record.scope.projectId, record.correctionId, intentHash, JSON.stringify(record));
+    }
+    save(input, access) {
+        for (const field of ['id', 'correctionId', 'title', 'body', 'originalInstruction']) {
+            required(input[field], field);
+        }
+        if (input.scope.ownerScope !== access.ownerScope ||
+            input.scope.projectId !== access.projectId ||
+            (input.scope.channelIds &&
+                (input.scope.channelIds.length === 0 ||
+                    input.scope.channelIds.some((channel) => channel !== access.channelId)))) {
+            throw new Error('procedure scope denied');
+        }
+        const expected = input.expectedRevision ?? 0;
+        if (!Number.isInteger(expected) || expected < 0) {
+            throw new Error('procedure expected revision invalid');
+        }
+        const intentHash = hash({ operation: 'save', ...input, expectedRevision: expected });
+        // better-sqlite3 creates a SAVEPOINT when the host already owns a transaction.
+        return this.db.transaction(() => {
+            const retry = this.retry(input.correctionId, intentHash, access);
+            if (retry) {
+                return retry;
+            }
+            const head = this.head(input.id, access);
+            if (expected !== (head?.revision ?? 0)) {
+                throw new Error('procedure revision conflict');
+            }
+            if (head && head.status !== 'active') {
+                throw new Error('procedure retired');
+            }
+            if (head &&
+                head.channel_ids_json !==
+                    (input.scope.channelIds ? JSON.stringify(input.scope.channelIds) : null)) {
+                throw new Error('procedure scope change denied');
+            }
+            const previous = head ? this.revision(input.id, head.revision, access) : null;
+            if (head && !previous) {
+                throw new Error('procedure head revision missing');
+            }
+            const { expectedRevision: _expectedRevision, ...content } = input;
+            const now = Date.now();
+            const record = {
+                ...content,
+                supersededMemoryIds: [
+                    ...new Set([
+                        ...(previous?.supersededMemoryIds ?? []),
+                        ...(input.supersededMemoryIds ?? []),
+                    ]),
+                ],
+                scopeKey: procedureScopeKey(access),
+                revision: expected + 1,
+                status: 'active',
+                createdAt: previous?.createdAt ?? now,
+                updatedAt: now,
+            };
+            if (head) {
+                const result = this.db
+                    .prepare('UPDATE operator_procedures SET revision = ? WHERE id = ? AND revision = ? AND owner_scope = ? AND project_id = ?')
+                    .run(record.revision, input.id, expected, access.ownerScope, access.projectId);
+                if (result.changes !== 1) {
+                    throw new Error('procedure revision conflict');
+                }
+            }
+            else {
+                this.db
+                    .prepare('INSERT INTO operator_procedures (id, revision, status, owner_scope, project_id, channel_ids_json) VALUES (?, ?, ?, ?, ?, ?)')
+                    .run(input.id, record.revision, record.status, input.scope.ownerScope, input.scope.projectId, input.scope.channelIds ? JSON.stringify(input.scope.channelIds) : null);
+            }
+            this.append(record, intentHash);
+            // Legacy operator DBs may not have trigger references yet. Never create a second truth.
+            const triggerColumns = this.db.prepare('PRAGMA table_info(operator_triggers)').all();
+            if (triggerColumns.some((column) => column.name === 'procedure_ref_json') &&
+                triggerColumns.some((column) => column.name === 'revision')) {
+                this.db
+                    .prepare("UPDATE operator_triggers SET procedure_ref_json = ?, revision = revision + 1 WHERE status = 'active' AND json_extract(procedure_ref_json, '$.id') = ? AND json_extract(procedure_ref_json, '$.scopeKey') = ?")
+                    .run(JSON.stringify({ id: record.id, revision: record.revision, scopeKey: record.scopeKey }), record.id, record.scopeKey);
+                this.db
+                    .prepare("UPDATE operator_triggers SET revision = revision + 1 WHERE status = 'active' AND id IN (SELECT trigger_id FROM operator_trigger_procedure_bindings WHERE scope_key = ? AND procedure_id = ?) AND NOT (COALESCE(json_extract(procedure_ref_json, '$.id'), '') = ? AND COALESCE(json_extract(procedure_ref_json, '$.scopeKey'), '') = ?)")
+                    .run(record.scopeKey, record.id, record.id, record.scopeKey);
+            }
+            return record;
+        }, 'immediate')();
+    }
+    /** The mapping records the original queued snapshot; current head is resolved separately. */
+    getLegacyTriggerBinding(triggerId, access) {
+        const triggerTable = this.db
+            .prepare("SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'operator_triggers'")
+            .get();
+        const trigger = triggerTable
+            ? this.db.prepare('SELECT status FROM operator_triggers WHERE id = ?').get(triggerId)
+            : undefined;
+        if (trigger && trigger.status !== 'active') {
+            throw new Error('legacy trigger not active');
+        }
+        const row = this.db
+            .prepare('SELECT procedure_id, procedure_revision, scope_key, snapshot_hash FROM operator_trigger_procedure_bindings WHERE trigger_id = ? AND owner_scope = ? AND project_id = ? AND channel_id = ?')
+            .get(triggerId, access.ownerScope, access.projectId, access.channelId ?? '');
+        if (!row) {
+            return null;
+        }
+        return {
+            id: row.procedure_id,
+            revision: row.procedure_revision,
+            scopeKey: row.scope_key,
+            snapshotHash: row.snapshot_hash,
+        };
+    }
+    /** TG-05: lazy legacy import never binds a global trigger to the first channel's private rule. */
+    importLegacyTrigger(input, access, binding) {
+        required(binding.triggerId, 'triggerId');
+        required(binding.snapshotHash, 'snapshotHash');
+        required(access.channelId ?? '', 'legacy channelId');
+        return this.withWriteTransaction(() => {
+            const triggerTable = this.db
+                .prepare("SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = 'operator_triggers'")
+                .get();
+            const trigger = triggerTable
+                ? this.db
+                    .prepare('SELECT status, revision FROM operator_triggers WHERE id = ?')
+                    .get(binding.triggerId)
+                : undefined;
+            if (trigger && trigger.status !== 'active') {
+                throw new Error('legacy trigger not active');
+            }
+            const existing = this.getLegacyTriggerBinding(binding.triggerId, access);
+            if (existing) {
+                const record = this.read(existing.id, access, existing.revision);
+                if (!record) {
+                    throw new Error('legacy bound procedure unavailable');
+                }
+                return record;
+            }
+            const record = this.save(input, access);
+            this.db
+                .prepare('INSERT INTO operator_trigger_procedure_bindings (trigger_id, owner_scope, project_id, channel_id, procedure_id, procedure_revision, scope_key, snapshot_hash) VALUES (?, ?, ?, ?, ?, ?, ?, ?)')
+                .run(binding.triggerId, access.ownerScope, access.projectId, access.channelId, record.id, record.revision, record.scopeKey, binding.snapshotHash);
+            if (trigger) {
+                const changed = this.db
+                    .prepare("UPDATE operator_triggers SET revision = revision + 1 WHERE id = ? AND status = 'active' AND revision = ?")
+                    .run(binding.triggerId, trigger.revision);
+                if (changed.changes !== 1) {
+                    throw new Error('legacy trigger revision conflict');
+                }
+            }
+            return record;
+        });
+    }
+    retire(id, expectedRevision, correctionId, reason, access) {
+        required(correctionId, 'correctionId');
+        required(reason, 'reason');
+        const intentHash = hash({ operation: 'retire', id, expectedRevision, correctionId, reason });
+        return this.db.transaction(() => {
+            const retry = this.retry(correctionId, intentHash, access);
+            if (retry) {
+                return retry;
+            }
+            const head = this.head(id, access);
+            if (!head) {
+                throw new Error('procedure unavailable');
+            }
+            if (head.revision !== expectedRevision || head.status !== 'active') {
+                throw new Error('procedure revision conflict');
+            }
+            const previous = this.revision(id, head.revision, access);
+            if (!previous) {
+                throw new Error('procedure head revision missing');
+            }
+            const record = {
+                ...previous,
+                revision: expectedRevision + 1,
+                status: 'retired',
+                correctionId,
+                reason,
+                updatedAt: Date.now(),
+            };
+            this.db
+                .prepare("UPDATE operator_procedures SET revision = ?, status = 'retired' WHERE id = ? AND revision = ? AND owner_scope = ? AND project_id = ?")
+                .run(record.revision, id, expectedRevision, access.ownerScope, access.projectId);
+            this.append(record, intentHash);
+            return record;
+        }, 'immediate')();
+    }
+    supersededMemoryIds(access) {
+        const heads = this.db
+            .prepare('SELECT * FROM operator_procedures WHERE owner_scope = ? AND project_id = ?')
+            .all(access.ownerScope, access.projectId);
+        return [
+            ...new Set(heads
+                .filter((head) => this.authorized(head, access))
+                .flatMap((head) => this.revision(head.id, head.revision, access)?.supersededMemoryIds ?? [])),
+        ];
+    }
+    recordOutcome(input, access) {
+        required(input.receiptId, 'receiptId');
+        return this.db.transaction(() => {
+            if (!this.head(input.procedureId, access) ||
+                !this.revision(input.procedureId, input.revision, access)) {
+                throw new Error('procedure unavailable');
+            }
+            const intentHash = hash(input);
+            const row = this.db
+                .prepare('SELECT intent_hash, outcome_json FROM operator_procedure_outcomes WHERE procedure_id = ? AND receipt_id = ? AND owner_scope = ? AND project_id = ?')
+                .get(input.procedureId, input.receiptId, access.ownerScope, access.projectId);
+            if (row) {
+                if (row.intent_hash !== intentHash) {
+                    throw new Error('procedure receipt conflict');
+                }
+                return JSON.parse(row.outcome_json);
+            }
+            const record = { ...input, observedAt: Date.now() };
+            this.db
+                .prepare('INSERT INTO operator_procedure_outcomes (procedure_id, revision, receipt_id, intent_hash, outcome_json, owner_scope, project_id) VALUES (?, ?, ?, ?, ?, ?, ?)')
+                .run(input.procedureId, input.revision, input.receiptId, intentHash, JSON.stringify(record), access.ownerScope, access.projectId);
+            return record;
+        }, 'immediate')();
+    }
+    /** Durable intent is part of the immutable revision; publication is a separate receipt. */
+    pendingProjections(access) {
+        return this.list(access).filter((record) => record.projection &&
+            !this.db
+                .prepare('SELECT 1 FROM operator_procedure_projections WHERE procedure_id = ? AND revision = ? AND owner_scope = ? AND project_id = ?')
+                .get(record.id, record.revision, access.ownerScope, access.projectId));
+    }
+    markProjected(id, revision, publishedHash, access) {
+        this.db.transaction(() => {
+            const head = this.head(id, access);
+            if (!head || head.status !== 'active') {
+                throw new Error('procedure unavailable');
+            }
+            if (head.revision !== revision) {
+                throw new Error('procedure projection revision conflict');
+            }
+            const record = this.revision(id, revision, access);
+            if (!record?.projection) {
+                throw new Error('procedure projection missing');
+            }
+            const expected = (0, node_crypto_1.createHash)('sha256').update(record.projection.desiredText).digest('hex');
+            if (expected !== publishedHash) {
+                throw new Error('procedure projection hash conflict');
+            }
+            this.db
+                .prepare('INSERT INTO operator_procedure_projections (procedure_id, revision, published_hash, owner_scope, project_id) VALUES (?, ?, ?, ?, ?) ON CONFLICT(owner_scope, project_id, procedure_id, revision) DO NOTHING')
+                .run(id, revision, publishedHash, access.ownerScope, access.projectId);
+        }, 'immediate')();
+    }
+    getOutcomes(id, access) {
+        if (!this.head(id, access)) {
+            return [];
+        }
+        return this.db
+            .prepare('SELECT outcome_json FROM operator_procedure_outcomes WHERE procedure_id = ? AND owner_scope = ? AND project_id = ? ORDER BY rowid')
+            .all(id, access.ownerScope, access.projectId).map((row) => JSON.parse(row.outcome_json));
+    }
+}
+exports.ProcedureStore = ProcedureStore;
+//# sourceMappingURL=procedure-store.js.map

package/dist/operator/procedure-store.js.map

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

package/dist/operator/subagent-stimulus.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Waking the standing owner when a native subagent finishes.
+ *
+ * The owner agent delegates long, bounded work to a native subagent and ends its
+ * turn, so the owner conversation is never blocked behind maintenance. The child's
+ * completion is therefore a HOST stimulus, delivered on the same one durable owner
+ * subject as heartbeat and cron stimuli, and treated exactly like a background task
+ * notification: the agent reads the result, verifies it, and decides what to do.
+ *
+ * The child's final text is text a model wrote outside this turn's authority. It is
+ * wrapped as untrusted data - it is evidence to check, not an instruction to obey.
+ */
+import type { SubagentEvent } from '../multi-agent/runtime-process.js';
+export type { SubagentEvent } from '../multi-agent/runtime-process.js';
+/** Stable ref for dedupe and for the owner recovery journal. */
+export declare function subagentStimulusSourceRef(event: SubagentEvent): string;
+/**
+ * The evidence block alone - what the recovery journal stores. The host sentence is
+ * standing policy, not evidence, so it is not journalled.
+ */
+export declare function buildSubagentStimulusBlock(event: SubagentEvent): string;
+/** The owner-turn text for a completed subagent event. */
+export declare function buildSubagentStimulus(event: SubagentEvent): string;
+/** Only a finished child of the STANDING OWNER's own turn wakes the owner subject. */
+export declare function shouldWakeOwner(event: SubagentEvent): boolean;
+/**
+ * Subscribe an owner wake to a model runner's subagent events.
+ *
+ * Idempotent per child thread: a duplicate 'completed' event must not enqueue a
+ * second owner turn. A runner that does not emit subagent events (Claude CLI,
+ * test doubles) yields a no-op detach rather than a boot failure.
+ */
+export declare function attachSubagentWake(runner: unknown, wake: (event: SubagentEvent) => Promise<unknown>, log?: (line: string) => void): () => void;
+//# sourceMappingURL=subagent-stimulus.d.ts.map

package/dist/operator/subagent-stimulus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-stimulus.d.ts","sourceRoot":"","sources":["../../src/operator/subagent-stimulus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAIvE,YAAY,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAoDvE,gEAAgE;AAChE,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEtE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAUvE;AAED,0DAA0D;AAC1D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAElE;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE7D;AAgBD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,EAChD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAC3B,MAAM,IAAI,CAsCZ"}

package/dist/operator/subagent-stimulus.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * Waking the standing owner when a native subagent finishes.
+ *
+ * The owner agent delegates long, bounded work to a native subagent and ends its
+ * turn, so the owner conversation is never blocked behind maintenance. The child's
+ * completion is therefore a HOST stimulus, delivered on the same one durable owner
+ * subject as heartbeat and cron stimuli, and treated exactly like a background task
+ * notification: the agent reads the result, verifies it, and decides what to do.
+ *
+ * The child's final text is text a model wrote outside this turn's authority. It is
+ * wrapped as untrusted data - it is evidence to check, not an instruction to obey.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.subagentStimulusSourceRef = subagentStimulusSourceRef;
+exports.buildSubagentStimulusBlock = buildSubagentStimulusBlock;
+exports.buildSubagentStimulus = buildSubagentStimulus;
+exports.shouldWakeOwner = shouldWakeOwner;
+exports.attachSubagentWake = attachSubagentWake;
+const untrusted_content_js_1 = require("../utils/untrusted-content.js");
+const owner_runtime_js_1 = require("./owner-runtime.js");
+/** Upper bound on the quoted child result reaching the owner prompt. */
+const MAX_RESULT_CHARS = 4000;
+/**
+ * The one sentence the host adds. It names the situation and the standing
+ * obligation (verify, then carry the outcome) and stops there: choosing tools and
+ * ordering the follow-up is the agent's judgment, not the host's script.
+ */
+const OWNER_OBLIGATION = 'Read its result (wait_agent/list_agents if you need ' +
+    'more), verify what matters against the sources, and carry the outcome to the owner or the ' +
+    'board as the original objective requires. Do not restate the result as your own work ' +
+    'without checking it.';
+const OWNER_SENTENCE = `A subagent you started has finished. ${OWNER_OBLIGATION}`;
+/**
+ * A child that failed, was interrupted, or whose completion was never confirmed must not
+ * reach the owner wearing the success sentence. The status is named in the sentence.
+ */
+function ownerSentence(event) {
+    const status = event.status ?? 'unknown';
+    return status === 'completed'
+        ? OWNER_SENTENCE
+        : `A subagent you started ended with status ${status}. ${OWNER_OBLIGATION}`;
+}
+/** Attribute values are host-visible identifiers; keep them from closing the tag. */
+function attributeValue(raw) {
+    return raw.replace(/["<>]/g, '_');
+}
+function resultBody(event) {
+    const text = event.finalText ?? '';
+    const error = event.error?.trim() ? event.error.slice(0, MAX_RESULT_CHARS) : '';
+    const parts = [];
+    if (text.trim().length > 0) {
+        parts.push(text.length > MAX_RESULT_CHARS ? `${text.slice(0, MAX_RESULT_CHARS)}\n[truncated]` : text);
+    }
+    // Partial text never hides the failure: an error is reported alongside it, not instead.
+    if (error) {
+        parts.push(parts.length > 0 ? `error: ${error}` : `(no final answer) error: ${error}`);
+    }
+    if (parts.length === 0) {
+        return '(no result text returned)';
+    }
+    return parts.join('\n');
+}
+/** Stable ref for dedupe and for the owner recovery journal. */
+function subagentStimulusSourceRef(event) {
+    return `subagent:${event.agentThreadId}`;
+}
+/**
+ * The evidence block alone - what the recovery journal stores. The host sentence is
+ * standing policy, not evidence, so it is not journalled.
+ */
+function buildSubagentStimulusBlock(event) {
+    const header = `<subagent_completed path="${attributeValue(event.agentPath)}" ` +
+        `thread="${attributeValue(event.agentThreadId)}" ` +
+        `status="${attributeValue(event.status ?? 'unknown')}">`;
+    return [
+        header,
+        (0, untrusted_content_js_1.wrapUntrustedContent)(subagentStimulusSourceRef(event), resultBody(event)),
+        '</subagent_completed>',
+    ].join('\n');
+}
+/** The owner-turn text for a completed subagent event. */
+function buildSubagentStimulus(event) {
+    return `${buildSubagentStimulusBlock(event)}\n\n${ownerSentence(event)}`;
+}
+/** Only a finished child of the STANDING OWNER's own turn wakes the owner subject. */
+function shouldWakeOwner(event) {
+    return event.kind === 'completed' && event.sessionKey === owner_runtime_js_1.OWNER_RUNTIME_SESSION_KEY;
+}
+function asSubagentEmitter(runner) {
+    if (!runner || typeof runner !== 'object')
+        return null;
+    const candidate = runner;
+    return typeof candidate.on === 'function' ? candidate : null;
+}
+const MAX_HANDLED_THREADS = 200;
+/**
+ * Subscribe an owner wake to a model runner's subagent events.
+ *
+ * Idempotent per child thread: a duplicate 'completed' event must not enqueue a
+ * second owner turn. A runner that does not emit subagent events (Claude CLI,
+ * test doubles) yields a no-op detach rather than a boot failure.
+ */
+function attachSubagentWake(runner, wake, log) {
+    const emitter = asSubagentEmitter(runner);
+    if (!emitter) {
+        return () => { };
+    }
+    const emit = log ?? ((line) => console.log(line));
+    const handled = new Set();
+    const handler = (event) => {
+        if (!event || !shouldWakeOwner(event))
+            return;
+        const ref = subagentStimulusSourceRef(event);
+        if (handled.has(ref))
+            return;
+        handled.add(ref);
+        if (handled.size > MAX_HANDLED_THREADS) {
+            const oldest = handled.values().next().value;
+            if (oldest !== undefined)
+                handled.delete(oldest);
+        }
+        emit(`[subagent] wake owner path=${event.agentPath} thread=${event.agentThreadId} ` +
+            `status=${event.status ?? 'unknown'}`);
+        void wake(event).catch((error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            const line = `[subagent] wake failed thread=${event.agentThreadId}: ${message}`;
+            if (log)
+                log(line);
+            else
+                console.error(line);
+            // A rejected wake delivered nothing, so the ref must leave the dedupe set: the
+            // guarantee is "no duplicate owner turn", not "one attempt and the result is lost".
+            handled.delete(ref);
+        });
+    };
+    emitter.on('subagent', handler);
+    return () => {
+        if (typeof emitter.off === 'function')
+            emitter.off('subagent', handler);
+        else if (typeof emitter.removeListener === 'function')
+            emitter.removeListener('subagent', handler);
+    };
+}
+//# sourceMappingURL=subagent-stimulus.js.map

package/dist/operator/subagent-stimulus.js.map

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