@danypops/jittor 0.18.1 → 0.19.2

package/package.json

@@ -1,10 +1,15 @@
 {
   "name": "@danypops/jittor",
-  "version": "0.18.1",
+  "version": "0.19.2",
   "description": "Just-in-Time Token Optimization Router for Pi -- token and context observability with optimization policies",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
   "keywords": ["llm-router", "token-budget"],
   "bin": {
     "jittor": "src/cli.ts"
@@ -27,9 +32,9 @@
     }
   },
   "dependencies": {
-    "@danypops/vehicle-core": "^0.12.1",
-    "@danypops/vehicle-server": "^0.17.0",
-    "@danypops/vehicle-client": "^0.5.1",
+    "@danypops/vehicle-core": "^0.17.1",
+    "@danypops/vehicle-server": "^0.25.1",
+    "@danypops/vehicle-client": "^0.10.1",
     "google-auth-library": "^10.9.0",
     "gpt-tokenizer": "^3.4.0"
   },

package/src/daemon.ts

@@ -1,5 +1,8 @@
 import { join } from "node:path";
 import { type RunningDaemon, startDaemon as startDaemonKit } from "@danypops/vehicle-server/daemon";
+import { openVehicleMetricsStore } from "@danypops/vehicle-server/metrics";
+import { createVehicleMetricsMiddleware } from "@danypops/vehicle-server/metrics-middleware";
+import { registerVehicleMetricsOperations } from "@danypops/vehicle-server/metrics-operations";
 import { ArtificialAnalysisDirectSource } from "./artificial-analysis/benchmark-source.ts";
 import { CodexTelemetrySource } from "./codex/source.ts";
 import { MAINTENANCE_INTERVAL_MS, TELEMETRY_POLL_INTERVAL_MS } from "./constants.ts";
@@ -117,6 +120,18 @@ export async function startDaemon(
 	});
 	const service = new JittorService(metrics, router, benchmarks, modelRanker, sessionIdentity, undefined, catalog, usageImporter, exporter);
 
