@nikolasp98/minion 2026.6.16-dev.20260703022951 → 2026.7.2-dev

package/dist/booking-create-tool-DoK1URaw.js

@@ -0,0 +1,50 @@
+import { t as wrapToolWithTracking } from "./tool-tracking-CtkaABAd.js";
+import { i as jsonResult, s as readStringParam } from "./common-mPQVYX41.js";
+import { a as hubToolsAvailable, i as hubPost, n as ORG_ID_FIELD, t as CONFIRM_FIELD } from "./hub-common-BXMO3y1A.js";
+import { Type } from "typebox";
+//#region src/agents/tools/hub/booking-create-tool.ts
+const BookingCreateSchema = Type.Object({
+	eventTypeId: Type.String({ description: "Which scheduling event type/service to book (required)." }),
+	start: Type.String({ description: "ISO 8601 start time, e.g. 2026-07-10T15:00:00-05:00." }),
+	crmContactId: Type.Optional(Type.String({ description: "CRM contact id, if the attendee is a known contact." })),
+	attendeeName: Type.Optional(Type.String({ description: "Attendee name, required if crmContactId is not known." })),
+	attendeeEmail: Type.Optional(Type.String({ description: "Attendee email address." })),
+	attendeePhone: Type.Optional(Type.String({ description: "Attendee phone number." })),
+	resourceId: Type.Optional(Type.String({ description: "Specific resource/staff id to book, if not left to auto-assign." })),
+	notes: Type.Optional(Type.String({ description: "Free-text booking notes." })),
+	confirm: CONFIRM_FIELD,
+	orgId: ORG_ID_FIELD
+});
+/**
+* Create a scheduling booking. WRITE — confirm contract: call with
+* confirm=false first to get a preview of what would be created; only call
+* with confirm=true after the user has explicitly agreed to the exact
+* booking (attendee, time, service).
+*/
+function createBookingCreateTool(options) {
+	const agentId = options.agentId;
+	if (!hubToolsAvailable(agentId)) return null;
+	return wrapToolWithTracking({
+		label: "Booking Create",
+		name: "booking_create",
+		description: "Create a new appointment/booking. First present the exact action (attendee, service, start time) to the user and ask for confirmation. Call with confirm=false to get a validated preview (no write); only call with confirm=true after the user explicitly agrees. On success, present the result with a deep link like [booking](/scheduling/bookings?contact={contactId}).",
+		parameters: BookingCreateSchema,
+		execute: async (_toolCallId, args) => {
+			const params = args;
+			const orgId = readStringParam(params, "orgId");
+			return jsonResult(await hubPost("actions/booking-create", agentId, {
+				eventTypeId: readStringParam(params, "eventTypeId", { required: true }),
+				start: readStringParam(params, "start", { required: true }),
+				crmContactId: readStringParam(params, "crmContactId"),
+				attendeeName: readStringParam(params, "attendeeName"),
+				attendeeEmail: readStringParam(params, "attendeeEmail"),
+				attendeePhone: readStringParam(params, "attendeePhone"),
+				resourceId: readStringParam(params, "resourceId"),
+				notes: readStringParam(params, "notes"),
+				confirm: params.confirm === true
+			}, orgId));
+		}
+	}, "builtin:booking_create");
+}
+//#endregion
+export { createBookingCreateTool };

package/dist/booking-reschedule-tool-BBRT8BeA.js

