@jitsusama/agentic-harness.core 0.1.0

package/dist/slack/auth/store.js

@@ -0,0 +1,27 @@
+/**
+ * File-based persistence for Slack credentials.
+ *
+ * Provides shared read/write primitives used by credentials
+ * and OAuth app modules. The credentials file's location is
+ * decided by paths.ts.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { credentialsPath } from "../paths.js";
+/** Read the credentials file, returning defaults if missing or corrupt. */
+export function readFile(filePath = credentialsPath()) {
+    try {
+        const raw = fs.readFileSync(filePath, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        // The file doesn't exist or is corrupt, so we start fresh.
+        return {};
+    }
+}
+/** Write the credentials file atomically. */
+export function writeFile(data, filePath = credentialsPath()) {
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(data, null, "\t"), "utf-8");
+}

package/dist/slack/block-message.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Turns detected Slack content violations into a single
+ * skill-grounded instruction the gate hands back to the author.
+ * The message names each kind of problem and points at the
+ * slack-guide skill so the retry is informed, not a guess.
+ */
+import type { SlackViolation } from "./detect.js";
+/** Format Slack violations into a block message, or "" if none. */
+export declare function formatSlackBlock(violations: SlackViolation[]): string;

package/dist/slack/block-message.js

@@ -0,0 +1,30 @@
+/**
+ * Turns detected Slack content violations into a single
+ * skill-grounded instruction the gate hands back to the author.
+ * The message names each kind of problem and points at the
+ * slack-guide skill so the retry is informed, not a guess.
+ */
+/** Format Slack violations into a block message, or "" if none. */
+export function formatSlackBlock(violations) {
+    if (violations.length === 0)
+        return "";
+    const kinds = new Set(violations.map((v) => v.kind));
+    const lines = [
+        "This Slack message uses formatting that will not render the way",
+        "you intended. Fix it and try again, per the slack-guide skill.",
+        "",
+    ];
+    if (kinds.has("slack-image")) {
+        lines.push("- Markdown image embeds (![alt](url)) do not render in Slack.", "  Upload the image with upload_file instead of embedding it.");
+    }
+    if (kinds.has("slack-table")) {
+        lines.push("- A markdown pipe table will render as literal text. Send the", "  data through the structured table parameter instead.");
+    }
+    if (kinds.has("slack-list")) {
+        lines.push("- A list is malformed and will render as plain text. Use a", "  bullet followed by a space (- item) or `N.` ordinals, per", "  the slack-guide skill.");
+    }
+    if (kinds.has("slack-glyph-bullet")) {
+        lines.push("- A list uses glyph bullets (a \u2022, \u2023 or similar), which", "  render as literal characters, not a native list. Replace the", "  glyph with a markdown marker (- item) or `N.` ordinals, per", "  the slack-guide skill.");
+    }
+    return lines.join("\n");
+}

package/dist/slack/blocks.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Block Kit support: tokenising mrkdwn into rich text
+ * elements, building structured `rich_text` blocks (lists,
+ * quotes, code blocks, tables) for sending, rendering
+ * received rich text back to readable text and extracting
+ * tables from blocks.
+ */
+import type { SlackTable } from "./types.js";
+/** A Block Kit inline element within a rich_text_section. */
+interface RichTextElement {
+    type: string;
+    text?: string;
+    url?: string;
+    style?: {
+        bold?: boolean;
+        italic?: boolean;
+        strike?: boolean;
+        code?: boolean;
+    };
+    user_id?: string;
+    channel_id?: string;
+    range?: string;
+    name?: string;
+}
+/**
+ * Tokenise a mrkdwn string into Block Kit inline elements.
+ *
+ * Scans left to right, matching patterns in priority order:
+ * angle brackets (unambiguous), backticks, then inline
+ * styles with word-boundary rules. Plain text between
+ * patterns becomes `text` elements. Adjacent plain segments
+ * are merged.
+ */
+export declare function parseMrkdwnToElements(text: string): RichTextElement[];
+/**
+ * Convert a mrkdwn string to a Block Kit table cell.
+ *
+ * Returns `raw_text` for plain strings (the common case)
+ * and `rich_text` for strings with formatting. Empty strings
+ * become `raw_text` with a zero-width space.
+ */
+export declare function mrkdwnToCell(text: string): unknown;
+/**
+ * Render a `rich_text` table cell to readable text.
+ *
+ * Walks the cell's elements → rich_text_section → inline
+ * elements, converting each to text.
+ */
+export declare function renderRichTextCell(cell: unknown): string;
+/**
+ * Extract the text content from a single table cell.
+ *
+ * Handles both `raw_text` (returns `.text` directly) and
+ * `rich_text` (renders inline elements to readable text).
+ */
+export declare function extractCellText(cell: unknown): string;
+/**
+ * Extract tables from a raw Block Kit blocks array.
+ *
+ * Finds all blocks with `type === "table"`, extracts
+ * headers, rows, and column settings from each.
+ */
+export declare function extractTables(blocks: unknown[]): SlackTable[];
+/**
+ * Build a Block Kit `blocks` array from mrkdwn-style text.
+ *
+ * Walks the text line by line, producing a mix of
+ * top-level blocks:
+ *
+ * - `rich_text` for paragraphs, lists, quotes and code
+ *   fences. Inline formatting inside each line goes
+ *   through {@link parseMrkdwnToElements}, which also
+ *   handles markdown-style links, double-marker styles
+ *   and the colour-swatch shield.
+ * - `header` for `#`-prefixed lines.
+ * - `divider` for thematic breaks (`---`, `***`, `___`).
+ *
+ * Returns the array plus a `hasStructure` flag the caller
+ * can use to decide whether sending blocks (instead of
+ * plain mrkdwn) actually changes how the message renders.
+ */
+export declare function mrkdwnToBlocks(text: string): {
+    blocks: unknown[];
+    hasStructure: boolean;
+};
+/**
+ * Build a Block Kit table block from a `SlackTable`.
+ *
+ * Converts mrkdwn strings in columns and rows to Block Kit
+ * cell elements. Maps `columnSettings` to Block Kit's
+ * `column_settings` format.
+ */
+export declare function tableToBlock(table: SlackTable): unknown;
+export {};