+	// Records how often each real operation is invoked (server-side, every caller) plus, via
+	// vehicle_usage.recordClientEvent, client-observed Vehicle Shell meta-tool calls -- see
+	// @danypops/vehicle-server's own metrics README section. Wired directly onto the same registry
+	// every real jittor operation is already registered on, so it's discoverable through the exact
+	// same tools_list/tools_man path as any other operation. operationPrefix: "vehicle_usage", NOT
+	// the default "metrics" -- jittor's own domain already owns a real, extensive metrics.*
+	// namespace (metrics.query/metrics.record/metrics.usage_series/...), a completely different
+	// concept (LLM usage/cost observations) from this module's tool/operation usage metrics.
+	const vehicleMetrics = openVehicleMetricsStore(paths.metrics);
+	service.vehicleRegistry.useExecutionMiddleware(createVehicleMetricsMiddleware(vehicleMetrics, "jittor"));
+	registerVehicleMetricsOperations(service.vehicleRegistry, vehicleMetrics, "jittor", { operationPrefix: "vehicle_usage" });
+
 	const daemon = await startDaemonKit({
 		daemonLabel: "Jittor",
 		handlePath: paths.handle,
@@ -155,6 +170,7 @@ export async function startDaemon(
 		onShutdown: async () => {
 			await exporter.shutdown();
 			service.close();
+			vehicleMetrics.close();
 		},
 	});
 

package/src/index.ts

@@ -6,7 +6,141 @@ export {
 	parseAnthropicRateLimitHeaders,
 } from "./anthropic/rate-limits.ts";
 export { parseCodexRateLimitHeaders } from "./codex/telemetry.ts";
-export * from "./constants.ts";
+export {
+	BENCHMARK_DEFAULT_QUERY_LIMIT,
+	BENCHMARK_IDENTITY_MAX_CHARACTERS,
+	BENCHMARK_MAX_MODELS_PER_SOURCE,
+	BENCHMARK_MAX_OBSERVATIONS_PER_SNAPSHOT,
+	BENCHMARK_MAX_QUERY_LIMIT,
+	BENCHMARK_MAX_TEXT_CHARACTERS,
+	BENCHMARK_REFRESH_INTERVAL_MS,
+	BENCHMARK_SOURCE_MAX_RESPONSE_BYTES,
+	BENCHMARK_SOURCE_MAX_TOTAL_RESPONSE_BYTES,
+	BENCHMARK_STORE_QUERY_LIMIT,
+	BENCHMARK_TUI_MAX_CANDIDATES,
+	BENCHMARK_TUI_MAX_PROVENANCE_PER_CANDIDATE,
+	CACHE_ECONOMICS_LOSS_CORRELATION_WINDOW_MS,
+	CACHE_ECONOMICS_MAX_MISSED_OPPORTUNITIES,
+	CACHE_ECONOMICS_MAX_MODEL_GROUPS,
+	CACHE_ECONOMICS_MAX_STABLE_PREFIX_POINTS,
+	CACHE_ECONOMICS_MAX_TASK_GROUPS,
+	CACHE_ECONOMICS_QUERY_LIMIT,
+	CATALOG_LONG_CONTEXT_THRESHOLD_TOKENS,
+	CATALOG_PRICE_TOKEN_UNIT,
+	CLI_AVAILABLE_ROUTES_MAX,
+	CLI_METRICS_HUMAN_MAX_ROWS,
+	CODEX_ERROR_MESSAGE_LIMIT,
+	CODEX_RECOVERY_ATTEMPT_WINDOW_MS,
+	CODEX_RECOVERY_BASE_DELAY_MS,
+	CODEX_RECOVERY_JITTER_RATIO,
+	CODEX_RECOVERY_MAX_ATTEMPTS,
+	CODEX_RECOVERY_MAX_DELAY_MS,
+	CODEX_RETRY_AFTER_MAX_MS,
+	COMPACTION_DURATION_ESTIMATE_MAX_SAMPLES,
+	COMPACTION_DURATION_ESTIMATE_MIN_SAMPLES,
+	CONTEXT_ASSESSMENT_DEFAULT_WINDOW_MS,
+	CONTEXT_ASSESSMENT_QUERY_LIMIT,
+	CONTEXT_DEFAULT_RESERVE_TOKENS,
+	CONTEXT_ESTIMATE_CHARACTERS_PER_TOKEN,
+	CONTEXT_EVENT_DEDUP_LIMIT,
+	CONTEXT_HUB_CONFIDENCE_TIERS,
+	CONTEXT_HUB_CONTRIBUTION_CHANNEL,
+	CONTEXT_HUB_CONTRIBUTION_DEDUP_LIMIT,
+	CONTEXT_HUB_CONTRIBUTION_MAX_AGE_MS,
+	CONTEXT_HUB_CONTRIBUTION_SCHEMA,
+	CONTEXT_HUB_ITEM_LABEL_MAX_CHARACTERS,
+	CONTEXT_HUB_MAX_ITEM_DEPTH,
+	CONTEXT_HUB_MAX_ITEMS_PER_SEGMENT,
+	CONTEXT_HUB_PRODUCER_NAME_MAX_CHARACTERS,
+	CONTEXT_HUB_SEGMENT_KEY_MAX_CHARACTERS,
+	CONTEXT_HUB_SEGMENT_LABEL_MAX_CHARACTERS,
+	CONTEXT_OBSERVATION_MAX_AGE_MS,
+	CONTEXT_OBSERVATION_MAX_CHARACTERS,
+	CONTEXT_TREE_MAX_NODES,
+	DATABASE_FILENAME,
+	DEFAULT_QUERY_LIMIT,
+	FOOTER_BAR_MAX_WIDTH,
+	FOOTER_BAR_MIN_WIDTH,
+	FOOTER_COMPACTION_BLINK_HALF_PERIOD_MS,
+	FOOTER_COMPACTION_RENDER_INTERVAL_MS,
+	FOOTER_CONTEXT_ACCENT_FRACTION,
+	FOOTER_CONTEXT_ERROR_FRACTION,
+	FOOTER_CONTEXT_WARNING_FRACTION,
+	FOOTER_WIDE_TERMINAL_WIDTH,
+	GOOGLE_ADC_TOKEN_REFRESH_SKEW_MS,
+	GOOGLE_VERTEX_BUDGET_CONFIDENCE,
+	GOOGLE_VERTEX_BUDGET_DISPLAY_NAME_MAX_CHARACTERS,
+	GOOGLE_VERTEX_BUDGET_MAX_MESSAGES_PER_PULL,
+	HANDLE_FILENAME,
+	HUMAN_STATUS_MAX_SOURCES,
+	HUMAN_TEXT_FIELD_MAX_CHARACTERS,
+	JITTOR_EXTENSION_SETTINGS_FILENAME,
+	JITTOR_STATE_DIRECTORY,
+	MAINTENANCE_INTERVAL_MS,
+	MAX_DYNAMIC_ROUTES,
+	MAX_QUERY_LIMIT,
+	MAX_USAGE_BUCKETS,
+	METRIC_ATTRIBUTES_MAX_DEPTH,
+	METRIC_ATTRIBUTES_MAX_SERIALIZED_CHARACTERS,
+	METRIC_BATCH_MAX_OBSERVATIONS,
+	METRIC_IDENTITY_MAX_CHARACTERS,
+	MILLISECONDS_PER_DAY,
+	MILLISECONDS_PER_HOUR,
+	MILLISECONDS_PER_MINUTE,
+	MILLISECONDS_PER_SECOND,
+	MODEL_AGGREGATE_MAX_GROUPS,
+	MODEL_AGGREGATE_MAX_ROWS,
+	MODEL_CATALOG_DEFAULT_QUERY_LIMIT,
+	MODEL_CATALOG_FRESHNESS_MS,
+	MODEL_CATALOG_MAX_ENTRIES,
+	MODEL_CATALOG_MAX_QUERY_LIMIT,
+	MODEL_CATALOG_MAX_RESPONSE_BYTES,
+	MODEL_CATALOG_REQUEST_TIMEOUT_MS,
+	MODEL_CATALOG_STORE_QUERY_LIMIT,
+	MODEL_OBSERVATION_FRESH_MS,
+	MODEL_OBSERVATION_IDENTITY_MAX_CHARACTERS,
+	MODEL_RANKING_DEFAULT_CONTEXT_WEIGHT,
+	MODEL_RANKING_DEFAULT_COST_WEIGHT,
+	MODEL_RANKING_DEFAULT_LATENCY_WEIGHT,
+	MODEL_RANKING_DEFAULT_QUALITY_WEIGHT,
+	MODEL_RANKING_DEFAULT_RELIABILITY_WEIGHT,
+	MODEL_RANKING_MAX_SOURCES,
+	OTLP_EXPORT_BATCH_SIZE,
+	OTLP_EXPORT_INTERVAL_MS,
+	OTLP_EXPORT_MAX_QUEUE_SIZE,
+	OTLP_EXPORT_MAX_RETRIES,
+	OTLP_EXPORT_TIMEOUT_MS,
+	PAPYRUS_CONTEXT_INJECTION_CHANNEL,
+	PAPYRUS_CONTEXT_INJECTION_SCHEMA,
+	PAPYRUS_TASK_FOCUS_CHANNEL,
+	PAPYRUS_TASK_FOCUS_SCHEMA,
+	PI_USAGE_IMPORT_MAX_DURATION_MS,
+	PI_USAGE_IMPORT_MAX_ENTRIES,
+	PI_USAGE_IMPORT_MAX_FILE_BYTES,
+	PI_USAGE_IMPORT_MAX_FILES,
+	PI_USAGE_IMPORT_MAX_RECORDS,
+	PI_USAGE_IMPORT_MAX_TOTAL_BYTES,
+	PRUNE_MIN_AGE_MS,
+	ROUTER_MAX_SESSION_SCOPES,
+	ROUTER_SESSION_ID_MAX_CHARACTERS,
+	SERVICE_MAX_BODY_BYTES,
+	SERVICE_MAX_RESPONSE_BYTES,
+	SESSION_IDENTITY_MAX_ROWS,
+	SQLITE_BUSY_TIMEOUT_MS,
+	SYSTEMD_UNIT_NAME,
+	TASK_COST_QUERY_LIMIT,
+	TASK_FOCUS_EVENT_MAX_AGE_MS,
+	TASK_FOCUS_ID_MAX_LENGTH,
+	TELEMETRY_POLL_INTERVAL_MS,
+	TELEMETRY_STALE_AFTER_MS,
+	TOKEN_FILENAME,
+	USAGE_AGGREGATE_MAX_ROWS,
+	USAGE_CHART_HEIGHT,
+	USAGE_MAX_DISTINCT_SCOPES,
+	USAGE_PER_SCOPE_QUERY_LIMIT,
+	USAGE_RENDER_MAX_SERIES,
+	USAGE_Y_AXIS_WIDTH,
+} from "./constants.ts";
 export {
 	classifyGoogleVertexFailure,
 	type GoogleVertexFailure,

package/src/vehicle/operation-types.ts

@@ -1,3 +1,51 @@
 /** One capability module's contribution to the operation dispatch table: a bounded set of operation names, each backed by a handler that only needs the collaborators its own factory was given. */
 export type OperationHandler = (input: Record<string, unknown>) => unknown | Promise<unknown>;
 export type OperationHandlerMap = Partial<Record<string, OperationHandler>>;
+
+/**
+ * The full, exhaustive operation surface -- shared by service.ts (dispatch/typed execute) and
+ * registration.ts (Vehicle projection) so neither module needs to import the other for this type.
+ * Living here (not in either module) is what breaks the service.ts<->registration.ts circular
+ * dependency: previously registration.ts `import type`-ed OperationName back from service.ts,
+ * while service.ts value-imported registerJittorVehicleOperations from registration.ts.
+ */
+export const EXPECTED_OPERATION_NAMES = [
+	"metrics.record",
+	"metrics.record_batch",
+	"metrics.query",
+	"metrics.distinct_scopes",
+	"metrics.usage_series",
+	"metrics.cost_by_task",
+	"metrics.prune",
+	"benchmark.refresh",
+	"benchmark.status",
+	"benchmark.query",
+	"catalog.refresh",
+	"catalog.status",
+	"catalog.query",
+	"usage.import",
+	"usage.import_status",
+	"usage.import_cancel",
+	"export.status",
+	"export.flush",
+	"session.register",
+	"session.release",
+	"models.rank",
+	"context.assess",
+	"context.delta",
+	"context.snapshot",
+	"compaction.estimate",
+	"service.checkpoint",
+	"telemetry.poll",
+	"router.status",
+	"router.decide",
+	"router.pause",
+	"router.resume",
+	"router.override",
+	"router.clear_override",
+	"router.current_route",
+	"router.available_routes",
+	"cache.economics",
+] as const;
+
+export type OperationName = (typeof EXPECTED_OPERATION_NAMES)[number];

package/src/vehicle/registration.ts

@@ -26,8 +26,7 @@ import type { VehicleEffect, VehicleIdempotency } from "@danypops/vehicle-core";
 import { bindVehicleOperation, defineErrorMapping, defineVehicleOperation, passthroughVehicleSchema } from "@danypops/vehicle-core";
 import type { VehicleRegistry } from "@danypops/vehicle-server";
 import { InvalidSessionSecretError } from "../sessions/identity.ts";
-import type { OperationHandlerMap } from "./operation-types.ts";
-import type { OperationName } from "./service.ts";
+import type { OperationHandlerMap, OperationName } from "./operation-types.ts";
 
 /** Preserves the legacy route's 403 for invalid session credentials; every other rejection remains validation. */
 const withJittorErrorParity = defineErrorMapping([

package/src/vehicle/service.ts

@@ -34,52 +34,14 @@ import { contextOperations } from "./context-operations.ts";
 import { exportOperations } from "./export-operations.ts";
 import { metricsOperations } from "./metric-operations.ts";
 import { modelRankingOperations } from "./model-ranking-operations.ts";
-import type { OperationHandlerMap } from "./operation-types.ts";
+import { EXPECTED_OPERATION_NAMES, type OperationHandlerMap, type OperationName } from "./operation-types.ts";
 import { registerJittorVehicleOperations } from "./registration.ts";
 import { routerOperations } from "./routing-operations.ts";
 import { sessionIdentityOperations } from "./session-operations.ts";
 import { usageImportOperations } from "./usage-import-operations.ts";
 
-export const EXPECTED_OPERATION_NAMES = [
-	"metrics.record",
-	"metrics.record_batch",
-	"metrics.query",
-	"metrics.distinct_scopes",
-	"metrics.usage_series",
-	"metrics.cost_by_task",
-	"metrics.prune",
-	"benchmark.refresh",
-	"benchmark.status",
-	"benchmark.query",
-	"catalog.refresh",
-	"catalog.status",
-	"catalog.query",
-	"usage.import",
-	"usage.import_status",
-	"usage.import_cancel",
-	"export.status",
-	"export.flush",
-	"session.register",
-	"session.release",
-	"models.rank",
-	"context.assess",
-	"context.delta",
-	"context.snapshot",
-	"compaction.estimate",
-	"service.checkpoint",
-	"telemetry.poll",
-	"router.status",
-	"router.decide",
-	"router.pause",
-	"router.resume",
-	"router.override",
-	"router.clear_override",
-	"router.current_route",
-	"router.available_routes",
-	"cache.economics",
-] as const;
+export { EXPECTED_OPERATION_NAMES, type OperationName };
 
-export type OperationName = (typeof EXPECTED_OPERATION_NAMES)[number];
 interface RouterScopeInput {
 	session_id?: string;
 	session_secret?: string;