@managoat/fountain-sdk 1.25.0

package/dist/sse.d.ts

@@ -0,0 +1,58 @@
+import type { HttpClient } from "./http.ts";
+import type { LogEvent, Stream } from "./types.ts";
+/**
+ * What a caller asks a stream for. `streams` takes the friendly array form
+ * here and is joined on the way to the query string.
+ */
+export type StreamRequest = Omit<StreamOptions, "streams"> & {
+    streams?: Stream[] | string;
+};
+/** One `id:`/`event:`/`data:` message off the wire. */
+export interface SseMessage {
+    id: string | null;
+    event: string;
+    data: string;
+}
+/** Split a byte stream into SSE messages. Comments (`: heartbeat`) are dropped. */
+export declare function parseSse(body: ReadableStream<Uint8Array>): AsyncGenerator<SseMessage>;
+export interface StreamOptions {
+    /** Resume after this event id. `0` replays the conversation from the start. */
+    after?: number;
+    signal?: AbortSignal;
+    /** How long one connection may sit idle before it is retried. */
+    idleTimeoutMs?: number;
+    /** Give up reconnecting after this many consecutive failures. */
+    maxRetries?: number;
+    /** Wait between reconnects, in ms. Exposed so tests do not sleep. */
+    retryDelayMs?: number;
+    /** Which streams to carry. Omitted means everything. */
+    streams?: string;
+    /** `false` drains the buffered events and closes instead of tailing live. */
+    wait?: boolean;
+    /**
+     * Ask for server-parsed `blocks` on each event.
+     *
+     * Every SSE endpoint takes it, so the wrappers here send it by default and
+     * a caller only sets this to stream the runtime's raw dialect instead.
+     */
+    blocks?: boolean;
+}
+/**
+ * The conversation's log feed as an async iterable of `LogEvent`, reconnecting
+ * on its own.
+ *
+ * The reconnect is not decoration. A Fountain deploy, a sandbox wake or an
+ * ordinary proxy timeout will end an SSE connection mid-turn; without a cursor
+ * the next connection either replays what the caller already saw or misses
+ * what arrived in the gap. `Last-Event-ID` is Fountain's answer — the server
+ * replays buffered events after that id, then tails live — so this loop tracks
+ * the last id it yielded and resumes there. A caller never sees the seam.
+ */
+export declare function streamEvents(http: HttpClient, conversationId: string, opts?: StreamOptions): AsyncGenerator<LogEvent>;
+/**
+ * The same reader, pointed at any of Fountain's SSE endpoints: one
+ * conversation, the whole team (`/api/team/stream`), or every conversation the
+ * caller owns (`/api/events/stream`). They share a format, a cursor header and
+ * a heartbeat, so they share this loop.
+ */
+export declare function streamPath(http: HttpClient, path: string, opts?: StreamOptions): AsyncGenerator<LogEvent>;

package/dist/sse.js

