@awarevue/agent-sdk 2.0.82 → 2.0.84

package/dist/agent-app.d.ts

@@ -7,6 +7,7 @@ export type AgentOptions = {
     accessControlProviders?: Record<string, AccessControlCapabilityReport>;
     agentId: string;
     replyTimeout?: number;
+    testerCliTags?: string[];
     transport: DuplexTransport<Message<FromServer>, Message<FromAgent>>;
 };
 export declare class AgentApp {

package/dist/agent-app.js

@@ -50,7 +50,6 @@ class AgentApp {
                 person: {},
                 accessRule: {},
                 schedule: {},
-                device: {},
                 zone: {},
             };
             return this.options.transport.messages$.pipe((0, rxjs_1.startWith)(null), // emit immediately to ensure subscription is active
@@ -136,6 +135,28 @@ class AgentApp {
                             requestId: message.id,
                             refs: result,
                         })));
+                    case 'describe-object': {
+                        if (!this.agent.find$) {
+                            return (0, rxjs_1.throwError)(() => new agent_error_1.AgentError(`Agent ${context.provider} does not support object description`, 'NOT_SUPPORTED')).pipe(this.handleResponse$(message.id));
+                        }
+                        const find$ = this.agent.find$;
+                        return find$(context, message.objectKind, [
+                            message.objectAssignedRef,
+                        ]).pipe((0, rxjs_1.map)((result) => {
+                            const data = result[message.objectAssignedRef];
+                            return data !== undefined
+                                ? {
+                                    objectKind: message.objectKind,
+                                    objectAssignedRef: message.objectAssignedRef,
+                                    data,
+                                }
+                                : null;
+                        }), this.handleResponse$(message.id, (object) => ({
+                            kind: 'describe-object-rs',
+                            requestId: message.id,
+                            object: object,
+                        })));
+                    }
                     default:
                         return rxjs_1.EMPTY;
                 }
@@ -148,6 +169,7 @@ class AgentApp {
                     kind: 'register',
                     providers: this.options.providers,
                     accessControlProviders: this.options.accessControlProviders,
+                    testerCliTags: this.options.testerCliTags,
                 })
                     .pipe((0, rxjs_1.retry)({ delay: 3000 }))
                 : rxjs_1.EMPTY));

package/dist/agent.d.ts