@@ -0,0 +1,54 @@
+import { t as wrapToolWithTracking } from "./tool-tracking-4XjaoCwP.js";
+import { i as jsonResult, s as readStringParam } from "./common-BHzo6lXS.js";
+import { a as hubToolsAvailable, i as hubPost, n as ORG_ID_FIELD, t as CONFIRM_FIELD } from "./hub-common-D7t3vbq1.js";
+import { Type } from "typebox";
+//#region src/agents/tools/hub/booking-reschedule-tool.ts
+const BookingRescheduleSchema = Type.Object({
+	bookingId: Type.String({ description: "The booking to reschedule (will be cancelled)." }),
+	eventTypeId: Type.String({ description: "Event type/service for the new slot (required)." }),
+	start: Type.String({ description: "New ISO 8601 start time, e.g. 2026-07-10T15:00:00-05:00." }),
+	crmContactId: Type.Optional(Type.String({ description: "CRM contact id, if the attendee is a known contact." })),
+	attendeeName: Type.Optional(Type.String({ description: "Attendee name, required if crmContactId is not known." })),
+	attendeeEmail: Type.Optional(Type.String({ description: "Attendee email address." })),
+	attendeePhone: Type.Optional(Type.String({ description: "Attendee phone number." })),
+	resourceId: Type.Optional(Type.String({ description: "Specific resource/staff id to book, if not left to auto-assign." })),
+	notes: Type.Optional(Type.String({ description: "Free-text booking notes for the new slot." })),
+	confirm: CONFIRM_FIELD,
+	orgId: ORG_ID_FIELD
+});
+/**
+* Reschedule an existing booking. The hub implements this as cancel-old +
+* create-new (no atomic "move" service call exists), so this tool must send
+* the FULL new-slot payload — same shape as booking_create — plus the
+* bookingId being cancelled. WRITE — confirm contract: confirm=false returns
+* a preview (cancels + new start), confirm=true only after the user
+* explicitly agrees.
+*/
+function createBookingRescheduleTool(options) {
+	const agentId = options.agentId;
+	if (!hubToolsAvailable(agentId)) return null;
+	return wrapToolWithTracking({
+		label: "Booking Reschedule",
+		name: "booking_reschedule",
+		description: "Move an existing booking to a new time. Under the hood the hub cancels the old booking and creates a new one, so this needs the full new-slot details (event type, start time, attendee), not just a new time. First present the exact change (which booking, old time → new time) and ask for confirmation. Call with confirm=false for a validated preview (no write); only call with confirm=true after the user explicitly agrees. Present the result with a deep link like [booking](/scheduling/bookings?contact={contactId}).",
+		parameters: BookingRescheduleSchema,
+		execute: async (_toolCallId, args) => {
+			const params = args;
+			const orgId = readStringParam(params, "orgId");
+			return jsonResult(await hubPost("actions/booking-reschedule", agentId, {
+				bookingId: readStringParam(params, "bookingId", { required: true }),
+				eventTypeId: readStringParam(params, "eventTypeId", { required: true }),
+				start: readStringParam(params, "start", { required: true }),
+				crmContactId: readStringParam(params, "crmContactId"),
+				attendeeName: readStringParam(params, "attendeeName"),
+				attendeeEmail: readStringParam(params, "attendeeEmail"),
+				attendeePhone: readStringParam(params, "attendeePhone"),
+				resourceId: readStringParam(params, "resourceId"),
+				notes: readStringParam(params, "notes"),
+				confirm: params.confirm === true
+			}, orgId));
+		}
+	}, "builtin:booking_reschedule");
+}
+//#endregion
+export { createBookingRescheduleTool };

package/dist/booking-reschedule-tool-BbCUsgsS.js

@@ -0,0 +1,54 @@
+import { t as wrapToolWithTracking } from "./tool-tracking-Crsmwdkj.js";
+import { i as jsonResult, s as readStringParam } from "./common-CRD8HhuP.js";
+import { a as hubToolsAvailable, i as hubPost, n as ORG_ID_FIELD, t as CONFIRM_FIELD } from "./hub-common-D7t3vbq1.js";
+import { Type } from "typebox";
+//#region src/agents/tools/hub/booking-reschedule-tool.ts
+const BookingRescheduleSchema = Type.Object({
+	bookingId: Type.String({ description: "The booking to reschedule (will be cancelled)." }),
+	eventTypeId: Type.String({ description: "Event type/service for the new slot (required)." }),
+	start: Type.String({ description: "New ISO 8601 start time, e.g. 2026-07-10T15:00:00-05:00." }),
+	crmContactId: Type.Optional(Type.String({ description: "CRM contact id, if the attendee is a known contact." })),
+	attendeeName: Type.Optional(Type.String({ description: "Attendee name, required if crmContactId is not known." })),
+	attendeeEmail: Type.Optional(Type.String({ description: "Attendee email address." })),
+	attendeePhone: Type.Optional(Type.String({ description: "Attendee phone number." })),
+	resourceId: Type.Optional(Type.String({ description: "Specific resource/staff id to book, if not left to auto-assign." })),
+	notes: Type.Optional(Type.String({ description: "Free-text booking notes for the new slot." })),
+	confirm: CONFIRM_FIELD,
+	orgId: ORG_ID_FIELD
+});
+/**
+* Reschedule an existing booking. The hub implements this as cancel-old +
+* create-new (no atomic "move" service call exists), so this tool must send
+* the FULL new-slot payload — same shape as booking_create — plus the
+* bookingId being cancelled. WRITE — confirm contract: confirm=false returns
+* a preview (cancels + new start), confirm=true only after the user
+* explicitly agrees.
+*/
+function createBookingRescheduleTool(options) {
+	const agentId = options.agentId;
+	if (!hubToolsAvailable(agentId)) return null;
+	return wrapToolWithTracking({
+		label: "Booking Reschedule",
+		name: "booking_reschedule",
+		description: "Move an existing booking to a new time. Under the hood the hub cancels the old booking and creates a new one, so this needs the full new-slot details (event type, start time, attendee), not just a new time. First present the exact change (which booking, old time → new time) and ask for confirmation. Call with confirm=false for a validated preview (no write); only call with confirm=true after the user explicitly agrees. Present the result with a deep link like [booking](/scheduling/bookings?contact={contactId}).",
+		parameters: BookingRescheduleSchema,
+		execute: async (_toolCallId, args) => {
+			const params = args;
+			const orgId = readStringParam(params, "orgId");
+			return jsonResult(await hubPost("actions/booking-reschedule", agentId, {
+				bookingId: readStringParam(params, "bookingId", { required: true }),
+				eventTypeId: readStringParam(params, "eventTypeId", { required: true }),
+				start: readStringParam(params, "start", { required: true }),
+				crmContactId: readStringParam(params, "crmContactId"),
+				attendeeName: readStringParam(params, "attendeeName"),
+				attendeeEmail: readStringParam(params, "attendeeEmail"),
+				attendeePhone: readStringParam(params, "attendeePhone"),
+				resourceId: readStringParam(params, "resourceId"),
+				notes: readStringParam(params, "notes"),
+				confirm: params.confirm === true
+			}, orgId));
+		}
+	}, "builtin:booking_reschedule");
+}
+//#endregion
+export { createBookingRescheduleTool };

