harness-dispatch 0.4.0

package/dist/billing.js

@@ -0,0 +1,201 @@
+function isLoopback(baseUrl) {
+    if (!baseUrl)
+        return false;
+    return (baseUrl.includes("localhost") ||
+        baseUrl.includes("127.0.0.1") ||
+        baseUrl.includes("::1"));
+}
+function isKnownLocalRuntime(baseUrl) {
+    if (!baseUrl)
+        return false;
+    return (baseUrl.includes("localhost:11434") ||
+        baseUrl.includes("127.0.0.1:11434") ||
+        baseUrl.includes("localhost:1234") ||
+        baseUrl.includes("127.0.0.1:1234"));
+}
+// NOTE: no harness-name special cases here. Built-in harnesses declare
+// provider/surface/auth_source/billing_kind in the shipped config.default.yaml,
+// and config.ts copies those onto every route built from them — by the time a
+// ServiceConfig reaches this file, its billing identity is declared data.
+// The fallbacks below are structural inference only (endpoint type, base_url
+// shape), for entries that declare nothing.
+function providerFromService(svc) {
+    if (svc.provider)
+        return svc.provider;
+    if (svc.type === "openai_compatible" && isKnownLocalRuntime(svc.baseUrl))
+        return "local";
+    if (svc.baseUrl?.includes("api.openai.com"))
+        return "openai";
+    return "custom";
+}
+function surfaceFromService(svc) {
+    if (svc.surface)
+        return svc.surface;
+    if (svc.type === "openai_compatible") {
+        if (svc.baseUrl?.includes("api.openai.com"))
+            return "openai_api";
+        if (isKnownLocalRuntime(svc.baseUrl))
+            return "local_endpoint";
+        return "openai_compatible";
+    }
+    return "custom";
+}
+function authSourceFromService(svc, surface) {
+    if (svc.authSource)
+        return svc.authSource;
+    if (svc.apiKey)
+        return "api_key";
+    if (surface === "local_endpoint")
+        return "local_network";
+    if (svc.type === "openai_compatible")
+        return "configured_endpoint";
+    if (surface === "claude_agent_sdk")
+        return "oauth_session";
+    if (surface === "codex_cli" ||
+        surface === "cursor_agent_cli" ||
+        surface === "antigravity_cli") {
+        return "product_login";
+    }
+    return "unknown";
+}
+function inferredKind(svc, surface, authSource, now) {
+    if (svc.billingKind)
+        return svc.billingKind;
+    if (authSource === "api_key")
+        return "metered_api";
+    switch (surface) {
+        case "claude_agent_sdk":
+        case "claude_code":
+            // Anthropic announced a separate Agent SDK credit pool for claude -p
+            // (2026-06-15) but PAUSED the change on launch day, before it took
+            // effect — as of 2026-07, programmatic and interactive Claude Code
+            // usage still draw from the same subscription pool. Reclassify to
+            // included_credit_then_optional_overage only if/when Anthropic
+            // actually ships the split (verify against
+            // https://support.claude.com/en/articles/15036540 first).
+            return "included_plan_usage";
+        case "codex_cli":
+        case "codex_sdk":
+            return "included_plan_then_flexible_credits";
+        case "cursor_agent_cli":
+            return "included_usage_then_on_demand";
+        case "antigravity_cli":
+            return "free_quota";
+        case "local_endpoint":
+            return "local_compute";
+        case "openai_api":
+        case "anthropic_api":
+        case "gemini_api":
+        case "vertex_ai":
+            return "metered_api";
+        case "openai_compatible":
+            return isLoopback(svc.baseUrl) ? "unknown" : "metered_api";
+        case "custom":
+            return "unknown";
+    }
+}
+function inferredConfidence(svc, surface, kind) {
+    if (svc.billingConfidence)
+        return svc.billingConfidence;
+    if (kind === "unknown")
+        return "unknown";
+    // An explicit billing_kind in the route's config IS documentation — the
+    // operator declared it. Without this, a custom/loopback route stays
+    // confidence-unknown (and therefore blocked by billingIsUnknown) even
+    // after the operator does exactly what the docs tell them to do.
+    if (svc.billingKind)
+        return "documented";
+    if (surface === "openai_compatible" && isLoopback(svc.baseUrl))
+        return "unknown";
+    if (surface === "custom")
+        return "unknown";
+    if (surface === "cursor_agent_cli" && svc.authSource === "api_key")
+        return "inferred";
+    return "documented";
+}
+/**
+ * Whether a route can incur a REAL charge with no further action from the
+ * user, by default — i.e. whether harness-dispatch should block it until
+ * explicitly allowed.
+ *
+ * "included_X_then_optional_Y" kinds (Codex flexible credits, Claude usage
+ * credits, Cursor on-demand) are NOT blocked by default: researched across
+ * Anthropic, OpenAI, and Cursor (2026-07), all three hard-stop at the
+ * included cap by default — continuing past it requires the user to have
+ * ALREADY completed a separate, deliberate opt-in on the PROVIDER's own
+ * side (enabling usage credits/flexible pricing/on-demand billing, usually
+ * with its own payment method and spend limit). harness-dispatch blocking
+ * these by default would just be re-gating something the provider already
+ * gates, and asking every user to prove a negative ("I haven't opted into
+ * my provider's overage") for a state that's off by default anyway.
+ *
+ * A user who HAS enabled provider-side overage can still restore the block
+ * by setting `paid_usage_possible: true` explicitly in that route's config
+ * — the override in buildRouteBilling() takes precedence over this
+ * function. Only kinds with no such provider-side backstop — metered_api
+ * (raw API keys bill from the first token, no included pool at all) and
+ * unknown (no data to reason about) — are blocked by default here.
+ */
+function inferredPaidUsagePossible(kind) {
+    switch (kind) {
+        case "local_compute":
+        case "included_plan_usage":
+        case "free_quota":
+        case "included_plan_then_flexible_credits":
+        case "included_credit_then_optional_overage":
+        case "included_usage_then_on_demand":
+            return false;
+        case "metered_api":
+        case "unknown":
+            return true;
+    }
+}
+function defaultNotes(svc, surface, kind, now) {
+    if (svc.billingNotes)
+        return svc.billingNotes;
+    if (surface === "claude_agent_sdk" || surface === "claude_code") {
+        // The genuinely useful operational fact for this route: dispatched jobs
+        // compete with the user's own interactive Claude Code sessions.
+        return ("claude -p draws from the same subscription usage pool as interactive " +
+            "Claude Code (Anthropic's announced 2026-06-15 Agent SDK credit split " +
+            "was paused before taking effect).");
+    }
+    if (surface === "openai_compatible" && isLoopback(svc.baseUrl) && kind === "unknown") {
+        return "Loopback endpoint is not assumed local unless configured as a known local runtime.";
+    }
+    return undefined;
+}
+export function buildRouteBilling(svc, opts = {}) {
+    const now = opts.now ?? new Date();
+    const provider = providerFromService(svc);
+    const surface = surfaceFromService(svc);
+    const authSource = authSourceFromService(svc, surface);
+    const kind = inferredKind(svc, surface, authSource, now);
+    const confidence = inferredConfidence(svc, surface, kind);
+    const paidUsagePossible = svc.paidUsagePossible ?? inferredPaidUsagePossible(kind);
+    const billing = {
+        provider,
+        surface,
+        authSource,
+        kind,
+        paidUsagePossible,
+        allowPaidUsage: svc.allowPaidUsage ?? false,
+        paidUsageRequiresOptIn: paidUsagePossible ? true : false,
+        confidence,
+    };
+    const notes = defaultNotes(svc, surface, kind, now);
+    if (notes !== undefined)
+        billing.notes = notes;
+    return billing;
+}
+export function billingIsUnknown(billing) {
+    return billing.kind === "unknown" || billing.confidence === "unknown";
+}
+export function billingIsBlocked(billing) {
+    if (billingIsUnknown(billing))
+        return !billing.allowPaidUsage;
+    if (billing.paidUsagePossible)
+        return !billing.allowPaidUsage;
+    return false;
+}
+//# sourceMappingURL=billing.js.map

package/dist/billing.js.map

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

package/dist/bin.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * harness-dispatch CLI entrypoint.
+ */
+export declare function main(argv: string[]): Promise<number>;
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;GAEG;AAkfH,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyF1D"}