@harborclient/core 0.1.1

package/dist/scripting/scriptResponseDocument.js

@@ -0,0 +1,49 @@
+import * as cheerio from 'cheerio';
+/**
+ * Wraps a Cheerio element selection as a plain object safe for the SES sandbox.
+ *
+ * @param selection - Cheerio wrapper around one or more parsed nodes.
+ * @returns Element facade, or null when the selection is empty.
+ */
+function wrapElement(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Cheerio node type is internal to the parser
+selection) {
+    if (selection.length === 0) {
+        return null;
+    }
+    return {
+        get textContent() {
+            return selection.text();
+        },
+        getAttribute: (name) => selection.attr(name) ?? null,
+        get innerHTML() {
+            return selection.html() ?? '';
+        }
+    };
+}
+/**
+ * Parses an HTML response body into a DOM-like document facade for script sandboxes.
+ *
+ * Uses Cheerio under the hood; returned objects are plain facades without exposing
+ * the Cheerio instance to user scripts.
+ *
+ * @param html - Raw response body string.
+ * @returns Document with querySelector helpers.
+ */
+export function parseResponseDocument(html) {
+    const $ = cheerio.load(html);
+    return {
+        querySelector: (selector) => wrapElement($(selector).first()),
+        querySelectorAll: (selector) => {
+            const matches = [];
+            $(selector).each((_index, node) => {
+                const facade = wrapElement($(node));
+                if (facade) {
+                    matches.push(facade);
+                }
+            });
+            return matches;
+        }
+    };
+}
+//# sourceMappingURL=scriptResponseDocument.js.map

package/dist/scripting/scriptResponseDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptResponseDocument.js","sourceRoot":"","sources":["../../src/scripting/scriptResponseDocument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AA2CnC;;;;;GAKG;AACH,SAAS,WAAW;AAClB,6GAA6G;AAC7G,SAA+B;IAE/B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,WAAW;YACb,OAAO,SAAS,CAAC,IAAI,EAAE,CAAC;QAC1B,CAAC;QACD,YAAY,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI;QAC5D,IAAI,SAAS;YACX,OAAO,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7B,OAAO;QACL,aAAa,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,CAAC;QACrE,gBAAgB,EAAE,CAAC,QAAgB,EAAE,EAAE;YACrC,MAAM,OAAO,GAA0B,EAAE,CAAC;YAC1C,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;gBAChC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBACpC,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/scripting/scriptRunner.d.ts

@@ -0,0 +1,2 @@
+import 'ses';
+//# sourceMappingURL=scriptRunner.d.ts.map

package/dist/scripting/scriptRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptRunner.d.ts","sourceRoot":"","sources":["../../src/scripting/scriptRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC"}

package/dist/scripting/scriptRunner.js

