@conduction/nextcloud-vue 2.119.0 → 2.121.0

package/src/components/CnAiFeaturesWidget/__tests__/CnAiFeaturesWidget.spec.js

@@ -0,0 +1,213 @@
+/**
+ * SPDX-License-Identifier: EUPL-1.2
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ *
+ * CnAiFeaturesWidget: a refusal is shown naming the feature and hermiq's gate,
+ * a transport failure apart from it, a feature hermiq does not offer gets no
+ * run, a failed read says the panel is incomplete, prompts are offered and
+ * answered, and every suggestion ends in one oversight report.
+ */
+import axios from '@nextcloud/axios'
+import { mount } from '@vue/test-utils'
+import CnAiFeaturesWidget from '../CnAiFeaturesWidget.vue'
+
+jest.mock('@nextcloud/axios', () => ({ __esModule: true, default: { get: jest.fn(), post: jest.fn() } }))
+jest.mock('@nextcloud/auth', () => ({ __esModule: true, getRequestToken: () => 'token' }))
+jest.mock('@nextcloud/router', () => ({ __esModule: true, generateUrl: (path) => path }))
+
+const flush = () => new Promise((resolve) => setTimeout(resolve, 0))
+
+const SUMMARY = { slug: 'document-summary', available: true, provider: 'Hermiq', residency: 'on-premise' }
+
+const PROPS = {
+	objectId: 'c-1',
+	register: 'reg',
+	schema: 'case',
+	declaration: { typeField: 'caseType', typeSchema: 'caseType', field: 'aiFeatures', surface: 'case' },
+	featuresEndpoint: '/apps/app/api/assistant/ai-features',
+	featuresQueryKey: 'caseType[aiFeatures]',
+	promptsEndpoint: '/apps/app/api/assistant/prompts',
+	askEndpoint: '/apps/app/api/assistant/converse',
+	decisionEndpoint: '/apps/app/api/ai/record-action',
+	objectKey: 'caseId',
+}
+
+const stubs = {
+	NcLoadingIcon: true,
+	NcButton: { props: ['disabled', 'type', 'variant'], template: '<button v-bind="$attrs" :type="type || \'button\'" :disabled="disabled"><slot /></button>' },
+	NcNoteCard: { props: ['type'], template: '<div class="note" v-bind="$attrs"><slot /></div>' },
+	NcSelect: {
+		props: ['options', 'modelValue', 'inputLabel', 'inputId'],
+		emits: ['update:modelValue'],
+		template: '<label><span>{{ inputLabel }}</span><select v-bind="$attrs" :id="inputId" @change="$emit(\'update:modelValue\', options.find((o) => o.id === $event.target.value) || null)"><option value="" /><option v-for="o in options" :key="o.id" :value="o.id">{{ o.label }}</option></select></label>',
+	},
+}
+
+/**
+ * Answer the reads: features and prompts as given, documents as one file.
+ *
+ * @param {object} answers `{features, prompts, featuresFail}`.
+ */
+function reads({ features = [SUMMARY], prompts = [], featuresFail = false } = {}) {
+	axios.get.mockImplementation((url) => {
+		if (url.endsWith('/objects/reg/case/c-1')) {
+			return featuresFail ? Promise.reject(new Error('down')) : Promise.resolve({ data: { caseType: 'ct-1' } })
+		}
+		if (url.endsWith('/objects/reg/caseType/ct-1')) {
+			return Promise.resolve({ data: { aiFeatures: Object.fromEntries(features.map((f) => [f.slug, 'case'])) } })
+		}
+		if (url.includes('/assistant/ai-features')) {
+			return Promise.resolve({ data: { features } })
+		}
+		if (url.endsWith('/assistant/prompts')) {
+			return Promise.resolve({ data: { prompts } })
+		}
+		if (url.endsWith('/files')) {
+			return Promise.resolve({ data: { results: [{ id: 42, title: 'besluit.pdf' }] } })
+		}
+		return Promise.reject(new Error(`unexpected ${url}`))
+	})
+}
+
+async function mountWidget(props = {}) {
+	const wrapper = mount(CnAiFeaturesWidget, { props: { ...PROPS, ...props }, global: { stubs } })
+	await flush()
+	await flush()
+	await flush()
+	await wrapper.vm.$nextTick()
+	return wrapper
+}
+
+const decisions = () => axios.post.mock.calls.filter(([url]) => url === '/apps/app/api/ai/record-action').map(([, body]) => body)
+
+beforeEach(() => {
+	axios.get.mockReset()
+	axios.post.mockReset()
+})
+
+describe('CnAiFeaturesWidget', () => {
+	it("renders a redaction refusal naming the feature and hermiq's gate", async () => {
+		reads()
+		axios.post.mockRejectedValue({ response: { status: 422, data: { error: 'The document is not redacted.', gate: 'redaction' } } })
+		const wrapper = await mountWidget()
+		await wrapper.find('select').setValue('42')
+		await wrapper.find('form').trigger('submit')
+		await flush()
+		const note = wrapper.find('[data-testid="cn-ai-feature-refusal-document-summary"]')
+		expect(note.text()).toContain('document-summary will not read a document that has not been redacted.')
+		expect(note.text()).toContain('Gate: redaction')
+	})
+
+	it('labels the document picker', async () => {
+		reads()
+		const wrapper = await mountWidget()
+		expect(wrapper.find('label').text()).toContain('Document')
+	})
+
+	it('refuses a run with no document before anything is sent', async () => {
+		reads()
+		const wrapper = await mountWidget()
+		await wrapper.find('form').trigger('submit')
+		await flush()
+		expect(axios.post).not.toHaveBeenCalled()
+		expect(wrapper.find('[data-testid="cn-ai-feature-refusal-document-summary"]').text()).toContain('no document was chosen')
+	})
+
+	it('shows a transport failure apart from a refusal', async () => {
+		reads()
+		axios.post.mockRejectedValue(new Error('Network Error'))
+		const wrapper = await mountWidget()
+		await wrapper.find('select').setValue('42')
+		await wrapper.find('form').trigger('submit')
+		await flush()
+		expect(wrapper.find('[data-testid="cn-ai-feature-failed-document-summary"]').exists()).toBe(true)
+		expect(wrapper.find('[data-testid="cn-ai-feature-refusal-document-summary"]').exists()).toBe(false)
+	})
+
+	it('offers no run for a feature hermiq does not offer, and reads no documents', async () => {
+		reads({ features: [{ slug: 'triage', available: false }] })
+		const wrapper = await mountWidget()
+		expect(wrapper.find('form').exists()).toBe(false)
+		expect(wrapper.text()).toContain('Unavailable: hermiq does not offer this feature here.')
+		expect(axios.get.mock.calls.some(([url]) => url.endsWith('/files'))).toBe(false)
+	})
+
+	it('says the panel is incomplete when the features could not be read', async () => {
+		reads({ featuresFail: true })
+		const wrapper = await mountWidget()
+		expect(wrapper.find('[data-testid="cn-ai-features-unreadable"]').exists()).toBe(true)
+	})
+
+	it("offers the prompts and shows the answer to one, or the assistant's refusal", async () => {
+		reads({ features: [], prompts: [{ id: 'p-1', label: 'Vraag', prompt: 'Vraag?' }] })
+		axios.post.mockResolvedValueOnce({ data: { reply: 'Ja.' } })
+		const wrapper = await mountWidget()
+		await wrapper.find('[data-testid="cn-ai-question-p-1"]').trigger('click')
+		await flush()
+		expect(axios.post.mock.calls[0]).toEqual(['/apps/app/api/assistant/converse', { caseId: 'c-1', message: 'Vraag?' }])
+		expect(wrapper.find('[data-testid="cn-ai-question-answer"]').text()).toBe('Ja.')
+
+		// The open answer is reported superseded first, then the question is asked.
+		axios.post.mockResolvedValueOnce({ data: {} }).mockRejectedValueOnce({ response: { data: { error: 'Not now.' } } })
+		await wrapper.find('[data-testid="cn-ai-question-p-1"]').trigger('click')
+		await flush()
+		expect(wrapper.find('[data-testid="cn-ai-question-failed"]').text()).toBe('Not now.')
+	})
+
+	it('renders no questions when none are offered', async () => {
+		reads({ features: [] })
+		const wrapper = await mountWidget()
+		expect(wrapper.find('[data-testid="cn-ai-questions"]').exists()).toBe(false)
+	})
+
+	it('reports a used run output to the oversight trail', async () => {
+		reads()
+		axios.post.mockResolvedValue({ data: { output: 'Verleend.' } })
+		const wrapper = await mountWidget()
+		await wrapper.find('select').setValue('42')
+		await wrapper.find('form').trigger('submit')
+		await flush()
+		expect(wrapper.find('[data-testid="cn-ai-feature-output-document-summary"]').text()).toBe('Verleend.')
+		await wrapper.find('[data-testid="cn-ai-feature-decision-document-summary-use"]').trigger('click')
+		await flush()
+		expect(decisions()).toHaveLength(1)
+		expect(decisions()[0]).toMatchObject({ caseId: 'c-1', type: 'decision_support', userAction: 'accepted', suggestion: 'Verleend.', documentId: '42' })
+	})
+
+	it('reports an adapted answer with the version that was used', async () => {
+		reads({ features: [], prompts: [{ id: 'p-1', label: 'Vraag', prompt: 'Vraag?' }] })
+		axios.post.mockResolvedValue({ data: { reply: 'Ja.' } })
+		const wrapper = await mountWidget()
+		await wrapper.find('[data-testid="cn-ai-question-p-1"]').trigger('click')
+		await flush()
+		await wrapper.find('[data-testid="cn-ai-question-decision-adapt"]').trigger('click')
+		await wrapper.find('[data-testid="cn-ai-question-decision-draft"]').setValue('Ja, mits.')
+		await wrapper.find('[data-testid="cn-ai-question-decision-use-adapted"]').trigger('click')
+		await flush()
+		expect(decisions()[0]).toMatchObject({ type: 'qa', userAction: 'modified', suggestion: 'Ja.', actualValue: 'Ja, mits.', prompt: 'Vraag?' })
+	})
+
+	it('reports an answer nobody acted on as superseded by the next question, then closed', async () => {
+		reads({ features: [], prompts: [{ id: 'p-1', label: 'Vraag', prompt: 'Vraag?' }] })
+		axios.post.mockResolvedValueOnce({ data: { reply: 'Eerste.' } }).mockResolvedValueOnce({ data: {} }).mockResolvedValue({ data: { reply: 'Tweede.' } })
+		const wrapper = await mountWidget()
+		await wrapper.find('[data-testid="cn-ai-question-p-1"]').trigger('click')
+		await flush()
+		await wrapper.find('[data-testid="cn-ai-question-p-1"]').trigger('click')
+		await flush()
+		wrapper.unmount()
+		await flush()
+		expect(decisions()).toHaveLength(2)
+		expect(decisions()[0]).toMatchObject({ userAction: 'ignored', unusedBecause: 'superseded', suggestion: 'Eerste.' })
+		expect(decisions()[1]).toMatchObject({ userAction: 'ignored', unusedBecause: 'closed' })
+	})
+})
+
+describe('CnObjectSidebar built-in', () => {
+	it('resolves the ai-features widget type', () => {
+		const fs = require('fs')
+		const path = require('path')
+		const source = fs.readFileSync(path.resolve(__dirname, '../../CnObjectSidebar/CnObjectSidebar.vue'), 'utf8')
+		expect(source).toMatch(/'ai-features': CnAiFeaturesWidget/)
+	})
+})

