@jini-ai/ui 0.1.2 → 0.3.0

package/dist/features/source-config-list/agent-handles.js

@@ -0,0 +1,151 @@
+/**
+ * @module agent-handles
+ *
+ * How this feature turns the ONE base handle a host passes as `agentHandle` into the
+ * `data-agent-*` markup for every sub-element it publishes.
+ *
+ * A host names a component (`agentHandle="mcp-add"`); the component names its own parts. That
+ * split is deliberate: only the component knows it has a "Show" toggle next to the password box,
+ * what verb applies to each control, and what each one is called — a caller supplying an
+ * id-per-element map would have to re-derive all of it, and re-derive it again on every internal
+ * change. See `@jini-ai/agentic`'s `element-handles.ts` for the markup convention itself.
+ *
+ * ## The scheme
+ *
+ * | element | handle |
+ * |---|---|
+ * | the component itself | `<base>` |
+ * | an action on it | `<base>-<action>` — e.g. `mcp-add-submit`, `mcp-server-1-remove` |
+ * | one host-described field | `<base>-field-<kebab-cased spec.key>` — e.g. `mcp-add-field-oauth-client-id` |
+ * | a control belonging to a field | `<field handle>-<action>` — e.g. `mcp-add-field-api-key-reveal` |
+ *
+ * Fields sit under their own `-field-` namespace rather than directly under the base so that a
+ * host whose source shape happens to contain a field keyed `remove` or `save` cannot collide with
+ * this feature's own action handles. A duplicate handle is not a cosmetic problem: it makes
+ * `page.fill`/`page.click` ambiguous for the very element a caller was most likely to want.
+ *
+ * ## The list-level scheme (`SourceConfigList`/`SourceConfigListView`)
+ *
+ * A list mounts one add form and N item cards from ONE base, the same "caller names one thing,
+ * this feature names its own parts" split as every card/form above:
+ *
+ * | element | handle |
+ * |---|---|
+ * | the add form | `<base>-add` (that base's own scheme then applies) |
+ * | one item card, keyed by the source's own stable id | `<base>-item-<slug of source.id>` (that base's own scheme then applies) |
+ *
+ * Item cards sit under `<base>-item-` rather than directly under `<base>` so that a source id
+ * cannot collide with the add form's `<base>-add` handle. See {@link sourceConfigItemHandles} for
+ * why cards are keyed by id rather than list position.
+ */
+import { agentHandle, buildAgentListHandles } from '@jini-ai/agentic';
+/** Segments of a derived handle: `<base>-field-<key>` and `<base>-<action>` share one joiner. */
+const HANDLE_SEPARATOR = '-';
+/** The namespace every host-described field sits under — see this module's doc for why. */
+const FIELD_NAMESPACE = 'field';
+/** What an unnameable field key degrades to, so it still produces a resolvable handle. */
+const UNNAMEABLE_FIELD_SEGMENT = 'unnamed';
+/** The action name `SourceConfigList`/`SourceConfigListView` derive the add form's base from. */
+const LIST_ADD_FORM_ACTION = 'add';
+/** The namespace every item card sits under — see this module's doc for why it is not `<base>` directly. */
+const LIST_ITEM_NAMESPACE = 'item';
+/**
+ * Reduces one segment to the `[a-z0-9]+(-[a-z0-9]+)*` alphabet handles are restricted to.
+ *
+ * `SourceFieldSpec.key` is host data, not a handle: nothing stops a host keying a field
+ * `oauthClientId`, `api_key`, or `Base URL`. `agentHandle()` THROWS on anything outside the
+ * pattern, and a throw here would take down the whole settings surface for a field spec that is
+ * otherwise perfectly valid — so keys are sanitized rather than validated, the same call this
+ * package's `McpUiSurfaceCard` already makes for producer-supplied `ui://` URIs. The base handle
+ * is NOT sanitized: it is the host's own explicit choice of name, and a bad one should fail loudly
+ * at the first render rather than silently answer to a handle the host never wrote.
+ *
+ * @param segment - Arbitrary host text.
+ * @returns The sanitized segment, or `''` when nothing survives.
+ * @complexity O(n) in `segment.length`.
+ */
+function sanitizeHandleSegment(segment) {
+    return segment
+        .replace(/([a-z0-9])([A-Z])/g, `$1${HANDLE_SEPARATOR}$2`)
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, HANDLE_SEPARATOR)
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * The handle for one action or sub-control published under `base`.
+ *
+ * Exported because a nested component that publishes handles of its own (`SourceConfigField`,
+ * `SourceConfigTestControl`) is handed a base rather than props — its parent derives that base
+ * with this, and the child then derives its own parts from it the same way.
+ *
+ * @param base - The component's own handle, as published by the host. Must already be a valid
+ *   element handle — see {@link sanitizeHandleSegment} for why this one is not sanitized.
+ * @param action - The sub-element's name. Always a literal chosen by this feature, never host data.
+ * @returns `<base>-<action>`.
+ * @complexity O(1).
+ */
+export function sourceConfigActionHandle(base, action) {
+    return `${base}${HANDLE_SEPARATOR}${action}`;
+}
+/**
+ * The handle for one host-described field rendered under `base`.
+ *
+ * @param base - The component's own handle, as published by the host.
+ * @param fieldKey - The `SourceFieldSpec.key` this field renders. Host data, so it is sanitized.
+ * @returns `<base>-field-<kebab-cased key>`.
+ * @complexity O(n) in `fieldKey.length`.
+ */
+export function sourceConfigFieldHandle(base, fieldKey) {
+    const segment = sanitizeHandleSegment(fieldKey);
+    return [base, FIELD_NAMESPACE, segment === '' ? UNNAMEABLE_FIELD_SEGMENT : segment].join(HANDLE_SEPARATOR);
+}
+/**
+ * The add form's own base, derived from a list's base — see this module's "list-level scheme" doc.
+ *
+ * @param listBase - The list's own handle, as published by the host to `SourceConfigList`/`SourceConfigListView`.
+ * @returns `<listBase>-add`.
+ * @complexity O(1).
+ */
+export function sourceConfigAddFormHandle(listBase) {
+    return sourceConfigActionHandle(listBase, LIST_ADD_FORM_ACTION);
+}
+/**
+ * One distinct, stable base handle per rendered item card, positionally aligned with `sourceIds` —
+ * what `SourceConfigListView` hands each `SourceConfigItemCard` as its own `agentHandle`.
+ *
+ * Derived from each source's own stable id, never its position in the list: an agent reading
+ * `page.find_elements` should keep seeing the same card handle for the same source after a
+ * refresh reorders or filters the list. Delegates the actual slugify-and-deduplicate mechanics to
+ * `@jini-ai/agentic`'s {@link buildAgentListHandles} — see that function's own doc for why
+ * uniqueness needs a suffix search rather than a single `-<index>` append.
+ *
+ * @param listBase - The list's own handle, as published by the host.
+ * @param sourceIds - The rendered sources' own stable ids, in render order.
+ * @returns One base handle per id, positionally aligned with `sourceIds`, all distinct, and none
+ *   colliding with {@link sourceConfigAddFormHandle}'s `<listBase>-add` (see the `-item-`
+ *   namespace in this module's doc).
+ * @complexity See {@link buildAgentListHandles}.
+ */
+export function sourceConfigItemHandles(listBase, sourceIds) {
+    return buildAgentListHandles(`${listBase}${HANDLE_SEPARATOR}${LIST_ITEM_NAMESPACE}`, sourceIds);
+}
+/**
+ * Builds the `data-agent-*` attribute props for one sub-element, or nothing at all when the host
+ * published no base handle.
+ *
+ * Returning `{}` rather than throwing is what keeps `agentHandle` an opt-in prop: a host with no
+ * agent-control surface renders exactly the markup it did before this existed.
+ *
+ * @param base - The component's own handle from the host, or `undefined` when it published none.
+ * @param options - Role, stable label, and the optional action naming this sub-element.
+ * @returns Spreadable attribute props, or `{}` when `base` is `undefined`.
+ * @throws If `base` is not a valid element handle — via `agentHandle()`, deliberately unguarded.
+ * @complexity O(1).
+ */
+export function sourceConfigAgentProps(base, options) {
+    if (base === undefined)
+        return {};
+    const handle = options.action === undefined ? base : sourceConfigActionHandle(base, options.action);
+    return agentHandle(handle, { role: options.role, label: options.label });
+}
+//# sourceMappingURL=agent-handles.js.map

