@tulip-systems/ai 0.11.0

package/dist/agents/lib/definitions.server.mjs

@@ -0,0 +1,14 @@
+import "server-cli-only";
+import { ToolLoopAgent } from "ai";
+
+//#region src/agents/lib/definitions.server.ts
+/**
+* Creates an AI SDK tool-loop agent with Tulip's package-level entrypoint.
+* This keeps applications from importing the underlying agent implementation directly.
+*/
+function createAgent(settings) {
+	return new ToolLoopAgent(settings);
+}
+
+//#endregion
+export { createAgent };

package/dist/agents/lib/delegation.server.d.mts

@@ -0,0 +1,15 @@
+import { ToolContext, TulipToolDefinition } from "../../tools/lib/types.mjs";
+import { DelegateToAgentToolOptions } from "./types.mjs";
+import "../../tools/server.mjs";
+import "server-cli-only";
+
+//#region src/agents/lib/delegation.server.d.ts
+/**
+ * Defines a Tulip tool that delegates work to another agent and returns its result.
+ * Resolve the returned definition with `resolveAgentTool()` before passing it to an agent.
+ */
+declare function delegateToAgentTool<const TName extends string, TInput extends Record<string, unknown>, TOutput = {
+  summary: string;
+}, TContext extends ToolContext = ToolContext>(options: DelegateToAgentToolOptions<TName, TInput, TOutput, TContext>): TulipToolDefinition<TName, TInput, TOutput, TContext>;
+//#endregion
+export { delegateToAgentTool };

package/dist/agents/lib/delegation.server.mjs

@@ -0,0 +1,28 @@
+import { defineTool } from "../../tools/lib/definitions.mjs";
+import "server-cli-only";
+
+//#region src/agents/lib/delegation.server.ts
+/**
+* Defines a Tulip tool that delegates work to another agent and returns its result.
+* Resolve the returned definition with `resolveAgentTool()` before passing it to an agent.
+*/
+function delegateToAgentTool(options) {
+	return defineTool({
+		name: options.name,
+		title: options.title,
+		description: options.description,
+		inputSchema: options.inputSchema,
+		outputSchema: options.outputSchema,
+		contextSchema: options.contextSchema,
+		async execute(input, { abortSignal }) {
+			const result = await options.agent.generate({
+				prompt: options.prompt ? options.prompt(input) : String(input.task ?? ""),
+				abortSignal
+			});
+			return options.output ? options.output(result, input) : { summary: result.text };
+		}
+	});
+}
+
+//#endregion
+export { delegateToAgentTool };

package/dist/agents/lib/instructions.server.d.mts

@@ -0,0 +1,14 @@
+import "server-cli-only";
+
+//#region src/agents/lib/instructions.server.d.ts
+type LoadAgentInstructionsOptions = {
+  path?: string;
+};
+/**
+ * Loads an agent's always-on instructions from a file next to the agent module.
+ * Pass `import.meta.url` from the agent file so relative paths resolve from that agent folder.
+ * Defaults to `./instructions.md`.
+ */
+declare function loadAgentInstructions(importMetaUrl: string, options?: LoadAgentInstructionsOptions): string;
+//#endregion
+export { LoadAgentInstructionsOptions, loadAgentInstructions };

package/dist/agents/lib/instructions.server.mjs

@@ -0,0 +1,26 @@
+import "server-cli-only";
+import { readFileSync } from "node:fs";
+
+//#region src/agents/lib/instructions.server.ts
+const instructionCache = /* @__PURE__ */ new Map();
+/**
+* Loads an agent's always-on instructions from a file next to the agent module.
+* Pass `import.meta.url` from the agent file so relative paths resolve from that agent folder.
+* Defaults to `./instructions.md`.
+*/
+function loadAgentInstructions(importMetaUrl, options = {}) {
+	const instructionUrl = new URL(options.path ?? "./instructions.md", importMetaUrl);
+	const cacheKey = instructionUrl.href;
+	const cached = instructionCache.get(cacheKey);
+	if (cached !== void 0) return cached;
+	try {
+		const instructions = readFileSync(instructionUrl, "utf-8");
+		instructionCache.set(cacheKey, instructions);
+		return instructions;
+	} catch (error) {
+		throw new Error(`Unable to load agent instructions from ${instructionUrl.pathname}.`, { cause: error });
+	}
+}
+
+//#endregion
+export { loadAgentInstructions };

package/dist/agents/lib/types.d.mts

