@meetquinn/animactl 0.1.1-canary.21.1.cd63d38

package/dist/server/cli/service.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerServiceCommands(program: Command): void;
+//# sourceMappingURL=service.d.ts.map

package/dist/server/cli/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../server/cli/service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkB9D"}

package/dist/server/cli/service.js

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { startRuntimeHost } from '../runtime/host.js';
+import { startWebHost } from '../web/host.js';
+const GlobalFlags = z.object({
+    agent: z.string().optional(),
+});
+const ServerSchema = GlobalFlags;
+const WebSchema = GlobalFlags.extend({
+    host: z.string().optional(),
+    port: z.coerce.number().int().positive().optional(),
+});
+export function registerServiceCommands(program) {
+    program
+        .command('server')
+        .description('Run the Anima server: Slack listener, reminder scheduler, and worker loop')
+        .action(async (_, command) => {
+        const opts = ServerSchema.parse(command.optsWithGlobals());
+        await server(opts);
+    });
+    program
+        .command('web')
+        .description('Run the local Anima web app')
+        .option('--host <host>')
+        .option('--port <port>')
+        .action(async (_, command) => {
+        const opts = WebSchema.parse(command.optsWithGlobals());
+        await web(opts);
+    });
+}
+async function server(opts) {
+    await startRuntimeHost(opts);
+}
+async function web(opts) {
+    await startWebHost(opts);
+}

package/dist/server/cli/services-cli.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerServicesCommand(program: Command): void;
+//# sourceMappingURL=services-cli.d.ts.map

package/dist/server/cli/services-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services-cli.d.ts","sourceRoot":"","sources":["../../../server/cli/services-cli.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4CzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuD9D"}

package/dist/server/cli/services-cli.js

