@agentworkforce/delivery 0.1.0

package/dist/delivery.d.ts

@@ -0,0 +1,22 @@
+import type { WorkforceCtx } from '@agentworkforce/runtime';
+import { type DeliveryClient, type DeliveryTransports } from './types.js';
+/**
+ * Create a delivery client that auto-discovers configured transports from
+ * the persona context and sends to all of them.
+ *
+ * Blocking mode (the default):
+ *   const heads = await delivery.send(header);
+ *   await delivery.send(body, { replyTo: heads });
+ *
+ * Non-blocking parentRef mode (zero receipt round-trips):
+ *   const heads = await delivery.publish(header);
+ *   await delivery.send(body, { replyTo: heads, nonBlocking: true });
+ *
+ * Pass `transports` to inject mock clients for testing — the same injected
+ * client is used for both blocking and non-blocking paths (tests supply
+ * their own mock that short-circuits the writeback).
+ */
+export declare function createDelivery(ctx: WorkforceCtx, transports?: DeliveryTransports, 
+/** Override which transports to target (defaults to all configured). */
+onlyTargets?: ReadonlyArray<'slack' | 'telegram'>): DeliveryClient;
+//# sourceMappingURL=delivery.d.ts.map

package/dist/delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../src/delivery.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAIL,KAAK,cAAc,EAGnB,KAAK,kBAAkB,EAGxB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,YAAY,EACjB,UAAU,CAAC,EAAE,kBAAkB;AAC/B,wEAAwE;AACxE,WAAW,CAAC,EAAE,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC,GAChD,cAAc,CA8BhB"}

package/dist/delivery.js

