@opentag/client 0.1.0

package/README.md

@@ -0,0 +1,57 @@
+# @opentag/client
+
+HTTP client SDK for talking to an OpenTag dispatcher.
+
+Use this package from ingress apps, admin setup scripts, local daemons, hosted runners, or tests that need to create, claim, update, or inspect OpenTag runs over the dispatcher API.
+
+## Install
+
+```bash
+pnpm add @opentag/client
+```
+
+## Exports
+
+- `createOpenTagClient`: full dispatcher client for run creation, claiming, progress, completion, and binding management.
+- `createDispatcherClient`: runner-focused compatibility wrapper used by `opentagd`.
+- `createDispatcherAdminClient`: admin-focused compatibility wrapper for runner registration and bindings.
+- `OpenTagClient`, `ClaimedOpenTagRun`, `RepoBindingInput`, `RunProgressInput`: public TypeScript contracts.
+
+## Example
+
+```ts
+import { createOpenTagClient } from "@opentag/client";
+
+const client = createOpenTagClient({
+  dispatcherUrl: "https://opentag.example.com",
+  pairingToken: process.env.OPENTAG_DISPATCHER_TOKEN
+});
+
+await client.createRun({
+  runId: `run_${Date.now()}`,
+  event
+});
+
+const claimed = await client.claim({ runnerId: "runner_local" });
+if (claimed) {
+  await client.markRunning({ runId: claimed.run.id, executor: "custom" });
+  await client.progress({
+    runId: claimed.run.id,
+    type: "executor.progress",
+    message: "Working on the request",
+    at: new Date().toISOString()
+  });
+  await client.complete({
+    runId: claimed.run.id,
+    result: { conclusion: "success", summary: "Done" }
+  });
+}
+```
+
+## Error Handling
+
+Non-2xx dispatcher responses throw `Error` values that include the HTTP status and response body excerpt. Treat these messages as diagnostic text, not a stable machine-readable API.
+
+## Stability
+
+The method names and input object shapes are public API. New fields should be optional by default. Breaking changes follow the repository versioning policy.

package/dist/index.d.ts