@@ -0,0 +1,191 @@
+import { fileURLToPath } from 'node:url';
+import { resolve as resolvePath } from 'node:path';
+import { defaultServerSettingsService } from '../settings/settings.service.js';
+import { resolveAnimaHome } from '../anima-home.js';
+import { clearRestartDrain, } from '../services/restart-drain.js';
+import { DEFAULT_RESTART_DRAIN_TIMEOUT_MS, DEFAULT_RESTART_IDLE_TIMEOUT_MS, listRestartBlockers, RestartBlockedError, restartBlockedError, waitForRestartDrain, waitForRestartIdle, } from '../services/restart-gate.js';
+import { blockedServicesRestartResult, idleServicesRestartResult, writeServicesRestartResult, } from '../services/restart-result.js';
+import { isServiceRunning, printStatus, startService, stopService, } from '../services/supervisor.js';
+const DEFAULT_DASHBOARD_PORT = 4174;
+export function registerServicesCommand(program) {
+    const services = program
+        .command('services')
+        .description('Supervise the agent and web daemons for this environment');
+    services
+        .command('start')
+        .description('Start the agent and web app as background processes')
+        .option('--only <service>', 'Start only one service: agent or web')
+        .action(async (_, command) => {
+        const opts = command.optsWithGlobals();
+        await runStart(opts);
+    });
+    services
+        .command('stop')
+        .description('Stop the agent and web app background processes')
+        .option('--only <service>', 'Stop only one service: agent or web')
+        .action(async (_, command) => {
+        const opts = command.optsWithGlobals();
+        await runStop(opts);
+    });
+    services
+        .command('restart')
+        .description('Stop and start the agent and web app background processes')
+        .option('--only <service>', 'Restart only one service: agent or web')
+        .option('--drain-active', 'Drain running agents to a safe boundary before restart')
+        .option('--drain-timeout-ms <ms>', 'How long to wait for running agents to reach a drain point', parseNonNegativeInteger, DEFAULT_RESTART_DRAIN_TIMEOUT_MS)
+        .option('--force', 'Restart even if agent inboxes are running or queued')
+        .option('--idle-timeout-ms <ms>', 'How long to wait for agent inboxes to become idle before failing', parseNonNegativeInteger, DEFAULT_RESTART_IDLE_TIMEOUT_MS)
+        .option('--resume-running', 'Resume drained running agents after restart')
+        .action(async (_, command) => {
+        const opts = command.optsWithGlobals();
+        await runRestart(opts);
+    });
+    services
+        .command('status')
+        .description('Report the agent and web app daemon status')
+        .option('--only <service>', 'Show only one service: agent or web')
+        .action(async (_, command) => {
+        const opts = command.optsWithGlobals();
+        await runStatus(opts);
+    });
+}
+async function runStart(opts) {
+    const { specs, supervisor } = await resolveServices(opts);
+    for (const spec of specs)
+        await startService(spec, supervisor);
+    await printStatus(specs);
+}
+async function runStop(opts) {
+    const { specs } = await resolveServices(opts);
+    assertCanControlServices(specs);
+    for (const spec of specs)
+        await stopService(spec);
+    await printStatus(specs);
+}
+async function runRestart(opts) {
+    validateRestartDrainOptions(opts);
+    const { specs, supervisor } = await resolveServices(opts);
+    assertCanControlServices(specs);
+    let gate;
+    let stopped = false;
+    try {
+        gate = await prepareRestartGate(specs, opts);
+        for (const spec of specs)
+            await stopService(spec);
+        stopped = true;
+        await gate.beforeStart();
+        for (const spec of specs)
+            await startService(spec, supervisor);
+        await printStatus(specs);
+        await writeRestartResult(gate.result);
+        if (gate.drainResult?.resumedCount) {
+            console.log(`restart: ${gate.drainResult.resumedCount} agent item(s) resumed after restart`);
+        }
+    }
+    catch (error) {
+        if (error instanceof RestartBlockedError) {
+            await writeRestartResult(blockedServicesRestartResult(error));
+        }
+        throw error;
+    }
+    finally {
+        if (!stopped)
+            await gate?.cleanup();
+    }
+}
+async function runStatus(opts) {
+    const { specs } = await resolveServices(opts);
+    await printStatus(specs);
+}
+async function resolveServices(opts) {
+    const animaHome = resolveAnimaHome();
+    const { host: dashboardHost, port: dashboardPort } = await defaultServerSettingsService.getDashboardSettings({
+        defaultHost: '0.0.0.0',
+        defaultPort: DEFAULT_DASHBOARD_PORT,
+    });
+    // For the status URL display: 0.0.0.0 means all interfaces, show 127.0.0.1 for local access.
+    const dashboardDisplayHost = dashboardHost === '0.0.0.0' ? '127.0.0.1' : dashboardHost;
+    const allSpecs = [
+        {
+            args: ['server'],
+            animaHome,
+            id: 'agent',
+            logName: 'agent.log',
+            matchAny: [' server'],
+        },
+        {
+            args: ['web', '--host', dashboardHost, '--port', String(dashboardPort)],
+            animaHome,
+            id: 'web',
+            legacyIds: ['ui'],
+            logName: 'web.log',
+            matchAny: [' web ', ' ui '],
+            url: `http://${dashboardDisplayHost}:${dashboardPort}`,
+        },
+    ];
+    if (opts.only && opts.only !== 'agent' && opts.only !== 'web') {
+        throw new Error('--only must be "agent" or "web"');
+    }
+    const specs = opts.only ? allSpecs.filter((spec) => spec.id === opts.only) : allSpecs;
+    const animactl = fileURLToPath(new URL('./animactl.js', import.meta.url));
+    const cwd = process.cwd();
+    return { specs, supervisor: { animactl, cwd } };
+}
+function assertCanControlServices(specs) {
+    if (!specs.some((spec) => spec.id === 'agent'))
+        return;
+    const isRuntimeItem = Boolean(process.env.ANIMA_INBOX_ITEM_ID || process.env.ANIMA_AGENT_ID);
+    if (!isRuntimeItem)
+        return;
+    const runtimeHome = process.env.ANIMA_RUNTIME_HOME;
+    if (runtimeHome && resolvePath(runtimeHome) !== resolvePath(resolveAnimaHome()))
+        return;
+    throw new Error('Refusing to stop or restart the agent service from inside its own active runtime. '
+        + 'Use an external shell or idle-gated restart for full restarts, or pass --only web for web-only reloads.');
+}
+async function prepareRestartGate(specs, opts) {
+    const agentSpec = specs.find((spec) => spec.id === 'agent');
+    const noop = {
+        beforeStart: async () => { },
+        cleanup: async () => { },
+        result: idleServicesRestartResult(),
+    };
+    if (!agentSpec || opts.force || !(await isServiceRunning(agentSpec)))
+        return noop;
+    if (opts.drainActive || opts.resumeRunning) {
+        const drainResult = await waitForRestartDrain({
+            drainTimeoutMs: opts.drainTimeoutMs ?? DEFAULT_RESTART_DRAIN_TIMEOUT_MS,
+            markerTtlMs: (opts.drainTimeoutMs ?? DEFAULT_RESTART_DRAIN_TIMEOUT_MS) + 60_000,
+        });
+        return {
+            beforeStart: clearRestartDrain,
+            cleanup: clearRestartDrain,
+            drainResult,
+            result: drainResult,
+        };
+    }
+    await waitForRestartIdle(opts.idleTimeoutMs ?? DEFAULT_RESTART_IDLE_TIMEOUT_MS);
+    const finalBlockers = await listRestartBlockers();
+    if (finalBlockers.length > 0) {
+        throw restartBlockedError(finalBlockers, 'Agents became busy before restart.', 'became_busy');
+    }
+    return noop;
+}
+function validateRestartDrainOptions(opts) {
+    if ((opts.drainActive || opts.resumeRunning) && (!opts.drainActive || !opts.resumeRunning)) {
+        throw new Error('--drain-active and --resume-running must be used together');
+    }
+}
+async function writeRestartResult(result) {
+    const resultPath = process.env.ANIMA_RESTART_RESULT_FILE;
+    if (!resultPath)
+        return;
+    await writeServicesRestartResult(resultPath, result);
+}
+function parseNonNegativeInteger(value) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 0) {
+        throw new Error('timeout must be a non-negative integer');
+    }
+    return parsed;
+}