@@ -0,0 +1,219 @@
+import { FountainError, errorForStatus } from "./errors.js";
+/** Split a byte stream into SSE messages. Comments (`: heartbeat`) are dropped. */
+export async function* parseSse(body) {
+    const decoder = new TextDecoder();
+    const reader = body.getReader();
+    let buffer = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            let split;
+            // A message ends at a blank line; \r\n is legal and Fountain sends \n.
+            while ((split = indexOfBoundary(buffer)) !== -1) {
+                const { chunk, length } = boundaryAt(buffer, split);
+                buffer = buffer.slice(split + length);
+                const message = parseChunk(chunk);
+                if (message)
+                    yield message;
+            }
+        }
+    }
+    finally {
+        // A consumer that breaks out mid-turn must not leave the socket open.
+        try {
+            await reader.cancel();
+        }
+        catch {
+            // Already closed, or the peer went away first.
+        }
+        reader.releaseLock();
+    }
+    const tail = parseChunk(buffer);
+    if (tail)
+        yield tail;
+}
+function indexOfBoundary(buffer) {
+    const lf = buffer.indexOf("\n\n");
+    const crlf = buffer.indexOf("\r\n\r\n");
+    if (lf === -1)
+        return crlf;
+    if (crlf === -1)
+        return lf;
+    return Math.min(lf, crlf);
+}
+function boundaryAt(buffer, index) {
+    const isCrlf = buffer.startsWith("\r\n\r\n", index);
+    return { chunk: buffer.slice(0, index), length: isCrlf ? 4 : 2 };
+}
+function parseChunk(chunk) {
+    let id = null;
+    let event = "message";
+    const data = [];
+    for (const rawLine of chunk.split("\n")) {
+        const line = rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine;
+        if (!line || line.startsWith(":"))
+            continue; // heartbeat comment
+        const colon = line.indexOf(":");
+        const field = colon === -1 ? line : line.slice(0, colon);
+        let value = colon === -1 ? "" : line.slice(colon + 1);
+        if (value.startsWith(" "))
+            value = value.slice(1);
+        if (field === "id")
+            id = value;
+        else if (field === "event")
+            event = value;
+        else if (field === "data")
+            data.push(value);
+    }
+    if (!data.length && id === null)
+        return null;
+    return { id, event, data: data.join("\n") };
+}
+/**
+ * The conversation's log feed as an async iterable of `LogEvent`, reconnecting
+ * on its own.
+ *
+ * The reconnect is not decoration. A Fountain deploy, a sandbox wake or an
+ * ordinary proxy timeout will end an SSE connection mid-turn; without a cursor
+ * the next connection either replays what the caller already saw or misses
+ * what arrived in the gap. `Last-Event-ID` is Fountain's answer — the server
+ * replays buffered events after that id, then tails live — so this loop tracks
+ * the last id it yielded and resumes there. A caller never sees the seam.
+ */
+export function streamEvents(http, conversationId, opts = {}) {
+    // A conversation stream supports blocks, and a turn cannot be followed
+    // without them, so it is the default here.
+    return streamPath(http, `/api/conversations/${conversationId}/stream`, {
+        blocks: true,
+        ...opts,
+    });
+}
+/**
+ * The same reader, pointed at any of Fountain's SSE endpoints: one
+ * conversation, the whole team (`/api/team/stream`), or every conversation the
+ * caller owns (`/api/events/stream`). They share a format, a cursor header and
+ * a heartbeat, so they share this loop.
+ */
+export async function* streamPath(http, path, opts = {}) {
+    let lastId = opts.after ?? 0;
+    let attempt = 0;
+    const maxRetries = opts.maxRetries ?? 5;
+    const retryDelayMs = opts.retryDelayMs ?? 500;
+    while (true) {
+        let response;
+        try {
+            response = await http.raw("GET", path, {
+                query: {
+                    blocks: opts.blocks ? "true" : undefined,
+                    streams: opts.streams,
+                    wait: opts.wait === false ? "false" : undefined,
+                },
+                headers: lastId > 0 ? { "Last-Event-ID": String(lastId) } : {},
+                accept: "text/event-stream",
+                signal: opts.signal,
+                // The stream is meant to be held open; a request timeout would kill it.
+                timeoutMs: 0,
+            });
+        }
+        catch (error) {
+            if (opts.signal?.aborted)
+                return;
+            if (++attempt > maxRetries)
+                throw error;
+            await delay(retryDelayMs * attempt, opts.signal);
+            continue;
+        }
+        if (!response.ok) {
+            const text = await response.text().catch(() => "");
+            // 4xx will not fix itself: a bad key or a conversation this account
+            // cannot see returns the same answer however many times we ask.
+            if (response.status < 500 || ++attempt > maxRetries) {
+                throw errorForStatus(response.status, text ? safeJson(text) : null, "GET", path, response.headers);
+            }
+            await delay(retryDelayMs * attempt, opts.signal);
+            continue;
+        }
+        if (!response.body) {
+            throw new FountainError("SSE response had no body");
+        }
+        attempt = 0;
+        try {
+            for await (const message of parseSse(response.body)) {
+                if (opts.signal?.aborted)
+                    return;
+                const id = Number(message.id);
+                if (Number.isFinite(id) && id > 0)
+                    lastId = id;
+                const event = decodeEvent(message);
+                if (event)
+                    yield event;
+            }
+        }
+        catch (error) {
+            if (opts.signal?.aborted)
+                return;
+            if (++attempt > maxRetries)
+                throw error;
+            await delay(retryDelayMs * attempt, opts.signal);
+            continue;
+        }
+        // A drain closes on purpose; there is nothing to reconnect to.
+        if (opts.wait === false)
+            return;
+        // The connection ended. Fountain closes an idle stream after 60s, which is
+        // normal for a conversation between turns — reconnect from the cursor.
+        if (opts.signal?.aborted)
+            return;
+        if (++attempt > maxRetries)
+            return;
+        await delay(retryDelayMs, opts.signal);
+    }
+}
+function decodeEvent(message) {
+    if (!message.data)
+        return null;
+    let payload;
+    try {
+        payload = JSON.parse(message.data);
+    }
+    catch {
+        return null;
+    }
+    if (!payload || typeof payload !== "object")
+        return null;
+    const event = payload;
+    const id = Number(message.id);
+    if (Number.isFinite(id) && id > 0)
+        event.id = id;
+    if (!event.kind && (message.event === "output" || message.event === "stage")) {
+        event.kind = message.event;
+    }
+    return event;
+}
+function safeJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+function delay(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal?.aborted)
+            return resolve();
+        const timer = setTimeout(done, ms);
+        // Never hold the process open on a retry sleep.
+        timer.unref?.();
+        function done() {
+            signal?.removeEventListener("abort", done);
+            clearTimeout(timer);
+            resolve();
+        }
+        signal?.addEventListener("abort", done, { once: true });
+    });
+}
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

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