@@ -0,0 +1,111 @@
+import { type OpenTagEvent, type OpenTagRun, type OpenTagRunResult } from "@opentag/core";
+export type ClaimedOpenTagRun = {
+    run: OpenTagRun;
+    event: OpenTagEvent;
+};
+export type RepoBindingInput = {
+    provider: string;
+    owner: string;
+    repo: string;
+    runnerId: string;
+    workspacePath?: string;
+    defaultExecutor?: string;
+    allowedActors?: string[];
+};
+export type RepositoryBindingConfig = {
+    provider: string;
+    owner: string;
+    repo: string;
+    checkoutPath: string;
+    defaultExecutor?: string;
+    baseBranch?: string;
+    pushRemote?: string;
+};
+export type SlackChannelBindingInput = {
+    teamId: string;
+    channelId: string;
+    owner: string;
+    repo: string;
+};
+export type OpenTagClientOptions = {
+    dispatcherUrl: string;
+    pairingToken?: string;
+    fetchImpl?: typeof fetch;
+};
+export type RunnerClientOptions = OpenTagClientOptions & {
+    runnerId: string;
+};
+export type RunProgressInput = {
+    type?: string;
+    message: string;
+    at?: string;
+};
+export type CreateRunInput = {
+    runId: string;
+    event: OpenTagEvent;
+};
+export type OpenTagClient = {
+    registerRunner(input: {
+        runnerId: string;
+        name?: string;
+    }): Promise<void>;
+    bindRepository(input: RepoBindingInput): Promise<void>;
+    getRepositoryBinding(input: {
+        provider: string;
+        owner: string;
+        repo: string;
+    }): Promise<{
+        binding: RepoBindingInput;
+    }>;
+    bindSlackChannel(input: SlackChannelBindingInput): Promise<void>;
+    getSlackChannelBinding(input: {
+        teamId: string;
+        channelId: string;
+    }): Promise<{
+        binding: SlackChannelBindingInput;
+    }>;
+    createRun(input: CreateRunInput): Promise<{
+        run: OpenTagRun;
+    }>;
+    claim(input: {
+        runnerId: string;
+    }): Promise<ClaimedOpenTagRun | null>;
+    heartbeat(input: {
+        runnerId: string;
+        runId: string;
+    }): Promise<void>;
+    markRunning(input: {
+        runId: string;
+        executor: string;
+    }): Promise<void>;
+    progress(input: {
+        runId: string;
+    } & RunProgressInput): Promise<void>;
+    complete(input: {
+        runId: string;
+        result: OpenTagRunResult;
+    }): Promise<void>;
+    getRun(input: {
+        runId: string;
+    }): Promise<ClaimedOpenTagRun>;
+    listRunEvents(input: {
+        runId: string;
+    }): Promise<{
+        events: unknown[];
+    }>;
+};
+export type DispatcherRunnerClient = {
+    claim(): Promise<ClaimedOpenTagRun | null>;
+    markRunning(runId: string, executor: string): Promise<void>;
+    heartbeat(runId: string): Promise<void>;
+    progress(runId: string, input: Required<RunProgressInput>): Promise<void>;
+    complete(runId: string, result: OpenTagRunResult): Promise<void>;
+};
+export declare function createOpenTagClient(options: OpenTagClientOptions): OpenTagClient;
+export declare function createDispatcherClient(options: RunnerClientOptions): DispatcherRunnerClient;
+export declare function createDispatcherAdminClient(options: RunnerClientOptions): {
+    registerRunner(name?: string): Promise<void>;
+    bindRepository(binding: RepositoryBindingConfig): Promise<void>;
+    bindSlackChannel(binding: SlackChannelBindingInput): Promise<void>;
+};
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,178 @@
+// src/index.ts
+import {
+  OpenTagEventSchema,
+  OpenTagRunResultSchema,
+  OpenTagRunSchema
+} from "@opentag/core";
+function baseUrlFrom(dispatcherUrl) {
+  return dispatcherUrl.replace(/\/$/, "");
+}
+function authHeaders(pairingToken) {
+  return pairingToken ? { authorization: `Bearer ${pairingToken}` } : {};
+}
+function jsonHeaders(pairingToken) {
+  return { "content-type": "application/json", ...authHeaders(pairingToken) };
+}
+async function assertOk(response, action) {
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`${action} failed: ${response.status}${text ? ` ${text}` : ""}`);
+  }
+}
+function parseClaimedRun(body) {
+  return {
+    run: OpenTagRunSchema.parse(body.run),
+    event: OpenTagEventSchema.parse(body.event)
+  };
+}
+function createOpenTagClient(options) {
+  const baseUrl = baseUrlFrom(options.dispatcherUrl);
+  const fetchImpl = options.fetchImpl ?? fetch;
+  return {
+    async registerRunner(input) {
+      const response = await fetchImpl(`${baseUrl}/v1/runners`, {
+        method: "POST",
+        headers: jsonHeaders(options.pairingToken),
+        body: JSON.stringify({ runnerId: input.runnerId, name: input.name ?? input.runnerId })
+      });
+      await assertOk(response, "registerRunner");
+    },
+    async bindRepository(input) {
+      const response = await fetchImpl(`${baseUrl}/v1/repo-bindings`, {
+        method: "POST",
+        headers: jsonHeaders(options.pairingToken),
+        body: JSON.stringify(input)
+      });
+      await assertOk(response, "bindRepository");
+    },
+    async getRepositoryBinding(input) {
+      const response = await fetchImpl(`${baseUrl}/v1/repo-bindings/${input.provider}/${input.owner}/${input.repo}`, {
+        headers: authHeaders(options.pairingToken)
+      });
+      await assertOk(response, "getRepositoryBinding");
+      return await response.json();
+    },
+    async bindSlackChannel(input) {
+      const response = await fetchImpl(`${baseUrl}/v1/slack-channel-bindings`, {
+        method: "POST",
+        headers: jsonHeaders(options.pairingToken),
+        body: JSON.stringify(input)
+      });
+      await assertOk(response, "bindSlackChannel");
+    },
+    async getSlackChannelBinding(input) {
+      const response = await fetchImpl(`${baseUrl}/v1/slack-channel-bindings/${input.teamId}/${input.channelId}`, {
+        headers: authHeaders(options.pairingToken)
+      });
+      await assertOk(response, "getSlackChannelBinding");
+      return await response.json();
+    },
+    async createRun(input) {
+      const event = OpenTagEventSchema.parse(input.event);
+      const response = await fetchImpl(`${baseUrl}/v1/runs`, {
+        method: "POST",
+        headers: jsonHeaders(options.pairingToken),
+        body: JSON.stringify({ runId: input.runId, event })
+      });
+      await assertOk(response, "createRun");
+      const body = await response.json();
+      return { run: OpenTagRunSchema.parse(body.run) };
+    },
+    async claim(input) {
+      const response = await fetchImpl(`${baseUrl}/v1/runners/${input.runnerId}/claim`, {
+        method: "POST",
+        headers: authHeaders(options.pairingToken)
+      });
+      if (response.status === 204) return null;
+      await assertOk(response, "claim");
+      return parseClaimedRun(await response.json());
+    },
+    async heartbeat(input) {
+      const response = await fetchImpl(`${baseUrl}/v1/runners/${input.runnerId}/runs/${input.runId}/heartbeat`, {
+        method: "POST",
+        headers: authHeaders(options.pairingToken)
+      });
+      await assertOk(response, "heartbeat");
+    },
+    async markRunning(input) {
+      const response = await fetchImpl(`${baseUrl}/v1/runs/${input.runId}/running`, {
+        method: "POST",
+        headers: jsonHeaders(options.pairingToken),
+        body: JSON.stringify({ executor: input.executor })
+      });
+      await assertOk(response, "markRunning");
+    },
+    async progress(input) {
+      const response = await fetchImpl(`${baseUrl}/v1/runs/${input.runId}/progress`, {
+        method: "POST",
+        headers: jsonHeaders(options.pairingToken),
+        body: JSON.stringify({
+          ...input.type ? { type: input.type } : {},
+          message: input.message,
+          ...input.at ? { at: input.at } : {}
+        })
+      });
+      await assertOk(response, "progress");
+    },
+    async complete(input) {
+      const result = OpenTagRunResultSchema.parse(input.result);
+      const response = await fetchImpl(`${baseUrl}/v1/runs/${input.runId}/complete`, {
+        method: "POST",
+        headers: jsonHeaders(options.pairingToken),
+        body: JSON.stringify({ result })
+      });
+      await assertOk(response, "complete");
+    },
+    async getRun(input) {
+      const response = await fetchImpl(`${baseUrl}/v1/runs/${input.runId}`, {
+        headers: authHeaders(options.pairingToken)
+      });
+      await assertOk(response, "getRun");
+      return parseClaimedRun(await response.json());
+    },
+    async listRunEvents(input) {
+      const response = await fetchImpl(`${baseUrl}/v1/runs/${input.runId}/events`, {
+        headers: authHeaders(options.pairingToken)
+      });
+      await assertOk(response, "listRunEvents");
+      return await response.json();
+    }
+  };
+}
+function createDispatcherClient(options) {
+  const client = createOpenTagClient(options);
+  return {
+    claim: () => client.claim({ runnerId: options.runnerId }),
+    markRunning: (runId, executor) => client.markRunning({ runId, executor }),
+    heartbeat: (runId) => client.heartbeat({ runnerId: options.runnerId, runId }),
+    progress: (runId, input) => client.progress({ runId, ...input }),
+    complete: (runId, result) => client.complete({ runId, result })
+  };
+}
+function createDispatcherAdminClient(options) {
+  const client = createOpenTagClient(options);
+  return {
+    registerRunner(name = options.runnerId) {
+      return client.registerRunner({ runnerId: options.runnerId, name });
+    },
+    bindRepository(binding) {
+      return client.bindRepository({
+        provider: binding.provider,
+        owner: binding.owner,
+        repo: binding.repo,
+        runnerId: options.runnerId,
+        workspacePath: binding.checkoutPath,
+        ...binding.defaultExecutor ? { defaultExecutor: binding.defaultExecutor } : {}
+      });
+    },
+    bindSlackChannel(binding) {
+      return client.bindSlackChannel(binding);
+    }
+  };
+}
+export {
+  createDispatcherAdminClient,
+  createDispatcherClient,
+  createOpenTagClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  OpenTagEventSchema,\n  OpenTagRunResultSchema,\n  OpenTagRunSchema,\n  type OpenTagEvent,\n  type OpenTagRun,\n  type OpenTagRunResult\n} from \"@opentag/core\";\n\nexport type ClaimedOpenTagRun = {\n  run: OpenTagRun;\n  event: OpenTagEvent;\n};\n\nexport type RepoBindingInput = {\n  provider: string;\n  owner: string;\n  repo: string;\n  runnerId: string;\n  workspacePath?: string;\n  defaultExecutor?: string;\n  allowedActors?: string[];\n};\n\nexport type RepositoryBindingConfig = {\n  provider: string;\n  owner: string;\n  repo: string;\n  checkoutPath: string;\n  defaultExecutor?: string;\n  baseBranch?: string;\n  pushRemote?: string;\n};\n\nexport type SlackChannelBindingInput = {\n  teamId: string;\n  channelId: string;\n  owner: string;\n  repo: string;\n};\n\nexport type OpenTagClientOptions = {\n  dispatcherUrl: string;\n  pairingToken?: string;\n  fetchImpl?: typeof fetch;\n};\n\nexport type RunnerClientOptions = OpenTagClientOptions & {\n  runnerId: string;\n};\n\nexport type RunProgressInput = {\n  type?: string;\n  message: string;\n  at?: string;\n};\n\nexport type CreateRunInput = {\n  runId: string;\n  event: OpenTagEvent;\n};\n\nexport type OpenTagClient = {\n  registerRunner(input: { runnerId: string; name?: string }): Promise<void>;\n  bindRepository(input: RepoBindingInput): Promise<void>;\n  getRepositoryBinding(input: { provider: string; owner: string; repo: string }): Promise<{ binding: RepoBindingInput }>;\n  bindSlackChannel(input: SlackChannelBindingInput): Promise<void>;\n  getSlackChannelBinding(input: { teamId: string; channelId: string }): Promise<{ binding: SlackChannelBindingInput }>;\n  createRun(input: CreateRunInput): Promise<{ run: OpenTagRun }>;\n  claim(input: { runnerId: string }): Promise<ClaimedOpenTagRun | null>;\n  heartbeat(input: { runnerId: string; runId: string }): Promise<void>;\n  markRunning(input: { runId: string; executor: string }): Promise<void>;\n  progress(input: { runId: string } & RunProgressInput): Promise<void>;\n  complete(input: { runId: string; result: OpenTagRunResult }): Promise<void>;\n  getRun(input: { runId: string }): Promise<ClaimedOpenTagRun>;\n  listRunEvents(input: { runId: string }): Promise<{ events: unknown[] }>;\n};\n\nexport type DispatcherRunnerClient = {\n  claim(): Promise<ClaimedOpenTagRun | null>;\n  markRunning(runId: string, executor: string): Promise<void>;\n  heartbeat(runId: string): Promise<void>;\n  progress(runId: string, input: Required<RunProgressInput>): Promise<void>;\n  complete(runId: string, result: OpenTagRunResult): Promise<void>;\n};\n\nfunction baseUrlFrom(dispatcherUrl: string): string {\n  return dispatcherUrl.replace(/\\/$/, \"\");\n}\n\nfunction authHeaders(pairingToken: string | undefined): Record<string, string> {\n  return pairingToken ? { authorization: `Bearer ${pairingToken}` } : {};\n}\n\nfunction jsonHeaders(pairingToken: string | undefined): Record<string, string> {\n  return { \"content-type\": \"application/json\", ...authHeaders(pairingToken) };\n}\n\nasync function assertOk(response: Response, action: string): Promise<void> {\n  if (!response.ok) {\n    const text = await response.text();\n    throw new Error(`${action} failed: ${response.status}${text ? ` ${text}` : \"\"}`);\n  }\n}\n\nfunction parseClaimedRun(body: { run: unknown; event: unknown }): ClaimedOpenTagRun {\n  return {\n    run: OpenTagRunSchema.parse(body.run),\n    event: OpenTagEventSchema.parse(body.event)\n  };\n}\n\nexport function createOpenTagClient(options: OpenTagClientOptions): OpenTagClient {\n  const baseUrl = baseUrlFrom(options.dispatcherUrl);\n  const fetchImpl = options.fetchImpl ?? fetch;\n\n  return {\n    async registerRunner(input) {\n      const response = await fetchImpl(`${baseUrl}/v1/runners`, {\n        method: \"POST\",\n        headers: jsonHeaders(options.pairingToken),\n        body: JSON.stringify({ runnerId: input.runnerId, name: input.name ?? input.runnerId })\n      });\n      await assertOk(response, \"registerRunner\");\n    },\n\n    async bindRepository(input) {\n      const response = await fetchImpl(`${baseUrl}/v1/repo-bindings`, {\n        method: \"POST\",\n        headers: jsonHeaders(options.pairingToken),\n        body: JSON.stringify(input)\n      });\n      await assertOk(response, \"bindRepository\");\n    },\n\n    async getRepositoryBinding(input) {\n      const response = await fetchImpl(`${baseUrl}/v1/repo-bindings/${input.provider}/${input.owner}/${input.repo}`, {\n        headers: authHeaders(options.pairingToken)\n      });\n      await assertOk(response, \"getRepositoryBinding\");\n      return (await response.json()) as { binding: RepoBindingInput };\n    },\n\n    async bindSlackChannel(input) {\n      const response = await fetchImpl(`${baseUrl}/v1/slack-channel-bindings`, {\n        method: \"POST\",\n        headers: jsonHeaders(options.pairingToken),\n        body: JSON.stringify(input)\n      });\n      await assertOk(response, \"bindSlackChannel\");\n    },\n\n    async getSlackChannelBinding(input) {\n      const response = await fetchImpl(`${baseUrl}/v1/slack-channel-bindings/${input.teamId}/${input.channelId}`, {\n        headers: authHeaders(options.pairingToken)\n      });\n      await assertOk(response, \"getSlackChannelBinding\");\n      return (await response.json()) as { binding: SlackChannelBindingInput };\n    },\n\n    async createRun(input) {\n      const event = OpenTagEventSchema.parse(input.event);\n      const response = await fetchImpl(`${baseUrl}/v1/runs`, {\n        method: \"POST\",\n        headers: jsonHeaders(options.pairingToken),\n        body: JSON.stringify({ runId: input.runId, event })\n      });\n      await assertOk(response, \"createRun\");\n      const body = (await response.json()) as { run: unknown };\n      return { run: OpenTagRunSchema.parse(body.run) };\n    },\n\n    async claim(input) {\n      const response = await fetchImpl(`${baseUrl}/v1/runners/${input.runnerId}/claim`, {\n        method: \"POST\",\n        headers: authHeaders(options.pairingToken)\n      });\n      if (response.status === 204) return null;\n      await assertOk(response, \"claim\");\n      return parseClaimedRun((await response.json()) as { run: unknown; event: unknown });\n    },\n\n    async heartbeat(input) {\n      const response = await fetchImpl(`${baseUrl}/v1/runners/${input.runnerId}/runs/${input.runId}/heartbeat`, {\n        method: \"POST\",\n        headers: authHeaders(options.pairingToken)\n      });\n      await assertOk(response, \"heartbeat\");\n    },\n\n    async markRunning(input) {\n      const response = await fetchImpl(`${baseUrl}/v1/runs/${input.runId}/running`, {\n        method: \"POST\",\n        headers: jsonHeaders(options.pairingToken),\n        body: JSON.stringify({ executor: input.executor })\n      });\n      await assertOk(response, \"markRunning\");\n    },\n\n    async progress(input) {\n      const response = await fetchImpl(`${baseUrl}/v1/runs/${input.runId}/progress`, {\n        method: \"POST\",\n        headers: jsonHeaders(options.pairingToken),\n        body: JSON.stringify({\n          ...(input.type ? { type: input.type } : {}),\n          message: input.message,\n          ...(input.at ? { at: input.at } : {})\n        })\n      });\n      await assertOk(response, \"progress\");\n    },\n\n    async complete(input) {\n      const result = OpenTagRunResultSchema.parse(input.result);\n      const response = await fetchImpl(`${baseUrl}/v1/runs/${input.runId}/complete`, {\n        method: \"POST\",\n        headers: jsonHeaders(options.pairingToken),\n        body: JSON.stringify({ result })\n      });\n      await assertOk(response, \"complete\");\n    },\n\n    async getRun(input) {\n      const response = await fetchImpl(`${baseUrl}/v1/runs/${input.runId}`, {\n        headers: authHeaders(options.pairingToken)\n      });\n      await assertOk(response, \"getRun\");\n      return parseClaimedRun((await response.json()) as { run: unknown; event: unknown });\n    },\n\n    async listRunEvents(input) {\n      const response = await fetchImpl(`${baseUrl}/v1/runs/${input.runId}/events`, {\n        headers: authHeaders(options.pairingToken)\n      });\n      await assertOk(response, \"listRunEvents\");\n      return (await response.json()) as { events: unknown[] };\n    }\n  };\n}\n\nexport function createDispatcherClient(options: RunnerClientOptions): DispatcherRunnerClient {\n  const client = createOpenTagClient(options);\n  return {\n    claim: () => client.claim({ runnerId: options.runnerId }),\n    markRunning: (runId, executor) => client.markRunning({ runId, executor }),\n    heartbeat: (runId) => client.heartbeat({ runnerId: options.runnerId, runId }),\n    progress: (runId, input) => client.progress({ runId, ...input }),\n    complete: (runId, result) => client.complete({ runId, result })\n  };\n}\n\nexport function createDispatcherAdminClient(options: RunnerClientOptions) {\n  const client = createOpenTagClient(options);\n  return {\n    registerRunner(name = options.runnerId): Promise<void> {\n      return client.registerRunner({ runnerId: options.runnerId, name });\n    },\n\n    bindRepository(binding: RepositoryBindingConfig): Promise<void> {\n      return client.bindRepository({\n        provider: binding.provider,\n        owner: binding.owner,\n        repo: binding.repo,\n        runnerId: options.runnerId,\n        workspacePath: binding.checkoutPath,\n        ...(binding.defaultExecutor ? { defaultExecutor: binding.defaultExecutor } : {})\n      });\n    },\n\n    bindSlackChannel(binding: SlackChannelBindingInput): Promise<void> {\n      return client.bindSlackChannel(binding);\n    }\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@opentag/client",
+  "version": "0.1.0",
+  "description": "HTTP client SDK for creating, claiming, and updating OpenTag dispatcher runs.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "opentag",
+    "sdk",
+    "client",
+    "dispatcher",
+    "agents"
+  ],
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@opentag/core": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "tsup && tsc -b tsconfig.json --emitDeclarationOnly --force",
+    "lint": "tsc --noEmit"
+  }
+}