@roj-ai/sdk 0.0.2

package/dist/plugins/llm-debug/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/llm-debug/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4EH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;GAwFlB,CAAA"}

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

@@ -0,0 +1,2 @@
+export { logsPlugin } from './plugin.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/logs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA"}

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

@@ -0,0 +1,10 @@
+export declare const logsPlugin: import("../../core/plugins/plugin-builder.js").PluginDefinition<"logs", void, void, {}, Record<"tail", {
+    input: {
+        since?: number | undefined;
+    };
+    output: {
+        lines: string[];
+        offset: number;
+    };
+}>>;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/logs/plugin.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,UAAU;;;;;;;;GAiCd,CAAA"}

package/dist/plugins/mailbox/helpers.d.ts

@@ -0,0 +1,20 @@
+import { AgentId } from '../../core/agents';
+import { AgentState } from '../../core/agents/state';
+/**
+ * Check if an agent can communicate with another agent.
+ * Communication is only allowed with:
+ * - Parent agent
+ * - Child agents
+ * - Special case: communicator ↔ orchestrator (both are root-level)
+ */
+export declare const canCommunicateWith: (session: {
+    agents: Map<AgentId, AgentState>;
+}, fromAgentId: AgentId, toAgentId: AgentId) => boolean;
+/**
+ * Get list of agents that the given agent can communicate with.
+ * Returns parent (if exists), children, and communicator/orchestrator peer (if applicable).
+ */
+export declare const getCommunicableAgents: (session: {
+    agents: Map<AgentId, AgentState>;
+}, agentId: AgentId) => AgentId[];
+//# sourceMappingURL=helpers.d.ts.map

package/dist/plugins/mailbox/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/plugins/mailbox/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,GAC9B,SAAS;IAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;CAAE,EAC7C,aAAa,OAAO,EACpB,WAAW,OAAO,KAChB,OAyBF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GACjC,SAAS;IAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;CAAE,EAC7C,SAAS,OAAO,KACd,OAAO,EAiCT,CAAA"}

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

@@ -0,0 +1,9 @@
+/**
+ * Mailbox plugin - inter-agent communication
+ */
+export { type MailboxAgentConfig, mailboxPlugin, type MailboxPresetConfig } from './plugin.js';
+export { type MailboxConsumedEvent, mailboxEvents, type MailboxMessageEvent, type MailboxMessageSender } from './state.js';
+export { canCommunicateWith, getCommunicableAgents } from './helpers.js';
+export { generateMessageId, generateTestMessageId, type MailboxMessage, MessageId, messageIdSchema } from './schema.js';
+export { getAgentMailbox, getAgentUnconsumedMailbox, getNextMessageSeq, type MailboxPluginState, selectMailboxState } from './query.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/mailbox/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,kBAAkB,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAE9F,OAAO,EAAE,KAAK,oBAAoB,EAAE,aAAa,EAAE,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAE1H,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAExE,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,KAAK,cAAc,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAEvH,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA"}

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

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

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * Mailbox Plugin - Inter-agent communication via message passing
+ *
+ * Level 1 (Preset): Empty config (mailbox is always enabled)
+ * Level 2 (Session): Events factory + state slice + methods + tools
+ * Level 3 (Agent): send_message tool for communication
+ */
+import z from "zod/v4";
+/**
+ * Session-wide mailbox configuration.
+ */
+export type MailboxPresetConfig = {};
+/**
+ * Agent-specific mailbox configuration.
+ */
+export interface MailboxAgentConfig {
+    /** If true, agent sends a completion message to its parent when it has no more work. */
+    sendCompletionMessage?: boolean;
+}
+export declare const mailboxPlugin: import("../../core/plugins/plugin-builder.js").PluginDefinition<"mailbox", MailboxPresetConfig, MailboxAgentConfig, {}, Record<"send", {
+    input: {
+        toAgentId: string & z.core.$brand<"AgentId">;
+        content: string;
+        fromAgentId?: (string & z.core.$brand<"AgentId">) | undefined;
+        debug?: boolean | undefined;
+    };
+    output: {
+        messageId: string;
+    };
+}>>;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/mailbox/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,CAAC,MAAM,QAAQ,CAAC;AAyBvB;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,wFAAwF;IACxF,qBAAqB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,eAAO,MAAM,aAAa;;;;;;;;;;GA+NjB,CAAC"}

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

