@agent-relay/sdk 7.1.1 → 8.0.1

package/dist/logs.js

@@ -1,291 +0,0 @@
-/**
- * Log reading utilities for the broker SDK.
- *
- * Reads agent logs from the local filesystem at
- * `.agent-relay/worker-logs/{agent}.log`.
- */
-import { open, readdir, stat } from "node:fs/promises";
-import { join, resolve, sep } from "node:path";
-const DEFAULT_LOG_FOLLOW_POLL_MS = 1000;
-const DEFAULT_LOG_HISTORY_LINES = 200;
-function getDefaultLogsDir() {
-    return join(process.cwd(), ".agent-relay", "team", "worker-logs");
-}
-function splitLogLines(content) {
-    if (!content)
-        return [];
-    const lines = content.split("\n");
-    if (lines.length > 0 && lines[lines.length - 1] === "") {
-        lines.pop();
-    }
-    return lines;
-}
-/**
- * Read the last N lines from a file by scanning backward from the end.
- *
- * Unlike the naive readFile+split approach, this only reads as much of the
- * file as needed — important for large log files that can grow to many MB.
- */
-async function tailFile(filePath, lines) {
-    const CHUNK_SIZE = 8192;
-    let fh;
-    try {
-        fh = await open(filePath, "r");
-        const { size } = await fh.stat();
-        if (size === 0)
-            return "";
-        // For small files, just read the whole thing
-        if (size <= CHUNK_SIZE) {
-            const buf = Buffer.alloc(size);
-            await fh.read(buf, 0, size, 0);
-            const content = buf.toString("utf-8");
-            const allLines = content.split("\n");
-            // Strip trailing empty element from trailing newline
-            if (allLines.length > 0 && allLines[allLines.length - 1] === "") {
-                allLines.pop();
-            }
-            return allLines.slice(-lines).join("\n");
-        }
-        // For large files, read backward in chunks
-        let remaining = lines;
-        let position = size;
-        const chunks = [];
-        let foundLines = 0;
-        let trailingNewline = false;
-        while (position > 0 && foundLines <= remaining) {
-            const readSize = Math.min(CHUNK_SIZE, position);
-            position -= readSize;
-            const buf = Buffer.alloc(readSize);
-            await fh.read(buf, 0, readSize, position);
-            chunks.unshift(buf);
-            // Count newlines in this chunk
-            for (let i = buf.length - 1; i >= 0; i--) {
-                if (buf[i] === 0x0a) {
-                    // Skip trailing newline at very end of file
-                    if (position + i === size - 1) {
-                        trailingNewline = true;
-                        continue;
-                    }
-                    foundLines++;
-                    if (foundLines > remaining)
-                        break;
-                }
-            }
-        }
-        const combined = Buffer.concat(chunks).toString("utf-8");
-        const allLines = combined.split("\n");
-        // Strip trailing empty element from trailing newline
-        if (trailingNewline && allLines.length > 0 && allLines[allLines.length - 1] === "") {
-            allLines.pop();
-        }
-        return allLines.slice(-lines).join("\n");
-    }
-    catch {
-        return "";
-    }
-    finally {
-        await fh?.close();
-    }
-}
-async function readFileDelta(filePath, offset) {
-    let fh;
-    try {
-        fh = await open(filePath, "r");
-        const { size } = await fh.stat();
-        const start = size < offset ? 0 : offset;
-        if (size <= start) {
-            return { nextOffset: start, content: "" };
-        }
-        const length = size - start;
-        const buffer = Buffer.alloc(length);
-        await fh.read(buffer, 0, length, start);
-        return { nextOffset: size, content: buffer.toString("utf-8") };
-    }
-    catch {
-        return { nextOffset: offset, content: "" };
-    }
-    finally {
-        await fh?.close();
-    }
-}
-/**
- * Get logs for a specific agent.
- *
- * @example
- * ```ts
- * import { getLogs } from "@agent-relay/sdk";
- *
- * const result = await getLogs("Worker1", { lines: 100 });
- * if (result.found) {
- *   console.log(result.content);
- * }
- * ```
- */
-export async function getLogs(agent, options = {}) {
-    const logsDir = options.logsDir ?? getDefaultLogsDir();
-    const lines = options.lines ?? 50;
-    const logFile = join(logsDir, `${agent}.log`);
-    // Prevent path traversal — resolved path must stay inside logsDir
-    const resolvedLog = resolve(logFile);
-    const resolvedDir = resolve(logsDir);
-    if (!resolvedLog.startsWith(resolvedDir + sep)) {
-        return { agent, content: "", found: false, lineCount: 0 };
-    }
-    try {
-        await stat(logFile);
-        const content = await tailFile(logFile, lines);
-        const lineCount = content ? content.split("\n").length : 0;
-        return { agent, content, found: true, lineCount };
-    }
-    catch {
-        // Agent not found — list available agents to help the caller
-        const availableAgents = await listLoggedAgents(logsDir);
-        return { agent, content: "", found: false, lineCount: 0, availableAgents };
-    }
-}
-/**
- * Follow an agent log file by polling local filesystem for appended content.
- *
- * Emits:
- * - `subscribed` once
- * - `history` once (initial tail)
- * - `log` for incremental content
- * - `error` if subscription cannot be established
- *
- * @example
- * ```ts
- * import { followLogs } from "@agent-relay/sdk";
- *
- * const handle = followLogs("Worker1", {
- *   historyLines: 100,
- *   onEvent(event) {
- *     if (event.type === "log") console.log(event.content);
- *   },
- * });
- *
- * setTimeout(() => handle.unsubscribe(), 30_000);
- * ```
- */
-export function followLogs(agent, options) {
-    const logsDir = options.logsDir ?? getDefaultLogsDir();
-    const pollMs = Math.max(50, options.pollMs ?? DEFAULT_LOG_FOLLOW_POLL_MS);
-    const historyLines = Math.max(0, options.historyLines ?? DEFAULT_LOG_HISTORY_LINES);
-    const allowMissing = options.allowMissing ?? false;
-    const logFile = join(logsDir, `${agent}.log`);
-    const emit = (event) => {
-        if (disposed)
-            return;
-        options.onEvent(event);
-    };
-    let disposed = false;
-    let offset = 0;
-    let interval;
-    let pollInFlight = false;
-    const stop = () => {
-        disposed = true;
-        if (interval) {
-            clearInterval(interval);
-            interval = undefined;
-        }
-    };
-    const startPolling = () => {
-        if (disposed || interval)
-            return;
-        interval = setInterval(() => {
-            void pollOnce();
-        }, pollMs);
-    };
-    const pollOnce = async () => {
-        if (disposed || pollInFlight)
-            return;
-        pollInFlight = true;
-        try {
-            const delta = await readFileDelta(logFile, offset);
-            offset = delta.nextOffset;
-            if (delta.content) {
-                emit({ type: "log", agent, content: delta.content });
-            }
-        }
-        finally {
-            pollInFlight = false;
-        }
-    };
-    void (async () => {
-        const resolvedLog = resolve(logFile);
-        const resolvedDir = resolve(logsDir);
-        if (!resolvedLog.startsWith(resolvedDir + sep)) {
-            emit({
-                type: "error",
-                agent,
-                error: "Invalid agent name for log path",
-            });
-            stop();
-            return;
-        }
-        try {
-            const history = await getLogs(agent, {
-                logsDir,
-                lines: historyLines,
-            });
-            if (!history.found && !allowMissing) {
-                emit({
-                    type: "error",
-                    agent,
-                    error: `No local logs for '${agent}'.`,
-                    availableAgents: history.availableAgents,
-                });
-                stop();
-                return;
-            }
-            emit({ type: "subscribed", agent });
-            emit({
-                type: "history",
-                agent,
-                lines: splitLogLines(history.content),
-            });
-            try {
-                const logStats = await stat(logFile);
-                offset = logStats.size;
-            }
-            catch {
-                offset = 0;
-            }
-            startPolling();
-        }
-        catch {
-            emit({
-                type: "error",
-                agent,
-                error: `Failed to follow logs for '${agent}'.`,
-            });
-            stop();
-        }
-    })();
-    return {
-        unsubscribe: stop,
-    };
-}
-/**
- * List all agents that have log files.
- *
- * @example
- * ```ts
- * import { listLoggedAgents } from "@agent-relay/sdk";
- *
- * const agents = await listLoggedAgents();
- * console.log("Agents with logs:", agents);
- * ```
- */
-export async function listLoggedAgents(logsDir) {
-    const dir = logsDir ?? getDefaultLogsDir();
-    try {
-        const files = await readdir(dir);
-        return files
-            .filter((f) => f.endsWith(".log"))
-            .map((f) => f.slice(0, -4));
-    }
-    catch {
-        return [];
-    }
-}
-//# sourceMappingURL=logs.js.map

