agent-relay-sdk 0.1.0 → 0.2.1

package/dist/context-probe.js

@@ -0,0 +1,210 @@
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, dirname, join } from "node:path";
+import { spawnSync } from "node:child_process";
+export const DEFAULT_CONTEXT_PROBE_STATE_DIR = tmpdir();
+export const DEFAULT_CONTEXT_PROBE_PATTERNS = [
+    {
+        name: "percent",
+        regex: /(\d+(?:\.\d+)?)%\s*(?:context|ctx)?/i,
+        extract: (match) => ({ contextPercent: Number(match[1]) }),
+    },
+    {
+        name: "token-count",
+        regex: /(\d[\d,]*)\s*\/\s*(\d[\d,]*)\s*(?:tokens?|tok)/i,
+        extract: (match) => ({
+            tokensUsed: parseInt(String(match[1]).replace(/,/g, ""), 10),
+            tokensMax: parseInt(String(match[2]).replace(/,/g, ""), 10),
+        }),
+    },
+    {
+        name: "quota",
+        regex: /quota[:\s]+(\d+(?:\.\d+)?)\s*%/i,
+        extract: (match) => ({ quotaUsed: Number(match[1]) }),
+    },
+];
+export function contextProbeStatePath(agentId, stateDir = DEFAULT_CONTEXT_PROBE_STATE_DIR) {
+    return join(stateDir, `agent-relay-context-${safeStateId(agentId)}.json`);
+}
+export function parseContextProbeMetrics(input, options = {}) {
+    const timestamp = options.now ?? Date.now();
+    const fromJson = parseClaudeStatusLineInput(input, options.agentId, timestamp, options.env);
+    if (fromJson)
+        return fromJson;
+    const partial = {};
+    for (const pattern of options.parsePatterns ?? DEFAULT_CONTEXT_PROBE_PATTERNS) {
+        const match = input.match(pattern.regex);
+        if (match)
+            Object.assign(partial, pattern.extract(match));
+    }
+    if (partial.contextPercent === undefined && partial.tokensUsed !== undefined && partial.tokensMax) {
+        partial.contextPercent = (partial.tokensUsed / partial.tokensMax) * 100;
+    }
+    if (partial.contextPercent === undefined)
+        return null;
+    return normalizeMetrics({
+        agentId: options.agentId || envAgentId(options.env) || "unknown",
+        contextPercent: partial.contextPercent,
+        tokensUsed: partial.tokensUsed,
+        tokensMax: partial.tokensMax,
+        quotaUsed: partial.quotaUsed,
+        quotaLimit: partial.quotaLimit,
+        quotaResetIn: partial.quotaResetIn,
+        source: partial.source ?? "statusline",
+        confidence: partial.confidence ?? "estimated",
+        timestamp,
+    });
+}
+export function contextStateFromProbeMetrics(metrics) {
+    return {
+        utilization: Math.max(0, Math.min(1, metrics.contextPercent / 100)),
+        ...(metrics.tokensUsed !== undefined ? { tokensUsed: metrics.tokensUsed } : {}),
+        ...(metrics.tokensMax !== undefined ? { tokensMax: metrics.tokensMax } : {}),
+        lifecycleState: "working",
+        warmTopics: [],
+        activeMemories: [],
+        tasksSinceCompact: 0,
+        lastUpdatedAt: metrics.timestamp,
+        source: metrics.source,
+        confidence: metrics.confidence,
+    };
+}
+export function writeContextProbeState(metrics, stateDir = DEFAULT_CONTEXT_PROBE_STATE_DIR) {
+    const file = contextProbeStatePath(metrics.agentId, stateDir);
+    mkdirSync(dirname(file), { recursive: true });
+    const tmp = `${file}.${process.pid}.tmp`;
+    writeFileSync(tmp, JSON.stringify(metrics, null, 2));
+    renameSync(tmp, file);
+    return file;
+}
+export function readContextProbeState(agentId, stateDir = DEFAULT_CONTEXT_PROBE_STATE_DIR) {
+    try {
+        const parsed = JSON.parse(readFileSync(contextProbeStatePath(agentId, stateDir), "utf8"));
+        return isContextProbeMetrics(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function runContextProbe(input, options = {}) {
+    let wrappedExitCode;
+    let wrappedStdout = "";
+    let wrappedStderr = "";
+    if (options.wrapCommand) {
+        const result = spawnSync(options.wrapCommand, {
+            input,
+            shell: true,
+            encoding: "utf8",
+            env: { ...process.env, ...(options.env ?? {}) },
+        });
+        wrappedExitCode = typeof result.status === "number" ? result.status : result.error ? 1 : 0;
+        wrappedStdout = result.stdout ?? "";
+        wrappedStderr = result.stderr ?? "";
+    }
+    const metrics = parseContextProbeMetrics(input, options) ??
+        (wrappedStdout ? parseContextProbeMetrics(wrappedStdout, { ...options, now: options.now }) : null);
+    const stateFile = metrics ? writeContextProbeState(metrics, options.stateDir) : undefined;
+    const output = options.wrapCommand ? wrappedStdout : standaloneOutput(metrics);
+    return { metrics, stateFile, wrappedExitCode, wrappedStdout, wrappedStderr, output };
+}
+function parseClaudeStatusLineInput(input, explicitAgentId, timestamp, env) {
+    let data;
+    try {
+        data = JSON.parse(input);
+    }
+    catch {
+        return null;
+    }
+    if (!isRecord(data))
+        return null;
+    const context = isRecord(data.context_window) ? data.context_window : undefined;
+    if (!context)
+        return null;
+    const contextPercent = numberValue(context.used_percentage);
+    const tokensMax = numberValue(context.context_window_size);
+    const usage = isRecord(context.current_usage) ? context.current_usage : undefined;
+    const tokensUsed = sumNumbers(usage?.input_tokens, usage?.cache_creation_input_tokens, usage?.cache_read_input_tokens);
+    if (contextPercent === undefined && tokensUsed === undefined)
+        return null;
+    const rateLimits = isRecord(data.rate_limits) ? data.rate_limits : undefined;
+    const fiveHour = isRecord(rateLimits?.five_hour) ? rateLimits.five_hour : undefined;
+    const model = stringValue(data.model) ?? envString(env, "CLAUDE_MODEL");
+    const effort = isRecord(data.effort) ? stringValue(data.effort.level) : stringValue(data.effort);
+    const resolvedEffort = effort ?? envString(env, "CLAUDE_EFFORT") ?? envString(env, "CLAUDE_CODE_EFFORT_LEVEL");
+    return normalizeMetrics({
+        agentId: explicitAgentId || envAgentId(env) || stringValue(data.session_id) || "unknown",
+        contextPercent: contextPercent ?? ((tokensUsed ?? 0) / (tokensMax || 1)) * 100,
+        tokensUsed,
+        tokensMax,
+        quotaUsed: numberValue(fiveHour?.used_percentage),
+        quotaResetIn: secondsUntil(numberValue(fiveHour?.resets_at), timestamp),
+        ...(model ? { model } : {}),
+        ...(resolvedEffort ? { effort: resolvedEffort } : {}),
+        source: "statusline",
+        confidence: "exact",
+        timestamp,
+    });
+}
+function normalizeMetrics(metrics) {
+    return {
+        ...metrics,
+        contextPercent: Math.max(0, Math.min(100, metrics.contextPercent)),
+    };
+}
+function standaloneOutput(metrics) {
+    if (!metrics)
+        return "agent-relay context: unavailable";
+    const pct = Math.round(metrics.contextPercent);
+    const tokens = metrics.tokensUsed && metrics.tokensMax ? ` ${formatTokens(metrics.tokensUsed)}/${formatTokens(metrics.tokensMax)}` : "";
+    return `agent-relay context: ${pct}%${tokens}`;
+}
+function formatTokens(tokens) {
+    if (tokens >= 1_000_000)
+        return `${(tokens / 1_000_000).toFixed(1)}M`;
+    if (tokens >= 1_000)
+        return `${Math.round(tokens / 1_000)}K`;
+    return String(tokens);
+}
+function safeStateId(agentId) {
+    return basename(agentId).replace(/[^a-zA-Z0-9._-]/g, "-") || "unknown";
+}
+function envAgentId(env) {
+    if (env !== undefined)
+        return stringValue(env.AGENT_RELAY_AGENT_ID) ?? stringValue(env.AGENT_RELAY_ID);
+    return stringValue(process.env.AGENT_RELAY_AGENT_ID) ?? stringValue(process.env.AGENT_RELAY_ID);
+}
+function envString(env, key) {
+    if (env !== undefined)
+        return stringValue(env[key]);
+    return stringValue(process.env[key]);
+}
+function numberValue(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function stringValue(value) {
+    return typeof value === "string" && value ? value : undefined;
+}
+function sumNumbers(...values) {
+    let total = 0;
+    let seen = false;
+    for (const value of values) {
+        if (typeof value === "number" && Number.isFinite(value)) {
+            total += value;
+            seen = true;
+        }
+    }
+    return seen ? total : undefined;
+}
+function secondsUntil(epochSeconds, nowMs) {
+    return epochSeconds === undefined ? undefined : Math.max(0, Math.round(epochSeconds - nowMs / 1000));
+}
+function isContextProbeMetrics(value) {
+    return isRecord(value) &&
+        typeof value.agentId === "string" &&
+        typeof value.contextPercent === "number" &&
+        typeof value.timestamp === "number";
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=context-probe.js.map

package/dist/context-probe.js.map

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

package/dist/contracts.d.ts

@@ -0,0 +1,27 @@
+import type { ContractCompatibility, RuntimeContractName, RuntimeContracts } from "./types.js";
+export declare const CONTRACT_VERSIONS: {
+    readonly relayApi: 1;
+    readonly orchestratorProtocol: 3;
+    readonly runnerProtocol: 1;
+    readonly providerPluginProtocol: 1;
+};
+export declare const CONTRACT_REQUIREMENTS: {
+    readonly orchestratorProtocol: {
+        readonly min: 3;
+        readonly maxExclusive: 4;
+    };
+    readonly runnerProtocol: {
+        readonly min: 1;
+        readonly maxExclusive: 2;
+    };
+    readonly providerPluginProtocol: {
+        readonly min: 1;
+        readonly maxExclusive: 2;
+    };
+};
+export interface ContractRequirement {
+    min: number;
+    maxExclusive: number;
+}
+export declare function contractCompatibility(contracts: RuntimeContracts, requirements: Partial<Record<RuntimeContractName, ContractRequirement>>): ContractCompatibility;
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAA8B,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE3H,eAAO,MAAM,iBAAiB;;;;;CAK0B,CAAC;AAEzD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;CAIxB,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,gBAAgB,EAC3B,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,GACtE,qBAAqB,CAuBvB"}

package/dist/contracts.js

@@ -0,0 +1,34 @@
+export const CONTRACT_VERSIONS = {
+    relayApi: 1,
+    orchestratorProtocol: 3,
+    runnerProtocol: 1,
+    providerPluginProtocol: 1,
+};
+export const CONTRACT_REQUIREMENTS = {
+    orchestratorProtocol: { min: 3, maxExclusive: 4 },
+    runnerProtocol: { min: 1, maxExclusive: 2 },
+    providerPluginProtocol: { min: 1, maxExclusive: 2 },
+};
+export function contractCompatibility(contracts, requirements) {
+    const issues = [];
+    let unknown = false;
+    for (const [contract, requirement] of Object.entries(requirements)) {
+        const actual = contracts[contract];
+        const expected = `>=${requirement.min} <${requirement.maxExclusive}`;
+        if (!Number.isFinite(actual)) {
+            unknown = true;
+            issues.push({ contract, expected });
+            continue;
+        }
+        if (actual < requirement.min || actual >= requirement.maxExclusive) {
+            issues.push({ contract, expected, actual });
+        }
+    }
+    const incompatible = issues.some((issue) => issue.actual !== undefined);
+    return {
+        status: incompatible ? "incompatible" : unknown ? "unknown" : "compatible",
+        compatible: !incompatible && !unknown,
+        issues,
+    };
+}
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,CAAC;IACX,oBAAoB,EAAE,CAAC;IACvB,cAAc,EAAE,CAAC;IACjB,sBAAsB,EAAE,CAAC;CAC6B,CAAC;AAEzD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,oBAAoB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE;IACjD,cAAc,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE;IAC3C,sBAAsB,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE;CAC3C,CAAC;AAOX,MAAM,UAAU,qBAAqB,CACnC,SAA2B,EAC3B,YAAuE;IAEvE,MAAM,MAAM,GAAiC,EAAE,CAAC;IAChD,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,CAAsD,EAAE,CAAC;QACxH,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,KAAK,WAAW,CAAC,GAAG,KAAK,WAAW,CAAC,YAAY,EAAE,CAAC;QACrE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QACD,IAAI,MAAO,GAAG,WAAW,CAAC,GAAG,IAAI,MAAO,IAAI,WAAW,CAAC,YAAY,EAAE,CAAC;YACrE,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;IACxE,OAAO;QACL,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY;QAC1E,UAAU,EAAE,CAAC,YAAY,IAAI,CAAC,OAAO;QACrC,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/http-client.d.ts

@@ -1,4 +1,4 @@
-import type { AgentCard, PollQuery, RegisterAgentInput, SendMessageInput, Message } from "./types.js";
+import type { AgentCard, Artifact, ArtifactKind, ArtifactSensitivity, PollQuery, RegisterAgentInput, SendMessageInput, Message, MessageDeliveryState, MessageDeliveryStatus, ReplyObligation, Task, TaskStatusInput } from "./types.js";
 export interface HttpClientOptions {
     baseUrl: string;
     token?: string;
@@ -14,34 +14,95 @@ export declare class RelayHttpError extends Error {
 }
 export declare class RelayHttpClient {
     private readonly baseUrl;
-    private readonly token?;
+    private token?;
     private readonly timeout;
     constructor(options: HttpClientOptions);
+    setToken(token?: string): void;
     registerAgent(input: RegisterAgentInput): Promise<AgentCard>;
     getAgent(id: string): Promise<AgentCard | null>;
+    listReplyObligations(agentId: string): Promise<ReplyObligation[]>;
     listAgents(filter?: {
         tag?: string;
         machine?: string;
         status?: string;
     }): Promise<AgentCard[]>;
-    heartbeat(agentId: string): Promise<void>;
-    setStatus(agentId: string, status: string): Promise<void>;
-    setReady(agentId: string, ready: boolean): Promise<void>;
+    heartbeat(agentId: string, instanceId?: string): Promise<void>;
+    setStatus(agentId: string, status: string, instanceId?: string): Promise<void>;
+    setReady(agentId: string, ready: boolean, instanceId?: string): Promise<void>;
     setLabel(agentId: string, label: string | null): Promise<void>;
     deleteAgent(agentId: string): Promise<void>;
     sendMessage(input: SendMessageInput): Promise<Message>;
     pollMessages(query: PollQuery): Promise<Message[]>;
     getMessage(id: number): Promise<Message | null>;
     getThread(messageId: number): Promise<Message[]>;
+    getMessageDelivery(messageId: number): Promise<MessageDeliveryState>;
+    recordMessageDeliveryAttempt(messageId: number, input: {
+        agentId?: string;
+        status: MessageDeliveryStatus;
+        error?: string;
+        nextRetryAt?: number;
+        poisonReason?: string;
+    }): Promise<MessageDeliveryState>;
+    updateMessageDelivery(messageId: number, input: {
+        action: "retry-now" | "mark-dead" | "clear";
+        reason?: string;
+        agentId?: string;
+    }): Promise<MessageDeliveryState>;
     claimMessage(messageId: number, agentId: string): Promise<boolean>;
+    claimMessageResult(messageId: number, agentId: string): Promise<{
+        ok: boolean;
+        claimExpiresAt?: number;
+        task?: Task;
+    }>;
+    renewMessageClaim(messageId: number, agentId: string): Promise<{
+        ok: boolean;
+        claimExpiresAt?: number;
+    }>;
+    updateTaskStatus(taskId: number, input: TaskStatusInput): Promise<Task>;
     markRead(messageId: number, agentId: string): Promise<void>;
     deleteMessage(messageId: number): Promise<void>;
     getCursor(): Promise<{
         latestId: number;
     }>;
+    uploadArtifact(file: Blob | Buffer | ReadableStream, opts?: {
+        filename?: string;
+        mediaType?: string;
+        digest?: string;
+        kind?: ArtifactKind;
+        sensitivity?: ArtifactSensitivity;
+        metadata?: Record<string, unknown>;
+        expiresAt?: number;
+    }): Promise<Artifact>;
+    downloadArtifact(id: string): Promise<{
+        stream: ReadableStream<Uint8Array>;
+        meta: Artifact;
+    }>;
+    getArtifact(id: string): Promise<Artifact>;
+    artifactExists(id: string): Promise<boolean>;
+    deleteArtifact(id: string): Promise<void>;
+    listArtifacts(query?: {
+        messageId?: number;
+        taskId?: number;
+        createdBy?: string;
+        limit?: number;
+    }): Promise<Artifact[]>;
+    renewRuntimeToken(): Promise<{
+        token: string;
+        record: {
+            jti: string;
+            profileId?: string;
+            expiresAt?: number;
+        };
+        previous: {
+            jti: string;
+            expiresAt?: number;
+        };
+    }>;
     private json;
     private jsonUrl;
     private request;
+    private requestRaw;
+    private parseResponseForOk;
     private parseResponse;
     private headers;
     private url;

package/dist/http-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEtG,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,cAAe,SAAQ,KAAK;IAErC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAJZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM;CAIxB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,iBAAiB;IAMtC,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAItD,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAMrD,UAAU,CAAC,MAAM,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAQ5F,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAW5C,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAOrD,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAI1C,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASlE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,SAAS,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAI1C,OAAO,CAAC,IAAI;YAIE,OAAO;YAKP,OAAO;YAeP,aAAa;IAS3B,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,GAAG;CAGZ"}
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../src/http-client.ts"],"names":[],"mappings":"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"}

package/dist/http-client.js

@@ -22,6 +22,9 @@ export class RelayHttpClient {
         this.token = options.token;
         this.timeout = options.timeout ?? 10_000;
     }
+    setToken(token) {
+        this.token = token;
+    }
     registerAgent(input) {
         return this.json("POST", "/api/agents", input);
     }
@@ -31,6 +34,9 @@ export class RelayHttpClient {
             return null;
         return this.parseResponse(response, "GET", `/api/agents/${id}`);
     }
+    listReplyObligations(agentId) {
+        return this.json("GET", `/api/agents/${encodeURIComponent(agentId)}/reply-obligations`);
+    }
     listAgents(filter = {}) {
         const url = this.url("/api/agents");
         for (const [key, value] of Object.entries(filter)) {
@@ -39,14 +45,14 @@ export class RelayHttpClient {
         }
         return this.jsonUrl("GET", url);
     }
-    async heartbeat(agentId) {
-        await this.json("POST", `/api/agents/${encodeURIComponent(agentId)}/heartbeat`);
+    async heartbeat(agentId, instanceId) {
+        await this.json("POST", `/api/agents/${encodeURIComponent(agentId)}/heartbeat`, instanceId ? { instanceId } : undefined);
     }
-    async setStatus(agentId, status) {
-        await this.json("PATCH", `/api/agents/${encodeURIComponent(agentId)}/status`, { status });
+    async setStatus(agentId, status, instanceId) {
+        await this.json("PATCH", `/api/agents/${encodeURIComponent(agentId)}/status`, { status, ...(instanceId ? { instanceId } : {}) });
     }
-    async setReady(agentId, ready) {
-        await this.json("PATCH", `/api/agents/${encodeURIComponent(agentId)}/ready`, { ready });
+    async setReady(agentId, ready, instanceId) {
+        await this.json("PATCH", `/api/agents/${encodeURIComponent(agentId)}/ready`, { ready, ...(instanceId ? { instanceId } : {}) });
     }
     async setLabel(agentId, label) {
         await this.json("PATCH", `/api/agents/${encodeURIComponent(agentId)}/label`, { label });
@@ -82,15 +88,43 @@ export class RelayHttpClient {
     getThread(messageId) {
         return this.json("GET", `/api/messages/${messageId}/thread`);
     }
+    getMessageDelivery(messageId) {
+        return this.json("GET", `/api/messages/${messageId}/delivery`);
+    }
+    recordMessageDeliveryAttempt(messageId, input) {
+        return this.json("POST", `/api/messages/${messageId}/delivery/attempts`, input);
+    }
+    updateMessageDelivery(messageId, input) {
+        return this.json("POST", `/api/messages/${messageId}/delivery/actions`, input);
+    }
     async claimMessage(messageId, agentId) {
+        return (await this.claimMessageResult(messageId, agentId)).ok;
+    }
+    async claimMessageResult(messageId, agentId) {
         const path = `/api/messages/${messageId}/claim`;
         const response = await this.request("POST", path, { agentId });
         if (response.ok)
-            return true;
+            return this.parseResponse(response, "POST", path);
         if ([400, 404, 409].includes(response.status))
-            return false;
+            return { ok: false };
+        await this.parseResponse(response, "POST", path);
+        return { ok: false };
+    }
+    async renewMessageClaim(messageId, agentId) {
+        const path = `/api/messages/${messageId}/claim/renew`;
+        const response = await this.request("POST", path, { agentId });
+        if (response.ok)
+            return this.parseResponse(response, "POST", path);
+        if ([400, 404, 409].includes(response.status))
+            return { ok: false };
         await this.parseResponse(response, "POST", path);
-        return false;
+        return { ok: false };
+    }
+    async updateTaskStatus(taskId, input) {
+        const payload = await this.json("PATCH", `/api/tasks/${taskId}/status`, input);
+        if (!payload.task)
+            throw new Error(`task status update failed: missing task ${taskId}`);
+        return payload.task;
     }
     async markRead(messageId, agentId) {
         await this.json("PATCH", `/api/messages/${messageId}`, { readBy: agentId });
@@ -101,6 +135,90 @@ export class RelayHttpClient {
     getCursor() {
         return this.json("GET", "/api/messages/cursor");
     }
+    async uploadArtifact(file, opts = {}) {
+        if (opts.metadata && !(file instanceof ReadableStream)) {
+            const form = new FormData();
+            if (file instanceof Blob) {
+                form.append("file", file, opts.filename);
+            }
+            else {
+                const arrayBuffer = file.buffer.slice(file.byteOffset, file.byteOffset + file.byteLength);
+                form.append("file", new Blob([arrayBuffer], { type: opts.mediaType }), opts.filename);
+            }
+            if (opts.filename)
+                form.append("filename", opts.filename);
+            if (opts.digest)
+                form.append("digest", opts.digest);
+            if (opts.kind)
+                form.append("kind", opts.kind);
+            if (opts.sensitivity)
+                form.append("sensitivity", opts.sensitivity);
+            if (opts.expiresAt)
+                form.append("expiresAt", String(opts.expiresAt));
+            form.append("metadata", JSON.stringify(opts.metadata));
+            const response = await this.requestRaw("POST", "/api/artifacts", form);
+            return this.parseResponse(response, "POST", "/api/artifacts");
+        }
+        const headers = {};
+        if (opts.mediaType)
+            headers["Content-Type"] = opts.mediaType;
+        if (opts.filename)
+            headers["X-Artifact-Filename"] = opts.filename;
+        if (opts.digest)
+            headers["X-Artifact-Digest"] = opts.digest;
+        if (opts.kind)
+            headers["X-Artifact-Kind"] = opts.kind;
+        if (opts.sensitivity)
+            headers["X-Artifact-Sensitivity"] = opts.sensitivity;
+        if (opts.expiresAt)
+            headers["X-Artifact-Expires-At"] = String(opts.expiresAt);
+        let body;
+        if (file instanceof Blob)
+            body = file;
+        else if (file instanceof ReadableStream)
+            body = file;
+        else
+            body = file;
+        const response = await this.requestRaw("POST", "/api/artifacts", body, headers);
+        return this.parseResponse(response, "POST", "/api/artifacts");
+    }
+    async downloadArtifact(id) {
+        const meta = await this.getArtifact(id);
+        const path = `/api/artifacts/${encodeURIComponent(id)}/content`;
+        const response = await this.requestRaw("GET", path);
+        await this.parseResponseForOk(response, "GET", path);
+        if (!response.body)
+            throw new RelayHttpError("GET", path, response.status, response.statusText, "missing response body");
+        return { stream: response.body, meta };
+    }
+    async getArtifact(id) {
+        return this.json("GET", `/api/artifacts/${encodeURIComponent(id)}`);
+    }
+    async artifactExists(id) {
+        const response = await this.requestRaw("HEAD", `/api/artifacts/${encodeURIComponent(id)}/content`);
+        if (response.status === 404)
+            return false;
+        await this.parseResponseForOk(response, "HEAD", `/api/artifacts/${id}/content`);
+        return true;
+    }
+    async deleteArtifact(id) {
+        await this.json("DELETE", `/api/artifacts/${encodeURIComponent(id)}`);
+    }
+    listArtifacts(query = {}) {
+        const url = this.url("/api/artifacts");
+        if (query.messageId !== undefined)
+            url.searchParams.set("messageId", String(query.messageId));
+        if (query.taskId !== undefined)
+            url.searchParams.set("taskId", String(query.taskId));
+        if (query.createdBy)
+            url.searchParams.set("createdBy", query.createdBy);
+        if (query.limit !== undefined)
+            url.searchParams.set("limit", String(query.limit));
+        return this.jsonUrl("GET", url);
+    }
+    renewRuntimeToken() {
+        return this.json("POST", "/api/runtime-tokens/renew");
+    }
     json(method, path, body) {
         return this.jsonUrl(method, this.url(path), body);
     }
@@ -123,6 +241,27 @@ export class RelayHttpClient {
             clearTimeout(timeout);
         }
     }
+    async requestRaw(method, pathOrUrl, body, headers = {}) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            return await fetch(pathOrUrl instanceof URL ? pathOrUrl : this.url(pathOrUrl), {
+                method,
+                headers: this.headers(headers),
+                body,
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    async parseResponseForOk(response, method, path) {
+        if (!response.ok) {
+            const text = await response.text();
+            throw new RelayHttpError(method, path, response.status, response.statusText, text);
+        }
+    }
     async parseResponse(response, method, path) {
         if (!response.ok) {
             const text = await response.text();