@monoes/monomindcli 2.16.13 → 2.16.14

package/dist/src/orgrt/org-tools.js

@@ -0,0 +1,305 @@
+// packages/@monomind/cli/src/orgrt/org-tools.ts
+// Extracted from session.ts — the org tool surface every role session gets.
+import { z } from 'zod';
+import { resolveSessionScope } from './session-ledger.js';
+import { skillTools } from './skill-tools.js';
+import { MAX_TASK_BRIEF } from './task-dag.js';
+import { orgTaskTool } from './task-tools.js';
+import { strictArgs } from './tool-fence.js';
+import { MAX_BLOCK_RECHECK_MINUTES } from './types.js';
+/** Build the org tool surface as platform-agnostic OrgToolDef[]. The handlers
+ *  close over sessionOpts callbacks (deliver, recall, remember, …) — same
+ *  wiring as the previous inline createSdkMcpServer block, just decoupled from
+ *  the Claude SDK's tool() shape so any AgentRunner can host them.
+ *
+ *  Behaviour is identical to the old inline definitions: conditional tools are
+ *  gated on their callback being present, org_send/ask_human are always added. */
+export function buildOrgTools(opts) {
+    const { role, deliver } = opts;
+    const tools = [];
+    const text = (t) => ({ text: t });
+    const searchKnowledge = opts.searchKnowledge;
+    if (searchKnowledge) {
+        tools.push({
+            name: 'knowledge_search',
+            description: "Semantic search over the user's Second Brain: this project's indexed documents plus their personal cross-project global brain. Use to ground work in the user's actual notes, handbooks, and documents.",
+            schema: { query: z.string() },
+            handler: async (args) => text(await searchKnowledge(role.id, args.query)),
+        });
+    }
+    tools.push(...skillTools(role, opts.orgRoot ?? opts.cwd, opts.onSkillLoad));
+    const recall = opts.recall;
+    if (recall) {
+        tools.push({
+            name: 'org_recall',
+            description: "Search this org's accumulated memory from previous runs (outcomes, decisions, learnings). Use before starting work that may already have been done.",
+            schema: { query: z.string() },
+            handler: async (args) => text(await recall(role.id, args.query)),
+        });
+    }
+    const remember = opts.remember;
+    if (remember) {
+        tools.push({
+            name: 'org_remember',
+            description: 'Save a memory for future runs. scope "org" (default) shares it with the whole org; scope "agent" keeps it private to your role. Use for decisions, findings, and state worth recalling later - org_recall searches both.',
+            schema: { content: z.string(), scope: z.enum(['org', 'agent']).optional() },
+            handler: async (args) => text(await remember(role.id, args.content, args.scope ?? 'org')),
+        });
+    }
+    const learn = opts.learn;
+    if (learn) {
+        tools.push({
+            name: 'org_learn',
+            description: "Persist durable knowledge from this run into the org's knowledge graph: entities ({name, type?, description?}), relationships ({source, target, relation, description?}) and reusable rules ({rule, context?}). Entities merge by name across runs - reuse the exact names listed in your briefing. Call once, before org_complete.",
+            schema: {
+                nodes: z
+                    .array(strictArgs({
+                    name: z.string(),
+                    type: z.string().optional(),
+                    description: z.string().optional(),
+                }))
+                    .optional(),
+                edges: z
+                    .array(strictArgs({
+                    source: z.string(),
+                    target: z.string(),
+                    relation: z.string(),
+                    description: z.string().optional(),
+                }))
+                    .optional(),
+                rules: z.array(strictArgs({ rule: z.string(), context: z.string().optional() })).optional(),
+            },
+            handler: async (args) => text(await learn(role.id, args)),
+        });
+    }
+    // Gate purely on onComplete: the daemon passes it only to the role its
+    // boss-selection rule picked, so tool availability always matches the
+    // kickoff instruction (reports_to may be non-null for a fallback boss).
+    if (opts.onComplete) {
+        tools.push({
+            name: 'org_complete',
+            description: '⚠️ Ends the run — every agent session shuts down after this. Call exactly once, and only against the org\'s actual, full stated goal (see your briefing), never against just the current batch of dispatched tasks. "achieved" means the WHOLE goal is done, not "everyone assigned so far finished their piece" — a multi-phase or open-ended goal is very rarely achieved in a single run. If the current task batch is clearly done but the goal has more scope left: do NOT call this — use org_task/createTask to dispatch the next phase\'s work instead, so the org keeps making progress instead of stopping short. "achieved" only when the full goal is met; "failed" only when it clearly cannot be — neither requires a blocker (though if this org\'s run_config.completion is set to \'dag\', "achieved" is ALSO refused while org_tasks still has runnable work that is not blocked on a real-world time — check org_tasks first if that setting applies to you). Use outcome "partial" only when you are ending the run with real scope still remaining, and you MUST name why with `blocker`: \'budget\' (a role is genuinely near its token/USD ceiling), \'human\' (an ask_human question or decision gate is actually pending), \'time\' (if the only thing blocking further work is a scheduled process or deadline you know the time of, call org_task_block instead of ending the run so a future run can pick back up automatically — this blocker is refused unless a task is actually blocked that way), or \'external\' (anything else — `blockerDetail` must be a real, substantive explanation; placeholders like "none"/"n/a" and anything under 10 characters are refused, because this is the one blocker nothing else can check, and it is recorded verbatim in the run history under your name). A refusal names which of these to use instead. Before calling, check org_tasks — siblings with in-progress work only get a short drain window to finish before being cut off, so do not call this while others are still mid-build or mid-edit unless the run genuinely cannot continue. The outcome and summary are persisted to the org run history and briefed to the next run. If the run produced a concrete deliverable (a post, document, message, piece of content, code, etc.), summary MUST include that deliverable\'s full text verbatim — not a meta-description of what happened. Someone reading only summary should be able to see the actual result, not just that "a result was produced".',
+            schema: {
+                outcome: z.enum(['achieved', 'partial', 'failed']),
+                summary: z.string(),
+                blocker: z.enum(['budget', 'human', 'external', 'time']).optional(),
+                blockerDetail: z.string().optional(),
+            },
+            handler: async (args) => {
+                const refusal = opts.onComplete?.(role.id, args.outcome, args.summary, args.blocker, args.blockerDetail);
+                // #302: a refusal must not claim the outcome was recorded — nothing
+                // was, and the daemon never emitted the event that would stop the run.
+                if (refusal)
+                    return text(refusal);
+                return text(`outcome "${args.outcome}" recorded`);
+            },
+        });
+    }
+    const onRespawnRole = opts.onRespawnRole;
+    if (onRespawnRole) {
+        tools.push({
+            name: 'org_respawn_role',
+            description: "Replace one crashed, exhausted, or unsuitable WORKER role with a fresh session — keeping its role id, workspace, task ownership, and queued messages. Cannot target the coordinator (yourself) or an unknown/removed/not-yet-started role. Omit runtime/model/providerName to keep their current values. Omitted budgetTokens uses the normal per-role allocation for this run; it cannot raise the org-wide token budget. reason is a short operational reason for the audit log; briefing is what the replacement should know to continue the work — it starts a FRESH model session with no memory of the old one's conversation, so include everything it needs.",
+            schema: {
+                roleId: z.string(),
+                runtime: z.string().optional(),
+                model: z.string().optional(),
+                providerName: z.string().optional(),
+                budgetTokens: z.number().optional(),
+                reason: z.string(),
+                briefing: z.string(),
+            },
+            handler: async (args) => {
+                const receipt = await onRespawnRole(role.id, args);
+                return text(JSON.stringify(receipt));
+            },
+        });
+    }
+    const onListRuntimeOptions = opts.onListRuntimeOptions;
+    if (onListRuntimeOptions) {
+        tools.push({
+            name: 'org_list_runtime_options',
+            description: 'List every runtime this daemon knows how to run a role on (availability, detected binary/version, install hint) and every named provider configured for this project (name and default model only — never keys, tokens, or endpoints). Use before org_respawn_role to pick a real runtime/providerName. "available" means locally resolvable/detected, not that login, quota, or a remote model is valid.',
+            schema: {},
+            handler: async () => text(JSON.stringify(await onListRuntimeOptions())),
+        });
+    }
+    const onGate = opts.onGate;
+    if (onGate) {
+        tools.push({
+            name: 'org_gate',
+            description: 'Create a decision gate — a hard-blocking human-approval checkpoint. Use before irreversible actions (deployments, deletions, external comms). The gate pauses your work until a human approves or rejects it. End your turn after calling this; you will receive the resolution as a new message.',
+            schema: { name: z.string(), description: z.string() },
+            handler: async (args) => text(await onGate(role.id, args.name, args.description)),
+        });
+    }
+    // ADR-O001 D7: the `loadout` argument exists only for an org with a
+    // catalog, so every other org's tool list stays byte-identical.
+    const catalog = opts.loadoutCatalog?.length ? opts.loadoutCatalog : undefined;
+    const loadoutArg = catalog
+        ? { loadout: z.enum(catalog.map((l) => l.name)).optional() }
+        : {};
+    // Sent with the dispatch itself (task-provenance.ts dispatchLine), so the
+    // instructions arrive with the task instead of in a follow-up message.
+    const briefArg = z.string().max(MAX_TASK_BRIEF).optional();
+    const orgTask = orgTaskTool(opts, loadoutArg, briefArg);
+    if (orgTask)
+        tools.push(orgTask);
+    const completeTask = opts.completeTask;
+    if (completeTask) {
+        tools.push({
+            name: 'org_task_done',
+            description: opts.requireTaskEvidence
+                ? 'Mark a task as completed. This org requires EVIDENCE (run_config.completion_evidence): pass `evidence` with the current commit sha of the work (the HEAD of any worktree of this repository, or any local branch tip), `worktree` naming the worktree you ran in when it is not the org workspace, and one entry per acceptance criterion — the command you actually ran, its real exit code, and its output. A check passes when its exit code equals `expectExit` (default 0): when the criterion is met by a non-zero exit (a lookup that must find nothing → 1, a timeout that must fire → 124), set `expectExit` instead of appending `|| true`, which erases the exit code, and always say why in a one-line `expectReason` ("404 = branch not protected") — `expectExit` without it is refused. `expectExit` is only for a SINGLE-PURPOSE command: on a test suite or any other aggregate runner (vitest, jest, `pnpm test`, `pnpm -r`, a verify script) it is refused outright, because a suite exit code means "at least one of many things failed" and declaring it expected accepts every other failure too — run the one failing test file on its own and declare `expectExit` on that, or exclude the known failure and record the exclusion in `result`. A task whose job is to REPORT (QA, an audit) closes on commands that prove the report exists and is complete (e.g. `test -s <report file>`); the failures it found are findings — put them in `result` and send them to the coordinator, not in `checks`. If you tested something outside a git worktree (a scratch dir, an installed tarball), pin `headSha`/`worktree` to the worktree the artifact was built from. Evidence pinned to a commit that is no longer the head of that work is stale and will be refused, and a refused completion puts the task back in your queue with the reason — but only up to run_config.max_evidence_attempts refused proofs (default 3; a call with no `evidence` at all is refused without counting), after which the task is recorded as failed and escalated to the boss instead of returned to you. Any downstream tasks whose deps are now all done become ready and are dispatched.'
+                : 'Mark a task as completed and optionally provide a result summary. Any downstream tasks whose deps are now all done will become ready and be dispatched.',
+            schema: {
+                taskId: z.string(),
+                result: z.string().optional(),
+                evidence: strictArgs({
+                    headSha: z.string(),
+                    worktree: z.string().optional(),
+                    checks: z
+                        .array(strictArgs({
+                        command: z.string(),
+                        exitCode: z.number().int(),
+                        expectExit: z.number().int().optional(),
+                        expectReason: z.string().optional(),
+                        output: z.string().optional(),
+                    }))
+                        .default([]),
+                }).optional(),
+            },
+            handler: async (args) => text(completeTask(role.id, args.taskId, args.result, args.evidence)),
+        });
+    }
+    const requestReview = opts.requestReview;
+    if (requestReview) {
+        tools.push({
+            name: 'org_review',
+            description: "Ask an artifact-only reviewer for a verdict on a task. You pass ids only: the runtime builds the review from the task's text, its assignee's latest org_task_done evidence (commands, exit codes, output) and its own git diff of base...headSha — nothing you write is added, so there is no summary to give. The reviewer starts cold every time and replies to you with org_send. Refused if the task has no evidence yet.",
+            schema: {
+                taskId: z.string(),
+                reviewer: z.string(),
+                base: z.string().optional().describe("git ref to diff against (default 'main')"),
+            },
+            handler: async (args) => text(requestReview(role.id, args.taskId, args.reviewer, args.base)),
+        });
+    }
+    const listTasks = opts.listTasks;
+    if (listTasks) {
+        tools.push({
+            name: 'org_tasks',
+            description: 'List all tasks in the DAG with their current status and dependencies. Pass `taskId` to get just that task, including its result and latest evidence.',
+            schema: { taskId: z.string().optional() },
+            handler: async (args) => text(listTasks(args.taskId)),
+        });
+    }
+    const splitTask = opts.splitTask;
+    if (splitTask) {
+        tools.push({
+            name: 'org_task_split',
+            description: 'Split a task into parallel children when scope expands. The parent becomes "split"; children inherit its deps; downstream tasks are rewired to depend on all children.',
+            schema: {
+                parentId: z.string(),
+                children: z.array(strictArgs({ title: z.string(), assignee: z.string() })).min(1),
+            },
+            handler: async (args) => text(splitTask(role.id, args.parentId, args.children ?? [])),
+        });
+    }
+    const mergeTask = opts.mergeTask;
+    if (mergeTask) {
+        tools.push({
+            name: 'org_task_merge',
+            description: 'Merge one task into another when parallel branches converge early. The source becomes "merged"; downstream deps are rewired to the target.',
+            schema: { sourceId: z.string(), targetId: z.string() },
+            handler: async (args) => text(mergeTask(role.id, args.sourceId, args.targetId)),
+        });
+    }
+    const cancelTask = opts.cancelTask;
+    if (cancelTask) {
+        tools.push({
+            name: 'org_task_cancel',
+            description: 'Cancel a task as moot. The task becomes "cancelled" and unblocks downstream work. Its assignee is told to stop and not to commit or report further work for it; a role that runs one session per task has that session\'s process ended at once.',
+            schema: { taskId: z.string(), reason: z.string().optional() },
+            handler: async (args) => text(cancelTask(role.id, args.taskId, args.reason)),
+        });
+    }
+    const blockTask = opts.blockTask;
+    if (blockTask) {
+        tools.push({
+            name: 'org_task_block',
+            description: `Mark a task you are actively working (status "running") as blocked on a real-world time, not on other tasks — e.g. a scheduled soak test, a CI run that takes hours, a human-set deadline. Use this INSTEAD of leaving the task "running" with nothing actually happening, and instead of calling org_complete just because there is genuinely nothing to do right now: the idle watchdog will stop nudging you about this task until the time you give arrives, then automatically re-dispatch it to you. Give untilIso as an ISO 8601 date/time (e.g. "2026-08-19T09:00:00Z"). Nothing external wakes a blocked task — not a background command finishing, not a Monitor event, not npm propagation — so never block on a command you started: run waits in the foreground instead, with a command timeout long enough for them. Until the deadline you are woken periodically (every run_config.block_recheck_minutes, default 5; recheckAfterMinutes sets it for this block, 1-${MAX_BLOCK_RECHECK_MINUTES}) to re-check: close the task, re-block it, or report.`,
+            schema: {
+                taskId: z.string(),
+                untilIso: z.string(),
+                reason: z.string().optional(),
+                recheckAfterMinutes: z.number().positive().max(MAX_BLOCK_RECHECK_MINUTES).optional(),
+            },
+            handler: async (args) => text(blockTask(role.id, args.taskId, args.untilIso, args.reason, args.recheckAfterMinutes)),
+        });
+    }
+    const planGraph = opts.planGraph;
+    if (planGraph) {
+        tools.push({
+            name: 'org_plan_graph',
+            description: 'Propose a full work graph in one call. Each task spec uses a local "name" and references other specs by name in "after", and may carry a "brief" with its instructions exactly as org_task does.' +
+                (catalog ? ' Each spec may select a "loadout" exactly as org_task does.' : ''),
+            schema: {
+                tasks: z
+                    .array(strictArgs({
+                    name: z.string(),
+                    title: z.string(),
+                    assignee: z.string(),
+                    after: z.array(z.string()).default([]),
+                    brief: briefArg,
+                    ...loadoutArg,
+                }, { deps: 'use `after` with node names' }))
+                    .min(1),
+            },
+            handler: async (args) => text(planGraph(role.id, args.tasks ?? [])),
+        });
+    }
+    tools.push({
+        name: 'org_send',
+        description: 'Send a message to another agent (role id) or another org ("org:role"). This is the only inter-agent channel.' +
+            // D3: only orgs with a task-scoped role see this, so every other org's
+            // tool list (prefix position 0) is unchanged.
+            (opts.def?.roles.some((r) => resolveSessionScope(r, opts.def) === 'task')
+                ? " When a message is about a task, start its subject with [task:<id>] so a task-scoped recipient reads it in that task's session."
+                : ''),
+        schema: { to: z.string(), subject: z.string(), message: z.string() },
+        handler: async (args) => {
+            if (opts.beforeTool) {
+                const approved = await opts.beforeTool(role.id, 'org_send', args);
+                if (approved === false)
+                    return text('Tool "org_send" was denied by guardrail approval');
+                if (approved === null)
+                    return text('Tool "org_send" is pending human approval - you will receive the result when it is approved or denied.');
+            }
+            const receipt = await deliver(role.id, args.to, args.subject, args.message);
+            return text(receipt);
+        },
+    });
+    tools.push({
+        name: 'ask_human',
+        description: 'Ask a human a free-form question. Use only when you genuinely need human judgment. ' +
+            'Set blocking: true ONLY if you cannot continue until it is answered — a blocking question pauses the ' +
+            "org's idle watchdog (for up to an hour; after that the run resumes its normal idle checks either way). " +
+            'If you can keep working while you wait — an FYI, a preference, anything you would describe as "not blocking on this" — ' +
+            'pass blocking: false and carry on; the question is still recorded and answered, it just does not freeze the run. ' +
+            'Defaults to blocking.',
+        schema: { question: z.string(), blocking: z.boolean().optional() },
+        handler: async (args) => {
+            if (!opts.askHuman)
+                return text('ask_human is not available in this session');
+            const receipt = await opts.askHuman(role.id, args.question, args.blocking);
+            return text(receipt);
+        },
+    });
+    // Built-in org tools reject undeclared keys instead of stripping them: a
+    // stripped `deps` on an org_plan_graph node silently dropped every edge.
+    for (const t of tools)
+        t.strict ??= {};
+    return tools;
+}
+//# sourceMappingURL=org-tools.js.map