package/src/components/CnAiFeaturesWidget/index.js

@@ -0,0 +1,14 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * CnAiFeaturesWidget — the hermiq AI features a record's type switches on,
+ * with where each runs, a run on a record document, refusals in words and an
+ * oversight decision on every suggestion. The CnObjectSidebar built-in
+ * `ai-features`.
+ */
+
+import CnAiFeaturesWidget from './CnAiFeaturesWidget.vue'
+
+export { CnAiFeaturesWidget }
+export default CnAiFeaturesWidget

package/src/components/CnIndexPage/CnIndexPage.vue

@@ -210,7 +210,7 @@
 			:mapLabel="mapLabel"
 			:mapIcon="mapIcon"
 			:listIcon="listIcon"
-			:showSearch="search !== false && (inlineSearch || isBoardLook)"
+			:showSearch="search !== false && (inlineSearch || isBoardLook) && !sourceRefusal"
 			:searchPlacement="searchPlacement"
 			:searchValue="effectiveSearchValue"
 			:searchPlaceholder="presented('searchPlaceholder') ? cnTranslate(presented('searchPlaceholder')) : presented('searchPlaceholder')"
@@ -745,12 +745,31 @@
 					<span v-if="scopeHeading.subtitle" class="cn-index-page__scope-subtitle" data-testid="cn-index-page-scope-subtitle">{{ scopeHeading.subtitle }}</span>
 				</div>
 
