@apnex/network-adapter 0.1.1 → 0.1.5

package/dist/build-info.json

@@ -0,0 +1,6 @@
+{
+  "commitSha": "1e3b998",
+  "dirty": true,
+  "buildTime": "2026-07-02T00:28:48.756Z",
+  "branch": "main"
+}

package/dist/file-logger.d.ts

@@ -0,0 +1,42 @@
+import type { ILogger, LogFields } from "./logger.js";
+import { type LogLevel } from "./observability.js";
+export interface FileLoggerOptions {
+    /** Text log file: timestamped human-readable lines. Required. */
+    textFile: string;
+    /**
+     * NDJSON structured-events file. When set, `appendEvent` + `logger` fan out
+     * here; when absent (opencode), `appendEvent` is a no-op.
+     */
+    eventsFile?: string;
+    /** Rotate textFile + eventsFile once either exceeds this many bytes. */
+    rotateBytes?: number;
+    /** Mirror every text line to process.stderr (claude: true; opencode: omit). */
+    mirrorToStderr?: boolean;
+    /**
+     * Suppress NDJSON events tagged with `fields.level` below this threshold
+     * (ADR-031 §3). Unlevelled events always emit. Default INFO.
+     */
+    logLevel?: LogLevel;
+    /** pid stamped into the NDJSON envelope. Default `process.pid`. */
+    pid?: number;
+    /** Fields pre-bound to every `logger` emission (root bind). */
+    bound?: LogFields;
+    /**
+     * Render a text-log line (including trailing newline) from a message.
+     * Default: `[<ISO with T/Z stripped>] <msg>\n` (claude's format). opencode
+     * injects `<raw ISO> <msg>\n`.
+     */
+    formatLine?: (msg: string) => string;
+}
+export interface FileLogger {
+    /** Append a human-readable line to textFile (+ optional stderr mirror). */
+    log(msg: string): void;
+    /**
+     * Append a structured NDJSON event (redacted, level-filtered). No-op when
+     * no `eventsFile` was configured.
+     */
+    appendEvent(event: string, fields: LogFields, message?: string): void;
+    /** Concrete ILogger fanning out to NDJSON events + the text log. */
+    logger: ILogger;
+}
+export declare function createFileLogger(opts: FileLoggerOptions): FileLogger;

package/dist/file-logger.js