package/dist/team.d.ts

@@ -0,0 +1,90 @@
+import type { HttpClient } from "./http.ts";
+import type { Resolver } from "./resolve.ts";
+import { Conversation } from "./conversation.ts";
+import { Run, type RunOptions } from "./run.ts";
+import { type StreamRequest } from "./sse.ts";
+import type { ConversationRecord, ImageInput, Schedule, ScheduleInput, SchedulePatch, Stream, TeamAddInput, TeamCommsStatus, TeamEvent, Teammate } from "./types.ts";
+export interface MessageOptions extends RunOptions {
+    images?: ImageInput[];
+}
+/**
+ * The team: agents you have hired, each with a standing conversation.
+ *
+ * This is the surface the applications built on Fountain actually use — ten of
+ * the eleven talk to `/api/team` and only some of them ever touch
+ * `/api/conversations`. The reason is that a teammate is a *durable* thing:
+ * one agent, one long-running sandbox, one thread you keep messaging, rather
+ * than a conversation you open and close. `message()` returns the same `Run`
+ * handle `fountain.run()` does, so a reply can be awaited or streamed.
+ */
+export declare class Team {
+    private readonly http;
+    private readonly resolver;
+    /** Cron routines that run a teammate with a prompt. */
+    readonly schedules: TeamSchedules;
+    constructor(http: HttpClient, resolver: Resolver);
+    /** Everyone on the team, with their unread counts and last activity. */
+    list(): Promise<Teammate[]>;
+    /** One teammate, by agent name or id. */
+    get(agent: string): Promise<Teammate>;
+    /** Put an agent on the team. Idempotent for an agent already on it. */
+    add(agent: string, options?: Omit<TeamAddInput, "agent_id">): Promise<Teammate>;
+    /** Take a teammate off the team. The agent itself is untouched. */
+    remove(agent: string): Promise<void>;
+    /** Change the name the team page shows. `null` restores the agent's own name. */
+    rename(agent: string, name: string | null): Promise<Teammate>;
+    /**
+     * Say something to a teammate, in its standing conversation.
+     *
+     * Returns a `Run`: await it for the reply, iterate it for events, or ignore
+     * it and let the team stream carry the answer to a UI.
+     */
+    message(agent: string, prompt: string, options?: MessageOptions): Run;
+    /** The teammate's standing conversation, as a handle. */
+    conversation(agent: string): Promise<Conversation>;
+    /** Every conversation this teammate has had on the team. */
+    history(agent: string): Promise<ConversationRecord[]>;
+    /** Start a fresh thread on a new computer; the current one is retired. */
+    freshConversation(agent: string): Promise<ConversationRecord>;
+    /** Can teammates here be given an email address and a phone number? */
+    commsStatus(): Promise<TeamCommsStatus>;
+    /**
+     * The whole team's events on one connection.
+     *
+     * One stream for every teammate is the shape a team UI wants, and building
+     * it out of N per-conversation streams is what the apps did before this
+     * endpoint existed. Reconnects from the last event id on its own.
+     *
+     * Each payload is a conversation event plus `conversation_id` and
+     * `agent_id`, so a roster row can be found without a socket per teammate.
+     *
+     * Events carry server-parsed `blocks`, as on every other feed, so a client
+     * renders a transcript from this stream alone rather than re-parsing a
+     * runtime's dialect or opening a second connection per thread. The stream is
+     * multi-conversation, so the server picks the runtime per event from the
+     * conversation that produced it (#881).
+     */
+    stream(options?: StreamRequest): AsyncIterable<TeamEvent>;
+    private agentId;
+}
+/** Cron routines attached to a teammate. */
+export declare class TeamSchedules {
+    private readonly http;
+    private readonly resolver;
+    constructor(http: HttpClient, resolver: Resolver);
+    /** Every routine on the team, or just one teammate's. */
+    list(agent?: string): Promise<Schedule[]>;
+    get(agent: string, id: string): Promise<Schedule>;
+    create(agent: string, input: ScheduleInput): Promise<Schedule>;
+    update(agent: string, id: string, patch: SchedulePatch): Promise<Schedule>;
+    delete(agent: string, id: string): Promise<void>;
+    /** Run it now, without waiting for its cron. */
+    run(agent: string, id: string): Promise<unknown>;
+    private agentId;
+}
+/** `streams: ["acp", "stage"]` is friendlier than a comma-joined string. */
+export declare function normalizeStreams<T extends {
+    streams?: Stream[] | string;
+}>(options: T): Omit<T, "streams"> & {
+    streams?: string;
+};

