@harborclient/core 0.1.1

package/dist/interfaces/ICookieJar.d.ts

@@ -0,0 +1,41 @@
+import type { KeyValue } from '../types/common';
+/**
+ * Contract for persisting and applying cookies by hostname.
+ */
+export interface ICookieJar {
+    /**
+     * Returns cookies stored for a hostname.
+     *
+     * @param domain - Hostname to query.
+     * @returns Cookie rows without internal metadata.
+     */
+    getCookiesForDomain(domain: string): KeyValue[];
+    /**
+     * Returns all hostnames with persisted cookies.
+     *
+     * @returns Sorted cookie domains.
+     */
+    listDomains(): string[];
+    /**
+     * Persists cookies for a hostname.
+     *
+     * @param domain - Hostname to update.
+     * @param cookies - Cookie rows to store.
+     */
+    setCookiesForDomain(domain: string, cookies: KeyValue[]): void;
+    /**
+     * Builds a Cookie header value for enabled cookies on the request host.
+     *
+     * @param url - Request URL used to resolve the host.
+     * @returns Semicolon-delimited cookie header value, or null when none apply.
+     */
+    buildCookieHeader(url: string): string | null;
+    /**
+     * Upserts or removes cookies from the jar based on Set-Cookie response headers.
+     *
+     * @param url - Request URL used to resolve the host.
+     * @param setCookieHeaders - Set-Cookie header values from the response.
+     */
+    captureSetCookies(url: string, setCookieHeaders: string[] | undefined): void;
+}
+//# sourceMappingURL=ICookieJar.d.ts.map

package/dist/interfaces/ICookieJar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICookieJar.d.ts","sourceRoot":"","sources":["../../src/interfaces/ICookieJar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IAEhD;;;;OAIG;IACH,WAAW,IAAI,MAAM,EAAE,CAAC;IAExB;;;;;OAKG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAE/D;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAE9C;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC;CAC9E"}

package/dist/interfaces/ICookieJar.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ICookieJar.js.map

package/dist/interfaces/ICookieJar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICookieJar.js","sourceRoot":"","sources":["../../src/interfaces/ICookieJar.ts"],"names":[],"mappings":""}

package/dist/interfaces/IScriptRunner.d.ts