@@ -0,0 +1,173 @@
+import { slackClient, telegramClient } from '@relayfile/relay-helpers';
+import { resolveDeliveryTargets, slackChannel, telegramChat } from './types.js';
+const WRITEBACK_TIMEOUT_MS = 45_000;
+/**
+ * Create a delivery client that auto-discovers configured transports from
+ * the persona context and sends to all of them.
+ *
+ * Blocking mode (the default):
+ *   const heads = await delivery.send(header);
+ *   await delivery.send(body, { replyTo: heads });
+ *
+ * Non-blocking parentRef mode (zero receipt round-trips):
+ *   const heads = await delivery.publish(header);
+ *   await delivery.send(body, { replyTo: heads, nonBlocking: true });
+ *
+ * Pass `transports` to inject mock clients for testing — the same injected
+ * client is used for both blocking and non-blocking paths (tests supply
+ * their own mock that short-circuits the writeback).
+ */
+export function createDelivery(ctx, transports, 
+/** Override which transports to target (defaults to all configured). */
+onlyTargets) {
+    const allTargets = resolveDeliveryTargets(ctx);
+    const targets = onlyTargets
+        ? allTargets.filter((t) => onlyTargets.includes(t))
+        : allTargets;
+    // Injected transports take priority. When not injected, construct real
+    // clients with appropriate timeouts.
+    const injectedSlack = transports?.slack;
+    const injectedTelegram = transports?.telegram;
+    const slackBlocking = injectedSlack ?? (targets.includes('slack')
+        ? slackClient({ writebackTimeoutMs: WRITEBACK_TIMEOUT_MS })
+        : undefined);
+    const slackNonBlocking = injectedSlack ?? (targets.includes('slack')
+        ? slackClient({ writebackTimeoutMs: 0 })
+        : undefined);
+    const telegramBlocking = injectedTelegram ?? (targets.includes('telegram')
+        ? telegramClient({ writebackTimeoutMs: WRITEBACK_TIMEOUT_MS })
+        : undefined);
+    const telegramNonBlocking = injectedTelegram ?? (targets.includes('telegram')
+        ? telegramClient({ writebackTimeoutMs: 0 })
+        : undefined);
+    return new DeliveryClientImpl(ctx, targets, {
+        slackBlocking,
+        slackNonBlocking,
+        telegramBlocking,
+        telegramNonBlocking
+    });
+}
+class DeliveryClientImpl {
+    targets;
+    ctx;
+    t;
+    constructor(ctx, targets, transports) {
+        this.ctx = ctx;
+        this.targets = targets;
+        this.t = transports;
+    }
+    async send(text, opts) {
+        const nonBlocking = opts?.nonBlocking === true;
+        const refs = [];
+        const errors = [];
+        const tasks = [];
+        for (const target of this.targets) {
+            const parentRef = opts?.replyTo?.refs.find((r) => r.provider === target);
+            if (target === 'slack') {
+                tasks.push(this.sendSlack(text, parentRef, nonBlocking)
+                    .then((ref) => { if (ref)
+                    refs.push(ref); })
+                    .catch((err) => { errors.push(`slack: ${String(err)}`); }));
+            }
+            if (target === 'telegram') {
+                tasks.push(this.sendTelegram(text, parentRef, nonBlocking)
+                    .then((ref) => { if (ref)
+                    refs.push(ref); })
+                    .catch((err) => { errors.push(`telegram: ${String(err)}`); }));
+            }
+        }
+        await Promise.all(tasks);
+        // In non-blocking mode, draft refs always succeed (no receipt wait to fail).
+        // Treat any ref as success. In blocking mode, require all targets to succeed.
+        const ok = nonBlocking
+            ? refs.length > 0
+            : errors.length === 0 && refs.length === this.targets.length;
+        if (!ok && errors.length > 0) {
+            this.ctx.log?.('warn', 'delivery.partial-failure', { errors, nonBlocking });
+        }
+        if (!ok && refs.length === 0) {
+            const detail = errors.length > 0 ? errors.join('; ') : 'all sends returned null (no configured targets)';
+            throw new Error(`Delivery failed to all targets: ${detail}`);
+        }
+        return { ok, refs };
+    }
+    async publish(text) {
+        return this.send(text, { nonBlocking: true });
+    }
+    // ── Slack ──────────────────────────────────────────────────────────────
+    async sendSlack(text, parentRef, nonBlocking) {
+        const channel = slackChannel(this.ctx);
+        if (!channel)
+            return null;
+        if (nonBlocking) {
+            return this.sendSlackNonBlocking(channel, text, parentRef);
+        }
+        return this.sendSlackBlocking(channel, text, parentRef);
+    }
+    async sendSlackBlocking(channel, text, parentRef) {
+        const client = this.t.slackBlocking;
+        if (!client)
+            return null;
+        const result = parentRef?.draftRef
+            ? await client.post(channel, text, { replyTo: parentRef.draftRef })
+            : await client.post(channel, text);
+        if (!result.ts) {
+            this.ctx.log?.('warn', 'delivery.slack.no-receipt', { channel });
+            return null;
+        }
+        return {
+            provider: 'slack',
+            channel: result.channel,
+            ts: result.ts,
+            draftRef: result.ref
+        };
+    }
+    /**
+     * Non-blocking Slack: uses messages.write() directly with writebackTimeoutMs:0.
+     * The parentRef is embedded in the message body so the cloud orders the message
+     * under the parent server-side — zero receipt round-trips. The returned draftRef
+     * is the relay path, usable as a parent for subsequent threaded sends.
+     *
+     * Mirrors the x-reply-radar parentRef threading pattern (internal-agents).
+     */
+    async sendSlackNonBlocking(channel, text, parentRef) {
+        const client = this.t.slackNonBlocking;
+        if (!client)
+            return null;
+        const body = { text };
+        if (parentRef?.draftRef) {
+            // Embed parentRef in the body — the cloud lifts it from the streamed head
+            // and orders this message under the parent once the parent delivers.
+            body.parentRef = parentRef.draftRef;
+        }
+        const result = await client.messages.write({ channelId: channel }, body);
+        return {
+            provider: 'slack',
+            channel,
+            ts: '', // Not available yet (non-blocking)
+            draftRef: result.path
+        };
+    }
+    // ── Telegram ───────────────────────────────────────────────────────────
+    async sendTelegram(text, parentRef, nonBlocking) {
+        const chatId = telegramChat(this.ctx);
+        if (!chatId)
+            return null;
+        const client = nonBlocking ? this.t.telegramNonBlocking : this.t.telegramBlocking;
+        if (!client)
+            return null;
+        const result = parentRef?.messageId
+            ? await client.sendMessage(chatId, text, { replyToMessageId: Number(parentRef.messageId) || undefined })
+            : await client.sendMessage(chatId, text);
+        if (!nonBlocking && !result.ok) {
+            this.ctx.log?.('warn', 'delivery.telegram.no-receipt', { chatId });
+            return null;
+        }
+        return {
+            provider: 'telegram',
+            chatId: result.chatId != null ? String(result.chatId) : chatId,
+            messageId: result.ok ? result.messageId : ''
+        };
+    }
+}
+//# sourceMappingURL=delivery.js.map

package/dist/delivery.js.map

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

package/dist/helpers.d.ts