package/dist/server/cli/shared.d.ts

@@ -0,0 +1,6 @@
+export interface GlobalCliOptions {
+    agent?: string;
+}
+export declare function resolveAgentIdFrom(agent: string | undefined): string | undefined;
+export declare function resolveItemIdFrom(item: string | undefined): string | undefined;
+//# sourceMappingURL=shared.d.ts.map

package/dist/server/cli/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../server/cli/shared.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAEhF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE9E"}

package/dist/server/cli/shared.js

@@ -0,0 +1,6 @@
+export function resolveAgentIdFrom(agent) {
+    return agent ?? (process.env.ANIMA_AGENT_ID?.trim() || undefined);
+}
+export function resolveItemIdFrom(item) {
+    return item ?? (process.env.ANIMA_INBOX_ITEM_ID?.trim() || undefined);
+}

package/dist/server/ids.d.ts

@@ -0,0 +1,10 @@
+export declare function nowIso(): string;
+export declare function errorMessage(error: unknown): string;
+export declare function makeId(prefix: string): string;
+export declare function slackSurfaceId(surface: {
+    channelId: string;
+    teamId: string;
+    threadTs?: string;
+}): string;
+export declare function slackMessageEventId(teamId: string, channelId: string, ts: string): string;
+//# sourceMappingURL=ids.d.ts.map

package/dist/server/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../server/ids.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAGxG;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEzF"}

package/dist/server/ids.js

@@ -0,0 +1,16 @@
+export function nowIso() {
+    return new Date().toISOString();
+}
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export function makeId(prefix) {
+    return `${prefix}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 8)}`;
+}
+export function slackSurfaceId(surface) {
+    const base = `slack:${surface.teamId}:${surface.channelId}`;
+    return surface.threadTs ? `${base}:thread:${surface.threadTs}` : base;
+}
+export function slackMessageEventId(teamId, channelId, ts) {
+    return `slack:${teamId}:${channelId}:${ts}`;
+}

package/dist/server/inbox/reminder-subscriber.d.ts