@@ -0,0 +1,132 @@
+import 'ses';
+import { evaluateScript } from './scriptEvaluator';
+lockdown();
+const utilityProcess = process;
+let nextNetId = 1;
+const pendingNetworkCalls = new Map();
+let nextFileId = 1;
+const pendingFileCalls = new Map();
+/**
+ * Rejects every pending hc.sendRequest promise when the runner shuts down.
+ *
+ * @param message - Error message applied to each pending network call.
+ */
+function rejectAllPendingNetworkCalls(message) {
+    for (const pending of pendingNetworkCalls.values()) {
+        pending.reject(new Error(message));
+    }
+    pendingNetworkCalls.clear();
+}
+/**
+ * Rejects every pending hc.fs / hc.parse promise when the runner shuts down.
+ *
+ * @param message - Error message applied to each pending file call.
+ */
+function rejectAllPendingFileCalls(message) {
+    for (const pending of pendingFileCalls.values()) {
+        pending.reject(new Error(message));
+    }
+    pendingFileCalls.clear();
+}
+/**
+ * Builds the hc.sendRequest transport that bridges to the main process runner host.
+ *
+ * @param runId - Correlation id for the active script run message.
+ * @returns Async send function injected into the script sandbox.
+ */
+function createNetworkTransport(runId) {
+    return (req) => new Promise((resolve, reject) => {
+        const port = utilityProcess.parentPort;
+        if (!port) {
+            reject(new Error('Script network bridge is unavailable'));
+            return;
+        }
+        const netId = nextNetId++;
+        pendingNetworkCalls.set(netId, { resolve, reject });
+        port.postMessage({ kind: 'net', runId, netId, req });
+    });
+}
+/**
+ * Builds the hc.fs / hc.parse transport that bridges to the main process runner host.
+ *
+ * @param runId - Correlation id for the active script run message.
+ * @returns Async file-bridge function injected into the script sandbox.
+ */
+function createFileTransport(runId) {
+    return (req) => new Promise((resolve, reject) => {
+        const port = utilityProcess.parentPort;
+        if (!port) {
+            reject(new Error('Script file bridge is unavailable'));
+            return;
+        }
+        const fileId = nextFileId++;
+        pendingFileCalls.set(fileId, { resolve, reject });
+        port.postMessage({ kind: 'file', runId, fileId, req });
+    });
+}
+/**
+ * Handles a single script run request from the main process.
+ *
+ * @param message - Correlation id and script input payload.
+ */
+async function handleRunMessage(message) {
+    const port = utilityProcess.parentPort;
+    if (!port) {
+        return;
+    }
+    try {
+        const result = await evaluateScript(message.input, {
+            sendRequest: createNetworkTransport(message.id),
+            fileBridge: createFileTransport(message.id)
+        });
+        const reply = { id: message.id, ok: true, result };
+        port.postMessage(reply);
+    }
+    catch (err) {
+        const rawMessage = err && typeof err === 'object' && 'message' in err
+            ? String(err.message)
+            : String(err);
+        const reply = { id: message.id, ok: false, error: rawMessage };
+        port.postMessage(reply);
+    }
+}
+const port = utilityProcess.parentPort;
+if (port) {
+    port.on('message', (event) => {
+        const message = event.data;
+        if ('kind' in message && message.kind === 'net-reply') {
+            const pending = pendingNetworkCalls.get(message.netId);
+            if (!pending) {
+                return;
+            }
+            pendingNetworkCalls.delete(message.netId);
+            if (message.ok) {
+                pending.resolve(message.result);
+            }
+            else {
+                pending.reject(new Error(message.error));
+            }
+            return;
+        }
+        if ('kind' in message && message.kind === 'file-reply') {
+            const pending = pendingFileCalls.get(message.fileId);
+            if (!pending) {
+                return;
+            }
+            pendingFileCalls.delete(message.fileId);
+            if (message.ok) {
+                pending.resolve(message.result);
+            }
+            else {
+                pending.reject(new Error(message.error));
+            }
+            return;
+        }
+        void handleRunMessage(message);
+    });
+}
+process.on('exit', () => {
+    rejectAllPendingNetworkCalls('Script runner exited');
+    rejectAllPendingFileCalls('Script runner exited');
+});
+//# sourceMappingURL=scriptRunner.js.map

package/dist/scripting/scriptRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptRunner.js","sourceRoot":"","sources":["../../src/scripting/scriptRunner.ts"],"names":[],"mappings":"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"}

package/dist/scripting/scriptSnippetBundler.d.ts

@@ -0,0 +1,46 @@
+import { type Plugin } from 'esbuild';
+/** Virtual path of the running script entry module. */
+export declare const SCRIPT_ENTRY_VIRTUAL_PATH = "/__entry__.js";
+/**
+ * Returns whether user script source uses ESM import or export syntax.
+ *
+ * Used to choose the bundling path; false positives only skip an unnecessary
+ * fast path, while false negatives would fail esbuild transform instead.
+ *
+ * @param source - Raw user-authored script source.
+ * @returns True when the source likely contains module syntax.
+ */
+export declare function scriptUsesModuleSyntax(source: string): boolean;
+/**
+ * Resolves a relative import specifier against a virtual snippet filesystem path.
+ *
+ * @param importerPath - Absolute virtual path of the importing module.
+ * @param specifier - Relative import string from the import statement.
+ * @returns Normalized snippet filename key (no leading slash).
+ */
+export declare function resolveSnippetImportPath(importerPath: string, specifier: string): string;
+/**
+ * Builds an esbuild plugin that resolves relative imports against snippet modules.
+ *
+ * @param entrySource - JavaScript source for the running script slot.
+ * @param modules - Snippet sources keyed by import filename.
+ * @param conflicts - Filenames that map to more than one snippet row.
+ * @returns esbuild plugin for virtual entry and snippet modules.
+ */
+export declare function createSnippetImportPlugin(entrySource: string, modules: Record<string, string>, conflicts: string[]): Plugin;
+/**
+ * Bundles a user script and its relative snippet imports into a single ESM file.
+ *
+ * The synthetic stdin entry side-effect-imports the user script so top-level
+ * exports in the entry are internalized by the bundler while entry statements
+ * still execute.
+ *
+ * @param source - Raw user-authored script source for the running slot.
+ * @param modules - Snippet sources keyed by import filename.
+ * @param conflicts - Filenames that map to more than one snippet row.
+ * @returns Bundled JavaScript with imports resolved and inlined, or an empty string
+ * when the entry module only exports bindings with no top-level side effects.
+ * @throws esbuild build errors when the script or imports are invalid.
+ */
+export declare function bundleUserScript(source: string, modules: Record<string, string>, conflicts: string[]): Promise<string>;
+//# sourceMappingURL=scriptSnippetBundler.d.ts.map