@@ -0,0 +1,25 @@
+import type { WorkforceCtx } from '@agentworkforce/runtime';
+/**
+ * Resolve a persona input value from the runtime ctx.
+ *
+ * Resolution order (mirrors persona-kit): ctx.persona.inputs (already
+ * resolved from agent value → env → default by the runtime) → fall back
+ * to process.env directly when running outside the full runtime.
+ */
+export declare function input(ctx: WorkforceCtx, name: string): string | undefined;
+/**
+ * Split a comma-separated string into trimmed, non-empty entries.
+ */
+export declare function list(raw: string | undefined): string[];
+/**
+ * Race a promise against a timeout. On timeout the timer rejects with an
+ * Error so the caller can catch and fall back. Always clears the timer.
+ */
+export declare function withTimeout<T>(p: Promise<T>, ms: number, label: string): Promise<T>;
+/**
+ * Fetch with an AbortController timeout. Returns the response on success,
+ * or undefined on timeout/network error (never throws). Preserves caller-
+ * provided signal by racing our abort against it.
+ */
+export declare function fetchWithTimeout(url: string, init?: RequestInit, timeoutMs?: number): Promise<Response | undefined>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAazE;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAEtD;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EACb,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,CAAC,CAAC,CAUZ;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,WAAgB,EACtB,SAAS,GAAE,MAAc,GACxB,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAa/B"}

package/dist/helpers.js

