@nomix-ai/nomix-harness 0.2.4 → 0.2.6

package/dist/kernel/client-ui-primitives/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nomix-ai/nomix-client-ui-primitives",
   "description": "Pure React atoms for the nomix web UI: controls, icons, markdown, and JSON inspectors (zero cordis)",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "publishConfig": {
     "access": "public"
   },
@@ -57,6 +57,7 @@
   "files": [
     "lib/index.js",
     "lib/invariant.js",
+    "lib/**/*.css",
     "lib/types/**/*.d.ts"
   ],
   "peerDependencies": {

package/dist/kernel/client-ui-reference/lib/client.js

@@ -0,0 +1,149 @@
+window.__ModuleLoader__.load({
+	id: "@nomix-ai/nomix-client-ui-reference",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		//#region ../../context/file-reference/src/grammar.ts
+		/**
+		* Format a selected path as prompt text. Whitespace uses the quoted
+		* `@"path"` grammar; a quoted directory keeps that quote open after its
+		* trailing slash so completion can descend another level.
+		* @param candidate - selected file or directory.
+		* @param preserveQuote - retain an explicitly opened quote even when unnecessary.
+		* @returns the insertion value, or `undefined` for a path the editor grammar cannot represent safely.
+		*/
+		function formatFileMention(candidate, preserveQuote) {
+			const path = candidate.kind === "directory" ? `${candidate.path}/` : candidate.path;
+			if (/[\u0000-\u001f\u007f-\u009f"]/u.test(path)) return void 0;
+			if (!(preserveQuote || /\s/u.test(path))) return `@${path}`;
+			if (candidate.kind === "directory") return `@"${path}`;
+			return `@"${path}"`;
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		/** `reference` namespace dictionaries for the unified `@` source. */
+		/** Dictionary namespace owned by this plugin. */
+		const NS = "reference";
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"section.files": "文件与文件夹",
+			"section.sessions": "Session 对话",
+			"candidate.file": "文件",
+			"candidate.folder": "文件夹",
+			"candidate.session": "Session",
+			"candidate.noCwd": "（无工作目录）"
+		};
+		/** English dictionary, checked complete against the zh key set. */
+		const en = {
+			"section.files": "Files & folders",
+			"section.sessions": "Session conversations",
+			"candidate.file": "File",
+			"candidate.folder": "Folder",
+			"candidate.session": "Session",
+			"candidate.noCwd": "(no cwd)"
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** Required services: the trigger registry, the Remote namespaces, and the copy. */
+		const inject = [
+			"inputTriggers",
+			"locale",
+			"remote",
+			"remote.fileReferences",
+			"remote.sessionReferenceResolver"
+		];
+		/**
+		* Register the combined `@file` / `@session` source.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "ui-reference: dictionaries");
+			const t = ctx.locale.bind(NS);
+			const source = {
+				trigger: "@",
+				name: "reference",
+				showGroupTitle: false,
+				async candidates(session, { query, quoted, signal }) {
+					const files = ctx.remote.fileReferences.list(session.sessionId, query, signal).then((result) => result.ok ? result.value : [], () => []);
+					const sessions = quoted === true ? Promise.resolve([]) : ctx.remote.sessionReferenceResolver.candidates(session.sessionId, query, signal).then((result) => result.ok ? result.value : [], () => []);
+					const [fileItems, sessionItems] = await Promise.all([files, sessions]);
+					if (signal.aborted) return [];
+					return [...fileItems.flatMap((candidate) => fileCandidate(candidate, quoted === true, t)), ...sessionItems.map((candidate) => sessionCandidate(candidate, t))];
+				},
+				onPick({ candidate }) {
+					const value = parseCandidate(candidate.value);
+					if (value?.kind === "file") return value.fileKind === "directory" ? {
+						text: value.mention,
+						continue: true
+					} : { insert: {
+						source: "reference",
+						ref: value.mention,
+						label: value.label,
+						appearance: "file",
+						clipboardText: value.mention
+					} };
+					if (value?.kind === "session") return { insert: {
+						source: "reference",
+						ref: value.mention,
+						label: value.label,
+						appearance: "session",
+						clipboardText: value.mention
+					} };
+				},
+				codec: {
+					clipboardText: (ref) => ref,
+					serialize: (ref) => Promise.resolve(ref)
+				}
+			};
+			const inputTriggers = ctx.get("inputTriggers");
+			ctx.effect(() => inputTriggers.registerSource(source), "ui-reference: @ source");
+		}
+		function fileCandidate(candidate, preserveQuote, t) {
+			const mention = formatFileMention(candidate, preserveQuote);
+			if (mention === void 0) return [];
+			const name = candidate.path.slice(candidate.path.lastIndexOf("/") + 1);
+			const directory = candidate.kind === "directory";
+			const value = {
+				kind: "file",
+				fileKind: candidate.kind,
+				label: name,
+				mention
+			};
+			return [{
+				name: `${t(directory ? "candidate.folder" : "candidate.file")} · ${name}${directory ? "/" : ""}`,
+				description: candidate.path,
+				section: t("section.files"),
+				value: JSON.stringify(value)
+			}];
+		}
+		function sessionCandidate(candidate, t) {
+			const location = candidate.cwd ?? t("candidate.noCwd");
+			const description = `${candidate.label === candidate.sessionId ? "" : `${candidate.sessionId} · `}${location} · ${new Date(candidate.createdAt).toISOString()}`;
+			const value = {
+				kind: "session",
+				label: candidate.label,
+				mention: candidate.mention
+			};
+			return {
+				name: `${t("candidate.session")} · ${candidate.label}`,
+				description,
+				section: t("section.sessions"),
+				value: JSON.stringify(value)
+			};
+		}
+		function parseCandidate(value) {
+			if (value === void 0) return void 0;
+			return JSON.parse(value);
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/dist/kernel/client-ui-reference/lib/index.js

@@ -0,0 +1,11 @@
+//#region lib/types/index.js
+/**
+* File/session reference plugin, node half. Pure UI plugin: the empty apply
+* exists so the plugin appears in the host cordis.yml / Loader; the browser
+* half ships via exports["./client"], discovered through the package.json
+* `nomix.client` declaration.
+*/
+/** Host plugin body — no host-side behavior for this source plugin. */
+function apply() {}
+//#endregion
+export { apply };

package/dist/kernel/{client-schema-form → client-ui-reference}/lib/invariant.js

@@ -1,18 +1,17 @@
 //#region lib/types/invariant.js
 /**
-* Package-owned invariant companion for `@nomix-ai/nomix-client-schema-form`.
-* @module @nomix-ai/nomix-client-schema-form/invariant
+* Package-owned invariant companion for `@nomix-ai/nomix-client-ui-reference`.
+* @module @nomix-ai/nomix-client-ui-reference/invariant
 */
-const PACKAGE_NAME = "@nomix-ai/nomix-client-schema-form";
+const PACKAGE_NAME = "@nomix-ai/nomix-client-ui-reference";
 /** Cordis companion plugin name. */
-const name = "client-schema-form-invariant";
+const name = "client-ui-reference-invariant";
 /** Service required before the companion can reserve package ownership. */
 const inject = ["invariants"];
 /**
-* No runtime invariant: a pure schema/draft helper library — it emits no
-* cordis events and owns no cross-plugin mutable relation; draft
-* immutability, schema rehydration, and path-edit round trips are asserted
-* directly by this package's model specs.
+* No runtime invariant: a single slash-source registration whose disposal is
+* proven by the HMR-safety spec — it emits no cordis events and owns no
+* cross-plugin mutable state.
 */
 const install = () => {};
 /**

package/dist/kernel/client-ui-reference/lib/types/client/index.d.ts

@@ -0,0 +1,9 @@
+import type { ClientContext } from '../../../../client-runtime/lib/client.js';
+/** Required services: the trigger registry, the Remote namespaces, and the copy. */
+export declare const inject: string[];
+/**
+ * Register the combined `@file` / `@session` source.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/kernel/client-ui-reference/lib/types/client/index.js

@@ -0,0 +1,106 @@
+import { formatFileMention } from '../../../../file-reference/lib/types/grammar.js';
+import { en, NS, zh } from "./locales.js";
+/** Required services: the trigger registry, the Remote namespaces, and the copy. */
+export const inject = [
+    'inputTriggers', 'locale', 'remote', 'remote.fileReferences', 'remote.sessionReferenceResolver',
+];
+/**
+ * Register the combined `@file` / `@session` source.
+ * @param ctx - client root context.
+ */
+export function apply(ctx) {
+    ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'ui-reference: dictionaries');
+    const t = ctx.locale.bind(NS);
+    const source = {
+        trigger: '@',
+        name: 'reference',
+        showGroupTitle: false,
+        async candidates(session, { query, quoted, signal }) {
+            const files = ctx.remote.fileReferences.list(session.sessionId, query, signal).then(result => result.ok ? result.value : [], () => []);
+            const sessions = quoted === true
+                ? Promise.resolve([])
+                : ctx.remote.sessionReferenceResolver.candidates(session.sessionId, query, signal).then(result => result.ok ? result.value : [], () => []);
+            const [fileItems, sessionItems] = await Promise.all([files, sessions]);
+            if (signal.aborted)
+                return [];
+            return [
+                ...fileItems.flatMap(candidate => fileCandidate(candidate, quoted === true, t)),
+                ...sessionItems.map(candidate => sessionCandidate(candidate, t)),
+            ];
+        },
+        onPick({ candidate }) {
+            const value = parseCandidate(candidate.value);
+            if (value?.kind === 'file') {
+                return value.fileKind === 'directory'
+                    ? { text: value.mention, continue: true }
+                    : {
+                        insert: {
+                            source: 'reference',
+                            ref: value.mention,
+                            label: value.label,
+                            appearance: 'file',
+                            clipboardText: value.mention,
+                        },
+                    };
+            }
+            if (value?.kind === 'session') {
+                return {
+                    insert: {
+                        source: 'reference',
+                        ref: value.mention,
+                        label: value.label,
+                        appearance: 'session',
+                        clipboardText: value.mention,
+                    },
+                };
+            }
+            return undefined;
+        },
+        codec: {
+            clipboardText: ref => ref,
+            serialize: ref => Promise.resolve(ref),
+        },
+    };
+    const inputTriggers = ctx.get('inputTriggers');
+    ctx.effect(() => inputTriggers.registerSource(source), 'ui-reference: @ source');
+}
+function fileCandidate(candidate, preserveQuote, t) {
+    const mention = formatFileMention(candidate, preserveQuote);
+    if (mention === undefined)
+        return [];
+    const name = candidate.path.slice(candidate.path.lastIndexOf('/') + 1);
+    const directory = candidate.kind === 'directory';
+    const value = {
+        kind: 'file',
+        fileKind: candidate.kind,
+        label: name,
+        mention,
+    };
+    return [{
+            name: `${t(directory ? 'candidate.folder' : 'candidate.file')} · ${name}${directory ? '/' : ''}`,
+            description: candidate.path,
+            section: t('section.files'),
+            value: JSON.stringify(value),
+        }];
+}
+function sessionCandidate(candidate, t) {
+    const location = candidate.cwd ?? t('candidate.noCwd');
+    const description = `${candidate.label === candidate.sessionId ? '' : `${candidate.sessionId} · `}${location} · ${new Date(candidate.createdAt).toISOString()}`;
+    const value = {
+        kind: 'session',
+        label: candidate.label,
+        mention: candidate.mention,
+    };
+    return {
+        name: `${t('candidate.session')} · ${candidate.label}`,
+        description,
+        section: t('section.sessions'),
+        value: JSON.stringify(value),
+    };
+}
+function parseCandidate(value) {
+    if (value === undefined)
+        return undefined;
+    return JSON.parse(value);
+}
+//# sourceMappingURL=index.js.map

package/dist/kernel/client-ui-reference/lib/types/client/locales.d.ts

@@ -0,0 +1,30 @@
+/** `reference` namespace dictionaries for the unified `@` source. */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "reference";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'section.files': string;
+    'section.sessions': string;
+    'candidate.file': string;
+    'candidate.folder': string;
+    'candidate.session': string;
+    'candidate.noCwd': string;
+};
+/** The reference namespace key union. */
+export type ReferenceKey = keyof typeof zh;
+declare module '@nomix-ai/nomix-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The unified `@` reference menu's copy. */
+        reference: ReferenceKey;
+    }
+}
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'section.files': string;
+    'section.sessions': string;
+    'candidate.file': string;
+    'candidate.folder': string;
+    'candidate.session': string;
+    'candidate.noCwd': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/dist/kernel/client-ui-reference/lib/types/client/locales.js

@@ -0,0 +1,22 @@
+/** `reference` namespace dictionaries for the unified `@` source. */
+/** Dictionary namespace owned by this plugin. */
+export const NS = 'reference';
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export const zh = {
+    'section.files': '文件与文件夹',
+    'section.sessions': 'Session 对话',
+    'candidate.file': '文件',
+    'candidate.folder': '文件夹',
+    'candidate.session': 'Session',
+    'candidate.noCwd': '（无工作目录）',
+};
+/** English dictionary, checked complete against the zh key set. */
+export const en = {
+    'section.files': 'Files & folders',
+    'section.sessions': 'Session conversations',
+    'candidate.file': 'File',
+    'candidate.folder': 'Folder',
+    'candidate.session': 'Session',
+    'candidate.noCwd': '(no cwd)',
+};
+//# sourceMappingURL=locales.js.map

package/dist/kernel/client-ui-reference/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * File/session reference plugin, node half. Pure UI plugin: the empty apply
+ * exists so the plugin appears in the host cordis.yml / Loader; the browser
+ * half ships via exports["./client"], discovered through the package.json
+ * `nomix.client` declaration.
+ */
+/** Host plugin body — no host-side behavior for this source plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/kernel/client-ui-reference/lib/types/index.js

@@ -0,0 +1,9 @@
+/**
+ * File/session reference plugin, node half. Pure UI plugin: the empty apply
+ * exists so the plugin appears in the host cordis.yml / Loader; the browser
+ * half ships via exports["./client"], discovered through the package.json
+ * `nomix.client` declaration.
+ */
+/** Host plugin body — no host-side behavior for this source plugin. */
+export function apply() { }
+//# sourceMappingURL=index.js.map

package/dist/kernel/{client-schema-form → client-ui-reference}/lib/types/invariant.d.ts

@@ -1,10 +1,10 @@
 /**
- * Package-owned invariant companion for `@nomix-ai/nomix-client-schema-form`.
- * @module @nomix-ai/nomix-client-schema-form/invariant
+ * Package-owned invariant companion for `@nomix-ai/nomix-client-ui-reference`.
+ * @module @nomix-ai/nomix-client-ui-reference/invariant
  */
-import type { Context } from '@nomix-ai/cordis';
+import type { Context } from '../../../cordis/lib/index.js';
 /** Cordis companion plugin name. */
-export declare const name = "client-schema-form-invariant";
+export declare const name = "client-ui-reference-invariant";
 /** Service required before the companion can reserve package ownership. */
 export declare const inject: string[];
 /**

package/dist/kernel/{client-schema-form → client-ui-reference}/lib/types/invariant.js

@@ -1,17 +1,16 @@
 /**
- * Package-owned invariant companion for `@nomix-ai/nomix-client-schema-form`.
- * @module @nomix-ai/nomix-client-schema-form/invariant
+ * Package-owned invariant companion for `@nomix-ai/nomix-client-ui-reference`.
+ * @module @nomix-ai/nomix-client-ui-reference/invariant
  */
-const PACKAGE_NAME = '@nomix-ai/nomix-client-schema-form';
+const PACKAGE_NAME = '@nomix-ai/nomix-client-ui-reference';
 /** Cordis companion plugin name. */
-export const name = 'client-schema-form-invariant';
+export const name = 'client-ui-reference-invariant';
 /** Service required before the companion can reserve package ownership. */
 export const inject = ['invariants'];
 /**
- * No runtime invariant: a pure schema/draft helper library — it emits no
- * cordis events and owns no cross-plugin mutable relation; draft
- * immutability, schema rehydration, and path-edit round trips are asserted
- * directly by this package's model specs.
+ * No runtime invariant: a single slash-source registration whose disposal is
+ * proven by the HMR-safety spec — it emits no cordis events and owns no
+ * cross-plugin mutable state.
  */
 const install = () => { };
 /**

package/dist/kernel/client-ui-reference/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@nomix-ai/nomix-client-ui-reference",
+  "description": "Unified Web @file and @session reference source",
+  "version": "0.2.6",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ditgaldev/nomix-harness.git",
+    "directory": "packages/client/ui-reference"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "nomix": {
+    "client": {
+      "inject": [
+        "@nomix-ai/nomix-client-runtime",
+        "@nomix-ai/nomix-api-remotes",
+        "@nomix-ai/nomix-client-locale",
+        "@nomix-ai/nomix-client-ui-input-trigger"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@nomix-ai/nomix-api-remotes": "workspace:^",
+    "@nomix-ai/nomix-client-locale": "workspace:^",
+    "@nomix-ai/nomix-client-runtime": "workspace:^",
+    "@nomix-ai/nomix-client-ui-input-trigger": "workspace:^",
+    "@nomix-ai/nomix-file-reference": "workspace:^",
+    "@nomix-ai/nomix-invariants": "workspace:^",
+    "@nomix-ai/nomix-session-reference": "workspace:^",
+    "@nomix-ai/nomix-typert-protocol": "workspace:^",
+    "@nomix-ai/cordis": "workspace:^"
+  },
+  "devDependencies": {
+    "@nomix-ai/nomix-api-remotes": "workspace:^",
+    "@nomix-ai/nomix-client-locale": "workspace:^",
+    "@nomix-ai/nomix-client-runtime": "workspace:^",
+    "@nomix-ai/nomix-client-ui-input-trigger": "workspace:^",
+    "@nomix-ai/nomix-client-ui-slots": "workspace:^",
+    "@nomix-ai/nomix-file-reference": "workspace:^",
+    "@nomix-ai/nomix-invariants": "workspace:^",
+    "@nomix-ai/nomix-session-reference": "workspace:^",
+    "@nomix-ai/nomix-typert-protocol": "workspace:^",
+    "@nomix-ai/cordis": "workspace:^"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ]
+}