@@ -1,4 +1,4 @@
-import { ValidateProviderConfigRs, DeviceDiscoveryDto, RunCommandRq, AccessValidateChangeRq, AccessChangeIssue, AccessApplyChange, AccessRefMap, AccessObjectKind, QueryRq, PushFile } from '@awarevue/api-types';
+import { ValidateProviderConfigRs, DeviceDiscoveryDto, RunCommandRq, AccessValidateChangeRq, AccessChangeIssue, AccessApplyChange, AccessRefMap, AccessObjectKind, ObjectKinds, QueryRq, PushFile, ExternalObjectProps } from '@awarevue/api-types';
 import { Observable } from 'rxjs';
 import { DeviceActivity } from './agent-app';
 export type Context = {
@@ -15,8 +15,8 @@ export type RunCommandContext = Context & {
 };
 export type AccessChangeContext = Context & {
     deviceCatalog: DeviceDiscoveryDto;
-    objectsById: <T extends Record<string, unknown>>(objectKind: AccessObjectKind, objectId: string) => T[];
-    objectByForeignRef: <T extends Record<string, unknown>>(objectKind: AccessObjectKind, foreignRef: string) => T | null;
+    objectsById: <K extends AccessObjectKind>(objectKind: K, objectId: string) => ObjectKinds[K][];
+    objectByForeignRef: <K extends AccessObjectKind>(objectKind: K, foreignRef: string) => ObjectKinds[K] | null;
 };
 export interface Agent {
     getConfigIssues$: (context: Context) => Observable<ValidateProviderConfigRs['issues']>;
@@ -26,6 +26,6 @@ export interface Agent {
     getResult$?: (context: Context, query: QueryRq) => Observable<unknown>;
     validateAccessChange$?: (context: AccessChangeContext, change: AccessValidateChangeRq) => Observable<AccessChangeIssue[]>;
     applyAccessChange$?: (context: AccessChangeContext, change: AccessApplyChange) => Observable<AccessRefMap>;
-    find$?: (context: Context, objectKind: AccessObjectKind, objectIds: string[]) => Observable<Record<string, Record<string, unknown>>>;
+    find$?: <K extends AccessObjectKind>(context: Context, objectKind: K, objectIds: string[]) => Observable<Record<string, ExternalObjectProps[K]>>;
     pushFile?: (context: Context, req: PushFile) => Observable<boolean>;
 }

package/dist/default-validator.d.ts

@@ -1,10 +1,10 @@
 import { AccessValidateChangeRq } from '@awarevue/api-types';
 import { Agent, Context } from './agent';
 export declare const createValidator: <T extends Agent>(agent: T) => (context: Context, change: AccessValidateChangeRq) => import("rxjs").Observable<readonly [{
+    objectId?: string | undefined;
+    objectKind?: "accessRule" | "schedule" | "person" | "zone" | undefined;
     code?: "BAD_REFERENCE" | "NOT_SUPPORTED" | "NOT_FOUND" | "NOT_UNIQUE" | "INVALID" | undefined;
     path?: string | undefined;
-    message?: string | undefined;
-    objectKind?: "person" | "zone" | "schedule" | "device" | "accessRule" | undefined;
-    objectId?: string | undefined;
     index?: number | undefined;
-}[], Record<"accessRule" | "schedule" | "person" | "zone" | "device", Record<string, Record<string, unknown>>>]>;
+    message?: string | undefined;
+}[], Record<"accessRule" | "schedule" | "person" | "zone", Record<string, Record<string, unknown>>>]>;

package/dist/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "git+https://github.com/Linc-Security-Systems/aware-essentials.git"
   },
-  "version": "2.0.82",
+  "version": "2.0.84",
   "description": "SDK for building Agent implementations that speak the agent protocol.",
   "author": "Yaser Awajan",
   "license": "MIT",
@@ -31,12 +31,13 @@
     "lint:fix": "yarn lint --fix"
   },
   "peerDependencies": {
-    "@awarevue/api-types": "2.0.82",
+    "@awarevue/api-types": "2.0.84",
     "rxjs": "^7.8.2",
-    "ws": "^8"
+    "ws": "^8",
+    "zod": "4.4.3"
   },
   "devDependencies": {
-    "@awarevue/api-types": "2.0.82",
+    "@awarevue/api-types": "2.0.84",
     "@types/node": "^20.12.7",
     "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^8.31.1",
@@ -48,7 +49,7 @@
     "typescript": "^5.8.3",
     "vitest": "^4.1.4",
     "ws": "^8",
-    "zod": "3.25.76"
+    "zod": "4.4.3"
   },
   "publishConfig": {
     "access": "public",

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "git+https://github.com/Linc-Security-Systems/aware-essentials.git"
   },
-  "version": "2.0.82",
+  "version": "2.0.84",
   "description": "SDK for building Agent implementations that speak the agent protocol.",
   "author": "Yaser Awajan",
   "license": "MIT",
@@ -31,12 +31,13 @@
     "lint:fix": "yarn lint --fix"
   },
   "peerDependencies": {
-    "@awarevue/api-types": "2.0.82",
+    "@awarevue/api-types": "2.0.84",
     "rxjs": "^7.8.2",
-    "ws": "^8"
+    "ws": "^8",
+    "zod": "4.4.3"
   },
   "devDependencies": {
-    "@awarevue/api-types": "2.0.82",
+    "@awarevue/api-types": "2.0.84",
     "@types/node": "^20.12.7",
     "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^8.31.1",
@@ -48,7 +49,7 @@
     "typescript": "^5.8.3",
     "vitest": "^4.1.4",
     "ws": "^8",
-    "zod": "3.25.76"
+    "zod": "4.4.3"
   },
   "publishConfig": {
     "access": "public",