@deepwatch/dsh-tools 0.1.0

package/lib/typert.host.js

@@ -0,0 +1,649 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
+import { z } from 'zod'
+
+const _deepwatch_dsh_tools_watchQuery_coreHealth_parameter_0$schema = z.object({
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'deadlineMs': z.number().readonly(),
+})
+const _deepwatch_dsh_tools_watchQuery_coreHealth_result$schema = z.union([z.object({
+  'outcome': z.literal("rejected").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'reason': z.union([z.literal("protocol_mismatch"), z.literal("malformed_request"), z.literal("request_too_large"), z.literal("identifier_invalid")]).readonly(),
+  'field': z.union([z.literal(null), z.string()]).readonly(),
+}), z.object({
+  'outcome': z.literal("deadline_exceeded").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'deadlineMs': z.number().readonly(),
+}), z.object({
+  'outcome': z.literal("core_health").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'phase': z.string().readonly(),
+  'blocker': z.union([z.literal("protocol_mismatch"), z.literal("connected"), z.literal("core_missing"), z.literal("bridge_surface_missing"), z.literal("handshake_failed"), z.literal("contract_mismatch"), z.literal("core_crashed"), z.literal("core_timeout"), z.literal("circuit_open"), z.literal("test_only_mock")]).readonly(),
+  'coreVersion': z.union([z.literal(null), z.string()]).readonly(),
+  'coreBuild': z.union([z.literal(null), z.string()]).readonly(),
+  'protocolVersion': z.union([z.literal(null), z.number()]).readonly(),
+  'protocolMin': z.union([z.literal(null), z.number()]).readonly(),
+  'transport': z.union([z.literal(null), z.string()]).readonly(),
+  'isTestOnlyMock': z.boolean().readonly(),
+  'contractsMatch': z.boolean().readonly(),
+  'contractDrift': z.array(z.string()).readonly(),
+  'lastHandshakeAt': z.union([z.literal(null), z.string()]).readonly(),
+  'restartCount': z.number().readonly(),
+  'capabilities': z.object({
+  'ready': z.number().readonly(),
+  'unavailable': z.number().readonly(),
+  'degraded': z.number().readonly(),
+  'unknown': z.number().readonly(),
+}).readonly(),
+  'capabilityDetails': z.array(z.object({
+  'capabilityId': z.string().readonly(),
+  'status': z.union([z.literal("implemented"), z.literal("machine_tested"), z.literal("probed"), z.literal("unavailable"), z.literal("not_tested")]).readonly(),
+  'usable': z.boolean().readonly(),
+  'missing': z.array(z.string()).readonly(),
+  'fixes': z.array(z.string()).readonly(),
+  'lastCheckedAt': z.union([z.literal(null), z.string()]).readonly(),
+})).readonly(),
+  'fix': z.string().readonly(),
+})])
+const _deepwatch_dsh_tools_watchQuery_libraryGet_parameter_0$schema = z.object({
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'recordId': z.string().readonly(),
+  'deadlineMs': z.number().readonly(),
+})
+const _deepwatch_dsh_tools_watchQuery_libraryGet_result$schema = z.union([z.object({
+  'outcome': z.literal("rejected").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'reason': z.union([z.literal("protocol_mismatch"), z.literal("malformed_request"), z.literal("request_too_large"), z.literal("identifier_invalid")]).readonly(),
+  'field': z.union([z.literal(null), z.string()]).readonly(),
+}), z.object({
+  'outcome': z.literal("deadline_exceeded").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'deadlineMs': z.number().readonly(),
+}), z.object({
+  'outcome': z.literal("record").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'revision': z.number().readonly(),
+  'record': z.object({
+  'recordId': z.string().readonly(),
+  'revisionId': z.string().readonly(),
+  'title': z.string().readonly(),
+  'modality': z.string().readonly(),
+  'observedAt': z.union([z.literal(null), z.string()]).readonly(),
+  'source': z.string().readonly(),
+  'runId': z.union([z.literal(null), z.string()]).readonly(),
+  'verdict': z.union([z.literal(null), z.string()]).readonly(),
+  'tags': z.array(z.string()).readonly(),
+  'evidenceIds': z.array(z.string()).readonly(),
+  'current': z.boolean().readonly(),
+}).readonly(),
+}), z.object({
+  'outcome': z.literal("absent").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'revision': z.number().readonly(),
+  'recordId': z.string().readonly(),
+})])
+const _deepwatch_dsh_tools_watchQuery_libraryRefresh_parameter_0$schema = z.object({
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'deadlineMs': z.number().readonly(),
+})
+const _deepwatch_dsh_tools_watchQuery_libraryRefresh_result$schema = z.union([z.object({
+  'outcome': z.literal("rejected").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'reason': z.union([z.literal("protocol_mismatch"), z.literal("malformed_request"), z.literal("request_too_large"), z.literal("identifier_invalid")]).readonly(),
+  'field': z.union([z.literal(null), z.string()]).readonly(),
+}), z.object({
+  'outcome': z.literal("deadline_exceeded").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'deadlineMs': z.number().readonly(),
+}), z.object({
+  'outcome': z.literal("refreshed").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'index': z.object({
+  'generation': z.number().readonly(),
+  'startedAt': z.string().readonly(),
+  'completedAt': z.union([z.literal(null), z.string()]).readonly(),
+  'sourceCount': z.number().readonly(),
+  'recordCount': z.number().readonly(),
+  'indexState': z.union([z.literal("ready"), z.literal("rebuilding"), z.literal("stale"), z.literal("empty")]).readonly(),
+}).readonly(),
+  'skipped': z.array(z.string()).readonly(),
+}), z.object({
+  'outcome': z.literal("refresh_cancelled").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'index': z.object({
+  'generation': z.number().readonly(),
+  'startedAt': z.string().readonly(),
+  'completedAt': z.union([z.literal(null), z.string()]).readonly(),
+  'sourceCount': z.number().readonly(),
+  'recordCount': z.number().readonly(),
+  'indexState': z.union([z.literal("ready"), z.literal("rebuilding"), z.literal("stale"), z.literal("empty")]).readonly(),
+}).readonly(),
+}), z.object({
+  'outcome': z.literal("refresh_failed").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'reason': z.string().readonly(),
+  'index': z.object({
+  'generation': z.number().readonly(),
+  'startedAt': z.string().readonly(),
+  'completedAt': z.union([z.literal(null), z.string()]).readonly(),
+  'sourceCount': z.number().readonly(),
+  'recordCount': z.number().readonly(),
+  'indexState': z.union([z.literal("ready"), z.literal("rebuilding"), z.literal("stale"), z.literal("empty")]).readonly(),
+}).readonly(),
+})])
+const _deepwatch_dsh_tools_watchQuery_librarySearch_parameter_0$schema = z.object({
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'query': z.string().readonly(),
+  'modalities': z.array(z.string()).readonly(),
+  'limit': z.number().readonly(),
+  'cursor': z.union([z.literal(null), z.string()]).readonly(),
+  'deadlineMs': z.number().readonly(),
+})
+const _deepwatch_dsh_tools_watchQuery_librarySearch_result$schema = z.union([z.object({
+  'outcome': z.literal("page").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'revision': z.number().readonly(),
+  'generation': z.number().readonly(),
+  'records': z.array(z.object({
+  'recordId': z.string().readonly(),
+  'revisionId': z.string().readonly(),
+  'title': z.string().readonly(),
+  'modality': z.string().readonly(),
+  'observedAt': z.union([z.literal(null), z.string()]).readonly(),
+  'source': z.string().readonly(),
+  'runId': z.union([z.literal(null), z.string()]).readonly(),
+  'verdict': z.union([z.literal(null), z.string()]).readonly(),
+  'tags': z.array(z.string()).readonly(),
+  'evidenceIds': z.array(z.string()).readonly(),
+  'current': z.boolean().readonly(),
+})).readonly(),
+  'nextCursor': z.union([z.literal(null), z.string()]).readonly(),
+  'total': z.number().readonly(),
+  'indexState': z.union([z.literal("ready"), z.literal("rebuilding"), z.literal("stale"), z.literal("empty")]).readonly(),
+}), z.object({
+  'outcome': z.literal("cursor_expired").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'revision': z.number().readonly(),
+}), z.object({
+  'outcome': z.literal("rejected").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'reason': z.union([z.literal("protocol_mismatch"), z.literal("malformed_request"), z.literal("request_too_large"), z.literal("identifier_invalid")]).readonly(),
+  'field': z.union([z.literal(null), z.string()]).readonly(),
+}), z.object({
+  'outcome': z.literal("deadline_exceeded").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'deadlineMs': z.number().readonly(),
+})])
+const _deepwatch_dsh_tools_watchQuery_providerTest_parameter_0$schema = z.object({
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'deadlineMs': z.number().readonly(),
+  'provider': z.string().readonly(),
+  'model': z.string().readonly(),
+})
+const _deepwatch_dsh_tools_watchQuery_providerTest_result$schema = z.object({
+  'outcome': z.literal("provider_test").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'provider': z.string().readonly(),
+  'model': z.string().readonly(),
+  'ok': z.boolean().readonly(),
+  'credential': z.union([z.literal("rejected"), z.literal("configured_unverified"), z.literal("verified")]).readonly(),
+  'reachability': z.union([z.literal("reachable"), z.literal("unreachable"), z.literal("rate_limited"), z.literal("unauthorized")]).readonly(),
+  'message': z.string().readonly(),
+})
+const _deepwatch_dsh_tools_watchQuery_routeReadiness_parameter_0$schema = z.object({
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'deadlineMs': z.number().readonly(),
+  'provider': z.string().readonly(),
+  'model': z.string().readonly(),
+})
+const _deepwatch_dsh_tools_watchQuery_routeReadiness_result$schema = z.union([z.object({
+  'outcome': z.literal("rejected").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'reason': z.union([z.literal("protocol_mismatch"), z.literal("malformed_request"), z.literal("request_too_large"), z.literal("identifier_invalid")]).readonly(),
+  'field': z.union([z.literal(null), z.string()]).readonly(),
+}), z.object({
+  'outcome': z.literal("deadline_exceeded").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'deadlineMs': z.number().readonly(),
+}), z.object({
+  'outcome': z.literal("route_readiness").readonly(),
+  'protocol': z.number().readonly(),
+  'requestId': z.string().readonly(),
+  'provider': z.string().readonly(),
+  'model': z.string().readonly(),
+  'proved': z.boolean().readonly(),
+  'reason': z.union([z.literal("proved"), z.literal("never_tested"), z.literal("configuration_changed"), z.literal("unreadable")]).readonly(),
+})])
+
+export const TYPERT = {
+  package: '@deepwatch/dsh-tools',
+  face: 'host',
+  schemas: [
+  ],
+  invocations: [
+    {
+      id: '@deepwatch/dsh-tools#watchQuery/coreHealth',
+      service: 'watchQuery',
+      namespace: 'watchQuery',
+      method: 'coreHealth',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepwatch/dsh-contracts/query/wire#CoreHealthRequest',
+            schema: _deepwatch_dsh_tools_watchQuery_coreHealth_parameter_0$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepwatch/dsh-contracts/query/wire#CoreHealthResponse',
+        schema: _deepwatch_dsh_tools_watchQuery_coreHealth_result$schema,
+      },
+      sourceLocation: {"file":"packages/watch/tools/src/read-plane.ts","line":232,"column":3},
+    },
+    {
+      id: '@deepwatch/dsh-tools#watchQuery/libraryGet',
+      service: 'watchQuery',
+      namespace: 'watchQuery',
+      method: 'libraryGet',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepwatch/dsh-contracts/query/wire#LibraryGetRequest',
+            schema: _deepwatch_dsh_tools_watchQuery_libraryGet_parameter_0$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepwatch/dsh-contracts/query/wire#LibraryGetResponse',
+        schema: _deepwatch_dsh_tools_watchQuery_libraryGet_result$schema,
+      },
+      sourceLocation: {"file":"packages/watch/tools/src/read-plane.ts","line":194,"column":3},
+    },
+    {
+      id: '@deepwatch/dsh-tools#watchQuery/libraryRefresh',
+      service: 'watchQuery',
+      namespace: 'watchQuery',
+      method: 'libraryRefresh',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepwatch/dsh-contracts/query/wire#LibraryRefreshRequest',
+            schema: _deepwatch_dsh_tools_watchQuery_libraryRefresh_parameter_0$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepwatch/dsh-contracts/query/wire#LibraryRefreshResponse',
+        schema: _deepwatch_dsh_tools_watchQuery_libraryRefresh_result$schema,
+      },
+      sourceLocation: {"file":"packages/watch/tools/src/read-plane.ts","line":213,"column":3},
+    },
+    {
+      id: '@deepwatch/dsh-tools#watchQuery/librarySearch',
+      service: 'watchQuery',
+      namespace: 'watchQuery',
+      method: 'librarySearch',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepwatch/dsh-contracts/query/wire#LibrarySearchRequest',
+            schema: _deepwatch_dsh_tools_watchQuery_librarySearch_parameter_0$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepwatch/dsh-contracts/query/wire#LibrarySearchResponse',
+        schema: _deepwatch_dsh_tools_watchQuery_librarySearch_result$schema,
+      },
+      sourceLocation: {"file":"packages/watch/tools/src/read-plane.ts","line":182,"column":3},
+    },
+    {
+      id: '@deepwatch/dsh-tools#watchQuery/providerTest',
+      service: 'watchQuery',
+      namespace: 'watchQuery',
+      method: 'providerTest',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepwatch/dsh-contracts/query/wire#ProviderTestRequest',
+            schema: _deepwatch_dsh_tools_watchQuery_providerTest_parameter_0$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepwatch/dsh-contracts/query/wire#ProviderTestResponse',
+        schema: _deepwatch_dsh_tools_watchQuery_providerTest_result$schema,
+      },
+      sourceLocation: {"file":"packages/watch/tools/src/read-plane.ts","line":240,"column":3},
+    },
+    {
+      id: '@deepwatch/dsh-tools#watchQuery/routeReadiness',
+      service: 'watchQuery',
+      namespace: 'watchQuery',
+      method: 'routeReadiness',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'request',
+          wire: 'request',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: '@deepwatch/dsh-contracts/query/wire#RouteReadinessRequest',
+            schema: _deepwatch_dsh_tools_watchQuery_routeReadiness_parameter_0$schema,
+          },
+        },
+      ],
+      cancellation: { parameter: 'signal' },
+      result: {
+        mode: 'strict',
+        typeSymbol: '@deepwatch/dsh-contracts/query/wire#RouteReadinessResponse',
+        schema: _deepwatch_dsh_tools_watchQuery_routeReadiness_result$schema,
+      },
+      sourceLocation: {"file":"packages/watch/tools/src/read-plane.ts","line":258,"column":3},
+    },
+  ],
+  model: {
+    "services": [
+      {
+        "description": "The Typert Remote a Watch surface calls. `watchQuery` is both the Cordis service key and the wire namespace, so the client reaches it as `ctx.remote.watchQuery`.",
+        "summary": "The Typert Remote a Watch surface calls.",
+        "tags": [],
+        "jsDoc": "/**\n * The Typert Remote a Watch surface calls.\n *\n * `watchQuery` is both the Cordis service key and the wire namespace, so the\n * client reaches it as `ctx.remote.watchQuery`.\n */",
+        "key": "watchQuery",
+        "exportName": "WatchQueryService",
+        "members": [
+          {
+            "kind": "property",
+            "name": "config",
+            "signature": "readonly config: ReadPlaneConfig",
+            "summary": "Deliberately not a `#private` field.",
+            "jsDoc": "/**\n * Deliberately not a `#private` field.\n *\n * Cordis hands a Service to callers through a Proxy, and a private field is\n * unreachable through one: the Gateway invoked this method and got\n * \"Cannot read private member #config from an object whose class did not\n * declare it\". Every direct unit test passed, because a direct call has no\n * proxy in front of it -- which is the whole argument for exercising this\n * through the real Gateway.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "librarySearch",
+            "signature": "@Remote('librarySearch') librarySearch( request: LibrarySearchRequest, signal: AbortSignal, ): Promise<LibrarySearchResponse>",
+            "summary": "One concrete method per read, rather than one `read` over a union.",
+            "jsDoc": "/**\n * One concrete method per read, rather than one `read` over a union.\n *\n * DSH already routes by method, so a discriminated union inside a single\n * entry point would be a second router with its own schema to generate.\n * One request type and one response type per method is what Typert emits\n * a strict codec from most directly.\n *\n * `signal` is last, as Typert requires, and is not serialised.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "libraryGet",
+            "signature": "@Remote('libraryGet') libraryGet( request: LibraryGetRequest, signal: AbortSignal, ): Promise<LibraryGetResponse>",
+            "summary": "One record by id.",
+            "jsDoc": "/** One record by id. A direct lookup, not a one-result search. */"
+          },
+          {
+            "kind": "method",
+            "name": "libraryRefresh",
+            "signature": "@Remote('libraryRefresh') libraryRefresh( request: LibraryRefreshRequest, signal: AbortSignal, ): Promise<LibraryRefreshResponse>",
+            "summary": "Read the roots again, and put the result into service if it is healthy.",
+            "jsDoc": "/**\n * Read the roots again, and put the result into service if it is healthy.\n *\n * The only method here with a side effect, and the only one that is not a\n * question. It is a separate method for exactly that reason: a `rebuild`\n * flag on `librarySearch` would make every search a potential re-read of the\n * corpus, and would leave a caller no way to ask for an answer from what the\n * host already has.\n *\n * Genuinely async, unlike its siblings: the rebuild yields between files so\n * a caller that stops waiting can be observed doing so.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "coreHealth",
+            "signature": "@Remote('coreHealth') coreHealth( request: CoreHealthRequest, signal: AbortSignal, ): Promise<CoreHealthResponse>",
+            "summary": "What Watch Core is doing right now, read from the running Bridge.",
+            "jsDoc": "/**\n * What Watch Core is doing right now, read from the running Bridge.\n *\n * The one method here that is not about the Library, and it is here because\n * this is the only channel the browser has to the Host. Diagnostics used to\n * render \"Connected over stdio\" and a version number as literals in a\n * component, because there was nowhere to read them from.\n *\n * Nothing is defaulted. A value the Bridge has not established is `null`,\n * and the panel renders that as \"not reported\" -- which is worth less than a\n * real reading and far more than a confident wrong one.\n */"
+          },
+          {
+            "kind": "method",
+            "name": "providerTest",
+            "signature": "@Remote('providerTest') providerTest( request: ProviderTestRequest, signal: AbortSignal, ): Promise<ProviderTestResponse>",
+            "summary": "Spend one deliberately tiny provider request only after a person asks.",
+            "jsDoc": "/** Spend one deliberately tiny provider request only after a person asks. */"
+          },
+          {
+            "kind": "method",
+            "name": "routeReadiness",
+            "signature": "@Remote('routeReadiness') routeReadiness( request: RouteReadinessRequest, signal: AbortSignal, ): Promise<RouteReadinessResponse>",
+            "summary": "Whether the Host would serve this route right now, asked without spending anything.",
+            "jsDoc": "/**\n * Whether the Host would serve this route right now, asked without spending\n * anything.\n *\n * The browser half used to answer this from its own memory of a provider\n * test it had run, which is a claim about a Host it cannot see. A tab that\n * stayed open across a Host restart, or across an edit made in another tab,\n * kept drawing a tested badge over a route the Host had already stopped\n * being willing to serve — and the composer it gates opened onto a refusal.\n * There is one answer, and this is where it is read from.\n */"
+          }
+        ],
+        "types": [
+          {
+            "name": "CapabilityHealthDetail",
+            "declaration": "export interface CapabilityHealthDetail {\n    readonly capabilityId: string;\n    readonly status: 'implemented' | 'machine_tested' | 'probed' | 'unavailable' | 'not_tested';\n    readonly usable: boolean;\n    readonly missing: readonly string[];\n    readonly fixes: readonly string[];\n    readonly lastCheckedAt: string | null;\n}"
+          },
+          {
+            "name": "CapabilityTally",
+            "declaration": "export interface CapabilityTally {\n    readonly ready: number;\n    readonly unavailable: number;\n    readonly degraded: number;\n    readonly unknown: number;\n}"
+          },
+          {
+            "name": "CoreBlocker",
+            "declaration": "export type CoreBlocker = 'connected' | 'core_missing' | 'bridge_surface_missing' | 'handshake_failed' | 'protocol_mismatch' | 'contract_mismatch' | 'core_crashed' | 'core_timeout' | 'circuit_open' | 'test_only_mock';"
+          },
+          {
+            "name": "CoreHealthReport",
+            "declaration": "export interface CoreHealthReport {\n    readonly outcome: 'core_health';\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly phase: string;\n    readonly blocker: CoreBlocker;\n    readonly coreVersion: string | null;\n    readonly coreBuild: string | null;\n    readonly protocolVersion: number | null;\n    readonly protocolMin: number | null;\n    readonly transport: string | null;\n    readonly isTestOnlyMock: boolean;\n    readonly contractsMatch: boolean;\n    readonly contractDrift: readonly string[];\n    readonly lastHandshakeAt: string | null;\n    readonly restartCount: number;\n    readonly capabilities: CapabilityTally;\n    readonly capabilityDetails: readonly CapabilityHealthDetail[];\n    readonly fix: string;\n}"
+          },
+          {
+            "name": "CoreHealthRequest",
+            "declaration": "export interface CoreHealthRequest {\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly deadlineMs: number;\n}"
+          },
+          {
+            "name": "CoreHealthResponse",
+            "declaration": "export type CoreHealthResponse = CoreHealthReport | LibraryRequestRejected | LibraryDeadlineExceeded;"
+          },
+          {
+            "name": "IndexableRecord",
+            "declaration": "export interface IndexableRecord {\n    readonly recordId: string;\n    readonly revisionId: string;\n    readonly title: string;\n    readonly kind: SourceKind;\n    readonly text: string;\n    readonly source: string | null;\n    readonly runId: string | null;\n    readonly observedAt: string | null;\n    readonly verdict: string | null;\n    readonly tags: readonly string[];\n    readonly evidenceIds: readonly string[];\n}"
+          },
+          {
+            "name": "IndexGeneration",
+            "declaration": "export interface IndexGeneration {\n    readonly generation: number;\n    readonly startedAt: string;\n    readonly completedAt: string | null;\n    readonly sourceCount: number;\n    readonly recordCount: number;\n    readonly indexState: LibraryIndexState;\n    readonly skipped: readonly string[];\n}"
+          },
+          {
+            "name": "IndexHealth",
+            "declaration": "export type IndexHealth = 'empty' | 'ready' | 'indexing' | 'stale' | 'corrupt';"
+          },
+          {
+            "name": "IndexQuery",
+            "declaration": "export interface IndexQuery {\n    readonly text: string;\n    readonly kinds?: readonly SourceKind[];\n    readonly runIds?: readonly string[];\n    readonly verdicts?: readonly string[];\n    readonly tags?: readonly string[];\n    readonly sources?: readonly string[];\n    readonly from?: string;\n    readonly to?: string;\n    readonly sort?: 'relevance' | 'newest' | 'oldest' | 'title';\n    readonly offset?: number;\n    readonly limit?: number;\n    readonly signal?: AbortSignal;\n}"
+          },
+          {
+            "name": "IndexQueryResult",
+            "declaration": "export interface IndexQueryResult {\n    readonly results: readonly SearchResult[];\n    readonly total: number;\n    readonly offset: number;\n    readonly limit: number;\n    readonly health: IndexHealth;\n    readonly notes: readonly string[];\n}"
+          },
+          {
+            "name": "LibraryCursorExpired",
+            "declaration": "export interface LibraryCursorExpired {\n    readonly outcome: 'cursor_expired';\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly revision: number;\n}"
+          },
+          {
+            "name": "LibraryDeadlineExceeded",
+            "declaration": "export interface LibraryDeadlineExceeded {\n    readonly outcome: 'deadline_exceeded';\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly deadlineMs: number;\n}"
+          },
+          {
+            "name": "LibraryGenerations",
+            "declaration": "export class LibraryGenerations {\n    addLive(record: IndexableRecord): void;\n    liveCount(): number;\n    index(): LibraryIndex;\n    generation(): IndexGeneration;\n    refresh(requestId: string, signal: AbortSignal): Promise<RefreshOutcome>;\n    rebuilding(): boolean;\n}"
+          },
+          {
+            "name": "LibraryGetRequest",
+            "declaration": "export interface LibraryGetRequest {\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly recordId: string;\n    readonly deadlineMs: number;\n}"
+          },
+          {
+            "name": "LibraryGetResponse",
+            "declaration": "export type LibraryGetResponse = LibraryRecordFound | LibraryRecordAbsent | LibraryRequestRejected | LibraryDeadlineExceeded;"
+          },
+          {
+            "name": "LibraryIndex",
+            "declaration": "export class LibraryIndex {\n    get health(): IndexHealth;\n    record(recordId: string): IndexableRecord | undefined;\n    get size(): number;\n    get pending(): readonly string[];\n    get diagnostics(): readonly string[];\n    add(input: IndexableRecord): void;\n    addAll(records: readonly IndexableRecord[], signal?: AbortSignal): number;\n    remove(recordId: string): boolean;\n    clear(): void;\n    markStale(reason: string): void;\n    search(query: IndexQuery): IndexQueryResult;\n    serialize(): SerializedIndex;\n}"
+          },
+          {
+            "name": "LibraryIndexGeneration",
+            "declaration": "export interface LibraryIndexGeneration {\n    readonly generation: number;\n    readonly startedAt: string;\n    readonly completedAt: string | null;\n    readonly sourceCount: number;\n    readonly recordCount: number;\n    readonly indexState: LibraryIndexState;\n}"
+          },
+          {
+            "name": "LibraryIndexState",
+            "declaration": "export type LibraryIndexState = 'ready' | 'rebuilding' | 'stale' | 'empty';"
+          },
+          {
+            "name": "LibraryRecord",
+            "declaration": "export interface LibraryRecord {\n    readonly recordId: string;\n    readonly revisionId: string;\n    readonly title: string;\n    readonly modality: string;\n    readonly observedAt: string | null;\n    readonly source: string;\n    readonly runId: string | null;\n    readonly verdict: string | null;\n    readonly tags: readonly string[];\n    readonly evidenceIds: readonly string[];\n    readonly current: boolean;\n}"
+          },
+          {
+            "name": "LibraryRecordAbsent",
+            "declaration": "export interface LibraryRecordAbsent {\n    readonly outcome: 'absent';\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly revision: number;\n    readonly recordId: string;\n}"
+          },
+          {
+            "name": "LibraryRecordFound",
+            "declaration": "export interface LibraryRecordFound {\n    readonly outcome: 'record';\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly revision: number;\n    readonly record: LibraryRecord;\n}"
+          },
+          {
+            "name": "LibraryRefreshCancelled",
+            "declaration": "export interface LibraryRefreshCancelled {\n    readonly outcome: 'refresh_cancelled';\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly index: LibraryIndexGeneration;\n}"
+          },
+          {
+            "name": "LibraryRefreshed",
+            "declaration": "export interface LibraryRefreshed {\n    readonly outcome: 'refreshed';\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly index: LibraryIndexGeneration;\n    readonly skipped: readonly string[];\n}"
+          },
+          {
+            "name": "LibraryRefreshFailed",
+            "declaration": "export interface LibraryRefreshFailed {\n    readonly outcome: 'refresh_failed';\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly reason: string;\n    readonly index: LibraryIndexGeneration;\n}"
+          },
+          {
+            "name": "LibraryRefreshRequest",
+            "declaration": "export interface LibraryRefreshRequest {\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly deadlineMs: number;\n}"
+          },
+          {
+            "name": "LibraryRefreshResponse",
+            "declaration": "export type LibraryRefreshResponse = LibraryRefreshed | LibraryRefreshCancelled | LibraryRefreshFailed | LibraryRequestRejected | LibraryDeadlineExceeded;"
+          },
+          {
+            "name": "LibraryRequestRejected",
+            "declaration": "export interface LibraryRequestRejected {\n    readonly outcome: 'rejected';\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly reason: 'protocol_mismatch' | 'malformed_request' | 'request_too_large' | 'identifier_invalid';\n    readonly field: string | null;\n}"
+          },
+          {
+            "name": "LibrarySearchPage",
+            "declaration": "export interface LibrarySearchPage {\n    readonly outcome: 'page';\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly revision: number;\n    readonly generation: number;\n    readonly records: readonly LibraryRecord[];\n    readonly nextCursor: string | null;\n    readonly total: number;\n    readonly indexState: LibraryIndexState;\n}"
+          },
+          {
+            "name": "LibrarySearchRequest",
+            "declaration": "export interface LibrarySearchRequest {\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly query: string;\n    readonly modalities: readonly string[];\n    readonly limit: number;\n    readonly cursor: string | null;\n    readonly deadlineMs: number;\n}"
+          },
+          {
+            "name": "LibrarySearchResponse",
+            "declaration": "export type LibrarySearchResponse = LibrarySearchPage | LibraryCursorExpired | LibraryRequestRejected | LibraryDeadlineExceeded;"
+          },
+          {
+            "name": "ProviderTestRequest",
+            "declaration": "export interface ProviderTestRequest {\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly deadlineMs: number;\n    readonly provider: string;\n    readonly model: string;\n}"
+          },
+          {
+            "name": "ProviderTestResponse",
+            "declaration": "export interface ProviderTestResponse {\n    readonly outcome: 'provider_test';\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly provider: string;\n    readonly model: string;\n    readonly ok: boolean;\n    readonly credential: 'configured_unverified' | 'verified' | 'rejected';\n    readonly reachability: 'reachable' | 'unreachable' | 'rate_limited' | 'unauthorized';\n    readonly message: string;\n}"
+          },
+          {
+            "name": "ReadPlaneConfig",
+            "declaration": "export interface ReadPlaneConfig {\n    readonly index: () => LibraryIndex;\n    readonly scope: string;\n    readonly generations?: LibraryGenerations;\n}"
+          },
+          {
+            "name": "RefreshOutcome",
+            "declaration": "export type RefreshOutcome = { readonly kind: 'refreshed'; readonly index: IndexGeneration; } | { readonly kind: 'cancelled'; readonly index: IndexGeneration; } | { readonly kind: 'failed'; readonly reason: string; readonly index: IndexGeneration; };"
+          },
+          {
+            "name": "RetrievalPath",
+            "declaration": "export type RetrievalPath = 'lexical' | 'semantic' | 'both';"
+          },
+          {
+            "name": "RouteReadinessReport",
+            "declaration": "export interface RouteReadinessReport {\n    readonly outcome: 'route_readiness';\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly provider: string;\n    readonly model: string;\n    readonly proved: boolean;\n    readonly reason: 'proved' | 'never_tested' | 'configuration_changed' | 'unreadable';\n}"
+          },
+          {
+            "name": "RouteReadinessRequest",
+            "declaration": "export interface RouteReadinessRequest {\n    readonly protocol: number;\n    readonly requestId: string;\n    readonly deadlineMs: number;\n    readonly provider: string;\n    readonly model: string;\n}"
+          },
+          {
+            "name": "RouteReadinessResponse",
+            "declaration": "export type RouteReadinessResponse = RouteReadinessReport | LibraryRequestRejected | LibraryDeadlineExceeded;"
+          },
+          {
+            "name": "SearchHit",
+            "declaration": "export interface SearchHit {\n    readonly sourceId: string;\n    readonly sourceRevisionId: string;\n    readonly range: TemporalRange | null;\n    readonly text: string;\n    readonly path: RetrievalPath;\n    readonly score: number;\n    readonly evidenceIds: readonly string[];\n}"
+          },
+          {
+            "name": "SearchResult",
+            "declaration": "export interface SearchResult {\n    readonly sourceId: string;\n    readonly title: string;\n    readonly kind: SourceKind;\n    readonly hits: readonly SearchHit[];\n    readonly current: boolean;\n}"
+          },
+          {
+            "name": "SerializedIndex",
+            "declaration": "export interface SerializedIndex {\n    readonly version: number;\n    readonly digest: string;\n    readonly builtAt: string;\n    readonly documents: readonly IndexableRecord[];\n    readonly postings: Readonly<Record<string, readonly string[]>>;\n}"
+          },
+          {
+            "name": "SourceKind",
+            "declaration": "export type SourceKind = 'video' | 'audio' | 'page' | 'stream' | 'document' | 'screen_capture';"
+          },
+          {
+            "name": "TemporalRange",
+            "declaration": "export interface TemporalRange {\n    readonly startMs: number;\n    readonly endMs: number;\n}"
+          }
+        ]
+      }
+    ],
+    "events": [],
+    "objects": []
+  },
+}