package/dist/booking-reschedule-tool-szF6zAV5.js

@@ -0,0 +1,54 @@
+import { t as wrapToolWithTracking } from "./tool-tracking-CtkaABAd.js";
+import { i as jsonResult, s as readStringParam } from "./common-mPQVYX41.js";
+import { a as hubToolsAvailable, i as hubPost, n as ORG_ID_FIELD, t as CONFIRM_FIELD } from "./hub-common-BXMO3y1A.js";
+import { Type } from "typebox";
+//#region src/agents/tools/hub/booking-reschedule-tool.ts
+const BookingRescheduleSchema = Type.Object({
+	bookingId: Type.String({ description: "The booking to reschedule (will be cancelled)." }),
+	eventTypeId: Type.String({ description: "Event type/service for the new slot (required)." }),
+	start: Type.String({ description: "New ISO 8601 start time, e.g. 2026-07-10T15:00:00-05:00." }),
+	crmContactId: Type.Optional(Type.String({ description: "CRM contact id, if the attendee is a known contact." })),
+	attendeeName: Type.Optional(Type.String({ description: "Attendee name, required if crmContactId is not known." })),
+	attendeeEmail: Type.Optional(Type.String({ description: "Attendee email address." })),
+	attendeePhone: Type.Optional(Type.String({ description: "Attendee phone number." })),
+	resourceId: Type.Optional(Type.String({ description: "Specific resource/staff id to book, if not left to auto-assign." })),
+	notes: Type.Optional(Type.String({ description: "Free-text booking notes for the new slot." })),
+	confirm: CONFIRM_FIELD,
+	orgId: ORG_ID_FIELD
+});
+/**
+* Reschedule an existing booking. The hub implements this as cancel-old +
+* create-new (no atomic "move" service call exists), so this tool must send
+* the FULL new-slot payload — same shape as booking_create — plus the
+* bookingId being cancelled. WRITE — confirm contract: confirm=false returns
+* a preview (cancels + new start), confirm=true only after the user
+* explicitly agrees.
+*/
+function createBookingRescheduleTool(options) {
+	const agentId = options.agentId;
+	if (!hubToolsAvailable(agentId)) return null;
+	return wrapToolWithTracking({
+		label: "Booking Reschedule",
+		name: "booking_reschedule",
+		description: "Move an existing booking to a new time. Under the hood the hub cancels the old booking and creates a new one, so this needs the full new-slot details (event type, start time, attendee), not just a new time. First present the exact change (which booking, old time → new time) and ask for confirmation. Call with confirm=false for a validated preview (no write); only call with confirm=true after the user explicitly agrees. Present the result with a deep link like [booking](/scheduling/bookings?contact={contactId}).",
+		parameters: BookingRescheduleSchema,
+		execute: async (_toolCallId, args) => {
+			const params = args;
+			const orgId = readStringParam(params, "orgId");
+			return jsonResult(await hubPost("actions/booking-reschedule", agentId, {
+				bookingId: readStringParam(params, "bookingId", { required: true }),
+				eventTypeId: readStringParam(params, "eventTypeId", { required: true }),
+				start: readStringParam(params, "start", { required: true }),
+				crmContactId: readStringParam(params, "crmContactId"),
+				attendeeName: readStringParam(params, "attendeeName"),
+				attendeeEmail: readStringParam(params, "attendeeEmail"),
+				attendeePhone: readStringParam(params, "attendeePhone"),
+				resourceId: readStringParam(params, "resourceId"),
+				notes: readStringParam(params, "notes"),
+				confirm: params.confirm === true
+			}, orgId));
+		}
+	}, "builtin:booking_reschedule");
+}
+//#endregion
+export { createBookingRescheduleTool };

