{"id":"@lssm-tech/module.agent-fleet","slug":"module.agent-fleet","name":"@lssm-tech/module.agent-fleet","version":"2.1.4","path":"packages/platform/agents/agent-fleet","manifestPath":"packages/platform/agents/agent-fleet/package.json","manifestBlobSha":"3bc9b4d22f4c01dfcebe71020ad2671cb07eb7ae","layer":"platform","physicalArea":"agents","primaryArea":"agents-and-context","classification":{"privateDeclared":null,"catalogFamily":"solutions","catalogKind":"module","catalogStatus":"active","adoptionMode":"adoptable","stability":"experimental"},"description":"Agent fleet management module — fleet, tree, detail, tool registry, and run console surfaces.","descriptionOrigin":"package.json","catalog":{"family":"solutions","kind":"module","status":"active","adoptionMode":"adoptable","stability":"experimental","platforms":["server"],"runtimes":["node"],"entrypoints":[".","./agent-fleet.capability","./agent-fleet.feature","./core","./data-views","./hubs","./hubs/agent-network","./hubs/agent-system","./hubs/federation-ports","./hubs/federation-verification","./hubs/presentation","./presentation"],"documentation":[{"title":"Module Agent Fleet documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fmodule.agent-fleet","kind":"readme"}],"examples":[],"replacements":[],"capabilities":[{"id":"package.lssm.tech.module.agent.fleet","title":"Module Agent Fleet","description":"Agent fleet management module — fleet, tree, detail, tool registry, and run console surfaces.","status":"active","useCases":["Adopt agent fleet management module — fleet, tree, detail, tool registry, and run console surfaces"],"aliases":["contractspec","agent","fleet","modules","typescript","module"],"pythonEquivalents":[],"canonicalImports":[{"from":"@lssm-tech/module.agent-fleet","symbols":[]},{"from":"@lssm-tech/module.agent-fleet/agent-fleet.capability","symbols":[]},{"from":"@lssm-tech/module.agent-fleet/agent-fleet.feature","symbols":[]},{"from":"@lssm-tech/module.agent-fleet/core","symbols":[]},{"from":"@lssm-tech/module.agent-fleet/data-views","symbols":[]},{"from":"@lssm-tech/module.agent-fleet/hubs","symbols":[]},{"from":"@lssm-tech/module.agent-fleet/hubs/agent-network","symbols":[]},{"from":"@lssm-tech/module.agent-fleet/hubs/agent-system","symbols":[]},{"from":"@lssm-tech/module.agent-fleet/hubs/federation-ports","symbols":[]},{"from":"@lssm-tech/module.agent-fleet/hubs/federation-verification","symbols":[]},{"from":"@lssm-tech/module.agent-fleet/hubs/presentation","symbols":[]},{"from":"@lssm-tech/module.agent-fleet/presentation","symbols":[]}],"constraints":{"platforms":["server"],"runtimes":["node"],"avoidWhen":["The @lssm-tech/module.agent-fleet package constraints do not match the target runtime or platform."],"requires":["TypeScript"]},"alternatives":[],"relationships":[],"resolutionPriority":50}],"visualTesting":{"status":"deferred","owner":"@contractspec-core","targetWave":"wave-3-react-packages","rationale":"Foundational Storybook adoption establishes shared catalogs and guardrails before this package migrates."}},"canonicalImports":[{"capabilityId":"package.lssm.tech.module.agent.fleet","from":"@lssm-tech/module.agent-fleet","symbols":[]},{"capabilityId":"package.lssm.tech.module.agent.fleet","from":"@lssm-tech/module.agent-fleet/agent-fleet.capability","symbols":[]},{"capabilityId":"package.lssm.tech.module.agent.fleet","from":"@lssm-tech/module.agent-fleet/agent-fleet.feature","symbols":[]},{"capabilityId":"package.lssm.tech.module.agent.fleet","from":"@lssm-tech/module.agent-fleet/core","symbols":[]},{"capabilityId":"package.lssm.tech.module.agent.fleet","from":"@lssm-tech/module.agent-fleet/data-views","symbols":[]},{"capabilityId":"package.lssm.tech.module.agent.fleet","from":"@lssm-tech/module.agent-fleet/hubs","symbols":[]},{"capabilityId":"package.lssm.tech.module.agent.fleet","from":"@lssm-tech/module.agent-fleet/hubs/agent-network","symbols":[]},{"capabilityId":"package.lssm.tech.module.agent.fleet","from":"@lssm-tech/module.agent-fleet/hubs/agent-system","symbols":[]},{"capabilityId":"package.lssm.tech.module.agent.fleet","from":"@lssm-tech/module.agent-fleet/hubs/federation-ports","symbols":[]},{"capabilityId":"package.lssm.tech.module.agent.fleet","from":"@lssm-tech/module.agent-fleet/hubs/federation-verification","symbols":[]},{"capabilityId":"package.lssm.tech.module.agent.fleet","from":"@lssm-tech/module.agent-fleet/hubs/presentation","symbols":[]},{"capabilityId":"package.lssm.tech.module.agent.fleet","from":"@lssm-tech/module.agent-fleet/presentation","symbols":[]}],"scripts":{"publish:pkg":"bun publish --tolerate-republish --ignore-scripts --verbose","publish:pkg:canary":"bun publish:pkg --tag canary","build":"contractspec-bun-build build","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types","dev":"contractspec-bun-build dev","clean":"rimraf dist .turbo","lint":"bun lint:fix","lint:fix":"node ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .","lint:check":"node ../../../../scripts/biome.cjs check .","test":"bun test","prebuild":"contractspec-bun-build prebuild","typecheck":"tsgo --noEmit"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.agent-protocol-spec":"workspace:^","@lssm-tech/lib.contracts-runtime-core":"workspace:^","@lssm-tech/lib.orchestration-spec":"workspace:^","@lssm-tech/lib.contracts-spec-core":"workspace:^","@lssm-tech/lib.design-system":"workspace:^","@lssm-tech/lib.personalization":"workspace:^","@lssm-tech/lib.schema":"workspace:^","@lssm-tech/lib.surface-runtime":"workspace:^","@lssm-tech/lib.translation-runtime":"workspace:^","@lssm-tech/lib.ui-kit-web":"workspace:^","react":"catalog:","@lssm-tech/lib.ai-agent":"workspace:^","@lssm-tech/lib.lssm-os-runtime":"workspace:^","@lssm-tech/lib.communication-runtime":"workspace:^"},"devDependencies":{"@lssm-tech/tool.bun":"workspace:*","@lssm-tech/tool.typescript":"workspace:*","@types/react":"catalog:types","typescript":"catalog:","@electric-sql/pglite":"catalog:data","@lssm-tech/integration.agent-durable-store":"workspace:*","@lssm-tech/lib.contracts-integrations":"workspace:*"},"peerDependencies":{"react":"catalog:"},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts","./agent-fleet.capability":"./src/agent-fleet.capability.ts","./agent-fleet.feature":"./src/agent-fleet.feature.ts","./core":"./src/core/index.ts","./data-views":"./src/data-views/index.ts","./hubs":"./src/hubs/index.ts","./hubs/agent-network":"./src/hubs/agent-network.ts","./hubs/agent-system":"./src/hubs/agent-system.ts","./hubs/federation-ports":"./src/hubs/federation-ports.ts","./hubs/federation-verification":"./src/hubs/federation-verification.ts","./hubs/presentation":"./src/hubs/presentation.ts","./presentation":"./src/presentation/index.ts"},"publishExports":{".":{"types":"./dist/index.d.ts","browser":"./dist/browser/index.js","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.js"},"./agent-fleet.capability":{"types":"./dist/agent-fleet.capability.d.ts","browser":"./dist/browser/agent-fleet.capability.js","bun":"./dist/agent-fleet.capability.js","node":"./dist/node/agent-fleet.capability.js","default":"./dist/agent-fleet.capability.js"},"./agent-fleet.feature":{"types":"./dist/agent-fleet.feature.d.ts","browser":"./dist/browser/agent-fleet.feature.js","bun":"./dist/agent-fleet.feature.js","node":"./dist/node/agent-fleet.feature.js","default":"./dist/agent-fleet.feature.js"},"./core":{"types":"./dist/core/index.d.ts","browser":"./dist/browser/core/index.js","bun":"./dist/core/index.js","node":"./dist/node/core/index.js","default":"./dist/core/index.js"},"./data-views":{"types":"./dist/data-views/index.d.ts","browser":"./dist/browser/data-views/index.js","bun":"./dist/data-views/index.js","node":"./dist/node/data-views/index.js","default":"./dist/data-views/index.js"},"./hubs":{"types":"./dist/hubs/index.d.ts","browser":"./dist/browser/hubs/index.js","bun":"./dist/hubs/index.js","node":"./dist/node/hubs/index.js","default":"./dist/hubs/index.js"},"./hubs/agent-network":{"types":"./dist/hubs/agent-network.d.ts","browser":"./dist/browser/hubs/agent-network.js","bun":"./dist/hubs/agent-network.js","node":"./dist/node/hubs/agent-network.js","default":"./dist/hubs/agent-network.js"},"./hubs/agent-system":{"types":"./dist/hubs/agent-system.d.ts","browser":"./dist/browser/hubs/agent-system.js","bun":"./dist/hubs/agent-system.js","node":"./dist/node/hubs/agent-system.js","default":"./dist/hubs/agent-system.js"},"./hubs/federation-ports":{"types":"./dist/hubs/federation-ports.d.ts","browser":"./dist/browser/hubs/federation-ports.js","bun":"./dist/hubs/federation-ports.js","node":"./dist/node/hubs/federation-ports.js","default":"./dist/hubs/federation-ports.js"},"./hubs/federation-verification":{"types":"./dist/hubs/federation-verification.d.ts","browser":"./dist/browser/hubs/federation-verification.js","bun":"./dist/hubs/federation-verification.js","node":"./dist/node/hubs/federation-verification.js","default":"./dist/hubs/federation-verification.js"},"./hubs/presentation":{"types":"./dist/hubs/presentation.d.ts","browser":"./dist/browser/hubs/presentation.js","bun":"./dist/hubs/presentation.js","node":"./dist/node/hubs/presentation.js","default":"./dist/hubs/presentation.js"},"./presentation":{"types":"./dist/presentation/index.d.ts","browser":"./dist/browser/presentation/index.js","bun":"./dist/presentation/index.js","node":"./dist/node/presentation/index.js","default":"./dist/presentation/index.js"}},"types":"./dist/index.d.ts","files":["dist","README.md"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/module.agent-fleet","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"packages/platform/agents/agent-fleet/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/src/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./agent-fleet.capability","importPath":"@lssm-tech/module.agent-fleet/agent-fleet.capability","target":"./src/agent-fleet.capability.ts","targets":[{"conditions":[],"target":"./src/agent-fleet.capability.ts","sourcePath":"packages/platform/agents/agent-fleet/src/agent-fleet.capability.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/src/agent-fleet.capability.ts","sourceStatus":"verified source file"}]},{"subpath":"./agent-fleet.feature","importPath":"@lssm-tech/module.agent-fleet/agent-fleet.feature","target":"./src/agent-fleet.feature.ts","targets":[{"conditions":[],"target":"./src/agent-fleet.feature.ts","sourcePath":"packages/platform/agents/agent-fleet/src/agent-fleet.feature.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/src/agent-fleet.feature.ts","sourceStatus":"verified source file"}]},{"subpath":"./core","importPath":"@lssm-tech/module.agent-fleet/core","target":"./src/core/index.ts","targets":[{"conditions":[],"target":"./src/core/index.ts","sourcePath":"packages/platform/agents/agent-fleet/src/core/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/src/core/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./data-views","importPath":"@lssm-tech/module.agent-fleet/data-views","target":"./src/data-views/index.ts","targets":[{"conditions":[],"target":"./src/data-views/index.ts","sourcePath":"packages/platform/agents/agent-fleet/src/data-views/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/src/data-views/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./hubs","importPath":"@lssm-tech/module.agent-fleet/hubs","target":"./src/hubs/index.ts","targets":[{"conditions":[],"target":"./src/hubs/index.ts","sourcePath":"packages/platform/agents/agent-fleet/src/hubs/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/src/hubs/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./hubs/agent-network","importPath":"@lssm-tech/module.agent-fleet/hubs/agent-network","target":"./src/hubs/agent-network.ts","targets":[{"conditions":[],"target":"./src/hubs/agent-network.ts","sourcePath":"packages/platform/agents/agent-fleet/src/hubs/agent-network.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/src/hubs/agent-network.ts","sourceStatus":"verified source file"}]},{"subpath":"./hubs/agent-system","importPath":"@lssm-tech/module.agent-fleet/hubs/agent-system","target":"./src/hubs/agent-system.ts","targets":[{"conditions":[],"target":"./src/hubs/agent-system.ts","sourcePath":"packages/platform/agents/agent-fleet/src/hubs/agent-system.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/src/hubs/agent-system.ts","sourceStatus":"verified source file"}]},{"subpath":"./hubs/federation-ports","importPath":"@lssm-tech/module.agent-fleet/hubs/federation-ports","target":"./src/hubs/federation-ports.ts","targets":[{"conditions":[],"target":"./src/hubs/federation-ports.ts","sourcePath":"packages/platform/agents/agent-fleet/src/hubs/federation-ports.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/src/hubs/federation-ports.ts","sourceStatus":"verified source file"}]},{"subpath":"./hubs/federation-verification","importPath":"@lssm-tech/module.agent-fleet/hubs/federation-verification","target":"./src/hubs/federation-verification.ts","targets":[{"conditions":[],"target":"./src/hubs/federation-verification.ts","sourcePath":"packages/platform/agents/agent-fleet/src/hubs/federation-verification.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/src/hubs/federation-verification.ts","sourceStatus":"verified source file"}]},{"subpath":"./hubs/presentation","importPath":"@lssm-tech/module.agent-fleet/hubs/presentation","target":"./src/hubs/presentation.ts","targets":[{"conditions":[],"target":"./src/hubs/presentation.ts","sourcePath":"packages/platform/agents/agent-fleet/src/hubs/presentation.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/src/hubs/presentation.ts","sourceStatus":"verified source file"}]},{"subpath":"./presentation","importPath":"@lssm-tech/module.agent-fleet/presentation","target":"./src/presentation/index.ts","targets":[{"conditions":[],"target":"./src/presentation/index.ts","sourcePath":"packages/platform/agents/agent-fleet/src/presentation/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/src/presentation/index.ts","sourceStatus":"verified source file"}]}],"entryCount":12,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Module Agent Fleet documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fmodule.agent-fleet","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/module.agent-fleet.txt"},"readme":{"status":"available","body":"# `@lssm-tech/module.agent-fleet`\n\nAgent fleet, tool-registry, and governed execution surfaces. The package also\nexports two distinct installable Feature Hub profiles:\n\n- `./agent-system` for local fleet, tool, memory, lease, and audit adapters.\n- `./agent-network` for cross-system delegation and federation.\n\nFederation verification uses RFC 8785 canonical UTF-8 bytes with the signature\nomitted, intersects every signed/requested/current/exposed scope and ceiling,\nand fails closed through injected trust, key, replay, revocation, target-local\npolicy, and audit ports.\nReplay is consumed before target-local authorization; over-scoped requests do\nnot reach local policy. A local `allow` carrying unresolved obligations remains\ndenied, so a verification result cannot silently discard target controls.\n\n## External Markdown migration preview\n\n`previewAgentMarkdownMigration` validates the restricted archive and exact agent\nscope, then projects explicit target mappings as new, identical or conflicting.\nMemory requires review by its owning PersonalOS/CompanyOS service; skill content\nrequires independent evaluation. The projection contains hashes and references,\nnot imported text. It neither writes files nor installs or activates content.\nProduct import UI, durable owner proposals, schedule/channel translation and live\nvendor migration qualification remain separate work.\n\n`proposeAgentMarkdownMemory` translates an explicitly selected memory file into the\nexisting `AgentMemoryProposalArtifactV1`. It binds source/archive/content digests,\nexact scope, host-selected owner and policy references, and an optional correction\ntarget/revision. Imported contents are not embedded in the proposal or interpreted\nas authority. The host must resolve `contentRef` in restricted storage; PersonalOS\nor CompanyOS must verify consent, retention and authority before persistence.\n\n`submitAgentMemoryImportProposal` composes the existing agent protocol artifact\nstore with host-provided submission authorization and restricted-content\nverification. It appends at revision zero, verifies exact readback, and reconciles\nlost acknowledgements without repeating the append in the same call. Unverified\nwrites remain indeterminate. This persists review candidates only; memory-owner\npromotion, consent and runtime activation stay separate. Production hosts must\nprovide the durable scoped adapter and current principal authorization.\n\n`AgentMigrationReviewPanel` is a controlled reusable presentation for console or\nembedded hosts. Pass a validated preview, localized labels, selected target refs,\npending/error state and host permission projection. It allows selection only for\nnew mappings and sends the archive digest plus selected target refs to the host.\nThe host must revalidate all input and call the authorized submission service;\nclient-side `canSubmit` never grants permission. Conflicts require mapping resolution\noutside this panel. Product-route wiring and browser/visual qualification are pending.\n\nMigration submission has one monotonic I/O budget (default ten seconds, configurable\nfrom one millisecond to sixty seconds). All authorization, content verification,\nartifact reads/writes and record validation share it. Preflight timeout starts no\nwrite; an unsettled append remains indeterminate. The generic store interface\ncannot forcibly cancel a provider request, so explicit retries must reconcile the\nsame immutable proposal identity rather than creating another proposal.\n\nSubmission authorizes the actor before restricted-content lookup and rechecks\ncurrent authority immediately before a new artifact append. Revocation during\nlookup therefore blocks the write; it does not rely solely on an earlier decision.\n\n`executeMemoryImportOperation` is the handler adapter for\n`agent.memory.import.submit`. A host-provided Runtime Node verifier must return\ncurrent signed-operation bindings matching the exact request, actor, scope,\nwork-order, archive/proposal digests and idempotency key. Restricted artifacts are\nloaded only after that check; authority is rechecked before submission. The adapter\nnever creates a signature, claim, fence or promotion decision. Production verifier\ncomposition, handler registration and HTTP/UI route wiring remain required.\n\n`createMemoryImportRuntimeVerifier` composes the canonical V3 order validator,\nConnect dispatch verifier and durable operation reader. The signed payload binds\nthe actor, agent scope and complete request; the operation must retain the same\nrunning claim/attempt/fence and request digest after verification. Trusted time is\nrechecked for expiry. Production key verification still belongs to Connect; this\nadapter neither implements a signing authority nor accepts bare digest equality\nas signature proof. Hosts must provide the real trusted readers and verifier.\n\n`createMemoryImportOperationRegistry` returns a canonical operation registry with\nthe import command and handler bound. Normal registry input/output and permission\nchecks apply. The handler additionally binds the authenticated context user and\ntenant to the verified Runtime Node actor/scope, preventing a transport caller\nfrom selecting another identity. Hosts still supply the production verifier and\nstore adapters and must register the registry with their authenticated transport.\n\nMemory import registry callers must supply a server-authenticated `workspaceId`\nalongside actor and physical tenant. Both the request and verified Runtime Node\noperation must match that workspace; a tenant-wide session alone cannot import.\n\n## Founder operations workflows (`./core`)\n\nThese additive surfaces are headless and provider-neutral. Hosts inject durable\nstores, provider control, notification, authority and Work-creation ports.\nNothing here executes consequential effects on its own.\n\n- **`coding-supervision-v1`** — `SupervisedCodingSessionService` binds a coding\n  agent run to a canonical Work item (UUIDv7), repository/worktree/branch, path\n  leases and an exact task digest. Questions, reviews and CI waits are persisted\n  before notification; answers must match the wait id, expected revision and\n  current owner epoch and pass current authority. Delivery is `pending` →\n  `dispatching` → `delivered`; after a restart `sweep()` dispatches never-sent\n  answers once and reconciles in-flight ones by provider lookup. Uncertain\n  provider, delivery and cancellation outcomes stay explicit and are escalated,\n  never retried blindly. Wait deadlines, wall-clock/compute/cost budgets and\n  stalls escalate once per trigger as a `FounderProposalV1` (proposed Work\n  item); `onExhausted: 'cancel_and_escalate'` additionally requests\n  cancellation. Completion needs every declared artifact; acceptance needs the\n  required verification receipts. External sessions are unqualified until an\n  identity proof is supplied.\n- **Proactive proposals (FW-013)** — `ProactiveProposalService` accepts\n  explained candidates (trigger, evidence, expected value, affected scope, next\n  action), suppresses duplicates and repeatedly dismissed rules, keeps paused or\n  archived scopes quiet unless an obligation remains, and defers routine items,\n  quiet hours and rate-limited items to the digest. Critical blockers may bypass\n  quiet hours and the rate limit per policy. Accepting returns a Work draft only.\n- **`workflow-improvement-v1`** — `WorkflowImprovementService` and\n  `createWorkflowImprovementAdapter` route knowledge corrections to Company\n  Intelligence and send procedure feedback through\n  `GovernedAiImprovementRuntimeV2` (`@lssm-tech/lib.ai-agent/improvement-loop`)\n  with a frozen success criterion, replay plus independent held-out evaluation,\n  canary observation and rollback. Failed evaluations are rejected; promotion\n  requires an explicit human approval; self-granted authority and model-route\n  drift fail closed.\n- **`usecase-proposal-v1`** — `reviewUseCaseProposals` turns recurring observed\n  work into at most `maxProposals` proposals with past examples, frequency,\n  benefit, needed access (`granted: false`), operating cost, smallest trial,\n  stop condition and acceptance hypothesis, at the agreed cadence. Nothing is\n  activated.\n\nReference stores (`InMemorySupervisedCodingSessionStore`,\n`InMemoryProactiveProposalLedger`, `InMemoryWorkflowImprovementBriefStore`) are\ndeterministic fixtures, not production persistence. For production, pass\n`supervisedCodingSessionCodecV1`, `proactiveLedgerRecordCodecV1` and\n`workflowImprovementBriefCodecV1` to the matching Postgres stores in\n`@lssm-tech/integration.agent-durable-store/postgres`. The codecs validate every\npersisted payload. One shared contract suite (`src/core/store-contracts/`) runs\nagainst both the in-memory and the PGlite-backed Postgres implementations.\n\n`createCommunicationQuietHoursInterruptionPort` binds proactive quiet hours to\nCommunicationOS `isWithinCommunicationQuietHoursV1`. A missing preference means\nthere is no quiet window. A preference that cannot be read fails toward quiet.\n","sourcePath":"packages/platform/agents/agent-fleet/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/agent-fleet/README.md","blobSha":"120bbcd9aab870595fd6b735d6223c778cd202d0","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"agents-and-context","areaTitle":"Agents, execution and context","displayName":"module.agent-fleet","runtimes":["node"],"platforms":["server"],"kind":"module","scope":"Package manifest","canonicalRoute":"/docs/packages/module.agent-fleet/","contextUrl":"/docs/packages/module.agent-fleet.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}