@nylorun/agents 0.19.1-beta → 0.21.0-beta

package/dist/sandboxes.js

@@ -1,109 +0,0 @@
-/**
- * Sandboxes as a resource (Host feature `sandboxes`): `client.sandboxes`. A sandbox has its own
- * id and outlives the sessions attached to it; whether it serves one session, one person or a
- * project is the app's choice, made here:
- *
- * - `sandboxes.forSession(...)`: one sandbox for one session. It creates the sandbox, opens the
- *   session attached to it, and `release()` deletes the sandbox when the session is done. It
- *   replaces sharing through another session (`sandbox: { session }`, `sandboxOwnerId`).
- * - `sandboxes.ensure(id, spec)`: one sandbox per person or per project, by a deterministic id
- *   (`user-42`, `team-a/proj-42`); get-or-create in one call. Attach sessions to it with
- *   `createSession({ sandbox: { id } })`.
- *
- * Ids may hold `/`; they are sent percent-encoded as one path segment.
- */
-import { SandboxPageSchema, isSandboxId, } from "@nylorun/core/contracts";
-import { id, segment } from "./http.js";
-const FEATURE = "sandboxes";
-export class SandboxesClient {
-    transport;
-    createSession;
-    constructor(transport, 
-    /** `AgentsClient.createSession`, bound. */
-    createSession) {
-        this.transport = transport;
-        this.createSession = createSession;
-    }
-    path(sandboxId) {
-        if (!isSandboxId(sandboxId))
-            throw new TypeError(`${sandboxId} is not a sandbox id: up to 200 characters, /-separated segments of letters, digits, '.', '_' and '-'`);
-        return `/v1/sandboxes/${segment(sandboxId)}`;
-    }
-    /**
-     * Creates the sandbox, or finds the one with this id (`PUT /v1/sandboxes/{id}`). Its spec is
-     * fixed once it exists: a different one is a 409. Labels, when given, replace its labels.
-     */
-    async ensure(sandboxId, spec = {}, options = {}) {
-        const path = this.path(sandboxId);
-        await this.transport.requireFeature(FEATURE, options.signal);
-        return this.transport.json(path, "PUT", { requestId: id(), ...spec }, options.signal);
-    }
-    async get(sandboxId, options = {}) {
-        const path = this.path(sandboxId);
-        await this.transport.requireFeature(FEATURE, options.signal);
-        return this.transport.json(path, "GET", undefined, options.signal);
-    }
-    /** The sandboxes with every label in `labels` that this client reaches. */
-    async list(options = {}) {
-        await this.transport.requireFeature(FEATURE, options.signal);
-        const query = new URLSearchParams();
-        for (const [key, value] of Object.entries(options.labels ?? {}))
-            query.append("label", `${key}=${value}`);
-        const search = query.toString();
-        const reply = await this.transport.json(`/v1/sandboxes${search ? `?${search}` : ""}`, "GET", undefined, options.signal);
-        return reply.sandboxes;
-    }
-    async page(options = {}) {
-        await this.transport.requireFeature("session-reads", options.signal);
-        const query = new URLSearchParams({ limit: String(options.limit ?? 50) });
-        if (options.cursor !== undefined)
-            query.set("cursor", options.cursor);
-        for (const [key, value] of Object.entries(options.labels ?? {}))
-            query.append("label", `${key}=${value}`);
-        return SandboxPageSchema.parse(await this.transport.json(`/v1/sandboxes?${query}`, "GET", undefined, options.signal));
-    }
-    /** Deletes the sandbox and its files; `deleted` is false when there was none. */
-    async delete(sandboxId, options = {}) {
-        const path = this.path(sandboxId);
-        await this.transport.requireFeature(FEATURE, options.signal);
-        return this.transport.json(path, "DELETE", undefined, options.signal);
-    }
-    /** The sandbox's lifecycle events, from `from` on. */
-    async events(sandboxId, options = {}) {
-        const path = this.path(sandboxId);
-        await this.transport.requireFeature(FEATURE, options.signal);
-        const reply = await this.transport.json(`${path}/events${options.from === undefined ? "" : `?from=${options.from}`}`, "GET", undefined, options.signal);
-        return reply.events;
-    }
-    /**
-     * One sandbox for one session: creates the sandbox (`sessions/<session id>` unless
-     * `sandboxId` names another), opens the session attached to it, and returns both with
-     * `release()`, which deletes the sandbox. If the session cannot be opened, the sandbox is
-     * deleted again.
-     */
-    async forSession(options) {
-        const sessionId = options.session.id ?? id();
-        const sandboxId = options.sandboxId ??
-            (isSandboxId(`sessions/${sessionId}`) ? `sessions/${sessionId}` : `sessions/${id()}`);
-        const sandbox = await this.ensure(sandboxId, options.spec ?? {}, {
-            ...(options.signal ? { signal: options.signal } : {}),
-        });
-        let session;
-        try {
-            session = await this.createSession({
-                ...options.session,
-                id: sessionId,
-                sandbox: { id: sandboxId },
-            });
-        }
-        catch (error) {
-            await this.delete(sandboxId).catch(() => undefined);
-            throw error;
-        }
-        return {
-            session,
-            sandbox,
-            release: (release = {}) => this.delete(sandboxId, release),
-        };
-    }
-}

package/dist/skills/catalog.d.ts

@@ -1,5 +0,0 @@
-export declare const SKILLS_USAGE = "The following skills provide specialized instructions. When a task matches a skill description, call load_skill with that name before proceeding.";
-export declare function formatSkillCatalog(skills: readonly {
-    name: string;
-    description: string;
-}[]): string;

package/dist/skills/catalog.js

@@ -1,14 +0,0 @@
-export const SKILLS_USAGE = "The following skills provide specialized instructions. When a task matches a skill description, call load_skill with that name before proceeding.";
-export function formatSkillCatalog(skills) {
-    const entries = skills
-        .map((skill) => `  <skill>\n    <name>${escapeXml(skill.name)}</name>\n    <description>${escapeXml(skill.description)}</description>\n  </skill>`)
-        .join("\n");
-    return `<available_skills>\n${entries}\n</available_skills>`;
-}
-function escapeXml(value) {
-    return value
-        .replaceAll("&", "&amp;")
-        .replaceAll("<", "&lt;")
-        .replaceAll(">", "&gt;")
-        .replaceAll('"', "&quot;");
-}