package/dist/bookings-query-tool-BeUjMBd7.js

@@ -0,0 +1,39 @@
+import { t as wrapToolWithTracking } from "./tool-tracking-Crsmwdkj.js";
+import { i as jsonResult, s as readStringParam } from "./common-CRD8HhuP.js";
+import { a as hubToolsAvailable, n as ORG_ID_FIELD, r as hubGet } from "./hub-common-D7t3vbq1.js";
+import { Type } from "typebox";
+//#region src/agents/tools/hub/bookings-query-tool.ts
+const BookingsQuerySchema = Type.Object({
+	status: Type.Optional(Type.String({ description: "Comma-separated booking status filter, e.g. 'accepted,pending'. Valid values: accepted | pending | cancelled | rejected | completed | no_show. Omit for all statuses." })),
+	contactId: Type.Optional(Type.String({ description: "Filter to one CRM contact's bookings." })),
+	dateFrom: Type.Optional(Type.String({ description: "ISO date/time, inclusive lower bound on start time." })),
+	dateTo: Type.Optional(Type.String({ description: "ISO date/time, inclusive upper bound on start time." })),
+	orgId: ORG_ID_FIELD
+});
+/**
+* Scheduling module read: upcoming/past bookings, optionally filtered by
+* contact or date range. Calls the hub's /api/gateway/query/bookings with
+* the session's personal agent id (org + membership resolved server-side).
+*/
+function createBookingsQueryTool(options) {
+	const agentId = options.agentId;
+	if (!hubToolsAvailable(agentId)) return null;
+	return wrapToolWithTracking({
+		label: "Bookings Query",
+		name: "bookings_query",
+		description: "List appointments/bookings — upcoming, past, or a date range, optionally filtered to one contact. Use for 'what's on the schedule today', 'when is X's next appointment'. To create/change/cancel a booking use booking_create/booking_reschedule/booking_cancel. Present results with a deep link like [bookings](/scheduling/bookings) or, for one contact, [bookings](/scheduling/bookings?contact={contactId}).",
+		parameters: BookingsQuerySchema,
+		execute: async (_toolCallId, args) => {
+			const params = args;
+			return jsonResult(await hubGet("query/bookings", agentId, {
+				status: readStringParam(params, "status"),
+				contact: readStringParam(params, "contactId"),
+				from: readStringParam(params, "dateFrom"),
+				to: readStringParam(params, "dateTo"),
+				orgId: readStringParam(params, "orgId")
+			}));
+		}
+	}, "builtin:bookings_query");
+}
+//#endregion
+export { createBookingsQueryTool };

package/dist/bookings-query-tool-C82uomRU.js

@@ -0,0 +1,39 @@
+import { t as wrapToolWithTracking } from "./tool-tracking-CtkaABAd.js";
+import { i as jsonResult, s as readStringParam } from "./common-mPQVYX41.js";
+import { a as hubToolsAvailable, n as ORG_ID_FIELD, r as hubGet } from "./hub-common-BXMO3y1A.js";
+import { Type } from "typebox";
+//#region src/agents/tools/hub/bookings-query-tool.ts
+const BookingsQuerySchema = Type.Object({
+	status: Type.Optional(Type.String({ description: "Comma-separated booking status filter, e.g. 'accepted,pending'. Valid values: accepted | pending | cancelled | rejected | completed | no_show. Omit for all statuses." })),
+	contactId: Type.Optional(Type.String({ description: "Filter to one CRM contact's bookings." })),
+	dateFrom: Type.Optional(Type.String({ description: "ISO date/time, inclusive lower bound on start time." })),
+	dateTo: Type.Optional(Type.String({ description: "ISO date/time, inclusive upper bound on start time." })),
+	orgId: ORG_ID_FIELD
+});
+/**
+* Scheduling module read: upcoming/past bookings, optionally filtered by
+* contact or date range. Calls the hub's /api/gateway/query/bookings with
+* the session's personal agent id (org + membership resolved server-side).
+*/
+function createBookingsQueryTool(options) {
+	const agentId = options.agentId;
+	if (!hubToolsAvailable(agentId)) return null;
+	return wrapToolWithTracking({
+		label: "Bookings Query",
+		name: "bookings_query",
+		description: "List appointments/bookings — upcoming, past, or a date range, optionally filtered to one contact. Use for 'what's on the schedule today', 'when is X's next appointment'. To create/change/cancel a booking use booking_create/booking_reschedule/booking_cancel. Present results with a deep link like [bookings](/scheduling/bookings) or, for one contact, [bookings](/scheduling/bookings?contact={contactId}).",
+		parameters: BookingsQuerySchema,
+		execute: async (_toolCallId, args) => {
+			const params = args;
+			return jsonResult(await hubGet("query/bookings", agentId, {
+				status: readStringParam(params, "status"),
+				contact: readStringParam(params, "contactId"),
+				from: readStringParam(params, "dateFrom"),
+				to: readStringParam(params, "dateTo"),
+				orgId: readStringParam(params, "orgId")
+			}));
+		}
+	}, "builtin:bookings_query");
+}
+//#endregion
+export { createBookingsQueryTool };