@@ -0,0 +1,21 @@
+import type { MailboxMessage } from './schema.js';
+/**
+ * Briefing for entry agents (orchestrator without communicator).
+ * Entry agents can communicate directly with users and orchestrate children.
+ */
+export declare const ENTRY_ROLE_SECTION = "## Your Role: Entry Agent (Orchestrator)\n\nYou are the entry point for user communication AND you orchestrate child agents. See your available tools for capabilities.";
+/**
+ * Reporting instructions for child agents.
+ * Child agents cannot communicate with users directly.
+ */
+export declare const CHILD_REPORTING_SECTION = "## Your Role: Child Agent\n\nYou were spawned by a parent agent to handle a specific task. You CANNOT communicate with users directly. See your available tools for capabilities.\n\nFocus on completing your assigned task.\n\n## Reporting (MANDATORY)\n\n**You MUST always report back to your parent via `send_message` with `to: \"parent\"` before stopping.** This is the most important rule \u2014 your parent is waiting for your response and cannot proceed without it.\n\n- **Task completed**: Call `send_message` with `to: \"parent\"` and a structured final result summarizing what you accomplished and any relevant outputs.\n- **Task failed / blocked**: If you encounter an error, are blocked, or cannot complete the task for any reason, you MUST still call `send_message` with `to: \"parent\"` explaining what went wrong and what you attempted.\n- **Progress updates**: For long-running tasks, report progress to your parent periodically via `send_message` with `to: \"parent\"`.\n\n**Never stop without calling `send_message` with `to: \"parent\"`.** Silent termination leaves your parent stuck waiting indefinitely.";
+/**
+ * Reporting instructions for orchestrator agents (when there's a communicator).
+ */
+export declare const ORCHESTRATOR_REPORTING_SECTION = "## Your Role: Orchestrator\n\nYou coordinate work and spawn child agents to complete tasks. You do NOT communicate directly with users. See your available tools for capabilities.\n\nYou receive tasks from the communicator via `send_message`. The communicator's agent ID is in the `from` field of the message you receive.\n\n## Reporting (MANDATORY)\n\n**You MUST always report back to the communicator via `send_message` before stopping.** The communicator is waiting for your response and cannot update the user without it.\n\n- **Task completed**: Send a structured result summarizing what was accomplished.\n- **Task failed / blocked**: If you cannot complete the task, you MUST still send a message explaining what went wrong.\n- **Progress updates**: For long-running tasks, report progress to the communicator periodically.\n\n**Never stop without sending a message to the communicator.** Silent termination leaves the communicator and user stuck waiting indefinitely.";
+/**
+ * Message flow instructions for communicator agents.
+ */
+export declare const COMMUNICATOR_FLOW_SECTION = "## Your Role: Communicator\n\nYou handle user communication and relay messages to/from the orchestrator. See your available tools for capabilities.\n\n## Message Flow\n\n- User messages arrive to you first\n- Forward tasks to the orchestrator via `send_message` (use the orchestrator's agent ID from messages)\n- When the orchestrator reports back, format and relay the results to the user via `tell_user`";
+export declare const formatMailboxForLLM: (messages: MailboxMessage[], currentTimestamp?: number) => string;
+//# sourceMappingURL=prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/plugins/mailbox/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAMjD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,4KAE6F,CAAA;AAE5H;;;GAGG;AACH,eAAO,MAAM,uBAAuB,omCAcqG,CAAA;AAEzI;;GAEG;AACH,eAAO,MAAM,8BAA8B,m9BAcmG,CAAA;AAE9I;;GAEG;AACH,eAAO,MAAM,yBAAyB,0ZAQ2D,CAAA;AAMjG,eAAO,MAAM,mBAAmB,GAAI,UAAU,cAAc,EAAE,EAAE,mBAAmB,MAAM,KAAG,MAiC3F,CAAA"}

