showrunner-agent-staging 0.2.2-staging.1274 → 0.2.3-staging.1276

package/dist/src/adapter-runner.js

@@ -131,6 +131,9 @@ 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);
     }

package/dist/src/adapter.d.ts

@@ -1,4 +1,4 @@
-import type { ContextFolders } from "./protocol.js";
+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 = {
@@ -115,6 +115,7 @@ 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: {

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

@@ -18,6 +18,10 @@ 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>>;
@@ -191,7 +195,7 @@ export declare const agentToolSchemas: {
 };
 export type AgentToolName = keyof typeof agentToolSchemas;
 export declare const agentToolDefinitions: {
-    name: "read_thread" | "read_recent" | "search_workspace" | "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_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>>;
@@ -203,6 +207,9 @@ 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>>;

package/dist/src/client.d.ts

@@ -1,4 +1,4 @@
-import type { ContextFolders } from "./protocol.js";
+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";
@@ -203,6 +203,7 @@ export declare class ExternalAgentClient {
         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,4 +1,4 @@
-import { contextFoldersSchema } from "./protocol.js";
+import { contextFoldersSchema, contextFolderContentsSchema } from "./protocol.js";
 import * as signalR from "@microsoft/signalr";
 import { z } from "zod";
 import { resolveAdapterModels } from "./adapter.js";
@@ -360,6 +360,26 @@ export class ExternalAgentClient {
         }
         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,10 @@ 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>>;

package/dist/src/context-tools.js

@@ -12,6 +12,10 @@ 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."),
@@ -34,6 +38,8 @@ 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":
@@ -49,6 +55,7 @@ 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";
@@ -69,6 +76,7 @@ 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;
     }
@@ -86,6 +94,7 @@ 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}`;
@@ -105,6 +114,10 @@ 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));

package/dist/src/protocol.d.ts

@@ -666,4 +666,15 @@ export declare const contextFoldersSchema: z.ZodObject<{
     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

@@ -370,3 +370,13 @@ export const contextFoldersSchema = z.object({
     })),
     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.2-staging.1274",
+  "version": "0.2.3-staging.1276",
   "description": "Provider-neutral connector SDK for Showrunner agents",
   "type": "module",
   "main": "dist/src/index.js",