package/dist/bookings-query-tool-CKBaEz6v.js

@@ -0,0 +1,39 @@
+import { t as wrapToolWithTracking } from "./tool-tracking-4XjaoCwP.js";
+import { i as jsonResult, s as readStringParam } from "./common-BHzo6lXS.js";
+import { a as hubToolsAvailable, n as ORG_ID_FIELD, r as hubGet } from "./hub-common-D7t3vbq1.js";
+import { Type } from "typebox";
+//#region src/agents/tools/hub/bookings-query-tool.ts
+const BookingsQuerySchema = Type.Object({
+	status: Type.Optional(Type.String({ description: "Comma-separated booking status filter, e.g. 'accepted,pending'. Valid values: accepted | pending | cancelled | rejected | completed | no_show. Omit for all statuses." })),
+	contactId: Type.Optional(Type.String({ description: "Filter to one CRM contact's bookings." })),
+	dateFrom: Type.Optional(Type.String({ description: "ISO date/time, inclusive lower bound on start time." })),
+	dateTo: Type.Optional(Type.String({ description: "ISO date/time, inclusive upper bound on start time." })),
+	orgId: ORG_ID_FIELD
+});
+/**
+* Scheduling module read: upcoming/past bookings, optionally filtered by
+* contact or date range. Calls the hub's /api/gateway/query/bookings with
+* the session's personal agent id (org + membership resolved server-side).
+*/
+function createBookingsQueryTool(options) {
+	const agentId = options.agentId;
+	if (!hubToolsAvailable(agentId)) return null;
+	return wrapToolWithTracking({
+		label: "Bookings Query",
+		name: "bookings_query",
+		description: "List appointments/bookings — upcoming, past, or a date range, optionally filtered to one contact. Use for 'what's on the schedule today', 'when is X's next appointment'. To create/change/cancel a booking use booking_create/booking_reschedule/booking_cancel. Present results with a deep link like [bookings](/scheduling/bookings) or, for one contact, [bookings](/scheduling/bookings?contact={contactId}).",
+		parameters: BookingsQuerySchema,
+		execute: async (_toolCallId, args) => {
+			const params = args;
+			return jsonResult(await hubGet("query/bookings", agentId, {
+				status: readStringParam(params, "status"),
+				contact: readStringParam(params, "contactId"),
+				from: readStringParam(params, "dateFrom"),
+				to: readStringParam(params, "dateTo"),
+				orgId: readStringParam(params, "orgId")
+			}));
+		}
+	}, "builtin:bookings_query");
+}
+//#endregion
+export { createBookingsQueryTool };

package/dist/brain-remember-tool-5GpyMh2L.js

@@ -0,0 +1,54 @@
+import { t as wrapToolWithTracking } from "./tool-tracking-4XjaoCwP.js";
+import { i as jsonResult, s as readStringParam } from "./common-BHzo6lXS.js";
+import { a as hubToolsAvailable, i as hubPost, n as ORG_ID_FIELD, t as CONFIRM_FIELD } from "./hub-common-D7t3vbq1.js";
+import { Type } from "typebox";
+//#region src/agents/tools/hub/brain-remember-tool.ts
+const BrainRememberSchema = Type.Object({
+	brainId: Type.String({ description: "Brain to write to. If unknown, call brains_list first — do not guess." }),
+	title: Type.String({ description: "Short title for the note document." }),
+	contentMd: Type.String({ description: "Note body, markdown." }),
+	confirm: CONFIRM_FIELD,
+	orgId: ORG_ID_FIELD
+});
+/**
+* Knowledge-brain module write: add a `note` document to a brain.
+* WRITE — confirm contract: confirm=false returns a preview, confirm=true
+* only after the user explicitly agrees.
+*
+* The hub's /api/gateway/brain-remember endpoint is a plain, idempotent-per-
+* call write with no confirm/preview support of its own (by design — see the
+* hub handler's docstring), so the preview gate is enforced here rather than
+* forwarded like the other write tools.
+*/
+function createBrainRememberTool(options) {
+	const agentId = options.agentId;
+	if (!hubToolsAvailable(agentId)) return null;
+	return wrapToolWithTracking({
+		label: "Brain Remember",
+		name: "brain_remember",
+		description: "Save a note into a knowledge brain. First present the exact action (brain, title, content) and ask for confirmation. Call with confirm=false for a preview (no write); only call with confirm=true after the user explicitly agrees. If you don't already know the brainId, call brains_list first.",
+		parameters: BrainRememberSchema,
+		execute: async (_toolCallId, args) => {
+			const params = args;
+			const brainId = readStringParam(params, "brainId", { required: true });
+			const title = readStringParam(params, "title", { required: true });
+			const contentMd = readStringParam(params, "contentMd", { required: true });
+			const orgId = readStringParam(params, "orgId");
+			if (params.confirm !== true) return jsonResult({
+				preview: {
+					brainId,
+					title,
+					contentMd
+				},
+				note: "Preview only — not written. Call again with confirm=true after the user agrees."
+			});
+			return jsonResult(await hubPost("brain-remember", agentId, {
+				brainId,
+				title,
+				contentMd
+			}, orgId));
+		}
+	}, "builtin:brain_remember");
+}
+//#endregion
+export { createBrainRememberTool };

