@sanqianx/project-knowledge 4.7.0 → 5.0.0

package/_site/_test/workbench-permission-test.js

@@ -1,118 +1,118 @@
-// _site/_test/workbench-permission-test.js
-//
-// T14: Claude Workbench permission lifecycle is preserved. The backend
-// already exposes /api/claude/sessions/:id/permission (Allow/Deny) and
-// a permission-mode selector (default/acceptEdits/auto/bypassPermissions/plan).
-// This test verifies:
-//   - the permission endpoint is reachable for a real session;
-//   - the mode selector is accepted at session start;
-//   - Workbench / Workbench chat messages do NOT auto-append Development
-//     Conversation events (internal-only contract per I-06 / I-07).
-
-const assert = require('assert');
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const { spawnSync } = require('child_process');
-const { spawnServer } = require('./helpers/spawn-server');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const sitePort = 8010 + (process.pid % 200);
-const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-workbench-' + process.pid + '-'));
-const repo = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-workbench-repo-' + process.pid + '-'));
-
-function git(args) {
-  const result = spawnSync('git', ['-C', repo, ...args], {
-    encoding: 'utf8', windowsHide: true,
-    env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },
-  });
-  if (result.status !== 0) throw new Error(result.stderr || `git ${args.join(' ')} failed: ${result.status}`);
-  return String(result.stdout || '').trim();
-}
-
-async function serverFetch(url, init, timeoutMs = 10000) {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
-  try {
-    const response = await fetch(url, { ...init, signal: controller.signal });
-    const text = await response.text();
-    return { status: response.status, body: text ? JSON.parse(text) : {} };
-  } finally {
-    clearTimeout(timer);
-  }
-}
-
-(async () => {
-  git(['init', '-q', '-b', 'main']);
-  git(['config', 'user.email', 'wb@example.local']);
-  git(['config', 'user.name', 'WB']);
-  fs.writeFileSync(path.join(repo, 'README.md'), '# wb\n');
-  git(['add', 'README.md']);
-  git(['commit', '-q', '-m', 'baseline']);
-  const knowledgeRoot = path.join(dataDir, 'knowledge');
-  fs.mkdirSync(knowledgeRoot, { recursive: true });
-  const server = spawnServer({
-    root: ROOT, port: sitePort, dataDir, tag: 'wb',
-    extraEnv: { KB_AUTOMATION_FAKE_CLAUDE: '1', KB_EMBEDDING_FAKE: '1', KB_SKIP_MIGRATION: '1' },
-  });
-  try {
-    for (let attempt = 0; attempt < 100; attempt += 1) {
-      try { const r = await serverFetch(`http://127.0.0.1:${sitePort}/api/health`); if (r.body.ok) break; } catch {}
-      await new Promise(resolve => setTimeout(resolve, 100));
-    }
-    await serverFetch(`http://127.0.0.1:${sitePort}/api/settings`, {
-      method: 'PATCH', headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ knowledge: { rootPath: knowledgeRoot } }),
-    });
-    await serverFetch(`http://127.0.0.1:${sitePort}/api/ai-profiles`, {
-      method: 'PUT', headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({
-        schema: 'ai-profiles/v1', defaultProfileId: 'fake',
-        profiles: [{ id: 'fake', name: 'Fake', enabled: true, vendor: 'anthropic', model: 'fake', apiKeyUpdate: { mode: 'replace', value: 'k' } }],
-      }),
-    });
-    const importR = await serverFetch(`http://127.0.0.1:${sitePort}/api/projects/import`, {
-      method: 'POST', headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ localPath: repo, aiProfileId: 'fake' }),
-    });
-    assert.strictEqual(importR.status, 201, JSON.stringify(importR.body));
-    const projectId = importR.body.projectId;
-
-    // Case 1: permission modes are accepted at session start.
-    for (const mode of ['default', 'acceptEdits', 'auto', 'bypassPermissions', 'plan']) {
-      const r = await serverFetch(`http://127.0.0.1:${sitePort}/api/claude/sessions`, {
-        method: 'POST', headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({ projectId, permissionMode: mode }),
-      });
-      // We only assert the endpoint accepts the request; the Claude CLI
-      // binary may not be present, so the session may end up missing/idle.
-      assert(r.status === 201 || r.status === 400 || r.status === 503, `unexpected status for mode=${mode}: ${r.status}`);
-    }
-
-    // Case 2: Workbench messages MUST NOT auto-append Development
-    // Conversation events. We snapshot the conversation store via the
-    // server API and confirm no Workbench events are present for the
-    // freshly imported project.
-    const convoR = await serverFetch(`http://127.0.0.1:${sitePort}/api/conversations/projects`, undefined);
-    assert.strictEqual(convoR.status, 200);
-    // The project MAY appear in the conversation project list because
-    // import initializes the Bridge baseline cursor. What matters is
-    // that NO Workbench messages were recorded: the bridge cursor at
-    // this point is 0 (no events captured), and no turns should exist.
-    // We assert by reading the list and confirming the entry's
-    // lastCapturedCursor is 0.
-    const entry = (convoR.body.projects || []).find(p => p.projectId === projectId);
-    if (entry) {
-      assert.strictEqual(entry.lastCapturedCursor || 0, 0, 'Bridge cursor must be 0 for a project with no Bridge events');
-    }
-  } finally {
-    server.child.kill();
-    await new Promise(resolve => server.child.once('exit', resolve));
-    fs.rmSync(dataDir, { recursive: true, force: true });
-    fs.rmSync(repo, { recursive: true, force: true });
-  }
-  console.log('workbench-permission-test PASS');
-})().catch(error => {
-  console.error(error.stack || error.message);
-  process.exit(1);
+// _site/_test/workbench-permission-test.js
+//
+// T14: Claude Workbench permission lifecycle is preserved. The backend
+// already exposes /api/claude/sessions/:id/permission (Allow/Deny) and
+// a permission-mode selector (default/acceptEdits/auto/bypassPermissions/plan).
+// This test verifies:
+//   - the permission endpoint is reachable for a real session;
+//   - the mode selector is accepted at session start;
+//   - Workbench / Workbench chat messages do NOT auto-append Development
+//     Conversation events (internal-only contract per I-06 / I-07).
+
+const assert = require('assert');
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const { spawnSync } = require('child_process');
+const { spawnServer } = require('./helpers/spawn-server');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const sitePort = 8010 + (process.pid % 200);
+const dataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-workbench-' + process.pid + '-'));
+const repo = fs.mkdtempSync(path.join(os.tmpdir(), 'pk-workbench-repo-' + process.pid + '-'));
+
+function git(args) {
+  const result = spawnSync('git', ['-C', repo, ...args], {
+    encoding: 'utf8', windowsHide: true,
+    env: { ...process.env, GIT_TERMINAL_PROMPT: '0' },
+  });
+  if (result.status !== 0) throw new Error(result.stderr || `git ${args.join(' ')} failed: ${result.status}`);
+  return String(result.stdout || '').trim();
+}
+
+async function serverFetch(url, init, timeoutMs = 10000) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const response = await fetch(url, { ...init, signal: controller.signal });
+    const text = await response.text();
+    return { status: response.status, body: text ? JSON.parse(text) : {} };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+(async () => {
+  git(['init', '-q', '-b', 'main']);
+  git(['config', 'user.email', 'wb@example.local']);
+  git(['config', 'user.name', 'WB']);
+  fs.writeFileSync(path.join(repo, 'README.md'), '# wb\n');
+  git(['add', 'README.md']);
+  git(['commit', '-q', '-m', 'baseline']);
+  const knowledgeRoot = path.join(dataDir, 'knowledge');
+  fs.mkdirSync(knowledgeRoot, { recursive: true });
+  const server = spawnServer({
+    root: ROOT, port: sitePort, dataDir, tag: 'wb',
+    extraEnv: { KB_AUTOMATION_FAKE_CLAUDE: '1', KB_EMBEDDING_FAKE: '1', KB_SKIP_MIGRATION: '1' },
+  });
+  try {
+    for (let attempt = 0; attempt < 100; attempt += 1) {
+      try { const r = await serverFetch(`http://127.0.0.1:${sitePort}/api/health`); if (r.body.ok) break; } catch {}
+      await new Promise(resolve => setTimeout(resolve, 100));
+    }
+    await serverFetch(`http://127.0.0.1:${sitePort}/api/settings`, {
+      method: 'PATCH', headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ knowledge: { rootPath: knowledgeRoot } }),
+    });
+    await serverFetch(`http://127.0.0.1:${sitePort}/api/ai-profiles`, {
+      method: 'PUT', headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({
+        schema: 'ai-profiles/v1', defaultProfileId: 'fake',
+        profiles: [{ id: 'fake', name: 'Fake', enabled: true, vendor: 'anthropic', model: 'fake', apiKeyUpdate: { mode: 'replace', value: 'k' } }],
+      }),
+    });
+    const importR = await serverFetch(`http://127.0.0.1:${sitePort}/api/projects/import`, {
+      method: 'POST', headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ localPath: repo, aiProfileId: 'fake' }),
+    });
+    assert.strictEqual(importR.status, 201, JSON.stringify(importR.body));
+    const projectId = importR.body.projectId;
+
+    // Case 1: permission modes are accepted at session start.
+    for (const mode of ['default', 'acceptEdits', 'auto', 'bypassPermissions', 'plan']) {
+      const r = await serverFetch(`http://127.0.0.1:${sitePort}/api/claude/sessions`, {
+        method: 'POST', headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ projectId, permissionMode: mode }),
+      });
+      // We only assert the endpoint accepts the request; the Claude CLI
+      // binary may not be present, so the session may end up missing/idle.
+      assert(r.status === 201 || r.status === 400 || r.status === 503, `unexpected status for mode=${mode}: ${r.status}`);
+    }
+
+    // Case 2: Workbench messages MUST NOT auto-append Development
+    // Conversation events. We snapshot the conversation store via the
+    // server API and confirm no Workbench events are present for the
+    // freshly imported project.
+    const convoR = await serverFetch(`http://127.0.0.1:${sitePort}/api/conversations/projects`, undefined);
+    assert.strictEqual(convoR.status, 200);
+    // The project MAY appear in the conversation project list because
+    // import initializes the Bridge baseline cursor. What matters is
+    // that NO Workbench messages were recorded: the bridge cursor at
+    // this point is 0 (no events captured), and no turns should exist.
+    // We assert by reading the list and confirming the entry's
+    // lastCapturedCursor is 0.
+    const entry = (convoR.body.projects || []).find(p => p.projectId === projectId);
+    if (entry) {
+      assert.strictEqual(entry.lastCapturedCursor || 0, 0, 'Bridge cursor must be 0 for a project with no Bridge events');
+    }
+  } finally {
+    server.child.kill();
+    await new Promise(resolve => server.child.once('exit', resolve));
+    fs.rmSync(dataDir, { recursive: true, force: true });
+    fs.rmSync(repo, { recursive: true, force: true });
+  }
+  console.log('workbench-permission-test PASS');
+})().catch(error => {
+  console.error(error.stack || error.message);
+  process.exit(1);
 });

