@molecule/app-ide-react 1.0.0

package/dist/components/chat-report-utilities.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Pure helpers backing the `/report` (and `/bug` alias) command and the header
+ * bug-report button.
+ *
+ * The report modal collects a title, description, optional reproduction steps,
+ * and an "include recent chat" toggle, then POSTs to
+ * `POST /projects/:id/report { title, description, steps?, includeChat, clientInfo? }`.
+ * The backend files a GitHub issue when a report repo + token are configured
+ * (else records a DB row) and always persists a DB row tagged with
+ * projectId+userId, returning `{ ok, url?, id }`.
+ *
+ * The payload also carries an optional `clientInfo` block of client-side
+ * diagnostics — app version, browser/OS (user agent + platform), language,
+ * viewport + screen size, theme, and the current URL — collected by
+ * {@link collectClientInfo}. Every field is read defensively (each guarded for
+ * SSR / missing globals) so the report attaches whatever it can without ever
+ * throwing, giving triage real context without the user having to type it.
+ *
+ * These helpers parse the command, build the exact POST payload (omitting empty
+ * optional fields), validate the form, and produce a confirmation message. They
+ * are deterministic and side-effect free so they can be unit tested without
+ * rendering or a real backend. The confirmation/link rendering uses these values
+ * with `t()` in the component — the only translatable strings here are the
+ * confirmation defaults, kept i18n-ready by the caller.
+ *
+ * @module
+ */
+/** The report modal's form state. */
+export interface ReportFormState {
+    /** Short summary / issue title. */
+    title: string;
+    /** Detailed description of the problem or request. */
+    description: string;
+    /** Optional reproduction steps (free text). */
+    steps: string;
+    /** Whether to attach the recent conversation to the report. */
+    includeChat: boolean;
+}
+/**
+ * Client-side diagnostics attached to a report so triage can see the running
+ * environment without asking the user. Every field is optional — only what
+ * could be read in the current environment is present (see
+ * {@link collectClientInfo}).
+ */
+export interface ClientInfo {
+    /** The running build version. */
+    appVersion?: string;
+    /** `navigator.userAgent` (browser + OS). */
+    userAgent?: string;
+    /** `navigator.platform`. */
+    platform?: string;
+    /** `navigator.language`. */
+    language?: string;
+    /** Inner viewport size, `${innerWidth}×${innerHeight}`. */
+    viewport?: string;
+    /** Physical screen size, `${screen.width}×${screen.height}`. */
+    screen?: string;
+    /** Active theme — `'light'` or `'dark'`. */
+    theme?: string;
+    /** The current page URL (`window.location.href`). */
+    url?: string;
+}
+/** The `POST /projects/:id/report` request body. */
+export interface ReportPayload {
+    /** Short summary / issue title. */
+    title: string;
+    /** Detailed description. */
+    description: string;
+    /** Reproduction steps — omitted entirely when blank. */
+    steps?: string;
+    /** Whether the backend should attach the recent conversation. */
+    includeChat: boolean;
+    /** Client diagnostics — omitted entirely when none could be collected. */
+    clientInfo?: ClientInfo;
+}
+/** The `POST /projects/:id/report` response. */
+export interface ReportResult {
+    /** Whether the report was recorded. */
+    ok: boolean;
+    /** Link to the created issue, when one was filed. */
+    url?: string;
+    /** The persisted DB row id. */
+    id?: string;
+}
+/** An empty report form (the modal's initial state). */
+export declare const EMPTY_REPORT_FORM: ReportFormState;
+/**
+ * Parses a `/report [title]` or `/bug [title]` command. Returns the (possibly
+ * empty) trimmed title used to seed the modal when the input is one of those
+ * commands, else `null`.
+ *
+ * @param input - The raw chat input.
+ * @returns `{ title }` when it's a `/report` or `/bug` command, else `null`.
+ */
+export declare function parseReportCommand(input: string): {
+    title: string;
+} | null;
+/**
+ * Collects client-side diagnostics for a report. Reads `navigator`
+ * (userAgent/platform/language), `window` (inner viewport size, screen size,
+ * location href), plus the caller-supplied app version and theme. Every access
+ * is guarded (`typeof window/navigator !== 'undefined'` and per-property
+ * presence) so it is SSR-safe and never throws — it returns only the fields it
+ * could actually read, so the result may be partial or (in a headless
+ * environment) empty.
+ *
+ * @param opts - Caller-supplied context.
+ * @param opts.appVersion - The running build version, if known.
+ * @param opts.theme - The active theme (`'light'` | `'dark'`), if known.
+ * @returns The populated subset of {@link ClientInfo}.
+ */
+export declare function collectClientInfo(opts?: {
+    appVersion?: string;
+    theme?: string;
+}): ClientInfo;
+/**
+ * Builds the `POST /projects/:id/report` body from the form state, trimming all
+ * text fields and omitting `steps` entirely when it is blank. When `clientInfo`
+ * is supplied and non-empty, it is attached; an `undefined` or empty diagnostics
+ * object is omitted from the payload.
+ *
+ * @param form - The report form state.
+ * @param clientInfo - Optional client diagnostics from {@link collectClientInfo}.
+ * @returns The normalized report payload.
+ */
+export declare function buildReportPayload(form: ReportFormState, clientInfo?: ClientInfo): ReportPayload;
+/**
+ * Whether the report form has the minimum required fields: a non-empty title
+ * and a non-empty description.
+ *
+ * @param form - The report form state.
+ * @returns `true` when the form can be submitted.
+ */
+export declare function isReportFormValid(form: ReportFormState): boolean;
+/**
+ * Builds the confirmation message shown after a report is submitted. Returns the
+ * English defaults; the component passes these through `t()` at render. The
+ * success `defaultValue` may contain the `{{productName}}` interpolation token,
+ * which the caller fills in from the host's product identity (neutral default:
+ * "the IDE"). When the result is not `ok`, returns the failure message.
+ *
+ * @param result - The `POST /projects/:id/report` response.
+ * @returns `{ key, defaultValue }` for the confirmation/failure message.
+ */
+export declare function formatReportConfirmation(result: ReportResult): {
+    key: string;
+    defaultValue: string;
+};
+//# sourceMappingURL=chat-report-utilities.d.ts.map

