kortext 2.2.3 → 3.0.0

package/dist/server/engine/workflow-parser.js

@@ -0,0 +1,158 @@
+import { readFileSync } from 'node:fs';
+import { basename } from 'node:path';
+const PERSONA_RE = /^\*\*(\+[\w-]+):\*\*\s*(.*)$/;
+const PHASE_HEADING_RE = /^##\s+(.+?)\s*$/;
+const STEP_BULLET_RE = /^(\d+)\.\s+(.*)$/;
+const SUB_BULLET_RE = /^\s*[-*]\s+([A-Za-z]+):\s*(.+?)\s*$/;
+const NOTE_OPEN_RE = /^>\s*\[!(NOTE|TIP|INFO|WARNING)\]/i;
+const NEXT_WORKFLOW_RE = /\*\*Sonraki akış[^:]*:\*\*\s*(?:onay sonrası\s+)?`([^`]+)`/i;
+const START_COMMAND_RE = /`!start\s+([\w-]+)`/i;
+const PERSONA_HANDLE_RE = /(\+[\w-]+)/;
+function slugifyPhase(phase) {
+    return phase
+        .toLowerCase()
+        .replace(/[^\w\s-]/g, '')
+        .trim()
+        .replace(/\s+/g, '-');
+}
+function splitList(value) {
+    return value
+        .replace(/`/g, '')
+        .split(',')
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+}
+export function parseWorkflowMarkdown(source, fileId) {
+    const lines = source.split('\n');
+    let title = fileId;
+    let startCommand = null;
+    let nextWorkflowId = null;
+    const steps = [];
+    const gates = [];
+    let currentPhase = '__preamble__';
+    let stepCounter = 0;
+    let stepByPhaseCount = new Map();
+    // Cursor state while consuming a step's sub-bullets.
+    let activeStep = null;
+    const flushStep = () => {
+        if (activeStep) {
+            steps.push(activeStep);
+            activeStep = null;
+        }
+    };
+    const noteCollect = (startIdx) => {
+        const bodyLines = [];
+        let i = startIdx;
+        while (i < lines.length) {
+            const line = lines[i];
+            if (line === undefined)
+                break;
+            if (!line.startsWith('>'))
+                break;
+            bodyLines.push(line.replace(/^>\s?/, ''));
+            i += 1;
+        }
+        return { body: bodyLines.join('\n').trim(), consumedTo: i - 1 };
+    };
+    for (let i = 0; i < lines.length; i += 1) {
+        const raw = lines[i] ?? '';
+        const line = raw.replace(/\r$/, '');
+        if (i === 0 || (title === fileId && line.startsWith('# '))) {
+            const h1 = line.match(/^#\s+(.+?)\s*$/);
+            if (h1?.[1]) {
+                title = h1[1].replace(/`[^`]*`/g, '').trim();
+                const cmd = line.match(START_COMMAND_RE);
+                if (cmd?.[1])
+                    startCommand = cmd[1];
+            }
+        }
+        const phaseMatch = line.match(PHASE_HEADING_RE);
+        if (phaseMatch?.[1]) {
+            flushStep();
+            currentPhase = phaseMatch[1].trim();
+            continue;
+        }
+        const noteMatch = line.match(NOTE_OPEN_RE);
+        if (noteMatch) {
+            flushStep();
+            const block = noteCollect(i);
+            i = block.consumedTo;
+            if (/RAPOR HAZIR|ANALİZ TAMAMLANDI|!approve/i.test(block.body)) {
+                const approverMatch = block.body.match(PERSONA_HANDLE_RE);
+                gates.push({
+                    phase: currentPhase === '__preamble__' ? '(preamble)' : currentPhase,
+                    afterStepIndex: stepCounter - 1,
+                    body: block.body,
+                    approver: approverMatch?.[1] ?? null,
+                });
+            }
+            continue;
+        }
+        if (!nextWorkflowId) {
+            const nextMatch = line.match(NEXT_WORKFLOW_RE);
+            if (nextMatch?.[1]) {
+                nextWorkflowId = nextMatch[1].replace(/\.md$/, '').replace(/^.*\//, '');
+            }
+        }
+        const stepMatch = line.match(STEP_BULLET_RE);
+        if (stepMatch?.[2]) {
+            flushStep();
+            const inlineRest = stepMatch[2].trim();
+            const personaMatch = inlineRest.match(PERSONA_RE);
+            const persona = personaMatch?.[1] ?? null;
+            const description = personaMatch?.[2]?.trim() ?? inlineRest;
+            const phaseCount = (stepByPhaseCount.get(currentPhase) ?? 0) + 1;
+            stepByPhaseCount.set(currentPhase, phaseCount);
+            const key = `${slugifyPhase(currentPhase)}.${phaseCount}`;
+            activeStep = {
+                key,
+                index: stepCounter,
+                phase: currentPhase,
+                persona,
+                description,
+                inputs: [],
+                outputs: [],
+                approver: null,
+                reviewer: null,
+            };
+            stepCounter += 1;
+            continue;
+        }
+        if (activeStep) {
+            const sub = line.match(SUB_BULLET_RE);
+            if (sub?.[1] && sub[2]) {
+                const label = sub[1].toLowerCase();
+                const value = sub[2];
+                if (label === 'inputs')
+                    activeStep.inputs = splitList(value);
+                else if (label === 'outputs')
+                    activeStep.outputs = splitList(value);
+                else if (label === 'approver')
+                    activeStep.approver = value.trim().replace(/[`*]/g, '');
+                else if (label === 'reviewer')
+                    activeStep.reviewer = value.trim().replace(/[`*]/g, '');
+                continue;
+            }
+            // Blank line or unrelated content ends step body.
+            if (line.trim() === '') {
+                // Don't flush yet — sub-bullets may continue after blank lines in some files.
+                continue;
+            }
+        }
+    }
+    flushStep();
+    return {
+        id: fileId,
+        title,
+        startCommand,
+        nextWorkflowId,
+        steps,
+        gates,
+    };
+}
+export function loadWorkflowFromFile(filePath) {
+    const source = readFileSync(filePath, 'utf8');
+    const fileId = basename(filePath).replace(/\.md$/, '');
+    return parseWorkflowMarkdown(source, fileId);
+}
+//# sourceMappingURL=workflow-parser.js.map

package/dist/server/engine/workflow-parser.js.map

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

package/dist/server/engine/worktree.js

@@ -0,0 +1,176 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, renameSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+/**
+ * Worktree manager.
+ *
+ * Each run is given an isolated working copy under `.kortext/worktrees/run-<id>`
+ * on its own throwaway branch (`kortext/run-<id>`). On success the branch can be
+ * merged back into the base branch and the worktree is removed. On failure the
+ * directory is moved to `.kortext/worktrees-quarantine/run-<id>-<timestamp>/`
+ * (NOT deleted) so postmortem analysis is possible, and the branch is kept.
+ *
+ * Limits:
+ *   - `maxConcurrent` caps simultaneous worktrees (default 10) so a runaway
+ *     pipeline can't exhaust disk.
+ *
+ * All git invocations use `execFileSync('git', [...])` — shell-free so callers
+ * can't smuggle metacharacters via run id or branch name.
+ */
+export class WorktreeError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.name = 'WorktreeError';
+        if (cause !== undefined)
+            this.cause = cause;
+    }
+}
+export class WorktreeLimitError extends WorktreeError {
+    constructor(limit) {
+        super(`worktree limit reached: ${limit}`);
+        this.name = 'WorktreeLimitError';
+    }
+}
+export class WorktreeManager {
+    repoRoot;
+    baseBranch;
+    maxConcurrent;
+    artifacts;
+    worktreeRoot;
+    quarantineRoot;
+    active = new Map();
+    constructor(opts) {
+        this.repoRoot = resolve(opts.repoRoot);
+        this.baseBranch = opts.baseBranch ?? 'main';
+        this.maxConcurrent = opts.maxConcurrent ?? 10;
+        this.artifacts = opts.artifacts;
+        this.worktreeRoot =
+            opts.worktreeRoot ?? join(this.repoRoot, '.kortext', 'worktrees');
+        this.quarantineRoot =
+            opts.quarantineRoot ?? join(this.repoRoot, '.kortext', 'worktrees-quarantine');
+    }
+    /**
+     * Provision (or return existing) worktree for a run.
+     * Idempotent for the same runId.
+     */
+    acquire(runId) {
+        const existing = this.active.get(runId);
+        if (existing)
+            return existing;
+        if (this.active.size >= this.maxConcurrent) {
+            throw new WorktreeLimitError(this.maxConcurrent);
+        }
+        // Verify base branch exists.
+        try {
+            this.git('rev-parse', '--verify', `refs/heads/${this.baseBranch}`);
+        }
+        catch (e) {
+            throw new WorktreeError(`base branch '${this.baseBranch}' not found in ${this.repoRoot}`, e);
+        }
+        const branch = `kortext/run-${runId}`;
+        const path = join(this.worktreeRoot, `run-${runId}`);
+        mkdirSync(this.worktreeRoot, { recursive: true });
+        try {
+            // -B forces branch creation/reset from base; safe because branch name is namespaced.
+            this.git('worktree', 'add', '-B', branch, path, this.baseBranch);
+        }
+        catch (e) {
+            throw new WorktreeError(`failed to create worktree at ${path} from ${this.baseBranch}`, e);
+        }
+        const handle = { runId, path, branch, baseBranch: this.baseBranch };
+        this.active.set(runId, handle);
+        if (this.artifacts) {
+            let bytes = null;
+            try {
+                bytes = statSync(path).size;
+            }
+            catch {
+                bytes = null;
+            }
+            this.artifacts.create({
+                run_id: runId,
+                step_id: null,
+                kind: 'worktree',
+                path,
+                bytes,
+            });
+        }
+        return handle;
+    }
+    /**
+     * Tear down a worktree.
+     *
+     *   success: true,  merge: false → drop branch & worktree (no merge)
+     *   success: true,  merge: true  → merge branch into base, then drop
+     *   success: false               → quarantine dir; keep branch for postmortem
+     */
+    release(handle, opts) {
+        if (!this.active.has(handle.runId)) {
+            // already released — be idempotent
+            return;
+        }
+        if (opts.success) {
+            if (opts.merge) {
+                try {
+                    this.git('-C', this.repoRoot, 'checkout', handle.baseBranch);
+                    this.git('-C', this.repoRoot, 'merge', '--no-ff', '-m', `Merge ${handle.branch} into ${handle.baseBranch}`, handle.branch);
+                }
+                catch (e) {
+                    throw new WorktreeError(`merge ${handle.branch} -> ${handle.baseBranch} failed`, e);
+                }
+            }
+            try {
+                this.git('worktree', 'remove', '--force', handle.path);
+            }
+            catch (e) {
+                throw new WorktreeError(`failed to remove worktree ${handle.path}`, e);
+            }
+            try {
+                this.git('branch', '-D', handle.branch);
+            }
+            catch {
+                // branch may be gone already (merge + auto-delete in some configs) — ignore
+            }
+        }
+        else {
+            // Quarantine path: move dir, prune git's internal record, keep branch.
+            mkdirSync(this.quarantineRoot, { recursive: true });
+            const stamp = new Date()
+                .toISOString()
+                .replace(/[:.]/g, '-')
+                .replace('T', '_')
+                .replace('Z', '');
+            const dest = join(this.quarantineRoot, `run-${handle.runId}-${stamp}`);
+            if (existsSync(handle.path)) {
+                renameSync(handle.path, dest);
+            }
+            try {
+                this.git('worktree', 'prune');
+            }
+            catch {
+                // best-effort
+            }
+            if (this.artifacts) {
+                this.artifacts.create({
+                    run_id: handle.runId,
+                    step_id: null,
+                    kind: 'worktree',
+                    path: dest,
+                    bytes: null,
+                });
+            }
+        }
+        this.active.delete(handle.runId);
+    }
+    list() {
+        return [...this.active.values()];
+    }
+    git(...args) {
+        return execFileSync('git', args, {
+            cwd: this.repoRoot,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'pipe'],
+        }).trim();
+    }
+}
+//# sourceMappingURL=worktree.js.map

package/dist/server/engine/worktree.js.map

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

package/dist/server/index.js

@@ -0,0 +1,99 @@
+import { resolve } from 'node:path';
+import express from 'express';
+import { env } from "./config/env.js";
+import { healthRouter } from "./routes/health.js";
+import { dbInfoRouter } from "./routes/db-info.js";
+import { approvalRouter } from "./routes/approvals.js";
+import { runsRouter } from "./routes/runs.js";
+import { handoversRouter } from "./routes/handovers.js";
+import { doctorRouter } from "./routes/doctor.js";
+import { personasRouter } from "./routes/personas.js";
+import { workflowsRouter } from "./routes/workflows.js";
+import { backlogRouter } from "./routes/backlog.js";
+import { docsRouter } from "./routes/docs.js";
+import { getDb } from "./db/client.js";
+import { ApprovalQueue } from "./orchestrator/approval-queue.js";
+import { mcpSseRouter } from "../mcp/sse.js";
+import { resumeOrphanedRuns } from "./orchestrator/resume.js";
+import { loadWorkflowsFromDir } from "./engine/workflow-loader.js";
+import { loadPersonasFromDir } from "./engine/persona-registry.js";
+import { findUnknownPersonas } from "./engine/consistency.js";
+// Open DB + run migrations before the HTTP server starts accepting traffic.
+const { schemaVersion, repositories: repos } = getDb();
+console.log(`[kortext] db ready (schema v${schemaVersion})`);
+// Load workflow + persona definitions from disk into in-memory registries.
+// Faz 5.5+: these become the source for `loadWorkflowById` and persona
+// dispatch when the orchestrator is wired into the server process.
+const workflowsDir = resolve(process.cwd(), 'workflows');
+const agentsDir = resolve(process.cwd(), 'agents');
+const workflowRegistry = loadWorkflowsFromDir(workflowsDir);
+const personaRegistry = loadPersonasFromDir(agentsDir);
+const wfErrors = workflowRegistry.errors();
+const personaErrors = personaRegistry.errors();
+console.log(`[kortext] workflows loaded: ${workflowRegistry.list().length} ok, ${wfErrors.length} error(s)`);
+for (const err of wfErrors) {
+    console.warn(`[kortext]   - ${err.file}: ${err.reason}`);
+}
+console.log(`[kortext] personas loaded: ${personaRegistry.list().length} ok, ${personaErrors.length} error(s)`);
+for (const err of personaErrors) {
+    console.warn(`[kortext]   - ${err.file}: ${err.reason}`);
+}
+// Cross-validate: every persona handle used in workflows must resolve.
+// '+prime' is the human-in-the-loop and is allowed to be missing.
+const unknownPersonas = findUnknownPersonas(workflowRegistry, personaRegistry)
+    .filter((f) => f.persona !== '+prime');
+if (unknownPersonas.length > 0) {
+    console.warn(`[kortext] consistency: ${unknownPersonas.length} unknown persona reference(s):`);
+    for (const f of unknownPersonas) {
+        console.warn(`[kortext]   - ${f.workflowId} (${f.stepKey}): ${f.persona}`);
+    }
+}
+// Reconcile zombie runs left behind by a previous crash/restart.
+const resumed = resumeOrphanedRuns(repos);
+if (resumed.recovered.length > 0) {
+    console.log(`[kortext] orphan recovery: ${resumed.recovered.length} run(s) moved to cancelled — retry with 'kortext retry <id>'`);
+}
+const approvalQueue = new ApprovalQueue({ repos });
+const app = express();
+app.use(express.json());
+app.use('/api', healthRouter);
+app.use('/api', dbInfoRouter);
+app.use('/api', approvalRouter({ repos, queue: approvalQueue }));
+app.use('/api', runsRouter({ repos }));
+app.use('/api', handoversRouter({ repos }));
+app.use('/api', backlogRouter({ repos }));
+app.use('/api', personasRouter({ personas: personaRegistry, agentsDir }));
+app.use('/api', workflowsRouter({ workflows: workflowRegistry }));
+app.use('/api', doctorRouter({ repos, workflows: workflowRegistry, personas: personaRegistry }));
+app.use('/api', docsRouter({
+    scopes: {
+        references: resolve(process.cwd(), 'workspace/references'),
+        reports: resolve(process.cwd(), 'workspace/reports'),
+        memory: resolve(process.cwd(), 'workspace/memory'),
+        rules: resolve(process.cwd(), 'rules'),
+        workflows: workflowsDir,
+    },
+}));
+// MCP over SSE for dashboard / remote clients.
+app.use(mcpSseRouter({
+    repos,
+    workflows: workflowRegistry,
+    personas: personaRegistry,
+    queue: approvalQueue,
+    workspaceRoot: process.cwd(),
+    workflowsDir,
+}));
+app.use((err, _req, res, _next) => {
+    console.error('[kortext]', err);
+    res.status(500).json({ error: 'internal_error', message: err.message });
+});
+const server = app.listen(env.KORTEXT_PORT, () => {
+    console.log(`[kortext] server listening on http://localhost:${env.KORTEXT_PORT}`);
+});
+const shutdown = (signal) => {
+    console.log(`[kortext] received ${signal}, closing`);
+    server.close(() => process.exit(0));
+};
+process.on('SIGINT', () => shutdown('SIGINT'));
+process.on('SIGTERM', () => shutdown('SIGTERM'));
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

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

package/dist/server/notifications/dispatcher.js

@@ -0,0 +1,60 @@
+export class NotificationDispatcher {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async dispatch(event) {
+        const eventKey = buildEventKey(event);
+        const text = formatText(event);
+        for (const transport of this.opts.transports) {
+            // Dedup: skip transport.send if (channel, event_key) already recorded.
+            const existing = this.opts.repos.notifications.getByKey(transport.channel, eventKey);
+            if (existing)
+                continue;
+            if (!transport.isEnabled()) {
+                this.opts.repos.notifications.record({
+                    channel: transport.channel,
+                    event_key: eventKey,
+                    payload: { ...event.payload, kind: event.kind, summary: event.summary },
+                    status: 'suppressed',
+                    error_message: null,
+                });
+                continue;
+            }
+            try {
+                await transport.send(text, { ...event.payload, runId: event.runId });
+                this.opts.repos.notifications.record({
+                    channel: transport.channel,
+                    event_key: eventKey,
+                    payload: { ...event.payload, kind: event.kind, summary: event.summary },
+                    status: 'sent',
+                    error_message: null,
+                });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                this.opts.repos.notifications.record({
+                    channel: transport.channel,
+                    event_key: eventKey,
+                    payload: { ...event.payload, kind: event.kind, summary: event.summary },
+                    status: 'failed',
+                    error_message: message,
+                });
+            }
+        }
+    }
+}
+function buildEventKey(event) {
+    const slug = event.kind.replace(/\./g, '-');
+    if (event.kind === 'gate.awaiting-approval') {
+        return `${slug}:question:${event.questionId ?? 'unknown'}`;
+    }
+    if (event.kind === 'secret.detected' && event.stepId !== undefined) {
+        return `${slug}:run:${event.runId}:step:${event.stepId}`;
+    }
+    return `${slug}:run:${event.runId}`;
+}
+function formatText(event) {
+    return `[kortext] ${event.kind} • ${event.workflowId} #${event.runId} — ${event.summary}`;
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/server/notifications/dispatcher.js.map

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

package/dist/server/notifications/slack.js

@@ -0,0 +1,37 @@
+export class SlackTransport {
+    opts;
+    channel = 'slack';
+    fetchImpl;
+    constructor(opts) {
+        this.opts = opts;
+        this.fetchImpl = opts.fetch ?? fetch;
+    }
+    isEnabled() {
+        return Boolean(this.opts.webhookUrl);
+    }
+    async send(text, payload) {
+        const body = { text };
+        if (this.opts.channel)
+            body.channel = this.opts.channel;
+        if (Object.keys(payload).length > 0)
+            body.attachments = [{ text: JSON.stringify(payload) }];
+        const res = await this.fetchImpl(this.opts.webhookUrl, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const detail = await safeText(res);
+            throw new Error(`Slack webhook ${res.status}: ${detail}`);
+        }
+    }
+}
+async function safeText(res) {
+    try {
+        return await res.text();
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=slack.js.map

package/dist/server/notifications/slack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.js","sourceRoot":"","sources":["../../../server/notifications/slack.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,cAAc;IAII;IAHpB,OAAO,GAAwB,OAAO,CAAC;IAC/B,SAAS,CAAe;IAEzC,YAA6B,IAA2B;QAA3B,SAAI,GAAJ,IAAI,CAAuB;QACtD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;IACvC,CAAC;IAED,SAAS;QACP,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,OAAgC;QACvD,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,CAAC;QAC/C,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;QACxD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,WAAW,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAE5F,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE;YACrD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;CACF;AAED,KAAK,UAAU,QAAQ,CAAC,GAAa;IACnC,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/server/notifications/telegram.js

@@ -0,0 +1,33 @@
+export class TelegramTransport {
+    opts;
+    channel = 'telegram';
+    fetchImpl;
+    constructor(opts) {
+        this.opts = opts;
+        this.fetchImpl = opts.fetch ?? fetch;
+    }
+    isEnabled() {
+        return Boolean(this.opts.botToken) && Boolean(this.opts.chatId);
+    }
+    async send(text, _payload) {
+        const url = `https://api.telegram.org/bot${this.opts.botToken}/sendMessage`;
+        const res = await this.fetchImpl(url, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ chat_id: this.opts.chatId, text }),
+        });
+        if (!res.ok) {
+            const detail = await safeText(res);
+            throw new Error(`Telegram sendMessage ${res.status}: ${detail}`);
+        }
+    }
+}
+async function safeText(res) {
+    try {
+        return await res.text();
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=telegram.js.map

package/dist/server/notifications/telegram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.js","sourceRoot":"","sources":["../../../server/notifications/telegram.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,iBAAiB;IAIC;IAHpB,OAAO,GAAwB,UAAU,CAAC;IAClC,SAAS,CAAe;IAEzC,YAA6B,IAA8B;QAA9B,SAAI,GAAJ,IAAI,CAA0B;QACzD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;IACvC,CAAC;IAED,SAAS;QACP,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,QAAiC;QACxD,MAAM,GAAG,GAAG,+BAA+B,IAAI,CAAC,IAAI,CAAC,QAAQ,cAAc,CAAC;QAC5E,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;SAC1D,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF;AAED,KAAK,UAAU,QAAQ,CAAC,GAAa;IACnC,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}