@@ -0,0 +1,80 @@
+/**
+ * Resolve a persona input value from the runtime ctx.
+ *
+ * Resolution order (mirrors persona-kit): ctx.persona.inputs (already
+ * resolved from agent value → env → default by the runtime) → fall back
+ * to process.env directly when running outside the full runtime.
+ */
+export function input(ctx, name) {
+    const spec = ctx.persona.inputSpecs?.[name];
+    // ctx.persona.inputs is already resolved by the runtime (agent value →
+    // env → default). Check it first since it reflects the canonical value.
+    const fromCtx = ctx.persona.inputs?.[name];
+    if (fromCtx && String(fromCtx).trim())
+        return String(fromCtx).trim();
+    // Fall back to raw process.env for local dev outside the full runtime.
+    const fromEnv = process.env[spec?.env ?? name];
+    if (fromEnv && String(fromEnv).trim())
+        return String(fromEnv).trim();
+    // Last resort: the spec default.
+    const def = spec?.default;
+    if (def != null && String(def).trim())
+        return String(def).trim();
+    return undefined;
+}
+/**
+ * Split a comma-separated string into trimmed, non-empty entries.
+ */
+export function list(raw) {
+    return (raw ?? '').split(',').map((s) => s.trim()).filter(Boolean);
+}
+/**
+ * Race a promise against a timeout. On timeout the timer rejects with an
+ * Error so the caller can catch and fall back. Always clears the timer.
+ */
+export async function withTimeout(p, ms, label) {
+    let timer;
+    const timeout = new Promise((_, rej) => {
+        timer = setTimeout(() => rej(new Error(`${label} timed out after ${ms}ms`)), ms);
+    });
+    try {
+        return await Promise.race([p, timeout]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Fetch with an AbortController timeout. Returns the response on success,
+ * or undefined on timeout/network error (never throws). Preserves caller-
+ * provided signal by racing our abort against it.
+ */
+export async function fetchWithTimeout(url, init = {}, timeoutMs = 8_000) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    const signal = init.signal
+        ? anySignal([controller.signal, init.signal])
+        : controller.signal;
+    try {
+        return await fetch(url, { ...init, signal });
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Combine multiple AbortSignals — any one firing aborts the fetch. */
+function anySignal(signals) {
+    const controller = new AbortController();
+    for (const sig of signals) {
+        if (sig.aborted) {
+            controller.abort(sig.reason);
+            return controller.signal;
+        }
+        sig.addEventListener('abort', () => controller.abort(sig.reason), { once: true });
+    }
+    return controller.signal;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createDelivery } from './delivery.js';
+export { resolveDeliveryTargets, slackChannel, telegramChat, type DeliveryClient, type DeliveryOptions, type DeliveryResult, type DeliveryTransports, type MessageRef, type SlackRef, type TelegramRef } from './types.js';
+export { input, list, withTimeout, fetchWithTimeout } from './helpers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,WAAW,EACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createDelivery } from './delivery.js';
+export { resolveDeliveryTargets, slackChannel, telegramChat } from './types.js';
+export { input, list, withTimeout, fetchWithTimeout } from './helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,YAAY,EAQb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+import type { WorkforceCtx } from '@agentworkforce/runtime';
+import type { SlackClient } from '@relayfile/relay-helpers';
+import type { TelegramClient } from '@relayfile/relay-helpers';
+export interface SlackRef {
+    provider: 'slack';
+    channel: string;
+    /** Delivered message ts (set after the writeback receipt arrives). */
+    ts: string;
+    /** Draft ref for cloud-side replyTo threading. */
+    draftRef: string;
+}
+export interface TelegramRef {
+    provider: 'telegram';
+    chatId: string;
+    /** Delivered message id (set after the writeback receipt arrives). */
+    messageId: string;
+}
+export type MessageRef = SlackRef | TelegramRef;
+export interface DeliveryResult {
+    ok: boolean;
+    refs: MessageRef[];
+}
+export interface DeliveryOptions {
+    /** Thread the message under a prior delivery result. */
+    replyTo?: DeliveryResult;
+    /**
+     * When true, don't wait for the writeback receipt. Returns draft refs
+     * immediately and relies on the cloud's server-side ordering for
+     * threading (Slack parentRef pattern, Telegram sendMessage with 0ms
+     * timeout). The returned refs have empty ts/messageId but valid
+     * draftRef for use as a parent in subsequent threaded sends.
+     *
+     * Use this for the header in a header+threaded-body pattern so the
+     * digest never blocks on a receipt — the cloud orders the threaded
+     * body under the header server-side.
+     */
+    nonBlocking?: boolean;
+}
+export interface DeliveryTransports {
+    /** Injected Slack client (used for both blocking and non-blocking paths). */
+    slack?: SlackClient;
+    /** Injected Telegram client (used for both blocking and non-blocking paths). */
+    telegram?: TelegramClient;
+}
+export interface DeliveryClient {
+    /**
+     * Send a message to all configured targets.
+     *
+     * When `opts.replyTo` is set the message is threaded under the targets
+     * from that prior `DeliveryResult`, each using its transport's native
+     * threading mechanism.
+     *
+     * In blocking mode (default): waits for the writeback receipt and returns
+     * the delivered ts/messageId. In non-blocking mode (`opts.nonBlocking: true`):
+     * returns draft refs immediately with the relay path as draftRef — zero
+     * receipt round-trips, cloud-side server ordering handles threading.
+     */
+    send(text: string, opts?: DeliveryOptions): Promise<DeliveryResult>;
+    /**
+     * Convenience: same as `send(text, { nonBlocking: true })`.
+     * Publish a message without waiting for a receipt. Returns draft refs
+     * immediately for use as a threading parent.
+     */
+    publish(text: string): Promise<DeliveryResult>;
+    /** Which providers are configured. */
+    readonly targets: ReadonlyArray<'slack' | 'telegram'>;
+}
+/**
+ * Resolve which transport targets are configured for the given persona ctx.
+ * Uses input() helper for proper resolution order (ctx → env → default).
+ */
+export declare function resolveDeliveryTargets(ctx: WorkforceCtx): Array<'slack' | 'telegram'>;
+/**
+ * Get the configured slack channel id (bare, without `__name` suffix).
+ * Uses input() for proper resolution.
+ */
+export declare function slackChannel(ctx: WorkforceCtx): string | undefined;
+/**
+ * Get the configured telegram chat id (bare, without `__title` suffix).
+ * Uses input() for proper resolution.
+ */
+export declare function telegramChat(ctx: WorkforceCtx): string | undefined;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAK/D,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,WAAW,CAAC;AAIhD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,UAAU,EAAE,CAAC;CACpB;AAID,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAID,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAID,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEpE;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE/C,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,GAAG,UAAU,CAAC,CAAC;CACvD;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,YAAY,GAAG,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC,CAKrF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAGlE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAGlE"}

package/dist/types.js

@@ -0,0 +1,31 @@
+import { input } from './helpers.js';
+// ── configuration discovery ──────────────────────────────────────────────
+/**
+ * Resolve which transport targets are configured for the given persona ctx.
+ * Uses input() helper for proper resolution order (ctx → env → default).
+ */
+export function resolveDeliveryTargets(ctx) {
+    const targets = [];
+    if (input(ctx, 'SLACK_CHANNEL'))
+        targets.push('slack');
+    if (input(ctx, 'TELEGRAM_CHAT'))
+        targets.push('telegram');
+    return targets;
+}
+/**
+ * Get the configured slack channel id (bare, without `__name` suffix).
+ * Uses input() for proper resolution.
+ */
+export function slackChannel(ctx) {
+    const raw = input(ctx, 'SLACK_CHANNEL');
+    return raw?.split('__')[0]?.trim() || undefined;
+}
+/**
+ * Get the configured telegram chat id (bare, without `__title` suffix).
+ * Uses input() for proper resolution.
+ */
+export function telegramChat(ctx) {
+    const raw = input(ctx, 'TELEGRAM_CHAT');
+    return raw?.split('__')[0]?.trim() || undefined;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAqFrC,4EAA4E;AAE5E;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAiB;IACtD,MAAM,OAAO,GAAgC,EAAE,CAAC;IAChD,IAAI,KAAK,CAAC,GAAG,EAAE,eAAe,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,KAAK,CAAC,GAAG,EAAE,eAAe,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAiB;IAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IACxC,OAAO,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAiB;IAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IACxC,OAAO,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;AAClD,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@agentworkforce/delivery",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AgentWorkforce/workforce",
+    "directory": "packages/delivery"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "tsc -p tsconfig.json && node --test dist/**/*.test.js dist/*.test.js",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@agentworkforce/runtime": "workspace:*",
+    "@relayfile/relay-helpers": "^0.4.2"
+  }
+}