package/dist/logs.js.map

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

package/dist/models.d.ts

@@ -1,9 +0,0 @@
-/**
- * Model and CLI Constants
- *
- * Re-exports from @agent-relay/config package.
- * Source of truth: packages/shared/cli-registry.yaml
- * Run `npm run codegen:models` after editing the YAML.
- */
-export { CLIs, CLIVersions, CLIRegistry, ReasoningEfforts, ClaudeModels, CodexModels, GeminiModels, CursorModels, Models, DefaultModels, CLAUDE_MODEL_OPTIONS, CODEX_MODEL_OPTIONS, GEMINI_MODEL_OPTIONS, CURSOR_MODEL_OPTIONS, ModelMetadata, ModelOptions, getDefaultReasoningEffort, getModelMetadata, getSupportedReasoningEfforts, SwarmPatterns, type CLI, type ClaudeModel, type CodexModel, type GeminiModel, type CursorModel, type ModelOption, type ReasoningEffort, } from '@agent-relay/config';
-//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,IAAI,EACJ,WAAW,EACX,WAAW,EACX,gBAAgB,EAEhB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,aAAa,EAEb,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,yBAAyB,EACzB,gBAAgB,EAChB,4BAA4B,EAE5B,aAAa,EAEb,KAAK,GAAG,EACR,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/models.js