package/dist/brain-remember-tool-C0NYC-xc.js

@@ -0,0 +1,54 @@
+import { t as wrapToolWithTracking } from "./tool-tracking-Crsmwdkj.js";
+import { i as jsonResult, s as readStringParam } from "./common-CRD8HhuP.js";
+import { a as hubToolsAvailable, i as hubPost, n as ORG_ID_FIELD, t as CONFIRM_FIELD } from "./hub-common-D7t3vbq1.js";
+import { Type } from "typebox";
+//#region src/agents/tools/hub/brain-remember-tool.ts
+const BrainRememberSchema = Type.Object({
+	brainId: Type.String({ description: "Brain to write to. If unknown, call brains_list first — do not guess." }),
+	title: Type.String({ description: "Short title for the note document." }),
+	contentMd: Type.String({ description: "Note body, markdown." }),
+	confirm: CONFIRM_FIELD,
+	orgId: ORG_ID_FIELD
+});
+/**
+* Knowledge-brain module write: add a `note` document to a brain.
+* WRITE — confirm contract: confirm=false returns a preview, confirm=true
+* only after the user explicitly agrees.
+*
+* The hub's /api/gateway/brain-remember endpoint is a plain, idempotent-per-
+* call write with no confirm/preview support of its own (by design — see the
+* hub handler's docstring), so the preview gate is enforced here rather than
+* forwarded like the other write tools.
+*/
+function createBrainRememberTool(options) {
+	const agentId = options.agentId;
+	if (!hubToolsAvailable(agentId)) return null;
+	return wrapToolWithTracking({
+		label: "Brain Remember",
+		name: "brain_remember",
+		description: "Save a note into a knowledge brain. First present the exact action (brain, title, content) and ask for confirmation. Call with confirm=false for a preview (no write); only call with confirm=true after the user explicitly agrees. If you don't already know the brainId, call brains_list first.",
+		parameters: BrainRememberSchema,
+		execute: async (_toolCallId, args) => {
+			const params = args;
+			const brainId = readStringParam(params, "brainId", { required: true });
+			const title = readStringParam(params, "title", { required: true });
+			const contentMd = readStringParam(params, "contentMd", { required: true });
+			const orgId = readStringParam(params, "orgId");
+			if (params.confirm !== true) return jsonResult({
+				preview: {
+					brainId,
+					title,
+					contentMd
+				},
+				note: "Preview only — not written. Call again with confirm=true after the user agrees."
+			});
+			return jsonResult(await hubPost("brain-remember", agentId, {
+				brainId,
+				title,
+				contentMd
+			}, orgId));
+		}
+	}, "builtin:brain_remember");
+}
+//#endregion
+export { createBrainRememberTool };

package/dist/brain-remember-tool-C6nzb0DB.js