@@ -0,0 +1,26 @@
+import { ToolContext, TulipToolDefinition } from "../../tools/lib/types.mjs";
+import { Agent, Experimental_AgentSettings, FlexibleSchema, ToolSet } from "ai";
+
+//#region src/agents/lib/types.d.ts
+type AgentSettings = Experimental_AgentSettings;
+type CreatedAgent<TTools extends ToolSet = ToolSet> = Agent<never, TTools, Record<string, unknown>, never>;
+type DelegationTargetAgent = {
+  generate(options: {
+    prompt: string;
+    abortSignal?: AbortSignal;
+  }): PromiseLike<{
+    text: string;
+  }>;
+};
+type DelegateToAgentToolOptions<TName extends string, TInput extends Record<string, unknown>, TOutput, TContext extends ToolContext = ToolContext> = Pick<TulipToolDefinition<TName, TInput, TOutput, TContext>, "name" | "title" | "description"> & {
+  agent: DelegationTargetAgent;
+  inputSchema: FlexibleSchema<TInput>;
+  outputSchema?: FlexibleSchema<TOutput>;
+  contextSchema?: FlexibleSchema<TContext>;
+  prompt?: (input: TInput) => string;
+  output?: (result: {
+    text: string;
+  }, input: TInput) => TOutput;
+};
+//#endregion
+export { AgentSettings, CreatedAgent, DelegateToAgentToolOptions, DelegationTargetAgent };

package/dist/agents/server.d.mts

@@ -0,0 +1,5 @@
+import { AgentSettings, CreatedAgent, DelegateToAgentToolOptions, DelegationTargetAgent } from "./lib/types.mjs";
+import { createAgent } from "./lib/definitions.server.mjs";
+import { delegateToAgentTool } from "./lib/delegation.server.mjs";
+import { LoadAgentInstructionsOptions, loadAgentInstructions } from "./lib/instructions.server.mjs";
+export { AgentSettings, CreatedAgent, DelegateToAgentToolOptions, DelegationTargetAgent, LoadAgentInstructionsOptions, createAgent, delegateToAgentTool, loadAgentInstructions };

package/dist/agents/server.mjs

@@ -0,0 +1,5 @@
+import { createAgent } from "./lib/definitions.server.mjs";
+import { delegateToAgentTool } from "./lib/delegation.server.mjs";
+import { loadAgentInstructions } from "./lib/instructions.server.mjs";
+
+export { createAgent, delegateToAgentTool, loadAgentInstructions };

package/dist/chat/client.d.mts

@@ -0,0 +1,10 @@
+import { AgentActivity, AgentActivityProps } from "./components/agent-activity.client.mjs";
+import { ChatComposer, ChatComposerActions, ChatComposerAttachmentButton, ChatComposerInput, ChatComposerModelSelect, ChatComposerProps, ChatComposerStatus, ChatComposerSubmit, ChatComposerToolbar } from "./components/chat-composer.client.mjs";
+import { ChatPart, StreamAgentChatOptions, ToolChatPart } from "./lib/types.mjs";
+import { ChatMessage, ChatMessageContent, ChatMessageFooter, ChatMessageHeader, ChatMessageParts, ChatMessageProps } from "./components/chat-message.client.mjs";
+import { ChatThread, ChatThreadActivity, ChatThreadBottom, ChatThreadContent, ChatThreadMessage, ChatThreadProps, ChatThreadScrollButton } from "./components/chat-thread.client.mjs";
+import { ChatMessagePart, ChatMessagePartProps } from "./components/message-part.client.mjs";
+import { StarterPrompts, StarterPromptsProps } from "./components/starter-prompts.client.mjs";
+import { ToolCallCard, ToolCallCardLabels, ToolCallCardProps } from "./components/tool-call-card.client.mjs";
+import { getChatPartKey, getDefaultToolTitle, getToolName, isToolPart, stringifyChatValue } from "./lib/parts.mjs";
+export { AgentActivity, AgentActivityProps, ChatComposer, ChatComposerActions, ChatComposerAttachmentButton, ChatComposerInput, ChatComposerModelSelect, ChatComposerProps, ChatComposerStatus, ChatComposerSubmit, ChatComposerToolbar, ChatMessage, ChatMessageContent, ChatMessageFooter, ChatMessageHeader, ChatMessagePart, ChatMessagePartProps, ChatMessageParts, ChatMessageProps, ChatPart, ChatThread, ChatThreadActivity, ChatThreadBottom, ChatThreadContent, ChatThreadMessage, ChatThreadProps, ChatThreadScrollButton, StarterPrompts, StarterPromptsProps, StreamAgentChatOptions, ToolCallCard, ToolCallCardLabels, ToolCallCardProps, ToolChatPart, getChatPartKey, getDefaultToolTitle, getToolName, isToolPart, stringifyChatValue };