@@ -0,0 +1,122 @@
+/**
+ * file-logger.ts — file-backed logging primitives shared by host shims.
+ *
+ * idea-355 SLICE-1 single-home: the claude shim's `FileBackedLogger` (NDJSON
+ * events + text-log + stderr fan-out, size-rotation, redaction, level-filter)
+ * and the opencode shim's simple text-append `log()` are two points on one
+ * spectrum. `createFileLogger` parameterizes both — a host supplies its file
+ * paths and which fan-out targets it wants, and gets back:
+ *   - `log(msg)`     — the human-readable text sink (claude: + stderr mirror)
+ *   - `appendEvent`  — the NDJSON structured-events writer (no-op when no
+ *                      `eventsFile`; opencode never sets one)
+ *   - `logger`       — a concrete `ILogger` fanning out to both of the above
+ *
+ * Behavior-preserving by construction: each host injects its exact line
+ * format via `formatLine`, so no cosmetic drift vs the pre-hoist shims.
+ *
+ * Filesystem side-effects only; no module-init config read (unit-test safe).
+ */
+import { appendFileSync, mkdirSync, renameSync, statSync } from "node:fs";
+import { dirname } from "node:path";
+import { redactFields, shouldEmitLevel } from "./observability.js";
+function ensureDir(path) {
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+    }
+    catch {
+        /* best-effort */
+    }
+}
+function rotateIfNeeded(file, rotateBytes) {
+    try {
+        const stat = statSync(file);
+        if (stat.size > rotateBytes) {
+            renameSync(file, `${file}.${Date.now()}`);
+        }
+    }
+    catch {
+        /* file doesn't exist yet, that's fine */
+    }
+}
+// The claude `FileBackedLogger`'s per-field renderer: each field prefixed with
+// a leading space, joined with no separator. Kept verbatim so the rendered
+// text-log lines are byte-identical to the pre-hoist shim.
+function renderFields(fields) {
+    const parts = [];
+    for (const k of Object.keys(fields)) {
+        const v = fields[k];
+        parts.push(` ${k}=${Array.isArray(v) ? `[${v.join(",")}]` : String(v)}`);
+    }
+    return parts.join("");
+}
+const defaultFormatLine = (msg) => `[${new Date().toISOString().replace("T", " ").replace("Z", "")}] ${msg}\n`;
+export function createFileLogger(opts) {
+    const formatLine = opts.formatLine ?? defaultFormatLine;
+    const logLevel = opts.logLevel ?? "INFO";
+    const pid = opts.pid ?? process.pid;
+    ensureDir(opts.textFile);
+    if (opts.eventsFile)
+        ensureDir(opts.eventsFile);
+    if (opts.rotateBytes) {
+        rotateIfNeeded(opts.textFile, opts.rotateBytes);
+        if (opts.eventsFile)
+            rotateIfNeeded(opts.eventsFile, opts.rotateBytes);
+    }
+    function log(msg) {
+        const line = formatLine(msg);
+        if (opts.mirrorToStderr)
+            process.stderr.write(line);
+        try {
+            appendFileSync(opts.textFile, line);
+        }
+        catch {
+            /* best-effort — never disturb the call loop */
+        }
+    }
+    function appendEvent(event, fields, message) {
+        if (!opts.eventsFile)
+            return;
+        // OIS_SHIM_LOG_LEVEL filter (ADR-031 §3): events tagged with `fields.level`
+        // below threshold are suppressed; unlevelled events always emit.
+        if (!shouldEmitLevel(fields.level, logLevel)) {
+            return;
+        }
+        const line = JSON.stringify({
+            ts: new Date().toISOString(),
+            event,
+            fields: redactFields(fields),
+            message: message ?? null,
+            pid,
+        }) + "\n";
+        try {
+            appendFileSync(opts.eventsFile, line);
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    // FileBackedLogger — concrete ILogger fanning out to: (1) NDJSON events file
+    // (structured fields preserved) and (2) text log + optional stderr (rendered
+    // friendly form). Bound fields apply to every emission; `child()` scopes a
+    // logger to a session / reconnect without threading context.
+    function makeLogger(bound) {
+        return {
+            log(event, fields, message) {
+                const merged = { ...bound, ...(fields ?? {}) };
+                appendEvent(event, merged, message);
+                if (message) {
+                    log(`[${event}] ${message}`);
+                }
+                else {
+                    const fieldsStr = renderFields(merged);
+                    log(fieldsStr ? `[${event}]${fieldsStr}` : `[${event}]`);
+                }
+            },
+            child(fields) {
+                return makeLogger({ ...bound, ...fields });
+            },
+        };
+    }
+    return { log, appendEvent, logger: makeLogger(opts.bound ?? {}) };
+}
+//# sourceMappingURL=file-logger.js.map

package/dist/file-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-logger.js","sourceRoot":"","sources":["../src/file-logger.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -2,28 +2,52 @@ export type { ITransport, TransportConfig, TransportMetrics, WireState, WireReco
 export { McpTransport } from "./wire/mcp-transport.js";
 export { McpAgentClient } from "./kernel/mcp-agent-client.js";
 export type { McpAgentClientOptions } from "./kernel/mcp-agent-client.js";
-export type { IAgentClient, AgentClientConfig, AgentClientCallbacks, AgentClientMetrics, AgentEvent, AgentHandshakeConfig, SessionState, SessionReconnectReason, } from "./kernel/agent-client.js";
-export type { HubEventType, HubEvent, EventDisposition, } from "./kernel/event-router.js";
-export { classifyEvent, parseHubEvent, createDedupFilter, } from "./kernel/event-router.js";
-export { loadOrCreateGlobalInstanceId } from "./kernel/instance.js";
-export type { LoadInstanceOptions } from "./kernel/instance.js";
-export { FATAL_CODES, parseHandshakeError, parseHandshakeResponse, buildHandshakePayload, performHandshake, makeStdioFatalHalt, } from "./kernel/handshake.js";
+export type { IAgentClient, AgentClientConfig, AgentClientCallbacks, AgentClientMetrics, AgentHandshakeConfig, } from "./kernel/agent-client.js";
+export type { AgentEvent, SessionState, SessionReconnectReason, DrainedPendingAction, } from "@apnex/message-router";
+export type { HubEventType, HubEvent, EventDisposition, DrainedActionReconstruction, } from "./kernel/event-router.js";
+export { classifyEvent, parseHubEvent, createDedupFilter, isPulseEvent, PULSE_KINDS, reconstructDrainedAction, } from "./kernel/event-router.js";
+export { FATAL_CODES, parseHandshakeError, parseHandshakeResponse, buildHandshakePayload, performHandshake, makeStdioFatalHalt, readRequiredAgentName, } from "./kernel/handshake.js";
 export type { HandshakeClientMetadata, HandshakeAdvisoryTags, HandshakePayload, HandshakeResponse, HandshakeFatalError, HandshakeConfig, HandshakeContext, HandshakeResult, } from "./kernel/handshake.js";
+export { parseLabels, loadConfig } from "./kernel/adapter-config.js";
+export type { HubConfig, LoadConfigOptions } from "./kernel/adapter-config.js";
+export { readPackageVersion, readBuildInfo, UNKNOWN_BUILD_INFO, } from "./kernel/build-identity.js";
+export type { BuildInfo } from "./kernel/build-identity.js";
+export { REDACT_KEYS, redactFields, LOG_LEVELS, parseLogLevel, shouldEmitLevel, } from "./observability.js";
+export type { LogLevel } from "./observability.js";
+export { createFileLogger } from "./file-logger.js";
+export type { FileLogger, FileLoggerOptions } from "./file-logger.js";
 export { performStateSync } from "./kernel/state-sync.js";
-export type { StateSyncContext, DrainedPendingAction } from "./kernel/state-sync.js";
-export { PollBackstop, defaultCursorFile, readCursor, writeCursor, } from "./kernel/poll-backstop.js";
+export type { StateSyncContext } from "./kernel/state-sync.js";
+export { PollBackstop, defaultCursorFile, resolveRole, readCursor, writeCursor, } from "./kernel/poll-backstop.js";
 export type { PollBackstopOptions } from "./kernel/poll-backstop.js";
 export { isEagerWarmupEnabled, parseClaimSessionResponse, formatSessionClaimedLogLine, } from "./kernel/session-claim.js";
 export type { ClaimSessionParsed } from "./kernel/session-claim.js";
-export { createSharedDispatcher, pendingKey, injectQueueItemId, } from "./tool-manager/dispatcher.js";
-export type { DispatcherClientInfo, DispatcherNotificationHooks, SharedDispatcherOptions, SharedDispatcher, } from "./tool-manager/dispatcher.js";
-export { CATALOG_SCHEMA_VERSION, cachePathFor, readCache, writeCache, isCacheValid, } from "./tool-manager/tool-catalog-cache.js";
-export type { ToolCatalog, CachedCatalog, } from "./tool-manager/tool-catalog-cache.js";
+export { LivenessWatchdog } from "./kernel/liveness-watchdog.js";
+export type { LivenessWatchdogOptions } from "./kernel/liveness-watchdog.js";
+export { emitLivenessLostSignal, resolveSentinelPath, WEDGED_RESTART_EXIT_CODE, DEFAULT_LIVENESS_SENTINEL, } from "./kernel/liveness-signal.js";
+export type { LivenessLostSignalPayload } from "./kernel/liveness-signal.js";
+export { parseHarnessManifest, loadHarnessManifest, serverCapabilitiesFromManifest, } from "./kernel/harness-manifest.js";
+export type { HarnessManifest, HarnessCapability } from "./kernel/harness-manifest.js";
+export type { ToolDescriptor, ToolDispatchCallOptions, ToolDispatchResult, IToolDispatchAgent, IToolManager, } from "./tool-manager/contracts.js";
+export { runToolDispatch } from "./tool-manager/dispatch/dispatch.js";
+export type { ToolDispatchContext, McpToolCallResult, } from "./tool-manager/dispatch/dispatch.js";
+export { createSharedDispatcher, pendingKey, injectQueueItemId, assertHostWiringComplete, } from "./tool-manager/orchestrator/dispatcher.js";
+export type { DispatcherClientInfo, DispatcherNotificationHooks, SharedDispatcherOptions, SharedDispatcher, } from "./tool-manager/orchestrator/dispatcher.js";
+export { CATALOG_SCHEMA_VERSION, cachePathFor, readCache, writeCache, isCacheValid, } from "./tool-manager/catalog/tool-catalog-cache.js";
+export type { ToolCatalog, CachedCatalog, } from "./tool-manager/catalog/tool-catalog-cache.js";
+export { ToolSurfaceReconciler } from "./tool-manager/catalog/tool-surface-reconciler.js";
+export type { ToolSurfaceReconcilerDeps, ReconcileOutcome, } from "./tool-manager/catalog/tool-surface-reconciler.js";
+export { makeFetchLiveToolSurfaceRevision } from "./tool-manager/catalog/health-revision.js";
+export type { FetchLiveToolSurfaceRevisionOptions } from "./tool-manager/catalog/health-revision.js";
+export { ClaimableDigestTracker } from "./tool-manager/work-protocol/claimable-digest-tracker.js";
+export type { ClaimableDigestInput, ClaimableDigestDecision, } from "./tool-manager/work-protocol/claimable-digest-tracker.js";
+export { WorkLeaseTracker } from "./tool-manager/work-protocol/work-lease-tracker.js";
+export type { StallPrompt } from "./tool-manager/work-protocol/work-lease-tracker.js";
 export { HubReturnedError, isErrorEnvelope } from "./hub-error.js";
 export type { ILogger, LegacyStringLogger, LogField, LogFields } from "./logger.js";
 export { getActionText, buildPromptText, buildToastMessage, } from "./prompt-format.js";
 export type { PromptFormatConfig } from "./prompt-format.js";
-export { appendNotification } from "./notification-log.js";
+export { appendNotification, buildPendingTaskNotification } from "./notification-log.js";
 export type { NotificationLogEntry, NotificationLogOptions, } from "./notification-log.js";
 export { CognitivePipeline, CognitiveTelemetry, CircuitBreaker, HubUnavailableError, WriteCallDedup, DedupTimeoutError, ToolResultCache, FlushAllOnWriteStrategy, ToolDescriptionEnricher, ErrorNormalizer, NormalizedError, ResponseSummarizer, summarizeResult, buildPaginationHint, } from "@apnex/cognitive-layer";
 export type { CognitiveMiddleware, ToolCallContext, ListToolsContext, ToolErrorContext, Tool as CognitiveTool, StandardPipelineConfig, CognitiveTelemetryConfig, TelemetryEvent, TelemetryEventKind, CircuitBreakerConfig, CircuitState, CircuitStateChange, WriteCallDedupConfig, ToolResultCacheConfig, InvalidationStrategy, InvalidationDirective, CacheKey, ToolDescriptionEnricherConfig, ToolHints, ErrorNormalizerConfig, ErrorRule, CascadeDriftRule, ResponseSummarizerConfig, } from "@apnex/cognitive-layer";

package/dist/index.js

@@ -2,26 +2,53 @@
 export { McpTransport } from "./wire/mcp-transport.js";
 // ── Layer 1b: Kernel (handshake / session FSM / agent client) ──────
 export { McpAgentClient } from "./kernel/mcp-agent-client.js";
-export { classifyEvent, parseHubEvent, createDedupFilter, } from "./kernel/event-router.js";
-export { loadOrCreateGlobalInstanceId } from "./kernel/instance.js";
-export { FATAL_CODES, parseHandshakeError, parseHandshakeResponse, buildHandshakePayload, performHandshake, makeStdioFatalHalt, } from "./kernel/handshake.js";
+export { classifyEvent, parseHubEvent, createDedupFilter, isPulseEvent, PULSE_KINDS, reconstructDrainedAction, } from "./kernel/event-router.js";
+// idea-251 D-prime Phase 2: instance.ts deleted. Identity now flows from
+// OIS_AGENT_NAME env → handshake.name → Hub-side fingerprint(name).
+// Operators set OIS_AGENT_NAME in ~/.config/apnex-agents/{name}.env.
+export { FATAL_CODES, parseHandshakeError, parseHandshakeResponse, buildHandshakePayload, performHandshake, makeStdioFatalHalt, readRequiredAgentName, } from "./kernel/handshake.js";
+export { parseLabels, loadConfig } from "./kernel/adapter-config.js";
+export { readPackageVersion, readBuildInfo, UNKNOWN_BUILD_INFO, } from "./kernel/build-identity.js";
+export { REDACT_KEYS, redactFields, LOG_LEVELS, parseLogLevel, shouldEmitLevel, } from "./observability.js";
+export { createFileLogger } from "./file-logger.js";
 export { performStateSync } from "./kernel/state-sync.js";
-export { PollBackstop, defaultCursorFile, readCursor, writeCursor, } from "./kernel/poll-backstop.js";
+export { PollBackstop, defaultCursorFile, resolveRole, readCursor, writeCursor, } from "./kernel/poll-backstop.js";
 export { isEagerWarmupEnabled, parseClaimSessionResponse, formatSessionClaimedLogLine, } from "./kernel/session-claim.js";
-// ── Layer 1c: tool-manager (Initialize/ListTools/CallTool factory) ──
-//
-// The MCP protocol tool-manager per Design v1.2 §4 naming discipline
-// (Director-ratified rename from "MCP-boundary dispatcher" 2026-04-26).
-// Distinct from the future Message-router (sovereign-package #6,
-// `@apnex/message-router`, M-Push-Foundation W4). Always qualify
-// ("tool-manager" or "Message-router") in new code; avoid bare
-// "dispatcher".
-export { createSharedDispatcher, pendingKey, injectQueueItemId, } from "./tool-manager/dispatcher.js";
-export { CATALOG_SCHEMA_VERSION, cachePathFor, readCache, writeCache, isCacheValid, } from "./tool-manager/tool-catalog-cache.js";
+// ── L1.5 liveness watchdog + the kernel->supervisor exit-propagation seam
+//    (M-Adapter-Modernization P1c, Design §4). The watchdog detects the
+//    keepalives-flowing-but-session-dead wedge via a proactive session probe;
+//    on a bounded failure budget it emits the wedged-restart sentinel (the
+//    signal P1e's PID-1 supervisor consumes) and the shim self-exits.
+export { LivenessWatchdog } from "./kernel/liveness-watchdog.js";
+export { emitLivenessLostSignal, resolveSentinelPath, WEDGED_RESTART_EXIT_CODE, DEFAULT_LIVENESS_SENTINEL, } from "./kernel/liveness-signal.js";
+// ── Harness manifest (M-Adapter-Modernization P1b) — the per-harness STANDARD
+//    config as a schema-validated, VERSIONED artifact. The claude shim is the
+//    first conformant instance; opencode/Phase-2 slot in as a second manifest
+//    against this SAME schema (not a parallel hand-rolled shape). Per-agent
+//    INSTANCE values stay in ENV — the manifest carries only env var NAMES.
+export { parseHarnessManifest, loadHarnessManifest, serverCapabilitiesFromManifest, } from "./kernel/harness-manifest.js";
+// Slice D (pi): the transport-neutral dispatch authority + its dependency
+// context, exported through the facade so a NATIVE host binding (pi's
+// tool-bridge) consumes the SAME per-call behavior wrapper the MCP CallTool
+// handler uses — without importing an MCP server. This is the concrete payoff of
+// the Slice-B extraction: one dispatch authority, many last-mile bindings.
+export { runToolDispatch } from "./tool-manager/dispatch/dispatch.js";
+// Slice C: dispatcher is the orchestrator (binding assembly); dispatch authority
+// + OIS policy live under dispatch/; cache/reconcile/health under catalog/.
+export { createSharedDispatcher, pendingKey, injectQueueItemId, assertHostWiringComplete, } from "./tool-manager/orchestrator/dispatcher.js";
+export { CATALOG_SCHEMA_VERSION, cachePathFor, readCache, writeCache, isCacheValid, } from "./tool-manager/catalog/tool-catalog-cache.js";
+export { ToolSurfaceReconciler } from "./tool-manager/catalog/tool-surface-reconciler.js";
+// idea-355 SLICE-1T — the Hub /health toolSurfaceRevision fetcher, hoisted from
+// the shims so both share ONE network mechanism (pure; the cache side-effect
+// stays shim-side).
+export { makeFetchLiveToolSurfaceRevision } from "./tool-manager/catalog/health-revision.js";
+// idea-353 — queue wake/stall reconciliation primitives.
+export { ClaimableDigestTracker } from "./tool-manager/work-protocol/claimable-digest-tracker.js";
+export { WorkLeaseTracker } from "./tool-manager/work-protocol/work-lease-tracker.js";
 // ── Cross-cutting primitives (root) ─────────────────────────────────
 export { HubReturnedError, isErrorEnvelope } from "./hub-error.js";
 export { getActionText, buildPromptText, buildToastMessage, } from "./prompt-format.js";
-export { appendNotification } from "./notification-log.js";
+export { appendNotification, buildPendingTaskNotification } from "./notification-log.js";
 // ── Cognitive layer re-exports (ADR-018) ────────────────────────────
 // The `cognitive` option on `McpAgentClient` accepts any
 // `@apnex/cognitive-layer` `CognitivePipeline`. Re-exporting the

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAYtE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,sEAAsE;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAoB9D,OAAO,EACL,aAAa,EACb,aAAa,EACb,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAGpE,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAY/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AAGnC,uEAAuE;AACvE,EAAE;AACF,qEAAqE;AACrE,wEAAwE;AACxE,iEAAiE;AACjE,iEAAiE;AACjE,+DAA+D;AAC/D,gBAAgB;AAEhB,OAAO,EACL,sBAAsB,EACtB,UAAU,EACV,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AAQtC,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,UAAU,EACV,YAAY,GACb,MAAM,sCAAsC,CAAC;AAM9C,uEAAuE;AAEvE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAInE,OAAO,EACL,aAAa,EACb,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAM3D,uEAAuE;AACvE,yDAAyD;AACzD,iEAAiE;AACjE,gEAAgE;AAChE,4DAA4D;AAE5D,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/kernel/adapter-config.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Adapter configuration — the generic `.ois/adapter-config.json` + env loader.
+ *
+ * idea-355 SLICE-1 single-home: both shims hand-rolled a near-identical
+ * HubConfig + parseLabels + loadConfig. They diverged only in host specifics —
+ * the default hubUrl, whether `autoPrompt` is carried, the warn sink, and the
+ * missing-creds policy (claude `process.exit(1)`; opencode can't kill the TUI).
+ * Those host specifics are INJECTED here; the load mechanism lives once in the
+ * kernel so it can't drift (the M18-scar class). Credential VALIDATION stays in
+ * the shim (the last-mile abort).
+ */
+export interface HubConfig {
+    hubUrl: string;
+    hubToken: string;
+    role: string;
+    /**
+     * Mission-19 routing labels. Stamped onto the Agent entity via the enriched
+     * register_role handshake; scoped dispatches filter by these. Read from
+     * adapter-config.json `labels` or the `OIS_HUB_LABELS` env var (JSON). Omit
+     * for broadcast.
+     */
+    labels?: Record<string, string>;
+    /** OpenCode-only: auto-prompt the host on actionable events. Claude omits it. */
+    autoPrompt?: boolean;
+}
+/**
+ * Parse a JSON-encoded label map (string→string only). Returns undefined for
+ * empty/absent/invalid input; warns via the injected sink on parse failure.
+ */
+export declare function parseLabels(raw: string | undefined, source: string, warn?: (m: string) => void): Record<string, string> | undefined;
+export interface LoadConfigOptions {
+    /** Parent dir of `.ois/` — WORK_DIR/cwd for claude, the host-supplied dir for opencode. */
+    directory: string;
+    /** Host defaults layered under file + env (e.g. opencode's relay hubUrl + autoPrompt:true). */
+    defaults?: Partial<HubConfig>;
+    /** Warn sink (claude console.error; opencode log()). */
+    warn?: (m: string) => void;
+    /** Read `autoPrompt` from file + `HUB_PLUGIN_AUTO_PROMPT` env (opencode only). */
+    readAutoPrompt?: boolean;
+}
+/**
+ * Load HubConfig from `<directory>/.ois/adapter-config.json` layered under env
+ * overrides (OIS_HUB_URL/OIS_HUB_TOKEN/OIS_HUB_ROLE/OIS_HUB_LABELS, plus
+ * HUB_PLUGIN_AUTO_PROMPT when readAutoPrompt). Precedence: defaults < file < env.
+ * Does NOT validate credentials — the caller (shim) does its host-specific abort.
+ */
+export declare function loadConfig(opts: LoadConfigOptions): HubConfig;

package/dist/kernel/adapter-config.js

@@ -0,0 +1,90 @@
+/**
+ * Adapter configuration — the generic `.ois/adapter-config.json` + env loader.
+ *
+ * idea-355 SLICE-1 single-home: both shims hand-rolled a near-identical
+ * HubConfig + parseLabels + loadConfig. They diverged only in host specifics —
+ * the default hubUrl, whether `autoPrompt` is carried, the warn sink, and the
+ * missing-creds policy (claude `process.exit(1)`; opencode can't kill the TUI).
+ * Those host specifics are INJECTED here; the load mechanism lives once in the
+ * kernel so it can't drift (the M18-scar class). Credential VALIDATION stays in
+ * the shim (the last-mile abort).
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Parse a JSON-encoded label map (string→string only). Returns undefined for
+ * empty/absent/invalid input; warns via the injected sink on parse failure.
+ */
+export function parseLabels(raw, source, warn = () => { }) {
+    if (!raw)
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            const out = {};
+            for (const [k, v] of Object.entries(parsed)) {
+                if (typeof v === "string")
+                    out[k] = v;
+            }
+            return Object.keys(out).length > 0 ? out : undefined;
+        }
+    }
+    catch (err) {
+        warn(`WARNING: Failed to parse labels from ${source}: ${err}`);
+    }
+    return undefined;
+}
+/**
+ * Load HubConfig from `<directory>/.ois/adapter-config.json` layered under env
+ * overrides (OIS_HUB_URL/OIS_HUB_TOKEN/OIS_HUB_ROLE/OIS_HUB_LABELS, plus
+ * HUB_PLUGIN_AUTO_PROMPT when readAutoPrompt). Precedence: defaults < file < env.
+ * Does NOT validate credentials — the caller (shim) does its host-specific abort.
+ */
+export function loadConfig(opts) {
+    const { directory, defaults = {}, warn = () => { }, readAutoPrompt = false } = opts;
+    const cfg = {
+        hubUrl: defaults.hubUrl ?? "",
+        hubToken: defaults.hubToken ?? "",
+        role: defaults.role ?? "engineer",
+    };
+    if (defaults.labels)
+        cfg.labels = defaults.labels;
+    if (defaults.autoPrompt !== undefined)
+        cfg.autoPrompt = defaults.autoPrompt;
+    try {
+        const raw = JSON.parse(readFileSync(join(directory, ".ois", "adapter-config.json"), "utf-8"));
+        if (typeof raw.hubUrl === "string")
+            cfg.hubUrl = raw.hubUrl;
+        if (typeof raw.hubToken === "string")
+            cfg.hubToken = raw.hubToken;
+        if (typeof raw.role === "string")
+            cfg.role = raw.role;
+        if (raw.labels && typeof raw.labels === "object") {
+            cfg.labels = raw.labels;
+        }
+        if (readAutoPrompt && typeof raw.autoPrompt === "boolean")
+            cfg.autoPrompt = raw.autoPrompt;
+    }
+    catch (err) {
+        // Silent on a missing file (the common case); warn on a real read/parse
+        // failure of a PRESENT file (preserves claude's prior behavior; opencode
+        // gains the diagnostic to its log).
+        if (err?.code !== "ENOENT") {
+            warn(`WARNING: Failed to read/parse ${join(directory, ".ois", "adapter-config.json")}: ${err}`);
+        }
+    }
+    if (process.env.OIS_HUB_URL)
+        cfg.hubUrl = process.env.OIS_HUB_URL;
+    if (process.env.OIS_HUB_TOKEN)
+        cfg.hubToken = process.env.OIS_HUB_TOKEN;
+    if (process.env.OIS_HUB_ROLE)
+        cfg.role = process.env.OIS_HUB_ROLE;
+    if (readAutoPrompt && process.env.HUB_PLUGIN_AUTO_PROMPT) {
+        cfg.autoPrompt = process.env.HUB_PLUGIN_AUTO_PROMPT.toLowerCase() !== "false";
+    }
+    const envLabels = parseLabels(process.env.OIS_HUB_LABELS, "OIS_HUB_LABELS env var", warn);
+    if (envLabels)
+        cfg.labels = envLabels;
+    return cfg;
+}
+//# sourceMappingURL=adapter-config.js.map

package/dist/kernel/adapter-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-config.js","sourceRoot":"","sources":["../../src/kernel/adapter-config.ts"],"names":[],"mappings":"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"}

package/dist/kernel/agent-client.d.ts

@@ -43,9 +43,10 @@
 import type { ILogger, LegacyStringLogger } from "../logger.js";
 import type { ITransport } from "../wire/transport.js";
 import type { HandshakeFatalError, HandshakeResponse } from "./handshake.js";
-import type { DrainedPendingAction } from "./state-sync.js";
+import type { AgentEvent, DrainedPendingAction, SessionReconnectReason, SessionState } from "@apnex/message-router";
+export type { AgentEvent, SessionState, SessionReconnectReason };
 /**
- * Session FSM state exposed to shims.
+ * Session FSM the AgentClient drives `SessionState` through:
  *
  *   disconnected → connecting → synchronizing → streaming
  *                                    ↑                ↓
@@ -58,22 +59,6 @@ import type { DrainedPendingAction } from "./state-sync.js";
  *   G4: Consecutive SSE failures trigger exponential backoff
  *   G5: All reconnections carry a classified SessionReconnectReason
  */
-export type SessionState = "disconnected" | "connecting" | "synchronizing" | "streaming" | "reconnecting";
-/** Classifies why a session re-entered `reconnecting`. */
-export type SessionReconnectReason = "heartbeat_failed" | "sse_watchdog" | "sse_never_opened" | "session_invalid";
-/**
- * Classified hub event delivered to the shim. Mirrors the existing
- * `HubEvent` shape from `event-router.ts` but re-declared here so the
- * AgentClient surface can be consumed without importing the router.
- * Phase 3+ will unify these back to one source of truth.
- */
-export interface AgentEvent {
-    readonly id?: number | string;
-    readonly event: string;
-    readonly data: Record<string, unknown>;
-    readonly timestamp?: string;
-    readonly targetRoles?: readonly string[];
-}
 /**
  * What a shim plugs into an AgentClient. All callbacks are optional —
  * a shim that doesn't care about, say, informational events can omit
@@ -90,11 +75,21 @@ export interface AgentClientCallbacks {
  * collapse to the bare register_role call.
  */
 export interface AgentHandshakeConfig {
-    globalInstanceId: string;
+    /**
+     * idea-251 D-prime Phase 2: name IS identity. REQUIRED. Sourced from
+     * `OIS_AGENT_NAME` env var by the host shim. Drives agentId derivation
+     * `agent-{8-hex-of-sha256(name)}` on Hub side. globalInstanceId field
+     * RETIRED (was pre-D-prime fingerprint input).
+     */
+    name: string;
     proxyName: string;
     proxyVersion: string;
     transport: string;
     sdkVersion: string;
+    proxyCommitSha?: string;
+    proxyDirty?: boolean;
+    sdkCommitSha?: string;
+    sdkDirty?: boolean;
     getClientInfo: () => {
         name: string;
         version: string;
@@ -148,6 +143,16 @@ export interface AgentClientMetrics {
     readonly totalSessionInvalidRetries: number;
     readonly dedupDropCount: number;
 }
+/**
+ * Per-call options for `IAgentClient.call`. bug-106: `internal: true` marks
+ * a machinery-originated call (poll-backstop catch-up, transport heartbeat)
+ * so the cognitive pipeline's LLM-facing result transforms (notably
+ * `ResponseSummarizer`) skip it — machinery needs the raw, full result.
+ */
+export interface AgentCallOptions {
+    /** Mark this call internal-machinery — skip LLM-facing result transforms. */
+    internal?: boolean;
+}
 export interface IAgentClient {
     /** Current session FSM state. */
     readonly state: SessionState;
@@ -169,7 +174,7 @@ export interface IAgentClient {
      * and retries exactly once on the fresh session before surfacing
      * the error.
      */
-    call(method: string, params: Record<string, unknown>): Promise<unknown>;
+    call(method: string, params: Record<string, unknown>, opts?: AgentCallOptions): Promise<unknown>;
     /**
      * List the method surface currently advertised by the peer. The
      * AgentClient delegates to `ITransport.listMethods()` and may cache

package/dist/kernel/build-identity.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Adapter build-identity reads — package version + build-info (commit SHA /
+ * dirty / build time / branch), hoisted from the shims in idea-355 SLICE-1.
+ *
+ * `readPackageVersion` was duplicated verbatim in both shims (the mission-66 #40
+ * version-source-of-truth fix). `readBuildInfo` + `BuildInfo` were claude-only
+ * (the idea-256 build-identity wire). Single-home the READ mechanism here so it
+ * can't drift; each shim still resolves its host-specific package.json /
+ * build-info paths and derives its own version constants. (The
+ * bundle-vs-node_modules path nuance + the report-both/auto-bump scheme are
+ * SLICE-3's concern.)
+ */
+/** Read the `version` field from a package.json; fallback on any failure. */
+export declare function readPackageVersion(pkgJsonPath: string, fallback: string): string;
+/** idea-256 build-identity: commit SHA / dirty / build time / branch. */
+export interface BuildInfo {
+    commitSha: string;
+    dirty: boolean;
+    buildTime: string | null;
+    branch: string;
+}
+export declare const UNKNOWN_BUILD_INFO: BuildInfo;
+/** Read a dist/build-info.json (written by scripts/build/write-build-info.js). */
+export declare function readBuildInfo(buildInfoPath: string): BuildInfo;

package/dist/kernel/build-identity.js

@@ -0,0 +1,45 @@
+/**
+ * Adapter build-identity reads — package version + build-info (commit SHA /
+ * dirty / build time / branch), hoisted from the shims in idea-355 SLICE-1.
+ *
+ * `readPackageVersion` was duplicated verbatim in both shims (the mission-66 #40
+ * version-source-of-truth fix). `readBuildInfo` + `BuildInfo` were claude-only
+ * (the idea-256 build-identity wire). Single-home the READ mechanism here so it
+ * can't drift; each shim still resolves its host-specific package.json /
+ * build-info paths and derives its own version constants. (The
+ * bundle-vs-node_modules path nuance + the report-both/auto-bump scheme are
+ * SLICE-3's concern.)
+ */
+import { readFileSync } from "node:fs";
+/** Read the `version` field from a package.json; fallback on any failure. */
+export function readPackageVersion(pkgJsonPath, fallback) {
+    try {
+        const raw = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
+        return typeof raw.version === "string" ? raw.version : fallback;
+    }
+    catch {
+        return fallback;
+    }
+}
+export const UNKNOWN_BUILD_INFO = {
+    commitSha: "unknown",
+    dirty: false,
+    buildTime: null,
+    branch: "unknown",
+};
+/** Read a dist/build-info.json (written by scripts/build/write-build-info.js). */
+export function readBuildInfo(buildInfoPath) {
+    try {
+        const raw = JSON.parse(readFileSync(buildInfoPath, "utf-8"));
+        return {
+            commitSha: typeof raw.commitSha === "string" ? raw.commitSha : "unknown",
+            dirty: !!raw.dirty,
+            buildTime: typeof raw.buildTime === "string" ? raw.buildTime : null,
+            branch: typeof raw.branch === "string" ? raw.branch : "unknown",
+        };
+    }
+    catch {
+        return UNKNOWN_BUILD_INFO;
+    }
+}
+//# sourceMappingURL=build-identity.js.map