@@ -0,0 +1,54 @@
+import { t as wrapToolWithTracking } from "./tool-tracking-CtkaABAd.js";
+import { i as jsonResult, s as readStringParam } from "./common-mPQVYX41.js";
+import { a as hubToolsAvailable, i as hubPost, n as ORG_ID_FIELD, t as CONFIRM_FIELD } from "./hub-common-BXMO3y1A.js";
+import { Type } from "typebox";
+//#region src/agents/tools/hub/brain-remember-tool.ts
+const BrainRememberSchema = Type.Object({
+	brainId: Type.String({ description: "Brain to write to. If unknown, call brains_list first — do not guess." }),
+	title: Type.String({ description: "Short title for the note document." }),
+	contentMd: Type.String({ description: "Note body, markdown." }),
+	confirm: CONFIRM_FIELD,
+	orgId: ORG_ID_FIELD
+});
+/**
+* Knowledge-brain module write: add a `note` document to a brain.
+* WRITE — confirm contract: confirm=false returns a preview, confirm=true
+* only after the user explicitly agrees.
+*
+* The hub's /api/gateway/brain-remember endpoint is a plain, idempotent-per-
+* call write with no confirm/preview support of its own (by design — see the
+* hub handler's docstring), so the preview gate is enforced here rather than
+* forwarded like the other write tools.
+*/
+function createBrainRememberTool(options) {
+	const agentId = options.agentId;
+	if (!hubToolsAvailable(agentId)) return null;
+	return wrapToolWithTracking({
+		label: "Brain Remember",
+		name: "brain_remember",
+		description: "Save a note into a knowledge brain. First present the exact action (brain, title, content) and ask for confirmation. Call with confirm=false for a preview (no write); only call with confirm=true after the user explicitly agrees. If you don't already know the brainId, call brains_list first.",
+		parameters: BrainRememberSchema,
+		execute: async (_toolCallId, args) => {
+			const params = args;
+			const brainId = readStringParam(params, "brainId", { required: true });
+			const title = readStringParam(params, "title", { required: true });
+			const contentMd = readStringParam(params, "contentMd", { required: true });
+			const orgId = readStringParam(params, "orgId");
+			if (params.confirm !== true) return jsonResult({
+				preview: {
+					brainId,
+					title,
+					contentMd
+				},
+				note: "Preview only — not written. Call again with confirm=true after the user agrees."
+			});
+			return jsonResult(await hubPost("brain-remember", agentId, {
+				brainId,
+				title,
+				contentMd
+			}, orgId));
+		}
+	}, "builtin:brain_remember");
+}
+//#endregion
+export { createBrainRememberTool };

package/dist/brain-search-tool-CISjpiVH.js

@@ -0,0 +1,37 @@
+import { t as wrapToolWithTracking } from "./tool-tracking-CtkaABAd.js";
+import { a as readNumberParam, i as jsonResult, s as readStringParam } from "./common-mPQVYX41.js";
+import { a as hubToolsAvailable, i as hubPost, n as ORG_ID_FIELD } from "./hub-common-BXMO3y1A.js";
+import { Type } from "typebox";
+//#region src/agents/tools/hub/brain-search-tool.ts
+const BrainSearchSchema = Type.Object({
+	brainId: Type.String({ description: "Brain to search. If unknown, call brains_list first — do not guess." }),
+	query: Type.String({ description: "Natural-language search query." }),
+	limit: Type.Optional(Type.Number({ description: "Max hits to return. Hub default applies." })),
+	orgId: ORG_ID_FIELD
+});
+/**
+* Knowledge-brain module read: semantic search over one brain's chunks.
+* Calls the hub's /api/gateway/brain-search with the session's personal
+* agent id; per-brain access is enforced again on the hub (fail-closed).
+*/
+function createBrainSearchTool(options) {
+	const agentId = options.agentId;
+	if (!hubToolsAvailable(agentId)) return null;
+	return wrapToolWithTracking({
+		label: "Brain Search",
+		name: "brain_search",
+		description: "Semantic search over one knowledge brain's documents. Requires brainId — if you're not sure which brain to target, call brains_list first rather than guessing. Use for 'what does the X brain say about...' style questions.",
+		parameters: BrainSearchSchema,
+		execute: async (_toolCallId, args) => {
+			const params = args;
+			const orgId = readStringParam(params, "orgId");
+			return jsonResult(await hubPost("brain-search", agentId, {
+				brainId: readStringParam(params, "brainId", { required: true }),
+				query: readStringParam(params, "query", { required: true }),
+				limit: readNumberParam(params, "limit")
+			}, orgId));
+		}
+	}, "builtin:brain_search");
+}
+//#endregion
+export { createBrainSearchTool };

package/dist/brain-search-tool-CroWlajo.js