package/dist/components/chat-report-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-report-utilities.d.ts","sourceRoot":"","sources":["../../src/components/chat-report-utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,WAAW,EAAE,OAAO,CAAA;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,WAAW,EAAE,OAAO,CAAA;IACpB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,UAAU,CAAA;CACxB;AAED,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,EAAE,EAAE,OAAO,CAAA;IACX,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,+BAA+B;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED,wDAAwD;AACxD,eAAO,MAAM,iBAAiB,EAAE,eAK/B,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI1E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,UAAU,CAwBhG;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,UAAU,GAAG,aAAa,CAUhG;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAEhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG;IAC9D,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;CACrB,CAiBA"}

package/dist/components/chat-report-utilities.js

@@ -0,0 +1,151 @@
+/**
+ * Pure helpers backing the `/report` (and `/bug` alias) command and the header
+ * bug-report button.
+ *
+ * The report modal collects a title, description, optional reproduction steps,
+ * and an "include recent chat" toggle, then POSTs to
+ * `POST /projects/:id/report { title, description, steps?, includeChat, clientInfo? }`.
+ * The backend files a GitHub issue when a report repo + token are configured
+ * (else records a DB row) and always persists a DB row tagged with
+ * projectId+userId, returning `{ ok, url?, id }`.
+ *
+ * The payload also carries an optional `clientInfo` block of client-side
+ * diagnostics — app version, browser/OS (user agent + platform), language,
+ * viewport + screen size, theme, and the current URL — collected by
+ * {@link collectClientInfo}. Every field is read defensively (each guarded for
+ * SSR / missing globals) so the report attaches whatever it can without ever
+ * throwing, giving triage real context without the user having to type it.
+ *
+ * These helpers parse the command, build the exact POST payload (omitting empty
+ * optional fields), validate the form, and produce a confirmation message. They
+ * are deterministic and side-effect free so they can be unit tested without
+ * rendering or a real backend. The confirmation/link rendering uses these values
+ * with `t()` in the component — the only translatable strings here are the
+ * confirmation defaults, kept i18n-ready by the caller.
+ *
+ * @module
+ */
+/** An empty report form (the modal's initial state). */
+export const EMPTY_REPORT_FORM = {
+    title: '',
+    description: '',
+    steps: '',
+    includeChat: true,
+};
+/**
+ * Parses a `/report [title]` or `/bug [title]` command. Returns the (possibly
+ * empty) trimmed title used to seed the modal when the input is one of those
+ * commands, else `null`.
+ *
+ * @param input - The raw chat input.
+ * @returns `{ title }` when it's a `/report` or `/bug` command, else `null`.
+ */
+export function parseReportCommand(input) {
+    const match = input.trim().match(/^\/(?:report|bug)(?:\s+(.*))?$/i);
+    if (!match)
+        return null;
+    return { title: (match[1] ?? '').trim() };
+}
+/**
+ * Collects client-side diagnostics for a report. Reads `navigator`
+ * (userAgent/platform/language), `window` (inner viewport size, screen size,
+ * location href), plus the caller-supplied app version and theme. Every access
+ * is guarded (`typeof window/navigator !== 'undefined'` and per-property
+ * presence) so it is SSR-safe and never throws — it returns only the fields it
+ * could actually read, so the result may be partial or (in a headless
+ * environment) empty.
+ *
+ * @param opts - Caller-supplied context.
+ * @param opts.appVersion - The running build version, if known.
+ * @param opts.theme - The active theme (`'light'` | `'dark'`), if known.
+ * @returns The populated subset of {@link ClientInfo}.
+ */
+export function collectClientInfo(opts = {}) {
+    const info = {};
+    if (opts.appVersion)
+        info.appVersion = opts.appVersion;
+    if (opts.theme)
+        info.theme = opts.theme;
+    if (typeof navigator !== 'undefined') {
+        if (navigator.userAgent)
+            info.userAgent = navigator.userAgent;
+        if (navigator.platform)
+            info.platform = navigator.platform;
+        if (navigator.language)
+            info.language = navigator.language;
+    }
+    if (typeof window !== 'undefined') {
+        if (typeof window.innerWidth === 'number' && typeof window.innerHeight === 'number') {
+            info.viewport = `${window.innerWidth}×${window.innerHeight}`;
+        }
+        if (window.screen) {
+            info.screen = `${window.screen.width}×${window.screen.height}`;
+        }
+        if (window.location?.href) {
+            info.url = window.location.href;
+        }
+    }
+    return info;
+}
+/**
+ * Builds the `POST /projects/:id/report` body from the form state, trimming all
+ * text fields and omitting `steps` entirely when it is blank. When `clientInfo`
+ * is supplied and non-empty, it is attached; an `undefined` or empty diagnostics
+ * object is omitted from the payload.
+ *
+ * @param form - The report form state.
+ * @param clientInfo - Optional client diagnostics from {@link collectClientInfo}.
+ * @returns The normalized report payload.
+ */
+export function buildReportPayload(form, clientInfo) {
+    const steps = form.steps.trim();
+    const payload = {
+        title: form.title.trim(),
+        description: form.description.trim(),
+        includeChat: form.includeChat,
+    };
+    if (steps)
+        payload.steps = steps;
+    if (clientInfo && Object.keys(clientInfo).length > 0)
+        payload.clientInfo = clientInfo;
+    return payload;
+}
+/**
+ * Whether the report form has the minimum required fields: a non-empty title
+ * and a non-empty description.
+ *
+ * @param form - The report form state.
+ * @returns `true` when the form can be submitted.
+ */
+export function isReportFormValid(form) {
+    return form.title.trim().length > 0 && form.description.trim().length > 0;
+}
+/**
+ * Builds the confirmation message shown after a report is submitted. Returns the
+ * English defaults; the component passes these through `t()` at render. The
+ * success `defaultValue` may contain the `{{productName}}` interpolation token,
+ * which the caller fills in from the host's product identity (neutral default:
+ * "the IDE"). When the result is not `ok`, returns the failure message.
+ *
+ * @param result - The `POST /projects/:id/report` response.
+ * @returns `{ key, defaultValue }` for the confirmation/failure message.
+ */
+export function formatReportConfirmation(result) {
+    if (!result.ok) {
+        return {
+            key: 'ide.chat.report.failed',
+            defaultValue: 'Could not submit your report. Please try again.',
+        };
+    }
+    if (result.url) {
+        return {
+            key: 'ide.chat.report.submittedWithLink',
+            defaultValue: 'Thanks! Your report was submitted — track it on the linked issue.',
+        };
+    }
+    return {
+        key: 'ide.chat.report.submitted',
+        defaultValue: "Thanks! Your report was submitted to {{productName}}'s team.",
+    };
+}
+//# sourceMappingURL=chat-report-utilities.js.map

