@opentag/dispatcher 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amplift
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -15,6 +15,7 @@ pnpm add @opentag/dispatcher
 - `createDispatcherApp`: creates the Hono app that exposes the OpenTag dispatcher API.
 - `createGitHubCallbackSink`: posts callback messages to GitHub issue or PR comments.
 - `createSlackCallbackSink`: posts callback messages to Slack threads through `chat.postMessage`.
+- `createTelegramCallbackSink`: posts callback messages to Telegram chats through the Bot API `sendMessage` method.
 - `createCompositeCallbackSink`: fans callback delivery out to multiple sinks.
 - `CallbackMessage`, `CallbackSink`: callback delivery contracts.
 
@@ -25,7 +26,8 @@ import {
   createCompositeCallbackSink,
   createDispatcherApp,
   createGitHubCallbackSink,
-  createSlackCallbackSink
+  createSlackCallbackSink,
+  createTelegramCallbackSink
 } from "@opentag/dispatcher";
 
 export const dispatcher = createDispatcherApp({
@@ -33,14 +35,15 @@ export const dispatcher = createDispatcherApp({
   pairingToken: process.env.OPENTAG_PAIRING_TOKEN,
   callbackSink: createCompositeCallbackSink([
     createGitHubCallbackSink({ token: process.env.OPENTAG_GITHUB_TOKEN }),
-    createSlackCallbackSink({ botToken: process.env.OPENTAG_SLACK_BOT_TOKEN })
+    createSlackCallbackSink({ botToken: process.env.OPENTAG_SLACK_BOT_TOKEN }),
+    createTelegramCallbackSink({ botToken: process.env.OPENTAG_TELEGRAM_BOT_TOKEN })
   ])
 });
 ```
 
 ## API Shape
 
-The app exposes `/healthz` and `/v1/*` dispatcher endpoints for runners, repository bindings, Slack channel bindings, runs, progress, heartbeats, completion, and audit event lookup.
+The app exposes `/healthz` and `/v1/*` dispatcher endpoints for runners, Project Target bindings, generic channel bindings, Slack compatibility bindings, runs, progress, heartbeats, completion, and audit event lookup.
 
 When `pairingToken` is set, every `/v1/*` endpoint requires:
 

package/dist/admission.d.ts

@@ -0,0 +1,44 @@
+import { type OpenTagEvent, type OpenTagRun, type RunAdmissionDecision, type RunAdmissionReasonCode } from "@opentag/core";
+import { type FollowUpRequest, type RepoBinding, type createOpenTagRepository } from "@opentag/store";
+type Repository = ReturnType<typeof createOpenTagRepository>;
+export type AgentAccessProfileCheckInput = {
+    event: OpenTagEvent;
+    binding: RepoBinding;
+};
+export type AgentAccessProfileCheckResult = {
+    allowed: true;
+} | {
+    allowed: false;
+    reason: string;
+    reasonCode?: Extract<RunAdmissionReasonCode, "agent_access_profile_denied" | "policy_rejected">;
+};
+export type AgentAccessProfileCheck = (input: AgentAccessProfileCheckInput) => Promise<AgentAccessProfileCheckResult>;
+export type AdmitRunInput = {
+    requestId: string;
+    event: OpenTagEvent;
+};
+export type AdmitRunResult = {
+    outcome: "start";
+    decision: RunAdmissionDecision;
+    binding: RepoBinding;
+} | {
+    outcome: "drop_duplicate";
+    decision: RunAdmissionDecision;
+    run: OpenTagRun;
+    idempotentReplay: true;
+} | {
+    outcome: "follow_up_queued";
+    decision: RunAdmissionDecision;
+    followUpRequest: FollowUpRequest;
+} | {
+    outcome: "needs_human_decision";
+    decision: RunAdmissionDecision;
+};
+export declare function createAdmissionRuntime(input: {
+    repo: Repository;
+    agentAccessProfileCheck?: AgentAccessProfileCheck;
+}): {
+    admitRun(request: AdmitRunInput): Promise<AdmitRunResult>;
+};
+export {};
+//# sourceMappingURL=admission.d.ts.map

package/dist/admission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admission.d.ts","sourceRoot":"","sources":["../src/admission.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,WAAW,EAAE,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEtG,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE7D,MAAM,MAAM,4BAA4B,GAAG;IACzC,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GACrC;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GACjB;IACE,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC,sBAAsB,EAAE,6BAA6B,GAAG,iBAAiB,CAAC,CAAC;CACjG,CAAC;AAEN,MAAM,MAAM,uBAAuB,GAAG,CAAC,KAAK,EAAE,4BAA4B,KAAK,OAAO,CAAC,6BAA6B,CAAC,CAAC;AAEtH,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB;IACE,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,OAAO,EAAE,WAAW,CAAC;CACtB,GACD;IACE,OAAO,EAAE,gBAAgB,CAAC;IAC1B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,GAAG,EAAE,UAAU,CAAC;IAChB,gBAAgB,EAAE,IAAI,CAAC;CACxB,GACD;IACE,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,eAAe,EAAE,eAAe,CAAC;CAClC,GACD;IACE,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,oBAAoB,CAAC;CAChC,CAAC;AAgCN,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,IAAI,EAAE,UAAU,CAAC;IACjB,uBAAuB,CAAC,EAAE,uBAAuB,CAAC;CACnD;sBAI2B,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;EAoHlE"}

package/dist/callbacks.d.ts

@@ -1,3 +1,4 @@
+import { type LarkReplyClient } from "@opentag/lark";
 import type { CallbackSink } from "./server.js";
 export type FetchLike = typeof fetch;
 export declare function createGitHubCallbackSink(input: {
@@ -6,6 +7,18 @@ export declare function createGitHubCallbackSink(input: {
 }): CallbackSink;
 export declare function createSlackCallbackSink(input: {
     botToken?: string;
+    botTokensByAgentId?: Record<string, string>;
+    fetchImpl?: FetchLike;
+}): CallbackSink;
+export declare function createLarkCallbackSink(input: {
+    appId?: string;
+    appSecret?: string;
+    domain?: "lark" | "feishu";
+    client?: LarkReplyClient;
+}): CallbackSink;
+export declare function createTelegramCallbackSink(input: {
+    botToken?: string;
+    botTokensByAgentId?: Record<string, string>;
     fetchImpl?: FetchLike;
 }): CallbackSink;
 export declare function createCompositeCallbackSink(sinks: CallbackSink[]): CallbackSink;

package/dist/callbacks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"callbacks.d.ts","sourceRoot":"","sources":["../src/callbacks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AAErC,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,YAAY,CAwBvG;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,YAAY,CA+BzG;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,CAQ/E"}
+{"version":3,"file":"callbacks.d.ts","sourceRoot":"","sources":["../src/callbacks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,eAAe,EAAwC,MAAM,eAAe,CAAC;AAGlH,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,aAAa,CAAC;AAEjE,MAAM,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC;AA8BrC,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,YAAY,CA+CvG;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,GAAG,YAAY,CA0Df;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B,GAAG,YAAY,CA0Bf;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,GAAG,YAAY,CAyDf;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,CAQ/E"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from "./callbacks.js";
+export * from "./presentation.js";
 export * from "./server.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC"}