@urateam/core 0.1.0

package/dist/pm/slack-helpers.js

@@ -0,0 +1,24 @@
+import { createLogger } from "../logger.js";
+const log = createLogger({ component: "PmAgent:slack" });
+export async function postSlackMessage(botToken, payload) {
+    try {
+        const resp = await fetch("https://slack.com/api/chat.postMessage", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${botToken}`,
+            },
+            body: JSON.stringify(payload),
+        });
+        const data = await resp.json();
+        if (!data?.ok) {
+            log.warn({ error: data?.error }, "Slack chat.postMessage returned ok:false");
+        }
+        return data;
+    }
+    catch (err) {
+        log.error({ err }, "Slack postMessage failed");
+        return null;
+    }
+}
+//# sourceMappingURL=slack-helpers.js.map

package/dist/pm/slack-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-helpers.js","sourceRoot":"","sources":["../../src/pm/slack-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB,EAAE,OAAe;IACtE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,wCAAwC,EAAE;YACjE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,QAAQ,EAAE;aACpC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAS,CAAC;QACtC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC;YACd,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,0CAA0C,CAAC,CAAC;QAC/E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,0BAA0B,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/pm/slack-interface.d.ts

@@ -0,0 +1,133 @@
+/**
+ * PM Agent Slack Interface — bidirectional human-agent communication.
+ *
+ * Inbound:
+ *   POST /slack/commands  — slash commands (/pm prioritize, /pm create, …)
+ *   POST /slack/events    — Events API (natural language messages + URL verification)
+ *
+ * Outbound helpers (call from PM scheduler):
+ *   notifyAssigned, notifySkipped, askForClarification, postDailySummary
+ */
+import { Hono } from "hono";
+export interface SlackInterfaceConfig {
+    /** Slack signing secret for request verification */
+    signingSecret: string;
+    /** Slack bot OAuth token (xoxb-…) */
+    botToken: string;
+    /** Channel to send proactive PM notifications to */
+    channelId: string;
+    /** Linear API key (needed for create / prioritize / assign commands) */
+    linearApiKey?: string;
+    /** Team IDs for issue creation commands */
+    teamIds?: string[];
+    /** Optional injectable for testing */
+    callClaude?: (prompt: string) => Promise<string>;
+    /** Optional Sonnet-model callable for bulk create analysis (defaults to Sonnet if not provided) */
+    callClaudeSonnet?: (prompt: string) => Promise<string>;
+}
+export type PmCommand = {
+    type: "prioritize";
+    issueId: string;
+} | {
+    type: "create";
+    title: string;
+    description: string;
+} | {
+    type: "bulk_create";
+    request: string;
+} | {
+    type: "status";
+} | {
+    type: "pause";
+} | {
+    type: "resume";
+} | {
+    type: "assign";
+    issueId: string;
+} | {
+    type: "unknown";
+    original: string;
+};
+export interface AssignedNotification {
+    issueId: string;
+    issueTitle: string;
+    reasoning: string;
+    issueUrl?: string;
+}
+export interface SkippedNotification {
+    issueId: string;
+    issueTitle: string;
+    reasoning: string;
+}
+export interface DailySummaryEntry {
+    issueId: string;
+    issueTitle: string;
+    status: "assigned" | "completed" | "blocked";
+}
+export declare function isPmPaused(): boolean;
+export declare function setPmPaused(value: boolean): void;
+/**
+ * Verifies the Slack signing secret against the X-Slack-Signature header.
+ * Returns `true` if valid, `false` otherwise.
+ *
+ * See https://api.slack.com/authentication/verifying-requests-from-slack
+ */
+export declare function verifySlackSignature(rawBody: string, timestamp: string, signature: string, signingSecret: string): Promise<boolean>;
+export declare function parsePmCommand(text: string): PmCommand;
+/**
+ * Interprets a free-text Slack message as a `PmCommand` using Claude.
+ * Returns `{ type: "unknown", original }` if no actionable intent is found.
+ */
+export declare function interpretNaturalLanguage(message: string, callClaude: (prompt: string) => Promise<string>): Promise<PmCommand>;
+export interface BulkIssueSpec {
+    title: string;
+    description: string;
+    priority: number;
+    acceptanceCriteria: string[];
+}
+export interface CommandExecutorDeps {
+    linearApiKey?: string;
+    teamIds?: string[];
+    callClaudeSonnet?: (prompt: string) => Promise<string>;
+}
+/**
+ * Executes a parsed `PmCommand` against Linear and returns a human-readable
+ * response string suitable for posting back to Slack.
+ */
+export declare function executePmCommand(cmd: PmCommand, deps: CommandExecutorDeps): Promise<string>;
+export declare class SlackInterfaceNotifier {
+    private botToken;
+    private channelId;
+    constructor(config: Pick<SlackInterfaceConfig, "botToken" | "channelId">);
+    /** Called when PM Agent promotes an issue to Todo. */
+    notifyAssigned(n: AssignedNotification): Promise<void>;
+    /** Called when PM Agent skips/deprioritizes an issue. */
+    notifySkipped(n: SkippedNotification): Promise<void>;
+    /** Ask a human for input when priority is ambiguous. */
+    askForClarification(question: string): Promise<void>;
+    /** Post a daily summary of assigned, completed, and blocked issues. */
+    postDailySummary(entries: DailySummaryEntry[], date?: string): Promise<void>;
+    private postMessage;
+}
+/**
+ * Creates a Hono router that handles Slack slash commands and Events API
+ * messages for the PM Agent.
+ *
+ * Mount it in your app:
+ *   const { router } = createSlackInterface(config);
+ *   app.route("/", router);
+ *
+ * The router registers:
+ *   POST /slack/commands — Slack slash command handler
+ *   POST /slack/events   — Slack Events API handler
+ */
+export declare function createSlackInterface(config: SlackInterfaceConfig): {
+    router: Hono;
+    notifier: SlackInterfaceNotifier;
+};
+/**
+ * Uses a capable Claude model (Sonnet) to analyze a bulk create request and
+ * produce a structured list of issue specifications.
+ */
+export declare function analyzeBulkCreateRequest(request: string, callClaudeSonnet: (prompt: string) => Promise<string>): Promise<BulkIssueSpec[]>;
+//# sourceMappingURL=slack-interface.d.ts.map

package/dist/pm/slack-interface.d.ts.map

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