@@ -1,17 +0,0 @@
-/**
- * Model and CLI Constants
- *
- * Re-exports from @agent-relay/config package.
- * Source of truth: packages/shared/cli-registry.yaml
- * Run `npm run codegen:models` after editing the YAML.
- */
-export { 
-// CLI tools and versions
-CLIs, CLIVersions, CLIRegistry, ReasoningEfforts, 
-// Model constants
-ClaudeModels, CodexModels, GeminiModels, CursorModels, Models, DefaultModels, 
-// Model options for UI dropdowns
-CLAUDE_MODEL_OPTIONS, CODEX_MODEL_OPTIONS, GEMINI_MODEL_OPTIONS, CURSOR_MODEL_OPTIONS, ModelMetadata, ModelOptions, getDefaultReasoningEffort, getModelMetadata, getSupportedReasoningEfforts, 
-// Swarm patterns (type is in workflows/types.ts)
-SwarmPatterns, } from '@agent-relay/config';
-//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO;AACL,yBAAyB;AACzB,IAAI,EACJ,WAAW,EACX,WAAW,EACX,gBAAgB;AAChB,kBAAkB;AAClB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,aAAa;AACb,iCAAiC;AACjC,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,YAAY,EACZ,yBAAyB,EACzB,gBAAgB,EAChB,4BAA4B;AAC5B,iDAAiD;AACjD,aAAa,GASd,MAAM,qBAAqB,CAAC"}

package/dist/personas.d.ts