package/dist/features/source-config-list/agent-handles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-handles.js","sourceRoot":"","sources":["../../../src/features/source-config-list/agent-handles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAgD,MAAM,kBAAkB,CAAC;AAEpH,iGAAiG;AACjG,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B,2FAA2F;AAC3F,MAAM,eAAe,GAAG,OAAO,CAAC;AAEhC,0FAA0F;AAC1F,MAAM,wBAAwB,GAAG,SAAS,CAAC;AAE3C,iGAAiG;AACjG,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAEnC,4GAA4G;AAC5G,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC;;;;;;;;;;;;;;GAcG;AACH,SAAS,qBAAqB,CAAC,OAAe;IAC5C,OAAO,OAAO;SACX,OAAO,CAAC,oBAAoB,EAAE,KAAK,gBAAgB,IAAI,CAAC;SACxD,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,gBAAgB,CAAC;SACxC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,MAAc;IACnE,OAAO,GAAG,IAAI,GAAG,gBAAgB,GAAG,MAAM,EAAE,CAAC;AAC/C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,QAAgB;IACpE,MAAM,OAAO,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CACtF,gBAAgB,CACjB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB;IACxD,OAAO,wBAAwB,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB,EAAE,SAA4B;IACpF,OAAO,qBAAqB,CAAC,GAAG,QAAQ,GAAG,gBAAgB,GAAG,mBAAmB,EAAE,EAAE,SAAS,CAAC,CAAC;AAClG,CAAC;AAmBD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAAwB,EACxB,OAAsC;IAEtC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACpG,OAAO,WAAW,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/features/source-config-list/index.d.ts

@@ -1,9 +1,10 @@
-export type { AddSourceInput, AddSourceResult, SourceActionKind, SourceConfigItem, SourceConnectionStatus, SourceDraftIssue, SourceDraftValidation, SourceFieldKind, SourceFieldOption, SourceFieldSpec, SourceFieldValues, SourceTestResult, SourceTrustOption, } from './types.js';
-export { MASK_CHAR, MASKED_VALUE_MIN_MASK_LENGTH, MASKED_VALUE_VISIBLE_SUFFIX_LENGTH } from './constants.js';
-export { emptySourceDraft, isActionPending, issueForField, maskFieldValue, pendingActionKey, removeSourceById, sourceDisplayLabel, updateSourceById, upsertSourceById, validateSourceDraft, withoutPendingAction, withPendingAction, } from './rules.js';
+export { sourceConfigActionHandle, sourceConfigAgentProps, sourceConfigFieldHandle, } from './agent-handles.js';
+export type { SourceConfigAgentPropsOptions } from './agent-handles.js';
+export { MASK_CHAR, MASKED_VALUE_MIN_MASK_LENGTH, MASKED_VALUE_VISIBLE_SUFFIX_LENGTH, } from './constants.js';
+export { createFakeSourceConfigDependencies, createFakeSourceConfigPort, type FakeSourceConfigPortOptions, } from './dependencies.js';
 export type { SourceConfigDependencies, SourceConfigPort } from './ports.js';