@@ -0,0 +1,15 @@
+import { type ReminderService } from '../reminders/reminder.service.js';
+import { WakeQueueService } from './wake-queue.service.js';
+export declare class ReminderInboxSubscriber {
+    private readonly queue;
+    private poll?;
+    private readonly reminderService;
+    private timer?;
+    constructor(queue: WakeQueueService, reminderService?: ReminderService);
+    start(): void;
+    stop(): Promise<void>;
+    private pollDueReminders;
+    private fireDueReminders;
+    private fireReminder;
+}
+//# sourceMappingURL=reminder-subscriber.d.ts.map

package/dist/server/inbox/reminder-subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-subscriber.d.ts","sourceRoot":"","sources":["../../../server/inbox/reminder-subscriber.ts"],"names":[],"mappings":"AACA,OAAO,EAA2B,KAAK,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAI3D,qBAAa,uBAAuB;IAMhC,OAAO,CAAC,QAAQ,CAAC,KAAK;IALxB,OAAO,CAAC,IAAI,CAAC,CAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,KAAK,CAAC,CAAiB;gBAGZ,KAAK,EAAE,gBAAgB,EACxC,eAAe,CAAC,EAAE,eAAe;IAKnC,KAAK,IAAI,IAAI;IAMP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAMb,gBAAgB;YAYhB,gBAAgB;YAOhB,YAAY;CA6B3B"}

package/dist/server/inbox/reminder-subscriber.js

@@ -0,0 +1,69 @@
+import { errorMessage } from '../ids.js';
+import { reminderServiceForAgent } from '../reminders/reminder.service.js';
+const REMINDER_POLL_MS = 30_000;
+export class ReminderInboxSubscriber {
+    queue;
+    poll;
+    reminderService;
+    timer;
+    constructor(queue, reminderService) {
+        this.queue = queue;
+        this.reminderService = reminderService ?? reminderServiceForAgent(queue.agentId);
+    }
+    start() {
+        this.timer = setInterval(() => void this.pollDueReminders(), REMINDER_POLL_MS);
+        this.timer.unref();
+        void this.pollDueReminders();
+    }
+    async stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = undefined;
+        await (this.poll ?? Promise.resolve());
+    }
+    async pollDueReminders() {
+        if (this.poll)
+            return this.poll;
+        this.poll = this.fireDueReminders()
+            .catch((error) => {
+            console.error(`Reminder scheduler failed for ${this.queue.agentId}: ${errorMessage(error)}`);
+        })
+            .finally(() => {
+            this.poll = undefined;
+        });
+        return this.poll;
+    }
+    async fireDueReminders() {
+        const firedAt = new Date();
+        for (const reminder of await this.reminderService.dueReminders({ now: firedAt })) {
+            await this.fireReminder(reminder, firedAt);
+        }
+    }
+    async fireReminder(reminder, firedAt) {
+        const receivedAt = firedAt.toISOString();
+        const event = {
+            id: `reminder:${reminder.reminderId}:fire:${reminder.firedCount + 1}`,
+            kind: 'reminder',
+            receivedAt,
+            handling: {
+                createdAt: receivedAt,
+                queuedAt: receivedAt,
+                status: 'queued',
+                updatedAt: receivedAt,
+            },
+            reminderId: reminder.reminderId,
+        };
+        const decision = await this.queue.enqueue(event);
+        const firedReminder = await this.reminderService.completeReminderFire({
+            id: reminder.reminderId,
+            now: firedAt,
+        });
+        if (!decision.duplicate) {
+            await this.reminderService.recordReminderFire({
+                firedAt,
+                reminder: firedReminder,
+            });
+        }
+        console.log(`reminder fired reminderId=${reminder.reminderId} eventId=${event.id} duplicate=${Boolean(decision.duplicate)} queued=${Boolean(decision.queued)} firedAt=${firedAt.toISOString()}`);
+    }
+}

package/dist/server/inbox/slack-events.d.ts