package/_site/_test/workspace-ui-contract-test.js

@@ -1,43 +1,28 @@
-const assert = require('assert');
-const fs = require('fs');
-const path = require('path');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const html = fs.readFileSync(path.join(ROOT, 'ui', 'index.html'), 'utf8');
-const css = fs.readFileSync(path.join(ROOT, 'ui', 'app.css'), 'utf8');
-const script = fs.readFileSync(path.join(ROOT, 'ui', 'app.js'), 'utf8');
-
-for (const contract of [
-  'id="project-list"',
-  'id="view-terminal"',
-  'id="view-search"',
-  'id="view-import"',
-  'id="settings-drawer"',
-  'data-settings="logs"',
-  'id="delete-dialog"',
-]) assert(html.includes(contract), 'missing v13 shell contract: ' + contract);
-
-const desktopNav = html.slice(html.indexOf('<aside class="sidebar">'), html.indexOf('</aside>'));
-assert(desktopNav.includes('data-go="terminal"') && desktopNav.includes('data-go="search"') && desktopNav.includes('data-go="import"'));
-assert(!/开发对话|运行记录|系统日志/.test(desktopNav), 'conversation and logs must not be duplicated in main navigation');
-assert(!html.includes('data-install-hook') && !html.includes('data-analyze') && !html.includes('data-simulate'), 'manual Hook/analysis controls are forbidden');
-
-// 开发对话已迁移到 ai-coding-event-bridge 模块，设置抽屉不再保留该入口
-assert(!html.includes('data-settings="conversation"') && !html.includes('settings-conversation') && !html.includes('conversation-project'), 'development-conversation settings entry must be absent (moved to event-bridge module)');
-
-for (const required of ['logs-date', 'logs-project', 'logs-scope', 'logs-limit', 'logs-search', 'logs-export']) assert(html.includes(`id="${required}"`), 'missing logs toolbar control: ' + required);
-for (const forbidden of ['pause-button', 'level-filter', 'setting-retention', 'setting-capacity', 'health-pill', 'data-log-table']) assert(!html.includes(forbidden), 'legacy logs-only control must be absent: ' + forbidden);
-assert(!/>Level</i.test(html) && !/>级别</i.test(html.slice(html.indexOf('class="record-toolbar"'), html.indexOf('class="record-shell"'))), 'logs toolbar must not expose a level filter/column');
-
-assert(css.includes('grid-template-columns:minmax(0,1fr) 88px') && css.includes('grid-template-columns:minmax(0,1fr) 76px'), 'desktop/mobile log row geometry is required');
-assert(css.includes('.record-list{flex:1;min-height:0;max-height:none;overflow-y:auto;overflow-x:hidden}'), 'record list must own logs scrolling');
-assert(!css.includes('max-height:520px'), 'fixed legacy record height is forbidden');
-for (const level of ['warn', 'error', 'fatal']) assert(css.includes(`[data-level="${level}"]`), 'whole-row severity color missing: ' + level);
-assert(css.includes('html[data-theme="dark"]') && css.includes('@media(max-width:760px)'), 'dark and responsive layouts are required');
-
-assert(!script.includes('.innerHTML') && !script.includes('insertAdjacentHTML'), 'business data must never render through an HTML sink');
-assert(script.includes('.textContent = record.message') && script.includes('.textContent = value'), 'logs must render as plain text');
-assert(script.includes("stream.addEventListener('logs/appended'") && script.includes('state.newLogs += 1'), 'SSE append/new-record behavior is required');
-assert(script.includes('window.__PK_APP__'), 'browser test surface is required');
-
-console.log('workspace UI contract test PASS');
+'use strict';
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+const path = require('node:path');
+const root = path.resolve(__dirname, '../..');
+const html = fs.readFileSync(path.join(root, 'ui/index.html'), 'utf8');
+const script = fs.readFileSync(path.join(root, 'ui/product.js'), 'utf8');
+const css = fs.readFileSync(path.join(root, 'ui/product.css'), 'utf8');
+for (const view of ['home', 'work', 'search', 'memory', 'projects', 'activity']) {
+  assert.equal((html.match(new RegExp(`data-view="${view}"`, 'g')) || []).length, 1);
+  assert.ok(html.includes(`id="view-${view}"`));
+}
+assert.equal((html.match(/data-view=/g) || []).length, 6, 'diagnostics must not become another primary product');
+for (const id of ['workFrame', 'vectorFrame', 'bridgeFrame', 'engineFrame', 'importDialog', 'importCode', 'importKnowledge', 'importDomain', 'setupImportRoot', 'createDomain', 'logsDialog', 'systemDrawer', 'copyReference']) assert.equal((html.match(new RegExp(`id="${id}"`, 'g')) || []).length, 1);
+assert.ok(html.includes('data-action="import"') && html.includes('不分析全部历史'));
+assert.ok(!html.includes('srcdoc') && !/data-simulate|data-analyze|data-install-hook/.test(html));
+assert.equal((script.match(/\.src = /g) || []).length, 1, 'frames initialize once, not on project/theme/page changes');
+for (const contract of ['kb:theme', 'kb:select-project', 'kb:scope', 'kb:knowledge', 'kb:ready']) assert.ok(script.includes(contract));
+assert.ok(script.includes('event.origin !== location.origin') && script.includes('contentWindow === event.source'), 'module messages must be from the expected frame and origin');
+assert.ok(script.includes('state.epoch++') && script.includes('referenceEpoch') && script.includes('logEpoch'), 'late project/reference/log feedback must be isolated');
+assert.ok(script.includes('esc(r.title)') && script.includes('esc(m.text)') && script.includes('esc(project.name)'));
+assert.ok(script.includes('text.textContent = record.message') && script.includes("'logs/appended'"), 'diagnostics stay inert and stream live');
+assert.ok(script.includes('URL.revokeObjectURL(url)') && script.includes('logStream?.close()'));
+assert.ok(script.includes('resumeImport = true') && script.includes("$('importDialog').showModal()") && script.includes("p.code === 'KNOWLEDGE_ROOT_MISSING'"), 'first import can return from setup without resetting its input');
+assert.ok(css.includes('height:100%') && css.includes('.view.module-view{padding:0;overflow:hidden}') && css.includes('overflow-wrap:anywhere'));
+assert.ok(css.includes('html[data-theme=dark]') && css.includes('prefers-reduced-motion'));
+assert.doesNotThrow(() => new Function(script));
+console.log('workspace UI contract test PASS (source contract; not browser acceptance)');

