@roj-ai/sdk 0.0.2

package/dist/plugins/skills/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Skills module - Skill discovery and loading.
+ */
+export { skillsPlugin } from './plugin.js';
+export type { PresetSkill, SkillsAgentConfig, SkillsPluginConfig as SkillsPresetConfig, SkillsPluginContext, } from './plugin.js';
+export { SkillId, skillIdSchema } from './schema.js';
+export type { LoadedSkill, SkillMetadata } from './schema.js';
+export { skillEvents } from './plugin.js';
+export type { SkillLoadedEvent } from './plugin.js';
+export { discoverSkills, type FrontmatterParseError, loadSkillContent, type ParsedFrontmatter, type ParsedSkillFile, parseSkillFile, parseSkillFrontmatter, type SkillDiscoveryError, } from './discovery.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/skills/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EACX,WAAW,EACX,iBAAiB,EACjB,kBAAkB,IAAI,kBAAkB,EACxC,mBAAmB,GACnB,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACpD,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG7D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAGnD,OAAO,EACN,cAAc,EACd,KAAK,qBAAqB,EAC1B,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,cAAc,EACd,qBAAqB,EACrB,KAAK,mBAAmB,GACxB,MAAM,gBAAgB,CAAA"}

package/dist/plugins/skills/plugin.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Skills Plugin - Progressive disclosure of reusable instruction sets
+ *
+ * Level 1 (Preset): SkillsPresetConfig with skill source directories
+ * Level 2 (Session): Plugin context with discovered skills, methods (load, list)
+ * Level 3 (Agent): Agent-specific skill config (preload, sources override), tools, status
+ */
+import z from 'zod/v4';
+import { AgentId } from '../../core/agents/schema.js';
+import type { SessionState } from '../../core/sessions/state.js';
+import { type LoadedSkill, type SkillMetadata } from './schema.js';
+/**
+ * A preset-contributed skill. Skills are matched by name; file-discovered
+ * skills from user sources take precedence over inline preset skills with
+ * the same name (lets projects override the defaults).
+ */
+export interface PresetSkill {
+    name: string;
+    description: string;
+    content: string;
+}
+/**
+ * Extract loaded skills for an agent from session state (for external consumers).
+ */
+export declare function selectAgentSkills(sessionState: SessionState, agentId: AgentId): LoadedSkill[];
+/**
+ * Session-wide skill configuration.
+ */
+export interface SkillsPluginConfig {
+    /**
+     * Directories to scan for SKILL.md files. Supports `{{workspaceDir}}` and
+     * `{{sessionDir}}` placeholders; sources referencing `{{workspaceDir}}` are
+     * skipped for sessions without a workspace. Relative paths resolve against
+     * the agent server cwd.
+     */
+    sources: string[];
+    /**
+     * Skills contributed directly by the preset. They behave identically to
+     * filesystem-discovered skills (same `load`/`list`/`use_skill`/`preload`
+     * flow), but content is kept in memory instead of read from disk. A skill
+     * discovered from `sources` with the same name overrides the preset one.
+     */
+    skills?: PresetSkill[];
+}
+/**
+ * Agent-specific skill configuration.
+ */
+export interface SkillsAgentConfig {
+    /** Override skill sources for this agent (default: use preset sources) */
+    sources?: string[];
+    /** Skills to auto-load when agent starts */
+    preload?: string[];
+}
+/**
+ * Plugin context - session-wide state.
+ */
+export interface SkillsPluginContext {
+    /** Available skills discovered from sources */
+    availableSkills: SkillMetadata[];
+}
+export declare const skillEvents: import("../../core/events/types.js").EventsFactory<{
+    skill_loaded: z.ZodObject<{
+        agentId: z.core.$ZodBranded<z.ZodString, "AgentId", "out">;
+        skillId: z.core.$ZodBranded<z.ZodString, "SkillId", "out">;
+        skillName: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>;
+}>;
+export type SkillLoadedEvent = (typeof skillEvents)['Events']['skill_loaded'];
+export declare const skillsPlugin: import("../../core/plugins/plugin-builder.js").PluginDefinition<"skills", SkillsPluginConfig, SkillsAgentConfig, {}, Record<"load", {
+    input: {
+        sessionId: string;
+        agentId: string & z.core.$brand<"AgentId">;
+        skillName: string;
+    };
+    output: {
+        skillId?: string | undefined;
+        message?: string | undefined;
+    };
+}> & Record<"list", {
+    input: {
+        sessionId: string;
+        agentId: string & z.core.$brand<"AgentId">;
+    };
+    output: {
+        skills: {
+            id: string;
+            name: string;
+            description: string;
+            loaded: boolean;
+        }[];
+    };
+}>>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/skills/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/skills/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,CAAC,MAAM,QAAQ,CAAA;AACtB,OAAO,EAAE,OAAO,EAAiB,MAAM,yBAAyB,CAAA;AAMhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAK5D,OAAO,EAAE,KAAK,WAAW,EAA0B,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAE1F;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CACf;AAgBD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,EAAE,CAE7F;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;;;;OAKG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,+CAA+C;IAC/C,eAAe,EAAE,aAAa,EAAE,CAAA;CAChC;AAED,eAAO,MAAM,WAAW;;;;;;;EAStB,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,CAAA;AAE7E,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;GAmRhB,CAAA"}

package/dist/plugins/skills/prompts.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Skills Prompt Sections - Build prompt sections for skill metadata and loaded skills.
+ */
+import type { LoadedSkill, SkillMetadata } from './schema.js';
+/**
+ * Build the "Available Skills" section for the system prompt.
+ * Lists skill names and descriptions, instructing agent to use use_skill tool.
+ *
+ * @param skills - Array of discovered skill metadata
+ * @returns Formatted section string, or empty string if no skills
+ */
+export declare function buildSkillsSection(skills: SkillMetadata[]): string;
+/**
+ * Format loaded skills as content to be injected before inference.
+ * Each skill is wrapped in a clear section header.
+ *
+ * @param loadedSkills - Array of skills loaded into agent context
+ * @returns Formatted string with all loaded skill content
+ */
+export declare function formatLoadedSkills(loadedSkills: LoadedSkill[]): string;
+/**
+ * Build a system message containing all loaded skills.
+ * Returns null if no skills are loaded.
+ *
+ * @param loadedSkills - Array of skills loaded into agent context
+ * @returns System message content or null
+ */
+export declare function buildLoadedSkillsMessage(loadedSkills: LoadedSkill[]): string | null;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/plugins/skills/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/plugins/skills/prompts.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAM7D;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAkBlE;AAMD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,MAAM,CActE;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,MAAM,GAAG,IAAI,CAYnF"}

package/dist/plugins/skills/schema.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Skills domain types
+ *
+ * Skills are reusable instruction sets that agents can load on-demand.
+ * Only metadata (name + description) is shown in system prompt;
+ * full content is loaded via use_skill tool.
+ */
+import z from 'zod/v4';
+/** SkillId schema - validates any string and brands as SkillId. */
+export declare const skillIdSchema: z.core.$ZodBranded<z.ZodString, "SkillId", "out">;
+/**
+ * Branded type for skill IDs.
+ * Format: lowercase kebab-case (e.g., "arxiv-search", "research-workflow")
+ */
+export type SkillId = z.infer<typeof skillIdSchema>;
+/**
+ * Create a SkillId from a string.
+ */
+export declare const SkillId: (id: string) => SkillId;
+/**
+ * Metadata about an available skill.
+ * Either discovered at session init from SKILL.md files (`source: 'file'`)
+ * or contributed inline by the preset (`source: 'inline'`).
+ */
+export type SkillMetadata = {
+    source: 'file';
+    /** Unique identifier (from frontmatter name field) */
+    id: SkillId;
+    /** Human-readable name */
+    name: string;
+    /** Short description shown in system prompt */
+    description: string;
+    /** Absolute path to the SKILL.md file */
+    sourcePath: string;
+} | {
+    source: 'inline';
+    id: SkillId;
+    name: string;
+    description: string;
+    /** Full skill body, already provided by the preset */
+    content: string;
+};
+/**
+ * A skill that has been loaded into an agent's context.
+ * Stored in AgentState and injected as system message before inference.
+ */
+export interface LoadedSkill {
+    /** Skill identifier */
+    id: SkillId;
+    /** Skill name */
+    name: string;
+    /** Full content of the SKILL.md file (without frontmatter) */
+    content: string;
+    /** Timestamp when the skill was loaded */
+    loadedAt: number;
+}
+/**
+ * Skills configuration for a preset.
+ */
+export interface SkillsConfig {
+    /** Directories to scan for skills (relative to preset or absolute paths) */
+    sources: string[];
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/plugins/skills/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/plugins/skills/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,CAAC,MAAM,QAAQ,CAAA;AAMtB,mEAAmE;AACnE,eAAO,MAAM,aAAa,mDAA8B,CAAA;AAExD;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,IAAI,MAAM,KAAG,OAAwB,CAAA;AAM7D;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACtB;IACD,MAAM,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,EAAE,EAAE,OAAO,CAAA;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAA;IACnB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAA;CAClB,GACC;IACD,MAAM,EAAE,QAAQ,CAAA;IAChB,EAAE,EAAE,OAAO,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAMF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC3B,uBAAuB;IACvB,EAAE,EAAE,OAAO,CAAA;IACX,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAA;IACf,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAA;CAChB;AAMD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,4EAA4E;IAC5E,OAAO,EAAE,MAAM,EAAE,CAAA;CACjB"}

package/dist/plugins/skills/skills.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skills.integration.test.d.ts.map

package/dist/plugins/skills/skills.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.integration.test.d.ts","sourceRoot":"","sources":["../../../src/plugins/skills/skills.integration.test.ts"],"names":[],"mappings":""}

package/dist/plugins/snapshotting/index.d.ts

@@ -0,0 +1,4 @@
+export { JjSnapshotter } from './jj-snapshotter.js';
+export { snapshottingPlugin, type SnapshottingPluginConfig } from './plugin.js';
+export type { ForkSnapshotOptions, SnapshotRefs, Snapshotter } from './snapshotter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/snapshotting/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/snapshotting/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,KAAK,wBAAwB,EAAE,MAAM,aAAa,CAAA;AAC/E,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/plugins/snapshotting/jj-snapshotter.d.ts

@@ -0,0 +1,27 @@
+import type { FileSystem } from '../../platform/fs.js';
+import type { ProcessRunner } from '../../platform/process.js';
+import type { Logger } from '../../lib/logger/logger.js';
+import type { ForkSnapshotOptions, SnapshotRefs, Snapshotter } from './snapshotter.js';
+export interface JjSnapshotterDeps {
+    fs: FileSystem;
+    process: ProcessRunner;
+}
+/**
+ * JJ (Jujutsu VCS) based snapshotter.
+ *
+ * Creates JJ repositories in session and workspace directories
+ * and takes snapshots by reading the current commit ID.
+ */
+export declare class JjSnapshotter implements Snapshotter {
+    private readonly sessionDir;
+    private readonly workspaceDir;
+    private readonly logger;
+    private readonly fs;
+    private readonly process;
+    constructor(sessionDir: string, workspaceDir: string | undefined, logger: Logger, deps: JjSnapshotterDeps);
+    init(): Promise<void>;
+    initFromFork(options: ForkSnapshotOptions): Promise<void>;
+    snapshot(): Promise<SnapshotRefs>;
+    private snapshotDir;
+}
+//# sourceMappingURL=jj-snapshotter.d.ts.map

package/dist/plugins/snapshotting/jj-snapshotter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jj-snapshotter.d.ts","sourceRoot":"","sources":["../../../src/plugins/snapshotting/jj-snapshotter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AA8BtF,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,UAAU,CAAA;IACd,OAAO,EAAE,aAAa,CAAA;CACtB;AAED;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,WAAW;IAK/C,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IANxB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAY;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;gBAGrB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,MAAM,EAAE,MAAM,EAC/B,IAAI,EAAE,iBAAiB;IAMlB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBrB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BzD,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;YASzB,WAAW;CAOzB"}

package/dist/plugins/snapshotting/plugin.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Snapshotting Plugin — takes JJ snapshots after tool execution
+ *
+ * Wraps the Snapshotter interface into a plugin with afterToolCall hook.
+ * The actual snapshotting implementation (JjSnapshotter) is injected via plugin config.
+ */
+import type { Snapshotter } from './snapshotter.js';
+/**
+ * Plugin config — provides a pre-configured Snapshotter instance.
+ */
+export interface SnapshottingPluginConfig {
+    snapshotter: Snapshotter;
+}
+export declare const snapshottingPlugin: import("../../core/plugins/plugin-builder.js").PluginDefinition<"snapshotting", SnapshottingPluginConfig, void, {}, {}>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/snapshotting/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/snapshotting/plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC,WAAW,EAAE,WAAW,CAAA;CACxB;AAED,eAAO,MAAM,kBAAkB,qHAkBtB,CAAA"}

package/dist/plugins/snapshotting/snapshotter.d.ts

@@ -0,0 +1,19 @@
+export interface SnapshotRefs {
+    workspaceRef?: string;
+    sessionRef?: string;
+}
+export interface ForkSnapshotOptions {
+    sourceSessionDir: string;
+    sourceWorkspaceDir?: string;
+    sessionRef?: string;
+    workspaceRef?: string;
+}
+export interface Snapshotter {
+    /** Initialize snapshot repositories. Called once when session is created. */
+    init(): Promise<void>;
+    /** Take a snapshot and return refs for current state. */
+    snapshot(): Promise<SnapshotRefs>;
+    /** Initialize from a fork of another session's snapshot. */
+    initFromFork?(options: ForkSnapshotOptions): Promise<void>;
+}
+//# sourceMappingURL=snapshotter.d.ts.map

package/dist/plugins/snapshotting/snapshotter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotter.d.ts","sourceRoot":"","sources":["../../../src/plugins/snapshotting/snapshotter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,mBAAmB;IACnC,gBAAgB,EAAE,MAAM,CAAA;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,WAAW;IAC3B,6EAA6E;IAC7E,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrB,yDAAyD;IACzD,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,CAAA;IACjC,4DAA4D;IAC5D,YAAY,CAAC,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1D"}

package/dist/plugins/todo/index.d.ts

@@ -0,0 +1,7 @@
+export { todoPlugin } from './plugin.js';
+export type { TodoAgentConfig, TodoPresetConfig } from './plugin.js';
+export { generateTodoId, TodoId, todoIdSchema } from './schema.js';
+export type { TodoStatus } from './schema.js';
+export { todoEvents } from './plugin.js';
+export type { TodoCreatedEvent, TodoDeletedEvent, TodoUpdatedEvent } from './plugin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/todo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/todo/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAGpE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAClE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}

package/dist/plugins/todo/plugin.d.ts

@@ -0,0 +1,95 @@
+import z from 'zod/v4';
+export declare const todoEvents: import("../../core/events/types.js").EventsFactory<{
+    todo_created: z.ZodObject<{
+        agentId: z.core.$ZodBranded<z.ZodString, "AgentId", "out">;
+        todoId: z.core.$ZodBranded<z.ZodString, "TodoId", "out">;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    todo_updated: z.ZodObject<{
+        todoId: z.core.$ZodBranded<z.ZodString, "TodoId", "out">;
+        agentId: z.core.$ZodBranded<z.ZodString, "AgentId", "out">;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodEnum<{
+            pending: "pending";
+            in_progress: "in_progress";
+            completed: "completed";
+            cancelled: "cancelled";
+        }>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    todo_deleted: z.ZodObject<{
+        todoId: z.core.$ZodBranded<z.ZodString, "TodoId", "out">;
+        agentId: z.core.$ZodBranded<z.ZodString, "AgentId", "out">;
+    }, z.core.$strip>;
+}>;
+export type TodoCreatedEvent = (typeof todoEvents)['Events']['todo_created'];
+export type TodoUpdatedEvent = (typeof todoEvents)['Events']['todo_updated'];
+export type TodoDeletedEvent = (typeof todoEvents)['Events']['todo_deleted'];
+/**
+ * Session-wide todo configuration.
+ */
+export interface TodoPresetConfig {
+    /** Whether todos are enabled by default (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Agent-specific todo configuration.
+ */
+export interface TodoAgentConfig {
+    /** Whether todos are enabled for this agent (default: true) */
+    enabled?: boolean;
+    /** Initial todos to create when agent spawns */
+    initial?: Array<{
+        title: string;
+        description?: string;
+        metadata?: Record<string, unknown>;
+    }>;
+}
+export declare const todoPlugin: import("../../core/plugins/plugin-builder.js").PluginDefinition<"todos", TodoPresetConfig, TodoAgentConfig, {}, Record<"create", {
+    input: {
+        agentId: string & z.core.$brand<"AgentId">;
+        title: string;
+        description?: string | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    };
+    output: {
+        todoId: string;
+    };
+}> & Record<"update", {
+    input: {
+        agentId: string & z.core.$brand<"AgentId">;
+        todoId: string & z.core.$brand<"TodoId">;
+        title?: string | undefined;
+        description?: string | undefined;
+        status?: "pending" | "in_progress" | "completed" | "cancelled" | undefined;
+        metadata?: Record<string, unknown> | undefined;
+    };
+    output: {};
+}> & Record<"delete", {
+    input: {
+        agentId: string & z.core.$brand<"AgentId">;
+        todoId: string & z.core.$brand<"TodoId">;
+    };
+    output: {};
+}> & Record<"list", {
+    input: {
+        agentId: string & z.core.$brand<"AgentId">;
+        status?: "pending" | "in_progress" | "completed" | "cancelled" | undefined;
+    };
+    output: {
+        todos: {
+            todoId: string & z.core.$brand<"TodoId">;
+            title: string;
+            status: string;
+            agentId: string & z.core.$brand<"AgentId">;
+            createdAt: number;
+            updatedAt: number;
+            description?: string | undefined;
+            metadata?: Record<string, unknown> | undefined;
+        }[];
+    };
+}>>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/todo/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/todo/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAA;AAWtB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;EAsBrB,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,CAAA;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,CAAA;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,CAAA;AAE5E;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,gDAAgD;IAChD,OAAO,CAAC,EAAE,KAAK,CAAC;QACf,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAClC,CAAC,CAAA;CACF;AAID,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2Sd,CAAA"}

package/dist/plugins/todo/prompts.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Todo Status Prompt Builder
+ *
+ * Builds a system message section describing the current state
+ * of todos for injection into agent context.
+ */
+import type { TodoEntry } from './schema.js';
+/**
+ * Build a todo status message for agent context.
+ * Returns null if there are no todos to show.
+ */
+export declare function buildTodoStatusMessage(todos: TodoEntry[]): string | null;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/plugins/todo/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/plugins/todo/prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,GAAG,IAAI,CAiDxE"}

package/dist/plugins/todo/schema.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Todo domain types and schemas
+ *
+ * Todos are task items that agents can create, update, and track.
+ * Each todo belongs to an agent and tracks its completion status.
+ */
+import z from 'zod/v4';
+import type { AgentId } from '../../core/agents';
+/** TodoId schema - validates any string and brands as TodoId. */
+export declare const todoIdSchema: z.core.$ZodBranded<z.ZodString, "TodoId", "out">;
+/** Branded TodoId type */
+export type TodoId = z.infer<typeof todoIdSchema>;
+/** Constructor for TodoId */
+export declare const TodoId: (id: string) => TodoId;
+/** Generate a new TodoId (UUIDv7) */
+export declare const generateTodoId: () => TodoId;
+/**
+ * Todo completion status.
+ */
+export type TodoStatus = 'pending' | 'in_progress' | 'completed' | 'cancelled';
+/**
+ * Todo entry in session state.
+ * Tracks the todo's status, owner, and metadata.
+ */
+export interface TodoEntry {
+    /** Todo instance ID */
+    id: TodoId;
+    /** Owning agent */
+    agentId: AgentId;
+    /** Todo title (short description) */
+    title: string;
+    /** Optional detailed description */
+    description?: string;
+    /** Current status */
+    status: TodoStatus;
+    /** Optional metadata (tags, priority, etc.) */
+    metadata?: Record<string, unknown>;
+    /** Timestamps */
+    createdAt: number;
+    updatedAt: number;
+    completedAt?: number;
+    cancelledAt?: number;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/plugins/todo/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/plugins/todo/schema.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,CAAC,MAAM,QAAQ,CAAA;AACtB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAM5C,iEAAiE;AACjE,eAAO,MAAM,YAAY,kDAA6B,CAAA;AAEtD,0BAA0B;AAC1B,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEjD,6BAA6B;AAC7B,eAAO,MAAM,MAAM,GAAI,IAAI,MAAM,KAAG,MAAsB,CAAA;AAE1D,qCAAqC;AACrC,eAAO,MAAM,cAAc,QAAO,MAA0B,CAAA;AAU5D;;GAEG;AACH,MAAM,MAAM,UAAU,GACnB,SAAS,GACT,aAAa,GACb,WAAW,GACX,WAAW,CAAA;AAMd;;;GAGG;AACH,MAAM,WAAW,SAAS;IACzB,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,mBAAmB;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAA;IACb,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qBAAqB;IACrB,MAAM,EAAE,UAAU,CAAA;IAClB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAClC,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/dist/plugins/todo/todo.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=todo.integration.test.d.ts.map

package/dist/plugins/todo/todo.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.integration.test.d.ts","sourceRoot":"","sources":["../../../src/plugins/todo/todo.integration.test.ts"],"names":[],"mappings":""}

package/dist/plugins/uploads/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Upload module exports
+ */
+export { uploadsPlugin } from './plugin.js';
+export type { UploadsPluginConfig } from './plugin.js';
+export type { Preprocessor, PreprocessorContext, PreprocessorResult } from './preprocessor.js';
+export { PreprocessorRegistry } from './preprocessor.js';
+export { createImageClassifierPreprocessor, type ImageClassifierConfig, ImageClassifierPreprocessor } from './preprocessors/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/uploads/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/uploads/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEtD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAGxD,OAAO,EAAE,iCAAiC,EAAE,KAAK,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/plugins/uploads/plugin.d.ts

@@ -0,0 +1,56 @@
+import type { FileStore } from '../../core/file-store/types.js';
+import type { PreprocessorRegistry } from './preprocessor.js';
+export interface UploadsPluginConfig {
+    dataFileStore: FileStore;
+    preprocessorRegistry?: PreprocessorRegistry;
+}
+export declare const uploadsPlugin: import("../../core/plugins/plugin-builder.js").PluginDefinition<"uploads", UploadsPluginConfig, void, {}, Record<"listPending", {
+    input: {
+        sessionId: string;
+    };
+    output: {
+        uploads: {
+            uploadId: string;
+            filename: string;
+            mimeType: string;
+            size: number;
+            status: "processing" | "ready" | "failed";
+            createdAt: number;
+        }[];
+    };
+}> & Record<"delete", {
+    input: {
+        sessionId: string;
+        uploadId: string;
+    };
+    output: {};
+}> & Record<"loadAttachments", {
+    input: {
+        sessionId: string;
+        uploadIds: string[];
+    };
+    output: {
+        attachments: unknown[];
+    };
+}> & Record<"markUsed", {
+    input: {
+        sessionId: string;
+        uploadIds: string[];
+        messageId: string;
+    };
+    output: {};
+}> & Record<"upload", {
+    input: {
+        sessionId: string;
+        filename: string;
+        mimeType: string;
+        size: number;
+        fileBuffer: Buffer<ArrayBufferLike>;
+    };
+    output: {
+        uploadId: string;
+        status: "ready" | "failed";
+        extractedContent?: string | undefined;
+    };
+}>>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/uploads/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/uploads/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAG3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAiC7D,MAAM,WAAW,mBAAmB;IACnC,aAAa,EAAE,SAAS,CAAA;IACxB,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;CAC3C;AA+BD,eAAO,MAAM,aAAa;;;;;;sBA+FZ,MAAM;sBACN,MAAM;sBACN,MAAM;kBACV,MAAM;oBACJ,YAAY,GAAG,OAAO,GAAG,QAAQ;uBAC9B,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyOZ,CAAA"}

package/dist/plugins/uploads/preprocessor.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Preprocessor - Interface for file upload preprocessing
+ *
+ * Preprocessors extract content from uploaded files to make them
+ * accessible to LLMs. Examples include:
+ * - Image description via vision LLM
+ * - PDF text extraction
+ * - Document conversion
+ */
+import type { FileStore } from '../../core/file-store/types.js';
+import type { Result } from '../../lib/utils/result.js';
+/**
+ * Context provided to preprocessors during file processing.
+ */
+export interface PreprocessorContext {
+    /** FileStore scoped to upload directory for writing derived files */
+    files: FileStore;
+}
+/**
+ * Result of preprocessing a file.
+ */
+export interface PreprocessorResult {
+    /** Extracted text content for LLM consumption */
+    extractedContent?: string;
+    /** Paths to derived files (e.g., extracted images from PDF) */
+    derivedPaths?: string[];
+}
+/**
+ * Interface for file preprocessors.
+ * Each preprocessor handles specific MIME types.
+ */
+export interface Preprocessor {
+    /** Name of the preprocessor for logging */
+    name: string;
+    /** MIME types this preprocessor can handle (supports wildcards like "image/*") */
+    supportedMimeTypes: string[];
+    /**
+     * Process a file and extract content.
+     *
+     * @param filePath - Absolute path to the uploaded file
+     * @param mimeType - MIME type of the file
+     * @param ctx - Context with artifact store for writing derived files
+     * @returns Result with extracted content or error
+     */
+    process(filePath: string, mimeType: string, ctx: PreprocessorContext): Promise<Result<PreprocessorResult, Error>>;
+}
+/**
+ * Registry for file preprocessors.
+ * Manages preprocessor registration and lookup by MIME type.
+ */
+export declare class PreprocessorRegistry {
+    private readonly processors;
+    /**
+     * Register a preprocessor.
+     */
+    register(processor: Preprocessor): void;
+    /**
+     * Get a preprocessor for the given MIME type.
+     * Returns null if no preprocessor supports this type.
+     *
+     * @param mimeType - MIME type to find a preprocessor for
+     * @returns The first matching preprocessor or null
+     */
+    getForMimeType(mimeType: string): Preprocessor | null;
+    /**
+     * Get all registered preprocessors.
+     */
+    getAll(): readonly Preprocessor[];
+}
+//# sourceMappingURL=preprocessor.d.ts.map