@@ -1,160 +0,0 @@
-/**
- * Persona loading and translation.
- *
- * A persona is a JSON file that describes a pre-configured agent: which
- * harness (CLI) to use, which model, what system prompt to inject, plus
- * optional MCP servers and permission flags. Personas live in
- * `<cwd>/agentworkforce/personas`, the AgentWorkforce home directory, or
- * any directory the caller passes explicitly.
- *
- * Translation from a resolved persona to `{bin, args}` delegates to
- * `@agentworkforce/harness-kit#buildInteractiveSpec`, so relay always
- * produces the same launch args the AgentWorkforce CLI does.
- *
- * The schema mirrors the AgentWorkforce persona format
- * (see https://github.com/AgentWorkforce/workforce). Skills installation,
- * mount policy, sidecar markdown, input rendering, and routing profiles
- * are deliberately not handled here — callers needing those should use
- * the `agentworkforce` CLI directly.
- */
-import { type InteractiveConfigFile } from '@agentworkforce/harness-kit';
-import { HARNESS_VALUES, PERSONA_TIERS, type Harness, type McpServerSpec, type PersonaPermissions, type PersonaTier } from '@agentworkforce/workload-router';
-export type { Harness, McpServerSpec, PersonaPermissions, PersonaTier };
-export { HARNESS_VALUES, PERSONA_TIERS };
-export interface PersonaTierSpec {
-    harness?: Harness;
-    model?: string;
-    systemPrompt?: string;
-    /** Free-form harness settings (reasoning level, timeout) — not consumed by spawnPty today. */
-    harnessSettings?: Record<string, unknown>;
-}
-/** Raw persona file shape. */
-export interface PersonaFile {
-    id: string;
-    intent?: string;
-    description?: string;
-    tags?: string[];
-    /** Used for every tier when set without `tiers`. Ignored when `tiers` is set. */
-    systemPrompt?: string;
-    /** Top-level harness/model — used when there are no tiers. */
-    harness?: Harness;
-    model?: string;
-    permissions?: PersonaPermissions;
-    mcpServers?: Record<string, McpServerSpec>;
-    /** Per-tier overrides. A tier set here takes precedence over the top-level fields. */
-    tiers?: Partial<Record<PersonaTier, PersonaTierSpec>>;
-    /** Inherits from another persona id (looked up in the same search dirs). One level deep. */
-    extends?: string;
-}
-/** A persona file located on disk. */
-export interface DiscoveredPersona {
-    id: string;
-    path: string;
-    spec: PersonaFile;
-}
-/** A persona resolved against a tier — ready for {@link buildPersonaSpawnSpec}. */
-export interface ResolvedPersona {
-    id: string;
-    /** Absolute path to the JSON file the spec came from. */
-    source: string;
-    tier: PersonaTier;
-    harness: Harness;
-    model: string;
-    systemPrompt: string;
-    description?: string;
-    permissions?: PersonaPermissions;
-    mcpServers?: Record<string, McpServerSpec>;
-}
-export interface PersonaLoadOptions {
-    cwd?: string;
-    /** Override the default search-dir cascade. */
-    searchDirs?: string[];
-    /** Extra dirs appended after the default cascade. */
-    extraDirs?: string[];
-    /** Tier to resolve. Defaults to 'best'. */
-    tier?: PersonaTier;
-}
-/**
- * The shape `AgentRelay.spawnPersona` needs to drive `spawnPty`. Built by
- * {@link buildPersonaSpawnSpec} from a {@link ResolvedPersona}.
- */
-export interface PersonaSpawnSpec {
-    /** CLI to launch (matches relay's AgentCli union: 'claude' | 'codex' | 'opencode'). */
-    cli: string;
-    model: string;
-    args: string[];
-    /**
-     * If non-null, append this as the final positional arg to the CLI invocation.
-     * Codex uses this to carry the system prompt; claude / opencode return null.
-     */
-    initialPrompt: string | null;
-    /**
-     * Files the caller must materialize (relative to spawn cwd) before launching
-     * the agent. Used by opencode to drop an `opencode.json` carrying the
-     * persona's agent definition. Empty for claude / codex.
-     */
-    configFiles: InteractiveConfigFile[];
-    /** Non-fatal warnings from the harness-kit translation step. */
-    warnings: string[];
-}
-/**
- * The default cascade. First match wins for a given persona id.
- *
- * 1. `<cwd>/agentworkforce/personas`            (the path most projects pick)
- * 2. `<cwd>/.agentworkforce/workforce/personas` (workforce CLI's project default)
- * 3. `<cwd>/agentworkforce/workforce/personas`  (alt workforce layout)
- * 4. `$AGENT_WORKFORCE_HOME/personas` if set, else `~/.agentworkforce/workforce/personas`
- */
-export declare function defaultPersonaSearchDirs(cwd?: string): string[];
-/**
- * List every persona discoverable across the search-dir cascade. When the
- * same id appears in multiple dirs, only the first match (by cascade order)
- * is returned.
- */
-export declare function listPersonas(options?: PersonaLoadOptions): DiscoveredPersona[];
-/**
- * Find a persona file by id across the search-dir cascade.
- * Returns undefined if not found.
- */
-export declare function findPersona(id: string, options?: PersonaLoadOptions): DiscoveredPersona | undefined;
-/**
- * Load and resolve a persona by id. Searches the cascade, applies the
- * chosen tier, and resolves a single level of `extends` against the same
- * cascade. Throws if the persona is missing required fields for the tier.
- */
-export declare function loadPersona(id: string, options?: PersonaLoadOptions): ResolvedPersona;
-/**
- * Translate a resolved persona into the bin/args spawnPty needs. Delegates
- * to {@link buildInteractiveSpec} from `@agentworkforce/harness-kit` so
- * relay produces the same launch shape the AgentWorkforce CLI does.
- */
-export declare function buildPersonaSpawnSpec(persona: ResolvedPersona): PersonaSpawnSpec;
-/**
- * Codex has no system-prompt flag, so the persona's instructions must ride
- * on the task. Combines them in the same shape the agentworkforce
- * harness-kit uses for non-interactive codex runs.
- */
-export declare function composePersonaTask(spec: Pick<PersonaSpawnSpec, 'initialPrompt'>, userTask: string | undefined): string | undefined;
-/** Tracks a file we wrote, so the caller can restore the prior contents. */
-export interface MaterializedConfigFile {
-    /** Absolute path that was written. */
-    path: string;
-    /** Whether a file existed at this path before we wrote. */
-    existed: boolean;
-    /** Prior contents (only set when existed is true). */
-    previous?: string;
-}
-/**
- * Write each persona config file into `cwd`. Refuses absolute paths or
- * paths that escape `cwd`. Returns handles the caller can pass to
- * {@link restorePersonaConfigFiles}.
- */
-export declare function materializePersonaConfigFiles(cwd: string, files: readonly InteractiveConfigFile[]): MaterializedConfigFile[];
-/**
- * Restore the original state of files written by
- * {@link materializePersonaConfigFiles}. Files that did not exist before
- * are removed; files that did exist are written back to their prior
- * contents. Errors are swallowed — restore is best-effort cleanup.
- */
-export declare function restorePersonaConfigFiles(writes: readonly MaterializedConfigFile[]): void;
-//# sourceMappingURL=personas.d.ts.map

package/dist/personas.d.ts.map

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