@vertesia/common 1.5.0-dev.20260717.131047Z → 1.5.0-dev.20260725.083715Z

package/lib/views.js

@@ -0,0 +1,41 @@
+export const VIEW_EXPERIENCE_SCHEMA_VERSION = 1;
+/** Build the generic reusable client route for a persisted or app-contributed View. */
+export function viewExperienceRoute(id) {
+    return `/view/${encodeURIComponent(id)}`;
+}
+export const VIEW_SEARCH_FIELD_TYPES = ['text', 'keyword', 'number', 'date', 'boolean'];
+export const VIEW_RESULT_FIELD_FORMATS = [
+    'text',
+    'date',
+    'number',
+    'badge',
+    'user',
+    'content_type',
+    'location',
+];
+/**
+ * Project a persisted or extended View value back to its reusable configuration
+ * fields. Callers that require a persisted configuration must validate the
+ * result at their API or persistence boundary because legacy records may not
+ * satisfy newer persisted-only requirements.
+ */
+export function getViewExperienceConfiguration(value) {
+    return {
+        name: value.name,
+        ...(value.description === undefined ? {} : { description: value.description }),
+        ...(value.enabled === undefined ? {} : { enabled: value.enabled }),
+        ...(value.layout === undefined ? {} : { layout: value.layout }),
+        ...(value.scope === undefined ? {} : { scope: value.scope }),
+        ...(value.navigation === undefined ? {} : { navigation: value.navigation }),
+        ...(value.search === undefined ? {} : { search: value.search }),
+        ...(value.results === undefined ? {} : { results: value.results }),
+    };
+}
+/** Project a type-valid persisted View while preserving its required documentation field. */
+export function getPersistedViewExperienceConfiguration(value) {
+    return {
+        ...getViewExperienceConfiguration(value),
+        description: value.description,
+    };
+}
+//# sourceMappingURL=views.js.map

package/lib/views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.js","sourceRoot":"","sources":["../src/views.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAU,CAAC;AAIzD,uFAAuF;AACvF,MAAM,UAAU,mBAAmB,CAAC,EAAU;IAC1C,OAAO,SAAS,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7C,CAAC;AAkGD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAU,CAAC;AAqDjG,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACrC,MAAM;IACN,MAAM;IACN,QAAQ;IACR,OAAO;IACP,MAAM;IACN,cAAc;IACd,UAAU;CACJ,CAAC;AAwHX;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAAC,KAAkC;IAC7E,OAAO;QACH,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;QAC9E,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAClE,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/D,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QAC5D,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;QAC3E,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;QAC/D,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;KACrE,CAAC;AACN,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,uCAAuC,CACnD,KAA2C;IAE3C,OAAO;QACH,GAAG,8BAA8B,CAAC,KAAK,CAAC;QACxC,WAAW,EAAE,KAAK,CAAC,WAAW;KACjC,CAAC;AACN,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertesia/common",
-  "version": "1.5.0-dev.20260717.131047Z",
+  "version": "1.5.0-dev.20260725.083715Z",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./lib/index.js",
@@ -17,14 +17,14 @@
     }
   },
   "devDependencies": {
-    "rolldown": "1.1.4",
+    "rolldown": "1.2.0",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.9",
+    "vitest": "^4.1.10",
     "@vertesia/tsconfig": "0.1.0"
   },
   "dependencies": {
     "ajv": "^8.20.0",
-    "@llumiverse/common": "1.5.0-dev.20260713.114357Z"
+    "@llumiverse/common": "1.5.0-dev.20260725.065646Z"
   },
   "repository": {
     "type": "git",
@@ -39,7 +39,7 @@
     "ai",
     "typescript"
   ],