package/dist/chat/client.mjs

@@ -0,0 +1,12 @@
+"use client";
+
+import { getChatPartKey, getDefaultToolTitle, getToolName, isToolPart, stringifyChatValue } from "./lib/parts.mjs";
+import { AgentActivity } from "./components/agent-activity.client.mjs";
+import { ChatComposer, ChatComposerActions, ChatComposerAttachmentButton, ChatComposerInput, ChatComposerModelSelect, ChatComposerStatus, ChatComposerSubmit, ChatComposerToolbar } from "./components/chat-composer.client.mjs";
+import { ToolCallCard } from "./components/tool-call-card.client.mjs";
+import { ChatMessagePart } from "./components/message-part.client.mjs";
+import { ChatMessage, ChatMessageContent, ChatMessageFooter, ChatMessageHeader, ChatMessageParts } from "./components/chat-message.client.mjs";
+import { ChatThread, ChatThreadActivity, ChatThreadBottom, ChatThreadContent, ChatThreadMessage, ChatThreadScrollButton } from "./components/chat-thread.client.mjs";
+import { StarterPrompts } from "./components/starter-prompts.client.mjs";
+
+export { AgentActivity, ChatComposer, ChatComposerActions, ChatComposerAttachmentButton, ChatComposerInput, ChatComposerModelSelect, ChatComposerStatus, ChatComposerSubmit, ChatComposerToolbar, ChatMessage, ChatMessageContent, ChatMessageFooter, ChatMessageHeader, ChatMessagePart, ChatMessageParts, ChatThread, ChatThreadActivity, ChatThreadBottom, ChatThreadContent, ChatThreadMessage, ChatThreadScrollButton, StarterPrompts, ToolCallCard, getChatPartKey, getDefaultToolTitle, getToolName, isToolPart, stringifyChatValue };

package/dist/chat/components/agent-activity.client.d.mts