package/_site/lib/ai-profile-resolver.js

@@ -1,78 +1,78 @@
-// _site/lib/ai-profile-resolver.js
-//
-// Single source of truth for "what AI profile does this project use right now".
-// Replaces the inconsistent fallback logic that used to live separately in
-// Workbench start-session / send-input, the analyzer, the CommitReconciler,
-// and import default assignment.
-//
-// Resolution order (per T01):
-//   1. projectConfig.aiProfileId, when it references a usable configured profile
-//   2. settings.ai.defaultProfileId, when it references a usable configured profile
-//   3. first usable configured profile in stable configured order
-//   4. otherwise an explicit AI_PROFILE_REQUIRED failure
-//
-// "Usable" matches the current runtime's minimum contract: the profile exists,
-// is enabled, and references a vendor/implementation that the runtime can use.
-// We do NOT invent additional requirements (e.g. "must have a non-empty apiKey")
-// — that is the runtime's job to evaluate when it actually starts a session.
-
-const { DomainError } = require('./contracts');
-
-function profileById(settings, profileId) {
-  if (!profileId) return null;
-  const list = settings && settings.ai && Array.isArray(settings.ai.profiles) ? settings.ai.profiles : [];
-  return list.find(profile => profile && profile.id === profileId) || null;
-}
-
-function isUsable(profile) {
-  return Boolean(profile) && profile.enabled !== false;
-}
-
-function listUsable(settings) {
-  const list = settings && settings.ai && Array.isArray(settings.ai.profiles) ? settings.ai.profiles : [];
-  return list.filter(isUsable);
-}
-
-function resolveEffectiveAiProfile(settings, projectConfig) {
-  const safeSettings = settings || { ai: { profiles: [] } };
-  const safeProject = projectConfig || {};
-  const configured = safeSettings.ai && Array.isArray(safeSettings.ai.profiles) ? safeSettings.ai.profiles : [];
-
-  const projectId = safeProject.aiProfileId || null;
-  if (projectId) {
-    const projectProfile = profileById(safeSettings, projectId);
-    if (isUsable(projectProfile)) {
-      return { profile: projectProfile, profileId: projectProfile.id, source: 'project' };
-    }
-  }
-
-  const defaultId = safeSettings.ai && safeSettings.ai.defaultProfileId || null;
-  if (defaultId) {
-    const defaultProfile = profileById(safeSettings, defaultId);
-    if (isUsable(defaultProfile)) {
-      return { profile: defaultProfile, profileId: defaultProfile.id, source: 'default' };
-    }
-  }
-
-  const firstUsable = listUsable(safeSettings)[0];
-  if (firstUsable) {
-    return { profile: firstUsable, profileId: firstUsable.id, source: 'first-usable' };
-  }
-
-  throw new DomainError('AI_PROFILE_REQUIRED', 'A usable AI profile is required for this operation.', {
-    status: 409,
-    details: {
-      hint: 'Configure at least one enabled AI profile, or assign an aiProfileId to the project.',
-      configuredProfileCount: configured.length,
-      projectProfileId: projectId || null,
-      defaultProfileId: defaultId || null,
-    },
-  });
-}
-
-module.exports = {
-  resolveEffectiveAiProfile,
-  profileById,
-  isUsable,
-  listUsable,
-};
+// _site/lib/ai-profile-resolver.js
+//
+// Single source of truth for "what AI profile does this project use right now".
+// Replaces the inconsistent fallback logic that used to live separately in
+// Workbench start-session / send-input, the analyzer, the CommitReconciler,
+// and import default assignment.
+//
+// Resolution order (per T01):
+//   1. projectConfig.aiProfileId, when it references a usable configured profile
+//   2. settings.ai.defaultProfileId, when it references a usable configured profile
+//   3. first usable configured profile in stable configured order
+//   4. otherwise an explicit AI_PROFILE_REQUIRED failure
+//
+// "Usable" matches the current runtime's minimum contract: the profile exists,
+// is enabled, and references a vendor/implementation that the runtime can use.
+// We do NOT invent additional requirements (e.g. "must have a non-empty apiKey")
+// — that is the runtime's job to evaluate when it actually starts a session.
+
+const { DomainError } = require('./contracts');
+
+function profileById(settings, profileId) {
+  if (!profileId) return null;
+  const list = settings && settings.ai && Array.isArray(settings.ai.profiles) ? settings.ai.profiles : [];
+  return list.find(profile => profile && profile.id === profileId) || null;
+}
+
+function isUsable(profile) {
+  return Boolean(profile) && profile.enabled !== false;
+}
+
+function listUsable(settings) {
+  const list = settings && settings.ai && Array.isArray(settings.ai.profiles) ? settings.ai.profiles : [];
+  return list.filter(isUsable);
+}
+
+function resolveEffectiveAiProfile(settings, projectConfig) {
+  const safeSettings = settings || { ai: { profiles: [] } };
+  const safeProject = projectConfig || {};
+  const configured = safeSettings.ai && Array.isArray(safeSettings.ai.profiles) ? safeSettings.ai.profiles : [];
+
+  const projectId = safeProject.aiProfileId || null;
+  if (projectId) {
+    const projectProfile = profileById(safeSettings, projectId);
+    if (isUsable(projectProfile)) {
+      return { profile: projectProfile, profileId: projectProfile.id, source: 'project' };
+    }
+  }
+
+  const defaultId = safeSettings.ai && safeSettings.ai.defaultProfileId || null;
+  if (defaultId) {
+    const defaultProfile = profileById(safeSettings, defaultId);
+    if (isUsable(defaultProfile)) {
+      return { profile: defaultProfile, profileId: defaultProfile.id, source: 'default' };
+    }
+  }
+
+  const firstUsable = listUsable(safeSettings)[0];
+  if (firstUsable) {
+    return { profile: firstUsable, profileId: firstUsable.id, source: 'first-usable' };
+  }
+
+  throw new DomainError('AI_PROFILE_REQUIRED', 'A usable AI profile is required for this operation.', {
+    status: 409,
+    details: {
+      hint: 'Configure at least one enabled AI profile, or assign an aiProfileId to the project.',
+      configuredProfileCount: configured.length,
+      projectProfileId: projectId || null,
+      defaultProfileId: defaultId || null,
+    },
+  });
+}
+
+module.exports = {
+  resolveEffectiveAiProfile,
+  profileById,
+  isUsable,
+  listUsable,
+};