busa-sdk 0.53.0 → 0.60.0

package/dist/airapp.d.ts

@@ -1,4 +1,4 @@
-import { t as BusabaseClient } from "./client-CsSxFhUP.js";
+import { t as BusabaseClient } from "./client-SAiQFoug.js";
 //#region src/airapp.d.ts
 type NodeChangeRequestInput = Parameters<BusabaseClient["nodes"]["createChangeRequest"]>[0];
 type NodeOperationInput = NodeChangeRequestInput["operations"][number];

package/dist/{client-CsSxFhUP.d.ts → client-SAiQFoug.d.ts}

@@ -481,6 +481,17 @@ declare const cloudContract: {
       nodes: "nodes";
       records: "records";
     }>]>, z.ZodTransform<("files" | "names" | "nodes" | "records")[], "files" | "names" | "nodes" | "records" | ("files" | "names" | "nodes" | "records")[]>>>;
+    sort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+      created_asc: "created_asc";
+      created_desc: "created_desc";
+      relevance: "relevance";
+      updated_asc: "updated_asc";
+      updated_desc: "updated_desc";
+    }>>>;
+    updatedAfter: z.ZodOptional<z.ZodString>;
+    updatedBefore: z.ZodOptional<z.ZodString>;
+    createdBy: z.ZodOptional<z.ZodString>;
+    inNodeId: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>, z.ZodObject<{
     query: z.ZodString;
     limit: z.ZodNumber;
@@ -500,6 +511,7 @@ declare const cloudContract: {
       eyebrow: z.ZodString;
       href: z.ZodString;
       updatedAt: z.ZodNullable<z.ZodString>;
+      createdBy: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     }, z.core.$strip>>;
     contentTruncated: z.ZodDefault<z.ZodBoolean>;
   }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