package/dist/src/orgrt/org-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-tools.js","sourceRoot":"","sources":["../../../src/orgrt/org-tools.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,4EAA4E;AAC5E,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;kFAMkF;AAClF,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,CAAS,EAAoB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAE5D,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;IAC7C,IAAI,eAAe,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,kBAAkB;YACxB,WAAW,EACT,yMAAyM;YAC3M,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;YAC7B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,eAAe,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAe,CAAC,CAAC;SACpF,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,YAAY;YAClB,WAAW,EACT,qJAAqJ;YACvJ,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;YAC7B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAe,CAAC,CAAC;SAC3E,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,0NAA0N;YAC5N,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE;YAC3E,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,IAAI,CACF,MAAM,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,OAAiB,EAAG,IAAI,CAAC,KAAyB,IAAI,KAAK,CAAC,CAC1F;SACJ,CAAC,CAAC;IACL,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,qUAAqU;YACvU,MAAM,EAAE;gBACN,KAAK,EAAE,CAAC;qBACL,KAAK,CACJ,UAAU,CAAC;oBACT,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;oBAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBACnC,CAAC,CACH;qBACA,QAAQ,EAAE;gBACb,KAAK,EAAE,CAAC;qBACL,KAAK,CACJ,UAAU,CAAC;oBACT,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;oBAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;oBAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;oBACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;iBACnC,CAAC,CACH;qBACA,QAAQ,EAAE;gBACb,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;aAC5F;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,IAAW,CAAC,CAAC;SACjE,CAAC,CAAC;IACL,CAAC;IACD,uEAAuE;IACvE,sEAAsE;IACtE,wEAAwE;IACxE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,i5EAAi5E;YACn5E,MAAM,EAAE;gBACN,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;gBAClD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;gBACnB,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;gBACnE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;aACrC;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAC/B,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,OAA4C,EACjD,IAAI,CAAC,OAAiB,EACtB,IAAI,CAAC,OAA+D,EACpE,IAAI,CAAC,aAAmC,CACzC,CAAC;gBACF,oEAAoE;gBACpE,uEAAuE;gBACvE,IAAI,OAAO;oBAAE,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;gBAClC,OAAO,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,YAAY,CAAC,CAAC;YACpD,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IACzC,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,kBAAkB;YACxB,WAAW,EACT,soBAAsoB;YACxoB,MAAM,EAAE;gBACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;gBAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC5B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACnC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;gBAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;aACrB;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACtB,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,IAAW,CAAC,CAAC;gBAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YACvC,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IACD,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,CAAC;IACvD,IAAI,oBAAoB,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,0BAA0B;YAChC,WAAW,EACT,2YAA2Y;YAC7Y,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,oBAAoB,EAAE,CAAC,CAAC;SACxE,CAAC,CAAC;IACL,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,UAAU;YAChB,WAAW,EACT,mSAAmS;YACrS,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;YACrD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,IAAI,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAc,EAAE,IAAI,CAAC,WAAqB,CAAC,CAAC;SAC/E,CAAC,CAAC;IACL,CAAC;IACD,oEAAoE;IACpE,gEAAgE;IAChE,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IAC9E,MAAM,UAAU,GAA8B,OAAO;QACnD,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAA0B,CAAC,CAAC,QAAQ,EAAE,EAAE;QACrF,CAAC,CAAC,EAAE,CAAC;IACP,0EAA0E;IAC1E,uEAAuE;IACvE,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3D,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxD,IAAI,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACvC,IAAI,YAAY,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,IAAI,CAAC,mBAAmB;gBACnC,CAAC,CAAC,ykEAAykE;gBAC3kE,CAAC,CAAC,yJAAyJ;YAC7J,MAAM,EAAE;gBACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;gBAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC7B,QAAQ,EAAE,UAAU,CAAC;oBACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;oBACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;oBAC/B,MAAM,EAAE,CAAC;yBACN,KAAK,CACJ,UAAU,CAAC;wBACT,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;wBACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;wBAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;wBACvC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;wBACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;qBAC9B,CAAC,CACH;yBACA,OAAO,CAAC,EAAE,CAAC;iBACf,CAAC,CAAC,QAAQ,EAAE;aACd;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,IAAI,CACF,YAAY,CACV,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,MAAgB,EACrB,IAAI,CAAC,MAA4B,EACjC,IAAI,CAAC,QAAoC,CAC1C,CACF;SACJ,CAAC,CAAC;IACL,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IACzC,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,YAAY;YAClB,WAAW,EACT,+ZAA+Z;YACja,MAAM,EAAE;gBACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;gBAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;gBACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;aACjF;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,IAAI,CACF,aAAa,CACX,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,MAAgB,EACrB,IAAI,CAAC,QAAkB,EACvB,IAAI,CAAC,IAA0B,CAChC,CACF;SACJ,CAAC,CAAC;IACL,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACjC,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,WAAW;YACjB,WAAW,EACT,sJAAsJ;YACxJ,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;YACzC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAA4B,CAAC,CAAC;SAC5E,CAAC,CAAC;IACL,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACjC,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,gBAAgB;YACtB,WAAW,EACT,wKAAwK;YAC1K,MAAM,EAAE;gBACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;gBACpB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;aAClF;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,IAAI,CACF,SAAS,CACP,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,QAAkB,EACtB,IAAI,CAAC,QAAkD,IAAI,EAAE,CAC/D,CACF;SACJ,CAAC,CAAC;IACL,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACjC,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,gBAAgB;YACtB,WAAW,EACT,4IAA4I;YAC9I,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;YACtD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,QAAkB,EAAE,IAAI,CAAC,QAAkB,CAAC,CAAC;SAC7E,CAAC,CAAC;IACL,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACnC,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,iBAAiB;YACvB,WAAW,EACT,kPAAkP;YACpP,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC7D,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,MAAgB,EAAE,IAAI,CAAC,MAA4B,CAAC,CAAC;SACtF,CAAC,CAAC;IACL,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACjC,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,s7BAAs7B,yBAAyB,wDAAwD;YACphC,MAAM,EAAE;gBACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;gBAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;gBACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;gBAC7B,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,QAAQ,EAAE;aACrF;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,IAAI,CACF,SAAS,CACP,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,MAAgB,EACrB,IAAI,CAAC,QAAkB,EACvB,IAAI,CAAC,MAA4B,EACjC,IAAI,CAAC,mBAAyC,CAC/C,CACF;SACJ,CAAC,CAAC;IACL,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACjC,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,gBAAgB;YACtB,WAAW,EACT,kMAAkM;gBAClM,CAAC,OAAO,CAAC,CAAC,CAAC,6DAA6D,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,MAAM,EAAE;gBACN,KAAK,EAAE,CAAC;qBACL,KAAK,CACJ,UAAU,CACR;oBACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;oBAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;oBACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;oBACpB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;oBACtC,KAAK,EAAE,QAAQ;oBACf,GAAG,UAAU;iBACd,EACD,EAAE,IAAI,EAAE,6BAA6B,EAAE,CACxC,CACF;qBACA,GAAG,CAAC,CAAC,CAAC;aACV;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACtB,IAAI,CACF,SAAS,CACP,IAAI,CAAC,EAAE,EACN,IAAI,CAAC,KAOF,IAAI,EAAE,CACX,CACF;SACJ,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,IAAI,CAAC;QACT,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,8GAA8G;YAC9G,uEAAuE;YACvE,8CAA8C;YAC9C,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC;gBACvE,CAAC,CAAC,iIAAiI;gBACnI,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;QACpE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;gBAClE,IAAI,QAAQ,KAAK,KAAK;oBAAE,OAAO,IAAI,CAAC,kDAAkD,CAAC,CAAC;gBACxF,IAAI,QAAQ,KAAK,IAAI;oBACnB,OAAO,IAAI,CACT,wGAAwG,CACzG,CAAC;YACN,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAC3B,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,EAAY,EACjB,IAAI,CAAC,OAAiB,EACtB,IAAI,CAAC,OAAiB,CACvB,CAAC;YACF,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;IACH,KAAK,CAAC,IAAI,CAAC;QACT,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,qFAAqF;YACrF,uGAAuG;YACvG,yGAAyG;YACzG,yHAAyH;YACzH,mHAAmH;YACnH,uBAAuB;QACzB,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;QAClE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC,4CAA4C,CAAC,CAAC;YAC9E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CACjC,IAAI,CAAC,EAAE,EACP,IAAI,CAAC,QAAkB,EACvB,IAAI,CAAC,QAA+B,CACrC,CAAC;YACF,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;IACH,yEAAyE;IACzE,yEAAyE;IACzE,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC;IACvC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/orgrt/role-incarnation.d.ts

