@lleverage-ai/agent-sdk 0.0.2 → 0.0.4

package/dist/plugins/agent-teams/types.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Type definitions for the Agent Teams plugin.
+ *
+ * @packageDocumentation
+ */
+import type { LanguageModel } from "ai";
+import type { Agent, AgentOptions, HookRegistration } from "../../types.js";
+/**
+ * Mutable reference to an agent, used by tools that need access to an agent
+ * that hasn't been created yet at tool-definition time.
+ *
+ * @category Agent Teams
+ */
+export interface AgentRef {
+    current: Agent | undefined;
+}
+/**
+ * Status of a team task.
+ *
+ * @category Agent Teams
+ */
+export type TeamTaskStatus = "pending" | "in_progress" | "completed";
+/**
+ * A shared task with dependencies for team coordination.
+ *
+ * @category Agent Teams
+ */
+export interface TeamTask {
+    /** Unique task identifier */
+    id: string;
+    /** Brief task title */
+    subject: string;
+    /** Detailed task description */
+    description: string;
+    /** Current task status */
+    status: TeamTaskStatus;
+    /** Teammate ID that claimed this task */
+    assignee?: string;
+    /** ID of the teammate/lead that created this task */
+    createdBy: string;
+    /** Task IDs that must complete before this task can start */
+    blockedBy: string[];
+    /** Task IDs that this task blocks (computed reverse dependency) */
+    blocks: string[];
+    /** Result or output after task completion */
+    result?: string;
+    /** ISO timestamp of task creation */
+    createdAt: string;
+    /** ISO timestamp of last update */
+    updatedAt: string;
+}
+/**
+ * A mailbox message between team members.
+ *
+ * @category Agent Teams
+ */
+export interface TeamMessage {
+    /** Unique message identifier */
+    id: string;
+    /** Sender teammate/lead ID */
+    from: string;
+    /** Recipient teammate ID (null for broadcast) */
+    to: string | null;
+    /** Message content */
+    content: string;
+    /** ISO timestamp */
+    timestamp: string;
+    /** Whether the recipient has read this message */
+    read: boolean;
+}
+/**
+ * Status of a teammate.
+ *
+ * @category Agent Teams
+ */
+export type TeammateStatus = "idle" | "working" | "stopped";
+/**
+ * Information about an active teammate.
+ *
+ * @category Agent Teams
+ */
+export interface TeammateInfo {
+    /** Unique teammate identifier */
+    id: string;
+    /** Role name (e.g., "researcher", "coder") */
+    role: string;
+    /** Description of the teammate's capabilities */
+    description: string;
+    /** Current status */
+    status: TeammateStatus;
+    /** ID of the task currently being worked on */
+    currentTaskId?: string;
+    /** ISO timestamp when the teammate was spawned */
+    spawnedAt: string;
+}
+/**
+ * Abstract coordination interface for team management.
+ *
+ * Handles teammate registration, task management with dependencies,
+ * and inter-agent messaging.
+ *
+ * @category Agent Teams
+ */
+export interface TeamCoordinator {
+    registerTeammate(info: TeammateInfo): void;
+    removeTeammate(id: string): void;
+    getTeammate(id: string): TeammateInfo | undefined;
+    listTeammates(): TeammateInfo[];
+    updateTeammateStatus(id: string, status: TeammateStatus, taskId?: string): void;
+    createTask(task: Omit<TeamTask, "id" | "createdAt" | "updatedAt" | "blocks">): TeamTask;
+    getTask(id: string): TeamTask | undefined;
+    listTasks(filter?: {
+        status?: TeamTaskStatus;
+        assignee?: string;
+    }): TeamTask[];
+    claimTask(taskId: string, teammateId: string): boolean;
+    completeTask(taskId: string, result?: string): boolean;
+    updateTask(taskId: string, updates: Partial<Pick<TeamTask, "subject" | "description" | "status" | "blockedBy">>): boolean;
+    isTaskBlocked(taskId: string): boolean;
+    sendMessage(msg: Omit<TeamMessage, "id" | "timestamp" | "read">): TeamMessage;
+    getMessages(recipientId: string, unreadOnly?: boolean): TeamMessage[];
+    markRead(messageId: string): void;
+    waitForMessage(agentId: string, timeoutMs?: number): Promise<TeamMessage[] | null>;
+    dispose(): void;
+}
+/**
+ * Template for spawnable teammates.
+ *
+ * Defines the role, capabilities, and agent configuration for a teammate type.
+ *
+ * @category Agent Teams
+ */
+export interface TeammateDefinition {
+    /** Role name (e.g., "researcher", "coder") */
+    role: string;
+    /** Description of what this teammate does */
+    description: string;
+    /** Agent options for this teammate (systemPrompt, tools, plugins, etc.) */
+    agentOptions: Partial<AgentOptions>;
+    /** Model to use for this teammate */
+    model?: LanguageModel;
+    /** Maximum turns before the teammate stops */
+    maxTurns?: number;
+}
+/**
+ * Configuration options for the Agent Teams plugin.
+ *
+ * @category Agent Teams
+ */
+export interface AgentTeamsPluginOptions {
+    /** Teammate definitions (templates for spawnable teammates) */
+    teammates: TeammateDefinition[];
+    /** Custom coordinator implementation (defaults to InMemoryTeamCoordinator) */
+    coordinator?: TeamCoordinator;
+    /** Hooks to merge into the agent's hook registration */
+    hooks?: HookRegistration;
+    /** Maximum concurrent teammates (default: Infinity) */
+    maxConcurrentTeammates?: number;
+    /** Milliseconds to wait for messages before considering a teammate idle. @default 30000 */
+    idleTimeoutMs?: number;
+    /** Callback when a teammate session error occurs. If not provided, errors are logged to console. */
+    onError?: (teammateId: string, error: Error) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/agent-teams/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plugins/agent-teams/types.ts"],"names":[],"mappings":"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"}

package/dist/plugins/agent-teams/types.js

@@ -0,0 +1,7 @@
+/**
+ * Type definitions for the Agent Teams plugin.
+ *
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/plugins/agent-teams/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plugins/agent-teams/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,CAShE"}
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,CAUhE"}

package/dist/plugins.js

@@ -58,6 +58,7 @@ export function definePlugin(options) {
         tools: options.tools,
         mcpServer: options.mcpServer,
         skills: options.skills,
+        hooks: options.hooks,
     };
 }
 //# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../src/plugins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC;AACJ,CAAC"}

package/dist/presets/production.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"production.d.ts","sourceRoot":"","sources":["../../src/presets/production.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAGxC,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAChC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAA+C,MAAM,aAAa,CAAC;AAmCpG;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,oBAAoB,CAAC;IAEtC;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAE5C;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAElD;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;OAEG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CAmF5F;AAED;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,EAUlD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,EAOnD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,4BACf,SAAQ,IAAI,CAAC,sBAAsB,EAAE,kBAAkB,CAAC;IACxD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,qBAAqB,CA0BvB"}
+{"version":3,"file":"production.d.ts","sourceRoot":"","sources":["../../src/presets/production.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAGxC,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAChC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAC;AAoCzE;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,KAAK,EAAE,aAAa,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,oBAAoB,CAAC;IAEtC;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAE5C;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,oBAAoB,CAAC,EAAE,0BAA0B,CAAC;IAElD;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhC;;OAEG;IACH,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEjC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;IAEb;;OAEG;IACH,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CAmF5F;AAED;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,EAUlD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,+BAA+B,EAAE,MAAM,EAOnD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,4BACf,SAAQ,IAAI,CAAC,sBAAsB,EAAE,kBAAkB,CAAC;IACxD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,qBAAqB,CA0BvB"}

package/dist/presets/production.js

@@ -27,17 +27,17 @@ function mergeHooks(target, source) {
         "SubagentStart",
         "SubagentStop",
     ];
+    // Cast to Record for dynamic key assignment — all HookRegistration values are arrays
+    const t = target;
+    const s = source;
     for (const event of hookEvents) {
-        const sourceCallbacks = source[event];
+        const sourceCallbacks = s[event];
         if (sourceCallbacks) {
-            if (!target[event]) {
-                target[event] = sourceCallbacks;
+            if (!t[event]) {
+                t[event] = sourceCallbacks;
             }
             else {
-                target[event] = [
-                    ...target[event],
-                    ...sourceCallbacks,
-                ];
+                t[event] = [...t[event], ...sourceCallbacks];
             }
         }
     }

package/dist/presets/production.js.map

@@ -1 +1 @@
-{"version":3,"file":"production.js","sourceRoot":"","sources":["../../src/presets/production.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"production.js","sourceRoot":"","sources":["../../src/presets/production.ts"],"names":[],"mappings":"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"}

package/dist/prompt-builder/components.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Default prompt components for common use cases.
+ *
+ * @packageDocumentation
+ */
+import type { PromptComponent } from "./index.js";
+import { PromptBuilder } from "./index.js";
+/**
+ * Default identity component providing a basic agent identity.
+ *
+ * Priority: 100 (highest)
+ *
+ * @example
+ * ```typescript
+ * const builder = new PromptBuilder().register(identityComponent);
+ * ```
+ *
+ * @category Prompt Builder
+ */
+export declare const identityComponent: PromptComponent;
+/**
+ * Lists available tools in the system prompt.
+ *
+ * Only included if tools are available.
+ * Priority: 70
+ *
+ * @example
+ * ```typescript
+ * const builder = new PromptBuilder().register(toolsComponent);
+ * ```
+ *
+ * @category Prompt Builder
+ */
+export declare const toolsComponent: PromptComponent;
+/**
+ * Lists available skills in the system prompt.
+ *
+ * Only included if skills are available.
+ * Priority: 65
+ *
+ * @example
+ * ```typescript
+ * const builder = new PromptBuilder().register(skillsComponent);
+ * ```
+ *
+ * @category Prompt Builder
+ */
+export declare const skillsComponent: PromptComponent;
+/**
+ * Lists agent capabilities based on backend and configuration.
+ *
+ * Priority: 60
+ *
+ * @example
+ * ```typescript
+ * const builder = new PromptBuilder().register(capabilitiesComponent);
+ * ```
+ *
+ * @category Prompt Builder
+ */
+export declare const capabilitiesComponent: PromptComponent;
+/**
+ * Provides context about the current conversation.
+ *
+ * Only included if thread ID or messages are available.
+ * Priority: 50
+ *
+ * @example
+ * ```typescript
+ * const builder = new PromptBuilder().register(contextComponent);
+ * ```
+ *
+ * @category Prompt Builder
+ */
+export declare const contextComponent: PromptComponent;
+/**
+ * Lists loaded plugins.
+ *
+ * Only included if plugins are available.
+ * Priority: 68
+ *
+ * @example
+ * ```typescript
+ * const builder = new PromptBuilder().register(pluginsComponent);
+ * ```
+ *
+ * @category Prompt Builder
+ */
+export declare const pluginsComponent: PromptComponent;
+/**
+ * Provides information about permission mode.
+ *
+ * Only included if permission mode is set.
+ * Priority: 55
+ *
+ * @example
+ * ```typescript
+ * const builder = new PromptBuilder().register(permissionModeComponent);
+ * ```
+ *
+ * @category Prompt Builder
+ */
+export declare const permissionModeComponent: PromptComponent;
+/**
+ * Creates a prompt builder with sensible defaults.
+ *
+ * Includes the following components by default:
+ * - `identity`: Basic agent identity
+ * - `tools-listing`: Available tools
+ * - `skills-listing`: Available skills
+ * - `plugins-listing`: Loaded plugins
+ * - `capabilities`: Backend capabilities
+ * - `permission-mode`: Permission mode info
+ * - `context`: Conversation context
+ *
+ * You can customize by cloning and modifying:
+ *
+ * @example
+ * ```typescript
+ * // Use defaults
+ * const agent = createAgent({
+ *   model,
+ *   // No systemPrompt = uses default builder automatically
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Customize defaults
+ * const builder = createDefaultPromptBuilder()
+ *   .unregister('identity')
+ *   .register({
+ *     name: 'custom-identity',
+ *     priority: 100,
+ *     render: () => 'You are a specialized coding assistant.',
+ *   });
+ *
+ * const agent = createAgent({
+ *   model,
+ *   promptBuilder: builder,
+ * });
+ * ```
+ *
+ * @returns A PromptBuilder with default components registered
+ *
+ * @category Prompt Builder
+ */
+export declare function createDefaultPromptBuilder(): PromptBuilder;
+//# sourceMappingURL=components.d.ts.map

package/dist/prompt-builder/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../src/prompt-builder/components.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAI/B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,EAAE,eAQ5B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,EAAE,eAQ7B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,eA6BnC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAqB9B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAQ9B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,EAAE,eAsBrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,0BAA0B,IAAI,aAAa,CAU1D"}

package/dist/prompt-builder/components.js

@@ -0,0 +1,252 @@
+/**
+ * Default prompt components for common use cases.
+ *
+ * @packageDocumentation
+ */
+import { PromptBuilder } from "./index.js";
+/**
+ * Default identity component providing a basic agent identity.
+ *
+ * Priority: 100 (highest)
+ *
+ * @example
+ * ```typescript
+ * const builder = new PromptBuilder().register(identityComponent);
+ * ```
+ *
+ * @category Prompt Builder
+ */
+export const identityComponent = {
+    name: "identity",
+    priority: 100,
+    render: () => "You are a helpful AI assistant.",
+};
+/**
+ * Lists available tools in the system prompt.
+ *
+ * Only included if tools are available.
+ * Priority: 70
+ *
+ * @example
+ * ```typescript
+ * const builder = new PromptBuilder().register(toolsComponent);
+ * ```
+ *
+ * @category Prompt Builder
+ */
+export const toolsComponent = {
+    name: "tools-listing",
+    priority: 70,
+    condition: (ctx) => ctx.tools !== undefined && ctx.tools.length > 0,
+    render: (ctx) => {
+        const toolLines = ctx.tools.map((t) => `- **${t.name}**: ${t.description}`);
+        return `# Available Tools\n\nYou have access to the following tools:\n${toolLines.join("\n")}`;
+    },
+};
+/**
+ * Lists available skills in the system prompt.
+ *
+ * Only included if skills are available.
+ * Priority: 65
+ *
+ * @example
+ * ```typescript
+ * const builder = new PromptBuilder().register(skillsComponent);
+ * ```
+ *
+ * @category Prompt Builder
+ */
+export const skillsComponent = {
+    name: "skills-listing",
+    priority: 65,
+    condition: (ctx) => ctx.skills !== undefined && ctx.skills.length > 0,
+    render: (ctx) => {
+        const skillLines = ctx.skills.map((s) => `- **${s.name}**: ${s.description}`);
+        return `# Available Skills\n\nYou can activate these skills on-demand:\n${skillLines.join("\n")}`;
+    },
+};
+/**
+ * Lists agent capabilities based on backend and configuration.
+ *
+ * Priority: 60
+ *
+ * @example
+ * ```typescript
+ * const builder = new PromptBuilder().register(capabilitiesComponent);
+ * ```
+ *
+ * @category Prompt Builder
+ */
+export const capabilitiesComponent = {
+    name: "capabilities",
+    priority: 60,
+    render: (ctx) => {
+        const capabilities = [];
+        if (ctx.backend?.hasExecuteCapability) {
+            capabilities.push("- Execute shell commands (bash)");
+        }
+        if (ctx.backend?.type === "filesystem") {
+            capabilities.push("- Read and write files to the filesystem");
+            if (ctx.backend.rootDir) {
+                capabilities.push(`- Working directory: ${ctx.backend.rootDir}`);
+            }
+        }
+        else if (ctx.backend?.type === "state") {
+            capabilities.push("- In-memory file operations (sandboxed)");
+        }
+        if (ctx.state?.todos && ctx.state.todos.length > 0) {
+            capabilities.push(`- ${ctx.state.todos.length} active task(s) in the task list`);
+        }
+        if (capabilities.length === 0) {
+            return "";
+        }
+        return `# Capabilities\n\n${capabilities.join("\n")}`;
+    },
+};
+/**
+ * Provides context about the current conversation.
+ *
+ * Only included if thread ID or messages are available.
+ * Priority: 50
+ *
+ * @example
+ * ```typescript
+ * const builder = new PromptBuilder().register(contextComponent);
+ * ```
+ *
+ * @category Prompt Builder
+ */
+export const contextComponent = {
+    name: "context",
+    priority: 50,
+    condition: (ctx) => !!ctx.threadId || !!(ctx.currentMessages && ctx.currentMessages.length > 0),
+    render: (ctx) => {
+        const parts = [];
+        if (ctx.threadId) {
+            parts.push(`- Thread ID: ${ctx.threadId}`);
+        }
+        if (ctx.currentMessages && ctx.currentMessages.length > 0) {
+            parts.push(`- Conversation history: ${ctx.currentMessages.length} message(s)`);
+        }
+        if (parts.length === 0) {
+            return "";
+        }
+        return `# Context\n\n${parts.join("\n")}`;
+    },
+};
+/**
+ * Lists loaded plugins.
+ *
+ * Only included if plugins are available.
+ * Priority: 68
+ *
+ * @example
+ * ```typescript
+ * const builder = new PromptBuilder().register(pluginsComponent);
+ * ```
+ *
+ * @category Prompt Builder
+ */
+export const pluginsComponent = {
+    name: "plugins-listing",
+    priority: 68,
+    condition: (ctx) => ctx.plugins !== undefined && ctx.plugins.length > 0,
+    render: (ctx) => {
+        const pluginLines = ctx.plugins.map((p) => `- **${p.name}**: ${p.description}`);
+        return `# Loaded Plugins\n\n${pluginLines.join("\n")}`;
+    },
+};
+/**
+ * Provides information about permission mode.
+ *
+ * Only included if permission mode is set.
+ * Priority: 55
+ *
+ * @example
+ * ```typescript
+ * const builder = new PromptBuilder().register(permissionModeComponent);
+ * ```
+ *
+ * @category Prompt Builder
+ */
+export const permissionModeComponent = {
+    name: "permission-mode",
+    priority: 55,
+    condition: (ctx) => !!ctx.permissionMode,
+    render: (ctx) => {
+        const mode = ctx.permissionMode;
+        let description = "";
+        if (mode === "default") {
+            description = "Default permission mode: tools may require approval based on safety rules.";
+        }
+        else if (mode === "acceptEdits") {
+            description = "File editing tools are auto-approved; other tools may require approval.";
+        }
+        else if (mode === "bypassPermissions") {
+            description = "All tools are auto-approved without permission checks.";
+        }
+        else if (mode === "plan") {
+            description = "Plan mode: tool use is planned but not executed.";
+        }
+        else {
+            description = `Permission mode: ${String(mode)}`;
+        }
+        return `# Permission Mode\n\n${description}`;
+    },
+};
+/**
+ * Creates a prompt builder with sensible defaults.
+ *
+ * Includes the following components by default:
+ * - `identity`: Basic agent identity
+ * - `tools-listing`: Available tools
+ * - `skills-listing`: Available skills
+ * - `plugins-listing`: Loaded plugins
+ * - `capabilities`: Backend capabilities
+ * - `permission-mode`: Permission mode info
+ * - `context`: Conversation context
+ *
+ * You can customize by cloning and modifying:
+ *
+ * @example
+ * ```typescript
+ * // Use defaults
+ * const agent = createAgent({
+ *   model,
+ *   // No systemPrompt = uses default builder automatically
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Customize defaults
+ * const builder = createDefaultPromptBuilder()
+ *   .unregister('identity')
+ *   .register({
+ *     name: 'custom-identity',
+ *     priority: 100,
+ *     render: () => 'You are a specialized coding assistant.',
+ *   });
+ *
+ * const agent = createAgent({
+ *   model,
+ *   promptBuilder: builder,
+ * });
+ * ```
+ *
+ * @returns A PromptBuilder with default components registered
+ *
+ * @category Prompt Builder
+ */
+export function createDefaultPromptBuilder() {
+    return new PromptBuilder().registerMany([
+        identityComponent,
+        toolsComponent,
+        skillsComponent,
+        pluginsComponent,
+        capabilitiesComponent,
+        permissionModeComponent,
+        contextComponent,
+    ]);
+}
+//# sourceMappingURL=components.js.map

package/dist/prompt-builder/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../../src/prompt-builder/components.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAoB;IAChD,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,GAAG;IACb,MAAM,EAAE,GAAG,EAAE,CAAC,iCAAiC;CAChD,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;IACnE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;QACd,MAAM,SAAS,GAAG,GAAG,CAAC,KAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7E,OAAO,iEAAiE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACjG,CAAC;CACF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,IAAI,EAAE,gBAAgB;IACtB,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;IACrE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;QACd,MAAM,UAAU,GAAG,GAAG,CAAC,MAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/E,OAAO,mEAAmE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACpG,CAAC;CACF,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAoB;IACpD,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;QACd,MAAM,YAAY,GAAa,EAAE,CAAC;QAElC,IAAI,GAAG,CAAC,OAAO,EAAE,oBAAoB,EAAE,CAAC;YACtC,YAAY,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;YACvC,YAAY,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;YAC9D,IAAI,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBACxB,YAAY,CAAC,IAAI,CAAC,wBAAwB,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;YACzC,YAAY,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QAC/D,CAAC;QAED,IAAI,GAAG,CAAC,KAAK,EAAE,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnD,YAAY,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,kCAAkC,CAAC,CAAC;QACnF,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,qBAAqB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACxD,CAAC;CACF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/F,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;QACd,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1D,KAAK,CAAC,IAAI,CAAC,2BAA2B,GAAG,CAAC,eAAe,CAAC,MAAM,aAAa,CAAC,CAAC;QACjF,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,gBAAgB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC5C,CAAC;CACF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAoB;IAC/C,IAAI,EAAE,iBAAiB;IACvB,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;IACvE,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;QACd,MAAM,WAAW,GAAG,GAAG,CAAC,OAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACjF,OAAO,uBAAuB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACzD,CAAC;CACF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAoB;IACtD,IAAI,EAAE,iBAAiB;IACvB,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc;IACxC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE;QACd,MAAM,IAAI,GAAG,GAAG,CAAC,cAAe,CAAC;QACjC,IAAI,WAAW,GAAG,EAAE,CAAC;QAErB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,WAAW,GAAG,4EAA4E,CAAC;QAC7F,CAAC;aAAM,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;YAClC,WAAW,GAAG,yEAAyE,CAAC;QAC1F,CAAC;aAAM,IAAI,IAAI,KAAK,mBAAmB,EAAE,CAAC;YACxC,WAAW,GAAG,wDAAwD,CAAC;QACzE,CAAC;aAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,WAAW,GAAG,kDAAkD,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,WAAW,GAAG,oBAAoB,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,CAAC;QAED,OAAO,wBAAwB,WAAW,EAAE,CAAC;IAC/C,CAAC;CACF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO,IAAI,aAAa,EAAE,CAAC,YAAY,CAAC;QACtC,iBAAiB;QACjB,cAAc;QACd,eAAe;QACf,gBAAgB;QAChB,qBAAqB;QACrB,uBAAuB;QACvB,gBAAgB;KACjB,CAAC,CAAC;AACL,CAAC"}