package/dist/plugins/mailbox/query.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Mailbox plugin query helpers.
+ *
+ * Query functions accept MailboxPluginState directly.
+ * Use selectMailboxState() to extract plugin state from SessionState.
+ */
+import type { AgentId } from '../../core/agents/schema.js';
+import type { SessionState } from '../../core/sessions/state.js';
+import type { MailboxMessage } from './schema.js';
+/**
+ * Mailbox plugin state — session-level state keyed by agent ID.
+ */
+export interface MailboxPluginState {
+    agentMailboxes: Map<AgentId, MailboxMessage[]>;
+}
+/**
+ * Extract MailboxPluginState from SessionState.
+ */
+export declare function selectMailboxState(sessionState: SessionState): MailboxPluginState;
+/**
+ * Get all mailbox messages for a specific agent.
+ */
+export declare function getAgentMailbox(pluginState: MailboxPluginState, agentId: AgentId): MailboxMessage[];
+/**
+ * Get unconsumed mailbox messages for a specific agent.
+ */
+export declare function getAgentUnconsumedMailbox(pluginState: MailboxPluginState, agentId: AgentId): MailboxMessage[];
+/**
+ * Get the next message sequence number.
+ * Derived from total message count across all mailboxes (replay-safe).
+ */
+export declare function getNextMessageSeq(pluginState: MailboxPluginState): number;
+//# sourceMappingURL=query.d.ts.map

package/dist/plugins/mailbox/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/plugins/mailbox/query.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,cAAc,EAAE,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,CAAA;CAC9C;AAID;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG,kBAAkB,CAEjF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,EAAE,CAEnG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,EAAE,CAE7G;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,kBAAkB,GAAG,MAAM,CAMzE"}

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

@@ -0,0 +1,54 @@
+/**
+ * Message domain types and schemas
+ *
+ * Contains all types related to messages:
+ * - Branded ID type and constructor
+ * - Mailbox types
+ * - AskUser input types
+ * - Zod schemas for validation
+ */
+import z from 'zod/v4';
+import { COMMUNICATOR_ROLE, ORCHESTRATOR_ROLE } from '../../core/agents/agent-roles.js';
+import type { AgentId } from '../../core/agents/schema.js';
+import type { MessageAttachment } from '../uploads/schema.js';
+import type { WorkerId } from '../workers/worker.js';
+/** MessageId schema - validates any string and brands as MessageId. */
+export declare const messageIdSchema: z.core.$ZodBranded<z.ZodString, "MessageId", "out">;
+/** Branded MessageId type */
+export type MessageId = z.infer<typeof messageIdSchema>;
+/** Constructor for MessageId */
+export declare const MessageId: (id: string) => MessageId;
+/**
+ * Generate a short message ID.
+ * Format: m{seq} e.g., "m1", "m42"
+ */
+export declare const generateMessageId: (seq: number) => MessageId;
+/**
+ * Generate a test message ID (for tests only).
+ * Uses incrementing counter for uniqueness.
+ */
+export declare const generateTestMessageId: () => MessageId;
+/**
+ * Sender of a mailbox message.
+ * Can be an agent, user, system roles, or a worker.
+ */
+export type MailboxMessageSender = AgentId | WorkerId | 'user' | 'debug' | typeof ORCHESTRATOR_ROLE | typeof COMMUNICATOR_ROLE;
+/**
+ * Message in an agent's mailbox.
+ */
+export type MailboxMessage = {
+    id: MessageId;
+    from: MailboxMessageSender;
+    content: string;
+    timestamp: number;
+    consumed: boolean;
+    /** If this message is an answer to a question, the question's message ID */
+    answerTo?: MessageId;
+    /** The answer value (JSON-serializable), only present when answerTo is set */
+    answerValue?: unknown;
+    /** File attachments uploaded with this message */
+    attachments?: MessageAttachment[];
+    /** Optional context visible to LLM but not displayed in chat UI */
+    context?: string;
+};
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/plugins/mailbox/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,CAAC,MAAM,QAAQ,CAAA;AACtB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AACvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAMpD,uEAAuE;AACvE,eAAO,MAAM,eAAe,qDAAgC,CAAA;AAE5D,6BAA6B;AAC7B,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,gCAAgC;AAChC,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,KAAG,SAA4B,CAAA;AAEnE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,KAAG,SAAiC,CAAA;AAQjF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAO,SAA2C,CAAA;AAMpF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAC7B,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,OAAO,iBAAiB,GACxB,OAAO,iBAAiB,CAAA;AAE3B;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,EAAE,EAAE,SAAS,CAAA;IACb,IAAI,EAAE,oBAAoB,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,OAAO,CAAA;IACjB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,kDAAkD;IAClD,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAA;IACjC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA"}