@@ -0,0 +1,62 @@
+import type { SlackFileMeta, SlackInboxItem } from '../../shared/inbox.js';
+import type { SlackUserProfile } from './slack-profiles.js';
+export type SlackEvent = SlackInboxItem;
+export type SlackFile = SlackFileMeta;
+export interface SlackSurface {
+    id: string;
+    channelId: string;
+    channelName?: string;
+    kind: 'channel' | 'dm' | 'thread';
+    teamId: string;
+    threadTs?: string;
+    visibility: 'private' | 'public';
+}
+export interface SlackMessageEnvelope {
+    event_id?: string;
+    team_id?: string;
+}
+export interface SlackRawMessageEvent {
+    bot_id?: string;
+    channel?: string;
+    channel_type?: string;
+    files?: Array<{
+        id?: string;
+        mimetype?: string;
+        name?: string;
+        size?: number;
+        title?: string;
+        url_private?: string;
+        url_private_download?: string;
+    }>;
+    subtype?: string;
+    team?: string;
+    text?: string;
+    thread_ts?: string;
+    ts?: string;
+    type?: string;
+    user?: string;
+}
+interface SlackUserMessageEvent extends SlackRawMessageEvent {
+    channel: string;
+    text: string;
+    ts: string;
+    type: 'app_mention' | 'message';
+    user: string;
+}
+export declare function isUserAuthoredSlackMessage(event: SlackRawMessageEvent): event is SlackUserMessageEvent;
+export declare function isRoutableSlackMessage(event: SlackRawMessageEvent): event is SlackUserMessageEvent;
+export declare function normalizeSlackMessage(input: {
+    attentionSuggestion?: string;
+    envelope?: SlackMessageEnvelope;
+    channelName?: string;
+    event: SlackRawMessageEvent;
+    files?: SlackFile[];
+    permalink?: string;
+    text?: string;
+    userProfile?: SlackUserProfile;
+}): SlackEvent;
+export declare function isSlackEvent(event: unknown): event is SlackEvent;
+export declare function slackSurfaceDisplayRef(surface: SlackSurface): string;
+export declare function slackSurfaceForEvent(event: SlackEvent): SlackSurface;
+export {};
+//# sourceMappingURL=slack-events.d.ts.map

package/dist/server/inbox/slack-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-events.d.ts","sourceRoot":"","sources":["../../../server/inbox/slack-events.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,MAAM,UAAU,GAAG,cAAc,CAAC;AACxC,MAAM,MAAM,SAAS,GAAG,aAAa,CAAC;AAEtC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,QAAQ,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,qBAAsB,SAAQ,oBAAoB;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,oBAAoB,GAAG,KAAK,IAAI,qBAAqB,CAMtG;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,oBAAoB,GAAG,KAAK,IAAI,qBAAqB,CAUlG;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC,GAAG,UAAU,CA0Bb;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAEpE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,YAAY,CAcpE"}

package/dist/server/inbox/slack-events.js