@@ -0,0 +1,18 @@
+import { type RoleCheckpoint } from './checkpoint.js';
+import { OrgDaemon } from './daemon.js';
+import type { AgentRuntime, RunningOrg } from './daemon-types.js';
+import { type OrgRole } from './types.js';
+/** Build one role incarnation: mailbox, policy, AgentRuntime, sessionOpts,
+ *  and the supervised crash-retry loop. Used by BOTH the startup lazy-spawn
+ *  path (generation 0, via the `spawnRole` closure inside startOrgInner)
+ *  and respawnRole() (generation N+1). Does not touch running.agents or
+ *  running.roleSlots — callers publish the result themselves. */
+export declare function spawnRoleIncarnation(daemon: OrgDaemon, name: string, running: RunningOrg, role: OrgRole, generation: number, opts?: {
+    roleCheckpoint?: RoleCheckpoint;
+    abort?: AbortController;
+    budgetTokensOverride?: number;
+}): {
+    runtime: AgentRuntime;
+    abort: AbortController;
+};
+//# sourceMappingURL=role-incarnation.d.ts.map

package/dist/src/orgrt/role-incarnation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-incarnation.d.ts","sourceRoot":"","sources":["../../../src/orgrt/role-incarnation.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,cAAc,EAA2C,MAAM,iBAAiB,CAAC;AAC/F,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAYlE,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;iEAIiE;AACjE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,EACnB,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE;IACJ,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC1B,GACL;IAAE,OAAO,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CA+WnD"}