package/dist/components/chat-report-utilities.js.map

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

package/dist/components/chat-scripts-utilities.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Pure helpers backing the `/scripts` browser and the `/run <name>` command.
+ *
+ * Scripts are saved shell files under the project's `.agents/scripts/` tree
+ * (`.agents/scripts/<name>.sh`) carrying a YAML frontmatter header (`name`,
+ * `description`, `createdAt`). The UI lists them via `GET /projects/:id/scripts`,
+ * runs one via `POST /projects/:id/scripts/:name/run`, and saves a new one (e.g.
+ * one the agent just generated) via `POST /projects/:id/scripts`.
+ *
+ * These helpers parse the slash commands, normalize a script name into the safe
+ * filename base the backend expects, resolve a typed `/run` argument against the
+ * known scripts, filter the list for the browser, and assemble a run's raw
+ * output for display. They are deterministic and side-effect free so they can be
+ * unit tested without rendering or a real backend. Any user-facing prose
+ * (status labels, empty states) lives in the components via `t()`, never here —
+ * `formatRunOutput` returns only the command's own (untranslatable) stdout/stderr.
+ *
+ * @module
+ */
+/** A saved project script's metadata (the body lives in the sandbox file). */
+export interface ScriptInfo {
+    /** Script name — the `<name>` in `.agents/scripts/<name>.sh` (no extension). */
+    name: string;
+    /** One-line description (from the script's YAML frontmatter `description`). */
+    description: string;
+    /** ISO 8601 creation timestamp (frontmatter `createdAt`). */
+    createdAt: string;
+}
+/** The result of running a script via the sandbox `exec`. */
+export interface ScriptRunResult {
+    /** Captured standard output. */
+    stdout: string;
+    /** Captured standard error. */
+    stderr: string;
+    /** Process exit code (`0` = success). */
+    exitCode: number;
+}
+/** The `POST /projects/:id/scripts` request body for saving a script. */
+export interface SaveScriptPayload {
+    /** Normalized script name (the filename base, no `.sh`). */
+    name: string;
+    /** One-line description stored in the frontmatter header. */
+    description: string;
+    /** The shell script body. */
+    body: string;
+}
+/**
+ * Normalizes a raw, possibly user- or AI-supplied script name into the safe
+ * filename base the backend writes as `.agents/scripts/<name>.sh`: lowercased,
+ * a trailing `.sh` dropped, every run of disallowed characters collapsed to a
+ * single `-`, and leading/trailing `-` trimmed. Returns `''` when nothing usable
+ * remains (the caller should treat that as invalid).
+ *
+ * @param raw - The raw script name (e.g. `'Run Tests.sh'`).
+ * @returns The normalized base name (e.g. `'run-tests'`), or `''`.
+ */
+export declare function normalizeScriptName(raw: string): string;
+/**
+ * Parses a `/scripts [query]` command. Returns the (possibly empty) trimmed
+ * filter query when the input is the `/scripts` command, else `null`.
+ *
+ * @param input - The raw chat input.
+ * @returns `{ query }` when it's a `/scripts` command, else `null`.
+ */
+export declare function parseScriptsCommand(input: string): {
+    query: string;
+} | null;
+/**
+ * Parses a `/run [name]` command. Returns the (possibly empty) trimmed script
+ * name when the input is the `/run` command, else `null`. An empty `name`
+ * signals `/run` was typed without an argument.
+ *
+ * @param input - The raw chat input.
+ * @returns `{ name }` when it's a `/run` command, else `null`.
+ */
+export declare function parseRunCommand(input: string): {
+    name: string;
+} | null;
+/**
+ * Resolves a `/run` name argument against the known scripts. Tries, in order:
+ * exact (case-insensitive, `.sh`-insensitive) match, then a unique prefix match,
+ * then a unique substring match. Returns `undefined` when there is no match or
+ * the match is ambiguous (more than one prefix/substring candidate).
+ *
+ * @param scripts - The known scripts.
+ * @param name - The raw name argument (may include a `.sh` suffix).
+ * @returns The single matching script, or `undefined`.
+ */
+export declare function findScriptByName(scripts: readonly ScriptInfo[], name: string): ScriptInfo | undefined;
+/**
+ * Filters scripts by a free-text query, matching (case-insensitively) against
+ * the name and description. An empty/blank query returns all scripts in input
+ * order.
+ *
+ * @param scripts - The scripts to filter.
+ * @param query - The search query.
+ * @returns The matching scripts, in input order.
+ */
+export declare function filterScripts(scripts: readonly ScriptInfo[], query: string): ScriptInfo[];
+/**
+ * Assembles a run's raw output for display: stdout followed by stderr (each
+ * trimmed of trailing whitespace), joined by a blank line when both are present.
+ * Returns `''` when the run produced no output — the component decides how to
+ * render an empty result. Contains no translatable prose; the exit-status label
+ * is rendered separately by the component via `t()`.
+ *
+ * @param result - The script run result.
+ * @returns The combined stdout/stderr text (possibly empty).
+ */
+export declare function formatRunOutput(result: ScriptRunResult): string;
+/**
+ * Whether a run succeeded (exit code `0`).
+ *
+ * @param result - The script run result.
+ * @returns `true` when `exitCode === 0`.
+ */
+export declare function runSucceeded(result: ScriptRunResult): boolean;
+/**
+ * Builds the `POST /projects/:id/scripts` body from raw form/AI input,
+ * normalizing the name and trimming the description and body. The backend adds
+ * the YAML frontmatter header (`name`, `description`, `createdAt`); the body
+ * here is the script content only.
+ *
+ * @param input - The raw `{ name, description, body }` to save.
+ * @returns The normalized save payload.
+ */
+export declare function buildSaveScriptPayload(input: {
+    name: string;
+    description: string;
+    body: string;
+}): SaveScriptPayload;
+/**
+ * Whether a save payload has the minimum required fields: a non-empty
+ * normalized name and a non-empty body.
+ *
+ * @param payload - The save payload to validate.
+ * @returns `true` when the payload can be saved.
+ */
+export declare function isSaveScriptValid(payload: SaveScriptPayload): boolean;
+//# sourceMappingURL=chat-scripts-utilities.d.ts.map