@@ -0,0 +1,14 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/chat/components/agent-activity.client.d.ts
+type AgentActivityProps = {
+  className?: string;
+};
+/**
+ * Small typing indicator for an agent that is currently streaming a response.
+ */
+declare function AgentActivity({
+  className
+}: AgentActivityProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { AgentActivity, AgentActivityProps };

package/dist/chat/components/agent-activity.client.mjs

@@ -0,0 +1,26 @@
+"use client";
+
+import { cn } from "@tulip-systems/core/lib";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/chat/components/agent-activity.client.tsx
+/**
+* Small typing indicator for an agent that is currently streaming a response.
+*/
+function AgentActivity({ className }) {
+	return /* @__PURE__ */ jsxs("div", {
+		className: cn("flex h-7 w-fit items-center gap-1 px-1", className),
+		children: [
+			/* @__PURE__ */ jsx("span", {
+				className: "sr-only",
+				children: "Assistant is responding"
+			}),
+			/* @__PURE__ */ jsx("span", { className: "size-1.5 animate-pulse rounded-full bg-muted-foreground/50 [animation-delay:-0.3s]" }),
+			/* @__PURE__ */ jsx("span", { className: "size-1.5 animate-pulse rounded-full bg-muted-foreground/50 [animation-delay:-0.15s]" }),
+			/* @__PURE__ */ jsx("span", { className: "size-1.5 animate-pulse rounded-full bg-muted-foreground/50" })
+		]
+	});
+}
+
+//#endregion
+export { AgentActivity };

package/dist/chat/components/assistant-panel.client.d.mts

@@ -0,0 +1,40 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { ComponentProps, PropsWithChildren } from "react";
+
+//#region src/chat/components/assistant-panel.client.d.ts
+type AssistantPanelProps = PropsWithChildren<{
+  open?: boolean;
+  defaultOpen?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  className?: string;
+}>;
+type AssistantPanelContentProps = ComponentProps<"div">;
+type AssistantPanelThreadProps = ComponentProps<"div">;
+type AssistantPanelInputProps = ComponentProps<"div">;
+/**
+ * A composable admin assistant panel shell.
+ *
+ * The panel only renders its children while open, so expensive chat state can
+ * live in child components without slowing down the app when the panel is closed.
+ */
+declare function AssistantPanel({
+  open,
+  defaultOpen,
+  onOpenChange,
+  className,
+  children
+}: AssistantPanelProps): react_jsx_runtime0.JSX.Element;
+declare function AssistantPanelContent({
+  className,
+  ...props
+}: AssistantPanelContentProps): react_jsx_runtime0.JSX.Element;
+declare function AssistantPanelThread({
+  className,
+  ...props
+}: AssistantPanelThreadProps): react_jsx_runtime0.JSX.Element;
+declare function AssistantPanelInput({
+  className,
+  ...props
+}: AssistantPanelInputProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { AssistantPanel, AssistantPanelContent, AssistantPanelContentProps, AssistantPanelInput, AssistantPanelInputProps, AssistantPanelProps, AssistantPanelThread, AssistantPanelThreadProps };

package/dist/chat/components/assistant-panel.client.mjs

@@ -0,0 +1,53 @@
+"use client";
+
+import { cn } from "@tulip-systems/core/lib";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+
+//#region src/chat/components/assistant-panel.client.tsx
+/**
+* A composable admin assistant panel shell.
+*
+* The panel only renders its children while open, so expensive chat state can
+* live in child components without slowing down the app when the panel is closed.
+*/
+function AssistantPanel({ open, defaultOpen = false, onOpenChange, className, children }) {
+	const [internalOpen, setInternalOpen] = useState(defaultOpen);
+	const isOpen = open ?? internalOpen;
+	function setOpen(nextOpen) {
+		if (open === void 0) setInternalOpen(nextOpen);
+		onOpenChange?.(nextOpen);
+	}
+	return /* @__PURE__ */ jsxs("aside", {
+		"data-state": isOpen ? "open" : "closed",
+		className: cn("relative z-40 flex h-dvh w-[min(100vw,30rem)] shrink-0 flex-col border-border/60 border-l bg-sidebar/70 shadow-2xl backdrop-blur-2xl transition-[transform,width] duration-200 md:relative md:inset-auto md:h-dvh", isOpen ? "translate-x-0 px-content md:w-[30rem]" : "translate-x-full md:w-content md:translate-x-0", className),
+		children: [isOpen && children, /* @__PURE__ */ jsx("button", {
+			className: "absolute inset-y-0 left-0 h-full w-content bg-sidebar/70 hover:bg-primary/10",
+			type: "button",
+			onClick: () => setOpen(!isOpen),
+			"data-state": isOpen ? "open" : "closed",
+			"aria-label": isOpen ? "Close assistant panel" : "Open assistant panel"
+		})]
+	});
+}
+function AssistantPanelContent({ className, ...props }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("flex min-h-0 flex-1 flex-col", className),
+		...props
+	});
+}
+function AssistantPanelThread({ className, ...props }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("min-h-0 flex-1 overflow-hidden", className),
+		...props
+	});
+}
+function AssistantPanelInput({ className, ...props }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: cn("shrink-0 border-border/50 border-t bg-background/35 px-3 pt-3 pb-4 backdrop-blur-xl", className),
+		...props
+	});
+}
+
+//#endregion
+export { AssistantPanel, AssistantPanelContent, AssistantPanelInput, AssistantPanelThread };

package/dist/chat/components/chat-composer.client.d.mts

