@flow-a2a/shared 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export type { LobsterIdentity, LobsterInfo, MentionTarget, ClientMessage, ServerMessage, TelemetryRecord, TriggerUserInfo, LobbyAdapter, } from "./types.js";
+export { MODEL_PRICING, MODEL_ALIASES, computeCost, type ModelPrice, type CostSource, type CostResult, } from "./pricing.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { MODEL_PRICING, MODEL_ALIASES, computeCost, } from "./pricing.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":"AAWA,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,GAIZ,MAAM,cAAc,CAAC"}

package/dist/pricing.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Flow-A2A — Model Pricing Table & Cost Calculator
+ *
+ * Reused from costclaw-telemetry with no modifications.
+ */
+export interface ModelPrice {
+    inputPer1M: number;
+    outputPer1M: number;
+}
+export declare const MODEL_PRICING: Record<string, ModelPrice>;
+export declare const MODEL_ALIASES: Array<[string, string]>;
+export type CostSource = "telemetry" | "calculated" | "estimated";
+export interface CostResult {
+    costUsd: number;
+    source: CostSource;
+}
+export declare function computeCost(model: string, inputTokens: number, outputTokens: number, telemetryCostUsd?: number): CostResult;

package/dist/pricing.js

@@ -0,0 +1,88 @@
+/**
+ * Flow-A2A — Model Pricing Table & Cost Calculator
+ *
+ * Reused from costclaw-telemetry with no modifications.
+ */
+// Prices as of March 2026 — update entries as needed
+export const MODEL_PRICING = {
+    // OpenAI
+    "gpt-4o": { inputPer1M: 2.50, outputPer1M: 10.00 },
+    "gpt-4o-2024-11-20": { inputPer1M: 2.50, outputPer1M: 10.00 },
+    "gpt-4o-mini": { inputPer1M: 0.15, outputPer1M: 0.60 },
+    "gpt-4o-mini-2024-07-18": { inputPer1M: 0.15, outputPer1M: 0.60 },
+    "gpt-4-turbo": { inputPer1M: 10.00, outputPer1M: 30.00 },
+    "gpt-4": { inputPer1M: 30.00, outputPer1M: 60.00 },
+    "gpt-3.5-turbo": { inputPer1M: 0.50, outputPer1M: 1.50 },
+    "o1": { inputPer1M: 15.00, outputPer1M: 60.00 },
+    "o1-mini": { inputPer1M: 3.00, outputPer1M: 12.00 },
+    "o3": { inputPer1M: 10.00, outputPer1M: 40.00 },
+    "o3-mini": { inputPer1M: 1.10, outputPer1M: 4.40 },
+    "o4-mini": { inputPer1M: 1.10, outputPer1M: 4.40 },
+    // Anthropic Claude
+    "claude-3-5-sonnet-20241022": { inputPer1M: 3.00, outputPer1M: 15.00 },
+    "claude-3-5-sonnet-20240620": { inputPer1M: 3.00, outputPer1M: 15.00 },
+    "claude-3-5-haiku-20241022": { inputPer1M: 0.80, outputPer1M: 4.00 },
+    "claude-3-opus-20240229": { inputPer1M: 15.00, outputPer1M: 75.00 },
+    "claude-3-sonnet-20240229": { inputPer1M: 3.00, outputPer1M: 15.00 },
+    "claude-3-haiku-20240307": { inputPer1M: 0.25, outputPer1M: 1.25 },
+    "claude-sonnet-4-6": { inputPer1M: 3.00, outputPer1M: 15.00 },
+    "claude-opus-4-6": { inputPer1M: 15.00, outputPer1M: 75.00 },
+    "claude-haiku-4-5": { inputPer1M: 0.80, outputPer1M: 4.00 },
+    // Google Gemini
+    "gemini-2.5-pro": { inputPer1M: 1.25, outputPer1M: 10.00 },
+    "gemini-2.5-flash": { inputPer1M: 0.30, outputPer1M: 2.50 },
+    "gemini-2.5-flash-lite": { inputPer1M: 0.10, outputPer1M: 0.40 },
+    "gemini-2.0-flash": { inputPer1M: 0.10, outputPer1M: 0.40 },
+    "gemini-1.5-pro": { inputPer1M: 1.25, outputPer1M: 5.00 },
+    "gemini-1.5-flash": { inputPer1M: 0.075, outputPer1M: 0.30 },
+    // xAI Grok
+    "grok-2": { inputPer1M: 2.00, outputPer1M: 10.00 },
+    "grok-2-mini": { inputPer1M: 0.20, outputPer1M: 0.40 },
+    "grok-3": { inputPer1M: 3.00, outputPer1M: 15.00 },
+    // Meta Llama (via API providers — prices vary, these are common averages)
+    "llama-3.1-405b-instruct": { inputPer1M: 3.00, outputPer1M: 3.00 },
+    "llama-3.1-70b-instruct": { inputPer1M: 0.52, outputPer1M: 0.75 },
+    "llama-3.1-8b-instruct": { inputPer1M: 0.05, outputPer1M: 0.08 },
+    "llama-3.3-70b-instruct": { inputPer1M: 0.23, outputPer1M: 0.40 },
+};
+// Canonical aliases for prefix matching (longest match wins)
+export const MODEL_ALIASES = [
+    ["claude-3-5-sonnet", "claude-3-5-sonnet-20241022"],
+    ["claude-3-5-haiku", "claude-3-5-haiku-20241022"],
+    ["claude-3-opus", "claude-3-opus-20240229"],
+    ["claude-3-sonnet", "claude-3-sonnet-20240229"],
+    ["claude-3-haiku", "claude-3-haiku-20240307"],
+    ["gpt-4o-mini", "gpt-4o-mini"],
+    ["gpt-4o", "gpt-4o"],
+    ["gr-claude-opus", "claude-opus-4-6"],
+    ["gr-claude-sonnet", "claude-sonnet-4-6"],
+];
+function resolveModel(raw) {
+    const lower = raw.toLowerCase().trim();
+    if (MODEL_PRICING[lower])
+        return lower;
+    for (const [alias, canonical] of MODEL_ALIASES) {
+        if (lower.startsWith(alias))
+            return canonical;
+    }
+    const keys = Object.keys(MODEL_PRICING).sort((a, b) => b.length - a.length);
+    for (const key of keys) {
+        if (lower.startsWith(key) || key.startsWith(lower))
+            return key;
+    }
+    return null;
+}
+export function computeCost(model, inputTokens, outputTokens, telemetryCostUsd) {
+    if (telemetryCostUsd != null && telemetryCostUsd > 0) {
+        return { costUsd: telemetryCostUsd, source: "telemetry" };
+    }
+    const resolved = resolveModel(model);
+    if (!resolved) {
+        return { costUsd: 0, source: "estimated" };
+    }
+    const price = MODEL_PRICING[resolved];
+    const costUsd = (inputTokens / 1_000_000) * price.inputPer1M +
+        (outputTokens / 1_000_000) * price.outputPer1M;
+    return { costUsd, source: "calculated" };
+}
+//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Flow-A2A — Shared Protocol Types
+ *
+ * Extends reef's protocol with telemetry message types.
+ * Used by plugin (client), center (server), and shared tooling.
+ */
+export interface LobsterIdentity {
+    lobsterId: string;
+    name: string;
+    botOpenId?: string;
+    groups?: string[];
+    meta?: Record<string, unknown>;
+}
+export interface LobsterInfo {
+    id: string;
+    name: string;
+    botOpenId?: string;
+    groups: string[];
+    connectedAt: number;
+    meta?: Record<string, unknown>;
+}
+export interface MentionTarget {
+    name: string;
+    openId?: string;
+}
+export type ClientMessage = ({
+    type: "register";
+    token?: string;
+} & LobsterIdentity) | {
+    type: "lobby";
+    text: string;
+} | {
+    type: "dm";
+    to: string;
+    text: string;
+} | {
+    type: "feishu";
+    chatId: string;
+    text: string;
+    messageId?: string;
+    threadId?: string;
+    mentions?: MentionTarget[];
+} | {
+    type: "history";
+} | {
+    type: "ping";
+} | {
+    type: "who";
+} | {
+    type: "telemetry";
+    batch: TelemetryRecord[];
+};
+export type ServerMessage = {
+    type: "registered";
+    lobsterId: string;
+    lobsters: LobsterInfo[];
+} | {
+    type: "lobby";
+    from: string;
+    fromName: string;
+    text: string;
+    ts: number;
+} | {
+    type: "dm";
+    from: string;
+    fromName: string;
+    text: string;
+    ts: number;
+    echo?: boolean;
+} | {
+    type: "feishu";
+    from: string;
+    fromName: string;
+    fromBotOpenId: string;
+    chatId: string;
+    text: string;
+    messageId: string;
+    threadId?: string;
+    ts: number;
+} | {
+    type: "join";
+    lobsterId: string;
+    name: string;
+    ts: number;
+} | {
+    type: "leave";
+    lobsterId: string;
+    name: string;
+    ts: number;
+} | {
+    type: "history";
+    messages: ServerMessage[];
+} | {
+    type: "who";
+    lobsters: LobsterInfo[];
+} | {
+    type: "pong";
+} | {
+    type: "error";
+    message: string;
+} | {
+    type: "telemetry_ack";
+    accepted: number;
+    errors?: string[];
+};
+export interface TelemetryRecord {
+    kind: "llm" | "tool";
+    ts: number;
+    sessionKey?: string;
+    agentId?: string;
+    triggerUser?: string;
+    triggerUserId?: string;
+    triggerSource?: string;
+    channel?: string;
+    scope?: string;
+    conversationId?: string;
+    conversationName?: string;
+    model?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    costUsd?: number;
+    costSource?: string;
+    trigger?: string;
+    isSubagent?: boolean;
+    toolName?: string;
+    success?: boolean;
+    durationMs?: number;
+}
+export interface TriggerUserInfo {
+    triggerUser: string;
+    triggerUserId: string;
+    triggerSource: string;
+    channel?: string;
+    scope?: string;
+    conversationId?: string;
+    conversationName?: string;
+    ts: number;
+}
+export interface LobbyAdapter {
+    onLobbyMessage?(msg: {
+        from: string;
+        fromName: string;
+        text: string;
+        ts: number;
+    }): void;
+    onDirectMessage?(msg: {
+        from: string;
+        fromName: string;
+        text: string;
+        ts: number;
+    }): void;
+    onFeishuRelay?(msg: {
+        from: string;
+        fromName: string;
+        fromBotOpenId: string;
+        chatId: string;
+        text: string;
+        messageId: string;
+        threadId?: string;
+        ts: number;
+    }): void;
+    onPresence?(msg: {
+        type: "join" | "leave";
+        lobsterId: string;
+        name: string;
+    }): void;
+    onHistory?(messages: ServerMessage[]): void;
+}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Flow-A2A — Shared Protocol Types
+ *
+ * Extends reef's protocol with telemetry message types.
+ * Used by plugin (client), center (server), and shared tooling.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@flow-a2a/shared",
+  "version": "0.1.0",
+  "description": "Shared types, protocol definitions, and pricing logic for Flow-A2A",
+  "type": "module",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nicepkg/flow-a2a.git",
+    "directory": "packages/shared"
+  },
+  "homepage": "https://github.com/nicepkg/flow-a2a#readme",
+  "keywords": [
+    "flow-a2a",
+    "a2a",
+    "agent-to-agent",
+    "llm",
+    "cost-tracking",
+    "openclaw"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}