@sema-agent/core 7.63.0 → 7.65.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +725 -0
- package/dist/agents/cc-peer-directory.js +1 -0
- package/dist/agents/cc-peer-wire.d.ts +4 -0
- package/dist/agents/cc-peer-wire.js +1 -0
- package/dist/agents/cc-uds-peer-channel.js +5 -0
- package/dist/agents/cross-session-judge.d.ts +3 -1
- package/dist/agents/cross-session-judge.js +4 -1
- package/dist/agents/peer-directory.d.ts +8 -0
- package/dist/agents/peer-directory.js +4 -0
- package/dist/agents/peer-held-queue.d.ts +9 -3
- package/dist/agents/peer-held-queue.js +12 -9
- package/dist/agents/peer-idle.d.ts +20 -1
- package/dist/agents/peer-idle.js +23 -12
- package/dist/agents/peer-notice-route.d.ts +16 -5
- package/dist/agents/peer-notice-route.js +11 -9
- package/dist/agents/peer-notices.d.ts +25 -8
- package/dist/agents/peer-notices.js +6 -1
- package/dist/agents/peer-session-drain.d.ts +32 -6
- package/dist/agents/peer-session-drain.js +100 -26
- package/dist/agents/send-message-tool.d.ts +7 -0
- package/dist/agents/send-message-tool.js +18 -6
- package/dist/agents/subagent.js +25 -5
- package/dist/core/allow-entry.d.ts +4 -0
- package/dist/core/ask-origin.d.ts +1 -1
- package/dist/core/ask-origin.js +2 -2
- package/dist/core/ask-unresolvable-notice.d.ts +13 -4
- package/dist/core/ask-unresolvable-notice.js +10 -3
- package/dist/core/auto-compaction.d.ts +7 -5
- package/dist/core/auto-promote.d.ts +3 -2
- package/dist/core/background-agent-store.d.ts +14 -0
- package/dist/core/background-agent-store.js +3 -0
- package/dist/core/checkpoint-queries.d.ts +9 -6
- package/dist/core/checkpoint-queries.js +8 -3
- package/dist/core/checkpoint-store.d.ts +7 -4
- package/dist/core/context-settings.d.ts +39 -9
- package/dist/core/context-settings.js +32 -10
- package/dist/core/engine-attestation.d.ts +26 -6
- package/dist/core/engine-attestation.js +5 -1
- package/dist/core/engine-notice.d.ts +37 -2
- package/dist/core/engine-notice.js +3 -1
- package/dist/core/extension-requester.d.ts +9 -0
- package/dist/core/extension-requester.js +7 -0
- package/dist/core/file-history-store.d.ts +30 -2
- package/dist/core/file-history-store.js +48 -9
- package/dist/core/fs-write-gate-policy.js +1 -1
- package/dist/core/gate-fold.js +5 -1
- package/dist/core/gate-lanes.js +2 -0
- package/dist/core/gate-outcome.d.ts +39 -2
- package/dist/core/gate-outcome.js +20 -1
- package/dist/core/governance-codes.d.ts +8 -4
- package/dist/core/governance-codes.js +8 -3
- package/dist/core/leg-identity.d.ts +35 -1
- package/dist/core/leg-identity.js +10 -0
- package/dist/core/mailbox-store.d.ts +39 -4
- package/dist/core/mailbox-store.js +14 -2
- package/dist/core/memory-engine/consolidation.d.ts +13 -6
- package/dist/core/memory-engine/consolidation.js +26 -0
- package/dist/core/memory-engine/control-objects.d.ts +58 -0
- package/dist/core/memory-engine/control-objects.js +273 -0
- package/dist/core/memory-engine/control-plane-adoption.d.ts +51 -0
- package/dist/core/memory-engine/control-plane-adoption.js +161 -0
- package/dist/core/memory-engine/delegation-settlement.d.ts +73 -40
- package/dist/core/memory-engine/delegation-settlement.js +271 -107
- package/dist/core/memory-engine/dual-root.d.ts +3 -2
- package/dist/core/memory-engine/dual-root.js +7 -3
- package/dist/core/memory-engine/engine.d.ts +54 -33
- package/dist/core/memory-engine/engine.js +150 -157
- package/dist/core/memory-engine/file-backend.d.ts +58 -76
- package/dist/core/memory-engine/file-backend.js +111 -268
- package/dist/core/memory-engine/index.d.ts +3 -2
- package/dist/core/memory-engine/index.js +2 -1
- package/dist/core/memory-engine/layout.d.ts +135 -50
- package/dist/core/memory-engine/layout.js +214 -89
- package/dist/core/memory-engine/memory-age.d.ts +12 -0
- package/dist/core/memory-engine/memory-age.js +17 -0
- package/dist/core/memory-engine/memory-backend-contract.d.ts +10 -3
- package/dist/core/memory-engine/memory-backend-contract.js +159 -2
- package/dist/core/memory-engine/memory-deployment.d.ts +12 -4
- package/dist/core/memory-engine/memory-deployment.js +31 -6
- package/dist/core/memory-engine/origin-clearance.d.ts +12 -3
- package/dist/core/memory-engine/origin-clearance.js +64 -9
- package/dist/core/memory-engine/session-write-home.d.ts +34 -1
- package/dist/core/memory-engine/session-write-home.js +37 -10
- package/dist/core/memory-engine/tools.d.ts +2 -2
- package/dist/core/memory-engine/tools.js +7 -7
- package/dist/core/memory-engine/types.d.ts +55 -12
- package/dist/core/memory-engine/types.js +2 -1
- package/dist/core/memory-vector.d.ts +6 -14
- package/dist/core/memory.d.ts +0 -462
- package/dist/core/memory.js +0 -333
- package/dist/core/mode-policy.js +3 -3
- package/dist/core/mods/agent-stations.d.ts +18 -0
- package/dist/core/mods/agent-stations.js +8 -6
- package/dist/core/mods/extension-call.d.ts +4 -0
- package/dist/core/mods/extension-call.js +8 -0
- package/dist/core/mods/tool-call.js +3 -4
- package/dist/core/parent-spec-seat.d.ts +2 -2
- package/dist/core/peer-channel.d.ts +5 -0
- package/dist/core/permission-rule-consent.d.ts +64 -22
- package/dist/core/permission-rule-consent.js +106 -58
- package/dist/core/permission-rule-store.d.ts +56 -21
- package/dist/core/permission-rule-store.js +2 -0
- package/dist/core/refusal-echo.d.ts +20 -0
- package/dist/core/refusal-echo.js +33 -0
- package/dist/core/retention.d.ts +175 -10
- package/dist/core/retention.js +44 -0
- package/dist/core/retired-keys.d.ts +5 -0
- package/dist/core/retired-keys.js +3 -0
- package/dist/core/rule-offer-read.d.ts +0 -4
- package/dist/core/rule-offer-read.js +2 -18
- package/dist/core/runner/classifier-ladder.d.ts +10 -2
- package/dist/core/runner/classifier-ladder.js +4 -2
- package/dist/core/runner/compact-session.js +10 -7
- package/dist/core/runner/compaction-call-options.d.ts +7 -7
- package/dist/core/runner/compaction-call-options.js +3 -2
- package/dist/core/runner/contracts.d.ts +28 -9
- package/dist/core/runner/delegation-owner.d.ts +2 -3
- package/dist/core/runner/delegation-owner.js +2 -1
- package/dist/core/runner/gate-exit.d.ts +6 -0
- package/dist/core/runner/gate-exit.js +11 -2
- package/dist/core/runner/memory-consolidation-driver.d.ts +4 -2
- package/dist/core/runner/memory-consolidation-driver.js +8 -5
- package/dist/core/runner/prepare-ask-lane.js +3 -3
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +3 -1
- package/dist/core/runner/prepare-caps-and-workflow.js +2 -2
- package/dist/core/runner/prepare-config-doors.js +4 -0
- package/dist/core/runner/prepare-delegation-surface.d.ts +3 -0
- package/dist/core/runner/prepare-delegation-surface.js +2 -2
- package/dist/core/runner/prepare-gate-stations.d.ts +8 -0
- package/dist/core/runner/prepare-gate-stations.js +15 -7
- package/dist/core/runner/prepare-hands-readface.js +1 -1
- package/dist/core/runner/prepare-inherited-gate.d.ts +3 -1
- package/dist/core/runner/prepare-inherited-gate.js +4 -2
- package/dist/core/runner/prepare-memory-engine-session.js +1 -1
- package/dist/core/runner/prepare-memory.d.ts +4 -0
- package/dist/core/runner/prepare-memory.js +22 -28
- package/dist/core/runner/prepare-policy-chain.js +18 -10
- package/dist/core/runner/prepare-prompt-inputs.js +1 -1
- package/dist/core/runner/prepare-task.d.ts +5 -1
- package/dist/core/runner/prepare-task.js +16 -11
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -1
- package/dist/core/runner/prepare-wiring-manifest.js +3 -2
- package/dist/core/runner/resume-admission.d.ts +2 -2
- package/dist/core/runner/resume-admission.js +2 -23
- package/dist/core/runner/role-resolution-table.d.ts +98 -0
- package/dist/core/runner/role-resolution-table.js +62 -0
- package/dist/core/runner/run-compaction-machinery.js +2 -2
- package/dist/core/runner/run-identity-wiring.js +12 -9
- package/dist/core/runner/run-leg.js +8 -4
- package/dist/core/runner/run-notification-lane.js +23 -23
- package/dist/core/runner/run-recovery-lanes.js +3 -3
- package/dist/core/runner/run-terminal-adoption.js +1 -1
- package/dist/core/runner/run-turn-boundary.js +14 -15
- package/dist/core/runner/runtask.js +1 -1
- package/dist/core/runner/sub-agent-deny-lists.d.ts +19 -0
- package/dist/core/runner/sub-agent-deny-lists.js +25 -0
- package/dist/core/runner/tool-occurrence.d.ts +4 -2
- package/dist/core/runner/tool-occurrence.js +2 -2
- package/dist/core/runner-deps.d.ts +1 -1
- package/dist/core/secret-env.d.ts +2 -2
- package/dist/core/secret-env.js +6 -20
- package/dist/core/session-checkout.d.ts +63 -3
- package/dist/core/session-checkout.js +152 -58
- package/dist/core/session-store.d.ts +6 -6
- package/dist/core/session-store.js +3 -3
- package/dist/core/shell-read-silence.js +8 -0
- package/dist/core/store-contracts/background-agent-store-contract.js +13 -0
- package/dist/core/store-contracts/peer-directory-contract.js +8 -1
- package/dist/core/task-event.d.ts +9 -5
- package/dist/core/task-notification.d.ts +137 -31
- package/dist/core/task-notification.js +198 -100
- package/dist/core/task-registry-agent.d.ts +11 -0
- package/dist/core/task-registry-agent.js +12 -3
- package/dist/core/task-registry-shared.d.ts +11 -0
- package/dist/core/task-registry.d.ts +18 -0
- package/dist/core/task-registry.js +27 -8
- package/dist/core/task-spec.d.ts +7 -2
- package/dist/core/tool-errors.d.ts +17 -9
- package/dist/core/tool-errors.js +1 -1
- package/dist/core/tool-policy.d.ts +18 -1
- package/dist/core/tool-policy.js +16 -7
- package/dist/core/tool-result-store.d.ts +20 -0
- package/dist/core/tool-spec.d.ts +10 -6
- package/dist/core/trace.d.ts +3 -2
- package/dist/core/workflow-journal-store.d.ts +11 -0
- package/dist/core/workflow-journal-store.js +7 -0
- package/dist/core/workflow-run-store.d.ts +9 -0
- package/dist/core/workflow-run-store.js +6 -0
- package/dist/core/write-protect.d.ts +16 -0
- package/dist/core/write-protect.js +10 -0
- package/dist/engine/compaction/compaction.d.ts +2 -1
- package/dist/engine/harness/types.d.ts +1 -0
- package/dist/engine/session/repo-utils.d.ts +14 -4
- package/dist/engine/session/repo-utils.js +5 -4
- package/dist/engine/session/session.d.ts +7 -1
- package/dist/engine/session/session.js +5 -2
- package/dist/index.d.ts +13 -11
- package/dist/index.js +13 -11
- package/dist/orchestration/run-workflow-tool.d.ts +4 -0
- package/dist/orchestration/run-workflow-tool.js +7 -0
- package/dist/orchestration/workflow-types.d.ts +2 -1
- package/dist/orchestration/workflow.d.ts +3 -0
- package/dist/orchestration/workflow.js +2 -1
- package/dist/prompts/default.d.ts +1 -2
- package/dist/scenarios/full-body.d.ts +1 -1
- package/dist/stores/file/adoption/adopt.d.ts +1 -1
- package/dist/stores/file/checkpoint-store.d.ts +6 -0
- package/dist/stores/file/checkpoint-store.js +4 -1
- package/dist/stores/file/file-history-store.d.ts +13 -0
- package/dist/stores/file/file-history-store.js +75 -13
- package/dist/stores/file/index.d.ts +12 -16
- package/dist/stores/file/index.js +7 -25
- package/dist/stores/file/permission-rule-store.d.ts +34 -0
- package/dist/stores/file/permission-rule-store.js +104 -9
- package/dist/stores/file/session-store.js +1 -1
- package/dist/stores/file/tool-result-store.d.ts +14 -0
- package/dist/stores/file/tool-result-store.js +39 -2
- package/dist/stores/file/workflow-journal-store.d.ts +4 -0
- package/dist/stores/file/workflow-journal-store.js +17 -0
- package/dist/stores/file/workflow-run-store.d.ts +3 -0
- package/dist/stores/file/workflow-run-store.js +15 -0
- package/dist/tools/fs/read-deny.d.ts +15 -2
- package/dist/tools/fs/read-deny.js +10 -2
- package/dist/tools/fs/shell-read-check.d.ts +8 -2
- package/dist/tools/fs/shell-read-check.js +7 -7
- package/package.json +2 -2
- package/test/export-surface.snapshot.json +71 -73
- package/wire-changes/core-stores-sql@7.64.0.json +30 -0
- package/wire-changes/core-stores-sql@7.65.0.json +30 -0
- package/wire-changes/core@7.64.0.json +2653 -0
- package/wire-changes/core@7.65.0.json +1650 -0
- package/wire-changes/mods-kernel@7.64.0.json +30 -0
- package/wire-changes/mods-kernel@7.65.0.json +30 -0
- package/wire-changes/primitives@7.64.0.json +30 -0
- package/wire-changes/primitives@7.65.0.json +337 -0
- package/dist/core/memory-recall.d.ts +0 -208
- package/dist/core/memory-recall.js +0 -136
- package/dist/stores/file/memory-store.d.ts +0 -124
- package/dist/stores/file/memory-store.js +0 -353
|
@@ -19,10 +19,17 @@ export function askUnresolvableRemedySeat(cause) {
|
|
|
19
19
|
return CAUSE_REMEDY_SEAT[cause];
|
|
20
20
|
}
|
|
21
21
|
export function askUnresolvableNotice(facts) {
|
|
22
|
-
const { sessionId, toolName, toolCallId, cause, parkLaneExisted, remedy, remedies } = facts;
|
|
22
|
+
const { sessionId, sourceSessionId, agentId, toolName, toolCallId, cause, parkLaneExisted, remedy, remedies } = facts;
|
|
23
23
|
if (typeof sessionId !== "string" || sessionId.length === 0) {
|
|
24
24
|
throw new TypeError("delegation.ask_unresolvable: sessionId is required — a user-audience notice with no session routes nowhere");
|
|
25
25
|
}
|
|
26
|
+
if (sourceSessionId !== undefined && (typeof sourceSessionId !== "string" || sourceSessionId.length === 0)) {
|
|
27
|
+
throw new TypeError("delegation.ask_unresolvable: sourceSessionId, when present, names the delegated leg's session");
|
|
28
|
+
}
|
|
29
|
+
if (agentId !== undefined && (sourceSessionId === undefined || typeof agentId !== "string" || agentId.length === 0)) {
|
|
30
|
+
throw new TypeError("delegation.ask_unresolvable: agentId, when present, is a non-empty id riding beside sourceSessionId");
|
|
31
|
+
}
|
|
32
|
+
const delegated = sourceSessionId !== undefined;
|
|
26
33
|
if (typeof toolName !== "string" || toolName.length === 0) {
|
|
27
34
|
throw new TypeError("delegation.ask_unresolvable: toolName is required");
|
|
28
35
|
}
|
|
@@ -48,9 +55,9 @@ export function askUnresolvableNotice(facts) {
|
|
|
48
55
|
const park = parkLaneExisted ? "the durable approval park did not take it" : "no durable approval park is armed for this run";
|
|
49
56
|
return {
|
|
50
57
|
code: "delegation.ask_unresolvable",
|
|
51
|
-
message: `approval for "${toolName}" could not be resolved: ${CAUSE_CLAUSE[cause]} and ${park} — ` +
|
|
58
|
+
message: `approval for "${toolName}"${delegated ? " (a delegated agent's call)" : ""} could not be resolved: ${CAUSE_CLAUSE[cause]} and ${park} — ` +
|
|
52
59
|
`the call was denied fail-closed and did not run. ${typeof remedy === "string" && remedy.length > 0 ? `To let it run: ${remedy}. ` : ""}To let such approvals wait for a person, run with a checkpoint store and a ` +
|
|
53
60
|
`durable approval opt-in (or a live approver reachable for delegated children).`,
|
|
54
|
-
detail: { sessionId, toolName, toolCallId, cause, parkLaneExisted: parkLaneExisted === true, ...(typeof remedy === "string" && remedy.length > 0 ? { remedy } : {}), ...(remedyList !== undefined ? { remedies: remedyList } : {}) },
|
|
61
|
+
detail: { sessionId, ...(delegated ? { sourceSessionId } : {}), ...(agentId !== undefined ? { agentId } : {}), toolName, toolCallId, cause, parkLaneExisted: parkLaneExisted === true, ...(typeof remedy === "string" && remedy.length > 0 ? { remedy } : {}), ...(remedyList !== undefined ? { remedies: remedyList } : {}) },
|
|
55
62
|
};
|
|
56
63
|
}
|
|
@@ -579,9 +579,10 @@ export declare function maybeCompact(opts: MaybeCompactOptions): Promise<{
|
|
|
579
579
|
* (auto/manual triggers only — never on "forced"). NOT a failure: the caller must not count it
|
|
580
580
|
* toward the compaction breaker; the next boundary consults the callback again. */
|
|
581
581
|
blocked?: boolean;
|
|
582
|
-
/** MF-18 修①: set (with `compacted:false`) when
|
|
583
|
-
*
|
|
584
|
-
* /compact with the honest `"disabled"` outcome (and
|
|
582
|
+
/** MF-18 修①: set (with `compacted:false`) when this pass is DISABLED by its settings (`enabled:false`
|
|
583
|
+
* — the pass's own gate; a run's lanes resolve it from the seat of the pass they run, `autoCompact` or
|
|
584
|
+
* `manualCompact`). Lets the caller resolve a manual /compact with the honest `"disabled"` outcome (and
|
|
585
|
+
* trace frame) instead of a structural noop. */
|
|
585
586
|
disabled?: boolean;
|
|
586
587
|
/** Set (with `compacted:false`) when the pass PASSED the trigger gate
|
|
587
588
|
* (natural or forced) but found nothing to summarize — no valid cut point / empty history. Was
|
|
@@ -755,8 +756,9 @@ export interface CompactSessionRequest {
|
|
|
755
756
|
/** This pass's summarization instructions: they REPLACE `compaction.instructions` and the default for this pass (the
|
|
756
757
|
* `TaskStream.compact` reading); sanitized and capped like every instructions channel. */
|
|
757
758
|
instructions?: string;
|
|
758
|
-
/** The members of `TaskSpec.compaction` a pass reads, as a run would carry them
|
|
759
|
-
|
|
759
|
+
/** The members of `TaskSpec.compaction` a pass reads, as a run would carry them — of the two seats only `manualCompact`
|
|
760
|
+
* (this pass is a requested one; `false` answers `"disabled"`, and absent reads the deployment's twin, else on). */
|
|
761
|
+
compaction?: Pick<NonNullable<TaskSpec["compaction"]>, "manualCompact" | "reserveTokens" | "keepRecentTokens" | "instructions" | "clampTolerance">;
|
|
760
762
|
/** The independent summary model (`TaskSpec.compactionModel`); absent ⇒ the deployment's `summarize` role (or its tier
|
|
761
763
|
* default), else the main model. A role-derived model whose key↔URL pairing is broken falls back to the main model,
|
|
762
764
|
* announced, as on a run. */
|
|
@@ -16,8 +16,9 @@ export type AutoPromoteTerminal = "auto_promote" | "candidate_only" | "needs_hum
|
|
|
16
16
|
*/
|
|
17
17
|
export interface PromotedRecord {
|
|
18
18
|
/**
|
|
19
|
-
* Gate-2
|
|
20
|
-
*
|
|
19
|
+
* Gate-2 result: the promotable write landed WITH a positive utility verdict, or it was absent/ungated. The core
|
|
20
|
+
* ships no Gate-2 door since 7.65.0 — the caller computes this verdict itself and hands it in. Only
|
|
21
|
+
* `"present_positive"` is gate-passing; `"absent_or_ungated"` ⇒ needs_human.
|
|
21
22
|
*/
|
|
22
23
|
gate2Verdict: "present_positive" | "absent_or_ungated";
|
|
23
24
|
}
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import type { SubagentEditedFile, SubagentStep } from "../agents/subagent-steps.js";
|
|
2
2
|
import type { SubagentTranscriptTier } from "./wiring-manifest.js";
|
|
3
|
+
import type { ExtensionRequester } from "./task-event.js";
|
|
3
4
|
/** Terminal/live usage rollup persisted on the row (mirror of the task_notification/BCE fields). */
|
|
4
5
|
export interface BackgroundAgentUsage {
|
|
5
6
|
totalTokens?: number;
|
|
@@ -37,6 +38,13 @@ export interface BackgroundAgentRecord {
|
|
|
37
38
|
* restart, intermediate spawner sessions are dead ends — "everything under this host session"
|
|
38
39
|
* keys on THIS field (listBySession matches it as a second arm), not on an alias walk. */
|
|
39
40
|
rootSessionId?: string;
|
|
41
|
+
/** The occupant of {@link rootSessionId}'s row (its `SessionMetadata.incarnation`) as the spawning tree held it — the other
|
|
42
|
+
* half of the root anchor's address, written beside it by the registration that creates the row. A revival reads it back
|
|
43
|
+
* with the anchor, so the frames its subtree escalates to the root are addressed to the occupant the tree was born under
|
|
44
|
+
* (delivered while that occupant holds the root, discarded and announced once the id was created again). ABSENT = the
|
|
45
|
+
* spawning tree held no occupant for its root, or a row an earlier release wrote: the revived tree's root occupant is
|
|
46
|
+
* then unknown. A store returns it as written, absent as absent. */
|
|
47
|
+
rootSessionIncarnation?: string;
|
|
40
48
|
parentTaskId?: string;
|
|
41
49
|
/** The agent's name — the spawner's explicit one, or the one the engine derives from `handle`
|
|
42
50
|
* (`engineAgentName`) when the spawn named none. Written by the registration that creates the row, so
|
|
@@ -44,6 +52,11 @@ export interface BackgroundAgentRecord {
|
|
|
44
52
|
* earlier version wrote without one derives it from `handle` with the same function. */
|
|
45
53
|
name: string;
|
|
46
54
|
agentType?: string;
|
|
55
|
+
/** Who started the agent when an extension did: the extension, by its registration name (`$.agent.spawn`). Written once, by the
|
|
56
|
+
* registration that creates the row; a revival keeps it (the row's origin, not the waker's). ABSENT = not an extension's spawn
|
|
57
|
+
* (the model's own, the host's) — and every row an earlier release wrote: the one reading, with no word for either. A display and
|
|
58
|
+
* audit fact only — it decides nothing. */
|
|
59
|
+
requestedBy?: ExtensionRequester;
|
|
47
60
|
description?: string;
|
|
48
61
|
/** Revival lookup key (CC meta-sidecar parity); populated when known, never required. The team
|
|
49
62
|
* key is {@link rootSessionId} — one implicit team per session, no column of its own. */
|
|
@@ -208,6 +221,7 @@ export interface BackgroundAgentRowSummary {
|
|
|
208
221
|
rootSessionId?: string;
|
|
209
222
|
name: string;
|
|
210
223
|
agentType?: string;
|
|
224
|
+
requestedBy?: ExtensionRequester;
|
|
211
225
|
status: BackgroundAgentRecord["status"];
|
|
212
226
|
spawnedAt: number;
|
|
213
227
|
updatedAt: number;
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import { uuidv7 } from "../internal/harness.js";
|
|
2
2
|
import { receiveRetentionPolicy } from "./retention-policy.js";
|
|
3
|
+
import { readExtensionRequester } from "./extension-requester.js";
|
|
3
4
|
export const REVIVED_ROW_CLEARED_FIELDS = Object.freeze([
|
|
4
5
|
"settledAt",
|
|
5
6
|
"stoppedBy",
|
|
@@ -178,6 +179,7 @@ export async function reconcileParkedAgents(stores, scope, now, opts) {
|
|
|
178
179
|
return out;
|
|
179
180
|
}
|
|
180
181
|
function toSummary(r) {
|
|
182
|
+
const requestedBy = readExtensionRequester(r.requestedBy);
|
|
181
183
|
return {
|
|
182
184
|
handle: r.handle,
|
|
183
185
|
owner: r.owner,
|
|
@@ -187,6 +189,7 @@ function toSummary(r) {
|
|
|
187
189
|
...(r.rootSessionId !== undefined ? { rootSessionId: r.rootSessionId } : {}),
|
|
188
190
|
name: r.name,
|
|
189
191
|
...(r.agentType !== undefined ? { agentType: r.agentType } : {}),
|
|
192
|
+
...(requestedBy !== undefined ? { requestedBy } : {}),
|
|
190
193
|
status: r.status,
|
|
191
194
|
spawnedAt: r.spawnedAt,
|
|
192
195
|
updatedAt: r.updatedAt,
|
|
@@ -174,18 +174,21 @@ interface RowMembers {
|
|
|
174
174
|
readonly deadline: unknown;
|
|
175
175
|
readonly state: unknown;
|
|
176
176
|
readonly checkpointId: unknown;
|
|
177
|
+
readonly resourceLedger: unknown;
|
|
177
178
|
}
|
|
178
179
|
/** The members {@link ROW_MEMBER_SHAPES} reads — no other (none a store's own transitions rewrite). */
|
|
179
|
-
type ShapeMembers = Pick<RowMembers, "gate" | "pendingAction" | "state" | "createdAt" | "deadline">;
|
|
180
|
+
type ShapeMembers = Pick<RowMembers, "gate" | "pendingAction" | "state" | "createdAt" | "deadline" | "resourceLedger" | "checkpointId">;
|
|
180
181
|
/**
|
|
181
182
|
* THE ROW'S MEMBER SHAPES — the reading every reader of a stored row makes of the members it reaches into, written once: the row
|
|
182
183
|
* judge (`judgeCheckpointRow`, the resume's first rung), the listing projection (`summarizeCheckpoint`) and the listing faces read
|
|
183
184
|
* this table and no shape test of their own, so over these members no face answers `ok` for a row another cannot read. The gate a
|
|
184
|
-
* record of a registered gate kind; the pending action a record of a registered pending kind
|
|
185
|
-
* id; the state a record; `createdAt` a finite number; `deadline` absent or a finite number
|
|
186
|
-
*
|
|
185
|
+
* record of a registered gate kind; the pending action a record of a registered pending kind — the one the gate's kind pairs with in
|
|
186
|
+
* the pause registry — a tool approval carrying a tool call id; the state a record; `createdAt` a finite number; `deadline` absent or a finite number; the resource ledger absent or a record
|
|
187
|
+
* (the summary reads its spend); the checkpoint id absent or a non-empty string (the summary echoes it and names the row by it: an
|
|
188
|
+
* empty one names no row, and no writer mints one). Each entry names the member by its shape, never a particular value; `undefined`
|
|
189
|
+
* = it reads.
|
|
187
190
|
*/
|
|
188
|
-
declare const ROW_MEMBER_SHAPES: readonly [readonly ["gate", (m: ShapeMembers) => string | undefined], readonly ["pendingAction", (m: ShapeMembers) => string | undefined], readonly ["state", (m: ShapeMembers) => string | undefined], readonly ["createdAt", (m: ShapeMembers) => string | undefined], readonly ["deadline", (m: ShapeMembers) => string | undefined]];
|
|
191
|
+
declare const ROW_MEMBER_SHAPES: readonly [readonly ["gate", (m: ShapeMembers) => string | undefined], readonly ["pendingAction", (m: ShapeMembers) => string | undefined], readonly ["state", (m: ShapeMembers) => string | undefined], readonly ["createdAt", (m: ShapeMembers) => string | undefined], readonly ["deadline", (m: ShapeMembers) => string | undefined], readonly ["resourceLedger", (m: ShapeMembers) => string | undefined], readonly ["checkpointId", (m: ShapeMembers) => string | undefined]];
|
|
189
192
|
/** A member {@link ROW_MEMBER_SHAPES} names. */
|
|
190
193
|
export type RowMemberName = (typeof ROW_MEMBER_SHAPES)[number][0];
|
|
191
194
|
/** The first member of a row that does not read as {@link ROW_MEMBER_SHAPES} says, and the table's words for it. */
|
|
@@ -195,7 +198,7 @@ export interface RowMemberProblem {
|
|
|
195
198
|
}
|
|
196
199
|
/**
|
|
197
200
|
* Where a row's members fail {@link ROW_MEMBER_SHAPES} — the one reading the row judge, the summary projection and the listing faces
|
|
198
|
-
* make of them: the first member that does not read and the table's words for it; `undefined` = every member reads. Reads the
|
|
201
|
+
* make of them: the first member that does not read and the table's words for it; `undefined` = every member reads. Reads the seven
|
|
199
202
|
* members the table names, each once. May throw (a member that throws when read); the caller is total.
|
|
200
203
|
*/
|
|
201
204
|
export declare function rowMemberProblem(cp: Checkpoint): RowMemberProblem | undefined;
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { types } from "node:util";
|
|
2
|
-
import { facetOf, isGateKind, isPendingKind } from "./pause-registry.js";
|
|
2
|
+
import { facetOf, isGateKind, isPendingKind, PAUSE_REGISTRY } from "./pause-registry.js";
|
|
3
3
|
import { receiptRefusal, receiveOwnProperties } from "./own-property-receipt.js";
|
|
4
4
|
import { principalNameOf } from "./principal-name.js";
|
|
5
5
|
export const CHECKPOINT_LIST_LIMITS = Object.freeze({
|
|
@@ -132,7 +132,7 @@ function orderKey(value) {
|
|
|
132
132
|
return typeof value === "number" && Number.isFinite(value) ? value : -Infinity;
|
|
133
133
|
}
|
|
134
134
|
function membersOf(key, cp) {
|
|
135
|
-
return { key, token: cp.token, sessionId: cp.sessionId, scope: cp.scope, status: cp.status, gate: cp.gate, pendingAction: cp.pendingAction, createdAt: cp.createdAt, deadline: cp.deadline, state: cp.state, checkpointId: cp.checkpointId };
|
|
135
|
+
return { key, token: cp.token, sessionId: cp.sessionId, scope: cp.scope, status: cp.status, gate: cp.gate, pendingAction: cp.pendingAction, createdAt: cp.createdAt, deadline: cp.deadline, state: cp.state, checkpointId: cp.checkpointId, resourceLedger: cp.resourceLedger };
|
|
136
136
|
}
|
|
137
137
|
const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
|
|
138
138
|
function memberOf(value, key) {
|
|
@@ -149,12 +149,17 @@ const ROW_MEMBER_SHAPES = Object.freeze([
|
|
|
149
149
|
const kind = memberOf(m.pendingAction, "kind");
|
|
150
150
|
if (!isPendingKind(kind))
|
|
151
151
|
return "its pending action is not an object of a registered pending kind";
|
|
152
|
+
const gateKind = memberOf(m.gate, "kind");
|
|
153
|
+
if (isGateKind(gateKind) && PAUSE_REGISTRY[gateKind].pending !== kind)
|
|
154
|
+
return "its pending action is not the one its gate kind pairs with";
|
|
152
155
|
return kind === "tool_approval" && typeof memberOf(m.pendingAction, "toolCallId") !== "string" ? "its tool approval carries no tool call id" : undefined;
|
|
153
156
|
},
|
|
154
157
|
],
|
|
155
158
|
["state", (m) => (isRecord(m.state) ? undefined : "its state is not an object")],
|
|
156
159
|
["createdAt", (m) => (isFiniteNumber(m.createdAt) ? undefined : "its createdAt is not a finite number")],
|
|
157
160
|
["deadline", (m) => (m.deadline === undefined || isFiniteNumber(m.deadline) ? undefined : "its deadline is not a finite number")],
|
|
161
|
+
["resourceLedger", (m) => (m.resourceLedger === undefined || isRecord(m.resourceLedger) ? undefined : "its resource ledger is not an object")],
|
|
162
|
+
["checkpointId", (m) => (m.checkpointId === undefined || (typeof m.checkpointId === "string" && m.checkpointId !== "") ? undefined : "its checkpoint id is not a non-empty string")],
|
|
158
163
|
]);
|
|
159
164
|
function shapeProblemOf(m) {
|
|
160
165
|
for (const [member, shape] of ROW_MEMBER_SHAPES) {
|
|
@@ -177,7 +182,7 @@ function listingDamage(m) {
|
|
|
177
182
|
return placementDamage(m) ?? shapeProblemOf(m)?.problem;
|
|
178
183
|
}
|
|
179
184
|
export function rowMemberProblem(cp) {
|
|
180
|
-
return shapeProblemOf({ gate: cp.gate, pendingAction: cp.pendingAction, state: cp.state, createdAt: cp.createdAt, deadline: cp.deadline });
|
|
185
|
+
return shapeProblemOf({ gate: cp.gate, pendingAction: cp.pendingAction, state: cp.state, createdAt: cp.createdAt, deadline: cp.deadline, resourceLedger: cp.resourceLedger, checkpointId: cp.checkpointId });
|
|
181
186
|
}
|
|
182
187
|
function thrownName(e) {
|
|
183
188
|
return e instanceof Error ? e.constructor.name : typeof e;
|
|
@@ -18,8 +18,7 @@ export { BINDING_CHECKPOINT_VERSION, CHECKPOINT_CONFIG_REFUSAL_CODES, CHECKPOINT
|
|
|
18
18
|
/**
|
|
19
19
|
* design/45 — the **durable-checkpoint** primitive: cross-process / resumable `suspend`/`resume`.
|
|
20
20
|
*
|
|
21
|
-
* A {@link CheckpointStore} is
|
|
22
|
-
* `MemoryStore`): a token-addressable store of "enough state to resume a suspended task", with an
|
|
21
|
+
* A {@link CheckpointStore} is a pluggable durable seam (alongside `ToolResultStore`): a token-addressable store of "enough state to resume a suspended task", with an
|
|
23
22
|
* **atomic CAS `resolve`** so a token is acted on **exactly once** even across replicas / double
|
|
24
23
|
* approvals. Two profiles share this one seam (design/43 原语 4, proven by two service instances):
|
|
25
24
|
*
|
|
@@ -1964,7 +1963,11 @@ export interface CheckpointSummary {
|
|
|
1964
1963
|
* {@link toolCallId} absence-shape note applies). It names the call that PRESENTED the plan, not a call the pause
|
|
1965
1964
|
* gates: `toolCallId` stays omitted on a plan_review row. */
|
|
1966
1965
|
requestedByCallId?: string;
|
|
1967
|
-
/** The pending tool's name ({@link PendingAction} `tool_approval.toolName`) when this is an approval suspend
|
|
1966
|
+
/** The pending tool's name ({@link PendingAction} `tool_approval.toolName`) when this is an approval suspend — the very name
|
|
1967
|
+
* the row's `boundInputHash` was minted over (`exactBoundInputHashOf(toolName, args)`), as the row records it (an alias call
|
|
1968
|
+
* records the tool's own name). With {@link toolCallId} it is the listing's half of the approval binding: two parks of one
|
|
1969
|
+
* call id over the same arguments by two tools list two names and hold two hashes. The hash itself stays on the drilled-in
|
|
1970
|
+
* row, opaque, echoed and never re-derived by a host.
|
|
1968
1971
|
* OMITTED (not `null`) for a non-`tool_approval` pendingAction — see {@link toolCallId}'s absence-shape note. */
|
|
1969
1972
|
toolName?: string;
|
|
1970
1973
|
/** Which approval card the pending call renders under — the gate's {@link CheckpointGate} `approvalCard` echoed when
|
|
@@ -2127,7 +2130,7 @@ export declare function summarizeCheckpoint(cp: Checkpoint, disclose?: (sentence
|
|
|
2127
2130
|
*/
|
|
2128
2131
|
export declare function summarizeStoredCheckpoint(cp: Checkpoint, memo: WeakMap<Checkpoint, CheckpointRowVerdict>, disclose?: (sentence: string) => void): CheckpointSummary;
|
|
2129
2132
|
/**
|
|
2130
|
-
* The pluggable durable seam (design/45 §2.1). Symmetric with `ToolResultStore
|
|
2133
|
+
* The pluggable durable seam (design/45 §2.1). Symmetric with `ToolResultStore`:
|
|
2131
2134
|
* create-once `put`, `get`, an **atomic CAS `resolve`** (the once-only foundation), and a `reap` for TTL
|
|
2132
2135
|
* expiry. A durable backend (TiDB) makes resume cross-replica; the default in-memory impl is single
|
|
2133
2136
|
* instance / tests only.
|
|
@@ -29,17 +29,34 @@ import type { ModelRef } from "./model-seat.js";
|
|
|
29
29
|
* · `autoCompactTokens` — the trigger-side window (dual-window semantics: lowers the compaction trigger and
|
|
30
30
|
* the context-editing frontier without touching the physical request budget). Clamped to the physical
|
|
31
31
|
* window by the one resolver, exactly as a model-card declaration is.
|
|
32
|
-
* · `
|
|
33
|
-
*
|
|
34
|
-
* one gate, inside `maybeCompact`, fed by one settings assembly). A request that states its own
|
|
35
|
-
* `compaction.enabled` outranks it: the request is the author, this seat is the deployment's default —
|
|
36
|
-
* the same "the spec's own value wins, the deployment fills an unset one" law every other seat follows.
|
|
32
|
+
* · `autoCompact` / `manualCompact` — the deployment's twins of the task's two compaction seats, each with its
|
|
33
|
+
* seat's reach and each the default for its own seat only ({@link compactionEnabled}).
|
|
37
34
|
*/
|
|
38
35
|
export interface ContextWindowOverlay {
|
|
39
36
|
readonly contextTokens?: number;
|
|
40
37
|
readonly autoCompactTokens?: number;
|
|
41
|
-
readonly
|
|
38
|
+
readonly autoCompact?: boolean;
|
|
39
|
+
readonly manualCompact?: boolean;
|
|
42
40
|
}
|
|
41
|
+
/**
|
|
42
|
+
* The two compaction seats, one per kind of pass — which pass reads which seat is {@link compactionEnabled}'s
|
|
43
|
+
* contract. A task's `compaction`, a `Runner.compactSession` request's `compaction` (which takes `manualCompact`
|
|
44
|
+
* only — a pass outside a run is a requested one) and a deployment's overlay carry them, and every one of those
|
|
45
|
+
* doors judges them with {@link compactionSeatsDefect}.
|
|
46
|
+
*/
|
|
47
|
+
export declare const COMPACTION_SEATS: readonly ["autoCompact", "manualCompact"];
|
|
48
|
+
export type CompactionSeat = (typeof COMPACTION_SEATS)[number];
|
|
49
|
+
/**
|
|
50
|
+
* The seats' ONE judgment, for every bag that carries them (a task's `compaction`, a `Runner.compactSession` request's
|
|
51
|
+
* `compaction`, a deployment overlay): the retired single seat `enabled` is refused by name with the sentence that names
|
|
52
|
+
* the two ({@link RETIRED_COMPACTION_SEAT_KEYS}; never read as either), then a seat present (a defined value) that is not
|
|
53
|
+
* a boolean. `subject` is the bag in the door's own words (`TaskSpec.compaction`, `compaction`,
|
|
54
|
+
* `RunnerDeps: contextSettings["w"]`). Answers which and the sentence; each door throws it with its own code.
|
|
55
|
+
*/
|
|
56
|
+
export declare function compactionSeatsDefect(bag: object, subject: string): {
|
|
57
|
+
readonly kind: "retired" | "value";
|
|
58
|
+
readonly sentence: string;
|
|
59
|
+
} | undefined;
|
|
43
60
|
/**
|
|
44
61
|
* The seat: catalog word → overlay. Words absent from the table are "nothing declared".
|
|
45
62
|
*
|
|
@@ -84,9 +101,22 @@ export declare function assertContextSettingsWords<T extends ContextSettings | u
|
|
|
84
101
|
* moments an operator can get it wrong.
|
|
85
102
|
*/
|
|
86
103
|
export declare function assertContextSettingsValue(v: unknown, where: string): ContextSettings | undefined;
|
|
87
|
-
/**
|
|
88
|
-
*
|
|
89
|
-
|
|
104
|
+
/**
|
|
105
|
+
* Is THIS seat on for a pass?
|
|
106
|
+
*
|
|
107
|
+
* @contract compaction.two_seats — every compaction pass asks exactly one seat, through this function, and the seat
|
|
108
|
+
* is fixed by who starts the pass. `autoCompact` holds the three lanes the engine starts by itself: the turn-boundary
|
|
109
|
+
* pass at the window threshold (with the trim-pressure pass it forces), the recovery pass (a provider's
|
|
110
|
+
* prompt-too-long rejection, the request guard's compaction arm) and the end-of-task summary. `manualCompact` holds
|
|
111
|
+
* the passes a caller asks for: `TaskStream.compact`, an extension's `$.session.compact` and `Runner.compactSession`.
|
|
112
|
+
* One law per seat: the request's own value for the seat is the author, the deployment overlay's twin of the same seat
|
|
113
|
+
* fills an unset one, nothing declared means ON — and switching one seat off never switches off the other. With
|
|
114
|
+
* `autoCompact` off no recovery pass runs: a request the provider rejects as too long is neither summarized nor
|
|
115
|
+
* retried, and the rejection ends the run as the terminal failure it is (the provider's code and sentence), never a
|
|
116
|
+
* silent retry. With `manualCompact` off a requested pass is answered `"disabled"` with its `compaction_outcome` frame
|
|
117
|
+
* (`trigger: "manual"`) and no model call, and the boundary goes on with its own pass.
|
|
118
|
+
*/
|
|
119
|
+
export declare function compactionEnabled(seat: CompactionSeat, requested: Readonly<Partial<Record<CompactionSeat, boolean>>> | undefined, overlay: ContextWindowOverlay | undefined): boolean;
|
|
90
120
|
/**
|
|
91
121
|
* The overlay's view of a model's PHYSICAL window — the model card's chain with the deployment's live
|
|
92
122
|
* declaration CLAMPED over it. The single expression `guardBudget` and `resolveTriggerWindow` share.
|
|
@@ -1,6 +1,26 @@
|
|
|
1
1
|
import { tierAliasVia } from "./roles.js";
|
|
2
2
|
import { optionKeys, receiveMembers } from "./own-property-receipt.js";
|
|
3
|
-
|
|
3
|
+
import { RETIRED_COMPACTION_SEAT_KEYS, retiredKeyOf, retiredKeyRefusal } from "./retired-keys.js";
|
|
4
|
+
import { describeRejectedValue } from "./tool-search-setting.js";
|
|
5
|
+
const OVERLAY_KEYS = optionKeys()({ contextTokens: 0, autoCompactTokens: 0, autoCompact: 0, manualCompact: 0 });
|
|
6
|
+
const OVERLAY_READ_NAMES = Object.freeze([...OVERLAY_KEYS, ...Object.keys(RETIRED_COMPACTION_SEAT_KEYS)]);
|
|
7
|
+
export const COMPACTION_SEATS = Object.freeze(["autoCompact", "manualCompact"]);
|
|
8
|
+
const SEAT_REACH = Object.freeze({
|
|
9
|
+
autoCompact: "false switches off the passes the engine starts by itself",
|
|
10
|
+
manualCompact: "false refuses the passes a caller asks for",
|
|
11
|
+
});
|
|
12
|
+
export function compactionSeatsDefect(bag, subject) {
|
|
13
|
+
const retired = retiredKeyOf(bag, RETIRED_COMPACTION_SEAT_KEYS);
|
|
14
|
+
if (retired !== undefined)
|
|
15
|
+
return { kind: "retired", sentence: retiredKeyRefusal(retired, subject).message };
|
|
16
|
+
for (const seat of COMPACTION_SEATS) {
|
|
17
|
+
const value = Reflect.get(bag, seat);
|
|
18
|
+
if (value !== undefined && typeof value !== "boolean") {
|
|
19
|
+
return { kind: "value", sentence: `${subject}.${seat} must be a boolean when given (got ${describeRejectedValue(value)}) — ${SEAT_REACH[seat]}; omit it for the default (on)` };
|
|
20
|
+
}
|
|
21
|
+
}
|
|
22
|
+
return undefined;
|
|
23
|
+
}
|
|
4
24
|
export function contextOverlayFor(settings, ref, catalog) {
|
|
5
25
|
if (settings === undefined || typeof ref !== "string")
|
|
6
26
|
return undefined;
|
|
@@ -21,33 +41,35 @@ export function assertContextSettingsValue(v, where) {
|
|
|
21
41
|
if (v === undefined)
|
|
22
42
|
return undefined;
|
|
23
43
|
if (v === null || typeof v !== "object" || Array.isArray(v)) {
|
|
24
|
-
throw new Error(`${where}: contextSettings must be a plain Record<string, {contextTokens?, autoCompactTokens?,
|
|
44
|
+
throw new Error(`${where}: contextSettings must be a plain Record<string, {contextTokens?, autoCompactTokens?, autoCompact?, manualCompact?}> (got ${v === null ? "null" : Array.isArray(v) ? "array" : typeof v})`);
|
|
25
45
|
}
|
|
26
46
|
const out = {};
|
|
27
47
|
for (const [word, raw] of Object.entries(v)) {
|
|
28
48
|
if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
|
|
29
49
|
throw new Error(`${where}: contextSettings[${JSON.stringify(word)}] must be a plain object (got ${raw === null ? "null" : Array.isArray(raw) ? "array" : typeof raw})`);
|
|
30
50
|
}
|
|
31
|
-
const
|
|
51
|
+
const subject = `${where}: contextSettings[${JSON.stringify(word)}]`;
|
|
52
|
+
const o = receiveMembers(raw, { subject, unit: "member", moment: "when the overlay is read" }, OVERLAY_READ_NAMES, (_, unknown) => new Error(`${subject} carries ${unknown.map((k) => JSON.stringify(String(k))).join(", ")} — this seat declares window geometry and the compaction seats only (contextTokens | autoCompactTokens | autoCompact | manualCompact); routing, pricing and fencing stay on the model card`));
|
|
32
53
|
for (const k of ["contextTokens", "autoCompactTokens"]) {
|
|
33
54
|
const n = o[k];
|
|
34
55
|
if (n !== undefined && (typeof n !== "number" || !Number.isFinite(n) || n <= 0)) {
|
|
35
|
-
throw new Error(`${
|
|
56
|
+
throw new Error(`${subject}.${k} must be a positive finite number (got ${JSON.stringify(n)}) — an unusable window is a configuration defect, not a request to fall back to the model's own`);
|
|
36
57
|
}
|
|
37
58
|
}
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
59
|
+
const seatDefect = compactionSeatsDefect(o, subject);
|
|
60
|
+
if (seatDefect !== undefined)
|
|
61
|
+
throw new Error(seatDefect.sentence);
|
|
41
62
|
out[word] = Object.freeze({
|
|
42
63
|
...(o.contextTokens !== undefined ? { contextTokens: o.contextTokens } : {}),
|
|
43
64
|
...(o.autoCompactTokens !== undefined ? { autoCompactTokens: o.autoCompactTokens } : {}),
|
|
44
|
-
...(o.
|
|
65
|
+
...(o.autoCompact !== undefined ? { autoCompact: o.autoCompact } : {}),
|
|
66
|
+
...(o.manualCompact !== undefined ? { manualCompact: o.manualCompact } : {}),
|
|
45
67
|
});
|
|
46
68
|
}
|
|
47
69
|
return Object.freeze(out);
|
|
48
70
|
}
|
|
49
|
-
export function compactionEnabled(
|
|
50
|
-
return
|
|
71
|
+
export function compactionEnabled(seat, requested, overlay) {
|
|
72
|
+
return requested?.[seat] ?? overlay?.[seat] ?? true;
|
|
51
73
|
}
|
|
52
74
|
export function physicalWindowOf(model, overlay) {
|
|
53
75
|
const card = model.contextTokens ?? model.contextWindow;
|
|
@@ -21,6 +21,17 @@ import type { AutoModeClassifierRound } from "./auto-mode.js";
|
|
|
21
21
|
import type { AskUnresolvableCause } from "./ask-unresolvable-notice.js";
|
|
22
22
|
import type { PathDenialEvidence } from "../tools/fs/safety.js";
|
|
23
23
|
import type { AskGuard } from "./tool-policy.js";
|
|
24
|
+
import type { RefusalEcho } from "./refusal-echo.js";
|
|
25
|
+
/** The engine's own account of a sentence it composed for a decision's `message`: the sentence (`text`); whether it is the
|
|
26
|
+
* engine's generic question for the call, naming no asker's reason (`generic` — a write gate's default question, the plan
|
|
27
|
+
* mode's); and the literals it quotes, in the order it quotes them (`echoed`, the refusal list's own form). The station that
|
|
28
|
+
* composed the sentence is its only writer, and freezes each listed literal itself. Read through {@link engineSentenceOf} alone,
|
|
29
|
+
* which answers only while the decision's `message` IS `text`. */
|
|
30
|
+
export interface EngineSentence {
|
|
31
|
+
readonly text: string;
|
|
32
|
+
readonly generic?: true;
|
|
33
|
+
readonly echoed?: readonly RefusalEcho[];
|
|
34
|
+
}
|
|
24
35
|
export interface EngineAttestation {
|
|
25
36
|
readonly toolCallId: string;
|
|
26
37
|
readonly toolName: string;
|
|
@@ -56,12 +67,13 @@ export interface EngineAttestation {
|
|
|
56
67
|
/** A seat refused the call's arguments because no approval can be bound to them: the refusal's sentence, carried by the
|
|
57
68
|
* refusal itself — the gate's deny exit reads it (the remedy it gives) instead of judging again. */
|
|
58
69
|
readonly bindingRefusal?: string;
|
|
59
|
-
/** The engine's own
|
|
60
|
-
*
|
|
61
|
-
*
|
|
62
|
-
* that spread the
|
|
63
|
-
* sentence, for that sentence
|
|
64
|
-
|
|
70
|
+
/** The engine's own account of the decision's `message` ({@link EngineSentence}): the sentence a station composed, whether it
|
|
71
|
+
* is the engine's generic question (the chain's entry mint, {@link import("./ask-origin.js").chainAskReasonsOf}, writes no
|
|
72
|
+
* entry for one), and the literals it quotes. Valid only while the decision's `message` is still that sentence — a later
|
|
73
|
+
* layer that spread the decision and put its own words in `message` keeps them, and the account then reads as absent.
|
|
74
|
+
* Written only by the station that composed the sentence, for that sentence (the write gate's and the plan mode's questions,
|
|
75
|
+
* and the longer text `askWithTableSentence` makes of one of them; the ask resolver's refusal that quotes one of them); a composer cannot state it (an unbranded record is refused). */
|
|
76
|
+
readonly sentence?: EngineSentence;
|
|
65
77
|
/** The askers a station read off this ask where it first received it, before it narrated the sentence (an inherited station
|
|
66
78
|
* floating an ancestor's ask back into this leg's fold: its mark frames, its denial-limit fallback's sentence). The chain's
|
|
67
79
|
* entry mint takes these instead of the sentence; empty = the station read no asker. Written only by that float. */
|
|
@@ -83,6 +95,14 @@ export declare function attestationOf(d: unknown, call: {
|
|
|
83
95
|
toolCallId: string;
|
|
84
96
|
toolName: string;
|
|
85
97
|
}): EngineAttestation | undefined;
|
|
98
|
+
/** THE read of the engine's account of `d`'s sentence for `call` ({@link EngineAttestation.sentence}): present only while `d`'s
|
|
99
|
+
* `message` is that sentence, byte for byte — a layer that rewrote the message, appended to it or put its own words over it
|
|
100
|
+
* carries the record along (a spread keeps it) but no longer carries its account. `message` is read as every reader of the
|
|
101
|
+
* decision's text reads it. */
|
|
102
|
+
export declare function engineSentenceOf(d: unknown, call: {
|
|
103
|
+
toolCallId: string;
|
|
104
|
+
toolName: string;
|
|
105
|
+
}): EngineSentence | undefined;
|
|
86
106
|
/**
|
|
87
107
|
* Combine two records for `call`, member GROUP by group: the later record's group stands where it has one, the earlier's
|
|
88
108
|
* fills a group the later lacks. A record not bound to `call` contributes nothing. `answer` scope is the veto's merge: the
|
|
@@ -10,7 +10,7 @@ const ATTESTATION_GROUP_OF = {
|
|
|
10
10
|
guards: "guards",
|
|
11
11
|
pathDenial: "pathDenial",
|
|
12
12
|
bindingRefusal: "bindingRefusal",
|
|
13
|
-
|
|
13
|
+
sentence: "sentence",
|
|
14
14
|
receivedAskReasons: "receivedAskReasons",
|
|
15
15
|
};
|
|
16
16
|
const ATTESTATION_MEMBERS = Object.keys(ATTESTATION_GROUP_OF);
|
|
@@ -41,6 +41,10 @@ export function attestationOf(d, call) {
|
|
|
41
41
|
return undefined;
|
|
42
42
|
return boundTo(Object.getOwnPropertyDescriptor(d, "attestation")?.value, call);
|
|
43
43
|
}
|
|
44
|
+
export function engineSentenceOf(d, call) {
|
|
45
|
+
const sentence = attestationOf(d, call)?.sentence;
|
|
46
|
+
return sentence !== undefined && d.message === sentence.text ? sentence : undefined;
|
|
47
|
+
}
|
|
44
48
|
export function mergeAttestation(call, earlier, later, scope = "all") {
|
|
45
49
|
const a = boundTo(earlier, call);
|
|
46
50
|
const b = boundTo(later, call);
|
|
@@ -612,6 +612,15 @@ export interface EngineNotice {
|
|
|
612
612
|
* sessionId }` — `entries` every one, `entry` through the same reading as `permission.allowed_tool_not_granted`'s;
|
|
613
613
|
* `reader` ∈ `no_rule` / `named_no_tool` / `grammar_revised`; `rewrite.by` = `operator_write_without_rev`; `rulesSessionId` the session
|
|
614
614
|
* whose rules they are (an ancestor's on a delegated child), `sessionId` the run that read them.
|
|
615
|
+
* - `"config.legacy_tool_name"` — a tool policy's `deny` or `ask` list (the run's own policy, the session's stored rules, or the rules
|
|
616
|
+
* an ancestor's session handed down) holds names of tools the engine retired with NO successor (`TaskOutput`, `TeamCreate`, …: the
|
|
617
|
+
* retirement table's `removed` and `folded` lines). Such a name reaches no tool in any roster, so the prepare-time name audit leaves
|
|
618
|
+
* the entry out and the run goes on; this says so, because the person who wrote it believes it guards a tool. A retired name that
|
|
619
|
+
* was RENAMED (it has a successor the entry used to guard) is not here: it is still refused at prepare with the name to write, and
|
|
620
|
+
* the same code rides that thrown error. Audience `user`. Once per audited layer per prepared task, and only when the run goes on.
|
|
621
|
+
* `detail: { layer, entries: [{ field, entry, layer, guidance }], total, sessionId }` — `layer` ∈ `caller_policy` / `session_rules` /
|
|
622
|
+
* `ancestor_session_rules`, `field` ∈ `deny` / `ask`, `guidance` the retirement table's own line, `entries` unique by (field,
|
|
623
|
+
* entry) in scan order (at most 32), `total` every one.
|
|
615
624
|
* - `"config.durable_gate_unavailable"` — a durable-approval MANDATE is in force on a leg with NO
|
|
616
625
|
* checkpoint store: the per-principal `forceDurableGate` entitlement, or the task's own
|
|
617
626
|
* `durableApproval` opt-in with no live approver seat (`durableMandateSourceOf`, the predicate the
|
|
@@ -637,7 +646,8 @@ export interface EngineNotice {
|
|
|
637
646
|
* alone must not mistake a stranded follow-up for a stranded steer — same split as the settled
|
|
638
647
|
* frame's two count keys). They are NOT redelivered (a steer aimed at a finished run must not
|
|
639
648
|
* fire at the next one — unlike ENGINE notes, which pend per session); the loud half of the
|
|
640
|
-
* #257 contract's "accepted = enqueued, not consumed" sentence;
|
|
649
|
+
* #257 contract's "accepted = enqueued, not consumed" sentence; what a host that re-sends one reads back is
|
|
650
|
+
* `notice.user_input_undrained.handoff` ({@link undrainedUserInputNotices});
|
|
641
651
|
* The words a person wrote on an approval card (a durable `policy_ask` allow's `feedback`) that did not reach the
|
|
642
652
|
* model are counted in the SAME account under the steer code — one more row of that family, `detail.kind:
|
|
643
653
|
* "approval_feedback"` (absent on every other row) — when the message carrying them never committed and the row did not come back
|
|
@@ -1070,6 +1080,14 @@ export interface EngineNotice {
|
|
|
1070
1080
|
* - `"delegation.resume_lane_missing"` (#3334) — a parked agent resumed by a lane-less drive in a process holding no park of it:
|
|
1071
1081
|
* its completion takes the mount's sink, settling no waiting submission elsewhere; the resume proceeds. Once per drive, at
|
|
1072
1082
|
* the consume, to the process default seat. `detail: { taskId, rootSessionId? }`. Audience `"operator"`.
|
|
1083
|
+
* - `"delegation.delivery_discarded"` (#3431) — a frame (a background task's completion, a monitor event, a child's message)
|
|
1084
|
+
* addressed to an earlier occupant of a session id — the id deleted and created again, by another principal or the same
|
|
1085
|
+
* one — was discarded instead of delivered to the occupant the id holds now. Once per frame, by the Runner's per-session
|
|
1086
|
+
* notification store (`PendingSessionNotifications`), the one place the occupant comparison answers "another".
|
|
1087
|
+
* `detail: { taskId, taskType, sessionId, path, addressed, current }` — `path` = the seat the frame would have reached
|
|
1088
|
+
* under the current occupant (`"live"` its running conversation, `"box"` its durable box, `"drain"` its next run's
|
|
1089
|
+
* turn-open delivery); `addressed` / `current` = whether each side's occupant carried a token (`"known"` / `"unknown"`),
|
|
1090
|
+
* never the token. The frame's text never rides it. Audience `"operator"`.
|
|
1073
1091
|
*
|
|
1074
1092
|
* - `"memory.consolidation_recommended"` (design/339 §2.2/§6.2) — the engine-minted per-scope
|
|
1075
1093
|
* session count crossed the consolidation thresholds (time gate open ∧ enough distinct
|
|
@@ -1171,8 +1189,11 @@ export declare function __resetMalformedNoticeSeatAnnouncement(): void;
|
|
|
1171
1189
|
* seat defect — the one fact every fallback would otherwise repeat — is announced once per process.
|
|
1172
1190
|
* · an ABSENT seat goes to the default seat a host installed ({@link setDefaultEngineNoticeSeat}; a function seat as above, and
|
|
1173
1191
|
* a present seat — non-function included — never falls through to it), else prints the historic `console.warn` line verbatim.
|
|
1192
|
+
* · `admission`, when given, is asked once with the notice as it will leave (after the text pass and the routing lift): `false`
|
|
1193
|
+
* hands it to no seat. A predicate that answers `false` has already said so on its own account (the occupant judge mints its
|
|
1194
|
+
* `delegation.delivery_discarded`); it only judges and never rewrites the notice — the mint stays at the call site.
|
|
1174
1195
|
*/
|
|
1175
|
-
export declare function deliverEngineNotice(onNotice: ((notice: EngineNotice) => void) | undefined, notice: EngineNotice): void;
|
|
1196
|
+
export declare function deliverEngineNotice(onNotice: ((notice: EngineNotice) => void) | undefined, notice: EngineNotice, admission?: (notice: EngineNotice) => boolean): void;
|
|
1176
1197
|
/**
|
|
1177
1198
|
* #259 loud half, one notice PER FAMILY (`task.user_steer_undrained` / `task.user_followup_undrained`):
|
|
1178
1199
|
* a consumer routing on `code` alone must never mistake a stranded follow-up for a stranded steer, so
|
|
@@ -1364,6 +1385,20 @@ export declare function parentLegIds(internals: {
|
|
|
1364
1385
|
* no `runId`: the account is per run and nothing carries the parent's. Only the DIRECT parent hears: a grandchild's
|
|
1365
1386
|
* row reaches its parent's session (the middle leg), not the root's. A parent that is no addressee — null, no or an empty session, or the leg's own session (which already
|
|
1366
1387
|
* hears the row) — gets no copy, and the call never throws on it.
|
|
1388
|
+
*
|
|
1389
|
+
* @contract notice.user_input_undrained.handoff — a row's `detail.inputIds` names exactly the unread inputs it counts (present
|
|
1390
|
+
* when the list covers the count; a row of approval words carries none): each input's `inputId` — the one its caller handed the
|
|
1391
|
+
* steer verb (or the parked-steer append, `CheckpointStore.setPendingSteer`), else the one the engine minted at acceptance. An
|
|
1392
|
+
* input parked on a checkpoint keeps its id (the entry freezes it), so a resume's `applied` frame and a resumed leg's row name the
|
|
1393
|
+
* same one. A minted id is published only on the input's `human_input` frames, which carry no text, and neither call returns it —
|
|
1394
|
+
* so it is no key a caller can tie back to its own call: a host that means to re-send sends every steer with its own `inputId`,
|
|
1395
|
+
* and the row hands its ids back. The engine keeps no state across runs and never carries an unread input to a later run itself (a durable park is the one
|
|
1396
|
+
* carrier: the resume delivers it with no row — or, when the deployment's prompt screen withholds it on redelivery, tells it by
|
|
1397
|
+
* `steering.parked_input_blocked` under the same `detail.inputId`, not by this row). A host that re-sends an input under the same
|
|
1398
|
+
* `inputId` to a later run gets that run's own answer — read (its `applied` frame, no row) or not read (a row of that run, the
|
|
1399
|
+
* same id, that run's `runId`) — so the leg's own rows naming one `inputId` count the runs that ended with it unread (a parent's
|
|
1400
|
+
* copy, the row carrying `childSessionId`, repeats its child's row and is not another time). The row's sentence states the
|
|
1401
|
+
* engine's part only ("NOT redelivered" by the engine); whether to re-send, and what the person is shown, is the host's.
|
|
1367
1402
|
*/
|
|
1368
1403
|
export declare function undrainedUserInputNotices(counts: {
|
|
1369
1404
|
steer: number;
|
|
@@ -9,7 +9,7 @@ let malformedNoticeSeatAnnounced = false;
|
|
|
9
9
|
export function __resetMalformedNoticeSeatAnnouncement() {
|
|
10
10
|
malformedNoticeSeatAnnounced = false;
|
|
11
11
|
}
|
|
12
|
-
export function deliverEngineNotice(onNotice, notice) {
|
|
12
|
+
export function deliverEngineNotice(onNotice, notice, admission) {
|
|
13
13
|
notice = {
|
|
14
14
|
...notice,
|
|
15
15
|
message: typeof notice.message === "string" ? egressText("same-principal", notice.message) : notice.message,
|
|
@@ -18,6 +18,8 @@ export function deliverEngineNotice(onNotice, notice) {
|
|
|
18
18
|
if (notice.sessionId === undefined && typeof notice.detail?.["sessionId"] === "string") {
|
|
19
19
|
notice = { ...notice, sessionId: notice.detail["sessionId"] };
|
|
20
20
|
}
|
|
21
|
+
if (admission !== undefined && !admission(notice))
|
|
22
|
+
return;
|
|
21
23
|
const seat = onNotice === undefined ? defaultNoticeSeat : onNotice;
|
|
22
24
|
if (typeof seat === "function") {
|
|
23
25
|
try {
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The one reading of who an extension-started agent row says started it. The row carries `requestedBy?: ExtensionRequester`
|
|
3
|
+
* (`{ kind: "extension", name }`): written once, by the registration that creates the row, from the extension's own `$.agent.spawn`
|
|
4
|
+
* call; absent on every other row — the model's own spawn, the host's, and every row an earlier release wrote. Rows come back from a
|
|
5
|
+
* store the engine did not just write, so every reader takes the member through this function: a value that is not exactly an
|
|
6
|
+
* extension's requester (another `kind`, a blank or non-string name) is no requester — never a half-read one.
|
|
7
|
+
*/
|
|
8
|
+
import type { ExtensionRequester } from "./task-event.js";
|
|
9
|
+
export declare function readExtensionRequester(raw: unknown): ExtensionRequester | undefined;
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export function readExtensionRequester(raw) {
|
|
2
|
+
if (typeof raw !== "object" || raw === null || Array.isArray(raw))
|
|
3
|
+
return undefined;
|
|
4
|
+
const kind = raw.kind;
|
|
5
|
+
const name = raw.name;
|
|
6
|
+
return kind === "extension" && typeof name === "string" && name.trim() !== "" ? Object.freeze({ kind: "extension", name }) : undefined;
|
|
7
|
+
}
|