@@ -0,0 +1,160 @@
+import { ChatStatus } from "ai";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { Button, Textarea } from "@tulip-systems/core/components";
+import { ComponentProps, ReactNode } from "react";
+
+//#region src/chat/components/chat-composer.client.d.ts
+type ChatComposerProps = Omit<ComponentProps<"form">, "onSubmit"> & {
+  value: string;
+  onValueChange: (value: string) => void;
+  onSubmit: (value: string) => void;
+  disabled?: boolean;
+  status?: ChatStatus;
+  statusLabel?: ReactNode;
+};
+/**
+ * Provides the root composer shell and shared state for all chat composer slots.
+ * Use it as the controlled boundary for the current draft value and submit handler.
+ *
+ * @example
+ * ```tsx
+ * <ChatComposer value={input} onValueChange={setInput} onSubmit={sendMessage}>
+ *   <ChatComposerInput placeholder="Ask something..." />
+ *   <ChatComposerToolbar>
+ *     <ChatComposerActions>
+ *       <ChatComposerAttachmentButton />
+ *     </ChatComposerActions>
+ *     <ChatComposerSubmit />
+ *   </ChatComposerToolbar>
+ * </ChatComposer>
+ * ```
+ */
+declare function ChatComposer({
+  value,
+  onValueChange,
+  onSubmit,
+  disabled,
+  status,
+  statusLabel,
+  className,
+  children,
+  ...props
+}: ChatComposerProps): react_jsx_runtime0.JSX.Element;
+/**
+ * Renders the auto-growing textarea connected to the nearest `ChatComposer`.
+ * Pressing Enter submits the composer, while Shift+Enter inserts a new line.
+ *
+ * @example
+ * ```tsx
+ * <ChatComposerInput placeholder="Ask something..." rows={3} />
+ * ```
+ */
+declare function ChatComposerInput({
+  rows,
+  className,
+  onKeyDown,
+  ...props
+}: Omit<ComponentProps<typeof Textarea>, "value" | "onChange" | "disabled">): react_jsx_runtime0.JSX.Element;
+/**
+ * Renders the bottom toolbar area for composer actions and the submit button.
+ * Place `ChatComposerActions` on the left and `ChatComposerSubmit` on the right.
+ *
+ * @example
+ * ```tsx
+ * <ChatComposerToolbar>
+ *   <ChatComposerActions>
+ *     <ChatComposerAttachmentButton />
+ *   </ChatComposerActions>
+ *   <ChatComposerSubmit />
+ * </ChatComposerToolbar>
+ * ```
+ */
+declare function ChatComposerToolbar({
+  className,
+  ...props
+}: ComponentProps<"div">): react_jsx_runtime0.JSX.Element;
+/**
+ * Groups secondary composer controls such as attachments, model selection, or status.
+ * It keeps action controls aligned together inside `ChatComposerToolbar`.
+ *
+ * @example
+ * ```tsx
+ * <ChatComposerActions>
+ *   <ChatComposerAttachmentButton />
+ *   <ChatComposerModelSelect>GPT-5.5</ChatComposerModelSelect>
+ *   <ChatComposerStatus />
+ * </ChatComposerActions>
+ * ```
+ */
+declare function ChatComposerActions({
+  className,
+  ...props
+}: ComponentProps<"div">): react_jsx_runtime0.JSX.Element;
+/**
+ * Renders an attachment action button for opening a file picker or context picker.
+ * It uses a file-upload icon and `Context toevoegen` accessible label by default.
+ *
+ * @example
+ * ```tsx
+ * <ChatComposerAttachmentButton onClick={openFilePicker} />
+ * ```
+ */
+declare function ChatComposerAttachmentButton({
+  className,
+  disabled,
+  ...props
+}: ComponentProps<typeof Button>): react_jsx_runtime0.JSX.Element;
+/**
+ * Renders a compact model selector trigger inside the composer toolbar.
+ * Use it as a simple button or compose it with a popover/select in application code.
+ *
+ * @example
+ * ```tsx
+ * <ChatComposerModelSelect onClick={openModelMenu}>GPT-5.5</ChatComposerModelSelect>
+ * ```
+ */
+declare function ChatComposerModelSelect({
+  className,
+  disabled,
+  children,
+  ...props
+}: ComponentProps<typeof Button>): react_jsx_runtime0.JSX.Element;
+/**
+ * Displays the current composer status from `ChatComposer.status` and `statusLabel`.
+ * It renders nothing when no label or children are provided.
+ *
+ * @example
+ * ```tsx
+ * <ChatComposer status="streaming" statusLabel="Thinking...">
+ *   <ChatComposerInput />
+ *   <ChatComposerToolbar>
+ *     <ChatComposerActions>
+ *       <ChatComposerStatus />
+ *     </ChatComposerActions>
+ *     <ChatComposerSubmit />
+ *   </ChatComposerToolbar>
+ * </ChatComposer>
+ * ```
+ */
+declare function ChatComposerStatus({
+  className,
+  children,
+  ...props
+}: ComponentProps<"div">): react_jsx_runtime0.JSX.Element | null;
+/**
+ * Renders the primary submit button for the current composer draft.
+ * It uses an arrow-up icon by default and disables itself while the composer cannot submit.
+ *
+ * @example
+ * ```tsx
+ * <ChatComposerSubmit />
+ * ```
+ */
+declare function ChatComposerSubmit({
+  className,
+  disabled,
+  onClick,
+  ...props
+}: ComponentProps<typeof Button>): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { ChatComposer, ChatComposerActions, ChatComposerAttachmentButton, ChatComposerInput, ChatComposerModelSelect, ChatComposerProps, ChatComposerStatus, ChatComposerSubmit, ChatComposerToolbar };