showrunner-agent-staging 0.2.3-staging.1280 → 0.2.4-staging.1282

package/dist/src/adapter-runner.js

@@ -134,6 +134,9 @@ class InvocationAdapterClient {
     listFolderContents(folderId, cursor) {
         return this.#client.listFolderContents(this.#event.invocation.id, folderId, cursor);
     }
+    listNotes(cursor) {
+        return this.#client.listNotes(this.#event.invocation.id, cursor);
+    }
     listFolders(streamId, cursor) {
         return this.#client.listFolders(this.#event.invocation.id, streamId, cursor);
     }

package/dist/src/adapter.d.ts

@@ -1,4 +1,4 @@
-import type { ContextFolders, ContextFolderContents } from "./protocol.js";
+import type { ContextNotes, ContextFolders, ContextFolderContents } from "./protocol.js";
 import type { ActivityOutcome, ActivityType, AgentEvent, AgentInputResponse, ApprovalDecision, ApprovalRiskLevel, CommandResponse, ContextAsset, ContextPage, FileDownloadLink, OutputMessagePiece, QuestionSelectionType } from "./protocol.js";
 import type { Note, TextAttachment } from "./protocol.js";
 export type ContextPageOptions = {
@@ -116,6 +116,7 @@ export interface AdapterClient {
     readRecentContext(options: ContextPageOptions): Promise<ContextPage>;
     searchContext(query: string, options: ContextPageOptions): Promise<ContextPage>;
     listFolderContents(folderId: string, cursor?: string | null): Promise<ContextFolderContents>;
+    listNotes(cursor?: string | null): Promise<ContextNotes>;
     listFolders(streamId?: string, cursor?: string | null): Promise<ContextFolders>;
     readAsset(assetId: string): Promise<ContextAsset>;
     uploadFile(input: {

package/dist/src/agent-tools.d.ts

@@ -22,6 +22,9 @@ export declare const agentToolSchemas: {
         folderId: z.ZodString;
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>;
+    readonly list_notes: z.ZodObject<{
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
     readonly list_folders: z.ZodObject<{
         streamId: z.ZodOptional<z.ZodString>;
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -195,7 +198,7 @@ export declare const agentToolSchemas: {
 };
 export type AgentToolName = keyof typeof agentToolSchemas;
 export declare const agentToolDefinitions: {
-    name: "read_thread" | "read_recent" | "search_workspace" | "list_folder_contents" | "list_folders" | "read_asset" | "upload_file" | "read_note" | "create_note" | "update_note" | "create_task" | "update_task" | "update_task_schedule" | "complete_task";
+    name: "read_thread" | "read_recent" | "search_workspace" | "list_folder_contents" | "list_notes" | "list_folders" | "read_asset" | "upload_file" | "read_note" | "create_note" | "update_note" | "create_task" | "update_task" | "update_task_schedule" | "complete_task";
     description: string;
     inputSchema: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -210,6 +213,8 @@ export declare const agentToolDefinitions: {
     }, z.core.$strip> | z.ZodObject<{
         folderId: z.ZodString;
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip> | z.ZodObject<{
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip> | z.ZodObject<{
         streamId: z.ZodOptional<z.ZodString>;
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/src/client.d.ts

@@ -1,4 +1,4 @@
-import type { ContextFolders, ContextFolderContents } from "./protocol.js";
+import type { ContextNotes, ContextFolders, ContextFolderContents } from "./protocol.js";
 import * as signalR from "@microsoft/signalr";
 import type { AgentEventHandler } from "./handler.js";
 import type { AgentModelOption, HostToolCapability, HostToolGrantKey } from "./adapter.js";
@@ -202,6 +202,7 @@ export declare class ExternalAgentClient {
         cursor?: string | null;
         limit?: number;
     }): Promise<ContextPage>;
+    listNotes(invocationId: string, cursor?: string | null): Promise<ContextNotes>;
     listFolders(invocationId: string, streamId?: string, cursor?: string | null): Promise<ContextFolders>;
     listFolderContents(invocationId: string, folderId: string, cursor?: string | null): Promise<ContextFolderContents>;
     readAsset(invocationId: string, assetId: string): Promise<ContextAsset>;

package/dist/src/client.js

@@ -1,4 +1,4 @@
-import { contextFoldersSchema, contextFolderContentsSchema } from "./protocol.js";
+import { contextNotesSchema, contextFoldersSchema, contextFolderContentsSchema } from "./protocol.js";
 import * as signalR from "@microsoft/signalr";
 import { z } from "zod";
 import { resolveAdapterModels } from "./adapter.js";
@@ -337,6 +337,26 @@ export class ExternalAgentClient {
             q: query,
         });
     }
+    async listNotes(invocationId, cursor) {
+        const params = new URLSearchParams();
+        if (cursor != null) {
+            params.set("cursor", cursor);
+        }
+        const token = await this.accessToken();
+        const response = await this.#fetch(`${this.#apiBaseUrl}/api/external-agent-gateway/v1/invocations/${invocationId}/context/notes?${params.toString()}`, {
+            method: "GET",
+            headers: {
+                Authorization: `Bearer ${token}`,
+                "X-Showrunner-Connector-Version": this.#connectorVersion,
+                "X-Showrunner-Protocol": "1.0",
+            },
+            signal: AbortSignal.timeout(30_000),
+        });
+        if (!response.ok) {
+            throw new ExternalAgentError(`http_${response.status}`, "Connector note request failed.", response.status);
+        }
+        return contextNotesSchema.parse(await response.json());
+    }
     async listFolders(invocationId, streamId, cursor) {
         const params = new URLSearchParams();
         if (streamId !== undefined) {

package/dist/src/context-tools.d.ts

@@ -18,6 +18,9 @@ export declare const contextToolSchemas: {
         folderId: z.ZodString;
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>;
+    readonly list_notes: z.ZodObject<{
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>;
     readonly list_folders: z.ZodObject<{
         streamId: z.ZodOptional<z.ZodString>;
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/src/context-tools.js

@@ -16,6 +16,7 @@ export const contextToolSchemas = {
         folderId: uuidSchema.describe("Folder ID returned by list_folders."),
         cursor: uuidSchema.nullable().optional().describe("nextCursor from the previous contents page."),
     }),
+    list_notes: z.object({ cursor: uuidSchema.nullable().optional().describe("nextCursor from the previous notes page.") }),
     list_folders: z.object({
         streamId: uuidSchema.optional().describe("A reachable chat ID. Omit for this conversation."),
         cursor: uuidSchema.nullable().optional().describe("nextCursor from the previous folder page."),
@@ -40,6 +41,8 @@ export function contextToolDescription(name) {
                 + "Every result carries a messageId you can cite back as a message_reference pill.";
         case "list_folder_contents":
             return "List direct subfolders, files and links in a reachable folder. itemType: 0 folder, 1 file, 2 link. Use folder IDs to navigate, asset IDs with read_asset. Pass nextCursor to continue. Does not list notes or tasks.";
+        case "list_notes":
+            return "List readable notes referenced in this conversation, plus notes this agent created here. Returns IDs, source chat, title and version; use read_note for bodies. Does not discover unreferenced workspace notes. Pass nextCursor to continue.";
         case "list_folders":
             return "List folders in a reachable chat with IDs, names, parent IDs and file counts. Pass nextCursor to continue.";
         case "read_asset":
@@ -56,6 +59,7 @@ export function contextToolEffect(name, input) {
             return `Search workspace messages for ${query}`;
         }
         case "list_folder_contents": return "List contents of a reachable folder";
+        case "list_notes": return "List notes readable from this conversation";
         case "list_folders": return "List folders in a reachable chat";
         case "read_asset": {
             const id = typeof input.assetId === "string" ? input.assetId : "by id";
@@ -73,6 +77,7 @@ export function contextReadIsWithinGrant(name, scope) {
         return true;
     }
     switch (name) {
+        case "list_notes": return scope.canReadNotes;
         case "read_thread": return scope.canReadThreadHistory;
         case "read_recent": return scope.canReadRecentMessages;
         case "search_workspace": return scope.canSearch;
@@ -94,6 +99,7 @@ export function contextToolApprovalBody(name, scope) {
             return `Read messages in ${target}`;
         case "search_workspace":
             return `Search messages in ${target}`;
+        case "list_notes": return `List readable notes in ${target}`;
         case "list_folder_contents":
         case "list_folders": return `Read folders accessible from ${target}`;
         case "read_asset":
@@ -118,6 +124,10 @@ export async function executeContextTool(context, name, untrusted) {
             const input = contextToolSchemas.list_folder_contents.parse(untrusted);
             return toolSuccess(await context.client.listFolderContents(input.folderId, input.cursor));
         }
+        if (name === "list_notes") {
+            const input = contextToolSchemas.list_notes.parse(untrusted);
+            return toolSuccess(await context.client.listNotes(input.cursor));
+        }
         if (name === "list_folders") {
             const input = contextToolSchemas.list_folders.parse(untrusted);
             return toolSuccess(await context.client.listFolders(input.streamId, input.cursor));

package/dist/src/protocol.d.ts

@@ -677,4 +677,14 @@ export declare const contextFolderContentsSchema: z.ZodObject<{
     nextCursor: z.ZodNullable<z.ZodString>;
 }, z.core.$strip>;
 export type ContextFolderContents = z.infer<typeof contextFolderContentsSchema>;
+export declare const contextNotesSchema: z.ZodObject<{
+    notes: z.ZodArray<z.ZodObject<{
+        noteId: z.ZodString;
+        streamId: z.ZodString;
+        title: z.ZodNullable<z.ZodString>;
+        version: z.ZodNumber;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ContextNotes = z.infer<typeof contextNotesSchema>;
 export {};

package/dist/src/protocol.js

@@ -380,3 +380,7 @@ export const contextFolderContentsSchema = z.object({
     })),
     nextCursor: z.string().uuid().nullable(),
 });
+export const contextNotesSchema = z.object({
+    notes: z.array(z.object({ noteId: z.string().uuid(), streamId: z.string().uuid(), title: z.string().nullable(), version: z.number().int() })),
+    nextCursor: z.string().uuid().nullable(),
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "showrunner-agent-staging",
-  "version": "0.2.3-staging.1280",
+  "version": "0.2.4-staging.1282",
   "description": "Provider-neutral connector SDK for Showrunner agents",
   "type": "module",
   "main": "dist/src/index.js",