showrunner-agent-staging 0.2.1-staging.1273 → 0.2.3-staging.1275

package/dist/src/adapter-runner.js

@@ -131,6 +131,12 @@ class InvocationAdapterClient {
     searchContext(query, options) {
         return this.#client.search(this.#event.invocation.id, query, options);
     }
+    listFolderContents(folderId, cursor) {
+        return this.#client.listFolderContents(this.#event.invocation.id, folderId, cursor);
+    }
+    listFolders(streamId, cursor) {
+        return this.#client.listFolders(this.#event.invocation.id, streamId, cursor);
+    }
     readAsset(assetId) {
         return this.#client.readAsset(this.#event.invocation.id, assetId);
     }

package/dist/src/adapter.d.ts

@@ -1,3 +1,4 @@
+import type { 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 = {
@@ -114,6 +115,8 @@ export interface AdapterClient {
     readThreadContext(options: ContextPageOptions): Promise<ContextPage>;
     readRecentContext(options: ContextPageOptions): Promise<ContextPage>;
     searchContext(query: string, options: ContextPageOptions): Promise<ContextPage>;
+    listFolderContents(folderId: string, cursor?: string | null): Promise<ContextFolderContents>;
+    listFolders(streamId?: string, cursor?: string | null): Promise<ContextFolders>;
     readAsset(assetId: string): Promise<ContextAsset>;
     uploadFile(input: {
         fileName: string;

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

@@ -18,6 +18,14 @@ export declare const agentToolSchemas: {
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         limit: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
+    readonly list_folder_contents: z.ZodObject<{
+        folderId: z.ZodString;
+        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>>;
+    }, z.core.$strip>;
     readonly read_asset: z.ZodObject<{
         assetId: z.ZodString;
     }, z.core.$strip>;
@@ -187,7 +195,7 @@ export declare const agentToolSchemas: {
 };
 export type AgentToolName = keyof typeof agentToolSchemas;
 export declare const agentToolDefinitions: {
-    name: "read_thread" | "read_recent" | "search_workspace" | "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_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>>;
@@ -199,6 +207,12 @@ export declare const agentToolDefinitions: {
         query: z.ZodString;
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip> | z.ZodObject<{
+        folderId: z.ZodString;
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip> | z.ZodObject<{
+        streamId: z.ZodOptional<z.ZodString>;
+        cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip> | z.ZodObject<{
         assetId: z.ZodString;
     }, z.core.$strip> | z.ZodObject<{

package/dist/src/client.d.ts

@@ -1,3 +1,4 @@
+import type { 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";
@@ -201,6 +202,8 @@ export declare class ExternalAgentClient {
         cursor?: string | null;
         limit?: number;
     }): Promise<ContextPage>;
+    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>;
     readNote(invocationId: string, noteId: string, input: {
         commandId: string;

package/dist/src/client.js

@@ -1,3 +1,4 @@
+import { contextFoldersSchema, contextFolderContentsSchema } from "./protocol.js";
 import * as signalR from "@microsoft/signalr";
 import { z } from "zod";
 import { resolveAdapterModels } from "./adapter.js";
@@ -336,6 +337,49 @@ export class ExternalAgentClient {
             q: query,
         });
     }
+    async listFolders(invocationId, streamId, cursor) {
+        const params = new URLSearchParams();
+        if (streamId !== undefined) {
+            params.set("streamId", streamId);
+        }
+        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/folders?${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 folder request failed.", response.status);
+        }
+        return contextFoldersSchema.parse(await response.json());
+    }
+    async listFolderContents(invocationId, folderId, 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/folders/${folderId}?${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 folder request failed.", response.status);
+        }
+        return contextFolderContentsSchema.parse(await response.json());
+    }
     async readAsset(invocationId, assetId) {
         const token = await this.accessToken();
         const response = await this.#fetch(`${this.#apiBaseUrl}/api/external-agent-gateway/v1/invocations/${invocationId}/context/assets/${assetId}`, {

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

@@ -14,6 +14,14 @@ export declare const contextToolSchemas: {
         cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         limit: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
+    readonly list_folder_contents: z.ZodObject<{
+        folderId: z.ZodString;
+        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>>;
+    }, z.core.$strip>;
     readonly read_asset: z.ZodObject<{
         assetId: z.ZodString;
     }, z.core.$strip>;

package/dist/src/context-tools.js

@@ -12,6 +12,14 @@ export const contextToolSchemas = {
         cursor: cursorSchema,
         limit: limitSchema,
     }),
+    list_folder_contents: z.object({
+        folderId: uuidSchema.describe("Folder ID returned by list_folders."),
+        cursor: uuidSchema.nullable().optional().describe("nextCursor from the previous contents 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."),
+    }),
     read_asset: z.object({
         assetId: uuidSchema.describe("UUID of a file, image, video, or voice note referenced in context."),
     }),
@@ -30,6 +38,10 @@ export function contextToolDescription(name) {
             return "Search the messages you can read for keywords. Reach for this the moment a question refers to "
                 + "something older than what you were handed — do not answer \"I don't have that\" without searching first. "
                 + "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_folders":
+            return "List folders in a reachable chat with IDs, names, parent IDs and file counts. Pass nextCursor to continue.";
         case "read_asset":
             return "Read one file's metadata: display name, mime type, size, duration for audio/video, and its folder. "
                 + "Use it before commenting on a media asset so your timestamps and ranges are real.";
@@ -43,6 +55,8 @@ export function contextToolEffect(name, input) {
             const query = typeof input.query === "string" ? input.query.slice(0, 120) : "";
             return `Search workspace messages for ${query}`;
         }
+        case "list_folder_contents": return "List contents of a reachable folder";
+        case "list_folders": return "List folders in a reachable chat";
         case "read_asset": {
             const id = typeof input.assetId === "string" ? input.assetId : "by id";
             return `Read file metadata for ${id}`;
@@ -62,6 +76,8 @@ export function contextReadIsWithinGrant(name, scope) {
         case "read_thread": return scope.canReadThreadHistory;
         case "read_recent": return scope.canReadRecentMessages;
         case "search_workspace": return scope.canSearch;
+        case "list_folder_contents":
+        case "list_folders":
         case "read_asset": return scope.canReadFiles;
     }
 }
@@ -78,6 +94,8 @@ export function contextToolApprovalBody(name, scope) {
             return `Read messages in ${target}`;
         case "search_workspace":
             return `Search messages in ${target}`;
+        case "list_folder_contents":
+        case "list_folders": return `Read folders accessible from ${target}`;
         case "read_asset":
             return `Read file details in ${target}`;
     }
@@ -96,6 +114,14 @@ export async function executeContextTool(context, name, untrusted) {
             const input = contextToolSchemas.search_workspace.parse(untrusted);
             return toolSuccess(toModelPage(await context.client.searchContext(input.query, pageOptions(input))));
         }
+        if (name === "list_folder_contents") {
+            const input = contextToolSchemas.list_folder_contents.parse(untrusted);
+            return toolSuccess(await context.client.listFolderContents(input.folderId, input.cursor));
+        }
+        if (name === "list_folders") {
+            const input = contextToolSchemas.list_folders.parse(untrusted);
+            return toolSuccess(await context.client.listFolders(input.streamId, input.cursor));
+        }
         const input = contextToolSchemas.read_asset.parse(untrusted);
         return toolSuccess(toModelAsset(await context.client.readAsset(input.assetId)));
     }

package/dist/src/protocol.d.ts

@@ -655,4 +655,26 @@ export declare const registerConnectorResultSchema: z.ZodUnion<readonly [z.ZodOb
 }, z.core.$strip>]>;
 export type DeliveryRejectionReason = z.infer<typeof deliveryRejectionReasonSchema>;
 export type RegisteredConnector = z.infer<typeof registeredConnectorSchema>;
+export declare const contextFoldersSchema: z.ZodObject<{
+    folders: z.ZodArray<z.ZodObject<{
+        folderId: z.ZodString;
+        streamId: z.ZodString;
+        displayName: z.ZodString;
+        parentFolderId: z.ZodNullable<z.ZodString>;
+        assetCount: z.ZodNumber;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ContextFolders = z.infer<typeof contextFoldersSchema>;
+export declare const contextFolderContentsSchema: z.ZodObject<{
+    folderId: z.ZodString;
+    streamId: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        itemType: z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>, z.ZodLiteral<2>]>;
+    }, z.core.$strip>>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ContextFolderContents = z.infer<typeof contextFolderContentsSchema>;
 export {};

package/dist/src/protocol.js

@@ -360,3 +360,23 @@ export const registerConnectorResultSchema = z.union([
     z.object({ ok: z.literal(true) }).and(registeredConnectorSchema),
     z.object({ ok: z.literal(false), error: connectorErrorSchema }),
 ]);
+export const contextFoldersSchema = z.object({
+    folders: z.array(z.object({
+        folderId: z.string().uuid(),
+        streamId: z.string().uuid(),
+        displayName: z.string(),
+        parentFolderId: z.string().uuid().nullable(),
+        assetCount: z.number().int().nonnegative(),
+    })),
+    nextCursor: z.string().uuid().nullable(),
+});
+export const contextFolderContentsSchema = z.object({
+    folderId: z.string().uuid(),
+    streamId: z.string().uuid(),
+    items: z.array(z.object({
+        id: z.string().uuid(),
+        displayName: z.string(),
+        itemType: z.union([z.literal(0), z.literal(1), z.literal(2)]),
+    })),
+    nextCursor: z.string().uuid().nullable(),
+});

package/package.json

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