package/dist/components/chat-scripts-utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-scripts-utilities.d.ts","sourceRoot":"","sources":["../../src/components/chat-scripts-utilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAA;IACZ,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAA;IACnB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAA;IACnB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQvD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAI3E;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAItE;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,IAAI,EAAE,MAAM,GACX,UAAU,GAAG,SAAS,CAUxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE,CAMzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAK/D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAE7D;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,iBAAiB,CAMpB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAErE"}

package/dist/components/chat-scripts-utilities.js

@@ -0,0 +1,158 @@
+/**
+ * Pure helpers backing the `/scripts` browser and the `/run <name>` command.
+ *
+ * Scripts are saved shell files under the project's `.agents/scripts/` tree
+ * (`.agents/scripts/<name>.sh`) carrying a YAML frontmatter header (`name`,
+ * `description`, `createdAt`). The UI lists them via `GET /projects/:id/scripts`,
+ * runs one via `POST /projects/:id/scripts/:name/run`, and saves a new one (e.g.
+ * one the agent just generated) via `POST /projects/:id/scripts`.
+ *
+ * These helpers parse the slash commands, normalize a script name into the safe
+ * filename base the backend expects, resolve a typed `/run` argument against the
+ * known scripts, filter the list for the browser, and assemble a run's raw
+ * output for display. They are deterministic and side-effect free so they can be
+ * unit tested without rendering or a real backend. Any user-facing prose
+ * (status labels, empty states) lives in the components via `t()`, never here —
+ * `formatRunOutput` returns only the command's own (untranslatable) stdout/stderr.
+ *
+ * @module
+ */
+/**
+ * Normalizes a raw, possibly user- or AI-supplied script name into the safe
+ * filename base the backend writes as `.agents/scripts/<name>.sh`: lowercased,
+ * a trailing `.sh` dropped, every run of disallowed characters collapsed to a
+ * single `-`, and leading/trailing `-` trimmed. Returns `''` when nothing usable
+ * remains (the caller should treat that as invalid).
+ *
+ * @param raw - The raw script name (e.g. `'Run Tests.sh'`).
+ * @returns The normalized base name (e.g. `'run-tests'`), or `''`.
+ */
+export function normalizeScriptName(raw) {
+    return raw
+        .trim()
+        .replace(/\.sh$/i, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * Parses a `/scripts [query]` command. Returns the (possibly empty) trimmed
+ * filter query when the input is the `/scripts` command, else `null`.
+ *
+ * @param input - The raw chat input.
+ * @returns `{ query }` when it's a `/scripts` command, else `null`.
+ */
+export function parseScriptsCommand(input) {
+    const match = input.trim().match(/^\/scripts(?:\s+(.*))?$/i);
+    if (!match)
+        return null;
+    return { query: (match[1] ?? '').trim() };
+}
+/**
+ * Parses a `/run [name]` command. Returns the (possibly empty) trimmed script
+ * name when the input is the `/run` command, else `null`. An empty `name`
+ * signals `/run` was typed without an argument.
+ *
+ * @param input - The raw chat input.
+ * @returns `{ name }` when it's a `/run` command, else `null`.
+ */
+export function parseRunCommand(input) {
+    const match = input.trim().match(/^\/run(?:\s+(.*))?$/i);
+    if (!match)
+        return null;
+    return { name: (match[1] ?? '').trim() };
+}
+/**
+ * Resolves a `/run` name argument against the known scripts. Tries, in order:
+ * exact (case-insensitive, `.sh`-insensitive) match, then a unique prefix match,
+ * then a unique substring match. Returns `undefined` when there is no match or
+ * the match is ambiguous (more than one prefix/substring candidate).
+ *
+ * @param scripts - The known scripts.
+ * @param name - The raw name argument (may include a `.sh` suffix).
+ * @returns The single matching script, or `undefined`.
+ */
+export function findScriptByName(scripts, name) {
+    const q = normalizeScriptName(name);
+    if (!q)
+        return undefined;
+    const exact = scripts.find((s) => normalizeScriptName(s.name) === q);
+    if (exact)
+        return exact;
+    const prefix = scripts.filter((s) => normalizeScriptName(s.name).startsWith(q));
+    if (prefix.length === 1)
+        return prefix[0];
+    if (prefix.length > 1)
+        return undefined;
+    const substring = scripts.filter((s) => normalizeScriptName(s.name).includes(q));
+    return substring.length === 1 ? substring[0] : undefined;
+}
+/**
+ * Filters scripts by a free-text query, matching (case-insensitively) against
+ * the name and description. An empty/blank query returns all scripts in input
+ * order.
+ *
+ * @param scripts - The scripts to filter.
+ * @param query - The search query.
+ * @returns The matching scripts, in input order.
+ */
+export function filterScripts(scripts, query) {
+    const q = query.trim().toLowerCase();
+    if (!q)
+        return [...scripts];
+    return scripts.filter((s) => s.name.toLowerCase().includes(q) || s.description.toLowerCase().includes(q));
+}
+/**
+ * Assembles a run's raw output for display: stdout followed by stderr (each
+ * trimmed of trailing whitespace), joined by a blank line when both are present.
+ * Returns `''` when the run produced no output — the component decides how to
+ * render an empty result. Contains no translatable prose; the exit-status label
+ * is rendered separately by the component via `t()`.
+ *
+ * @param result - The script run result.
+ * @returns The combined stdout/stderr text (possibly empty).
+ */
+export function formatRunOutput(result) {
+    const out = (result.stdout ?? '').replace(/\s+$/, '');
+    const err = (result.stderr ?? '').replace(/\s+$/, '');
+    if (out && err)
+        return `${out}\n\n${err}`;
+    return out || err;
+}
+/**
+ * Whether a run succeeded (exit code `0`).
+ *
+ * @param result - The script run result.
+ * @returns `true` when `exitCode === 0`.
+ */
+export function runSucceeded(result) {
+    return result.exitCode === 0;
+}
+/**
+ * Builds the `POST /projects/:id/scripts` body from raw form/AI input,
+ * normalizing the name and trimming the description and body. The backend adds
+ * the YAML frontmatter header (`name`, `description`, `createdAt`); the body
+ * here is the script content only.
+ *
+ * @param input - The raw `{ name, description, body }` to save.
+ * @returns The normalized save payload.
+ */
+export function buildSaveScriptPayload(input) {
+    return {
+        name: normalizeScriptName(input.name),
+        description: input.description.trim(),
+        body: input.body.replace(/\s+$/, ''),
+    };
+}
+/**
+ * Whether a save payload has the minimum required fields: a non-empty
+ * normalized name and a non-empty body.
+ *
+ * @param payload - The save payload to validate.
+ * @returns `true` when the payload can be saved.
+ */
+export function isSaveScriptValid(payload) {
+    return payload.name.length > 0 && payload.body.trim().length > 0;
+}
+//# sourceMappingURL=chat-scripts-utilities.js.map

package/dist/components/chat-scripts-utilities.js.map

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