package/dist/team.js

@@ -0,0 +1,183 @@
+import { Conversation } from "./conversation.js";
+import { Run } from "./run.js";
+import { streamPath } from "./sse.js";
+/**
+ * The team: agents you have hired, each with a standing conversation.
+ *
+ * This is the surface the applications built on Fountain actually use — ten of
+ * the eleven talk to `/api/team` and only some of them ever touch
+ * `/api/conversations`. The reason is that a teammate is a *durable* thing:
+ * one agent, one long-running sandbox, one thread you keep messaging, rather
+ * than a conversation you open and close. `message()` returns the same `Run`
+ * handle `fountain.run()` does, so a reply can be awaited or streamed.
+ */
+export class Team {
+    http;
+    resolver;
+    /** Cron routines that run a teammate with a prompt. */
+    schedules;
+    constructor(http, resolver) {
+        this.http = http;
+        this.resolver = resolver;
+        this.schedules = new TeamSchedules(http, resolver);
+    }
+    /** Everyone on the team, with their unread counts and last activity. */
+    async list() {
+        return this.http.list("/api/team");
+    }
+    /** One teammate, by agent name or id. */
+    async get(agent) {
+        return this.http.data("GET", `/api/team/${await this.agentId(agent)}`);
+    }
+    /** Put an agent on the team. Idempotent for an agent already on it. */
+    async add(agent, options = {}) {
+        const body = { ...options, agent_id: await this.agentId(agent) };
+        return this.http.data("POST", "/api/team", { body });
+    }
+    /** Take a teammate off the team. The agent itself is untouched. */
+    async remove(agent) {
+        await this.http.request("DELETE", `/api/team/${await this.agentId(agent)}`);
+    }
+    /** Change the name the team page shows. `null` restores the agent's own name. */
+    async rename(agent, name) {
+        return this.http.data("PATCH", `/api/team/${await this.agentId(agent)}`, {
+            body: { name },
+        });
+    }
+    /**
+     * Say something to a teammate, in its standing conversation.
+     *
+     * Returns a `Run`: await it for the reply, iterate it for events, or ignore
+     * it and let the team stream carry the answer to a UI.
+     */
+    message(agent, prompt, options = {}) {
+        const body = { prompt };
+        if (options.images?.length)
+            body.images = options.images;
+        return new Run(this.http, {
+            start: async () => {
+                const agentId = await this.agentId(agent);
+                // Where the teammate's thread stands *before* the message, so the
+                // follower knows which turn is the reply and where to read from.
+                const before = await this.http
+                    .data("GET", `/api/team/${agentId}`)
+                    .catch(() => null);
+                const existing = before?.conversation?.id ?? null;
+                let after = 0;
+                let turnNumber = 1;
+                if (existing) {
+                    const conversation = new Conversation(this.http, existing);
+                    after = await conversation.cursor();
+                    turnNumber = (await conversation.lastTurnNumber()) + 1;
+                }
+                const sent = await this.http.request("POST", `/api/team/${agentId}/messages`, { body });
+                const conversationId = sent?.conversation_id ?? existing;
+                if (!conversationId) {
+                    throw new Error(`POST /api/team/${agentId}/messages returned no conversation id`);
+                }
+                // A fresh thread (the teammate had none, or the old one was retired)
+                // starts its own numbering, and there is no history to skip.
+                if (conversationId !== existing) {
+                    after = 0;
+                    turnNumber = 1;
+                }
+                const conversation = await this.http.data("GET", `/api/conversations/${conversationId}`);
+                return { conversation, turnNumber, after };
+            },
+        }, options);
+    }
+    /** The teammate's standing conversation, as a handle. */
+    async conversation(agent) {
+        const teammate = await this.get(agent);
+        const id = teammate.conversation?.id;
+        if (!id)
+            throw new Error(`${agent} has no conversation yet — send it a message first`);
+        return new Conversation(this.http, id);
+    }
+    /** Every conversation this teammate has had on the team. */
+    async history(agent) {
+        return this.http.list(`/api/team/${await this.agentId(agent)}/conversations`);
+    }
+    /** Start a fresh thread on a new computer; the current one is retired. */
+    async freshConversation(agent) {
+        return this.http.data("POST", `/api/team/${await this.agentId(agent)}/conversations`);
+    }
+    /** Can teammates here be given an email address and a phone number? */
+    async commsStatus() {
+        return this.http.data("GET", "/api/team/comms");
+    }
+    /**
+     * The whole team's events on one connection.
+     *
+     * One stream for every teammate is the shape a team UI wants, and building
+     * it out of N per-conversation streams is what the apps did before this
+     * endpoint existed. Reconnects from the last event id on its own.
+     *
+     * Each payload is a conversation event plus `conversation_id` and
+     * `agent_id`, so a roster row can be found without a socket per teammate.
+     *
+     * Events carry server-parsed `blocks`, as on every other feed, so a client
+     * renders a transcript from this stream alone rather than re-parsing a
+     * runtime's dialect or opening a second connection per thread. The stream is
+     * multi-conversation, so the server picks the runtime per event from the
+     * conversation that produced it (#881).
+     */
+    stream(options = {}) {
+        return streamPath(this.http, "/api/team/stream", {
+            blocks: true,
+            ...normalizeStreams(options),
+        });
+    }
+    async agentId(agent) {
+        const { id } = await this.resolver.resolve("/api/agents", "agent", agent);
+        return id;
+    }
+}
+/** Cron routines attached to a teammate. */
+export class TeamSchedules {
+    http;
+    resolver;
+    constructor(http, resolver) {
+        this.http = http;
+        this.resolver = resolver;
+    }
+    /** Every routine on the team, or just one teammate's. */
+    async list(agent) {
+        if (!agent)
+            return this.http.list("/api/team/schedules");
+        return this.http.list(`/api/team/${await this.agentId(agent)}/schedules`);
+    }
+    async get(agent, id) {
+        return this.http.data("GET", `/api/team/${await this.agentId(agent)}/schedules/${id}`);
+    }
+    async create(agent, input) {
+        return this.http.data("POST", `/api/team/${await this.agentId(agent)}/schedules`, {
+            body: input,
+        });
+    }
+    async update(agent, id, patch) {
+        return this.http.data("PATCH", `/api/team/${await this.agentId(agent)}/schedules/${id}`, { body: patch });
+    }
+    async delete(agent, id) {
+        await this.http.request("DELETE", `/api/team/${await this.agentId(agent)}/schedules/${id}`);
+    }
+    /** Run it now, without waiting for its cron. */
+    async run(agent, id) {
+        return this.http.request("POST", `/api/team/${await this.agentId(agent)}/schedules/${id}/run`);
+    }
+    async agentId(agent) {
+        const { id } = await this.resolver.resolve("/api/agents", "agent", agent);
+        return id;
+    }
+}
+/** `streams: ["acp", "stage"]` is friendlier than a comma-joined string. */
+export function normalizeStreams(options) {
+    const { streams, ...rest } = options;
+    return {
+        ...rest,
+        ...(streams === undefined
+            ? {}
+            : { streams: Array.isArray(streams) ? streams.join(",") : streams }),
+    };
+}
+//# sourceMappingURL=team.js.map