@@ -0,0 +1,37 @@
+import { t as wrapToolWithTracking } from "./tool-tracking-Crsmwdkj.js";
+import { a as readNumberParam, i as jsonResult, s as readStringParam } from "./common-CRD8HhuP.js";
+import { a as hubToolsAvailable, i as hubPost, n as ORG_ID_FIELD } from "./hub-common-D7t3vbq1.js";
+import { Type } from "typebox";
+//#region src/agents/tools/hub/brain-search-tool.ts
+const BrainSearchSchema = Type.Object({
+	brainId: Type.String({ description: "Brain to search. If unknown, call brains_list first — do not guess." }),
+	query: Type.String({ description: "Natural-language search query." }),
+	limit: Type.Optional(Type.Number({ description: "Max hits to return. Hub default applies." })),
+	orgId: ORG_ID_FIELD
+});
+/**
+* Knowledge-brain module read: semantic search over one brain's chunks.
+* Calls the hub's /api/gateway/brain-search with the session's personal
+* agent id; per-brain access is enforced again on the hub (fail-closed).
+*/
+function createBrainSearchTool(options) {
+	const agentId = options.agentId;
+	if (!hubToolsAvailable(agentId)) return null;
+	return wrapToolWithTracking({
+		label: "Brain Search",
+		name: "brain_search",
+		description: "Semantic search over one knowledge brain's documents. Requires brainId — if you're not sure which brain to target, call brains_list first rather than guessing. Use for 'what does the X brain say about...' style questions.",
+		parameters: BrainSearchSchema,
+		execute: async (_toolCallId, args) => {
+			const params = args;
+			const orgId = readStringParam(params, "orgId");
+			return jsonResult(await hubPost("brain-search", agentId, {
+				brainId: readStringParam(params, "brainId", { required: true }),
+				query: readStringParam(params, "query", { required: true }),
+				limit: readNumberParam(params, "limit")
+			}, orgId));
+		}
+	}, "builtin:brain_search");
+}
+//#endregion
+export { createBrainSearchTool };

package/dist/brain-search-tool-D8benSIw.js

@@ -0,0 +1,37 @@
+import { t as wrapToolWithTracking } from "./tool-tracking-4XjaoCwP.js";
+import { a as readNumberParam, i as jsonResult, s as readStringParam } from "./common-BHzo6lXS.js";
+import { a as hubToolsAvailable, i as hubPost, n as ORG_ID_FIELD } from "./hub-common-D7t3vbq1.js";
+import { Type } from "typebox";
+//#region src/agents/tools/hub/brain-search-tool.ts
+const BrainSearchSchema = Type.Object({
+	brainId: Type.String({ description: "Brain to search. If unknown, call brains_list first — do not guess." }),
+	query: Type.String({ description: "Natural-language search query." }),
+	limit: Type.Optional(Type.Number({ description: "Max hits to return. Hub default applies." })),
+	orgId: ORG_ID_FIELD
+});
+/**
+* Knowledge-brain module read: semantic search over one brain's chunks.
+* Calls the hub's /api/gateway/brain-search with the session's personal
+* agent id; per-brain access is enforced again on the hub (fail-closed).
+*/
+function createBrainSearchTool(options) {
+	const agentId = options.agentId;
+	if (!hubToolsAvailable(agentId)) return null;
+	return wrapToolWithTracking({
+		label: "Brain Search",
+		name: "brain_search",
+		description: "Semantic search over one knowledge brain's documents. Requires brainId — if you're not sure which brain to target, call brains_list first rather than guessing. Use for 'what does the X brain say about...' style questions.",
+		parameters: BrainSearchSchema,
+		execute: async (_toolCallId, args) => {
+			const params = args;
+			const orgId = readStringParam(params, "orgId");
+			return jsonResult(await hubPost("brain-search", agentId, {
+				brainId: readStringParam(params, "brainId", { required: true }),
+				query: readStringParam(params, "query", { required: true }),
+				limit: readNumberParam(params, "limit")
+			}, orgId));
+		}
+	}, "builtin:brain_search");
+}
+//#endregion
+export { createBrainSearchTool };

package/dist/brains-list-tool-CgKa84V3.js

@@ -0,0 +1,27 @@
+import { t as wrapToolWithTracking } from "./tool-tracking-Crsmwdkj.js";
+import { i as jsonResult, s as readStringParam } from "./common-CRD8HhuP.js";
+import { a as hubToolsAvailable, n as ORG_ID_FIELD, r as hubGet } from "./hub-common-D7t3vbq1.js";
+import { Type } from "typebox";
+//#region src/agents/tools/hub/brains-list-tool.ts
+const BrainsListSchema = Type.Object({ orgId: ORG_ID_FIELD });
+/**
+* Knowledge-brain module read: list the brains the calling agent's owner can
+* access. Calls the hub's /api/gateway/brains with the session's personal
+* agent id. Call this before brain_search/brain_remember whenever the target
+* brainId isn't already known.
+*/
+function createBrainsListTool(options) {
+	const agentId = options.agentId;
+	if (!hubToolsAvailable(agentId)) return null;
+	return wrapToolWithTracking({
+		label: "Brains List",
+		name: "brains_list",
+		description: "List the knowledge brains available to the current user (id, name, access). Call this first whenever you don't already know which brainId to target for brain_search or brain_remember — do not guess a brainId.",
+		parameters: BrainsListSchema,
+		execute: async (_toolCallId, args) => {
+			return jsonResult(await hubGet("brains", agentId, { orgId: readStringParam(args, "orgId") }));
+		}
+	}, "builtin:brains_list");
+}
+//#endregion
+export { createBrainsListTool };