@cerebro-labs/agentnava-sdk 0.26.0

package/project.d.ts

@@ -0,0 +1,94 @@
+import { Conversation } from './conversation.ts';
+import type { Http } from './http.ts';
+import type { FileEntry, ProjectData, ProjectFields } from './types.ts';
+export interface ProjectStartOptions {
+    parameters?: Record<string, string | number>;
+}
+export interface FileUrlOptions {
+    download?: boolean;
+    ttl?: number;
+}
+/**
+ * A project you can work with. Holding one makes no request.
+ *
+ * The difference from an agent is the shared folder: every agent on a project
+ * reads and writes the SAME files, which is what lets one pick up where another
+ * left off. Two conversations with the same agent share nothing; two agents on
+ * the same project share everything in that folder.
+ */
+export declare class Project {
+    #private;
+    readonly id: string;
+    private snapshot?;
+    constructor(http: Http, id: string, snapshot?: ProjectData);
+    private get base();
+    get data(): ProjectData | undefined;
+    get(): Promise<ProjectData>;
+    update(fields: ProjectFields): Promise<Project>;
+    addAgent(agentId: string): Promise<Project>;
+    removeAgent(agentId: string): Promise<Project>;
+    /** Stop it without destroying it. The folder and the history stay readable. */
+    archive(): Promise<Project>;
+    /** Delete it, and the shared folder with it. Archive is usually what you
+     *  wanted. */
+    delete(): Promise<void>;
+    start(options?: ProjectStartOptions): Promise<Conversation>;
+    /**
+     * Address one of this project's conversations by id. No request.
+     *
+     * The sibling of `agent.conversation(id)`: the thing that owns it is the
+     * thing you ask.
+     *
+     * A PROJECT HAS ONE CONVERSATION PER AGENT, NOT ONE IN TOTAL. Starting a
+     * project opens the manager's conversation and one for every agent on the
+     * roster, so `conversations()` on a two-agent project returns three.
+     *
+     * This comment used to say a project had exactly one, which was true when it
+     * was written and had stopped being true by the time anyone read it.
+     * Observed on deployed staging on 2026-09-18: starting a project with Sal and
+     * Otis returned three, the manager's being the one with no `agent_id`.
+     *
+     * Tell them apart by `agent_id` on the wire row: absent means the manager,
+     * which is derived from the project rather than configured as an agent, and
+     * whose `conversation.agentId` reads `manager-<projectId>`.
+     *
+     * It resolves because `getSession` reads both session tables: an id does
+     * not say which one it came from, so the route answers for either.
+     */
+    conversation(conversationId: string): Conversation;
+    conversations(): Promise<Conversation[]>;
+    /** List one directory of the shared folder. Same `path` parameter as
+     *  everywhere else on this API. */
+    files(path?: string): Promise<FileEntry[]>;
+    readFile(path: string): Promise<string>;
+    fileUrl(path: string, options?: FileUrlOptions): Promise<string>;
+}
+/** A project row as `/v1/projects` returns it: snake_case, nested. */
+interface WireProject {
+    id: string;
+    workspace_id: string;
+    name: string;
+    status: string;
+    goal: string | null;
+    manager_instructions: string | null;
+    grade: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface WireMember {
+    project_id: string;
+    agent_id: string;
+    agent_version: number | null;
+    agent_name: string | null;
+    added_at: string;
+}
+/** The `{ project, agents }` envelope as one flat ProjectData.
+ *
+ *  The envelope and the snake_case are what apps/console reads, so the wire
+ *  stays and the SDK translates. A caller wants `project.agents`, not
+ *  `response.agents` alongside `response.project`. */
+export declare function toProjectData(body: {
+    project?: WireProject;
+    agents?: WireMember[];
+} | WireProject): ProjectData;
+export {};

package/project.js

@@ -0,0 +1,155 @@
+// A project: several agents, one goal, one shared folder.
+import { Conversation } from "./conversation.js";
+/**
+ * A project you can work with. Holding one makes no request.
+ *
+ * The difference from an agent is the shared folder: every agent on a project
+ * reads and writes the SAME files, which is what lets one pick up where another
+ * left off. Two conversations with the same agent share nothing; two agents on
+ * the same project share everything in that folder.
+ */
+export class Project {
+    id;
+    #http;
+    snapshot;
+    constructor(http, id, snapshot) {
+        this.#http = http;
+        this.id = id;
+        if (snapshot)
+            this.snapshot = snapshot;
+    }
+    get base() {
+        return `/v1/projects/${encodeURIComponent(this.id)}`;
+    }
+    get data() {
+        return this.snapshot;
+    }
+    async get() {
+        const data = toProjectData(await this.#http.get(this.base));
+        this.snapshot = data;
+        return data;
+    }
+    async update(fields) {
+        await this.#http.patch(this.base, fields);
+        // PATCH answers the row it wrote; re-read so the object carries the roster
+        // too, which the caller will ask for next.
+        return new Project(this.#http, this.id, await this.get());
+    }
+    async addAgent(agentId) {
+        const data = toProjectData(await this.#http.post(`${this.base}/agents`, { agentId }));
+        this.snapshot = data;
+        return new Project(this.#http, this.id, data);
+    }
+    async removeAgent(agentId) {
+        const data = toProjectData(await this.#http.delete(`${this.base}/agents/${encodeURIComponent(agentId)}`));
+        this.snapshot = data;
+        return new Project(this.#http, this.id, data);
+    }
+    /** Stop it without destroying it. The folder and the history stay readable. */
+    async archive() {
+        const data = toProjectData(await this.#http.post(`${this.base}/archive`));
+        this.snapshot = data;
+        return new Project(this.#http, this.id, data);
+    }
+    /** Delete it, and the shared folder with it. Archive is usually what you
+     *  wanted. */
+    async delete() {
+        await this.#http.delete(this.base);
+    }
+    async start(options = {}) {
+        const data = await this.#http.post(`${this.base}/conversations`, {
+            ...(options.parameters && { parameters: options.parameters }),
+        });
+        // A project conversation and an agent conversation differ in what STARTED
+        // them, not in what you can do with one, so they share the class. The
+        // distinction that matters (which id it carries) is in the data.
+        return new Conversation(this.#http, data.id);
+    }
+    /**
+     * Address one of this project's conversations by id. No request.
+     *
+     * The sibling of `agent.conversation(id)`: the thing that owns it is the
+     * thing you ask.
+     *
+     * A PROJECT HAS ONE CONVERSATION PER AGENT, NOT ONE IN TOTAL. Starting a
+     * project opens the manager's conversation and one for every agent on the
+     * roster, so `conversations()` on a two-agent project returns three.
+     *
+     * This comment used to say a project had exactly one, which was true when it
+     * was written and had stopped being true by the time anyone read it.
+     * Observed on deployed staging on 2026-09-18: starting a project with Sal and
+     * Otis returned three, the manager's being the one with no `agent_id`.
+     *
+     * Tell them apart by `agent_id` on the wire row: absent means the manager,
+     * which is derived from the project rather than configured as an agent, and
+     * whose `conversation.agentId` reads `manager-<projectId>`.
+     *
+     * It resolves because `getSession` reads both session tables: an id does
+     * not say which one it came from, so the route answers for either.
+     */
+    conversation(conversationId) {
+        return new Conversation(this.#http, conversationId);
+    }
+    async conversations() {
+        // `sessions`, which is what the route actually answers with. This read
+        // `res.conversations`, which is always undefined, so `?? []` turned a SHAPE
+        // MISMATCH into a plausible empty list and every project reported having no
+        // conversations however many it had.
+        //
+        // The URL was never the problem: /conversations is a real alias for
+        // /sessions and both return `{ sessions: [...] }`. Only the key was wrong,
+        // which is why nothing 404'd and nothing looked broken.
+        //
+        // Same shape as the bugs this SDK's own end-to-end suite found on the
+        // server today: an absence read as an emptiness. `?? []` is the line that
+        // does the hiding, and it is load-bearing for a genuinely empty project, so
+        // the fix is to read the right key rather than to remove the fallback.
+        const res = await this.#http.get(`${this.base}/conversations`);
+        return (res.sessions ?? []).map((c) => new Conversation(this.#http, c.id));
+    }
+    // --------------------------------------------------------- the shared folder
+    /** List one directory of the shared folder. Same `path` parameter as
+     *  everywhere else on this API. */
+    async files(path = '/') {
+        const res = await this.#http.get(`${this.base}/files`, { path });
+        return (res.files ?? []);
+    }
+    async readFile(path) {
+        // JSON `{path, content}`, not bare text. See Conversation.readFile.
+        const res = await this.#http.get(`${this.base}/files/content`, { path });
+        return res.content ?? '';
+    }
+    async fileUrl(path, options = {}) {
+        const res = await this.#http.post(`${this.base}/files/url`, {
+            path,
+            ...(options.download !== undefined && { download: options.download }),
+            ...(options.ttl !== undefined && { ttl: options.ttl }),
+        });
+        return res.url;
+    }
+}
+/** The `{ project, agents }` envelope as one flat ProjectData.
+ *
+ *  The envelope and the snake_case are what apps/console reads, so the wire
+ *  stays and the SDK translates. A caller wants `project.agents`, not
+ *  `response.agents` alongside `response.project`. */
+export function toProjectData(body) {
+    const p = ('project' in body ? body.project : body);
+    const members = ('agents' in body ? (body.agents ?? []) : []);
+    return {
+        id: p?.id ?? '',
+        name: p?.name ?? '',
+        goal: p?.goal ?? null,
+        managerInstructions: p?.manager_instructions ?? null,
+        grade: (p?.grade === 'premium' ? 'premium' : 'standard'),
+        status: p?.status === 'archived' ? 'archived' : 'active',
+        agents: members.map((m) => ({
+            agentId: m.agent_id,
+            name: m.agent_name ?? '',
+            addedAt: m.added_at,
+        })),
+        createdAt: p?.created_at ?? '',
+        updatedAt: p?.updated_at ?? '',
+    };
+}
+//# sourceMappingURL=project.js.map

package/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"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","sourcesContent":["// A project: several agents, one goal, one shared folder.\n\nimport { Conversation } from './conversation.ts';\nimport type { Http } from './http.ts';\nimport type { FileEntry, ProjectConversationData, ProjectData, ProjectFields } from './types.ts';\n\nexport interface ProjectStartOptions {\n\tparameters?: Record<string, string | number>;\n}\n\nexport interface FileUrlOptions {\n\tdownload?: boolean;\n\tttl?: number;\n}\n\n/**\n * A project you can work with. Holding one makes no request.\n *\n * The difference from an agent is the shared folder: every agent on a project\n * reads and writes the SAME files, which is what lets one pick up where another\n * left off. Two conversations with the same agent share nothing; two agents on\n * the same project share everything in that folder.\n */\nexport class Project {\n\treadonly id: string;\n\treadonly #http: Http;\n\tprivate snapshot?: ProjectData;\n\n\tconstructor(http: Http, id: string, snapshot?: ProjectData) {\n\t\tthis.#http = http;\n\t\tthis.id = id;\n\t\tif (snapshot) this.snapshot = snapshot;\n\t}\n\n\tprivate get base(): string {\n\t\treturn `/v1/projects/${encodeURIComponent(this.id)}`;\n\t}\n\n\tget data(): ProjectData | undefined {\n\t\treturn this.snapshot;\n\t}\n\n\tasync get(): Promise<ProjectData> {\n\t\tconst data = toProjectData(await this.#http.get(this.base));\n\t\tthis.snapshot = data;\n\t\treturn data;\n\t}\n\n\tasync update(fields: ProjectFields): Promise<Project> {\n\t\tawait this.#http.patch(this.base, fields);\n\t\t// PATCH answers the row it wrote; re-read so the object carries the roster\n\t\t// too, which the caller will ask for next.\n\t\treturn new Project(this.#http, this.id, await this.get());\n\t}\n\n\tasync addAgent(agentId: string): Promise<Project> {\n\t\tconst data = toProjectData(await this.#http.post(`${this.base}/agents`, { agentId }));\n\t\tthis.snapshot = data;\n\t\treturn new Project(this.#http, this.id, data);\n\t}\n\n\tasync removeAgent(agentId: string): Promise<Project> {\n\t\tconst data = toProjectData(\n\t\t\tawait this.#http.delete(`${this.base}/agents/${encodeURIComponent(agentId)}`),\n\t\t);\n\t\tthis.snapshot = data;\n\t\treturn new Project(this.#http, this.id, data);\n\t}\n\n\t/** Stop it without destroying it. The folder and the history stay readable. */\n\tasync archive(): Promise<Project> {\n\t\tconst data = toProjectData(await this.#http.post(`${this.base}/archive`));\n\t\tthis.snapshot = data;\n\t\treturn new Project(this.#http, this.id, data);\n\t}\n\n\t/** Delete it, and the shared folder with it. Archive is usually what you\n\t *  wanted. */\n\tasync delete(): Promise<void> {\n\t\tawait this.#http.delete(this.base);\n\t}\n\n\tasync start(options: ProjectStartOptions = {}): Promise<Conversation> {\n\t\tconst data = await this.#http.post<ProjectConversationData>(`${this.base}/conversations`, {\n\t\t\t...(options.parameters && { parameters: options.parameters }),\n\t\t});\n\t\t// A project conversation and an agent conversation differ in what STARTED\n\t\t// them, not in what you can do with one, so they share the class. The\n\t\t// distinction that matters (which id it carries) is in the data.\n\t\treturn new Conversation(this.#http, data.id);\n\t}\n\n\t/**\n\t * Address one of this project's conversations by id. No request.\n\t *\n\t * The sibling of `agent.conversation(id)`: the thing that owns it is the\n\t * thing you ask.\n\t *\n\t * A PROJECT HAS ONE CONVERSATION PER AGENT, NOT ONE IN TOTAL. Starting a\n\t * project opens the manager's conversation and one for every agent on the\n\t * roster, so `conversations()` on a two-agent project returns three.\n\t *\n\t * This comment used to say a project had exactly one, which was true when it\n\t * was written and had stopped being true by the time anyone read it.\n\t * Observed on deployed staging on 2026-09-18: starting a project with Sal and\n\t * Otis returned three, the manager's being the one with no `agent_id`.\n\t *\n\t * Tell them apart by `agent_id` on the wire row: absent means the manager,\n\t * which is derived from the project rather than configured as an agent, and\n\t * whose `conversation.agentId` reads `manager-<projectId>`.\n\t *\n\t * It resolves because `getSession` reads both session tables: an id does\n\t * not say which one it came from, so the route answers for either.\n\t */\n\tconversation(conversationId: string): Conversation {\n\t\treturn new Conversation(this.#http, conversationId);\n\t}\n\n\tasync conversations(): Promise<Conversation[]> {\n\t\t// `sessions`, which is what the route actually answers with. This read\n\t\t// `res.conversations`, which is always undefined, so `?? []` turned a SHAPE\n\t\t// MISMATCH into a plausible empty list and every project reported having no\n\t\t// conversations however many it had.\n\t\t//\n\t\t// The URL was never the problem: /conversations is a real alias for\n\t\t// /sessions and both return `{ sessions: [...] }`. Only the key was wrong,\n\t\t// which is why nothing 404'd and nothing looked broken.\n\t\t//\n\t\t// Same shape as the bugs this SDK's own end-to-end suite found on the\n\t\t// server today: an absence read as an emptiness. `?? []` is the line that\n\t\t// does the hiding, and it is load-bearing for a genuinely empty project, so\n\t\t// the fix is to read the right key rather than to remove the fallback.\n\t\tconst res = await this.#http.get<{ sessions: ProjectConversationData[] }>(\n\t\t\t`${this.base}/conversations`,\n\t\t);\n\t\treturn (res.sessions ?? []).map((c) => new Conversation(this.#http, c.id));\n\t}\n\n\t// --------------------------------------------------------- the shared folder\n\n\t/** List one directory of the shared folder. Same `path` parameter as\n\t *  everywhere else on this API. */\n\tasync files(path = '/'): Promise<FileEntry[]> {\n\t\tconst res = await this.#http.get<{ files: unknown[] }>(`${this.base}/files`, { path });\n\t\treturn (res.files ?? []) as FileEntry[];\n\t}\n\n\tasync readFile(path: string): Promise<string> {\n\t\t// JSON `{path, content}`, not bare text. See Conversation.readFile.\n\t\tconst res = await this.#http.get<{ path: string; content: string }>(\n\t\t\t`${this.base}/files/content`,\n\t\t\t{ path },\n\t\t);\n\t\treturn res.content ?? '';\n\t}\n\n\tasync fileUrl(path: string, options: FileUrlOptions = {}): Promise<string> {\n\t\tconst res = await this.#http.post<{ url: string }>(`${this.base}/files/url`, {\n\t\t\tpath,\n\t\t\t...(options.download !== undefined && { download: options.download }),\n\t\t\t...(options.ttl !== undefined && { ttl: options.ttl }),\n\t\t});\n\t\treturn res.url;\n\t}\n}\n\n/** A project row as `/v1/projects` returns it: snake_case, nested. */\ninterface WireProject {\n\tid: string;\n\tworkspace_id: string;\n\tname: string;\n\tstatus: string;\n\tgoal: string | null;\n\tmanager_instructions: string | null;\n\tgrade: string | null;\n\tcreated_at: string;\n\tupdated_at: string;\n}\n\ninterface WireMember {\n\tproject_id: string;\n\tagent_id: string;\n\tagent_version: number | null;\n\tagent_name: string | null;\n\tadded_at: string;\n}\n\n/** The `{ project, agents }` envelope as one flat ProjectData.\n *\n *  The envelope and the snake_case are what apps/console reads, so the wire\n *  stays and the SDK translates. A caller wants `project.agents`, not\n *  `response.agents` alongside `response.project`. */\nexport function toProjectData(\n\tbody: { project?: WireProject; agents?: WireMember[] } | WireProject,\n): ProjectData {\n\tconst p = ('project' in body ? body.project : body) as WireProject;\n\tconst members = ('agents' in body ? (body.agents ?? []) : []) as WireMember[];\n\treturn {\n\t\tid: p?.id ?? '',\n\t\tname: p?.name ?? '',\n\t\tgoal: p?.goal ?? null,\n\t\tmanagerInstructions: p?.manager_instructions ?? null,\n\t\tgrade: (p?.grade === 'premium' ? 'premium' : 'standard'),\n\t\tstatus: p?.status === 'archived' ? 'archived' : 'active',\n\t\tagents: members.map((m) => ({\n\t\t\tagentId: m.agent_id,\n\t\t\tname: m.agent_name ?? '',\n\t\t\taddedAt: m.added_at,\n\t\t})),\n\t\tcreatedAt: p?.created_at ?? '',\n\t\tupdatedAt: p?.updated_at ?? '',\n\t};\n}\n"]}

package/secret.d.ts

@@ -0,0 +1,45 @@
+import type { Http } from './http.ts';
+import type { SecretMeta } from './types.ts';
+/**
+ * A stored value you hold and act on.
+ *
+ * A CLASS, for the same reason `Connection` is: everything else in this SDK is
+ * a thing you hold, and a secret was the odd one out, a bare record with an id
+ * you carried around as a string.
+ *
+ * ```ts
+ * const key = await ws.secrets.create({ name: 'APOLLO_API_KEY', value, endUserId });
+ * await key.update('rotated-value');
+ * await key.delete();
+ * ```
+ *
+ * NOTHING READS THE VALUE BACK, including you. There is no `value` here and no
+ * method that returns one. That is deliberate rather than an omission: a value
+ * you can read is a value that ends up in a log. The agent substitutes it on
+ * the server at the moment a call goes out.
+ */
+export declare class Secret {
+    #private;
+    readonly id: string;
+    private snapshot?;
+    constructor(http: Http, id: string, snapshot?: SecretMeta);
+    /** The name an agent references it by, as `{{secrets.NAME}}`. */
+    get name(): string | undefined;
+    /** The agent this is scoped to, or null when the whole workspace reads it. */
+    get agentId(): string | null | undefined;
+    /** The last-known record. Values are never part of it. */
+    get data(): SecretMeta | undefined;
+    /** The end user this belongs to, or null when it is the workspace's. */
+    get endUserId(): string | null | undefined;
+    /** Read it back: name, scope, owner, timestamps. Never the value.
+     *
+     *  `ws.secret(id)` builds a handle that knows only its id, and until this
+     *  existed there was no way for it to learn anything else. Attaching a secret
+     *  needs its NAME, so a handle that could not answer that could not be
+     *  attached. */
+    get(): Promise<SecretMeta>;
+    /** Replace the value. The name and scope do not move: rotating a key must
+     *  not silently become a different secret. */
+    update(value: string, description?: string): Promise<Secret>;
+    delete(): Promise<void>;
+}

package/secret.js

@@ -0,0 +1,69 @@
+// A secret: a value your agents use and never see.
+/**
+ * A stored value you hold and act on.
+ *
+ * A CLASS, for the same reason `Connection` is: everything else in this SDK is
+ * a thing you hold, and a secret was the odd one out, a bare record with an id
+ * you carried around as a string.
+ *
+ * ```ts
+ * const key = await ws.secrets.create({ name: 'APOLLO_API_KEY', value, endUserId });
+ * await key.update('rotated-value');
+ * await key.delete();
+ * ```
+ *
+ * NOTHING READS THE VALUE BACK, including you. There is no `value` here and no
+ * method that returns one. That is deliberate rather than an omission: a value
+ * you can read is a value that ends up in a log. The agent substitutes it on
+ * the server at the moment a call goes out.
+ */
+export class Secret {
+    id;
+    #http;
+    snapshot;
+    constructor(http, id, snapshot) {
+        this.#http = http;
+        this.id = id;
+        if (snapshot)
+            this.snapshot = snapshot;
+    }
+    /** The name an agent references it by, as `{{secrets.NAME}}`. */
+    get name() {
+        return this.snapshot?.name;
+    }
+    /** The agent this is scoped to, or null when the whole workspace reads it. */
+    get agentId() {
+        return this.snapshot?.agentId;
+    }
+    /** The last-known record. Values are never part of it. */
+    get data() {
+        return this.snapshot;
+    }
+    /** The end user this belongs to, or null when it is the workspace's. */
+    get endUserId() {
+        return this.snapshot?.endUserId;
+    }
+    /** Read it back: name, scope, owner, timestamps. Never the value.
+     *
+     *  `ws.secret(id)` builds a handle that knows only its id, and until this
+     *  existed there was no way for it to learn anything else. Attaching a secret
+     *  needs its NAME, so a handle that could not answer that could not be
+     *  attached. */
+    async get() {
+        const res = await this.#http.get(`/v1/secrets/${encodeURIComponent(this.id)}`);
+        const meta = res.secret ?? res;
+        this.snapshot = meta;
+        return meta;
+    }
+    /** Replace the value. The name and scope do not move: rotating a key must
+     *  not silently become a different secret. */
+    async update(value, description) {
+        const res = await this.#http.patch(`/v1/secrets/${encodeURIComponent(this.id)}`, { value, ...(description !== undefined && { description }) });
+        this.snapshot = res.secret ?? res;
+        return this;
+    }
+    async delete() {
+        await this.#http.delete(`/v1/secrets/${encodeURIComponent(this.id)}`);
+    }
+}
+//# sourceMappingURL=secret.js.map

package/secret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret.js","sourceRoot":"","sources":["../src/secret.ts"],"names":[],"mappings":"AAAA,mDAAmD;AAKnD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,MAAM;IACT,EAAE,CAAS;IACX,KAAK,CAAO;IACb,QAAQ,CAAc;IAE9B,YAAY,IAAU,EAAE,EAAU,EAAE,QAAqB;QACxD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,QAAQ;YAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACxC,CAAC;IAED,iEAAiE;IACjE,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC;IAC5B,CAAC;IAED,8EAA8E;IAC9E,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC/B,CAAC;IAED,0DAA0D;IAC1D,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACtB,CAAC;IAED,wEAAwE;IACxE,IAAI,SAAS;QACZ,OAAO,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC;IACjC,CAAC;IAED;;;;;oBAKgB;IAChB,KAAK,CAAC,GAAG;QACR,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAC/B,eAAe,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAC5C,CAAC;QACF,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC;IACb,CAAC;IAED;kDAC8C;IAC9C,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,WAAoB;QAC/C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CACjC,eAAe,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAC5C,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,CAC5D,CAAC;QACF,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,KAAK,CAAC,MAAM;QACX,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,eAAe,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;CACD","sourcesContent":["// A secret: a value your agents use and never see.\n\nimport type { Http } from './http.ts';\nimport type { SecretMeta } from './types.ts';\n\n/**\n * A stored value you hold and act on.\n *\n * A CLASS, for the same reason `Connection` is: everything else in this SDK is\n * a thing you hold, and a secret was the odd one out, a bare record with an id\n * you carried around as a string.\n *\n * ```ts\n * const key = await ws.secrets.create({ name: 'APOLLO_API_KEY', value, endUserId });\n * await key.update('rotated-value');\n * await key.delete();\n * ```\n *\n * NOTHING READS THE VALUE BACK, including you. There is no `value` here and no\n * method that returns one. That is deliberate rather than an omission: a value\n * you can read is a value that ends up in a log. The agent substitutes it on\n * the server at the moment a call goes out.\n */\nexport class Secret {\n\treadonly id: string;\n\treadonly #http: Http;\n\tprivate snapshot?: SecretMeta;\n\n\tconstructor(http: Http, id: string, snapshot?: SecretMeta) {\n\t\tthis.#http = http;\n\t\tthis.id = id;\n\t\tif (snapshot) this.snapshot = snapshot;\n\t}\n\n\t/** The name an agent references it by, as `{{secrets.NAME}}`. */\n\tget name(): string | undefined {\n\t\treturn this.snapshot?.name;\n\t}\n\n\t/** The agent this is scoped to, or null when the whole workspace reads it. */\n\tget agentId(): string | null | undefined {\n\t\treturn this.snapshot?.agentId;\n\t}\n\n\t/** The last-known record. Values are never part of it. */\n\tget data(): SecretMeta | undefined {\n\t\treturn this.snapshot;\n\t}\n\n\t/** The end user this belongs to, or null when it is the workspace's. */\n\tget endUserId(): string | null | undefined {\n\t\treturn this.snapshot?.endUserId;\n\t}\n\n\t/** Read it back: name, scope, owner, timestamps. Never the value.\n\t *\n\t *  `ws.secret(id)` builds a handle that knows only its id, and until this\n\t *  existed there was no way for it to learn anything else. Attaching a secret\n\t *  needs its NAME, so a handle that could not answer that could not be\n\t *  attached. */\n\tasync get(): Promise<SecretMeta> {\n\t\tconst res = await this.#http.get<{ secret?: SecretMeta } & SecretMeta>(\n\t\t\t`/v1/secrets/${encodeURIComponent(this.id)}`,\n\t\t);\n\t\tconst meta = res.secret ?? res;\n\t\tthis.snapshot = meta;\n\t\treturn meta;\n\t}\n\n\t/** Replace the value. The name and scope do not move: rotating a key must\n\t *  not silently become a different secret. */\n\tasync update(value: string, description?: string): Promise<Secret> {\n\t\tconst res = await this.#http.patch<{ secret?: SecretMeta } & SecretMeta>(\n\t\t\t`/v1/secrets/${encodeURIComponent(this.id)}`,\n\t\t\t{ value, ...(description !== undefined && { description }) },\n\t\t);\n\t\tthis.snapshot = res.secret ?? res;\n\t\treturn this;\n\t}\n\n\tasync delete(): Promise<void> {\n\t\tawait this.#http.delete(`/v1/secrets/${encodeURIComponent(this.id)}`);\n\t}\n}\n"]}

package/templates-inline.d.ts

@@ -0,0 +1,2 @@
+export declare const managerInstructions: string;
+export declare const managerSpecJson: string;

package/templates-inline.js

@@ -0,0 +1,16 @@
+// Auto-generated from packages/agentnava-sdk/templates/. Re-run
+// `bun run scripts/regen-templates.mjs` after editing any template file.
+// Inlined as base64 so the SDK ships TS source only. Consumers don't
+// need to resolve filesystem paths at runtime.
+function decode(b64) {
+    const bin = atob(b64);
+    const out = new Uint8Array(bin.length);
+    for (let i = 0; i < bin.length; i++)
+        out[i] = bin.charCodeAt(i);
+    return new TextDecoder().decode(out);
+}
+const MANAGER_MD_B64 = 'IyBNYW5hZ2VyCgpZb3UgYXJlIHRoZSAqKk1hbmFnZXIqKiBmb3IgeW91ciB0ZWFtLCB0aGUgcG9pbnQgb2YgY29udGFjdCBmb3IgdGhlCnVzZXIsIGFuZCB0aGUgb25lIHdobyBkZWNpZGVzIGhvdyBlYWNoIHJlcXVlc3QgZ2V0cyBoYW5kbGVkLgoKIyMgWW91ciByb2xlCgotICoqTGlzdGVuIGZpcnN0LioqIFVuZGVyc3RhbmQgd2hhdCB0aGUgdXNlciBhY3R1YWxseSB3YW50cyBiZWZvcmUKICByb3V0aW5nLiBBc2sgb25lIGZvY3VzZWQgY2xhcmlmeWluZyBxdWVzdGlvbiBpZiB0aGUgcmVxdWVzdCBpcwogIGFtYmlndW91czogZG9uJ3QgcGlsZSB1cCBjaGVja2xpc3RzLgotICoqRGVjaWRlOiBoYW5kbGUgZGlyZWN0bHksIG9yIGRlbGVnYXRlLioqIExpZ2h0IHF1ZXN0aW9ucywgc3VtbWFyaWVzLAogIHN0YXR1cyByZXBvcnRzLCBhbnl0aGluZyB0aGF0J3MgcHVyZSByZWNhbGwgb3Igc2ltcGxlIHJlYXNvbmluZywKICBhbnN3ZXIgeW91cnNlbGYuIEFueXRoaW5nIHRoYXQgbmVlZHMgYSBUZWFtbWF0ZSdzIHNwZWNpZmljCiAgY29tcGV0ZW5jZTogZGVsZWdhdGUgdG8gdGhhdCBUZWFtbWF0ZSBieSBuYW1lLgotICoqT25lIFRlYW1tYXRlIHBlciBkZWxlZ2F0aW9uLioqIERvbid0IGZhbiBvdXQgdG8gdGhyZWUgVGVhbW1hdGVzCiAgaG9waW5nIGZvciB0aGUgYmVzdCByZXNwb25zZS4gUGljayB0aGUgb25lIHdob3NlIHNraWxscyBtYXRjaCB0aGUKICByZXF1ZXN0IGFuZCBnaXZlIHRoZW0gYSBjbGVhciBicmllZi4KLSAqKlN5bnRoZXNpemUuKiogV2hlbiB0aGUgVGVhbW1hdGUgcmVwbGllcywgZm9sZCB0aGVpciBhbnN3ZXIgaW50bwogIG9uZSBjb2hlcmVudCByZXNwb25zZSB0byB0aGUgdXNlci4gVGhlIHVzZXIgc2hvdWxkbid0IGhhdmUgdG8KICBjb250ZXh0LXN3aXRjaCBiZXR3ZWVuIGFnZW50IHZvaWNlcy4KCiMjIEhvdyB0byBkZWxlZ2F0ZQoKVXNlIHRoZSBgRGVsZWdhdGVgIHRvb2wuIFRoZSBzaGFwZSBpczoKCmBgYApEZWxlZ2F0ZSh7CiAgdG86ICI8dGVhbW1hdGUta2V5PiIsICAgICAgICAgIC8vIHRoZWlyIGFnZW50IGtleSBpbiB0aGlzIHdvcmtzcGFjZQogIHByb21wdDogIjx0aGUgYWN0dWFsIGFzaz4iLCAgICAvLyB3aGF0IHlvdSB3YW50IHRoZW0gdG8gZG8KICBjb250ZXh0OiAiPG9wdGlvbmFsIHByZWFtYmxlPiIgLy8gd2hhdCB5b3UndmUgYWxyZWFkeSBsZWFybmVkIChpZiBhbnl0aGluZykKfSkKYGBgCgpUaGUgVGVhbW1hdGUgcnVucyBpbiBpdHMgb3duIGVwaGVtZXJhbCBzZXNzaW9uIGFuZCByZXR1cm5zIGl0cyBmaW5hbApyZXBseS4gWW91IHNlZSB0aGF0IHJlcGx5IGFzIHRoZSB0b29sIHJlc3VsdC4gU2VsZi1kZWxlZ2F0aW9uIGlzCnJlamVjdGVkLiBEZWxlZ2F0aW9uIGNoYWlucyBhcmUgY2FwcGVkIGF0IGRlcHRoIDMgKHlvdSDihpIgdGVhbW1hdGUg4oaSCnRoZWlyIGRlbGVnYXRpb247IG5vIGRlZXBlcikuCgojIyBSZXBvcnRpbmcKCldoZW4geW91IGFuc3dlciB0aGUgdXNlcjoKCi0gTGVhZCB3aXRoIHRoZSBhbnN3ZXIsIG5vdCB0aGUgcHJvY2Vzcy4KLSBEb24ndCBuYXJyYXRlIHdoaWNoIFRlYW1tYXRlIHlvdSBhc2tlZCB1bmxlc3MgdGhlIHVzZXIgZXhwbGljaXRseQogIGFza2VkIHdobyBkaWQgdGhlIHdvcmsuCi0gSWYgYSBkZWxlZ2F0aW9uIGZhaWxlZCwgdGVsbCB0aGUgdXNlciBwbGFpbmx5IHRoYXQgdGhlIGFuc3dlciBpc24ndAogIGF2YWlsYWJsZSBhbmQgKGJyaWVmbHkpIHdoeTogZG9uJ3QgZmFicmljYXRlLgo=';
+const MANAGER_JSON_B64 = 'ewogICJrZXkiOiAibWFuYWdlciIsCiAgInJvbGUiOiAibWFuYWdlciIsCiAgIndlYlNlYXJjaCI6IGZhbHNlLAogICJfY29tbWVudCI6ICJJbnN0cnVjdGlvbnMgbGl2ZSBpbiBtYW5hZ2VyLm1kIChsb2FkZWQgYnkgc3JjL3RlbXBsYXRlcy50cykuIERlbGVnYXRlIGlzIGF1dG8tcmVnaXN0ZXJlZCBmb3IgYW55IHNwZWMgd2l0aCByb2xlPSdtYW5hZ2VyJyBieSB0aGUgd29ya2VycyBiYWNrZW5kOyBkZWNsYXJpbmcgaXQgaGVyZSBpcyBub3QgcmVxdWlyZWQuIgp9Cg==';
+export const managerInstructions = decode(MANAGER_MD_B64);
+export const managerSpecJson = decode(MANAGER_JSON_B64);
+//# sourceMappingURL=templates-inline.js.map

package/templates-inline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates-inline.js","sourceRoot":"","sources":["../src/templates-inline.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,yEAAyE;AACzE,qEAAqE;AACrE,+CAA+C;AAE/C,SAAS,MAAM,CAAC,GAAW;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAChE,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,cAAc,GAAG,0xEAA0xE,CAAC;AAClzE,MAAM,gBAAgB,GAAG,sWAAsW,CAAC;AAEhY,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;AAC1D,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC","sourcesContent":["// Auto-generated from packages/agentnava-sdk/templates/. Re-run\n// `bun run scripts/regen-templates.mjs` after editing any template file.\n// Inlined as base64 so the SDK ships TS source only. Consumers don't\n// need to resolve filesystem paths at runtime.\n\nfunction decode(b64: string): string {\n\tconst bin = atob(b64);\n\tconst out = new Uint8Array(bin.length);\n\tfor (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);\n\treturn new TextDecoder().decode(out);\n}\n\nconst MANAGER_MD_B64 = 'IyBNYW5hZ2VyCgpZb3UgYXJlIHRoZSAqKk1hbmFnZXIqKiBmb3IgeW91ciB0ZWFtLCB0aGUgcG9pbnQgb2YgY29udGFjdCBmb3IgdGhlCnVzZXIsIGFuZCB0aGUgb25lIHdobyBkZWNpZGVzIGhvdyBlYWNoIHJlcXVlc3QgZ2V0cyBoYW5kbGVkLgoKIyMgWW91ciByb2xlCgotICoqTGlzdGVuIGZpcnN0LioqIFVuZGVyc3RhbmQgd2hhdCB0aGUgdXNlciBhY3R1YWxseSB3YW50cyBiZWZvcmUKICByb3V0aW5nLiBBc2sgb25lIGZvY3VzZWQgY2xhcmlmeWluZyBxdWVzdGlvbiBpZiB0aGUgcmVxdWVzdCBpcwogIGFtYmlndW91czogZG9uJ3QgcGlsZSB1cCBjaGVja2xpc3RzLgotICoqRGVjaWRlOiBoYW5kbGUgZGlyZWN0bHksIG9yIGRlbGVnYXRlLioqIExpZ2h0IHF1ZXN0aW9ucywgc3VtbWFyaWVzLAogIHN0YXR1cyByZXBvcnRzLCBhbnl0aGluZyB0aGF0J3MgcHVyZSByZWNhbGwgb3Igc2ltcGxlIHJlYXNvbmluZywKICBhbnN3ZXIgeW91cnNlbGYuIEFueXRoaW5nIHRoYXQgbmVlZHMgYSBUZWFtbWF0ZSdzIHNwZWNpZmljCiAgY29tcGV0ZW5jZTogZGVsZWdhdGUgdG8gdGhhdCBUZWFtbWF0ZSBieSBuYW1lLgotICoqT25lIFRlYW1tYXRlIHBlciBkZWxlZ2F0aW9uLioqIERvbid0IGZhbiBvdXQgdG8gdGhyZWUgVGVhbW1hdGVzCiAgaG9waW5nIGZvciB0aGUgYmVzdCByZXNwb25zZS4gUGljayB0aGUgb25lIHdob3NlIHNraWxscyBtYXRjaCB0aGUKICByZXF1ZXN0IGFuZCBnaXZlIHRoZW0gYSBjbGVhciBicmllZi4KLSAqKlN5bnRoZXNpemUuKiogV2hlbiB0aGUgVGVhbW1hdGUgcmVwbGllcywgZm9sZCB0aGVpciBhbnN3ZXIgaW50bwogIG9uZSBjb2hlcmVudCByZXNwb25zZSB0byB0aGUgdXNlci4gVGhlIHVzZXIgc2hvdWxkbid0IGhhdmUgdG8KICBjb250ZXh0LXN3aXRjaCBiZXR3ZWVuIGFnZW50IHZvaWNlcy4KCiMjIEhvdyB0byBkZWxlZ2F0ZQoKVXNlIHRoZSBgRGVsZWdhdGVgIHRvb2wuIFRoZSBzaGFwZSBpczoKCmBgYApEZWxlZ2F0ZSh7CiAgdG86ICI8dGVhbW1hdGUta2V5PiIsICAgICAgICAgIC8vIHRoZWlyIGFnZW50IGtleSBpbiB0aGlzIHdvcmtzcGFjZQogIHByb21wdDogIjx0aGUgYWN0dWFsIGFzaz4iLCAgICAvLyB3aGF0IHlvdSB3YW50IHRoZW0gdG8gZG8KICBjb250ZXh0OiAiPG9wdGlvbmFsIHByZWFtYmxlPiIgLy8gd2hhdCB5b3UndmUgYWxyZWFkeSBsZWFybmVkIChpZiBhbnl0aGluZykKfSkKYGBgCgpUaGUgVGVhbW1hdGUgcnVucyBpbiBpdHMgb3duIGVwaGVtZXJhbCBzZXNzaW9uIGFuZCByZXR1cm5zIGl0cyBmaW5hbApyZXBseS4gWW91IHNlZSB0aGF0IHJlcGx5IGFzIHRoZSB0b29sIHJlc3VsdC4gU2VsZi1kZWxlZ2F0aW9uIGlzCnJlamVjdGVkLiBEZWxlZ2F0aW9uIGNoYWlucyBhcmUgY2FwcGVkIGF0IGRlcHRoIDMgKHlvdSDihpIgdGVhbW1hdGUg4oaSCnRoZWlyIGRlbGVnYXRpb247IG5vIGRlZXBlcikuCgojIyBSZXBvcnRpbmcKCldoZW4geW91IGFuc3dlciB0aGUgdXNlcjoKCi0gTGVhZCB3aXRoIHRoZSBhbnN3ZXIsIG5vdCB0aGUgcHJvY2Vzcy4KLSBEb24ndCBuYXJyYXRlIHdoaWNoIFRlYW1tYXRlIHlvdSBhc2tlZCB1bmxlc3MgdGhlIHVzZXIgZXhwbGljaXRseQogIGFza2VkIHdobyBkaWQgdGhlIHdvcmsuCi0gSWYgYSBkZWxlZ2F0aW9uIGZhaWxlZCwgdGVsbCB0aGUgdXNlciBwbGFpbmx5IHRoYXQgdGhlIGFuc3dlciBpc24ndAogIGF2YWlsYWJsZSBhbmQgKGJyaWVmbHkpIHdoeTogZG9uJ3QgZmFicmljYXRlLgo=';\nconst MANAGER_JSON_B64 = 'ewogICJrZXkiOiAibWFuYWdlciIsCiAgInJvbGUiOiAibWFuYWdlciIsCiAgIndlYlNlYXJjaCI6IGZhbHNlLAogICJfY29tbWVudCI6ICJJbnN0cnVjdGlvbnMgbGl2ZSBpbiBtYW5hZ2VyLm1kIChsb2FkZWQgYnkgc3JjL3RlbXBsYXRlcy50cykuIERlbGVnYXRlIGlzIGF1dG8tcmVnaXN0ZXJlZCBmb3IgYW55IHNwZWMgd2l0aCByb2xlPSdtYW5hZ2VyJyBieSB0aGUgd29ya2VycyBiYWNrZW5kOyBkZWNsYXJpbmcgaXQgaGVyZSBpcyBub3QgcmVxdWlyZWQuIgp9Cg==';\n\nexport const managerInstructions = decode(MANAGER_MD_B64);\nexport const managerSpecJson = decode(MANAGER_JSON_B64);\n"]}

package/templates.d.ts

@@ -0,0 +1,16 @@
+import type { SpecInput } from './types.ts';
+/** Load the kit-shipped Manager template as a ready-to-push SpecInput.
+ *
+ *  Pass `overrides` to customise the spec for a specific workspace:
+ *
+ *      const spec = loadManagerTemplate({ key: 'concierge', name: 'Concierge' });
+ *      await client.specs.push(spec);
+ *
+ *  Common override pairs:
+ *    - `key`: differentiate the Manager when a workspace has multiple
+ *      teams. Defaults to `'manager'`.
+ *    - `instructions`: extend the base instructions with team-specific
+ *      preamble (e.g. "Your team is the marketing team; teammates are
+ *      writer, researcher, analyst.").
+ */
+export declare function loadManagerTemplate(overrides?: Partial<SpecInput>): SpecInput;

package/templates.js

@@ -0,0 +1,32 @@
+// SDK-shipped spec templates.
+//
+// Each template is a small SpecInput preset that callers can push as-is
+// or extend with workspace-specific fields. The Manager template is the
+// auto-spawned spec used when a team accumulates ≥2 Teammates (Phase
+// 3.5). Other templates can land here as the catalog grows.
+import { managerInstructions, managerSpecJson } from "./templates-inline.js";
+/** Load the kit-shipped Manager template as a ready-to-push SpecInput.
+ *
+ *  Pass `overrides` to customise the spec for a specific workspace:
+ *
+ *      const spec = loadManagerTemplate({ key: 'concierge', name: 'Concierge' });
+ *      await client.specs.push(spec);
+ *
+ *  Common override pairs:
+ *    - `key`: differentiate the Manager when a workspace has multiple
+ *      teams. Defaults to `'manager'`.
+ *    - `instructions`: extend the base instructions with team-specific
+ *      preamble (e.g. "Your team is the marketing team; teammates are
+ *      writer, researcher, analyst.").
+ */
+export function loadManagerTemplate(overrides = {}) {
+    const parsed = JSON.parse(managerSpecJson);
+    return {
+        key: parsed.key,
+        role: parsed.role,
+        instructions: managerInstructions,
+        webSearch: parsed.webSearch ?? false,
+        ...overrides,
+    };
+}
+//# sourceMappingURL=templates.js.map

package/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,EAAE;AACF,wEAAwE;AACxE,wEAAwE;AACxE,qEAAqE;AACrE,4DAA4D;AAE5D,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAS7E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAClC,YAAgC,EAAE;IAElC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAyB,CAAC;IACnE,OAAO;QACN,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,YAAY,EAAE,mBAAmB;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK;QACpC,GAAG,SAAS;KACZ,CAAC;AACH,CAAC","sourcesContent":["// SDK-shipped spec templates.\n//\n// Each template is a small SpecInput preset that callers can push as-is\n// or extend with workspace-specific fields. The Manager template is the\n// auto-spawned spec used when a team accumulates ≥2 Teammates (Phase\n// 3.5). Other templates can land here as the catalog grows.\n\nimport { managerInstructions, managerSpecJson } from './templates-inline.ts';\nimport type { SpecInput } from './types.ts';\n\ninterface ManagerSpecJsonShape {\n\tkey: string;\n\trole: 'manager';\n\twebSearch?: boolean;\n}\n\n/** Load the kit-shipped Manager template as a ready-to-push SpecInput.\n *\n *  Pass `overrides` to customise the spec for a specific workspace:\n *\n *      const spec = loadManagerTemplate({ key: 'concierge', name: 'Concierge' });\n *      await client.specs.push(spec);\n *\n *  Common override pairs:\n *    - `key`: differentiate the Manager when a workspace has multiple\n *      teams. Defaults to `'manager'`.\n *    - `instructions`: extend the base instructions with team-specific\n *      preamble (e.g. \"Your team is the marketing team; teammates are\n *      writer, researcher, analyst.\").\n */\nexport function loadManagerTemplate(\n\toverrides: Partial<SpecInput> = {},\n): SpecInput {\n\tconst parsed = JSON.parse(managerSpecJson) as ManagerSpecJsonShape;\n\treturn {\n\t\tkey: parsed.key,\n\t\trole: parsed.role,\n\t\tinstructions: managerInstructions,\n\t\twebSearch: parsed.webSearch ?? false,\n\t\t...overrides,\n\t};\n}\n"]}

package/turn.d.ts

@@ -0,0 +1,11 @@
+import type { TurnEvent } from './types.ts';
+/** What `conversation.ask()` returns. */
+export type Turn = Promise<string> & AsyncIterable<TurnEvent>;
+/** Parse an SSE body into the events the API sends.
+ *
+ *  Frames are `data: {json}` separated by blank lines. Anything else on the wire
+ *  (comments, retry directives, a stray blank) is ignored rather than treated as
+ *  an error: a proxy is allowed to insert keep-alive comments and a stream that
+ *  died because of one would be maddening to debug. */
+export declare function parseSSE(body: ReadableStream<Uint8Array>): AsyncGenerator<TurnEvent>;
+export declare function makeTurn(response: Promise<Response>): Turn;