-export { createFakeSourceConfigDependencies, createFakeSourceConfigPort } from './dependencies.js';
-export type { FakeSourceConfigPortOptions } from './dependencies.js';
+export { emptySourceDraft, isActionPending, issueForField, maskFieldValue, pendingActionKey, removeSourceById, sourceDisplayLabel, updateSourceById, upsertSourceById, validateSourceDraft, withoutPendingAction, withPendingAction, } from './rules.js';
+export type { AddSourceInput, AddSourceResult, SourceActionKind, SourceConfigItem, SourceConnectionStatus, SourceDraftIssue, SourceDraftValidation, SourceFieldKind, SourceFieldOption, SourceFieldSpec, SourceFieldValues, SourceTestResult, SourceTrustOption, } from './types.js';
 export { useSourceConfigList, useWiredSourceConfigList } from './react/hooks/useSourceConfigList.js';
 export type { SourceConfigListCapabilities, SourceConfigListController, UseSourceConfigListParams, UseWiredSourceConfigListParams, } from './react/hooks/useSourceConfigList.js';
 export { useSourceConfigAddForm, useWiredSourceConfigAddForm } from './react/hooks/useSourceConfigAddForm.js';

package/dist/features/source-config-list/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/source-config-list/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,4BAA4B,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAC;AAE7G,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,kCAAkC,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AACnG,YAAY,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AACrG,YAAY,EACV,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAC9G,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,EAC5B,iCAAiC,GAClC,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,YAAY,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,YAAY,EAAE,4BAA4B,EAAE,MAAM,+CAA+C,CAAC;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,YAAY,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAClF,YAAY,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAClF,YAAY,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,YAAY,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/source-config-list/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EACL,SAAS,EACT,4BAA4B,EAC5B,kCAAkC,GACnC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kCAAkC,EAClC,0BAA0B,EAC1B,KAAK,2BAA2B,GACjC,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AACrG,YAAY,EACV,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,8BAA8B,GAC/B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAC9G,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,EAC5B,iCAAiC,GAClC,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,YAAY,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,YAAY,EAAE,4BAA4B,EAAE,MAAM,+CAA+C,CAAC;AAClG,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAChF,YAAY,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAClF,YAAY,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAClF,YAAY,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,YAAY,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/features/source-config-list/index.js

@@ -1,6 +1,7 @@
-export { MASK_CHAR, MASKED_VALUE_MIN_MASK_LENGTH, MASKED_VALUE_VISIBLE_SUFFIX_LENGTH } from './constants.js';
+export { sourceConfigActionHandle, sourceConfigAgentProps, sourceConfigFieldHandle, } from './agent-handles.js';
+export { MASK_CHAR, MASKED_VALUE_MIN_MASK_LENGTH, MASKED_VALUE_VISIBLE_SUFFIX_LENGTH, } from './constants.js';
+export { createFakeSourceConfigDependencies, createFakeSourceConfigPort, } from './dependencies.js';
 export { emptySourceDraft, isActionPending, issueForField, maskFieldValue, pendingActionKey, removeSourceById, sourceDisplayLabel, updateSourceById, upsertSourceById, validateSourceDraft, withoutPendingAction, withPendingAction, } from './rules.js';
-export { createFakeSourceConfigDependencies, createFakeSourceConfigPort } from './dependencies.js';
 export { useSourceConfigList, useWiredSourceConfigList } from './react/hooks/useSourceConfigList.js';
 export { useSourceConfigAddForm, useWiredSourceConfigAddForm } from './react/hooks/useSourceConfigAddForm.js';
 export { SourceConfigField } from './react/components/SourceConfigField.js';

package/dist/features/source-config-list/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/source-config-list/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,SAAS,EAAE,4BAA4B,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAC;AAE7G,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAIpB,OAAO,EAAE,kCAAkC,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAGnG,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAQrG,OAAO,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAO9G,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAE5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AAExF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAEhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAElF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAElF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/source-config-list/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,SAAS,EACT,4BAA4B,EAC5B,kCAAkC,GACnC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,kCAAkC,EAClC,0BAA0B,GAE3B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAiBpB,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAOrG,OAAO,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAM9G,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAE5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AAExF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAEhF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAElF,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAElF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/features/source-config-list/react/components/SourceConfigAddForm.d.ts

@@ -26,6 +26,15 @@ export interface SourceConfigAddFormProps {
     testing?: boolean;
     testResult?: SourceTestResult;
     onTest?: () => void;
+    /**
+     * This form's own agent handle — publishes the form and everything in it to
+     * `@jini-ai/agentic`'s `page.*` verbs. A plain string, not a per-element
+     * map: the caller names the form, this component names its own parts and
+     * supplies each one's role and label, because only it knows which controls
+     * it renders for a given set of props. Omit and no `data-agent-*` markup is
+     * emitted at all. See the table below and `../../agent-handles.ts`.
+     */
+    agentHandle?: string;
 }
 /**
  * The "add a source" form: one `SourceConfigField` per host-supplied field
@@ -35,6 +44,24 @@ export interface SourceConfigAddFormProps {
  * presentational — the draft state lives in `useSourceConfigAddForm`. Field
  * errors only render once a submit has been attempted, matching the origin
  * sources' "don't yell at the user before they've tried to submit" UX.
+ *
+ * ## Agent handles
+ *
+ * Given `agentHandle="mcp-add"` this publishes:
+ *
+ * | element | handle | role |
+ * |---|---|---|
+ * | the form | `mcp-add` | `form` |
+ * | one field (per `spec.key`) | `mcp-add-field-<kebab-cased key>` | `field` |
+ * | the trust selector | `mcp-add-trust` | `field` |
+ * | the test control | `mcp-add-test` / `mcp-add-test-status` | `button` / `status` |
+ * | the submit button | `mcp-add-submit` | `button` |
+ *
+ * The field set is whatever `fieldSpecs` currently is, so a host that varies
+ * `fieldSpecs` in response to a draft change (a transport picker that reveals
+ * URL-only fields, say) publishes the new fields as soon as they mount — a
+ * caller's next `page.find_elements` sees them, because that verb re-queries
+ * the DOM rather than replaying an earlier snapshot.
  */
