@mono-agent/agent-app 0.20.11 → 0.21.0

package/dist/channel-drivers/tui.d.ts

@@ -1,28 +1,88 @@
-import type { ProcessJobOperator } from "@mono-agent/agent-contracts";
+import type { MonitorOperator, ProcessJobOperator, ProviderAuthOperator } from "@mono-agent/agent-contracts";
 import type { TuiAdapterConfig, TuiAdapterOptions, TuiAdapterStartResult } from "@mono-agent/operator-adapter";
+import { discoverLocalProviders } from "@mono-agent/runtime-adapter";
 import type { DiscoveredLocalModel, LocalProviderDefinition } from "@mono-agent/runtime-adapter";
 import { deliverWebNotification } from "@mono-agent/web";
 import type { ChannelDriver, ChannelStartInput, RunningChannel } from "../channels.js";
-import { type CodexCatalogModel } from "../codex-model-catalog.js";
-import { type ClaudeEffortCatalogEntry } from "../model-effort-capabilities.js";
 import type { CronOperatorRegistry } from "../cron-operator-service.js";
 export interface TuiChannelOverrides {
     readonly adapterFactory?: (options: TuiAdapterOptions) => Promise<TuiAdapterStartResult>;
     /** Test seam: replaces the real local-provider model discovery call. */
     readonly discoverModels?: (providers: readonly LocalProviderDefinition[] | undefined) => Promise<readonly DiscoveredLocalModel[]>;
-    /** Test seam: replaces bounded Claude SDK catalog discovery at channel start. */
-    readonly discoverClaudeModels?: (authoredModelRefs: readonly string[]) => Promise<readonly ClaudeEffortCatalogEntry[]>;
-    /** Test seam: replaces bounded Codex app-server model/list discovery at channel start. */
-    readonly discoverCodexModels?: () => Promise<readonly CodexCatalogModel[]>;
+    /**
+     * Test seam: replaces the zero-config local-provider probe. This one MUST be
+     * injectable — the real implementation reaches localhost:11434 and
+     * localhost:1234, so a developer with Ollama running would otherwise get
+     * different test results from one who does not.
+     */
+    readonly discoverProviders?: typeof discoverLocalProviders;
     /** Test/embedding seam for the owner-private local web ingress. */
     readonly deliverNotification?: typeof deliverWebNotification;
 }
+/**
+ * Producer-side payload budgets for `/v1/info`.
+ *
+ * `/v1/info` shares ONE 1 MiB body cap ({@link MAX_INFO_BODY_BYTES}) across
+ * every field it carries, and `sendBoundedInfo` in the operator adapter is what
+ * enforces it: it measures the exact string it is about to send, sheds whole
+ * optional fields largest-first, logs the shed at error level, and falls back to
+ * a fixed liveness body. That fence is TOTAL — no body leaves this process over
+ * the cap whatever these numbers say — so the fence, and only the fence, is what
+ * decides that something genuinely cannot ship.
+ *
+ * What a budget HERE is for is bounding the AGGREGATE growth of a contributor
+ * whose size nobody authored, so one such contributor cannot flood the body and
+ * cost an unrelated field its place at the fence:
+ *
+ *     discovered model refs   384 KiB  advisory: whatever a local endpoint said
+ *     provider summary        128 KiB  advisory tail behind the declared vendors
+ *     skills                  256 KiB  `MAX_SKILL_REGISTRY_BYTES`, skill-registry.ts
+ *
+ * Configured routes get NO budget here, and that is the correction to a defect
+ * this file carried through three review rounds. A budget is not an opinion
+ * about which content deserves to ship, and a fixed per-contributor slice
+ * becomes exactly that the moment one VALID item is bigger than the slice.
+ * Round 3 bounded the model projection at 128 KiB and dropped a valid
+ * configured fallback; round 4 kept the rule and raised the constant to
+ * 512 KiB, and a then-valid 270,000-byte OpenRouter fallback was still dropped —
+ * from a body that would have been 540,778 bytes against a 1,048,576-byte cap.
+ * No constant was the right one; the shape was wrong. Dropping an authored
+ * route served neither purpose a budget has (the body fit, and nothing was
+ * being starved), and it cost real function: the TUI never calls `/v1/models`
+ * and rebuilds its picker from `info.models` alone, so a withheld route is an
+ * unselectable primary or fallback in the operator's own console.
+ *
+ * Nor is a single reference bounded. Two rounds put a byte ceiling in the
+ * reference parser so that no ONE item could be pathological, and both numbers
+ * refused a model that really exists — 96 bytes a Hugging Face GGUF repo Ollama
+ * serves, 160 bytes an `ollama:<model>:<tag>` reference whose two halves Ollama
+ * itself validates at 80 bytes each. A grammar layer does not get to decide what
+ * a provider calls a model, so the ceiling is gone and a single reference can be
+ * any size again. That changes nothing here, because the rule was never about
+ * item size: nothing bounds how MANY routes an operator may declare or how many
+ * rows a local `/v1/models` may report either, so a per-contributor slice would
+ * still be an opinion about authored content, and configured routes still get
+ * none. What it does mean is that the fence below is load-bearing for a case it
+ * briefly was not — one authored route larger than the whole cap — which
+ * `tui-info-wire.test.ts` drives over a real socket.
+ *
+ * So every configured route is admitted, and a result that cannot fit is the
+ * fence's call, made loudly. Advisory discovery then spends its own aggregate
+ * budget on top — but never room the body no longer has
+ * ({@link INFO_NON_MODEL_RESERVE_BYTES}) — so discovery can never be the reason
+ * the fence fires.
+ *
+ * The discovery budget is exported because it is the whole contract between
+ * authored routes and advisory content, and a test that keeps its own copy of a
+ * constant cannot notice that constant changing.
+ */
+export declare const MAX_DISCOVERED_INFO_MODEL_BYTES: number;
 /**
  * Start only a driver created by this module with app-owner capabilities. The
  * private symbol plus exact object identity prevents a plugin or arbitrary
  * driver named `tui` from opting into the owner path.
  */