@@ -0,0 +1,20 @@
+import type { ScriptRunInput, ScriptRunResult } from '../types/script';
+/**
+ * Runs pre/post request scripts in an isolated sandbox.
+ *
+ * GUI implements this with Electron `utilityProcess`; CLI uses `child_process`.
+ */
+export interface IScriptRunner {
+    /**
+     * Evaluates a script with the given request/response context.
+     *
+     * @param input - Script source, phase, and variable context.
+     * @returns Mutated request, variables, tests, and logs from the sandbox.
+     */
+    run(input: ScriptRunInput): Promise<ScriptRunResult>;
+    /**
+     * Releases runner resources (kills the child process, clears pending work).
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=IScriptRunner.d.ts.map

package/dist/interfaces/IScriptRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IScriptRunner.d.ts","sourceRoot":"","sources":["../../src/interfaces/IScriptRunner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvE;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAErD;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/interfaces/IScriptRunner.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IScriptRunner.js.map

package/dist/interfaces/IScriptRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IScriptRunner.js","sourceRoot":"","sources":["../../src/interfaces/IScriptRunner.ts"],"names":[],"mappings":""}

package/dist/interfaces/PluginHooks.d.ts

@@ -0,0 +1,24 @@
+import type { SendRequestInput } from '../types';
+import type { PluginHttpRequest, PluginHttpResponse } from '@harborclient/sdk';
+/**
+ * Optional hooks applied around outbound HTTP sends (plugins in the GUI).
+ *
+ * CLI typically supplies identity / no-op implementations.
+ */
+export interface PluginHooks {
+    /**
+     * Mutates or replaces a request before it is sent.
+     *
+     * @param request - Outbound request payload.
+     * @returns Request to send (may be the same object).
+     */
+    beforeSend?(request: SendRequestInput): Promise<SendRequestInput> | SendRequestInput;
+    /**
+     * Observes a successful HTTP response after send.
+     *
+     * @param request - Request that was sent (after beforeSend).
+     * @param response - HTTP response metadata for plugins.
+     */
+    afterSend?(request: SendRequestInput | PluginHttpRequest, response: PluginHttpResponse): Promise<void> | void;
+}
+//# sourceMappingURL=PluginHooks.d.ts.map

package/dist/interfaces/PluginHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginHooks.d.ts","sourceRoot":"","sources":["../../src/interfaces/PluginHooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE/E;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,UAAU,CAAC,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAAC;IAErF;;;;;OAKG;IACH,SAAS,CAAC,CACR,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,EAC7C,QAAQ,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACzB"}

package/dist/interfaces/PluginHooks.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=PluginHooks.js.map

package/dist/interfaces/PluginHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginHooks.js","sourceRoot":"","sources":["../../src/interfaces/PluginHooks.ts"],"names":[],"mappings":""}

package/dist/interfaces/SettingsProvider.d.ts

@@ -0,0 +1,20 @@
+import type { GeneralSettings } from '../types/settings';
+/**
+ * Read/write access to persisted general settings used by the request engine.
+ *
+ * GUI and CLI each supply an adapter (SQLite / electron-store vs config file + flags).
+ * Engine code must never reach into storage singletons directly.
+ */
+export interface SettingsProvider {
+    /**
+     * Returns the current general settings with defaults applied.
+     */
+    getGeneralSettings(): GeneralSettings;
+    /**
+     * Persists general settings.
+     *
+     * @param settings - Normalized settings to store.
+     */
+    setGeneralSettings(settings: GeneralSettings): void;
+}
+//# sourceMappingURL=SettingsProvider.d.ts.map

package/dist/interfaces/SettingsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsProvider.d.ts","sourceRoot":"","sources":["../../src/interfaces/SettingsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,kBAAkB,IAAI,eAAe,CAAC;IAEtC;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CACrD"}

package/dist/interfaces/SettingsProvider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SettingsProvider.js.map

package/dist/interfaces/SettingsProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsProvider.js","sourceRoot":"","sources":["../../src/interfaces/SettingsProvider.ts"],"names":[],"mappings":""}

package/dist/interfaces/index.d.ts

@@ -0,0 +1,5 @@
+export type { SettingsProvider } from './SettingsProvider';
+export type { IScriptRunner } from './IScriptRunner';
+export type { ICookieJar } from './ICookieJar';
+export type { PluginHooks } from './PluginHooks';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/interfaces/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":""}

package/dist/mcpToolNames.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Prefix for MCP client tools merged into the chat agent tool list.
+ */
+export declare const MCP_TOOL_PREFIX = "mcp__";
+/**
+ * Builds a prefixed MCP tool name for LLM routing.
+ *
+ * @param serverId - Configured MCP client server id.
+ * @param toolName - Original tool name from the remote server.
+ */
+export declare function encodeMcpToolName(serverId: string, toolName: string): string;
+/**
+ * Parses a prefixed MCP tool name into server id and original tool name.
+ *
+ * @param prefixed - Tool name from an assistant tool call.
+ */
+export declare function decodeMcpToolName(prefixed: string): {
+    serverId: string;
+    toolName: string;
+} | null;
+/**
+ * Returns whether a tool name belongs to a configured MCP client server.
+ *
+ * @param name - Tool name from the model.
+ */
+export declare function isMcpPrefixedToolName(name: string): boolean;
+//# sourceMappingURL=mcpToolNames.d.ts.map

package/dist/mcpToolNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolNames.d.ts","sourceRoot":"","sources":["../src/mcpToolNames.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAejG;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D"}

package/dist/mcpToolNames.js

@@ -0,0 +1,41 @@
+/**
+ * Prefix for MCP client tools merged into the chat agent tool list.
+ */
+export const MCP_TOOL_PREFIX = 'mcp__';
+/**
+ * Builds a prefixed MCP tool name for LLM routing.
+ *
+ * @param serverId - Configured MCP client server id.
+ * @param toolName - Original tool name from the remote server.
+ */
+export function encodeMcpToolName(serverId, toolName) {
+    return `${MCP_TOOL_PREFIX}${serverId}__${toolName}`;
+}
+/**
+ * Parses a prefixed MCP tool name into server id and original tool name.
+ *
+ * @param prefixed - Tool name from an assistant tool call.
+ */
+export function decodeMcpToolName(prefixed) {
+    if (!prefixed.startsWith(MCP_TOOL_PREFIX)) {
+        return null;
+    }
+    const rest = prefixed.slice(MCP_TOOL_PREFIX.length);
+    const separatorIndex = rest.indexOf('__');
+    if (separatorIndex <= 0) {
+        return null;
+    }
+    return {
+        serverId: rest.slice(0, separatorIndex),
+        toolName: rest.slice(separatorIndex + 2)
+    };
+}
+/**
+ * Returns whether a tool name belongs to a configured MCP client server.
+ *
+ * @param name - Tool name from the model.
+ */
+export function isMcpPrefixedToolName(name) {
+    return name.startsWith(MCP_TOOL_PREFIX);
+}
+//# sourceMappingURL=mcpToolNames.js.map

package/dist/mcpToolNames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpToolNames.js","sourceRoot":"","sources":["../src/mcpToolNames.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,QAAgB;IAClE,OAAO,GAAG,eAAe,GAAG,QAAQ,KAAK,QAAQ,EAAE,CAAC;AACtD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC;QACvC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC;KACzC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AAC1C,CAAC"}

package/dist/multipartRaw.d.ts

@@ -0,0 +1,85 @@
+import type { FormDataPart } from './types/common';
+/**
+ * Regex matching a path-embedded multipart file token on its own line.
+ */
+export declare const MULTIPART_FILE_TOKEN_RE: RegExp;
+/**
+ * Result of tolerantly parsing a raw multipart body into structured parts.
+ */
+export interface ParseMultipartRawResult {
+    /**
+     * Best-effort form parts derived from the raw text.
+     */
+    parts: FormDataPart[];
+    /**
+     * False when the raw text cannot cleanly map to structured rows (still sendable).
+     */
+    representable: boolean;
+    /**
+     * Boundary string detected in the raw text, when present.
+     */
+    boundary?: string;
+}
+/**
+ * Generates a unique multipart boundary for rendering the Raw body drawer.
+ *
+ * @returns Boundary string suitable for `multipart/form-data; boundary=…`.
+ */
+export declare function generateMultipartBoundary(): string;
+/**
+ * Builds a path-embedded file token for a multipart raw body line.
+ *
+ * @param filePath - Absolute file path to embed.
+ * @returns Token line content such as `<<file:/abs/path>>`.
+ */
+export declare function multipartFileToken(filePath: string): string;
+/**
+ * Returns whether raw multipart text contains at least one file token.
+ *
+ * Used at send time to choose between the verbatim text path and the
+ * token-expanding encoder that reads file bytes from disk.
+ *
+ * @param text - Verbatim multipart body from the Raw editor.
+ * @returns True when a `<<file:…>>` token is present.
+ */
+export declare function multipartRawHasFileTokens(text: string): boolean;
+/**
+ * Renders structured multipart form parts as editable raw wire-like text.
+ *
+ * File payloads are replaced with `<<file:/abs/path>>` tokens so binary bytes
+ * never enter the text editor. The boundary is caller-supplied so Content-Type
+ * and body stay in sync when no raw override is active.
+ *
+ * @param parts - Multipart form parts from the structured editor.
+ * @param boundary - Boundary string without leading dashes.
+ * @returns Multipart body text with CRLF line endings.
+ */
+export declare function renderMultipartRaw(parts: FormDataPart[], boundary: string): string;
+/**
+ * Detects the multipart boundary from the first `--…` line in raw text.
+ *
+ * @param text - Verbatim multipart body.
+ * @returns Boundary without leading dashes, or undefined when not found.
+ */
+export declare function detectMultipartBoundary(text: string): string | undefined;
+/**
+ * Builds a Content-Type header value for a raw multipart body.
+ *
+ * @param text - Verbatim multipart body (used to detect the boundary).
+ * @returns `multipart/form-data; boundary=…`, or without boundary when undetectable.
+ */
+export declare function multipartRawContentType(text: string): string;
+/**
+ * Tolerantly parses a raw multipart body into structured form parts.
+ *
+ * Never throws and never blocks sending. Returns `representable: false` when the
+ * text cannot cleanly map to rows (missing boundary, broken part headers, etc.)
+ * so the UI can detach the table while still sending the verbatim raw override.
+ *
+ * File tokens (`<<file:/abs/path>>`) resolve to file parts with that path.
+ *
+ * @param text - Verbatim multipart body from the Raw editor.
+ * @returns Best-effort parts plus whether they cleanly represent the raw text.
+ */
+export declare function parseMultipartRaw(text: string): ParseMultipartRawResult;
+//# sourceMappingURL=multipartRaw.d.ts.map

package/dist/multipartRaw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multipartRaw.d.ts","sourceRoot":"","sources":["../src/multipartRaw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,uBAAuB,QAAoB,CAAC;AAqBzD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,KAAK,EAAE,YAAY,EAAE,CAAC;IAEtB;;OAEG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAIlD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/D;AAYD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0ClF;AAqBD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUxE;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAyFvE"}

package/dist/multipartRaw.js

@@ -0,0 +1,244 @@
+/**
+ * Regex matching a path-embedded multipart file token on its own line.
+ */
+export const MULTIPART_FILE_TOKEN_RE = /^<<file:(.+)>>$/;
+/**
+ * Returns the final path segment of an absolute or relative file path.
+ *
+ * Avoids Node `path` so this module stays safe for the renderer bundle.
+ *
+ * @param filePath - Absolute or relative file path.
+ * @returns Filename portion after the last `/` or `\`.
+ */
+function fileBasename(filePath) {
+    const normalized = filePath.replace(/\\/g, '/');
+    const slash = normalized.lastIndexOf('/');
+    return slash === -1 ? normalized : normalized.slice(slash + 1);
+}
+/**
+ * Prefix used when generating multipart boundaries for the Raw body drawer.
+ */
+const BOUNDARY_PREFIX = '----HarborFormBoundary';
+/**
+ * Generates a unique multipart boundary for rendering the Raw body drawer.
+ *
+ * @returns Boundary string suitable for `multipart/form-data; boundary=…`.
+ */
+export function generateMultipartBoundary() {
+    const random = Math.random().toString(36).slice(2, 12);
+    const time = Date.now().toString(36);
+    return `${BOUNDARY_PREFIX}${time}${random}`;
+}
+/**
+ * Builds a path-embedded file token for a multipart raw body line.
+ *
+ * @param filePath - Absolute file path to embed.
+ * @returns Token line content such as `<<file:/abs/path>>`.
+ */
+export function multipartFileToken(filePath) {
+    return `<<file:${filePath}>>`;
+}
+/**
+ * Returns whether raw multipart text contains at least one file token.
+ *
+ * Used at send time to choose between the verbatim text path and the
+ * token-expanding encoder that reads file bytes from disk.
+ *
+ * @param text - Verbatim multipart body from the Raw editor.
+ * @returns True when a `<<file:…>>` token is present.
+ */
+export function multipartRawHasFileTokens(text) {
+    return /<<file:[^\n>]+>>/.test(text);
+}
+/**
+ * Escapes a Content-Disposition parameter value for double-quoted form fields.
+ *
+ * @param value - Name or filename to escape.
+ * @returns Value safe to place inside double quotes.
+ */
+function escapeDispositionValue(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+/**
+ * Renders structured multipart form parts as editable raw wire-like text.
+ *
+ * File payloads are replaced with `<<file:/abs/path>>` tokens so binary bytes
+ * never enter the text editor. The boundary is caller-supplied so Content-Type
+ * and body stay in sync when no raw override is active.
+ *
+ * @param parts - Multipart form parts from the structured editor.
+ * @param boundary - Boundary string without leading dashes.
+ * @returns Multipart body text with CRLF line endings.
+ */
+export function renderMultipartRaw(parts, boundary) {
+    const enabled = parts.filter((part) => part.enabled && part.key.trim());
+    if (enabled.length === 0) {
+        return '';
+    }
+    const chunks = [];
+    for (const part of enabled) {
+        const key = part.key.trim();
+        chunks.push(`--${boundary}`);
+        if (part.type === 'file') {
+            if (part.files.length === 0) {
+                chunks.push(`Content-Disposition: form-data; name="${escapeDispositionValue(key)}"; filename=""`);
+                chunks.push('');
+                chunks.push('');
+                continue;
+            }
+            part.files.forEach((filePath, index) => {
+                if (index > 0) {
+                    chunks.push(`--${boundary}`);
+                }
+                const filename = fileBasename(filePath) || 'file';
+                chunks.push(`Content-Disposition: form-data; name="${escapeDispositionValue(key)}"; filename="${escapeDispositionValue(filename)}"`);
+                chunks.push('');
+                chunks.push(multipartFileToken(filePath));
+            });
+            continue;
+        }
+        chunks.push(`Content-Disposition: form-data; name="${escapeDispositionValue(key)}"`);
+        chunks.push('');
+        chunks.push(part.value);
+    }
+    chunks.push(`--${boundary}--`);
+    return chunks.join('\r\n');
+}
+/**
+ * Extracts a quoted or token parameter value from a Content-Disposition header.
+ *
+ * @param header - Full Content-Disposition header line value.
+ * @param name - Parameter name such as `name` or `filename`.
+ * @returns Parameter value, or undefined when absent.
+ */
+function dispositionParam(header, name) {
+    const re = new RegExp(`${name}\\s*=\\s*(?:"((?:\\\\.|[^"\\\\])*)"|([^;\\s]+))`, 'i');
+    const match = header.match(re);
+    if (!match) {
+        return undefined;
+    }
+    if (match[1] !== undefined) {
+        return match[1].replace(/\\"/g, '"').replace(/\\\\/g, '\\');
+    }
+    return match[2];
+}
+/**
+ * Detects the multipart boundary from the first `--…` line in raw text.
+ *
+ * @param text - Verbatim multipart body.
+ * @returns Boundary without leading dashes, or undefined when not found.
+ */
+export function detectMultipartBoundary(text) {
+    const firstLine = text.split(/\r?\n/, 1)[0] ?? '';
+    if (!firstLine.startsWith('--')) {
+        return undefined;
+    }
+    let boundary = firstLine.slice(2);
+    if (boundary.endsWith('--')) {
+        boundary = boundary.slice(0, -2);
+    }
+    return boundary || undefined;
+}
+/**
+ * Builds a Content-Type header value for a raw multipart body.
+ *
+ * @param text - Verbatim multipart body (used to detect the boundary).
+ * @returns `multipart/form-data; boundary=…`, or without boundary when undetectable.
+ */
+export function multipartRawContentType(text) {
+    const boundary = detectMultipartBoundary(text);
+    if (!boundary) {
+        return 'multipart/form-data';
+    }
+    return `multipart/form-data; boundary=${boundary}`;
+}
+/**
+ * Tolerantly parses a raw multipart body into structured form parts.
+ *
+ * Never throws and never blocks sending. Returns `representable: false` when the
+ * text cannot cleanly map to rows (missing boundary, broken part headers, etc.)
+ * so the UI can detach the table while still sending the verbatim raw override.
+ *
+ * File tokens (`<<file:/abs/path>>`) resolve to file parts with that path.
+ *
+ * @param text - Verbatim multipart body from the Raw editor.
+ * @returns Best-effort parts plus whether they cleanly represent the raw text.
+ */
+export function parseMultipartRaw(text) {
+    if (!text.trim()) {
+        return { parts: [], representable: true };
+    }
+    const boundary = detectMultipartBoundary(text);
+    if (!boundary) {
+        return { parts: [], representable: false };
+    }
+    const delimiter = `--${boundary}`;
+    const normalized = text.replace(/\r\n/g, '\n');
+    const sections = normalized.split(delimiter);
+    const parts = [];
+    let representable = true;
+    for (const section of sections) {
+        const trimmedStart = section.replace(/^\n/, '');
+        if (!trimmedStart || trimmedStart === '--' || trimmedStart.startsWith('--')) {
+            continue;
+        }
+        const bodySeparator = trimmedStart.indexOf('\n\n');
+        if (bodySeparator === -1) {
+            representable = false;
+            continue;
+        }
+        const headerBlock = trimmedStart.slice(0, bodySeparator);
+        let body = trimmedStart.slice(bodySeparator + 2);
+        // Trailing newline before the next boundary is part of the wire format.
+        if (body.endsWith('\n')) {
+            body = body.slice(0, -1);
+        }
+        const headers = headerBlock.split('\n');
+        let disposition = '';
+        for (const line of headers) {
+            const colon = line.indexOf(':');
+            if (colon === -1) {
+                continue;
+            }
+            const name = line.slice(0, colon).trim().toLowerCase();
+            const value = line.slice(colon + 1).trim();
+            if (name === 'content-disposition') {
+                disposition = value;
+            }
+        }
+        if (!disposition) {
+            representable = false;
+            continue;
+        }
+        const fieldName = dispositionParam(disposition, 'name');
+        if (fieldName === undefined) {
+            representable = false;
+            continue;
+        }
+        const filename = dispositionParam(disposition, 'filename');
+        const tokenMatch = body.match(MULTIPART_FILE_TOKEN_RE);
+        if (filename !== undefined || tokenMatch) {
+            const filePath = tokenMatch?.[1] ?? '';
+            parts.push({
+                key: fieldName,
+                value: '',
+                enabled: true,
+                type: 'file',
+                files: filePath ? [filePath] : []
+            });
+            continue;
+        }
+        parts.push({
+            key: fieldName,
+            value: body,
+            enabled: true,
+            type: 'text',
+            files: []
+        });
+    }
+    if (parts.length === 0 && text.trim()) {
+        representable = false;
+    }
+    return { parts, representable, boundary };
+}
+//# sourceMappingURL=multipartRaw.js.map

package/dist/multipartRaw.js.map

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

package/dist/network/executeHttpSend.d.ts

@@ -0,0 +1,39 @@
+import type { GeneralSettings, SendRequestInput, SendResult } from '../types';
+import type { ICookieJar, PluginHooks, SettingsProvider } from '../interfaces';
+/**
+ * Dependencies supplied by an application host for an HTTP send.
+ */
+export interface ExecuteHttpSendDependencies {
+    /**
+     * Provides the current request-engine settings without a storage singleton.
+     */
+    settings: SettingsProvider | GeneralSettings;
+    /**
+     * Persists and supplies cookies associated with request hosts.
+     */
+    cookieJar: ICookieJar;
+    /**
+     * Optional plugin lifecycle hooks implemented by the application host.
+     */
+    pluginHooks?: PluginHooks;
+}
+/**
+ * Executes an HTTP request through the portable HarborClient HTTP stack.
+ *
+ * The caller injects persistence and plugin behavior so the engine has no
+ * dependency on Electron or application-level singletons.
+ *
+ * @param req - Outbound request payload.
+ * @param dependencies - Host-provided settings, cookie jar, and plugin hooks.
+ * @param signal - Optional abort signal for cancellation.
+ * @returns HTTP response metadata and body.
+ */
+export declare function executeHttpSend(req: SendRequestInput, dependencies: ExecuteHttpSendDependencies, signal?: AbortSignal): Promise<SendResult>;
+/**
+ * Returns whether scripts may initiate outbound HTTP under supplied settings.
+ *
+ * @param settings - Settings provider or already-resolved general settings.
+ * @returns True when hc.sendRequest is allowed.
+ */
+export declare function isScriptNetworkAllowed(settings: SettingsProvider | GeneralSettings): boolean;
+//# sourceMappingURL=executeHttpSend.d.ts.map

package/dist/network/executeHttpSend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeHttpSend.d.ts","sourceRoot":"","sources":["../../src/network/executeHttpSend.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAI/E;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,QAAQ,EAAE,gBAAgB,GAAG,eAAe,CAAC;IAE7C;;OAEG;IACH,SAAS,EAAE,UAAU,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAYD;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,YAAY,EAAE,2BAA2B,EACzC,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CA2BrB;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,eAAe,GAAG,OAAO,CAE5F"}