package/dist/plugins/mailbox/state.d.ts

@@ -0,0 +1,40 @@
+import z4 from 'zod/v4';
+import { AgentId } from '../../core/agents';
+import { COMMUNICATOR_ROLE, ORCHESTRATOR_ROLE } from '../../core/agents/agent-roles';
+import { WorkerId } from '../workers/worker';
+export type MailboxMessageSender = AgentId | WorkerId | 'user' | 'debug' | typeof ORCHESTRATOR_ROLE | typeof COMMUNICATOR_ROLE;
+export declare const mailboxEvents: import("../../core/events/types").EventsFactory<{
+    mailbox_message: z4.ZodObject<{
+        toAgentId: z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">;
+        message: z4.ZodObject<{
+            id: z4.core.$ZodBranded<z4.ZodString, "MessageId", "out">;
+            from: z4.ZodUnion<readonly [z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">, z4.core.$ZodBranded<z4.ZodString, "WorkerId", "out">, z4.ZodEnum<{
+                orchestrator: "orchestrator";
+                communicator: "communicator";
+                user: "user";
+                debug: "debug";
+            }>]>;
+            content: z4.ZodString;
+            timestamp: z4.ZodNumber;
+            consumed: z4.ZodBoolean;
+            answerTo: z4.ZodOptional<z4.core.$ZodBranded<z4.ZodString, "MessageId", "out">>;
+            answerValue: z4.ZodOptional<z4.ZodUnknown>;
+            attachments: z4.ZodOptional<z4.ZodArray<z4.ZodObject<{
+                uploadId: z4.core.$ZodBranded<z4.ZodString, "UploadId", "out">;
+                filename: z4.ZodString;
+                mimeType: z4.ZodString;
+                size: z4.ZodNumber;
+                path: z4.ZodString;
+                extractedContent: z4.ZodOptional<z4.ZodString>;
+                derivedPaths: z4.ZodOptional<z4.ZodArray<z4.ZodString>>;
+            }, z4.core.$strip>>>;
+        }, z4.core.$strip>;
+    }, z4.core.$strip>;
+    mailbox_consumed: z4.ZodObject<{
+        agentId: z4.core.$ZodBranded<z4.ZodString, "AgentId", "out">;
+        messageIds: z4.ZodArray<z4.core.$ZodBranded<z4.ZodString, "MessageId", "out">>;
+    }, z4.core.$strip>;
+}>;
+export type MailboxMessageEvent = (typeof mailboxEvents)['Events']['mailbox_message'];
+export type MailboxConsumedEvent = (typeof mailboxEvents)['Events']['mailbox_consumed'];
+//# sourceMappingURL=state.d.ts.map

package/dist/plugins/mailbox/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/plugins/mailbox/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,QAAQ,CAAA;AACvB,OAAO,EAAE,OAAO,EAAiB,MAAM,eAAe,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAIhF,OAAO,EAAE,QAAQ,EAAkB,MAAM,mBAAmB,CAAA;AAE5D,MAAM,MAAM,oBAAoB,GAC7B,OAAO,GACP,QAAQ,GACR,MAAM,GACN,OAAO,GACP,OAAO,iBAAiB,GACxB,OAAO,iBAAiB,CAAA;AAE3B,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgCxB,CAAA;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,iBAAiB,CAAC,CAAA;AACrF,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,kBAAkB,CAAC,CAAA"}

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

@@ -0,0 +1,7 @@
+export { resourcesPlugin } from './plugin.js';
+export type { ResourcesPluginConfig } from './plugin.js';
+export { postInjectRules } from './post-inject.js';
+export type { PostInjectContext, PostInjectExecOptions, PostInjectHook, PostInjectRule, } from './post-inject.js';
+export { RESOURCE_MANIFEST_FILENAME, ResourceManifestSchema } from './manifest.js';
+export type { ResourceManifest } from './manifest.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAClD,YAAY,EACX,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,cAAc,GACd,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AAClF,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA"}

