@sentropic/h2a-runtime 0.81.0

package/dist/account-pool.d.ts

@@ -0,0 +1,168 @@
+/**
+ * WP16 Layer-C — local LLM account pool.
+ *
+ * Descriptor store: ~/.sentropic/accounts.json (0600) — id, provider, label, enrolledAt.
+ * Token store:      ~/.sentropic/accounts-tokens.json (0600) — secrets only, separate file.
+ *
+ * Invariants:
+ *  - No tokens ever appear in descriptors, stdout, logs, or track.
+ *  - Both files are 0600 (owner-only). mkdirSync enforces ~/.sentropic/ exists.
+ *  - selectAccount() is pure: no I/O, just candidates + policy → one descriptor.
+ */
+export type AccountProvider = "claude-code" | "codex";
+export type AccountDescriptor = {
+    readonly id: string;
+    readonly provider: AccountProvider;
+    readonly label: string;
+    readonly enrolledAt: string;
+    /** For claude-code accounts: the config dir holding credentials (maps to CLAUDE_CONFIG_DIR). Absent = default ~/.claude. */
+    readonly configDir?: string;
+};
+export type AccountCandidate = AccountDescriptor & {
+    readonly accessToken: string;
+};
+export declare function sentropicDir(): string;
+export declare function accountsDescriptorPath(dir?: string): string;
+export declare function accountsTokensPath(dir?: string): string;
+export declare function loadDescriptors(dir?: string): AccountDescriptor[];
+export type EnrollOpts = {
+    provider: AccountProvider;
+    label: string;
+    accessToken: string;
+    id?: string;
+    dir?: string;
+    /** For claude-code: path to the CLI config dir holding credentials (stored as CLAUDE_CONFIG_DIR override). */
+    configDir?: string;
+};
+export type EnrollResult = {
+    ok: true;
+    descriptor: AccountDescriptor;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function enrollAccount(opts: EnrollOpts): EnrollResult;
+export declare function listAccounts(dir?: string): AccountDescriptor[];
+/** Returns every enrolled account paired with its access token.
+ * Accounts with no token stored (corrupted enroll) are silently skipped.
+ * Intended for push-cluster only — keep the result out of logs. */
+export declare function listAccountsWithTokens(dir?: string): Array<AccountDescriptor & {
+    accessToken: string;
+}>;
+export type RemoveResult = {
+    ok: true;
+    id: string;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function removeAccount(id: string, dir?: string): RemoveResult;
+export declare function loadCandidates(provider?: AccountProvider, dir?: string): AccountCandidate[];
+export type SelectPolicy = "round-robin";
+export declare function selectAccount(candidates: ReadonlyArray<AccountDescriptor>, lastUsedId?: string, _policy?: SelectPolicy): AccountDescriptor | undefined;
+export type SessionBinding = {
+    readonly affinityKey: string;
+    readonly accountId: string;
+    readonly provider: AccountProvider;
+    readonly boundAt: string;
+};
+export declare function bindingsPath(dir?: string): string;
+/** Write (or overwrite) a sticky binding for an affinityKey. */
+export declare function stickyBind(affinityKey: string, accountId: string, provider: AccountProvider, dir?: string): SessionBinding;
+/** Return the binding for affinityKey, or undefined if not yet bound. */
+export declare function lookupBinding(affinityKey: string, dir?: string): SessionBinding | undefined;
+/** Return all current sticky bindings (for `remote account bindings`). */
+export declare function listBindings(dir?: string): SessionBinding[];
+/** Remove a binding (explicit rebind path — not silent). */
+export declare function clearBinding(affinityKey: string, dir?: string): void;
+/** Duration presets for quota windows. */
+export declare const QUOTA_WINDOW_5H_MS: number;
+export declare const QUOTA_WINDOW_WEEK_MS: number;
+export type QuotaRecord = {
+    readonly accountId: string;
+    /** ISO-8601 timestamp when exhaustion was declared. */
+    readonly exhaustedAt: string;
+    /** Window duration in ms. Account is available again after exhaustedAt + windowMs. */
+    readonly windowMs: number;
+    /** Optional human-readable reason (e.g. "429 rate-limit", "weekly cap"). */
+    readonly reason?: string;
+};
+export declare function quotaPath(dir?: string): string;
+/** Mark an account as exhausted for `windowMs` milliseconds. */
+export declare function markExhausted(accountId: string, windowMs?: number, reason?: string, dir?: string): QuotaRecord;
+/** Clear exhaustion for an account (manual override or after confirmed refresh). */
+export declare function clearExhaustion(accountId: string, dir?: string): void;
+/** Prune expired quota records (window elapsed). Returns count removed. */
+export declare function pruneExpiredQuota(nowMs?: number, dir?: string): number;
+/** True if the account is currently within its exhaustion window. */
+export declare function isExhausted(accountId: string, quotaMap: Readonly<Record<string, QuotaRecord>>, nowMs?: number): boolean;
+/** Enriched view of an account descriptor (for `remote account ls`). */
+export type AccountStatus = AccountDescriptor & {
+    exhausted: boolean;
+    quotaResetsAt?: string;
+    /** Reason provided when exhaustion was recorded (e.g. "claude:rate-limited"). */
+    exhaustionReason?: string;
+};
+/** List all accounts with their current quota/exhaustion status. */
+export declare function listAccountsWithStatus(dir?: string): AccountStatus[];
+export type SelectWithFallbackResult = {
+    candidate: AccountCandidate;
+    crossProvider: false;
+} | {
+    candidate: AccountCandidate;
+    crossProvider: true;
+    originalProvider: AccountProvider;
+} | {
+    candidate: undefined;
+    allExhausted: true;
+};
+export declare function selectAccountWithFallback(preferredProvider: AccountProvider, affinityKey?: string, dir?: string, nowMs?: number): SelectWithFallbackResult;
+export type ReadCredentialResult = {
+    ok: true;
+    accessToken: string;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Read the Claude Code access token from ~/.claude/.credentials.json
+ * (or a custom configDir). Returns the claudeAiOauth.accessToken value.
+ */
+export declare function readClaudeCredential(configDir?: string): ReadCredentialResult;
+/**
+ * Read the Codex / OpenAI API key from ~/.codex/auth.json
+ * (or a custom configDir). Returns the OPENAI_API_KEY value.
+ */
+export declare function readCodexCredential(configDir?: string): ReadCredentialResult;
+export declare const LLM_GATEWAY_URL = "https://llm.sent-tech.ca";
+/**
+ * Returns the env vars to inject into a session so it routes through the
+ * llm-gateway. Requires a valid sentropic S2S DPoP token for pod auth
+ * (injected separately by the control-plane auth flow, not here).
+ */
+export declare function llmGatewayEnv(): {
+    ANTHROPIC_BASE_URL: string;
+};
+export type SessionLogEntry = {
+    at: string;
+    /** "launch" = account selected at job start; "exhaust" = account auto-exhausted (throttle). Absent = "launch" (back-compat). */
+    kind?: "launch" | "exhaust";
+    jobId: string;
+    preferredProvider: AccountProvider;
+    selectedProvider: AccountProvider;
+    accountId: string;
+    accountLabel: string;
+    crossProvider: boolean;
+    /** Throttle signature tag that triggered auto-exhaustion (kind="exhaust" only). */
+    signature?: string;
+};
+export declare function sessionLogPath(dir?: string): string;
+export declare function appendSessionLogEntry(entry: Omit<SessionLogEntry, "at">, dir?: string): void;
+/**
+ * Export the local session log to an S3 URI.
+ *
+ * Reads endpoint from AWS_ENDPOINT_URL (SCW: https://s3.fr-par.scw.cloud).
+ * Credentials from AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY (standard AWS env).
+ */
+export declare function exportSessionLogToS3(s3Uri: string, dir?: string): Promise<void>;
+//# sourceMappingURL=account-pool.d.ts.map

package/dist/account-pool.d.ts.map

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

package/dist/account-pool.js

@@ -0,0 +1,385 @@
+/**
+ * WP16 Layer-C — local LLM account pool.
+ *
+ * Descriptor store: ~/.sentropic/accounts.json (0600) — id, provider, label, enrolledAt.
+ * Token store:      ~/.sentropic/accounts-tokens.json (0600) — secrets only, separate file.
+ *
+ * Invariants:
+ *  - No tokens ever appear in descriptors, stdout, logs, or track.
+ *  - Both files are 0600 (owner-only). mkdirSync enforces ~/.sentropic/ exists.
+ *  - selectAccount() is pure: no I/O, just candidates + policy → one descriptor.
+ */
+import { appendFileSync, chmodSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+export function sentropicDir() {
+    return join(homedir(), ".sentropic");
+}
+export function accountsDescriptorPath(dir = sentropicDir()) {
+    return join(dir, "accounts.json");
+}
+export function accountsTokensPath(dir = sentropicDir()) {
+    return join(dir, "accounts-tokens.json");
+}
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function writeSecret(path, value) {
+    mkdirSync(dirname(path), { recursive: true });
+    const tmp = `${path}.tmp.${process.pid}`;
+    writeFileSync(tmp, JSON.stringify(value, null, 2) + "\n", { mode: 0o600 });
+    chmodSync(tmp, 0o600);
+    renameSync(tmp, path);
+}
+// ---------------------------------------------------------------------------
+// Descriptor store (no tokens)
+// ---------------------------------------------------------------------------
+export function loadDescriptors(dir) {
+    return readJson(accountsDescriptorPath(dir)) ?? [];
+}
+function saveDescriptors(descs, dir) {
+    writeSecret(accountsDescriptorPath(dir), descs);
+}
+// ---------------------------------------------------------------------------
+// Token store (secrets only — never mixed with descriptors)
+// ---------------------------------------------------------------------------
+function loadTokenMap(dir) {
+    return readJson(accountsTokensPath(dir)) ?? {};
+}
+function saveTokenMap(map, dir) {
+    writeSecret(accountsTokensPath(dir), map);
+}
+export function enrollAccount(opts) {
+    if (!opts.accessToken.trim()) {
+        return { ok: false, error: "access token is empty" };
+    }
+    const descs = loadDescriptors(opts.dir);
+    const id = opts.id ?? `${opts.provider}-${Math.floor(Date.now() / 1000)}`;
+    if (descs.some((d) => d.id === id)) {
+        return {
+            ok: false,
+            error: `account "${id}" already enrolled; use --id to specify a unique id`,
+        };
+    }
+    const descriptor = {
+        id,
+        provider: opts.provider,
+        label: opts.label,
+        enrolledAt: new Date().toISOString(),
+        ...(opts.configDir !== undefined ? { configDir: opts.configDir } : {}),
+    };
+    saveDescriptors([...descs, descriptor], opts.dir);
+    const tokens = loadTokenMap(opts.dir);
+    tokens[id] = opts.accessToken;
+    saveTokenMap(tokens, opts.dir);
+    return { ok: true, descriptor };
+}
+// ---------------------------------------------------------------------------
+// List
+// ---------------------------------------------------------------------------
+export function listAccounts(dir) {
+    return loadDescriptors(dir);
+}
+/** Returns every enrolled account paired with its access token.
+ * Accounts with no token stored (corrupted enroll) are silently skipped.
+ * Intended for push-cluster only — keep the result out of logs. */
+export function listAccountsWithTokens(dir) {
+    const descs = loadDescriptors(dir);
+    const tokens = loadTokenMap(dir);
+    return descs.flatMap((d) => {
+        const accessToken = tokens[d.id];
+        return accessToken ? [{ ...d, accessToken }] : [];
+    });
+}
+export function removeAccount(id, dir) {
+    const descs = loadDescriptors(dir);
+    if (!descs.some((d) => d.id === id)) {
+        return { ok: false, error: `account "${id}" not found` };
+    }
+    saveDescriptors(descs.filter((d) => d.id !== id), dir);
+    const tokens = loadTokenMap(dir);
+    delete tokens[id];
+    saveTokenMap(tokens, dir);
+    return { ok: true, id };
+}
+// ---------------------------------------------------------------------------
+// Load candidates (descriptor + token) — internal, never surfaced to user
+// ---------------------------------------------------------------------------
+export function loadCandidates(provider, dir) {
+    const descs = loadDescriptors(dir);
+    const tokens = loadTokenMap(dir);
+    return descs
+        .filter((d) => !provider || d.provider === provider)
+        .flatMap((d) => {
+        const accessToken = tokens[d.id];
+        if (!accessToken)
+            return [];
+        return [{ ...d, accessToken }];
+    });
+}
+export function selectAccount(candidates, lastUsedId, _policy = "round-robin") {
+    if (candidates.length === 0)
+        return undefined;
+    if (!lastUsedId)
+        return candidates[0];
+    const idx = candidates.findIndex((c) => c.id === lastUsedId);
+    if (idx === -1)
+        return candidates[0];
+    return candidates[(idx + 1) % candidates.length];
+}
+export function bindingsPath(dir = sentropicDir()) {
+    return join(dir, "session-bindings.json");
+}
+function loadBindings(dir) {
+    return (readJson(bindingsPath(dir)) ?? {});
+}
+function saveBindings(bindings, dir) {
+    writeSecret(bindingsPath(dir), bindings);
+}
+/** Write (or overwrite) a sticky binding for an affinityKey. */
+export function stickyBind(affinityKey, accountId, provider, dir) {
+    const bindings = loadBindings(dir);
+    const binding = {
+        affinityKey,
+        accountId,
+        provider,
+        boundAt: new Date().toISOString(),
+    };
+    bindings[affinityKey] = binding;
+    saveBindings(bindings, dir);
+    return binding;
+}
+/** Return the binding for affinityKey, or undefined if not yet bound. */
+export function lookupBinding(affinityKey, dir) {
+    return loadBindings(dir)[affinityKey];
+}
+/** Return all current sticky bindings (for `remote account bindings`). */
+export function listBindings(dir) {
+    return Object.values(loadBindings(dir));
+}
+/** Remove a binding (explicit rebind path — not silent). */
+export function clearBinding(affinityKey, dir) {
+    const bindings = loadBindings(dir);
+    delete bindings[affinityKey];
+    saveBindings(bindings, dir);
+}
+// ---------------------------------------------------------------------------
+// Quota tracking — exhaustion windows per account
+//
+// When a CLI session hits a rate-limit / capacity error (429, "too many
+// requests", "Claude.ai capacity"), the caller marks the account exhausted
+// for a window duration (5h default for Claude Code short-window, 7d for
+// weekly). selectAccountWithFallback() skips exhausted accounts and
+// falls back across providers when all same-provider accounts are saturated.
+// ---------------------------------------------------------------------------
+/** Duration presets for quota windows. */
+export const QUOTA_WINDOW_5H_MS = 5 * 60 * 60 * 1_000;
+export const QUOTA_WINDOW_WEEK_MS = 7 * 24 * 60 * 60 * 1_000;
+export function quotaPath(dir = sentropicDir()) {
+    return join(dir, "account-quota.json");
+}
+function loadQuotaMap(dir) {
+    return readJson(quotaPath(dir)) ?? {};
+}
+function saveQuotaMap(map, dir) {
+    writeSecret(quotaPath(dir), map);
+}
+/** Mark an account as exhausted for `windowMs` milliseconds. */
+export function markExhausted(accountId, windowMs = QUOTA_WINDOW_5H_MS, reason, dir) {
+    const map = loadQuotaMap(dir);
+    const record = {
+        accountId,
+        exhaustedAt: new Date().toISOString(),
+        windowMs,
+        ...(reason !== undefined ? { reason } : {}),
+    };
+    map[accountId] = record;
+    saveQuotaMap(map, dir);
+    return record;
+}
+/** Clear exhaustion for an account (manual override or after confirmed refresh). */
+export function clearExhaustion(accountId, dir) {
+    const map = loadQuotaMap(dir);
+    delete map[accountId];
+    saveQuotaMap(map, dir);
+}
+/** Prune expired quota records (window elapsed). Returns count removed. */
+export function pruneExpiredQuota(nowMs = Date.now(), dir) {
+    const map = loadQuotaMap(dir);
+    let removed = 0;
+    for (const [id, rec] of Object.entries(map)) {
+        if (nowMs >= new Date(rec.exhaustedAt).getTime() + rec.windowMs) {
+            delete map[id];
+            removed++;
+        }
+    }
+    if (removed > 0)
+        saveQuotaMap(map, dir);
+    return removed;
+}
+/** True if the account is currently within its exhaustion window. */
+export function isExhausted(accountId, quotaMap, nowMs = Date.now()) {
+    const rec = quotaMap[accountId];
+    if (!rec)
+        return false;
+    return nowMs < new Date(rec.exhaustedAt).getTime() + rec.windowMs;
+}
+/** List all accounts with their current quota/exhaustion status. */
+export function listAccountsWithStatus(dir) {
+    const descs = loadDescriptors(dir);
+    const quota = loadQuotaMap(dir);
+    const now = Date.now();
+    return descs.map((d) => {
+        const rec = quota[d.id];
+        if (!rec)
+            return { ...d, exhausted: false };
+        const resetMs = new Date(rec.exhaustedAt).getTime() + rec.windowMs;
+        if (now >= resetMs)
+            return { ...d, exhausted: false };
+        return {
+            ...d,
+            exhausted: true,
+            quotaResetsAt: new Date(resetMs).toISOString(),
+            ...(rec.reason !== undefined ? { exhaustionReason: rec.reason } : {}),
+        };
+    });
+}
+// ---------------------------------------------------------------------------
+// selectAccountWithFallback — quota-aware, cross-provider fallback
+//
+// Policy (priority order):
+//  1. Sticky binding if it exists AND the bound account is not exhausted.
+//  2. Round-robin from the preferred provider, skipping exhausted accounts.
+//  3. Cross-provider fallback: if ALL preferred-provider accounts are
+//     exhausted, try the other provider (claude-code ↔ codex).
+//  4. undefined if no usable account exists.
+// ---------------------------------------------------------------------------
+const FALLBACK_PROVIDER = {
+    "claude-code": "codex",
+    codex: "claude-code",
+};
+export function selectAccountWithFallback(preferredProvider, affinityKey, dir, nowMs = Date.now()) {
+    pruneExpiredQuota(nowMs, dir);
+    const quota = loadQuotaMap(dir);
+    // 1. Honour sticky binding if the bound account is still usable.
+    if (affinityKey) {
+        const binding = lookupBinding(affinityKey, dir);
+        if (binding && binding.provider === preferredProvider) {
+            if (!isExhausted(binding.accountId, quota, nowMs)) {
+                const candidates = loadCandidates(preferredProvider, dir);
+                const match = candidates.find((c) => c.id === binding.accountId);
+                if (match)
+                    return { candidate: match, crossProvider: false };
+            }
+        }
+    }
+    // 2. Round-robin from preferred provider, skip exhausted.
+    const preferred = loadCandidates(preferredProvider, dir).filter((c) => !isExhausted(c.id, quota, nowMs));
+    if (preferred.length > 0) {
+        return { candidate: preferred[0], crossProvider: false };
+    }
+    // 3. Cross-provider fallback.
+    const fallbackProvider = FALLBACK_PROVIDER[preferredProvider];
+    const fallback = loadCandidates(fallbackProvider, dir).filter((c) => !isExhausted(c.id, quota, nowMs));
+    if (fallback.length > 0) {
+        return {
+            candidate: fallback[0],
+            crossProvider: true,
+            originalProvider: preferredProvider,
+        };
+    }
+    return { candidate: undefined, allExhausted: true };
+}
+/**
+ * Read the Claude Code access token from ~/.claude/.credentials.json
+ * (or a custom configDir). Returns the claudeAiOauth.accessToken value.
+ */
+export function readClaudeCredential(configDir = join(homedir(), ".claude")) {
+    const path = join(configDir, ".credentials.json");
+    const raw = readJson(path);
+    if (!raw) {
+        return { ok: false, error: `credentials file not found or unreadable: ${path}` };
+    }
+    const oauth = raw["claudeAiOauth"];
+    const token = oauth?.["accessToken"];
+    if (typeof token !== "string" || !token.trim()) {
+        return { ok: false, error: `claudeAiOauth.accessToken missing or empty in ${path}` };
+    }
+    return { ok: true, accessToken: token.trim() };
+}
+/**
+ * Read the Codex / OpenAI API key from ~/.codex/auth.json
+ * (or a custom configDir). Returns the OPENAI_API_KEY value.
+ */
+export function readCodexCredential(configDir = join(homedir(), ".codex")) {
+    const path = join(configDir, "auth.json");
+    const raw = readJson(path);
+    if (!raw) {
+        return { ok: false, error: `auth file not found or unreadable: ${path}` };
+    }
+    const key = raw["OPENAI_API_KEY"];
+    if (typeof key !== "string" || !key.trim()) {
+        return { ok: false, error: `OPENAI_API_KEY missing or empty in ${path}` };
+    }
+    return { ok: true, accessToken: key.trim() };
+}
+// ---------------------------------------------------------------------------
+// Gateway constants (Layer-B wire — stable per architect spec)
+// ---------------------------------------------------------------------------
+export const LLM_GATEWAY_URL = "https://llm.sent-tech.ca";
+/**
+ * Returns the env vars to inject into a session so it routes through the
+ * llm-gateway. Requires a valid sentropic S2S DPoP token for pod auth
+ * (injected separately by the control-plane auth flow, not here).
+ */
+export function llmGatewayEnv() {
+    return { ANTHROPIC_BASE_URL: LLM_GATEWAY_URL };
+}
+export function sessionLogPath(dir = sentropicDir()) {
+    return join(dir, "session-log.jsonl");
+}
+export function appendSessionLogEntry(entry, dir) {
+    try {
+        const p = sessionLogPath(dir);
+        mkdirSync(dirname(p), { recursive: true });
+        const line = JSON.stringify({ at: new Date().toISOString(), ...entry }) + "\n";
+        appendFileSync(p, line, { mode: 0o600 });
+    }
+    catch {
+        // best-effort
+    }
+}
+/**
+ * Export the local session log to an S3 URI.
+ *
+ * Reads endpoint from AWS_ENDPOINT_URL (SCW: https://s3.fr-par.scw.cloud).
+ * Credentials from AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY (standard AWS env).
+ */
+export async function exportSessionLogToS3(s3Uri, dir) {
+    const match = s3Uri.match(/^s3:\/\/([^/]+)\/(.+)$/);
+    if (!match)
+        throw new Error(`Invalid S3 URI (expected s3://bucket/key): ${s3Uri}`);
+    const [, Bucket, Key] = match;
+    const logPath = sessionLogPath(dir);
+    let Body;
+    try {
+        Body = readFileSync(logPath);
+    }
+    catch {
+        throw new Error(`Session log not found at ${logPath}`);
+    }
+    const { S3Client, PutObjectCommand } = await import("@aws-sdk/client-s3");
+    const client = new S3Client({
+        region: process.env.AWS_DEFAULT_REGION ?? process.env.AWS_REGION ?? "fr-par",
+        ...(process.env.AWS_ENDPOINT_URL
+            ? { endpoint: process.env.AWS_ENDPOINT_URL }
+            : {}),
+    });
+    await client.send(new PutObjectCommand({ Bucket, Key, Body, ContentType: "application/x-ndjson" }));
+}
+//# sourceMappingURL=account-pool.js.map

package/dist/account-pool.js.map

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

package/dist/agents-projection.d.ts

@@ -0,0 +1,56 @@
+import type { RegistryEntry, LocalLsRow } from "./registry.js";
+export type RemoteAgentSourceKind = "job-registry" | "local-tmux";
+export type RemoteAgentState = "pending" | "running" | "throttled" | "done" | "failed" | "attached" | "detached" | "live";
+export type RemoteAgentProjection = {
+    id: string;
+    ownerSystem: "remote";
+    authoritativeForObjectiveState: false;
+    kind: "delegated-job" | "local-session";
+    tool: string;
+    state: RemoteAgentState;
+    cwd: string;
+    label?: string;
+    tmuxSession?: string;
+    remoteSessionId?: string;
+    jobId?: string;
+    h2aInstance?: string;
+    sources: Array<{
+        kind: RemoteAgentSourceKind;
+        id: string;
+    }>;
+    conflicts: string[];
+    capabilities: {
+        attach: boolean;
+        logs: boolean;
+        remote: boolean;
+        objectiveStateAuthority: false;
+    };
+};
+export type RemoteAgentsEnvelope = {
+    kind: "remote-agents-list";
+    version: 1;
+    agents: RemoteAgentProjection[];
+    warnings: string[];
+    degraded: false;
+};
+export type RemoteAgentInspectEnvelope = {
+    kind: "remote-agent-detail";
+    version: 1;
+    agent: RemoteAgentProjection;
+    related: {
+        jobs: unknown[];
+        sessions: unknown[];
+        logs: unknown[];
+    };
+    warnings: string[];
+};
+export declare function agentInstanceForJob(job: RegistryEntry): string;
+export declare function projectJobAgent(job: RegistryEntry): RemoteAgentProjection;
+export declare function projectLocalSessionAgent(row: LocalLsRow): RemoteAgentProjection;
+export declare function projectRemoteAgents(args: {
+    jobs: readonly RegistryEntry[];
+    localRows: readonly LocalLsRow[];
+}): RemoteAgentsEnvelope;
+export declare function projectRemoteAgentInspect(agent: RemoteAgentProjection): RemoteAgentInspectEnvelope;
+export declare function findProjectedAgent(agents: readonly RemoteAgentProjection[], selector: string): RemoteAgentProjection | undefined;
+//# sourceMappingURL=agents-projection.d.ts.map

package/dist/agents-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-projection.d.ts","sourceRoot":"","sources":["../src/agents-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE/D,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,YAAY,CAAC;AAClE,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,SAAS,GACT,WAAW,GACX,MAAM,GACN,QAAQ,GACR,UAAU,GACV,UAAU,GACV,MAAM,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,QAAQ,CAAC;IACtB,8BAA8B,EAAE,KAAK,CAAC;IACtC,IAAI,EAAE,eAAe,GAAG,eAAe,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,qBAAqB,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE;QACZ,MAAM,EAAE,OAAO,CAAC;QAChB,IAAI,EAAE,OAAO,CAAC;QACd,MAAM,EAAE,OAAO,CAAC;QAChB,uBAAuB,EAAE,KAAK,CAAC;KAChC,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,KAAK,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,EAAE;QACP,IAAI,EAAE,OAAO,EAAE,CAAC;QAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;QACpB,IAAI,EAAE,OAAO,EAAE,CAAC;KACjB,CAAC;IACF,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAE9D;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,aAAa,GAAG,qBAAqB,CAyBzE;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,UAAU,GAAG,qBAAqB,CAqB/E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IAC/B,SAAS,EAAE,SAAS,UAAU,EAAE,CAAC;CAClC,GAAG,oBAAoB,CAYvB;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,qBAAqB,GAC3B,0BAA0B,CAQ5B;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,qBAAqB,EAAE,EACxC,QAAQ,EAAE,MAAM,GACf,qBAAqB,GAAG,SAAS,CAUnC"}