package/dist/team.js.map

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

package/dist/turn.d.ts

@@ -0,0 +1,46 @@
+import type { LogEvent, RunEvent, TurnState } from "./types.ts";
+/**
+ * Folds the log feed into one turn's answer.
+ *
+ * The feed carries every turn of the conversation and every stream of each
+ * turn, so "what did the agent just say" is a filtering problem, not a
+ * concatenation one. This class is the filter:
+ *
+ *   - a `stage`/`turn` event opens and closes the turn we are following, and
+ *     is the only thing that says how it ended;
+ *   - `output` events carry server-parsed `blocks`; only `text` is the answer,
+ *     `tool_use` is noise worth naming, `thinking` is neither;
+ *   - text that follows a tool call is a new message, so it gets a paragraph
+ *     break — the rule that stops a transcript reading as one run-on sentence.
+ *
+ * The joining rules are ported from the Hermes plugin, which learned them
+ * against real runtimes: ACP streams one message as chunks that join with
+ * nothing, while a legacy stdout row is a whole message and joins as a
+ * paragraph.
+ */
+export declare class TurnFollower {
+    readonly turnNumber: number;
+    turnId: string | null;
+    started: boolean;
+    state: TurnState | null;
+    exitCode: number | null;
+    reason: string | null;
+    private readonly chunks;
+    private readonly tools;
+    private breakBeforeText;
+    constructor(turnNumber: number, turnId?: string | null);
+    get text(): string;
+    get toolsUsed(): string[];
+    get finished(): boolean;
+    /** Fold one event in, and report what a streaming caller should be told. */
+    apply(event: LogEvent): RunEvent[];
+    private applyStage;
+    private matchesTurn;
+    private applyOutput;
+    private applyBlock;
+    /**
+     * ACP chunks are pieces of one message and join with nothing; anything after
+     * a tool call is a new message. A legacy row is a whole message either way.
+     */
+    private paragraphBreak;
+}