@rowan-agent/agent 0.4.7 → 0.4.8

package/README.md

@@ -60,6 +60,8 @@ type AgentOptions = {
   context: AgentContext;
   model: LlmModelRef;
   stream: StreamFn;
+  cwd?: string;
+  rowanDir?: string;     // project-local Rowan directory, default: ".rowan"
   sessionId?: string;
   phases?: PhaseRegistry;
   extensions?: ExtensionRunnerRef;
@@ -460,6 +462,8 @@ export default function myPlugin(rowan: ExtensionAPI) {
 
 Multi-provider model configuration via `.rowan/config.yaml`. Supports multiple API providers, per-model settings, environment variable interpolation, and per-phase model overrides.
 
+Config is loaded from the runtime Rowan directory, which defaults to `.rowan` and can be set when constructing `Agent` via `rowanDir`.
+
 ### Config File
 
 Place `config.yaml` in your `.rowan/` directory (alongside `phases/`, `skills/`, etc.):
@@ -632,13 +636,16 @@ const request = buildModelRequest({ systemPrompt, messages, tools });
 
 ## Workspace
 
-Workspace resolution — dev mode uses the project root, packaged binary uses `~/.rowan`.
+Workspace resolution uses the current project for both source and binary runs. The project Rowan directory defaults to `<cwd>/.rowan`; pass `rowanDir` to resolve another project-local directory.
 
 ```ts
 import { resolveWorkspacePaths, resolveInWorkspace } from "@rowan-agent/agent";
 
 const workspace = resolveWorkspacePaths();
 // → { mode: "source" | "binary", cwd: string, rowanDir: string }
+
+const custom = resolveWorkspacePaths({ rowanDir: ".rowan-project" });
+// → custom.rowanDir is <cwd>/.rowan-project
 ```
 
 ## Loop Metrics

package/dist/{chunk-S7DI7HIF.js → chunk-2FIII4GP.js}

@@ -59,17 +59,10 @@ function detectRuntimeMode(input = {}) {
   const executable = basename(input.execPath ?? process.execPath).toLowerCase().replace(/\.exe$/, "");
   return executable === "bun" ? "source" : "binary";
 }
-function defaultSourceStartDir(options) {
+function defaultWorkspaceStartDir(options) {
   if (options.cwd) {
     return options.cwd;
   }
-  const entrypoint = options.entrypoint ?? process.argv[1];
-  if (entrypoint) {
-    const entrypointPath = resolve(process.cwd(), entrypoint);
-    if (existsSync(entrypointPath)) {
-      return dirname(entrypointPath);
-    }
-  }
   return process.cwd();
 }
 function resolveWorkspaceRoot(options = {}) {
@@ -79,11 +72,7 @@ function resolveWorkspaceRoot(options = {}) {
   if (override) {
     return resolveUserPath(override, homeDir);
   }
-  const mode = options.mode ?? detectRuntimeMode(options);
-  if (mode === "binary") {
-    return homeDir;
-  }
-  return findSourceWorkspaceRoot(defaultSourceStartDir(options));
+  return findSourceWorkspaceRoot(defaultWorkspaceStartDir(options));
 }
 function resolveWorkspacePaths(options = {}) {
   const mode = options.mode ?? detectRuntimeMode(options);
@@ -91,9 +80,16 @@ function resolveWorkspacePaths(options = {}) {
   return {
     mode,
     cwd,
-    rowanDir: join(cwd, BINARY_WORKSPACE_DIR)
+    rowanDir: resolveProjectRowanDir(cwd, options.rowanDir)
   };
 }
+function resolveProjectRowanDir(cwd, rowanDir = BINARY_WORKSPACE_DIR) {
+  const inputPath = rowanDir.trim() || BINARY_WORKSPACE_DIR;
+  if (isAbsolute(inputPath)) {
+    throw new Error(`Project Rowan dir must be a relative path: ${rowanDir}`);
+  }
+  return resolveWorkspacePath({ root: cwd }, inputPath).absolutePath;
+}
 function resolveInWorkspace(path, rootOrPaths) {
   if (path === "~" || path.startsWith("~/") || path.startsWith("~\\")) {
     return resolveUserPath(path, homedir());
@@ -139,6 +135,7 @@ export {
   detectRuntimeMode,
   resolveWorkspaceRoot,
   resolveWorkspacePaths,
+  resolveProjectRowanDir,
   resolveInWorkspace,
   normalizeRelativePath,
   resolveWorkspacePath

package/dist/{chunk-AFRSS3C5.js → chunk-APSIAOUD.js}

@@ -1,7 +1,7 @@
 import {
   resolveInWorkspace,
   resolveWorkspacePaths
-} from "./chunk-S7DI7HIF.js";
+} from "./chunk-2FIII4GP.js";
 
 // src/harness/phases/loader.ts
 import { existsSync as existsSync3 } from "fs";
@@ -370,11 +370,18 @@ var PHASE_DIR = "phases";
 async function loadPhase(input, workspace) {
   const resolved = resolveResourcePath(input, PHASE_DIR, PHASE_MARKER, workspace);
   const { frontmatter, body } = await loadMarkdown(resolved);
+  const id = inferResourceName(resolved, PHASE_MARKER);
+  if (!frontmatter.name) {
+    throw new Error(`Phase "${id}" at "${resolved}" is missing required field "name" in PHASE.md frontmatter.`);
+  }
+  if (!frontmatter.description) {
+    throw new Error(`Phase "${id}" at "${resolved}" is missing required field "description" in PHASE.md frontmatter.`);
+  }
   const baseDir = dirname2(resolved);
   const phase = {
-    id: inferResourceName(resolved, PHASE_MARKER),
-    name: frontmatter.name ?? inferResourceName(resolved, PHASE_MARKER),
-    description: frontmatter.description ?? "",
+    id,
+    name: frontmatter.name,
+    description: frontmatter.description,
     tools: frontmatter.tools,
     skills: frontmatter.skills,
     target: frontmatter.target,
@@ -409,12 +416,16 @@ async function loadPhases(workspace, paths) {
   const phases = /* @__PURE__ */ new Map();
   if (paths && paths.length > 0) {
     for (const path of paths) {
-      const phase = await loadPhase(path, workspace);
-      phases.set(phase.id, phase);
+      try {
+        const phase = await loadPhase(path, workspace);
+        phases.set(phase.id, phase);
+      } catch (error) {
+        console.warn(`Failed to load phase "${path}":`, error);
+      }
     }
     return { phases, entryPhaseId: null };
   }
-  const ws = workspace ?? (await import("./path-TJ2G5L4N.js")).resolveWorkspacePaths();
+  const ws = workspace ?? (await import("./path-XORRK2EC.js")).resolveWorkspacePaths();
   const phasesDir = join3(ws.rowanDir, PHASE_DIR);
   if (!existsSync3(phasesDir)) {
     return { phases, entryPhaseId: null };

package/dist/index.cjs

@@ -41,6 +41,7 @@ __export(path_exports, {
   findSourceWorkspaceRoot: () => findSourceWorkspaceRoot,
   normalizeRelativePath: () => normalizeRelativePath,
   resolveInWorkspace: () => resolveInWorkspace,
+  resolveProjectRowanDir: () => resolveProjectRowanDir,
   resolveWorkspacePath: () => resolveWorkspacePath,
   resolveWorkspacePaths: () => resolveWorkspacePaths,
   resolveWorkspaceRoot: () => resolveWorkspaceRoot
@@ -98,17 +99,10 @@ function detectRuntimeMode(input = {}) {
   const executable = (0, import_node_path.basename)(input.execPath ?? process.execPath).toLowerCase().replace(/\.exe$/, "");
   return executable === "bun" ? "source" : "binary";
 }
-function defaultSourceStartDir(options) {
+function defaultWorkspaceStartDir(options) {
   if (options.cwd) {
     return options.cwd;
   }
-  const entrypoint = options.entrypoint ?? process.argv[1];
-  if (entrypoint) {
-    const entrypointPath = (0, import_node_path.resolve)(process.cwd(), entrypoint);
-    if ((0, import_node_fs.existsSync)(entrypointPath)) {
-      return (0, import_node_path.dirname)(entrypointPath);
-    }
-  }
   return process.cwd();
 }
 function resolveWorkspaceRoot(options = {}) {
@@ -118,11 +112,7 @@ function resolveWorkspaceRoot(options = {}) {
   if (override) {
     return resolveUserPath(override, homeDir);
   }
-  const mode = options.mode ?? detectRuntimeMode(options);
-  if (mode === "binary") {
-    return homeDir;
-  }
-  return findSourceWorkspaceRoot(defaultSourceStartDir(options));
+  return findSourceWorkspaceRoot(defaultWorkspaceStartDir(options));
 }
 function resolveWorkspacePaths(options = {}) {
   const mode = options.mode ?? detectRuntimeMode(options);
@@ -130,9 +120,16 @@ function resolveWorkspacePaths(options = {}) {
   return {
     mode,
     cwd,
-    rowanDir: (0, import_node_path.join)(cwd, BINARY_WORKSPACE_DIR)
+    rowanDir: resolveProjectRowanDir(cwd, options.rowanDir)
   };
 }
+function resolveProjectRowanDir(cwd, rowanDir = BINARY_WORKSPACE_DIR) {
+  const inputPath = rowanDir.trim() || BINARY_WORKSPACE_DIR;
+  if ((0, import_node_path.isAbsolute)(inputPath)) {
+    throw new Error(`Project Rowan dir must be a relative path: ${rowanDir}`);
+  }
+  return resolveWorkspacePath({ root: cwd }, inputPath).absolutePath;
+}
 function resolveInWorkspace(path, rootOrPaths) {
   if (path === "~" || path.startsWith("~/") || path.startsWith("~\\")) {
     return resolveUserPath(path, (0, import_node_os.homedir)());
@@ -567,11 +564,18 @@ __export(loader_exports, {
 async function loadPhase(input, workspace) {
   const resolved = resolveResourcePath(input, PHASE_DIR, PHASE_MARKER, workspace);
   const { frontmatter, body } = await loadMarkdown(resolved);
+  const id = inferResourceName(resolved, PHASE_MARKER);
+  if (!frontmatter.name) {
+    throw new Error(`Phase "${id}" at "${resolved}" is missing required field "name" in PHASE.md frontmatter.`);
+  }
+  if (!frontmatter.description) {
+    throw new Error(`Phase "${id}" at "${resolved}" is missing required field "description" in PHASE.md frontmatter.`);
+  }
   const baseDir = (0, import_node_path4.dirname)(resolved);
   const phase = {
-    id: inferResourceName(resolved, PHASE_MARKER),
-    name: frontmatter.name ?? inferResourceName(resolved, PHASE_MARKER),
-    description: frontmatter.description ?? "",
+    id,
+    name: frontmatter.name,
+    description: frontmatter.description,
     tools: frontmatter.tools,
     skills: frontmatter.skills,
     target: frontmatter.target,
@@ -606,8 +610,12 @@ async function loadPhases(workspace, paths) {
   const phases = /* @__PURE__ */ new Map();
   if (paths && paths.length > 0) {
     for (const path of paths) {
-      const phase = await loadPhase(path, workspace);
-      phases.set(phase.id, phase);
+      try {
+        const phase = await loadPhase(path, workspace);
+        phases.set(phase.id, phase);
+      } catch (error) {
+        console.warn(`Failed to load phase "${path}":`, error);
+      }
     }
     return { phases, entryPhaseId: null };
   }
@@ -715,6 +723,7 @@ __export(index_exports, {
   loadConfigFile: () => loadConfigFile,
   loadExtensionFromFactory: () => loadExtensionFromFactory,
   loadExtensions: () => loadExtensions,
+  loadPhases: () => loadPhases,
   loadSkill: () => loadSkill,
   loadSkills: () => loadSkills,
   messageContentText: () => messageContentText,
@@ -2688,7 +2697,7 @@ var Agent = class {
    * - Merges with CLI-provided phases and skills
    */
   async discoverResources(context) {
-    const workspace = resolveWorkspacePaths({ cwd: this.options.cwd });
+    const workspace = resolveWorkspacePaths({ cwd: this.options.cwd, rowanDir: this.options.rowanDir });
     const filePhases = await loadPhases(workspace);
     let phases;
     const providedPhases = this.options.phases;
@@ -2848,7 +2857,7 @@ ${additionalInstructions}` : content;
    * @returns Formatted phase content string, or empty string if not found
    */
   async phase(name) {
-    const workspace = resolveWorkspacePaths({ cwd: this.options.cwd });
+    const workspace = resolveWorkspacePaths({ cwd: this.options.cwd, rowanDir: this.options.rowanDir });
     const { loadPhase: loadPhase2, readPhaseContent: readPhaseContent2 } = await Promise.resolve().then(() => (init_loader2(), loader_exports));
     try {
       const phase = await loadPhase2(name, workspace);
@@ -4198,13 +4207,19 @@ var ExtensionRunner = class {
     if (!registration.id) {
       throw new Error(`Phase registration requires an "id" field.`);
     }
+    if (!registration.name) {
+      throw new Error(`Phase registration "${registration.id}" requires a "name" field.`);
+    }
+    if (!registration.description) {
+      throw new Error(`Phase registration "${registration.id}" requires a "description" field.`);
+    }
     if (this.phases.has(registration.id)) {
       throw new Error(`Duplicate phase id: ${registration.id}`);
     }
     const definition = {
       id: registration.id,
-      name: registration.name ?? registration.id,
-      description: registration.description ?? "",
+      name: registration.name,
+      description: registration.description,
       run: registration.run,
       ...registration.model ? { model: registration.model } : {}
     };
@@ -4288,14 +4303,19 @@ function readManifestSync(dir) {
   }
 }
 function jitiAliases() {
-  return {
-    "@rowan-agent/agent": (0, import_node_url.fileURLToPath)(new URL("../index.ts", import_meta2.url)),
-    "@rowan-agent/models": (0, import_node_url.fileURLToPath)(new URL("../../../models/src/index.ts", import_meta2.url))
-  };
+  const moduleUrl = import_meta2.url;
+  if (!moduleUrl) {
+    return {};
+  }
+  const agentSourcePath = (0, import_node_url.fileURLToPath)(new URL("../index.ts", moduleUrl));
+  if (!(0, import_node_fs6.existsSync)(agentSourcePath)) {
+    return {};
+  }
+  return { "@rowan-agent/agent": agentSourcePath };
 }
 var sharedJiti;
 function getJiti() {
-  sharedJiti ??= (0, import_jiti.createJiti)(import_meta2.url, {
+  sharedJiti ??= (0, import_jiti.createJiti)(import_meta2.url || process.cwd(), {
     moduleCache: false,
     alias: jitiAliases()
   });
@@ -4398,6 +4418,9 @@ async function discoverAndLoadExtensions(cwd) {
   return loadExtensions(paths, cwd);
 }
 
+// src/index.ts
+init_loader2();
+
 // src/harness/context/index.ts
 init_resource_formatter();
 // Annotate the CommonJS export names for ESM import in node:
@@ -4430,6 +4453,7 @@ init_resource_formatter();
   loadConfigFile,
   loadExtensionFromFactory,
   loadExtensions,
+  loadPhases,
   loadSkill,
   loadSkills,
   messageContentText,

package/dist/index.d.cts

@@ -1381,6 +1381,7 @@ type AgentOptions = {
     model: LlmModelRef;
     stream: StreamFn;
     cwd?: string;
+    rowanDir?: string;
     phases?: PhaseRegistry;
     extensionRunnerRef?: ExtensionRunnerRef;
     sessionId?: string;
@@ -1700,6 +1701,7 @@ type ResolveWorkspaceOptions = {
     entrypoint?: string;
     homeDir?: string;
     mode?: RuntimeMode;
+    rowanDir?: string;
 };
 declare function resolveWorkspacePaths(options?: ResolveWorkspaceOptions): WorkspacePaths;
 declare function resolveInWorkspace(path: string, rootOrPaths: string | Pick<WorkspacePaths, "cwd">): string;
@@ -1774,6 +1776,18 @@ declare class AgentEventStream extends EventStream<AgentEvent, AgentMessage[]> {
     constructor();
 }
 
+/**
+ * Load all phases from .rowan/phases directory.
+ *
+ * Scans for subdirectories containing PHASE.md files.
+ * Returns PhaseRegistry with entryPhaseId:
+ * - null by default (caller must explicitly set to start from a specific phase)
+ * - Set to a specific phase id to start from that phase
+ *
+ * When entryPhaseId is null, AgentLoop starts from "none" phase.
+ */
+declare function loadPhases(workspace?: WorkspacePaths, paths?: string[]): Promise<PhaseRegistry>;
+
 interface SystemPromptOptions {
     /** Base system prompt. */
     systemPrompt: string;
@@ -1827,4 +1841,4 @@ declare function buildModelRequest(input: ModelRequestInput, options?: {
     model?: LlmModelRef;
 }): LlmRequest;
 
-export { type AbortEvent, type AfterPhaseEvent, type AfterPhaseHookResult, type AfterPhaseResult, type AfterToolCallEvent, type AfterToolCallResult, Agent, type AgentConfigFile, type AgentContext, type AgentEndEvent, AgentEventStream, type AgentOptions, type AgentStartEvent, type AgentStatus, type BeforePhaseEvent, type BeforePhaseHookResult, type BeforePhaseResult, type BeforePromptEvent, type BeforePromptResult, type BeforeToolCallEvent, type BeforeToolCallResult, type EventBus, EventStream, type ExecOptions, type ExecResult, type ExecutionTurn, type Extension, type ExtensionAPI, type ExtensionContext, type ExtensionError, type ExtensionErrorListener, type ExtensionFactory, type ExtensionManifest, type ExtensionPackageManifest, ExtensionRunner, type ExtensionRunnerOptions, type ExtensionRunnerRef, type ExtensionRuntime, type ExtensionUtils, HookError, type HookEvent, type HookEventType, type HookHandler, type HookResultMap, HooksManager, type LoadExtensionsResult, type LoadedExtension, LocalJsonlSessionManager, type LoopMetrics, type MessageEndEvent, type MessageStartEvent, type MessageUpdateEvent, type ModelConfigFromFile, type ModelTranscript, type Phase, type PhaseContext, type PhaseDefinition, type PhaseExecution, type PhaseOutput, type PhaseRegistration, type PhaseRegistry, type PhaseRun, type PhaseState, type ProviderConfigFromFile, type QueueUpdateEvent, type RegisteredPhase, type RegisteredTool, type RunOptions, type RunResult, type SavePointEvent, type Session, type SessionListItem, type SettledEvent, type SourceInfo, type Tool, type ToolDefinition, type ToolExecutionEndEvent, type ToolExecutionResult, type ToolExecutionStartEvent, type ToolExecutionUpdateEvent, type TurnEndEvent, type TurnStartEvent, type WorkspacePaths, appendUserTurn, buildModelRequest, buildSystemPrompt, conversationMessages, createCoreTools, createEventBus, createExtension, createExtensionAPI, createExtensionRunner, createExtensionRuntime, createId, createMessage, createSession, createSourceInfo, createTimestamp, discoverAndLoadExtensions, getGlobalHooks, interpolateEnvVars, latestUserInput, loadConfigFile, loadExtensionFromFactory, loadExtensions, loadSkill, loadSkills, messageContentText, parseModelRef, registerConfigModels, resetGlobalHooks, resolveDefaultModel, resolveInWorkspace, resolveSkillPath, resolveWorkspacePaths, serializeSkills };
+export { type AbortEvent, type AfterPhaseEvent, type AfterPhaseHookResult, type AfterPhaseResult, type AfterToolCallEvent, type AfterToolCallResult, Agent, type AgentConfigFile, type AgentContext, type AgentEndEvent, AgentEventStream, type AgentOptions, type AgentStartEvent, type AgentStatus, type BeforePhaseEvent, type BeforePhaseHookResult, type BeforePhaseResult, type BeforePromptEvent, type BeforePromptResult, type BeforeToolCallEvent, type BeforeToolCallResult, type EventBus, EventStream, type ExecOptions, type ExecResult, type ExecutionTurn, type Extension, type ExtensionAPI, type ExtensionContext, type ExtensionError, type ExtensionErrorListener, type ExtensionFactory, type ExtensionManifest, type ExtensionPackageManifest, ExtensionRunner, type ExtensionRunnerOptions, type ExtensionRunnerRef, type ExtensionRuntime, type ExtensionUtils, HookError, type HookEvent, type HookEventType, type HookHandler, type HookResultMap, HooksManager, type LoadExtensionsResult, type LoadedExtension, LocalJsonlSessionManager, type LoopMetrics, type MessageEndEvent, type MessageStartEvent, type MessageUpdateEvent, type ModelConfigFromFile, type ModelTranscript, type Phase, type PhaseContext, type PhaseDefinition, type PhaseExecution, type PhaseOutput, type PhaseRegistration, type PhaseRegistry, type PhaseRun, type PhaseState, type ProviderConfigFromFile, type QueueUpdateEvent, type RegisteredPhase, type RegisteredTool, type RunOptions, type RunResult, type SavePointEvent, type Session, type SessionListItem, type SettledEvent, type SourceInfo, type Tool, type ToolDefinition, type ToolExecutionEndEvent, type ToolExecutionResult, type ToolExecutionStartEvent, type ToolExecutionUpdateEvent, type TurnEndEvent, type TurnStartEvent, type WorkspacePaths, appendUserTurn, buildModelRequest, buildSystemPrompt, conversationMessages, createCoreTools, createEventBus, createExtension, createExtensionAPI, createExtensionRunner, createExtensionRuntime, createId, createMessage, createSession, createSourceInfo, createTimestamp, discoverAndLoadExtensions, getGlobalHooks, interpolateEnvVars, latestUserInput, loadConfigFile, loadExtensionFromFactory, loadExtensions, loadPhases, loadSkill, loadSkills, messageContentText, parseModelRef, registerConfigModels, resetGlobalHooks, resolveDefaultModel, resolveInWorkspace, resolveSkillPath, resolveWorkspacePaths, serializeSkills };

package/dist/index.d.ts

@@ -1381,6 +1381,7 @@ type AgentOptions = {
     model: LlmModelRef;
     stream: StreamFn;
     cwd?: string;
+    rowanDir?: string;
     phases?: PhaseRegistry;
     extensionRunnerRef?: ExtensionRunnerRef;
     sessionId?: string;
@@ -1700,6 +1701,7 @@ type ResolveWorkspaceOptions = {
     entrypoint?: string;
     homeDir?: string;
     mode?: RuntimeMode;
+    rowanDir?: string;
 };
 declare function resolveWorkspacePaths(options?: ResolveWorkspaceOptions): WorkspacePaths;
 declare function resolveInWorkspace(path: string, rootOrPaths: string | Pick<WorkspacePaths, "cwd">): string;
@@ -1774,6 +1776,18 @@ declare class AgentEventStream extends EventStream<AgentEvent, AgentMessage[]> {
     constructor();
 }
 
+/**
+ * Load all phases from .rowan/phases directory.
+ *
+ * Scans for subdirectories containing PHASE.md files.
+ * Returns PhaseRegistry with entryPhaseId:
+ * - null by default (caller must explicitly set to start from a specific phase)
+ * - Set to a specific phase id to start from that phase
+ *
+ * When entryPhaseId is null, AgentLoop starts from "none" phase.
+ */
+declare function loadPhases(workspace?: WorkspacePaths, paths?: string[]): Promise<PhaseRegistry>;
+
 interface SystemPromptOptions {
     /** Base system prompt. */
     systemPrompt: string;
@@ -1827,4 +1841,4 @@ declare function buildModelRequest(input: ModelRequestInput, options?: {
     model?: LlmModelRef;
 }): LlmRequest;
 
-export { type AbortEvent, type AfterPhaseEvent, type AfterPhaseHookResult, type AfterPhaseResult, type AfterToolCallEvent, type AfterToolCallResult, Agent, type AgentConfigFile, type AgentContext, type AgentEndEvent, AgentEventStream, type AgentOptions, type AgentStartEvent, type AgentStatus, type BeforePhaseEvent, type BeforePhaseHookResult, type BeforePhaseResult, type BeforePromptEvent, type BeforePromptResult, type BeforeToolCallEvent, type BeforeToolCallResult, type EventBus, EventStream, type ExecOptions, type ExecResult, type ExecutionTurn, type Extension, type ExtensionAPI, type ExtensionContext, type ExtensionError, type ExtensionErrorListener, type ExtensionFactory, type ExtensionManifest, type ExtensionPackageManifest, ExtensionRunner, type ExtensionRunnerOptions, type ExtensionRunnerRef, type ExtensionRuntime, type ExtensionUtils, HookError, type HookEvent, type HookEventType, type HookHandler, type HookResultMap, HooksManager, type LoadExtensionsResult, type LoadedExtension, LocalJsonlSessionManager, type LoopMetrics, type MessageEndEvent, type MessageStartEvent, type MessageUpdateEvent, type ModelConfigFromFile, type ModelTranscript, type Phase, type PhaseContext, type PhaseDefinition, type PhaseExecution, type PhaseOutput, type PhaseRegistration, type PhaseRegistry, type PhaseRun, type PhaseState, type ProviderConfigFromFile, type QueueUpdateEvent, type RegisteredPhase, type RegisteredTool, type RunOptions, type RunResult, type SavePointEvent, type Session, type SessionListItem, type SettledEvent, type SourceInfo, type Tool, type ToolDefinition, type ToolExecutionEndEvent, type ToolExecutionResult, type ToolExecutionStartEvent, type ToolExecutionUpdateEvent, type TurnEndEvent, type TurnStartEvent, type WorkspacePaths, appendUserTurn, buildModelRequest, buildSystemPrompt, conversationMessages, createCoreTools, createEventBus, createExtension, createExtensionAPI, createExtensionRunner, createExtensionRuntime, createId, createMessage, createSession, createSourceInfo, createTimestamp, discoverAndLoadExtensions, getGlobalHooks, interpolateEnvVars, latestUserInput, loadConfigFile, loadExtensionFromFactory, loadExtensions, loadSkill, loadSkills, messageContentText, parseModelRef, registerConfigModels, resetGlobalHooks, resolveDefaultModel, resolveInWorkspace, resolveSkillPath, resolveWorkspacePaths, serializeSkills };
+export { type AbortEvent, type AfterPhaseEvent, type AfterPhaseHookResult, type AfterPhaseResult, type AfterToolCallEvent, type AfterToolCallResult, Agent, type AgentConfigFile, type AgentContext, type AgentEndEvent, AgentEventStream, type AgentOptions, type AgentStartEvent, type AgentStatus, type BeforePhaseEvent, type BeforePhaseHookResult, type BeforePhaseResult, type BeforePromptEvent, type BeforePromptResult, type BeforeToolCallEvent, type BeforeToolCallResult, type EventBus, EventStream, type ExecOptions, type ExecResult, type ExecutionTurn, type Extension, type ExtensionAPI, type ExtensionContext, type ExtensionError, type ExtensionErrorListener, type ExtensionFactory, type ExtensionManifest, type ExtensionPackageManifest, ExtensionRunner, type ExtensionRunnerOptions, type ExtensionRunnerRef, type ExtensionRuntime, type ExtensionUtils, HookError, type HookEvent, type HookEventType, type HookHandler, type HookResultMap, HooksManager, type LoadExtensionsResult, type LoadedExtension, LocalJsonlSessionManager, type LoopMetrics, type MessageEndEvent, type MessageStartEvent, type MessageUpdateEvent, type ModelConfigFromFile, type ModelTranscript, type Phase, type PhaseContext, type PhaseDefinition, type PhaseExecution, type PhaseOutput, type PhaseRegistration, type PhaseRegistry, type PhaseRun, type PhaseState, type ProviderConfigFromFile, type QueueUpdateEvent, type RegisteredPhase, type RegisteredTool, type RunOptions, type RunResult, type SavePointEvent, type Session, type SessionListItem, type SettledEvent, type SourceInfo, type Tool, type ToolDefinition, type ToolExecutionEndEvent, type ToolExecutionResult, type ToolExecutionStartEvent, type ToolExecutionUpdateEvent, type TurnEndEvent, type TurnStartEvent, type WorkspacePaths, appendUserTurn, buildModelRequest, buildSystemPrompt, conversationMessages, createCoreTools, createEventBus, createExtension, createExtensionAPI, createExtensionRunner, createExtensionRuntime, createId, createMessage, createSession, createSourceInfo, createTimestamp, discoverAndLoadExtensions, getGlobalHooks, interpolateEnvVars, latestUserInput, loadConfigFile, loadExtensionFromFactory, loadExtensions, loadPhases, loadSkill, loadSkills, messageContentText, parseModelRef, registerConfigModels, resetGlobalHooks, resolveDefaultModel, resolveInWorkspace, resolveSkillPath, resolveWorkspacePaths, serializeSkills };

package/dist/index.js

@@ -16,12 +16,12 @@ import {
   reloadPhases,
   resolveDefaultModel,
   resolveResourcePath
-} from "./chunk-AFRSS3C5.js";
+} from "./chunk-APSIAOUD.js";
 import {
   normalizeRelativePath,
   resolveInWorkspace,
   resolveWorkspacePaths
-} from "./chunk-S7DI7HIF.js";
+} from "./chunk-2FIII4GP.js";
 
 // src/utils.ts
 function createId(prefix) {
@@ -1966,7 +1966,7 @@ var Agent = class {
    * - Merges with CLI-provided phases and skills
    */
   async discoverResources(context) {
-    const workspace = resolveWorkspacePaths({ cwd: this.options.cwd });
+    const workspace = resolveWorkspacePaths({ cwd: this.options.cwd, rowanDir: this.options.rowanDir });
     const filePhases = await loadPhases(workspace);
     let phases;
     const providedPhases = this.options.phases;
@@ -2126,8 +2126,8 @@ ${additionalInstructions}` : content;
    * @returns Formatted phase content string, or empty string if not found
    */
   async phase(name) {
-    const workspace = resolveWorkspacePaths({ cwd: this.options.cwd });
-    const { loadPhase: loadPhase2, readPhaseContent: readPhaseContent2 } = await import("./loader-UKBWDLDZ.js");
+    const workspace = resolveWorkspacePaths({ cwd: this.options.cwd, rowanDir: this.options.rowanDir });
+    const { loadPhase: loadPhase2, readPhaseContent: readPhaseContent2 } = await import("./loader-MVD5JAKM.js");
     try {
       const phase = await loadPhase2(name, workspace);
       return readPhaseContent2(phase);
@@ -3471,13 +3471,19 @@ var ExtensionRunner = class {
     if (!registration.id) {
       throw new Error(`Phase registration requires an "id" field.`);
     }
+    if (!registration.name) {
+      throw new Error(`Phase registration "${registration.id}" requires a "name" field.`);
+    }
+    if (!registration.description) {
+      throw new Error(`Phase registration "${registration.id}" requires a "description" field.`);
+    }
     if (this.phases.has(registration.id)) {
       throw new Error(`Duplicate phase id: ${registration.id}`);
     }
     const definition = {
       id: registration.id,
-      name: registration.name ?? registration.id,
-      description: registration.description ?? "",
+      name: registration.name,
+      description: registration.description,
       run: registration.run,
       ...registration.model ? { model: registration.model } : {}
     };
@@ -3560,14 +3566,19 @@ function readManifestSync(dir) {
   }
 }
 function jitiAliases() {
-  return {
-    "@rowan-agent/agent": fileURLToPath(new URL("../index.ts", import.meta.url)),
-    "@rowan-agent/models": fileURLToPath(new URL("../../../models/src/index.ts", import.meta.url))
-  };
+  const moduleUrl = import.meta.url;
+  if (!moduleUrl) {
+    return {};
+  }
+  const agentSourcePath = fileURLToPath(new URL("../index.ts", moduleUrl));
+  if (!existsSync2(agentSourcePath)) {
+    return {};
+  }
+  return { "@rowan-agent/agent": agentSourcePath };
 }
 var sharedJiti;
 function getJiti() {
-  sharedJiti ??= createJiti(import.meta.url, {
+  sharedJiti ??= createJiti(import.meta.url || process.cwd(), {
     moduleCache: false,
     alias: jitiAliases()
   });
@@ -3698,6 +3709,7 @@ export {
   loadConfigFile,
   loadExtensionFromFactory,
   loadExtensions,
+  loadPhases,
   loadSkill,
   loadSkills,
   messageContentText,

package/dist/{loader-UKBWDLDZ.js → loader-MVD5JAKM.js}

@@ -3,8 +3,8 @@ import {
   loadPhases,
   readPhaseContent,
   reloadPhases
-} from "./chunk-AFRSS3C5.js";
-import "./chunk-S7DI7HIF.js";
+} from "./chunk-APSIAOUD.js";
+import "./chunk-2FIII4GP.js";
 export {
   loadPhase,
   loadPhases,

package/dist/{path-TJ2G5L4N.js → path-XORRK2EC.js}

@@ -7,10 +7,11 @@ import {
   findSourceWorkspaceRoot,
   normalizeRelativePath,
   resolveInWorkspace,
+  resolveProjectRowanDir,
   resolveWorkspacePath,
   resolveWorkspacePaths,
   resolveWorkspaceRoot
-} from "./chunk-S7DI7HIF.js";
+} from "./chunk-2FIII4GP.js";
 export {
   BINARY_WORKSPACE_DIR,
   PACKAGED_ENV,
@@ -20,6 +21,7 @@ export {
   findSourceWorkspaceRoot,
   normalizeRelativePath,
   resolveInWorkspace,
+  resolveProjectRowanDir,
   resolveWorkspacePath,
   resolveWorkspacePaths,
   resolveWorkspaceRoot

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rowan-agent/agent",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "license": "MIT",
   "repository": {
     "type": "git",