package/dist/scripting/scriptSnippetBundler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptSnippetBundler.d.ts","sourceRoot":"","sources":["../../src/scripting/scriptSnippetBundler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAM7C,uDAAuD;AACvD,eAAO,MAAM,yBAAyB,kBAAkB,CAAC;AAQzD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxF;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,SAAS,EAAE,MAAM,EAAE,GAClB,MAAM,CAkER;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,MAAM,CAAC,CA0BjB"}

package/dist/scripting/scriptSnippetBundler.js

@@ -0,0 +1,136 @@
+import { build } from 'esbuild';
+import { dirname, join, normalize as posixNormalize } from 'node:path';
+/** esbuild target for bundled user script output. */
+const SCRIPT_BUNDLE_TARGET = 'es2022';
+/** Virtual path of the running script entry module. */
+export const SCRIPT_ENTRY_VIRTUAL_PATH = '/__entry__.js';
+/** esbuild namespace for the user script entry module. */
+const ENTRY_NAMESPACE = 'hc-entry';
+/** esbuild namespace for resolved snippet modules. */
+const SNIPPET_NAMESPACE = 'hc-snippet';
+/**
+ * Returns whether user script source uses ESM import or export syntax.
+ *
+ * Used to choose the bundling path; false positives only skip an unnecessary
+ * fast path, while false negatives would fail esbuild transform instead.
+ *
+ * @param source - Raw user-authored script source.
+ * @returns True when the source likely contains module syntax.
+ */
+export function scriptUsesModuleSyntax(source) {
+    return /\b(import\s*(?:[\w*{]|['"]|\.|\/)|export\s*(?:default|[\w*{]))/.test(source);
+}
+/**
+ * Resolves a relative import specifier against a virtual snippet filesystem path.
+ *
+ * @param importerPath - Absolute virtual path of the importing module.
+ * @param specifier - Relative import string from the import statement.
+ * @returns Normalized snippet filename key (no leading slash).
+ */
+export function resolveSnippetImportPath(importerPath, specifier) {
+    const joined = posixNormalize(join(dirname(importerPath), specifier));
+    return joined.replace(/^\//, '');
+}
+/**
+ * Builds an esbuild plugin that resolves relative imports against snippet modules.
+ *
+ * @param entrySource - JavaScript source for the running script slot.
+ * @param modules - Snippet sources keyed by import filename.
+ * @param conflicts - Filenames that map to more than one snippet row.
+ * @returns esbuild plugin for virtual entry and snippet modules.
+ */
+export function createSnippetImportPlugin(entrySource, modules, conflicts) {
+    const conflictSet = new Set(conflicts);
+    /**
+     * Loads snippet source or returns a descriptive resolve/load error.
+     *
+     * @param snippetKey - Normalized snippet filename key.
+     * @returns esbuild onLoad result with snippet source or an error.
+     */
+    const loadSnippetByKey = (snippetKey) => {
+        if (conflictSet.has(snippetKey)) {
+            return {
+                errors: [{ text: `Ambiguous import: multiple modules named "${snippetKey}"` }]
+            };
+        }
+        const source = modules[snippetKey];
+        if (source === undefined) {
+            return {
+                errors: [{ text: `Cannot find module "${snippetKey}"` }]
+            };
+        }
+        return { contents: source, loader: 'js' };
+    };
+    return {
+        name: 'hc-snippet-import',
+        setup(buildContext) {
+            buildContext.onResolve({ filter: /^\.\/__entry__\.js$/ }, () => ({
+                path: SCRIPT_ENTRY_VIRTUAL_PATH,
+                namespace: ENTRY_NAMESPACE
+            }));
+            buildContext.onResolve({ filter: /^\.\.?\//, namespace: ENTRY_NAMESPACE }, (args) => ({
+                path: `/${resolveSnippetImportPath(args.importer, args.path)}`,
+                namespace: SNIPPET_NAMESPACE
+            }));
+            buildContext.onResolve({ filter: /^\.\.?\//, namespace: SNIPPET_NAMESPACE }, (args) => ({
+                path: `/${resolveSnippetImportPath(args.importer, args.path)}`,
+                namespace: SNIPPET_NAMESPACE
+            }));
+            buildContext.onResolve({ filter: /^[^./]/, namespace: ENTRY_NAMESPACE }, (args) => ({
+                errors: [{ text: `Package imports are not supported yet: "${args.path}"` }]
+            }));
+            buildContext.onResolve({ filter: /^[^./]/, namespace: SNIPPET_NAMESPACE }, (args) => ({
+                errors: [{ text: `Package imports are not supported yet: "${args.path}"` }]
+            }));
+            buildContext.onLoad({ filter: /.*/, namespace: ENTRY_NAMESPACE }, () => ({
+                contents: entrySource,
+                loader: 'js',
+                resolveDir: '/'
+            }));
+            buildContext.onLoad({ filter: /.*/, namespace: SNIPPET_NAMESPACE }, (args) => {
+                const snippetKey = args.path.replace(/^\//, '');
+                return loadSnippetByKey(snippetKey);
+            });
+        }
+    };
+}
+/**
+ * Bundles a user script and its relative snippet imports into a single ESM file.
+ *
+ * The synthetic stdin entry side-effect-imports the user script so top-level
+ * exports in the entry are internalized by the bundler while entry statements
+ * still execute.
+ *
+ * @param source - Raw user-authored script source for the running slot.
+ * @param modules - Snippet sources keyed by import filename.
+ * @param conflicts - Filenames that map to more than one snippet row.
+ * @returns Bundled JavaScript with imports resolved and inlined, or an empty string
+ * when the entry module only exports bindings with no top-level side effects.
+ * @throws esbuild build errors when the script or imports are invalid.
+ */
+export async function bundleUserScript(source, modules, conflicts) {
+    const result = await build({
+        stdin: {
+            contents: 'import "./__entry__.js";',
+            loader: 'js',
+            resolveDir: '/',
+            sourcefile: 'script-entry.js'
+        },
+        bundle: true,
+        format: 'esm',
+        platform: 'neutral',
+        target: SCRIPT_BUNDLE_TARGET,
+        write: false,
+        logLevel: 'silent',
+        treeShaking: true,
+        plugins: [createSnippetImportPlugin(source, modules, conflicts)]
+    });
+    const output = result.outputFiles[0]?.text ?? '';
+    if (!output.trim()) {
+        // Export-only entry modules (no top-level side effects) tree-shake to empty
+        // output; that is valid when the slot runs as a helper library, not an error.
+        return '';
+    }
+    return output;
+}
+//# sourceMappingURL=scriptSnippetBundler.js.map

package/dist/scripting/scriptSnippetBundler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptSnippetBundler.js","sourceRoot":"","sources":["../../src/scripting/scriptSnippetBundler.ts"],"names":[],"mappings":"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"}

package/dist/search/actions.d.ts

@@ -0,0 +1,44 @@
+/**
+ * One action surfaced in the Action menu quick-open mode (`#` prefix).
+ */
+export interface ActionCommandDefinition {
+    /** Stable action id used for dispatch. */
+    id: string;
+    /** Namespace shown before the label (for example `File` in `File: Settings`). */
+    group: string;
+    /** Primary label shown after the group prefix. */
+    label: string;
+    /** Optional secondary description shown beneath the label. */
+    description?: string;
+}
+/**
+ * Built-in actions derived from the File, View, Team, and Help application menus.
+ */
+export declare const BUILTIN_ACTIONS: ActionCommandDefinition[];
+/**
+ * Returns the display label for an action row (`group: label`).
+ *
+ * @param action - Action command definition.
+ */
+export declare function actionCommandDisplayLabel(action: ActionCommandDefinition): string;
+/**
+ * Returns whether the query should enter Action menu quick-open mode.
+ *
+ * @param query - Raw search input value.
+ */
+export declare function isActionQuery(query: string): boolean;
+/**
+ * Filters registered actions whose group, label, or description match the typed prefix.
+ *
+ * @param query - Raw hash-prefixed input.
+ * @param actions - Full action catalog to search.
+ */
+export declare function matchActionSuggestions(query: string, actions: ActionCommandDefinition[]): ActionCommandDefinition[];
+/**
+ * Builds a stable action id for a plugin-registered quick-open command.
+ *
+ * @param pluginId - Plugin manifest id.
+ * @param commandId - Scoped command id stored in the agent webview.
+ */
+export declare function pluginActionId(pluginId: string, commandId: string): string;
+//# sourceMappingURL=actions.d.ts.map

package/dist/search/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../src/search/actions.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,uBAAuB,EA8DpD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAEjF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAeD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,uBAAuB,EAAE,GACjC,uBAAuB,EAAE,CAW3B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1E"}

package/dist/search/actions.js

@@ -0,0 +1,120 @@
+/**
+ * Built-in actions derived from the File, View, Team, and Help application menus.
+ */
+export const BUILTIN_ACTIONS = [
+    { id: 'builtin:new-request', group: 'File', label: 'New Request' },
+    { id: 'builtin:new-collection', group: 'File', label: 'New Collection' },
+    { id: 'builtin:sync', group: 'File', label: 'Sync Storage' },
+    { id: 'builtin:save', group: 'File', label: 'Save Request' },
+    { id: 'builtin:import', group: 'File', label: 'Import' },
+    { id: 'builtin:settings', group: 'File', label: 'Settings' },
+    { id: 'builtin:plugins', group: 'File', label: 'Plugins' },
+    { id: 'builtin:themes', group: 'File', label: 'Themes' },
+    { id: 'builtin:snippets', group: 'File', label: 'Snippets' },
+    { id: 'builtin:cookies', group: 'File', label: 'Cookies' },
+    { id: 'builtin:toggle-sidebar', group: 'View', label: 'Toggle Sidebar' },
+    { id: 'builtin:toggle-ai-sidebar', group: 'View', label: 'Toggle Agent Chat' },
+    { id: 'builtin:toggle-git-sidebar', group: 'View', label: 'Toggle Git' },
+    { id: 'builtin:toggle-request-editor', group: 'View', label: 'Toggle Request' },
+    { id: 'builtin:toggle-response-editor', group: 'View', label: 'Toggle Response' },
+    {
+        id: 'builtin:toggle-terminal',
+        group: 'View',
+        label: 'Terminal',
+        description: 'Open the terminal panel'
+    },
+    {
+        id: 'builtin:toggle-collections-section',
+        group: 'View',
+        label: 'Toggle Collections'
+    },
+    {
+        id: 'builtin:toggle-environments-section',
+        group: 'View',
+        label: 'Toggle Environments'
+    },
+    {
+        id: 'builtin:toggle-run-results-section',
+        group: 'View',
+        label: 'Toggle Run Results'
+    },
+    { id: 'builtin:team-hubs', group: 'Team', label: 'Team Hub' },
+    {
+        id: 'builtin:accept-team-hub-invite',
+        group: 'Team',
+        label: 'Accept Team Hub Invite'
+    },
+    { id: 'builtin:sharing-keys', group: 'Team', label: 'Sharing Keys' },
+    {
+        id: 'builtin:join-shared-collection',
+        group: 'Team',
+        label: 'Join Shared Collection'
+    },
+    { id: 'builtin:new-collection-git', group: 'Git', label: 'New Collection' },
+    { id: 'builtin:git-create-branch', group: 'Git', label: 'Branches' },
+    { id: 'builtin:git-delete-branch', group: 'Git', label: 'Delete Branch' },
+    { id: 'builtin:git-commit', group: 'Git', label: 'Commit' },
+    { id: 'builtin:git-merge', group: 'Git', label: 'Merge' },
+    { id: 'builtin:git-fetch', group: 'Git', label: 'Fetch' },
+    { id: 'builtin:git-pull', group: 'Git', label: 'Pull' },
+    { id: 'builtin:git-push', group: 'Git', label: 'Push' },
+    { id: 'builtin:git-settings', group: 'Git', label: 'Settings' },
+    { id: 'builtin:getting-started', group: 'Help', label: 'Getting Started' },
+    { id: 'builtin:check-for-updates', group: 'Help', label: 'Check for Updates' },
+    { id: 'builtin:shortcuts-reference', group: 'Help', label: 'Keyboard Shortcuts' },
+    { id: 'builtin:about', group: 'Help', label: 'About' }
+];
+/**
+ * Returns the display label for an action row (`group: label`).
+ *
+ * @param action - Action command definition.
+ */
+export function actionCommandDisplayLabel(action) {
+    return `${action.group}: ${action.label}`;
+}
+/**
+ * Returns whether the query should enter Action menu quick-open mode.
+ *
+ * @param query - Raw search input value.
+ */
+export function isActionQuery(query) {
+    return query.startsWith('#');
+}
+/**
+ * Returns the searchable text for one action definition.
+ *
+ * @param action - Action command definition.
+ */
+function actionSearchText(action) {
+    const parts = [actionCommandDisplayLabel(action), action.label, action.group];
+    if (action.description != null && action.description.length > 0) {
+        parts.push(action.description);
+    }
+    return parts.join(' ').toLowerCase();
+}
+/**
+ * Filters registered actions whose group, label, or description match the typed prefix.
+ *
+ * @param query - Raw hash-prefixed input.
+ * @param actions - Full action catalog to search.
+ */
+export function matchActionSuggestions(query, actions) {
+    if (!isActionQuery(query)) {
+        return [];
+    }
+    const filterText = query.slice(1).trim().toLowerCase();
+    if (filterText.length === 0) {
+        return actions;
+    }
+    return actions.filter((action) => actionSearchText(action).includes(filterText));
+}
+/**
+ * Builds a stable action id for a plugin-registered quick-open command.
+ *
+ * @param pluginId - Plugin manifest id.
+ * @param commandId - Scoped command id stored in the agent webview.
+ */
+export function pluginActionId(pluginId, commandId) {
+    return `plugin:${pluginId}:${commandId}`;
+}
+//# sourceMappingURL=actions.js.map

package/dist/search/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../src/search/actions.ts"],"names":[],"mappings":"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"}

package/dist/search/index.d.ts

@@ -0,0 +1,13 @@
+export * from './oramaIndex';
+export * from './types';
+export * from './sidebar';
+export * from './settings';
+export * from './settingsCatalog';
+export * from './plugins';
+export * from './installedPlugins';
+export * from './pagesCatalog';
+export * from './snippets';
+export * from './unified';
+export * from './slashCommands';
+export * from './actions';
+//# sourceMappingURL=index.d.ts.map

package/dist/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}

package/dist/search/index.js

@@ -0,0 +1,13 @@
+export * from './oramaIndex';
+export * from './types';
+export * from './sidebar';
+export * from './settings';
+export * from './settingsCatalog';
+export * from './plugins';
+export * from './installedPlugins';
+export * from './pagesCatalog';
+export * from './snippets';
+export * from './unified';
+export * from './slashCommands';
+export * from './actions';
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}

package/dist/search/installedPlugins.d.ts

@@ -0,0 +1,31 @@
+import type { PluginInfo } from '../plugin/types';
+import { type HarborSearchIndex } from './oramaIndex';
+/**
+ * Builds an Orama index over installed plugin metadata.
+ *
+ * @param plugins - Installed plugin rows to index.
+ * @returns Search index keyed by plugin id.
+ */
+export declare function buildInstalledPluginSearchIndex(plugins: PluginInfo[]): HarborSearchIndex;
+/**
+ * Filters installed plugins by a user query using the prebuilt search index.
+ *
+ * @param plugins - Full installed listing in display order.
+ * @param index - Orama index built from the same plugin rows.
+ * @param query - Raw search text from the installed filter field.
+ * @returns Matching plugins in relevance order, or the original list when the query is empty.
+ */
+export declare function searchInstalledPlugins(plugins: PluginInfo[], index: HarborSearchIndex, query: string): PluginInfo[];
+/**
+ * Returns installed plugin hits with scores for unified global search.
+ *
+ * @param index - Orama index built from installed plugin rows.
+ * @param query - Raw search text.
+ */
+export declare function searchInstalledPluginHits(index: HarborSearchIndex, query: string): Array<{
+    id: string;
+    score: number;
+    name: string;
+    summary: string;
+}>;
+//# sourceMappingURL=installedPlugins.d.ts.map

package/dist/search/installedPlugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installedPlugins.d.ts","sourceRoot":"","sources":["../../src/search/installedPlugins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAA0C,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAsC9F;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,iBAAiB,CAKxF;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,UAAU,EAAE,EACrB,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,MAAM,GACZ,UAAU,EAAE,CAYd;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,iBAAiB,EACxB,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAcrE"}