-  "gitHead": "8aaad228827b2927db8e6aa75b27bfac90fec36f",
+  "gitHead": "57bcc2f27dd17b3387f27c18e89329c4c37f98ac",
   "scripts": {
     "lint": "biome lint src",
     "test": "vitest run",

package/src/agent-resources.test.ts

@@ -0,0 +1,100 @@
+import { describe, expect, it } from 'vitest';
+import { type AgentResourceReference, getResourcesFromToolResult, normalizeAgentResources } from './interaction.js';
+import { AgentMessageType, getResourcesFromMessage } from './store/workflow.js';
+
+const validRef: AgentResourceReference = {
+    type: 'document',
+    id: 'doc-1',
+    label: 'My Document',
+    action: 'created',
+};
+
+describe('normalizeAgentResources', () => {
+    it('returns an empty array for non-array input', () => {
+        expect(normalizeAgentResources(undefined)).toEqual([]);
+        expect(normalizeAgentResources(null)).toEqual([]);
+        expect(normalizeAgentResources('nope')).toEqual([]);
+        expect(normalizeAgentResources({})).toEqual([]);
+    });
+
+    it('keeps a well-formed reference', () => {
+        expect(normalizeAgentResources([validRef])).toEqual([validRef]);
+    });
+
+    it('preserves revision_id when present and non-empty', () => {
+        const ref = { ...validRef, revision_id: 'rev-9' };
+        expect(normalizeAgentResources([ref])).toEqual([ref]);
+    });
+
+    it('drops an empty revision_id rather than keeping it', () => {
+        const result = normalizeAgentResources([{ ...validRef, revision_id: '' }]);
+        expect(result[0]).not.toHaveProperty('revision_id');
+    });
+
+    it('falls back to the id when the label is missing or empty', () => {
+        const result = normalizeAgentResources([{ type: 'collection', id: 'col-1', action: 'updated' }]);
+        expect(result).toEqual([{ type: 'collection', id: 'col-1', label: 'col-1', action: 'updated' }]);
+    });
+
+    it('drops entries with an unknown type or action', () => {
+        const result = normalizeAgentResources([
+            { type: 'artifact', id: 'a', label: 'a', action: 'created' },
+            { type: 'document', id: 'd', label: 'd', action: 'viewed' },
+            { type: 'document', id: '', label: 'd', action: 'created' },
+            validRef,
+        ]);
+        expect(result).toEqual([validRef]);
+    });
+
+    it('accepts every supported resource type', () => {
+        const types = [
+            'document',
+            'collection',
+            'content_type',
+            'interaction',
+            'prompt',
+            'agent',
+            'workflow',
+            'process',
+            'process_run',
+            'interaction_run',
+            'view',
+        ] as const;
+        const input = types.map((type, i) => ({ type, id: `id-${i}`, label: `L${i}`, action: 'created' }));
+        expect(normalizeAgentResources(input)).toHaveLength(types.length);
+    });
+});
+
+describe('getResourcesFromToolResult', () => {
+    it('reads resources from result meta', () => {
+        expect(getResourcesFromToolResult({ meta: { resources: [validRef] } })).toEqual([validRef]);
+    });
+
+    it('returns an empty array when meta or resources are absent', () => {
+        expect(getResourcesFromToolResult({})).toEqual([]);
+        expect(getResourcesFromToolResult({ meta: {} })).toEqual([]);
+    });
+});
+
+describe('getResourcesFromMessage', () => {
+    it('reads resources from message details', () => {
+        const msg = {
+            timestamp: 0,
+            workflow_run_id: 'run-1',
+            type: AgentMessageType.THOUGHT,
+            message: '',
+            details: { event_class: 'activity', resources: [validRef] },
+        };
+        expect(getResourcesFromMessage(msg)).toEqual([validRef]);
+    });
+
+    it('returns an empty array when details or resources are absent', () => {
+        const msg = {
+            timestamp: 0,
+            workflow_run_id: 'run-1',
+            type: AgentMessageType.COMPLETE,
+            message: '',
+        };
+        expect(getResourcesFromMessage(msg)).toEqual([]);
+    });
+});

package/src/apps.test.ts

@@ -1,5 +1,13 @@
 import { describe, expect, it } from 'vitest';
-import { effectiveAppAccessControl } from './apps.js';
+import { APP_ARTIFACT_TYPES, APP_CAPABILITIES, APP_PACKAGE_SCOPES, effectiveAppAccessControl } from './apps.js';
+
+describe('app capability contracts', () => {
+    it('keeps views in manifest, package, and build-artifact contracts', () => {
+        expect(APP_CAPABILITIES).toContain('views');
+        expect(APP_PACKAGE_SCOPES).toContain('views');
+        expect(APP_ARTIFACT_TYPES).toContain('view');
+    });
+});
 
 describe('effectiveAppAccessControl', () => {
     it("returns 'all' when neither installation nor manifest set the field", () => {