-export declare function SourceConfigAddForm({ fieldSpecs, trustOptions, values, trust, validation, submitAttempted, submitting, submitError, addLabel, onFieldChange, onTrustChange, onSubmit, canTest, testing, testResult, onTest, }: SourceConfigAddFormProps): import("react").JSX.Element;
+export declare function SourceConfigAddForm({ fieldSpecs, trustOptions, values, trust, validation, submitAttempted, submitting, submitError, addLabel, onFieldChange, onTrustChange, onSubmit, canTest, testing, testResult, onTest, agentHandle, }: SourceConfigAddFormProps): import("react").JSX.Element;
 //# sourceMappingURL=SourceConfigAddForm.d.ts.map

package/dist/features/source-config-list/react/components/SourceConfigAddForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SourceConfigAddForm.d.ts","sourceRoot":"","sources":["../../../../../src/features/source-config-list/react/components/SourceConfigAddForm.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAErI,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IACvC,YAAY,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5C,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,EAAE,qBAAqB,CAAC;IAClC,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,UAAU,EACV,YAAY,EACZ,MAAM,EACN,KAAK,EACL,UAAU,EACV,eAAe,EACf,UAAU,EACV,WAAW,EACX,QAAQ,EACR,aAAa,EACb,aAAa,EACb,QAAQ,EACR,OAAe,EACf,OAAe,EACf,UAAU,EACV,MAAM,GACP,EAAE,wBAAwB,+BAiE1B"}
+{"version":3,"file":"SourceConfigAddForm.d.ts","sourceRoot":"","sources":["../../../../../src/features/source-config-list/react/components/SourceConfigAddForm.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAIxB,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IACvC,YAAY,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5C,MAAM,EAAE,iBAAiB,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,UAAU,EAAE,qBAAqB,CAAC;IAClC,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,UAAU,EACV,YAAY,EACZ,MAAM,EACN,KAAK,EACL,UAAU,EACV,eAAe,EACf,UAAU,EACV,WAAW,EACX,QAAQ,EACR,aAAa,EACb,aAAa,EACb,QAAQ,EACR,OAAe,EACf,OAAe,EACf,UAAU,EACV,MAAM,EACN,WAAW,GACZ,EAAE,wBAAwB,+BA4E1B"}

package/dist/features/source-config-list/react/components/SourceConfigAddForm.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useT } from '../../../i18n/index.js';
+import { sourceConfigActionHandle, sourceConfigAgentProps, sourceConfigFieldHandle } from '../../agent-handles.js';
 import { issueForField } from '../../rules.js';
 import { SourceConfigField } from './SourceConfigField.js';
 import { SourceConfigTestControl } from './SourceConfigTestControl.js';
@@ -11,15 +12,35 @@ import { SourceConfigTestControl } from './SourceConfigTestControl.js';
  * presentational — the draft state lives in `useSourceConfigAddForm`. Field
  * errors only render once a submit has been attempted, matching the origin
  * sources' "don't yell at the user before they've tried to submit" UX.
+ *
+ * ## Agent handles
+ *
+ * Given `agentHandle="mcp-add"` this publishes:
+ *
+ * | element | handle | role |
+ * |---|---|---|
+ * | the form | `mcp-add` | `form` |
+ * | one field (per `spec.key`) | `mcp-add-field-<kebab-cased key>` | `field` |
+ * | the trust selector | `mcp-add-trust` | `field` |
+ * | the test control | `mcp-add-test` / `mcp-add-test-status` | `button` / `status` |
+ * | the submit button | `mcp-add-submit` | `button` |
+ *
+ * The field set is whatever `fieldSpecs` currently is, so a host that varies
+ * `fieldSpecs` in response to a draft change (a transport picker that reveals
+ * URL-only fields, say) publishes the new fields as soon as they mount — a
+ * caller's next `page.find_elements` sees them, because that verb re-queries
+ * the DOM rather than replaying an earlier snapshot.
  */