+				<!-- A note the named source read off its answer ("Filters run in
+				     this order: ..."). -->
+				<p v-if="sourceNote && !sourceRefusal"
+					class="cn-index-page__source-note"
+					data-testid="cn-index-page-source-note">
+					{{ sourceNote }}
+				</p>
+
 				<!-- Loading state — initial fetch only; a background refresh keeps the table visible -->
 				<div v-if="showInitialLoader" class="cn-index-page__loading">
 					<!-- name gives NcLoadingIcon a non-empty aria-label (WCAG role-img-alt); empty name ships an unlabeled role="img" -->
 					<NcLoadingIcon :size="32" :name="loadingText" />
 				</div>
 
+				<!-- The named source's server refused this reader: its sentence
+				     instead of the rows, never an empty list. -->
+				<div v-else-if="sourceRefusal"
+					class="cn-index-page__source-refusal"
+					role="status"
+					data-testid="cn-index-page-source-refusal">
+					<NcNoteCard type="error">
+						{{ sourceRefusal }}
+					</NcNoteCard>
+				</div>
+
 				<!-- A search the server refused for its grammar: the term with the
 				     character it stopped at, the server's reason, and what to do. -->
 				<div v-else-if="searchRefusal"
@@ -774,7 +793,7 @@
 				</div>
 
 				<!-- Error state: the latest self-fetch failed (e.g. a search term the server rejects) -->
-				<div v-else-if="selfFetchFailed"
+				<div v-else-if="selfFetchFailed || sourceFailed"
 					class="cn-index-page__empty"
 					role="status"
 					data-testid="cn-index-page-fetch-error">
@@ -4107,6 +4126,8 @@ export default {
 		const namedPageSize = Number(props.sourceConfig && props.sourceConfig.limit) > 0 ? Number(props.sourceConfig.limit) : 20
 		const namedPaging = ref({ page: 1, limit: namedPageSize })
 		const namedActiveFilters = ref(namedFiltersFromRoute(getCurrentInstance(), props))
+		// The search term on a named source that searches (`searchParam`).
+		const namedSearchTerm = ref('')
 
 		const {
 			isNamedSource,
@@ -4114,7 +4135,7 @@ export default {
 			namedRows,
 			namedLoading,
 			namedQuickFilters,
-		} = useNamedSource(props, { activeQuickFilterIndex, activeFilters: namedActiveFilters, paging: namedPaging })
+		} = useNamedSource(props, { activeQuickFilterIndex, activeFilters: namedActiveFilters, paging: namedPaging, searchTerm: namedSearchTerm })
 
 		return {
 			isBoard: isBoardLook,
@@ -4127,6 +4148,7 @@ export default {
 			namedQuickFilters,
 			namedActiveFilters,
 			namedPaging,
+			namedSearchTerm,
 			contextMenuOpen,
 			contextMenuRow,
 			openContextMenu,
@@ -4536,6 +4558,46 @@ export default {
 			return this.selfFetchFailed ? readSearchRefusal(this.list.error.value, this.effectiveSearchValue) : null
 		},
 
+		/**
+		 * Whether the named source sends the search term to its server.
+		 *
+		 * @return {boolean}
+		 */
+		namedSourceSearches() {
+			return this.isNamedSource && !!this.namedSource && typeof this.namedSource.searchParam === 'string' && this.namedSource.searchParam !== ''
+		},
+
+		/**
+		 * The sentence the named source's server refused this reader with, or ''.
+		 * While it holds the page shows it instead of the rows, the search and
+		 * the tabs: a list nobody may read is not an empty list.
+		 *
+		 * @return {string}
+		 * @spec openspec/changes/index-endpoint-source-states/specs/index-page/spec.md
+		 */
+		sourceRefusal() {
+			return this.isNamedSource && this.namedSource && typeof this.namedSource.refusal === 'function' ? (this.namedSource.refusal() || '') : ''
+		},
+
+		/**
+		 * Whether the named source's last load failed (not refused).
+		 *
+		 * @return {boolean}
+		 */
+		sourceFailed() {
+			return this.isNamedSource && !!this.namedSource && typeof this.namedSource.failed === 'function' && this.namedSource.failed() === true
+		},
+
+		/**
+		 * The note the named source read off its last answer, or ''.
+		 *
+		 * @return {string}
+		 * @spec openspec/changes/index-endpoint-source-states/specs/index-page/spec.md
+		 */
+		sourceNote() {
+			return this.isNamedSource && this.namedSource && typeof this.namedSource.note === 'function' ? (this.namedSource.note() || '') : ''
+		},
+
 		/** @return {string} What to do after a refused search. */
 		searchRefusalHintText() {
 			if (this.searchRefusalHint) {
@@ -5821,6 +5883,9 @@ export default {
 		},
 
 		tabStripEntries() {
+			if (this.sourceRefusal) {
+				return []
+			}
 			if (this.lensTabs.length > 0) {
 				return this.lensTabs
 			}
@@ -6921,6 +6986,9 @@ export default {
 
 		/** Search term / visible columns / active facet filters for the embedded sidebar. */
 		effectiveSearchValue() {
+			if (this.namedSourceSearches) {
+				return this.namedSearchTerm || ''
+			}
 			return this.isSelfFetchMode ? (this.list.searchTerm.value || '') : (this.searchValue || '')
 		},
 
@@ -9691,6 +9759,9 @@ export default {
 		 * @return {void}
 		 */
 		onSearchEvent(value) {
+			if (this.namedSourceSearches) {
+				this.namedSearchTerm = value || ''
+			}
 			if (this.isSelfFetchMode && typeof this.list.onSearch === 'function') {
 				this.list.onSearch(value)
 				this.persistViewStateToRoute(this.currentViewState())

package/src/components/CnIndexPage/useNamedSource.js

@@ -59,6 +59,9 @@ import { searchFieldParams } from '../../utils/searchFieldParams.js'
  *   chosen values, `{ fieldKey: values }`. Mapped through the source's
  *   `searchFields` declaration into loader arguments and merged into every
  *   load, so a manifest page's sidebar narrows the SERVER's query.
+ * @param {import('vue').Ref<string>} [options.searchTerm] The page's search
+ *   term. A source that names a `searchParam` gets it as that argument, so the
+ *   server searches; a new term reloads from the first page.
  *
  * @return {object} { isNamedSource, namedSource, namedRows, namedLoading, namedQuickFilters }
  */
@@ -106,6 +109,7 @@ export function useNamedSource(props, options = {}) {
 	const tabs = manifestTabs || sourceTabs
 	const activeIndex = options.activeQuickFilterIndex || null
 	const activeFilters = options.activeFilters || null
+	const searchTerm = (typeof source.searchParam === 'string' && source.searchParam !== '') ? (options.searchTerm || null) : null
 	// A source that pages (`pages: true`) gets the page as `limit` and
 	// `offset`, from the pager the page draws for it.
 	const paging = source.pages === true ? (options.paging || null) : null
@@ -169,6 +173,7 @@ export function useNamedSource(props, options = {}) {
 					activeFilters ? activeFilters.value : null,
 					props.entitySource,
 				),
+				...(searchTerm && searchTerm.value ? { [source.searchParam]: searchTerm.value } : {}),
 				...(paging ? { limit: paging.value.limit, offset: (paging.value.page - 1) * paging.value.limit } : {}),
 			},
 			tokenCtx(),
@@ -218,6 +223,10 @@ export function useNamedSource(props, options = {}) {
 		watch(activeFilters, reloadFromFirstPage, { deep: true })
 	}
 
+	if (searchTerm) {
+		watch(searchTerm, reloadFromFirstPage)
+	}
+
 	// A new page, or a new page size, is a new request. A new tab or filter
 	// first returns to page 1, which reloads through here.
 	if (paging) {