@harborclient/core 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog
+
+## Unreleased
+
+## 0.1.1 - 2026-07-25
+
+- fix: update pre-commit hook to block any local SDK link overrides. (`a4ab5392`)
+- feat(gui): update dependencies and enhance theme management. (`babfa827`)
+- feat(gui): enhance user agent handling across storage and request modules. (`cf17b788`)
+- feat(core): update .gitignore, add thumbnails, and refactor auth module. (`58bbb3b6`)
+- feat(docs): update documentation search index and improve logging format. (`6edd9fc`)
+- feat(gui): refactor path resolution and enhance sidebar actions. (`56b3645`)
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sean H
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+![@harborclient/core](https://raw.githubusercontent.com/harborclient/harborclient/main/images/logo.png)
+
+**Full documentation:** [https://harborclient.github.io/harborclient/core/](https://harborclient.github.io/harborclient/core/)
+
+**Platform-neutral HarborClient engine**
+
+`@harborclient/core` is the shared library for HarborClient hosts (GUI, CLI, and storage adapters):
+
+- **Request runner:** Host-agnostic HTTP pipeline with scripts, cookies, and variable substitution
+- **Scripting:** SES-sandboxed pre/post scripts and assertion helpers
+- **Shared types:** Domain models and the IPC `Api` contract used across the monorepo
+
+## Documentation
+
+| Topic           | Link                                                                              |
+| --------------- | --------------------------------------------------------------------------------- |
+| Getting started | [Introduction](https://harborclient.github.io/harborclient/core/)                 |
+| Installation    | [Installation](https://harborclient.github.io/harborclient/core/installation)     |
+| Package layout  | [Package layout](https://harborclient.github.io/harborclient/core/package-layout) |
+| Request runner  | [Request runner](https://harborclient.github.io/harborclient/core/request-runner) |
+| Scripting       | [Scripting](https://harborclient.github.io/harborclient/core/scripting)           |
+
+Canonical docs live in [`docs/`](./docs/). Edit those pages directly, then run `pnpm docs:build:nav` to refresh the VitePress sidebar.
+
+## Development
+
+```bash
+pnpm install
+pnpm --filter @harborclient/core test
+pnpm --filter @harborclient/core docs:serve    # VitePress dev server with nav watcher
+pnpm --filter @harborclient/core docs:build    # production docs build
+```
+
+## License
+
+MIT

package/dist/ai/chatComposer.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns whether the chat composer should submit on the current key event.
+ *
+ * @param key - Keyboard event key value.
+ * @param shiftKey - Whether Shift is held.
+ * @param ctrlKey - Whether Ctrl is held.
+ * @param metaKey - Whether Meta/Cmd is held.
+ * @param enterToSend - When true, plain Enter submits; when false, Ctrl/Cmd+Enter submits.
+ * @returns True when the key event should trigger send.
+ */
+export declare function shouldSendChatOnKeyDown(key: string, shiftKey: boolean, ctrlKey: boolean, metaKey: boolean, enterToSend: boolean): boolean;
+//# sourceMappingURL=chatComposer.d.ts.map

package/dist/ai/chatComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatComposer.d.ts","sourceRoot":"","sources":["../../src/ai/chatComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,OAAO,EACjB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,OAAO,GACnB,OAAO,CAUT"}

package/dist/ai/chatComposer.js

@@ -0,0 +1,20 @@
+/**
+ * Returns whether the chat composer should submit on the current key event.
+ *
+ * @param key - Keyboard event key value.
+ * @param shiftKey - Whether Shift is held.
+ * @param ctrlKey - Whether Ctrl is held.
+ * @param metaKey - Whether Meta/Cmd is held.
+ * @param enterToSend - When true, plain Enter submits; when false, Ctrl/Cmd+Enter submits.
+ * @returns True when the key event should trigger send.
+ */
+export function shouldSendChatOnKeyDown(key, shiftKey, ctrlKey, metaKey, enterToSend) {
+    if (key !== 'Enter') {
+        return false;
+    }
+    if (enterToSend) {
+        return !shiftKey;
+    }
+    return ctrlKey || metaKey;
+}
+//# sourceMappingURL=chatComposer.js.map

package/dist/ai/chatComposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatComposer.js","sourceRoot":"","sources":["../../src/ai/chatComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CACrC,GAAW,EACX,QAAiB,EACjB,OAAgB,EAChB,OAAgB,EAChB,WAAoB;IAEpB,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,QAAQ,CAAC;IACnB,CAAC;IAED,OAAO,OAAO,IAAI,OAAO,CAAC;AAC5B,CAAC"}

package/dist/ai/chatContext.d.ts

@@ -0,0 +1,181 @@
+import type { ChatStepMessage, ScriptTestResult, SendResult } from '../types';
+/**
+ * Character count for response body previews in summary tools.
+ */
+export declare const RESPONSE_BODY_PREVIEW_CHARS = 500;
+/**
+ * Default maximum response body characters for full-body tool fetches.
+ */
+export declare const DEFAULT_RESPONSE_BODY_CHARS = 16384;
+/**
+ * Per-message content cap applied during aggressive context recovery.
+ */
+export declare const AGGRESSIVE_MESSAGE_CONTENT_CHARS = 2000;
+/**
+ * Maximum history messages kept during aggressive context recovery.
+ */
+export declare const AGGRESSIVE_HISTORY_MESSAGE_COUNT = 6;
+/**
+ * Default maximum characters for stringified JMESPath query results.
+ */
+export declare const DEFAULT_QUERY_RESULT_CHARS = 4000;
+/**
+ * Result of truncating text for LLM consumption.
+ */
+export interface TruncatedText {
+    /**
+     * Truncated text safe to send to the model.
+     */
+    text: string;
+    /**
+     * Whether the original text was shortened.
+     */
+    truncated: boolean;
+    /**
+     * Length of the original string before truncation.
+     */
+    originalLength: number;
+}
+/**
+ * Options for formatting an HTTP response for agent tools.
+ */
+export type FormatHttpResponseOptions = {
+    mode: 'summary';
+} | {
+    maxBodyChars: number;
+};
+/**
+ * Agent-facing HTTP response payload with optional body truncation metadata.
+ */
+export interface AgentHttpResponse {
+    /**
+     * HTTP status code.
+     */
+    status: number;
+    /**
+     * HTTP status text.
+     */
+    statusText: string;
+    /**
+     * Response headers.
+     */
+    headers: Record<string, string>;
+    /**
+     * Round-trip time in milliseconds.
+     */
+    timeMs: number;
+    /**
+     * Response body size in bytes.
+     */
+    sizeBytes: number;
+    /**
+     * Error message when the request failed.
+     */
+    error?: string;
+    /**
+     * Script test results from the response tab.
+     */
+    tests: ScriptTestResult[];
+    /**
+     * Short body preview for summary mode.
+     */
+    bodyPreview?: string;
+    /**
+     * Whether the body preview was truncated.
+     */
+    bodyPreviewTruncated?: boolean;
+    /**
+     * Full or truncated body when requested.
+     */
+    body?: string;
+    /**
+     * Whether the body field was truncated.
+     */
+    bodyTruncated?: boolean;
+    /**
+     * Original body length before truncation.
+     */
+    bodyOriginalLength?: number;
+}
+/**
+ * JMESPath result type label returned to the agent.
+ */
+export type QueryResultType = 'array' | 'object' | 'string' | 'number' | 'boolean' | 'null';
+/**
+ * Successful JMESPath query result for agent tools.
+ */
+export interface QueryResponseBodyResult {
+    /**
+     * JMESPath expression that was evaluated.
+     */
+    expression: string;
+    /**
+     * JavaScript typeof-style label for the matched value.
+     */
+    resultType: QueryResultType;
+    /**
+     * Number of matches when the result is an array.
+     */
+    matchCount?: number;
+    /**
+     * Full structured result when it fits within the character cap.
+     */
+    result?: unknown;
+    /**
+     * Truncated JSON preview when the stringified result exceeds the cap.
+     */
+    resultPreview?: string;
+    /**
+     * Whether the stringified result was truncated.
+     */
+    resultTruncated?: boolean;
+    /**
+     * Original stringified result length before truncation.
+     */
+    resultOriginalLength?: number;
+}
+/**
+ * Failed JMESPath query result for agent tools.
+ */
+export interface QueryResponseBodyError {
+    /**
+     * Human-readable error message.
+     */
+    error: string;
+    /**
+     * Response Content-Type header when JSON parsing fails.
+     */
+    contentType?: string;
+}
+/**
+ * Evaluates a JMESPath expression against a JSON response body for agent tools.
+ *
+ * @param bodyText - Raw response body text expected to be JSON.
+ * @param expression - JMESPath expression to evaluate.
+ * @param maxResultChars - Maximum stringified result characters to return.
+ * @param contentType - Optional Content-Type header for parse error context.
+ */
+export declare function queryJsonForAgent(bodyText: string, expression: string, maxResultChars?: number, contentType?: string): QueryResponseBodyResult | QueryResponseBodyError;
+/**
+ * Truncates text to a maximum character length for LLM payloads.
+ *
+ * @param text - Source text.
+ * @param maxChars - Maximum allowed characters.
+ */
+export declare function truncateTextForLlm(text: string, maxChars: number): TruncatedText;
+/**
+ * Formats an HTTP response for agent tools in summary or capped full-body mode.
+ *
+ * @param response - Last send result from the active tab.
+ * @param tests - Script test results for the response.
+ * @param options - Summary preview or max body character limit.
+ */
+export declare function formatHttpResponseForAgent(response: SendResult, tests: ScriptTestResult[], options: FormatHttpResponseOptions): AgentHttpResponse;
+/**
+ * Shrinks chat step messages to recover from context length overflows.
+ *
+ * @param messages - Messages from the renderer tool loop.
+ * @param aggressive - When true, drops old history and caps message content length.
+ */
+export declare function truncateChatStepMessages(messages: ChatStepMessage[], aggressive: boolean): ChatStepMessage[];
+//# sourceMappingURL=chatContext.d.ts.map

package/dist/ai/chatContext.d.ts.map

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

package/dist/ai/chatContext.js

@@ -0,0 +1,168 @@
+import jmespath from 'jmespath';
+/**
+ * Character count for response body previews in summary tools.
+ */
+export const RESPONSE_BODY_PREVIEW_CHARS = 500;
+/**
+ * Default maximum response body characters for full-body tool fetches.
+ */
+export const DEFAULT_RESPONSE_BODY_CHARS = 16384;
+/**
+ * Per-message content cap applied during aggressive context recovery.
+ */
+export const AGGRESSIVE_MESSAGE_CONTENT_CHARS = 2000;
+/**
+ * Maximum history messages kept during aggressive context recovery.
+ */
+export const AGGRESSIVE_HISTORY_MESSAGE_COUNT = 6;
+/**
+ * Default maximum characters for stringified JMESPath query results.
+ */
+export const DEFAULT_QUERY_RESULT_CHARS = 4000;
+/**
+ * Resolves the agent-facing result type label for a JMESPath value.
+ *
+ * @param value - Value returned by JMESPath search.
+ */
+function resolveQueryResultType(value) {
+    if (value === null) {
+        return 'null';
+    }
+    if (Array.isArray(value)) {
+        return 'array';
+    }
+    switch (typeof value) {
+        case 'object':
+            return 'object';
+        case 'string':
+            return 'string';
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        default:
+            return 'null';
+    }
+}
+/**
+ * Evaluates a JMESPath expression against a JSON response body for agent tools.
+ *
+ * @param bodyText - Raw response body text expected to be JSON.
+ * @param expression - JMESPath expression to evaluate.
+ * @param maxResultChars - Maximum stringified result characters to return.
+ * @param contentType - Optional Content-Type header for parse error context.
+ */
+export function queryJsonForAgent(bodyText, expression, maxResultChars = DEFAULT_QUERY_RESULT_CHARS, contentType) {
+    let parsed;
+    try {
+        parsed = JSON.parse(bodyText);
+    }
+    catch {
+        return {
+            error: 'Response body is not valid JSON.',
+            ...(contentType ? { contentType } : {})
+        };
+    }
+    let value;
+    try {
+        value = jmespath.search(parsed, expression);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown expression error.';
+        return { error: `Invalid JMESPath expression: ${message}` };
+    }
+    const resultType = resolveQueryResultType(value);
+    const base = {
+        expression,
+        resultType,
+        ...(resultType === 'array' && Array.isArray(value) ? { matchCount: value.length } : {})
+    };
+    const serialized = JSON.stringify(value);
+    if (serialized.length <= maxResultChars) {
+        return { ...base, result: value };
+    }
+    const preview = truncateTextForLlm(serialized, maxResultChars);
+    return {
+        ...base,
+        resultPreview: preview.text,
+        resultTruncated: true,
+        resultOriginalLength: preview.originalLength
+    };
+}
+/**
+ * Truncates text to a maximum character length for LLM payloads.
+ *
+ * @param text - Source text.
+ * @param maxChars - Maximum allowed characters.
+ */
+export function truncateTextForLlm(text, maxChars) {
+    if (maxChars <= 0) {
+        return { text: '', truncated: text.length > 0, originalLength: text.length };
+    }
+    if (text.length <= maxChars) {
+        return { text, truncated: false, originalLength: text.length };
+    }
+    return {
+        text: text.slice(0, maxChars),
+        truncated: true,
+        originalLength: text.length
+    };
+}
+/**
+ * Formats an HTTP response for agent tools in summary or capped full-body mode.
+ *
+ * @param response - Last send result from the active tab.
+ * @param tests - Script test results for the response.
+ * @param options - Summary preview or max body character limit.
+ */
+export function formatHttpResponseForAgent(response, tests, options) {
+    const preview = truncateTextForLlm(response.body, RESPONSE_BODY_PREVIEW_CHARS);
+    const base = {
+        status: response.status,
+        statusText: response.statusText,
+        headers: response.headers,
+        timeMs: response.timeMs,
+        sizeBytes: response.sizeBytes,
+        ...(response.error ? { error: response.error } : {}),
+        tests,
+        bodyPreview: preview.text,
+        ...(preview.truncated
+            ? { bodyPreviewTruncated: true, bodyOriginalLength: preview.originalLength }
+            : {})
+    };
+    if ('mode' in options && options.mode === 'summary') {
+        return base;
+    }
+    const maxBodyChars = 'maxBodyChars' in options ? options.maxBodyChars : DEFAULT_RESPONSE_BODY_CHARS;
+    const body = truncateTextForLlm(response.body, maxBodyChars);
+    return {
+        ...base,
+        body: body.text,
+        ...(body.truncated ? { bodyTruncated: true, bodyOriginalLength: body.originalLength } : {})
+    };
+}
+/**
+ * Shrinks chat step messages to recover from context length overflows.
+ *
+ * @param messages - Messages from the renderer tool loop.
+ * @param aggressive - When true, drops old history and caps message content length.
+ */
+export function truncateChatStepMessages(messages, aggressive) {
+    if (!aggressive || messages.length === 0) {
+        return messages;
+    }
+    const trimmed = messages.length > AGGRESSIVE_HISTORY_MESSAGE_COUNT
+        ? messages.slice(-AGGRESSIVE_HISTORY_MESSAGE_COUNT)
+        : [...messages];
+    return trimmed.map((message) => {
+        if (message.content == null || message.content.length <= AGGRESSIVE_MESSAGE_CONTENT_CHARS) {
+            return message;
+        }
+        const shortened = truncateTextForLlm(message.content, AGGRESSIVE_MESSAGE_CONTENT_CHARS);
+        return {
+            ...message,
+            content: `${shortened.text}\n… [truncated from ${shortened.originalLength} characters]`
+        };
+    });
+}
+//# sourceMappingURL=chatContext.js.map

package/dist/ai/chatContext.js.map

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

package/dist/ai/chatStepMode.d.ts

@@ -0,0 +1,43 @@
+import type { ChatCompletionTool } from 'openai/resources/chat/completions';
+import type { ChatStepInput, ChatStepMessage } from '../types';
+/**
+ * Resolved prompt, tools, and messages for one LLM completion step.
+ */
+export interface ChatStepModeConfig {
+    /**
+     * System prompt injected before conversation messages.
+     */
+    systemPrompt: string;
+    /**
+     * Tool definitions available to the model for this step.
+     */
+    tools: ChatCompletionTool[];
+    /**
+     * Conversation messages sent to the provider for this step.
+     */
+    messages: ChatStepMessage[];
+    /**
+     * Optional forced tool choice for mini-agent style steps.
+     */
+    toolChoice?: {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+    /**
+     * When true, external MCP client tools are not merged into this step.
+     */
+    excludeMcpTools?: boolean;
+}
+/**
+ * Resolves system prompt, tools, and messages for a chat completion step.
+ *
+ * @param input - Renderer-provided step input with optional mode flags.
+ * @param options - Optional hub capability hints for tool gating.
+ * @returns Configuration for the provider request.
+ */
+export declare function resolveChatStepMode(input: ChatStepInput, options?: {
+    hubHasOpenAi?: boolean;
+}): ChatStepModeConfig;
+//# sourceMappingURL=chatStepMode.d.ts.map

package/dist/ai/chatStepMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatStepMode.d.ts","sourceRoot":"","sources":["../../src/ai/chatStepMode.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAyB/D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAE5B;;OAEG;IACH,QAAQ,EAAE,eAAe,EAAE,CAAC;IAE5B;;OAEG;IACH,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAE9D;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GACnC,kBAAkB,CAuCpB"}

package/dist/ai/chatStepMode.js

@@ -0,0 +1,64 @@
+import { buildChatTitleSystemPrompt, CHAT_TITLE_TOOL } from './chatTitle';
+import { buildGitCommitMessageSystemPrompt } from './gitCommitMessage';
+import { buildScriptAskSystemPrompt, SCRIPT_ASK_TOOL } from './scriptAsk';
+import { AI_SYSTEM_PROMPT, AI_TOOL_DEFINITIONS } from './tools';
+/**
+ * Removes tools that should not be offered for the current chat step context.
+ *
+ * @param tools - Full Harbor tool definitions for a step.
+ * @param input - Renderer-provided step input with optional hub routing.
+ * @param hubHasOpenAi - When false for a hub chat, documentation search is disabled.
+ */
+function filterToolsForChatStep(tools, input, hubHasOpenAi) {
+    const hubId = input.hubId?.trim();
+    if (!hubId || hubHasOpenAi !== false) {
+        return tools;
+    }
+    return tools.filter((tool) => {
+        const name = tool.type === 'function' ? tool.function.name : tool.custom.name;
+        return name !== 'search_docs';
+    });
+}
+/**
+ * Resolves system prompt, tools, and messages for a chat completion step.
+ *
+ * @param input - Renderer-provided step input with optional mode flags.
+ * @param options - Optional hub capability hints for tool gating.
+ * @returns Configuration for the provider request.
+ */
+export function resolveChatStepMode(input, options) {
+    const chatTitlePrompt = input.chatTitlePrompt?.trim();
+    if (chatTitlePrompt) {
+        return {
+            systemPrompt: buildChatTitleSystemPrompt(),
+            tools: [CHAT_TITLE_TOOL],
+            messages: [{ role: 'user', content: chatTitlePrompt }],
+            toolChoice: { type: 'function', function: { name: 'set_chat_title' } },
+            excludeMcpTools: true
+        };
+    }
+    if (input.scriptAsk) {
+        return {
+            systemPrompt: buildScriptAskSystemPrompt(input.scriptAsk),
+            tools: [SCRIPT_ASK_TOOL],
+            messages: input.messages,
+            toolChoice: { type: 'function', function: { name: 'answer_script' } },
+            excludeMcpTools: true
+        };
+    }
+    if (input.agentVariant === 'commitMessage') {
+        const gitDiffTool = AI_TOOL_DEFINITIONS.find((tool) => tool.type === 'function' && tool.function.name === 'git_diff');
+        return {
+            systemPrompt: buildGitCommitMessageSystemPrompt(),
+            tools: gitDiffTool ? [gitDiffTool] : [],
+            messages: input.messages,
+            excludeMcpTools: true
+        };
+    }
+    return {
+        systemPrompt: AI_SYSTEM_PROMPT,
+        tools: filterToolsForChatStep(AI_TOOL_DEFINITIONS, input, options?.hubHasOpenAi),
+        messages: input.messages
+    };
+}
+//# sourceMappingURL=chatStepMode.js.map

package/dist/ai/chatStepMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatStepMode.js","sourceRoot":"","sources":["../../src/ai/chatStepMode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,0BAA0B,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAIhE;;;;;;GAMG;AACH,SAAS,sBAAsB,CAC7B,KAA2B,EAC3B,KAAoB,EACpB,YAAsB;IAEtB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IAClC,IAAI,CAAC,KAAK,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QAC9E,OAAO,IAAI,KAAK,aAAa,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC;AAgCD;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAoB,EACpB,OAAoC;IAEpC,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IACtD,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO;YACL,YAAY,EAAE,0BAA0B,EAAE;YAC1C,KAAK,EAAE,CAAC,eAAe,CAAC;YACxB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;YACtD,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE;YACtE,eAAe,EAAE,IAAI;SACtB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,OAAO;YACL,YAAY,EAAE,0BAA0B,CAAC,KAAK,CAAC,SAAS,CAAC;YACzD,KAAK,EAAE,CAAC,eAAe,CAAC;YACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE;YACrE,eAAe,EAAE,IAAI;SACtB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,YAAY,KAAK,eAAe,EAAE,CAAC;QAC3C,MAAM,WAAW,GAAG,mBAAmB,CAAC,IAAI,CAC1C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,UAAU,CACxE,CAAC;QACF,OAAO;YACL,YAAY,EAAE,iCAAiC,EAAE;YACjD,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE;YACvC,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,eAAe,EAAE,IAAI;SACtB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,YAAY,EAAE,gBAAgB;QAC9B,KAAK,EAAE,sBAAsB,CAAC,mBAAmB,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,CAAC;QAChF,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC;AACJ,CAAC"}

package/dist/ai/chatTitle.d.ts

@@ -0,0 +1,35 @@
+import type { ChatCompletionTool } from 'openai/resources/chat/completions';
+import type { ChatStepResult } from '../types';
+/**
+ * Default title for chats that have not received an AI-generated summary yet.
+ */
+export declare const DEFAULT_CHAT_TITLE = "New Chat";
+/**
+ * Maximum length for persisted chat tab titles.
+ */
+export declare const CHAT_TITLE_MAX_LENGTH = 40;
+/**
+ * OpenAI tool definition for summarizing a user's first message into a chat title.
+ */
+export declare const CHAT_TITLE_TOOL: ChatCompletionTool;
+/**
+ * Builds the system prompt for AI chat title generation.
+ *
+ * @returns System prompt instructing the model to call set_chat_title.
+ */
+export declare function buildChatTitleSystemPrompt(): string;
+/**
+ * Normalizes raw title text for persistence and display.
+ *
+ * @param raw - Title string from the model or user input.
+ * @returns Sanitized title, or {@link DEFAULT_CHAT_TITLE} when empty after normalization.
+ */
+export declare function normalizeChatTitle(raw: string): string;
+/**
+ * Reads a set_chat_title tool call from a chat step result.
+ *
+ * @param result - One LLM completion step result.
+ * @returns Normalized title, or null when no usable response is present.
+ */
+export declare function parseChatTitleResult(result: ChatStepResult): string | null;
+//# sourceMappingURL=chatTitle.d.ts.map

package/dist/ai/chatTitle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatTitle.d.ts","sourceRoot":"","sources":["../../src/ai/chatTitle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,kBAAkB,aAAa,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,kBAiB7B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CASnD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBtD;AAyBD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAiB1E"}