@@ -14948,10 +14960,19 @@ declare const cloudContract: {
           mimeType: z.ZodString;
           filename: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>;
+      }, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+        accepted: z.ZodLiteral<true>;
+        sessionId: z.ZodString;
       }, z.core.$strip>, z.ZodObject<{
-        accepted: z.ZodBoolean;
+        accepted: z.ZodLiteral<false>;
         sessionId: z.ZodString;
-      }, z.core.$strip>, import("@orpc/contract").MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
+        status: z.ZodEnum<{
+          ended: "ended";
+          failed: "failed";
+        }>;
+        promptRecorded: z.ZodBoolean;
+        message: z.ZodString;
+      }, z.core.$strip>], "accepted">, import("@orpc/contract").MergedErrorMap<Record<never, never>, Record<never, never>>, Record<never, never>>;
       cancel: import("@orpc/contract").ContractProcedure<z.ZodObject<{
         sessionId: z.ZodString;
       }, z.core.$strip>, z.ZodObject<{
@@ -25688,6 +25709,8 @@ interface SearchResultVO {
   eyebrow: string;
   href: string;
   updatedAt: string | null;
+  /** Creating actor, or null when the source cannot say. Never render null as a person. */
+  createdBy: string | null;
 }
 interface SearchResponseVO {
   query: string;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as AssetTextStatus, A as NodeVO, At as GalleryCardSize, B as UpdatePreviewFileCredentialDTO, Bt as ViewSortVO, C as CommentVO, Ct as ListFormsDTO, D as MentionInboxItemVO, Dt as AssetAttachmentRef, E as LookupRollup, Et as UpdateFormDTO, F as SearchResponseVO, Ft as VIEW_FIELD_MAX_WIDTH, G as VaultItemKind, Gt as cloudContract, H as VaultAccessPolicy, Ht as ViewVO, I as SearchResultKind, It as VIEW_FIELD_MIN_WIDTH, J as VaultScopeType, Jt as CREATABLE_NODE_TYPES, K as VaultItemVO, Kt as NodeIcon, L as SearchResultVO, Lt as ViewConfigVO, M as OperationVO, Mt as GanttScale, N as ReviewVO, Nt as RecordLinkVO, O as MentionInboxPageVO, Ot as BaseFieldVO, P as ReviewVerdict, Pt as RecordVO, Q as AssetDetailVO, R as SourceAttributionVO, Rt as ViewFilterOperator, S as CommentSubjectType, St as FormVO, T as FieldType, Tt as SubmitFormDTO, U as VaultEnvironment, Ut as AttachmentRef, V as UpdateVaultSettingsDTO, Vt as ViewType, W as VaultItemInput, Wt as CloudContract, X as FileNodeMetadata, Xt as NodeType, Y as VaultSettingsVO, Yt as CreatableNodeType, Z as FileNodeVO, Zt as OperationKind, _ as ChangeRequestVO, _t as FormFieldBindingVO, a as createBusabaseClient, at as FilePreviewConfigurationStatus, b as CommentMentionTargetType, bt as FormSubmitResultVO, c as AuditAction, ct as FilePreviewUnavailableReason, d as ChangeRequestBatchFailureVO, dt as FileTreeNodeVO, et as AssetUsageVO, f as ChangeRequestCountsVO, ft as FileTreeReadFileVO, g as ChangeRequestTargetType, gt as FormBoundFieldVO, h as ChangeRequestStatus, ht as CreateFormDTO, i as ResolvedConfig, it as FilePreviewConfigVO, j as OperationStatus, jt as GalleryCoverFit, k as NodeSearchResultVO, kt as BaseVO, l as AuditEventVO, lt as FilePreviewVO, m as ChangeRequestReviewBatchResultVO, mt as ActivityItemVO, n as BusabaseConfig, nt as GrepInputDTO, o as resolveConfig, ot as FilePreviewCredentialSource, p as ChangeRequestMergeBatchResultVO, pt as NodeDetailVO, q as VaultRuntimeEnv, qt as NodeIconSchema, r as DEFAULT_BASE_URL, rt as GrepResultVO, s as AgentTaskVO, st as FilePreviewProvider, t as BusabaseClient, tt as AssetVO, u as BusabaseSourceChannel, ut as FileTreeFileVO, v as CommentMentionDispatchStatus, vt as FormPageSourceVO, w as CommitVO, wt as ListFormsVO, x as CommentMentionVO, xt as FormThemeVO, y as CommentMentionInputDTO, yt as FormShareVO, z as UserRefVO, zt as ViewFilterVO } from "./client-CsSxFhUP.js";
+import { $ as AssetTextStatus, A as NodeVO, At as GalleryCardSize, B as UpdatePreviewFileCredentialDTO, Bt as ViewSortVO, C as CommentVO, Ct as ListFormsDTO, D as MentionInboxItemVO, Dt as AssetAttachmentRef, E as LookupRollup, Et as UpdateFormDTO, F as SearchResponseVO, Ft as VIEW_FIELD_MAX_WIDTH, G as VaultItemKind, Gt as cloudContract, H as VaultAccessPolicy, Ht as ViewVO, I as SearchResultKind, It as VIEW_FIELD_MIN_WIDTH, J as VaultScopeType, Jt as CREATABLE_NODE_TYPES, K as VaultItemVO, Kt as NodeIcon, L as SearchResultVO, Lt as ViewConfigVO, M as OperationVO, Mt as GanttScale, N as ReviewVO, Nt as RecordLinkVO, O as MentionInboxPageVO, Ot as BaseFieldVO, P as ReviewVerdict, Pt as RecordVO, Q as AssetDetailVO, R as SourceAttributionVO, Rt as ViewFilterOperator, S as CommentSubjectType, St as FormVO, T as FieldType, Tt as SubmitFormDTO, U as VaultEnvironment, Ut as AttachmentRef, V as UpdateVaultSettingsDTO, Vt as ViewType, W as VaultItemInput, Wt as CloudContract, X as FileNodeMetadata, Xt as NodeType, Y as VaultSettingsVO, Yt as CreatableNodeType, Z as FileNodeVO, Zt as OperationKind, _ as ChangeRequestVO, _t as FormFieldBindingVO, a as createBusabaseClient, at as FilePreviewConfigurationStatus, b as CommentMentionTargetType, bt as FormSubmitResultVO, c as AuditAction, ct as FilePreviewUnavailableReason, d as ChangeRequestBatchFailureVO, dt as FileTreeNodeVO, et as AssetUsageVO, f as ChangeRequestCountsVO, ft as FileTreeReadFileVO, g as ChangeRequestTargetType, gt as FormBoundFieldVO, h as ChangeRequestStatus, ht as CreateFormDTO, i as ResolvedConfig, it as FilePreviewConfigVO, j as OperationStatus, jt as GalleryCoverFit, k as NodeSearchResultVO, kt as BaseVO, l as AuditEventVO, lt as FilePreviewVO, m as ChangeRequestReviewBatchResultVO, mt as ActivityItemVO, n as BusabaseConfig, nt as GrepInputDTO, o as resolveConfig, ot as FilePreviewCredentialSource, p as ChangeRequestMergeBatchResultVO, pt as NodeDetailVO, q as VaultRuntimeEnv, qt as NodeIconSchema, r as DEFAULT_BASE_URL, rt as GrepResultVO, s as AgentTaskVO, st as FilePreviewProvider, t as BusabaseClient, tt as AssetVO, u as BusabaseSourceChannel, ut as FileTreeFileVO, v as CommentMentionDispatchStatus, vt as FormPageSourceVO, w as CommitVO, wt as ListFormsVO, x as CommentMentionVO, xt as FormThemeVO, y as CommentMentionInputDTO, yt as FormShareVO, z as UserRefVO, zt as ViewFilterVO } from "./client-SAiQFoug.js";
 import { z } from "zod";
 //#region src/url.d.ts
 /**
@@ -323,6 +323,7 @@ declare class Busabase {
       eyebrow: string;
       href: string;
       updatedAt: string | null;
+      createdBy: string | null;
     }[];
     contentTruncated: boolean;
   }, Error>;

package/dist/index.js

@@ -278,13 +278,20 @@ list: oc.input(ListAgentConnectionsInputSchema).output(AgentConnectionVOSchema.a
 		list: oc.output(AgentSessionVOSchema.array()),
 		create: oc.input(CreateAgentSessionInputSchema).output(AgentSessionVOSchema),
 		/**
-		* Send a message. Returns as soon as the turn is accepted — the reply arrives
-		* on `subscribe`, not here, so a slow agent never blocks the caller.
+		* Send a message. A terminal session returns `accepted: false` instead of
+		* relying on error text; `promptRecorded` tells the caller whether automatic
+		* continuation can resend without duplicating a server echo.
 		*/
-		prompt: oc.input(PromptAgentSessionInputSchema).output(z.object({
-			accepted: z.boolean(),
+		prompt: oc.input(PromptAgentSessionInputSchema).output(z.discriminatedUnion("accepted", [z.object({
+			accepted: z.literal(true),
 			sessionId: z.string()
-		})),
+		}), z.object({
+			accepted: z.literal(false),
+			sessionId: z.string(),
+			status: AgentSessionStatusSchema.extract(["ended", "failed"]),
+			promptRecorded: z.boolean(),
+			message: z.string()
+		})])),
 		cancel: oc.input(AgentSessionIdInputSchema).output(z.object({ ok: z.boolean() })),
 		close: oc.input(AgentSessionIdInputSchema).output(z.object({ ok: z.boolean() })),
 		/**
@@ -1172,17 +1179,17 @@ const NodeIconSchema = z.discriminatedUnion("type", [z.object({
 //#endregion
 //#region ../../packages/busabase-contract/src/contract/node-agent-prompt-schemas.ts
 /**
-* Per-node custom scenario prompts (`node.metadata.agentPrompts`) — the single
+* Per-node custom scenario prompts (`node.agentPrompts`) — the single
 * schema shared by BOTH write and read paths, per the node-agent-prompts
 * design (v2) §7.3:
 *
 * - Write: `busabase-cli nodes set-agent-prompts` validates a file against this
-*   schema client-side, before calling `nodes.updateMetadata` — a malformed file
-*   never reaches the network.
+*   schema client-side, before calling `nodes.updateAgentPrompts` — a malformed
+*   file never reaches the network.
 * - Read: `buildNodeAgentPrompts` (`packages/busabase-core/.../node-agent-prompts.ts`)
-*   `.safeParse`s whatever is stored in `metadata.agentPrompts` and falls back to
-*   the node type's default scenarios on failure, so a bad write (or a manual
-*   jsonb edit) can never crash the Agent Prompts dialog.
+*   `.safeParse`s whatever is stored in the node's `agentPrompts` column and
+*   ignores invalid custom entries, so a bad write (or a manual jsonb edit) can
+*   never crash the Agent Prompts dialog or hide its built-in scenarios.
 *
 * One schema, one place to edit the limits — do not duplicate this validation on
 * either side.
@@ -1232,7 +1239,7 @@ const customPromptDefSchema = z.object({
 	body: customPromptBodySchema
 });
 /**
-* The full `metadata.agentPrompts` array. `.max` bounds the list; the
+* The full `agentPrompts` array. `.max` bounds the list; the
 * `superRefine` catches duplicate keys with an issue path pointing at the
 * offending entry, so a CLI/server validation error names which entry and
 * which key collided instead of a bare "keys must be unique".
@@ -1670,7 +1677,16 @@ const searchResultSchema = z.object({
 	body: z.string(),
 	eyebrow: z.string(),
 	href: z.string(),
-	updatedAt: z.string().nullable()
+	updatedAt: z.string().nullable(),
+	/**
+	* The actor that created this, or null when the source cannot say.
+	*
+	* Present so a result can SHOW its author and so the author filter can be
+	* driven by clicking one — you can only filter by a creator you can actually
+	* see, which beats a free-text box you have to guess the spelling of. Null is
+	* rendered as "unknown", never as a person.
+	*/
+	createdBy: z.string().nullable().default(null)
 });
 const searchResponseSchema = z.object({
 	query: z.string(),
@@ -1910,6 +1926,13 @@ const SEARCH_SOURCES = [
 	"names",
 	"nodes"
 ];
+const SearchSortSchema = z.enum([
+	"relevance",
+	"updated_desc",
+	"updated_asc",
+	"created_desc",
+	"created_asc"
+]);
 const searchInputSchema = z.object({
 	query: z.string().default("").describe("Full-text query. An empty string matches nothing."),
 	limit: z.coerce.number().int().min(1).max(100).optional().default(20).describe("Results per page. Capped at 100; note the default is 20, not 50."),
@@ -1923,7 +1946,43 @@ const searchInputSchema = z.object({
 	* (`?sources=records&sources=files`) becomes an array. Accept both shapes
 	* and normalize to an array.
 	*/
-	sources: z.union([z.array(z.enum(SEARCH_SOURCES)), z.enum(SEARCH_SOURCES)]).transform((value) => Array.isArray(value) ? value : [value]).optional().describe("Restrict which content is searched. Omitting it searches ALL sources. Repeat the parameter to pass several (`?sources=records&sources=files`); a single occurrence is accepted as a bare value.")
+	sources: z.union([z.array(z.enum(SEARCH_SOURCES)), z.enum(SEARCH_SOURCES)]).transform((value) => Array.isArray(value) ? value : [value]).optional().describe("Restrict which content is searched. Omitting it searches ALL sources. Repeat the parameter to pass several (`?sources=records&sources=files`); a single occurrence is accepted as a bare value."),
+	sort: SearchSortSchema.optional().default("relevance").describe("Result order. `relevance` (default) keeps each source's own ranking — for records that is the full-text rank, for everything else most-recently-updated first. The four explicit orders sort every source by the same column so a mixed result set is comparable."),
+	/**
+	* Both bounds are inclusive ISO 8601 instants, and both are optional — one
+	* on its own is an open-ended range, which is what "since last Monday" and
+	* "before the migration" each need.
+	*
+	* Filters the same timestamp `sort` orders by, so "edited this week, newest
+	* first" reads as one coherent question rather than two unrelated knobs.
+	*/
+	updatedAfter: z.string().datetime({ offset: true }).optional().describe("Inclusive lower bound, ISO 8601. A UTC `Z` or an explicit offset; not a bare local time."),
+	updatedBefore: z.string().datetime({ offset: true }).optional().describe("Inclusive upper bound, ISO 8601. A UTC `Z` or an explicit offset; not a bare local time."),
+	/**
+	* Restrict to what one actor created.
+	*
+	* Every source answers from a real column, which is what made this filter
+	* shippable: records and assets carry their own `created_by`, node CONTENT
+	* reads `busabase_nodes.created_by` (added with this change, backfilled from
+	* each node's `node_create` commit), and Bases resolve through the owning
+	* node the Base query already joins for its dates and sort.
+	*
+	* A free-form actor id, not a user id — agents and API keys create things
+	* too, and filtering by "user" would silently drop everything an agent made.
+	*
+	* Nodes whose creating commit is gone have a NULL `created_by` and match no
+	* author. That is deliberate: "this row cannot tell" must not render as
+	* "nobody made it".
+	*/
+	createdBy: z.string().optional().describe("Restrict to one creator. Matches the actor id, which may be an agent or API key."),
+	/**
+	* Restrict to a subtree: this node and everything beneath it.
+	*
+	* Resolved by walking the tree in application code (`collectSubtreeIds`),
+	* the same way `isDescendantOf` and permanent-delete already do — workspace
+	* trees are shallow and this repo has no recursive-CTE precedent.
+	*/
+	inNodeId: z.string().optional().describe("Limit to this node and its descendants.")
 });
 const authSpaceSchema = z.object({
 	id: z.string(),
@@ -5241,14 +5300,14 @@ const busabaseContractRoutes = {
 			path: "/nodes/{nodeId}/agent-prompts",
 			tags: ["Nodes"],
 			summary: "Get node custom agent prompts",
-			successDescription: "This node's custom scenario prompts, which replace the node type's default prompts in the Ask-agent dialog. `null` means the node has never had any set, which is not the same as an empty list. Read separately from the node itself because the list is large enough (50 prompts x 8 KiB per locale) that carrying it on every node listing would be its own problem. Requires read access on the node."
+			successDescription: "This node's custom scenario prompts, which appear alongside the node type's built-in prompts in the Ask-agent dialog. `null` means the node has never had any set, which is not the same as an empty list. Read separately from the node itself because the list is large enough (50 prompts x 8 KiB per locale) that carrying it on every node listing would be its own problem. Requires read access on the node."
 		}).input(getNodeAgentPromptsInputSchema).output(nodeAgentPromptsSchema),
 		updateAgentPrompts: oc.route({
 			method: "PUT",
 			path: "/nodes/{nodeId}/agent-prompts",
 			tags: ["Nodes"],
 			summary: "Replace node custom agent prompts",
-			successDescription: "Replaced this node's custom scenario prompts — the whole list, not a merge. Send `null` to clear them and return the node to its type's default prompts. Requires write access on the node."
+			successDescription: "Replaced this node's custom scenario prompts — the whole custom list, not a merge. Send `null` to clear custom prompts; built-in prompts are always retained. Requires write access on the node."
 		}).input(updateNodeAgentPromptsInputSchema).output(nodeAgentPromptsSchema),
 		updateContent: oc.route({
 			method: "PUT",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "busa-sdk",
-  "version": "0.53.0",
+  "version": "0.60.0",
   "description": "Typed TypeScript/JavaScript SDK for the Busabase OpenAPI REST API. Talks to a local or remote `busabase server` (or Busabase Cloud). Short-name alias for busabase-sdk.",
   "license": "MIT",
   "homepage": "https://github.com/busabase/busabase/tree/main/apps/busabase-sdk",