-export declare function startAppOwnedTuiChannel(driver: ChannelDriver, input: ChannelStartInput<unknown>, processJobs: ProcessJobOperator | undefined): Promise<RunningChannel> | undefined;
+export declare function startAppOwnedTuiChannel(driver: ChannelDriver, input: ChannelStartInput<unknown>, processJobs: ProcessJobOperator | undefined, monitors: MonitorOperator | undefined, providerAuth: ProviderAuthOperator | undefined): Promise<RunningChannel> | undefined;
 /**
  * The TUI stream endpoint deviates from the channels-off convention: with no
  * `tui` section it is enabled on loopback with an ephemeral port. An explicit

package/dist/channel-drivers/tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../src/channel-drivers/tui.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAsB,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAG1F,OAAO,KAAK,EACV,gBAAgB,EAEhB,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AAOtC,OAAO,KAAK,EACV,oBAAoB,EACpB,uBAAuB,EAExB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAIL,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACvF,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,iCAAiC,CAAC;AAOzC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAwCxE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACzF,wEAAwE;IACxE,QAAQ,CAAC,cAAc,CAAC,EAAE,CACxB,SAAS,EAAE,SAAS,uBAAuB,EAAE,GAAG,SAAS,KACtD,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAAC;IAC9C,iFAAiF;IACjF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAC9B,iBAAiB,EAAE,SAAS,MAAM,EAAE,KACjC,OAAO,CAAC,SAAS,wBAAwB,EAAE,CAAC,CAAC;IAClD,0FAA0F;IAC1F,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAC;IAC3E,mEAAmE;IACnE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,sBAAsB,CAAC;CAC9D;AAaD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,EACjC,WAAW,EAAE,kBAAkB,GAAG,SAAS,GAC1C,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAMrC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,GAAE,mBAAwB,EACnC,YAAY,CAAC,EAAE,oBAAoB,GAClC,aAAa,CAAC,gBAAgB,CAAC,CA+UjC"}
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../src/channel-drivers/tui.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAsB,eAAe,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAIjI,OAAO,KAAK,EACV,gBAAgB,EAEhB,iBAAiB,EACjB,qBAAqB,EAItB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,sBAAsB,EAGvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,oBAAoB,EACpB,uBAAuB,EAExB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAIL,sBAAsB,EACvB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAQxE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACzF,wEAAwE;IACxE,QAAQ,CAAC,cAAc,CAAC,EAAE,CACxB,SAAS,EAAE,SAAS,uBAAuB,EAAE,GAAG,SAAS,KACtD,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAAC;IAC9C;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,sBAAsB,CAAC;IAC3D,mEAAmE;IACnE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,sBAAsB,CAAC;CAC9D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,eAAO,MAAM,+BAA+B,QAAa,CAAC;AA2K1D;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,EACjC,WAAW,EAAE,kBAAkB,GAAG,SAAS,EAC3C,QAAQ,EAAE,eAAe,GAAG,SAAS,EACrC,YAAY,EAAE,oBAAoB,GAAG,SAAS,GAC7C,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAQrC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,GAAE,mBAAwB,EACnC,YAAY,CAAC,EAAE,oBAAoB,GAClC,aAAa,CAAC,gBAAgB,CAAC,CA2ejC"}