-export function SourceConfigAddForm({ fieldSpecs, trustOptions, values, trust, validation, submitAttempted, submitting, submitError, addLabel, onFieldChange, onTrustChange, onSubmit, canTest = false, testing = false, testResult, onTest, }) {
+export function SourceConfigAddForm({ fieldSpecs, trustOptions, values, trust, validation, submitAttempted, submitting, submitError, addLabel, onFieldChange, onTrustChange, onSubmit, canTest = false, testing = false, testResult, onTest, agentHandle, }) {
     const t = useT();
-    return (_jsxs("form", { className: "source-config-add-form", onSubmit: (event) => {
+    const submitLabel = addLabel ? t(addLabel) : t('Add source');
+    const trustLabel = t('Trust level');
+    return (_jsxs("form", { className: "source-config-add-form", ...sourceConfigAgentProps(agentHandle, { role: 'form', label: submitLabel }), onSubmit: (event) => {
             event.preventDefault();
             onSubmit();
         }, children: [fieldSpecs.map((spec) => {
                 const issue = submitAttempted ? issueForField(validation, spec.key) : undefined;
-                return (_jsx(SourceConfigField, { spec: spec, value: values[spec.key] ?? '', disabled: submitting, onChange: (value) => onFieldChange(spec.key, value), ...(issue ? { error: t(issue.message, { label: t(spec.label) }) } : {}) }, spec.key));
-            }), trustOptions && trustOptions.length > 0 ? (_jsxs("label", { className: "source-config-field", htmlFor: "source-config-add-form-trust", children: [_jsx("span", { className: "source-config-field-label", children: t('Trust level') }), _jsxs("select", { id: "source-config-add-form-trust", value: trust ?? '', disabled: submitting, "aria-label": t('Trust level'), onChange: (event) => onTrustChange(event.target.value), children: [!trust ? (_jsx("option", { value: "", disabled: true, hidden: true, children: t('Select…') })) : null, trustOptions.map((option) => (_jsx("option", { value: option.value, children: t(option.label) }, option.value)))] })] })) : null, canTest && onTest ? (_jsx(SourceConfigTestControl, { running: testing, disabled: submitting || !validation.ok, onTest: onTest, ...(testResult ? { result: testResult } : {}) })) : null, submitError ? (_jsx("div", { className: "source-config-add-form-error", role: "alert", children: t(submitError) })) : null, _jsx("button", { type: "submit", className: "source-config-add-form-submit", disabled: submitting, children: submitting ? t('Adding…') : addLabel ? t(addLabel) : t('Add source') })] }));
+                return (_jsx(SourceConfigField, { spec: spec, value: values[spec.key] ?? '', disabled: submitting, onChange: (value) => onFieldChange(spec.key, value), ...(issue ? { error: t(issue.message, { label: t(spec.label) }) } : {}), ...(agentHandle ? { agentHandle: sourceConfigFieldHandle(agentHandle, spec.key) } : {}) }, spec.key));
+            }), trustOptions && trustOptions.length > 0 ? (_jsxs("label", { className: "source-config-field", htmlFor: "source-config-add-form-trust", children: [_jsx("span", { className: "source-config-field-label", children: trustLabel }), _jsxs("select", { id: "source-config-add-form-trust", value: trust ?? '', disabled: submitting, "aria-label": trustLabel, ...sourceConfigAgentProps(agentHandle, { role: 'field', label: trustLabel, action: 'trust' }), onChange: (event) => onTrustChange(event.target.value), children: [!trust ? (_jsx("option", { value: "", disabled: true, hidden: true, children: t('Select…') })) : null, trustOptions.map((option) => (_jsx("option", { value: option.value, children: t(option.label) }, option.value)))] })] })) : null, canTest && onTest ? (_jsx(SourceConfigTestControl, { running: testing, disabled: submitting || !validation.ok, onTest: onTest, ...(testResult ? { result: testResult } : {}), ...(agentHandle ? { agentHandle: sourceConfigActionHandle(agentHandle, 'test') } : {}) })) : null, submitError ? (_jsx("div", { className: "source-config-add-form-error", role: "alert", children: t(submitError) })) : null, _jsx("button", { type: "submit", className: "source-config-add-form-submit", disabled: submitting, ...sourceConfigAgentProps(agentHandle, { role: 'button', label: submitLabel, action: 'submit' }), children: submitting ? t('Adding…') : submitLabel })] }));
 }
 //# sourceMappingURL=SourceConfigAddForm.js.map

package/dist/features/source-config-list/react/components/SourceConfigAddForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"SourceConfigAddForm.js","sourceRoot":"","sources":["../../../../../src/features/source-config-list/react/components/SourceConfigAddForm.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"SourceConfigAddForm.js","sourceRoot":"","sources":["../../../../../src/features/source-config-list/react/components/SourceConfigAddForm.tsx"],"names":[],"mappings":"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"}

package/dist/features/source-config-list/react/components/SourceConfigField.d.ts

@@ -14,6 +14,19 @@ export interface SourceConfigFieldProps {
      * from before this prop existed).
      */
     idPrefix?: string;
+    /**
+     * This field's own agent handle — publishes the input/select/textarea to
+     * `@jini-ai/agentic`'s `page.*` verbs as `<agentHandle>`, and the
+     * `password`/`secret-textarea` show-hide toggle as `<agentHandle>-reveal`.
+     * A plain string, not a per-element map: the caller names the field, this
+     * component names its own parts and supplies each one's role and label,
+     * because only it knows what its own toggle does. See
+     * `../../agent-handles.ts` for the full scheme.
+     *
+     * Omit entirely and no `data-agent-*` markup is emitted at all — the
+     * rendered DOM is byte-identical to before this prop existed.
+     */
+    agentHandle?: string;
 }
 /**
  * Renders one host-described field (`text`/`url`/`password`/`select`/
@@ -23,6 +36,28 @@ export interface SourceConfigFieldProps {
  * toggle is small local disclosure state (per the vertical-slice guardrail
  * allowing that in a leaf component), ported in spirit from the origin
  * `byok/ByokKeyField.tsx`.
+ *
+ * `secret-textarea`'s reveal gate (masked + read-only until "Show" is
+ * clicked) only ever applies to a field that MOUNTED with an existing stored
+ * value — see `isLockedSecret` below. A field with nothing to protect (a
+ * brand-new/always-empty field, or one already cleared out) is immediately
+ * editable with no reveal click required; there is no secret to guard, so
+ * gating it would just block legitimate first-time entry.
+ *
+ * ## Agent handles
+ *
+ * Given `agentHandle="mcp-add-field-api-key"` this publishes:
+ *
+ * | element | handle | role |
+ * |---|---|---|
+ * | the input/select/textarea | `mcp-add-field-api-key` | `field` |
+ * | the show-hide toggle | `mcp-add-field-api-key-reveal` | `button` |
+ *
+ * Note that publishing a handle is not the same as making a field writable:
+ * `page.fill` independently refuses credential fields, so a `password`-kind
+ * field is discoverable and readable-as-ontology but still only a human can
+ * type into it. That refusal lives in `@jini-ai/agentic`'s own guards and is
+ * not something this component either grants or can route around.
  */