@@ -0,0 +1,84 @@
+import { nowIso, slackMessageEventId, slackSurfaceId } from '../ids.js';
+import { slackFileFromRaw } from '../slack/slack.helper.js';
+export function isUserAuthoredSlackMessage(event) {
+    return (isRoutableSlackMessage(event) &&
+        event.bot_id === undefined &&
+        event.subtype !== 'bot_message');
+}
+export function isRoutableSlackMessage(event) {
+    return ((event.type === 'message' || event.type === 'app_mention') &&
+        typeof event.channel === 'string' &&
+        typeof event.ts === 'string' &&
+        typeof event.user === 'string' &&
+        typeof event.text === 'string' &&
+        (event.text.trim().length > 0 || (Array.isArray(event.files) && event.files.length > 0)) &&
+        (event.subtype === undefined || event.subtype === 'bot_message' || event.subtype === 'file_share'));
+}
+export function normalizeSlackMessage(input) {
+    const teamId = input.envelope?.team_id ?? input.event.team ?? 'unknown-team';
+    const channelId = input.event.channel;
+    const ts = input.event.ts;
+    const threadTs = input.event.thread_ts || undefined;
+    const eventId = slackMessageEventId(teamId, channelId, ts);
+    const files = input.files ?? input.event.files?.map(slackFileFromRaw).filter(Boolean);
+    const handlingAt = nowIso();
+    const result = {
+        id: eventId,
+        kind: 'slack',
+        receivedAt: slackTsToIsoOrNow(ts),
+        handling: { createdAt: handlingAt, queuedAt: handlingAt, status: 'queued', updatedAt: handlingAt },
+        teamId,
+        channelId,
+        messageTs: ts,
+        actor: { userId: input.event.user, ...input.userProfile },
+        text: input.text ?? input.event.text,
+    };
+    if (input.attentionSuggestion)
+        result.attentionSuggestion = input.attentionSuggestion;
+    if (input.channelName)
+        result.channelName = input.channelName;
+    if (threadTs)
+        result.threadTs = threadTs;
+    if (input.permalink)
+        result.permalink = input.permalink;
+    if (files?.length)
+        result.files = files;
+    return result;
+}
+export function isSlackEvent(event) {
+    return Boolean(event && typeof event === 'object' && event.kind === 'slack');
+}
+export function slackSurfaceDisplayRef(surface) {
+    return surface.channelName && surface.kind !== 'dm' ? `#${surface.channelName}` : surface.channelId;
+}
+export function slackSurfaceForEvent(event) {
+    return {
+        channelId: event.channelId,
+        ...(event.channelName ? { channelName: event.channelName } : {}),
+        id: slackSurfaceId({
+            channelId: event.channelId,
+            teamId: event.teamId,
+            ...(event.threadTs ? { threadTs: event.threadTs } : {}),
+        }),
+        kind: slackSurfaceKind(event),
+        teamId: event.teamId,
+        ...(event.threadTs ? { threadTs: event.threadTs } : {}),
+        visibility: slackVisibility(event),
+    };
+}
+function slackTsToIsoOrNow(ts) {
+    const seconds = Number(ts.split('.')[0]);
+    if (!Number.isFinite(seconds))
+        return nowIso();
+    return new Date(seconds * 1000).toISOString();
+}
+function slackSurfaceKind(event) {
+    if (event.channelId.startsWith('D'))
+        return 'dm';
+    if (event.threadTs)
+        return 'thread';
+    return 'channel';
+}
+function slackVisibility(event) {
+    return event.channelId.startsWith('C') ? 'public' : 'private';
+}

package/dist/server/inbox/slack-profiles.d.ts

@@ -0,0 +1,41 @@
+import type { WebClient } from '@slack/web-api';
+export interface SlackConversationProfile {
+    name?: string;
+}
+export interface SlackUserProfile {
+    displayName?: string;
+    handle?: string;
+    realName?: string;
+    timezone?: {
+        label?: string;
+        name: string;
+        offsetSeconds?: number;
+    };
+}
+export declare class SlackProfileResolver {
+    private readonly conversations;
+    private readonly users;
+    user(input: {
+        client: WebClient;
+        teamId: string;
+        userId: string;
+    }): Promise<SlackUserProfile | undefined>;
+    conversation(input: {
+        channelId: string;
+        client: WebClient;
+        teamId: string;
+    }): Promise<SlackConversationProfile | undefined>;
+    userMentionLabels(input: {
+        client: WebClient;
+        teamId: string;
+        text: string;
+    }): Promise<Map<string, string>>;
+    channelMentionLabels(input: {
+        client: WebClient;
+        teamId: string;
+        text: string;
+    }): Promise<Map<string, string>>;
+    private userMentions;
+    private channelMentions;
+}
+//# sourceMappingURL=slack-profiles.d.ts.map

package/dist/server/inbox/slack-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-profiles.d.ts","sourceRoot":"","sources":["../../../server/inbox/slack-profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAehD,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QACT,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAcD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2D;IACzF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmD;IAEnE,IAAI,CAAC,KAAK,EAAE;QAChB,MAAM,EAAE,SAAS,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC;IAkBnC,YAAY,CAAC,KAAK,EAAE;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,SAAS,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC;IAkB3C,iBAAiB,CAAC,KAAK,EAAE;QAC7B,MAAM,EAAE,SAAS,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAK1B,oBAAoB,CAAC,KAAK,EAAE;QAChC,MAAM,EAAE,SAAS,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAKlB,YAAY;YAsBZ,eAAe;CAqB9B"}