@hualinge/relay-api-server-contracts 0.1.6 → 1.0.0

package/dist/index.d.ts

@@ -14,4 +14,5 @@ export type { CatalogMemberEntry, CatalogProvider, CatalogSnapshot } from './cat
 export type { ConsistencyReport, Edge, EvidenceIndex, EvidenceItem, EvidenceKind, EvidenceProvider, EvidenceProviderInput, EvidenceServices, EvidenceStats, EvidenceStatus, EvidenceStore, RebuildResult, SearchOptions, } from './evidence.js';
 export type { DynamicTaskDef, DynamicTaskPort, EmissionPort, EmissionRecord, EmissionRow, GlobalControl, GlobalControlPort, PackTemplateDef, PackTemplatePort, RunLedgerPort, RunLedgerQuery, RunLedgerRecord, RunLedgerRow, RunOutcome, RunStats, SchedulerPersistence, SchedulerProvider, SchedulerProviderInput, TaskOverride, TriggerSpec, } from './scheduler.js';
 export type { TelemetryProvider } from './telemetry-provider.js';
+export type { MetricLabelProvider } from './metric-label-provider.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACjG,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACzF,YAAY,EACV,iBAAiB,EACjB,IAAI,EACJ,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACjG,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACzF,YAAY,EACV,iBAAiB,EACjB,IAAI,EACJ,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/metric-label-provider.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Metric Label Provider Plugin API — contract for dynamic metric labels.
+ *
+ * Provider resolves HTTP request into metric labels (key-value pairs).
+ * The platform merges these labels into metric attributes during recording.
+ */
+import type { FastifyRequest } from 'fastify';
+/**
+ * Metric Label Provider contract.
+ *
+ * Extension point for dynamic HTTP request metric labels.
+ */
+export interface MetricLabelProvider {
+    /** Unique provider identifier (runtime string, never hardcoded in platform). */
+    readonly id: string;
+    /** Human-readable name shown in logs and admin UI. */
+    readonly displayName?: string;
+    /**
+     * Called once at startup. Use for provider-level initialization
+     * (e.g., validate config, warm up connections).
+     */
+    bootstrap?(): Promise<void>;
+    /**
+     * Resolve metric labels from HTTP request.
+     * Return null to skip adding labels.
+     * Return object to merge into metric attributes.
+     */
+    resolveLabels(request: FastifyRequest): Promise<Record<string, string | number | boolean> | null>;
+    /**
+     * Called on shutdown. Use for cleanup.
+     */
+    shutdown?(): Promise<void>;
+}
+//# sourceMappingURL=metric-label-provider.d.ts.map

package/dist/metric-label-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-label-provider.d.ts","sourceRoot":"","sources":["../src/metric-label-provider.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;OAGG;IACH,SAAS,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;OAIG;IACH,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAElG;;OAEG;IACH,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B"}

package/dist/metric-label-provider.js

@@ -0,0 +1,7 @@
+/*
+ * * *
+ *  * Copyright (C) Huawei Technologies Co., Ltd. 2026. All rights reserved.
+ *
+ */
+export {};
+//# sourceMappingURL=metric-label-provider.js.map

package/dist/metric-label-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-label-provider.js","sourceRoot":"","sources":["../src/metric-label-provider.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/storage/session-chain-types.d.ts

@@ -6,7 +6,7 @@ export interface CreateSessionInput {
     agentId: AgentId;
     userId: string;
 }
-export type SessionRecordPatch = Partial<Pick<SessionRecord, 'cliSessionId' | 'status' | 'contextHealth' | 'lastUsage' | 'messageCount' | 'sealReason' | 'sealedAt' | 'updatedAt' | 'compressionCount' | 'consecutiveRestoreFailures'>>;
+export type SessionRecordPatch = Partial<Pick<SessionRecord, 'cliSessionId' | 'status' | 'contextHealth' | 'lastUsage' | 'lastUsageAt' | 'totalUsage' | 'usageByDay' | 'messageCount' | 'sealReason' | 'sealedAt' | 'updatedAt' | 'compressionCount' | 'consecutiveRestoreFailures'>>;
 export interface ISessionChainStore {
     create(input: CreateSessionInput): SessionRecord | Promise<SessionRecord>;
     get(id: string): SessionRecord | null | Promise<SessionRecord | null>;

package/dist/storage/session-chain-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-chain-types.d.ts","sourceRoot":"","sources":["../../src/storage/session-chain-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAErE,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,CACtC,IAAI,CACF,aAAa,EACX,cAAc,GACd,QAAQ,GACR,eAAe,GACf,WAAW,GACX,cAAc,GACd,YAAY,GACZ,UAAU,GACV,WAAW,GACX,kBAAkB,GAClB,4BAA4B,CAC/B,CACF,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACtE,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACpG,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACzF,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC/E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACpG,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC9F,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9E,mBAAmB,IAAI,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACrD"}
+{"version":3,"file":"session-chain-types.d.ts","sourceRoot":"","sources":["../../src/storage/session-chain-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAErE,YAAY,EAAE,aAAa,EAAE,CAAC;AAE9B,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,kBAAkB,GAAG,OAAO,CACtC,IAAI,CACF,aAAa,EACX,cAAc,GACd,QAAQ,GACR,eAAe,GACf,WAAW,GACX,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,cAAc,GACd,YAAY,GACZ,UAAU,GACV,WAAW,GACX,kBAAkB,GAClB,4BAA4B,CAC/B,CACF,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACtE,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACpG,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IACzF,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAC/E,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACpG,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC9F,yBAAyB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9E,mBAAmB,IAAI,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACrD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hualinge/relay-api-server-contracts",
-  "version": "0.1.6",
+  "version": "1.0.0",
   "type": "module",
   "description": "Plugin contracts for OfficeClaw extensions: auth, storage, identity.",
   "license": "MIT",
@@ -57,15 +57,15 @@
     "LICENSE"
   ],
   "peerDependencies": {
+    "@hualinge/relay-shared": ">=1.0.0",
     "@opentelemetry/sdk-trace-base": ">=1.0.0",
     "@opentelemetry/sdk-metrics": ">=1.0.0",
     "@opentelemetry/resources": ">=1.0.0",
-    "@opentelemetry/instrumentation": ">=0.50.0",
-    "@hualinge/relay-shared": ">=0.1.3"
+    "@opentelemetry/instrumentation": ">=0.50.0"
   },
   "devDependencies": {
     "typescript": "^5.3.3",
-    "@hualinge/relay-shared": "0.1.6"
+    "@hualinge/relay-shared": "1.0.0"
   },
   "scripts": {
     "build": "pnpm clean && tsc",