-export declare function SourceConfigField({ spec, value, error, disabled, idPrefix, onChange }: SourceConfigFieldProps): import("react").JSX.Element;
+export declare function SourceConfigField({ spec, value, error, disabled, idPrefix, agentHandle, onChange }: SourceConfigFieldProps): import("react").JSX.Element;
 //# sourceMappingURL=SourceConfigField.d.ts.map

package/dist/features/source-config-list/react/components/SourceConfigField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SourceConfigField.d.ts","sourceRoot":"","sources":["../../../../../src/features/source-config-list/react/components/SourceConfigField.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAgB,EAAE,QAAgC,EAAE,QAAQ,EAAE,EAAE,sBAAsB,+BAsF7I"}
+{"version":3,"file":"SourceConfigField.d.ts","sourceRoot":"","sources":["../../../../../src/features/source-config-list/react/components/SourceConfigField.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAgB,EAAE,QAAgC,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,sBAAsB,+BA2J1J"}

package/dist/features/source-config-list/react/components/SourceConfigField.js

@@ -1,6 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useState } from 'react';
+import { useEffect, useRef, useState } from 'react';
 import { useT } from '../../../i18n/index.js';
+import { sourceConfigAgentProps } from '../../agent-handles.js';
+import { maskFieldValue } from '../../rules.js';
 /**
  * Renders one host-described field (`text`/`url`/`password`/`select`/
  * `textarea`) in the add-source form (or an item card's expand-to-edit
@@ -9,13 +11,82 @@ import { useT } from '../../../i18n/index.js';
  * toggle is small local disclosure state (per the vertical-slice guardrail
  * allowing that in a leaf component), ported in spirit from the origin
  * `byok/ByokKeyField.tsx`.
+ *
+ * `secret-textarea`'s reveal gate (masked + read-only until "Show" is
+ * clicked) only ever applies to a field that MOUNTED with an existing stored
+ * value — see `isLockedSecret` below. A field with nothing to protect (a
+ * brand-new/always-empty field, or one already cleared out) is immediately
+ * editable with no reveal click required; there is no secret to guard, so
+ * gating it would just block legitimate first-time entry.
+ *
+ * ## Agent handles
+ *
+ * Given `agentHandle="mcp-add-field-api-key"` this publishes:
+ *
+ * | element | handle | role |
+ * |---|---|---|
+ * | the input/select/textarea | `mcp-add-field-api-key` | `field` |
+ * | the show-hide toggle | `mcp-add-field-api-key-reveal` | `button` |
+ *
+ * Note that publishing a handle is not the same as making a field writable:
+ * `page.fill` independently refuses credential fields, so a `password`-kind
+ * field is discoverable and readable-as-ontology but still only a human can
+ * type into it. That refusal lives in `@jini-ai/agentic`'s own guards and is
+ * not something this component either grants or can route around.
  */