package/dist/plugins/resources/manifest.d.ts

@@ -0,0 +1,23 @@
+import z from 'zod/v4';
+/**
+ * File at the root of a resource zip that ships template-specific setup
+ * instructions (e.g. `bun install` for a JS template). Read by the resources
+ * plugin after extraction, then deleted so it doesn't pollute the workspace.
+ */
+export declare const RESOURCE_MANIFEST_FILENAME = "roj.resource.json";
+export declare const ResourceManifestSchema: z.ZodObject<{
+    postInject: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        when: z.ZodOptional<z.ZodString>;
+        cwd: z.ZodOptional<z.ZodEnum<{
+            target: "target";
+            session: "session";
+        }>>;
+        run: z.ZodTuple<[z.ZodString], z.ZodString>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        continueOnError: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ResourceManifest = z.infer<typeof ResourceManifestSchema>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/plugins/resources/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/plugins/resources/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAA;AAGtB;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,sBAAsB,CAAA;AAY7D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;iBAEjC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA"}

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

@@ -0,0 +1,28 @@
+import { type PostInjectHook } from './post-inject.js';
+export interface ResourcesPluginConfig {
+    targetDir?: string;
+    /**
+     * Called after a resource is written/extracted into `targetDir`, before the
+     * `resource_injected` event is emitted. Use `postInjectRules` for a declarative
+     * setup, or pass a custom async function for full control.
+     */
+    postInject?: PostInjectHook;
+}
+export declare const resourcesPlugin: import("../../core/plugins/plugin-builder.js").PluginDefinition<"resources", ResourcesPluginConfig, void, {}, Record<"inject", {
+    input: {
+        sessionId: string;
+        filename: string;
+        mimeType: string;
+        size: number;
+        fileBuffer: Buffer<ArrayBufferLike>;
+        metadata?: {
+            slug?: string | undefined;
+            name?: string | undefined;
+        } | undefined;
+    };
+    output: {
+        resourceId: string;
+        paths: string[];
+    };
+}>>;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/resources/plugin.ts"],"names":[],"mappings":"AAOA,OAAO,EAGN,KAAK,cAAc,EAEnB,MAAM,kBAAkB,CAAA;AAKzB,MAAM,WAAW,qBAAqB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,cAAc,CAAA;CAC3B;AAsCD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;GAyInB,CAAA"}

package/dist/plugins/resources/post-inject.d.ts

@@ -0,0 +1,39 @@
+import type { Logger } from '../../lib/logger/logger.js';
+import type { FileSystem } from '../../platform/fs.js';
+export interface PostInjectExecOptions {
+    cwd?: string;
+    timeout?: number;
+    env?: Record<string, string>;
+}
+export interface PostInjectContext {
+    targetDir: string;
+    sessionDir: string;
+    paths: string[];
+    filename: string;
+    mimeType: string;
+    logger: Logger;
+    exec(cmd: string, args: string[], options?: PostInjectExecOptions): Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+    fs: FileSystem;
+}
+export type PostInjectHook = (ctx: PostInjectContext) => Promise<void>;
+export interface PostInjectRule {
+    /** Log label — defaults to the command string. */
+    name?: string;
+    /** Relative path (inside `cwd`) that must exist for the rule to fire. Omit to always run. */
+    when?: string;
+    /** Working directory — `target` (default) = injection targetDir, `session` = sessionDir. */
+    cwd?: 'target' | 'session';
+    /** Command + args. */
+    run: [string, ...string[]];
+    /** Environment overrides, merged into process.env. */
+    env?: Record<string, string>;
+    /** Command timeout in ms. Default 300000 (5 min). */
+    timeoutMs?: number;
+    /** If false, a failing rule throws and aborts subsequent rules. Default: true (warn + continue). */
+    continueOnError?: boolean;
+}
+export declare function postInjectRules(rules: PostInjectRule[]): PostInjectHook;
+//# sourceMappingURL=post-inject.d.ts.map

package/dist/plugins/resources/post-inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-inject.d.ts","sourceRoot":"","sources":["../../../src/plugins/resources/post-inject.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,MAAM,WAAW,qBAAqB;IACrC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC5B;AAED,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CACH,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,qBAAqB,GAC7B,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC9C,EAAE,EAAE,UAAU,CAAA;CACd;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAEtE,MAAM,WAAW,cAAc;IAC9B,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6FAA6F;IAC7F,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4FAA4F;IAC5F,GAAG,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC1B,sBAAsB;IACtB,GAAG,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;IAC1B,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,oGAAoG;IACpG,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,CA6BvE"}

package/dist/plugins/resources/state.d.ts

@@ -0,0 +1,25 @@
+import z4 from 'zod/v4';
+export declare const resourceEvents: import("../../core/events/types").EventsFactory<{
+    resource_injected: z4.ZodObject<{
+        resourceId: z4.ZodString;
+        slug: z4.ZodOptional<z4.ZodString>;
+        name: z4.ZodOptional<z4.ZodString>;
+        filename: z4.ZodString;
+        mimeType: z4.ZodString;
+        paths: z4.ZodArray<z4.ZodString>;
+        injectedAt: z4.ZodNumber;
+    }, z4.core.$strip>;
+}>;
+export interface InjectedResource {
+    resourceId: string;
+    slug?: string;
+    name?: string;
+    filename: string;
+    mimeType: string;
+    paths: string[];
+    injectedAt: number;
+}
+export interface ResourcesState {
+    resources: InjectedResource[];
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/plugins/resources/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/plugins/resources/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,QAAQ,CAAA;AAGvB,eAAO,MAAM,cAAc;;;;;;;;;;EAYzB,CAAA;AAEF,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,gBAAgB,EAAE,CAAA;CAC7B"}

package/dist/plugins/result-eviction/index.d.ts

@@ -0,0 +1,3 @@
+export { resultEvictionPlugin } from './plugin.js';
+export type { EvictionAgentConfig, EvictionConfig } from './plugin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/result-eviction/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/result-eviction/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA"}

package/dist/plugins/result-eviction/plugin.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Result Eviction Plugin - saves large tool outputs to disk
+ *
+ * When a tool produces output exceeding the token threshold, the full output is saved
+ * to a file in the session's .results directory, and a truncated preview with
+ * head + tail + file path is returned instead.
+ */
+export interface EvictionConfig {
+    /** Max tokens before eviction (default: 20000) */
+    maxTokens?: number;
+}
+export interface EvictionAgentConfig {
+    /** Whether result eviction is enabled for this agent (default: true) */
+    enabled?: boolean;
+    /** Eviction configuration */
+    config?: EvictionConfig;
+}
+export declare const resultEvictionPlugin: import("../../core/plugins/plugin-builder.js").PluginDefinition<"result-eviction", void, EvictionAgentConfig, {}, {}>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugins/result-eviction/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/result-eviction/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,cAAc;IAC9B,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,mBAAmB;IACnC,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,cAAc,CAAA;CACvB;AAID,eAAO,MAAM,oBAAoB,mHAuCxB,CAAA"}

package/dist/plugins/result-eviction/result-eviction.integration.test.d.ts

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

package/dist/plugins/result-eviction/result-eviction.integration.test.d.ts.map

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

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

@@ -0,0 +1,85 @@
+import z from 'zod/v4';
+import type { PortPool } from './port-pool.js';
+import type { ServiceConfig } from './schema.js';
+export declare const serviceEvents: import("../../core/events/types.js").EventsFactory<{
+    service_status_changed: z.ZodObject<{
+        serviceType: z.ZodString;
+        toStatus: z.ZodEnum<{
+            paused: "paused";
+            stopped: "stopped";
+            starting: "starting";
+            ready: "ready";
+            stopping: "stopping";
+            failed: "failed";
+        }>;
+        port: z.ZodOptional<z.ZodNumber>;
+        error: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodNumber>;
+        pidStartTime: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}>;
+export type ServiceStatusChangedEvent = (typeof serviceEvents)['Events']['service_status_changed'];
+/**
+ * Session-wide service configuration.
+ */
+export interface ServicePluginConfig {
+    services: ServiceConfig[];
+    portPool: PortPool;
+}
+/**
+ * Agent-specific service configuration.
+ */
+export interface ServiceAgentConfig {
+    services: string[];
+}
+export declare const servicePlugin: import("../../core/plugins/plugin-builder.js").PluginDefinition<"services", ServicePluginConfig, ServiceAgentConfig, {}, Record<"start", {
+    input: {
+        serviceType?: string | undefined;
+        all?: boolean | undefined;
+        waitForReady?: boolean | undefined;
+    };
+    output: {
+        started?: string[] | undefined;
+    };
+}> & Record<"stop", {
+    input: {
+        serviceType: string;
+    };
+    output: {};
+}> & Record<"restart", {
+    input: {
+        serviceType: string;
+    };
+    output: {};
+}> & Record<"list", {
+    input: Record<string, never>;
+    output: {
+        services: {
+            serviceType: string;
+            status: string;
+            port?: number | undefined;
+        }[];
+    };
+}> & Record<"status", {
+    input: {
+        serviceType: string;
+        logLines?: number | undefined;
+    };
+    output: {
+        serviceType: string;
+        status: string;
+        recentLogs: string[];
+        port?: number | undefined;
+        error?: string | undefined;
+    };
+}> & Record<"logs", {
+    input: {
+        serviceType: string;
+        lines?: number | undefined;
+    };
+    output: {
+        serviceType: string;
+        lines: string[];
+    };
+}>>;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/services/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAA;AAOtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAA;AAG9D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;EAWxB,CAAA;AAEF,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,QAAQ,CAAC,CAAC,wBAAwB,CAAC,CAAA;AAElG;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,QAAQ,EAAE,aAAa,EAAE,CAAA;IACzB,QAAQ,EAAE,QAAQ,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0bjB,CAAA"}

package/dist/plugins/services/port-pool.d.ts

@@ -0,0 +1,32 @@
+/**
+ * PortPool - Manages port allocation from a global range.
+ *
+ * Ports are assigned from the upper registered range (10000–49151) to avoid
+ * common dev server defaults and OS ephemeral ports. Allocation is random
+ * to minimize predictable conflicts across sessions.
+ */
+export declare class PortPool {
+    private readonly minPort;
+    private readonly maxPort;
+    private readonly allocated;
+    constructor(minPort?: number, maxPort?: number);
+    /**
+     * Try to allocate a specific (preferred) port.
+     * Returns true if the port was available and is now allocated.
+     */
+    tryAllocate(port: number): boolean;
+    /**
+     * Allocate a random available port from the range.
+     * Returns null if the pool is exhausted (practically impossible).
+     */
+    allocate(): number | null;
+    /**
+     * Allocate preferred port if available, otherwise allocate a random port.
+     */
+    allocatePreferred(preferred: number | undefined): number | null;
+    /**
+     * Release a previously allocated port back to the pool.
+     */
+    release(port: number): void;
+}
+//# sourceMappingURL=port-pool.d.ts.map

package/dist/plugins/services/port-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-pool.d.ts","sourceRoot":"","sources":["../../../src/plugins/services/port-pool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,qBAAa,QAAQ;IAInB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;gBAG5B,OAAO,SAAQ,EACf,OAAO,SAAQ;IAGjC;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOlC;;;OAGG;IACH,QAAQ,IAAI,MAAM,GAAG,IAAI;IAyBzB;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI;IAO/D;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG3B"}

package/dist/plugins/services/prompt.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Service Status Prompt Builder
+ *
+ * Builds a system message section describing the current state
+ * of session services for injection into agent context.
+ */
+import type { ServiceConfig, ServiceEntry } from '../../plugins/services/schema.js';
+/**
+ * Build a service status message for agent context.
+ * Returns null if there are no services to show.
+ */
+export declare function buildServiceStatusMessage(services: ServiceEntry[], configs: ServiceConfig[]): string | null;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/plugins/services/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/plugins/services/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAE/E;;;GAGG;AACH,wBAAgB,yBAAyB,CACxC,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE,aAAa,EAAE,GACtB,MAAM,GAAG,IAAI,CAoCf"}