@omnicross/core 0.1.7 → 0.1.8

package/dist/{ProviderProxy-C-xqrkKi.d.ts → ProviderProxy--ROec6VI.d.ts}

@@ -25,6 +25,15 @@ import { RouteContext, ProviderProxyDeps } from './provider-proxy/types.js';
  * run ends without an explicit `removeRoute`.
  */
 declare const DEFAULT_ROUTE_IDLE_MS: number;
+type RouteEvictionReason = 'idle' | 'removed' | 'cleared';
+/** Additive lease-aware registration options. Numeric callers remain supported. */
+interface RouteRegistrationOptions {
+    readonly idleMs?: number;
+    /** Receives only a timestamp; the bearer token is deliberately not exposed. */
+    readonly onActivity?: (at: number) => void;
+    /** Called at most once after the entry is no longer reachable. */
+    readonly onEvicted?: (reason: RouteEvictionReason) => void;
+}
 /**
  * The resident proxy owns ONE of these for the whole app session. Per-run
  * state is added at run start (`addRoute`) and removed at run end
@@ -40,7 +49,7 @@ declare class ProviderProxyRouteMap {
      * (`ANTHROPIC_AUTH_TOKEN` / `OPENAI_API_KEY`). Optionally override the idle
      * timeout (tests use a short one).
      */
-    addRoute(context: RouteContext, idleMs?: number): string;
+    addRoute(context: RouteContext, idleMsOrOptions?: number | RouteRegistrationOptions): string;
     /**
      * Look up a route by its token, touching the idle timer so an active run's
      * context survives. Returns `undefined` on a miss / reaped entry — the caller
@@ -49,6 +58,8 @@ declare class ProviderProxyRouteMap {
     lookup(token: string | undefined | null): RouteContext | undefined;
     /** Remove a route at run end. Returns true if an entry existed. */
     removeRoute(token: string): boolean;
+    /** Re-arm one existing route without rotating its token. */
+    renewRoute(token: string, idleMs?: number): boolean;
     /** Current live-route count (tests / diagnostics). */
     size(): number;
     /** Whether a token currently resolves (does NOT touch the idle timer). */
@@ -57,6 +68,7 @@ declare class ProviderProxyRouteMap {
     clear(): void;
     private armIdleTimer;
     private clearIdleTimer;
+    private evict;
 }
 
 /**
@@ -92,6 +104,7 @@ declare class ProviderProxy {
     private server;
     private port;
     private readonly routes;
+    private readonly beforeStop;
     constructor(deps: ProviderProxyDeps, routes?: ProviderProxyRouteMap);
     /**
      * Start the resident listener on a stable port on 127.0.0.1. Idempotent —
@@ -102,6 +115,10 @@ declare class ProviderProxy {
     stop(): Promise<void>;
     /** Base URL for injector wiring (`ANTHROPIC_BASE_URL` / codex `base_url`). */
     getBaseUrl(): string;
+    /** Register daemon-owned cleanup that must run before route-map teardown. */
+    registerBeforeStop(cleanup: () => void | Promise<void>): () => void;
+    /** Whether the resident listener has completed binding. */
+    isReady(): boolean;
     /**
      * The SHARED route map. Exposed so the outbound API server
      * (`outbound-api-server`) can mint per-request routes on the SAME map and
@@ -115,11 +132,13 @@ declare class ProviderProxy {
      */
     getDeps(): ProviderProxyDeps;
     /** Register a route for one run; returns the crypto route token (task 2.2). */
-    addRoute(context: RouteContext, idleMs?: number): string;
+    addRoute(context: RouteContext, idleMsOrOptions?: number | RouteRegistrationOptions): string;
+    /** Re-arm one route while retaining the exact same bearer token. */
+    renewRoute(token: string, idleMs?: number): boolean;
     /** Remove a route at run end. Returns true if an entry existed. */
     removeRoute(token: string): boolean;
     /** Live-route count (diagnostics / tests). */
     routeCount(): number;
 }
 
-export { DEFAULT_ROUTE_IDLE_MS as D, ProviderProxy as P, ProviderProxyRouteMap as a, isLoopbackAddress as i };
+export { DEFAULT_ROUTE_IDLE_MS as D, ProviderProxy as P, type RouteEvictionReason as R, ProviderProxyRouteMap as a, type RouteRegistrationOptions as b, isLoopbackAddress as i };