-export function SourceConfigField({ spec, value, error, disabled = false, idPrefix = 'source-config-field', onChange }) {
+export function SourceConfigField({ spec, value, error, disabled = false, idPrefix = 'source-config-field', agentHandle, onChange }) {
     const t = useT();
     const [revealed, setRevealed] = useState(false);
+    // Whether THIS mount ever had a pre-existing secret to protect, captured
+    // once rather than recomputed from `value` on every render. A plain
+    // `Boolean(value)` gate would look right at first glance but re-locks the
+    // field the instant a first-time entry stops being empty — i.e. after the
+    // user's very first keystroke, since `value` goes from '' to non-empty as
+    // a DIRECT RESULT of their own typing, not because a stored secret showed
+    // up. A ref survives across renders without itself triggering one, so it
+    // can be flipped on (below, in the empty-value effect) without disturbing
+    // in-progress typing.
+    const hadStoredSecretRef = useRef(spec.kind === 'secret-textarea' && Boolean(value));
+    // Re-hide as soon as the field empties. The add form clears its values after a
+    // successful submit but keeps this component mounted, so a `revealed` left on
+    // from the previous entry meant the NEXT credential was typed into a visible
+    // `type="text"` input — a plain shoulder-surfing exposure in the ordinary
+    // add-several-sources flow, with nothing on screen to suggest it.
+    //
+    // For `secret-textarea` this also drops `hadStoredSecretRef`: once a field
+    // is empty there is nothing left to protect, so it must never re-engage the
+    // reveal gate again for the rest of this mount — whether that emptiness
+    // came from a successful submit (this component reused for the next entry)
+    // or from the user clearing an existing secret mid-edit to type a new one.
+    useEffect(() => {
+        if (!value) {
+            setRevealed(false);
+            hadStoredSecretRef.current = false;
+        }
+    }, [value]);
     const inputId = `${idPrefix}-${spec.key}`;
     const errorId = error ? `${inputId}-error` : undefined;
     const placeholder = spec.placeholder ? t(spec.placeholder) : undefined;
-    return (_jsxs("label", { className: "source-config-field", htmlFor: inputId, children: [_jsxs("span", { className: "source-config-field-label", children: [t(spec.label), spec.required ? (_jsx("span", { className: "source-config-field-required", "aria-label": t('required'), children: "*" })) : null] }), spec.kind === 'select' ? (_jsxs("select", { id: inputId, value: value, disabled: disabled, "aria-invalid": Boolean(error) || undefined, "aria-describedby": errorId, onChange: (event) => onChange(event.target.value), children: [_jsx("option", { value: "", disabled: true, hidden: true, children: placeholder ?? t('Select…') }), (spec.options ?? []).map((option) => (_jsx("option", { value: option.value, children: t(option.label) }, option.value)))] })) : spec.kind === 'textarea' ? (_jsx("textarea", { id: inputId, value: value, placeholder: placeholder, disabled: disabled, "aria-invalid": Boolean(error) || undefined, "aria-describedby": errorId, onChange: (event) => onChange(event.target.value) })) : spec.kind === 'password' ? (_jsxs("span", { className: "source-config-field-row", children: [_jsx("input", { id: inputId, type: revealed ? 'text' : 'password', value: value, placeholder: placeholder, disabled: disabled, "aria-invalid": Boolean(error) || undefined, "aria-describedby": errorId, onChange: (event) => onChange(event.target.value) }), _jsx("button", { type: "button", className: "source-config-field-toggle", disabled: disabled, onClick: () => setRevealed((current) => !current), title: revealed ? t('Hide') : t('Show'), children: revealed ? t('Hide') : t('Show') })] })) : (_jsx("input", { id: inputId, type: spec.kind === 'url' ? 'url' : 'text', value: value, placeholder: placeholder, disabled: disabled, "aria-invalid": Boolean(error) || undefined, "aria-describedby": errorId, onChange: (event) => onChange(event.target.value) })), error ? (_jsx("span", { id: errorId, className: "source-config-field-error", role: "alert", children: error })) : null] }));
+    // Gate (mask + block direct typing) only when there is an actual stored
+    // secret still un-revealed. A field with nothing to protect — first-time
+    // entry, or one already cleared out — is immediately editable, no
+    // "Show"/reveal click required.
+    const isLockedSecret = spec.kind === 'secret-textarea' && hadStoredSecretRef.current && !revealed;
+    const fieldLabel = t(spec.label);
+    const controlAgentProps = sourceConfigAgentProps(agentHandle, { role: 'field', label: fieldLabel });
+    // Labelled by the field it reveals, not by the live "Show"/"Hide" on its face: an agent label is
+    // stable page ontology, so it must not flip every time the toggle is clicked.
+    const revealAgentProps = sourceConfigAgentProps(agentHandle, {
+        role: 'button',
+        label: t('Show or hide {label}', { label: fieldLabel }),
+        action: 'reveal',
+    });
+    return (_jsxs("label", { className: "source-config-field", htmlFor: inputId, children: [_jsxs("span", { className: "source-config-field-label", children: [fieldLabel, spec.required ? (_jsx("span", { className: "source-config-field-required", "aria-label": t('required'), children: "*" })) : null] }), spec.kind === 'select' ? (_jsxs("select", { id: inputId, value: value, disabled: disabled, "aria-invalid": Boolean(error) || undefined, "aria-describedby": errorId, ...controlAgentProps, onChange: (event) => onChange(event.target.value), children: [_jsx("option", { value: "", disabled: true, hidden: true, children: placeholder ?? t('Select…') }), (spec.options ?? []).map((option) => (_jsx("option", { value: option.value, children: t(option.label) }, option.value)))] })) : spec.kind === 'textarea' || spec.kind === 'secret-textarea' ? (_jsxs("span", { className: "source-config-field-row", children: [_jsx("textarea", { id: inputId, value: isLockedSecret ? maskFieldValue(spec.kind, value) : value, placeholder: placeholder, 
+                        // A masked textarea must not be typed into — the visible text is not
+                        // the real value, so an edit would commit the mask characters.
+                        // Revealing is the way in, exactly like the password field. Only
+                        // applies when there is a stored secret to protect — see
+                        // `isLockedSecret`.
+                        readOnly: isLockedSecret, disabled: disabled, "aria-invalid": Boolean(error) || undefined, "aria-describedby": errorId, ...controlAgentProps, onChange: (event) => onChange(event.target.value) }), spec.kind === 'secret-textarea' ? (_jsx("button", { type: "button", className: "source-config-field-toggle", disabled: disabled, ...revealAgentProps, onClick: () => setRevealed((current) => !current), title: revealed ? t('Hide') : t('Show'), children: revealed ? t('Hide') : t('Show') })) : null] })) : spec.kind === 'password' ? (_jsxs("span", { className: "source-config-field-row", children: [_jsx("input", { id: inputId, type: revealed ? 'text' : 'password', value: value, placeholder: placeholder, disabled: disabled, "aria-invalid": Boolean(error) || undefined, "aria-describedby": errorId, ...controlAgentProps, onChange: (event) => onChange(event.target.value) }), _jsx("button", { type: "button", className: "source-config-field-toggle", disabled: disabled, ...revealAgentProps, onClick: () => setRevealed((current) => !current), title: revealed ? t('Hide') : t('Show'), children: revealed ? t('Hide') : t('Show') })] })) : (_jsx("input", { id: inputId, type: spec.kind === 'url' ? 'url' : 'text', value: value, placeholder: placeholder, disabled: disabled, "aria-invalid": Boolean(error) || undefined, "aria-describedby": errorId, ...controlAgentProps, onChange: (event) => onChange(event.target.value) })), error ? (_jsx("span", { id: errorId, className: "source-config-field-error", role: "alert", children: error })) : null] }));
 }
 //# sourceMappingURL=SourceConfigField.js.map

package/dist/features/source-config-list/react/components/SourceConfigField.js.map

@@ -1 +1 @@
-{"version":3,"file":"SourceConfigField.js","sourceRoot":"","sources":["../../../../../src/features/source-config-list/react/components/SourceConfigField.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"SourceConfigField.js","sourceRoot":"","sources":["../../../../../src/features/source-config-list/react/components/SourceConfigField.tsx"],"names":[],"mappings":"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"}

package/dist/features/source-config-list/react/components/SourceConfigItemCard.d.ts

@@ -1,5 +1,5 @@
-import type { SourceConfigListCapabilities } from '../hooks/useSourceConfigList.js';
 import type { SourceConfigItem, SourceFieldSpec, SourceTestResult, SourceTrustOption, SourceUpdateInput } from '../../types.js';
+import type { SourceConfigListCapabilities } from '../hooks/useSourceConfigList.js';
 export interface SourceConfigItemCardProps<TSource extends SourceConfigItem> {
     source: TSource;
     fieldSpecs: readonly SourceFieldSpec[];
@@ -18,6 +18,20 @@ export interface SourceConfigItemCardProps<TSource extends SourceConfigItem> {
     onTest: () => void;
     /** Patches this item's `label`/`enabled`/`fields`. Only ever called when `capabilities.canUpdate` is true. */
     onUpdate: (patch: SourceUpdateInput) => void;
+    /**
+     * This card's own agent handle — publishes the card and every control on it
+     * to `@jini-ai/agentic`'s `page.*` verbs. A plain string, not a per-element
+     * map: the caller names the card, this component names its own parts and
+     * supplies each one's role and label, because only it knows which of its
+     * eight-or-so controls are rendered for a given `capabilities`/expansion/
+     * edit state. Omit and no `data-agent-*` markup is emitted at all.
+     *
+     * A list renders many of these, so the caller is responsible for handing
+     * each card a DISTINCT base — two cards under the same base would publish
+     * duplicate handles and make every verb on them ambiguous. See the table
+     * below and `../../agent-handles.ts`.
+     */
+    agentHandle?: string;
 }
 /**
  * One configured source: a collapsed summary row (an always-visible
@@ -30,6 +44,29 @@ export interface SourceConfigItemCardProps<TSource extends SourceConfigItem> {
  * `McpClientSection.tsx`'s expand-to-edit `McpRow` (enable toggle + editable
  * label/fields when expanded) and `PluginsView.tsx`'s `SourcesPanel`
  * marketplace card.
+ *
+ * ## Agent handles
+ *
+ * Given `agentHandle="mcp-server-1"` this publishes, whenever the control in
+ * question is actually rendered:
+ *
+ * | element | handle | role |
+ * |---|---|---|
+ * | the card | `mcp-server-1` | `region` |
+ * | enable/disable toggle | `mcp-server-1-enabled` | `checkbox` |
+ * | expand/collapse summary | `mcp-server-1-expand` | `button` |
+ * | trust selector | `mcp-server-1-trust` | `field` |
+ * | refresh / remove | `mcp-server-1-refresh` / `-remove` | `button` |
+ * | edit / save / cancel | `mcp-server-1-edit` / `-save` / `-cancel` | `button` |
+ * | the label input (editing) | `mcp-server-1-label` | `field` |
+ * | one field (editing) | `mcp-server-1-field-<kebab-cased key>` | `field` |
+ * | the test control | `mcp-server-1-test` / `-test-status` | `button` / `status` |
+ *
+ * A caller reaching the edit fields has to `page.click` `-expand` and then
+ * `-edit` first, and re-run `page.find_elements` after each: those controls
+ * genuinely do not exist in the DOM until then, and this component owns that
+ * state privately. That sequencing is the honest shape of the card, not a
+ * limitation of the markup.
  */
-export declare function SourceConfigItemCard<TSource extends SourceConfigItem>({ source, fieldSpecs, trustOptions, capabilities, removing, refreshing, settingTrust, testing, updating, testResult, onRefresh, onRemove, onTrustChange, onTest, onUpdate, }: SourceConfigItemCardProps<TSource>): import("react").JSX.Element;
+export declare function SourceConfigItemCard<TSource extends SourceConfigItem>({ source, fieldSpecs, trustOptions, capabilities, removing, refreshing, settingTrust, testing, updating, testResult, onRefresh, onRemove, onTrustChange, onTest, onUpdate, agentHandle, }: SourceConfigItemCardProps<TSource>): import("react").JSX.Element;
 //# sourceMappingURL=SourceConfigItemCard.d.ts.map

package/dist/features/source-config-list/react/components/SourceConfigItemCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SourceConfigItemCard.d.ts","sourceRoot":"","sources":["../../../../../src/features/source-config-list/react/components/SourceConfigItemCard.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAEf,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,yBAAyB,CAAC,OAAO,SAAS,gBAAgB;IACzE,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IACvC,YAAY,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5C,YAAY,EAAE,4BAA4B,CAAC;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,iHAAiH;IACjH,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,8GAA8G;IAC9G,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,SAAS,gBAAgB,EAAE,EACrE,MAAM,EACN,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,UAAU,EACV,SAAS,EACT,QAAQ,EACR,aAAa,EACb,MAAM,EACN,QAAQ,GACT,EAAE,yBAAyB,CAAC,OAAO,CAAC,+BA8IpC"}
+{"version":3,"file":"SourceConfigItemCard.d.ts","sourceRoot":"","sources":["../../../../../src/features/source-config-list/react/components/SourceConfigItemCard.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAEf,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAEpF,MAAM,WAAW,yBAAyB,CAAC,OAAO,SAAS,gBAAgB;IACzE,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,SAAS,eAAe,EAAE,CAAC;IACvC,YAAY,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5C,YAAY,EAAE,4BAA4B,CAAC;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,iHAAiH;IACjH,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,8GAA8G;IAC9G,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC7C;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,SAAS,gBAAgB,EAAE,EACrE,MAAM,EACN,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,UAAU,EACV,SAAS,EACT,QAAQ,EACR,aAAa,EACb,MAAM,EACN,QAAQ,EACR,WAAW,GACZ,EAAE,yBAAyB,CAAC,OAAO,CAAC,+BA+MpC"}