package/dist/{ProviderProxy-CnMQYN59.d.cts → ProviderProxy-QdwNV6l1.d.cts}

@@ -25,6 +25,15 @@ import { RouteContext, ProviderProxyDeps } from './provider-proxy/types.cjs';
  * run ends without an explicit `removeRoute`.
  */
 declare const DEFAULT_ROUTE_IDLE_MS: number;
+type RouteEvictionReason = 'idle' | 'removed' | 'cleared';
+/** Additive lease-aware registration options. Numeric callers remain supported. */
+interface RouteRegistrationOptions {
+    readonly idleMs?: number;
+    /** Receives only a timestamp; the bearer token is deliberately not exposed. */
+    readonly onActivity?: (at: number) => void;
+    /** Called at most once after the entry is no longer reachable. */
+    readonly onEvicted?: (reason: RouteEvictionReason) => void;
+}
 /**
  * The resident proxy owns ONE of these for the whole app session. Per-run
  * state is added at run start (`addRoute`) and removed at run end
@@ -40,7 +49,7 @@ declare class ProviderProxyRouteMap {
      * (`ANTHROPIC_AUTH_TOKEN` / `OPENAI_API_KEY`). Optionally override the idle
      * timeout (tests use a short one).
      */
-    addRoute(context: RouteContext, idleMs?: number): string;
+    addRoute(context: RouteContext, idleMsOrOptions?: number | RouteRegistrationOptions): string;
     /**
      * Look up a route by its token, touching the idle timer so an active run's
      * context survives. Returns `undefined` on a miss / reaped entry — the caller
@@ -49,6 +58,8 @@ declare class ProviderProxyRouteMap {
     lookup(token: string | undefined | null): RouteContext | undefined;
     /** Remove a route at run end. Returns true if an entry existed. */
     removeRoute(token: string): boolean;
+    /** Re-arm one existing route without rotating its token. */
+    renewRoute(token: string, idleMs?: number): boolean;
     /** Current live-route count (tests / diagnostics). */
     size(): number;
     /** Whether a token currently resolves (does NOT touch the idle timer). */
@@ -57,6 +68,7 @@ declare class ProviderProxyRouteMap {
     clear(): void;
     private armIdleTimer;
     private clearIdleTimer;
+    private evict;
 }
 
 /**
@@ -92,6 +104,7 @@ declare class ProviderProxy {
     private server;
     private port;
     private readonly routes;
+    private readonly beforeStop;
     constructor(deps: ProviderProxyDeps, routes?: ProviderProxyRouteMap);
     /**
      * Start the resident listener on a stable port on 127.0.0.1. Idempotent —
@@ -102,6 +115,10 @@ declare class ProviderProxy {
     stop(): Promise<void>;
     /** Base URL for injector wiring (`ANTHROPIC_BASE_URL` / codex `base_url`). */
     getBaseUrl(): string;
+    /** Register daemon-owned cleanup that must run before route-map teardown. */
+    registerBeforeStop(cleanup: () => void | Promise<void>): () => void;
+    /** Whether the resident listener has completed binding. */
+    isReady(): boolean;
     /**
      * The SHARED route map. Exposed so the outbound API server
      * (`outbound-api-server`) can mint per-request routes on the SAME map and
@@ -115,11 +132,13 @@ declare class ProviderProxy {
      */
     getDeps(): ProviderProxyDeps;
     /** Register a route for one run; returns the crypto route token (task 2.2). */
-    addRoute(context: RouteContext, idleMs?: number): string;
+    addRoute(context: RouteContext, idleMsOrOptions?: number | RouteRegistrationOptions): string;
+    /** Re-arm one route while retaining the exact same bearer token. */
+    renewRoute(token: string, idleMs?: number): boolean;
     /** Remove a route at run end. Returns true if an entry existed. */
     removeRoute(token: string): boolean;
     /** Live-route count (diagnostics / tests). */
     routeCount(): number;
 }
 
-export { DEFAULT_ROUTE_IDLE_MS as D, ProviderProxy as P, ProviderProxyRouteMap as a, isLoopbackAddress as i };
+export { DEFAULT_ROUTE_IDLE_MS as D, ProviderProxy as P, type RouteEvictionReason as R, ProviderProxyRouteMap as a, type RouteRegistrationOptions as b, isLoopbackAddress as i };