@comma-agents/core 2.0.0-rc.0 → 2.0.0-rc.1

package/dist/strategy/discover/discover.types.d.ts

@@ -1,7 +1,6 @@
 /**
  * Where a discovered strategy was found.
  *
- * - `bundled` — shipped with `@comma-agents/core` under `packages/core/strategies/`.
  * - `cwd` — single strategy file under `<cwd>/.comma/strategies/`.
  * - `cwd-project` — strategy referenced by a `comma-project.json`
  *   inside `<cwd>/.comma/strategies/<project>/`.
@@ -9,8 +8,10 @@
  * - `data` — single strategy file under `<dataDir>/strategies/`.
  * - `data-project` — strategy referenced by a `comma-project.json`
  *   inside `<dataDir>/strategies/<project>/`.
+ * - `hub-package` — exposed strategy from an installed Hub package.
+ * - `bundled` — exposed strategy from the official strategies bundled with Core.
  */
-export type DiscoveredStrategyOrigin = "bundled" | "bundled-project" | "cwd" | "cwd-project" | "cwd-root-project" | "data" | "data-project";
+export type DiscoveredStrategyOrigin = "cwd" | "cwd-project" | "cwd-root-project" | "data" | "data-project" | "hub-package" | "bundled";
 /** A successfully discovered and schema-validated strategy. */
 export interface DiscoveredStrategy {
     /** Strategy `name` field from the file. */
@@ -52,8 +53,8 @@ export interface DiscoverStrategiesOptions {
      */
     readonly dataDir?: string;
     /**
-     * Whether to include the strategies bundled with `@comma-agents/core`
-     * (under `packages/core/strategies/`). Defaults to `true`.
+     * Include the official strategies bundled with Core.
+     * Defaults to `true`.
      */
     readonly includeBundled?: boolean;
 }
@@ -61,7 +62,7 @@ export interface DiscoverStrategiesOptions {
 export interface DiscoverStrategiesResult {
     /**
      * Schema-validated strategies, in source-priority order:
-     * bundled → cwd → cwd-project → cwd-root-project → data → data-project.
+     * cwd → cwd-project → cwd-root-project → data → data-project → hub-package → bundled.
      * Duplicates (by absolute path) are removed.
      */
     readonly strategies: readonly DiscoveredStrategy[];

package/dist/strategy/discover/discover.utils.d.ts

@@ -67,6 +67,8 @@ export declare function listStrategyFiles(dir: string): string[];
  * subdirectory of `dir` that contains one.
  */
 export declare function listProjectManifests(dir: string): string[];
+/** List installed Hub manifests under `<dataDir>/packages/@scope/project`. */
+export declare function listInstalledProjectManifests(dataDir: string): string[];
 /**
  * Build a {@link DiscoveredStrategy} from a parsed strategy header.
  * Project-scoped entries get a `"<project> > <name>"` label.
@@ -80,16 +82,3 @@ export declare function buildDiscoveredStrategy(input: {
     readonly projectName?: string;
     readonly manifestPath?: string;
 }): DiscoveredStrategy;
-/**
- * Locate the root directory of the `@comma-agents/core` package.
- *
- * Walks up from this source file looking for a `package.json` whose
- * `name === "@comma-agents/core"`. This works in both workspace
- * development (where the source lives under `packages/core/src/`) and
- * when the package is consumed from `node_modules`.
- *
- * Returns `null` if the package root cannot be located (e.g., when the
- * file has been bundled into a single artifact without a package
- * manifest nearby).
- */
-export declare function findCorePackageRoot(): string | null;

package/dist/strategy/discover/index.d.ts

@@ -1,3 +1,3 @@
-export { discoverStrategies } from "./discover";
+export { discoverStrategies, resolveInstalledStrategyReference, } from "./discover";
 export type { DiscoveredStrategy, DiscoveredStrategyOrigin, DiscoverStrategiesOptions, DiscoverStrategiesResult, DiscoveryWarning, } from "./discover.types";
 export { readStrategyFile } from "./discover.utils";

package/dist/strategy/index.d.ts

@@ -1,10 +1,10 @@
 export type { DiscoveredStrategy, DiscoveredStrategyOrigin, DiscoverStrategiesOptions, DiscoverStrategiesResult, DiscoveryWarning, } from "./discover/index";
-export { discoverStrategies, readStrategyFile } from "./discover/index";
+export { discoverStrategies, readStrategyFile, resolveInstalledStrategyReference, } from "./discover/index";
 export { exportStrategy } from "./exporter/exporter";
 export type { ExportStrategyOptions } from "./exporter/exporter.types";
 export { loadStrategy, loadStrategyFromString } from "./loader/loader";
 export type { LoadedStrategy, LoadStrategyOptions, } from "./loader/loader.types";
 export type { LoadedProject } from "./loader/project-loader";
 export { loadProject } from "./loader/project-loader";
-export type { AgentDef, AgentStep, BroadcastFlowDef, BuiltInToolName, CommaProjectManifest, CycleFlowDef, FlowDef, LLMAgentDef, SequentialFlowDef, Strategy, UserAgentDef, } from "./schema";
-export { CommaProjectManifestSchema, isAgentStep, isFlowDef, isLLMAgentDef, isUserAgentDef, StrategySchema, } from "./schema";
+export type { AgentDef, AgentStep, BroadcastFlowDef, BuiltInToolName, CustomAgentDef, CustomFlowDef, CycleFlowDef, FlowDef, LLMAgentDef, SequentialFlowDef, Strategy, UserAgentDef, } from "./schema";
+export { CustomAgentDefSchema, CustomFlowDefSchema, isAgentStep, isCustomAgentDef, isFlowDef, isLLMAgentDef, isUserAgentDef, StrategySchema, } from "./schema";

package/dist/strategy/loader/loader.types.d.ts

@@ -1,9 +1,6 @@
 import type { Agent } from "../../agents/agent/agent.types";
-import type { InputCollector } from "../../agents/built-in/user/user-agent.types";
+import type { AgentTypeRuntime } from "../../agents/registry/agent-registry.types";
 import type { FlowHooks } from "../../flows/flow/flow.types";
-import type { LanguageService } from "../../language";
-import type { SkillRegistry } from "../../skills/skills.types";
-import type { LaunchStrategyHandle } from "../../tools/launch-strategy.types";
 import type { Strategy } from "../schema";
 /**
  * Options for loading a strategy.
@@ -13,78 +10,13 @@ import type { Strategy } from "../schema";
  * not accept provider factories or credential stores — callers must
  * configure those globally before loading a strategy.
  */
-export interface LoadStrategyOptions {
-    /**
-     * Input collector function for user agents.
-     * Required if the strategy contains any user agents with `requireInput: true`.
-     */
-    readonly inputCollector?: InputCollector;
+export interface LoadStrategyOptions extends AgentTypeRuntime {
     /**
      * Flow hooks to inject into all flows via `hookIntoFlow()` after
      * construction. Useful for the daemon to observe step execution,
      * flow lifecycle, etc.
      */
     readonly flowHooks?: FlowHooks;
-    /**
-     * Override the model for ALL LLM agents in the strategy.
-     *
-     * When set, every agent's model string is replaced with this value,
-     * regardless of what the strategy file specifies. Format: "providerID/modelID".
-     *
-     * Useful for the daemon's `--model-override` flag, allowing a single
-     * daemon instance to serve any provider/model combination without
-     * editing strategy files.
-     *
-     * @example "github-copilot/gpt-4o"
-     */
-    readonly modelOverride?: string;
-    /**
-     * Skill registry to make available to every LLM agent in this strategy.
-     *
-     * When provided, every agent that lists `load_skill` in its `tools`
-     * array can resolve skill names against this registry. The loader also
-     * prepends a compact `## Available Skills` block to each agent's
-     * `systemPrompt` so the model knows what to ask for. Build the
-     * registry with `loadSkills(workspaceRoot)`.
-     */
-    readonly skillRegistry?: SkillRegistry;
-    /**
-     * Optional base directory of the strategy file, used to resolve relative paths
-     * (such as system prompt file paths).
-     */
-    readonly strategyDir?: string;
-    /**
-     * Optional handle for spawning sub-strategies, threaded into every
-     * agent's {@link ToolContext} so tools such as `launch_strategy` can
-     * delegate to a runtime-supplied implementation (e.g., the daemon
-     * executor, which wires the nested run's flow/agent hooks to the
-     * parent run's broadcast pipeline).
-     *
-     * When omitted, `launch_strategy` falls back to an in-process
-     * `loadStrategy` + `flow.call()` invocation with no broadcast.
-     */
-    readonly launchStrategy?: LaunchStrategyHandle;
-    /** Optional runtime language service threaded into every agent tool call. */
-    readonly languageService?: LanguageService;
-    /**
-     * Optional run identifier propagated to every agent's
-     * {@link AgentConfig.runId} (and from there into each tool's
-     * {@link ToolContext.runId}).
-     *
-     * Distinct from `sessionId` (which scopes the audit log and trash
-     * metadata across an entire user/daemon session): `runId` identifies
-     * a single strategy invocation. The daemon executor passes the
-     * top-level run id here, and gives each `launch_strategy` sub-load
-     * a *fresh* derived id, so recursive strategy invocations have
-     * isolated state for tools that key on `runId` (notably `todo_*`,
-     * which shares state across agents within one invocation but must not
-     * leak into recursive sub-runs).
-     *
-     * When omitted, runId-aware tools fall back to `agentName`-only
-     * keying (their original behaviour) — safe for tests and embedded
-     * callers that don't care about cross-launch isolation.
-     */
-    readonly runId?: string;
 }
 /**
  * The result of loading a strategy — contains the runnable flow

package/dist/strategy/loader/loader.utils.d.ts

@@ -1,6 +1,6 @@
 import type { Agent } from "../../agents/agent/agent.types";
 import type { SkillRegistry } from "../../skills/skills.types";
-import type { FlowDef, Strategy } from "../schema";
+import type { Strategy } from "../schema";
 import type { LoadStrategyOptions } from "./loader.types";
 /**
  * Build all agents defined in the strategy into live Agent instances.
@@ -11,10 +11,3 @@ import type { LoadStrategyOptions } from "./loader.types";
 export declare function buildAgentRegistry(strategy: Strategy, options: LoadStrategyOptions): Promise<Record<string, Agent>>;
 /** @internal Used by tests to assert the header gets attached. */
 export declare function previewSkillsHeader(registry: SkillRegistry): string;
-/**
- * Recursively build a flow definition into a runnable Agent.
- *
- * If `options.flowHooks` is provided, hooks are injected into the
- * created flow via `hookIntoFlow()` after construction.
- */
-export declare function buildFlow(flowDef: FlowDef, agents: Readonly<Record<string, Agent>>, options: LoadStrategyOptions): Agent;

package/dist/strategy/loader/project-loader.d.ts

@@ -1,9 +1,15 @@
-import type { CommaProjectManifest } from "../schema";
+import { type CommaProjectManifest } from "../../hub";
+/** A validated project manifest and its location on disk. */
 export interface LoadedProject {
+    /** Project name displayed with its discovered strategies. */
     readonly name: string;
+    /** Optional project version from the manifest. */
     readonly version?: string;
+    /** Optional project description from the manifest. */
     readonly description?: string;
+    /** Validated project manifest. */
     readonly manifest: CommaProjectManifest;
+    /** Absolute directory containing the manifest. */
     readonly manifestDir: string;
 }
 export declare function loadProject(manifestPath: string): Promise<LoadedProject>;

package/dist/strategy/schema.d.ts

@@ -53,16 +53,15 @@ export declare const LLMAgentDefSchema: z.ZodObject<{
      */
     skills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /**
-     * Per-call provider options forwarded verbatim to the AI SDK. Used to
-     * enable provider-specific features such as Anthropic extended thinking
-     * or OpenAI reasoning effort. Shape:
+     * Per-call options for provider-specific features such as extended
+     * thinking or reasoning effort. Shape:
      * `{ <providerId>: { <option>: <value>, ... }, ... }`.
      */
     providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     /**
-     * Model-level generation parameters (temperature, maxOutputTokens, topP, seed,
-     * etc.). Forwarded to `streamText` as top-level options. Provider-specific
-     * features should use `providerOptions` instead.
+     * Provider-independent generation parameters such as temperature,
+     * maxOutputTokens, topP, and seed. Provider-specific features belong in
+     * `providerOptions` instead.
      */
     modelOptions: z.ZodOptional<z.ZodObject<{
         temperature: z.ZodOptional<z.ZodNumber>;
@@ -138,13 +137,13 @@ export declare const LLMAgentDefSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     type?: "llm" | undefined;
     description?: string | undefined;
+    tools?: string[] | undefined;
     model?: string | undefined;
     systemPrompt?: string | undefined;
     systemPromptTemplate?: {
         template: string;
         variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
     } | undefined;
-    tools?: string[] | undefined;
     providerOptions?: Record<string, Record<string, unknown>> | undefined;
     modelOptions?: {
         temperature?: number | undefined;
@@ -171,13 +170,13 @@ export declare const LLMAgentDefSchema: z.ZodObject<{
 }, {
     type?: "llm" | undefined;
     description?: string | undefined;
+    tools?: string[] | undefined;
     model?: string | undefined;
     systemPrompt?: string | undefined;
     systemPromptTemplate?: {
         template: string;
         variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
     } | undefined;
-    tools?: string[] | undefined;
     providerOptions?: Record<string, Record<string, unknown>> | undefined;
     modelOptions?: {
         temperature?: number | undefined;
@@ -202,11 +201,24 @@ export declare const LLMAgentDefSchema: z.ZodObject<{
     maxSteps?: number | undefined;
     skills?: string[] | undefined;
 }>;
-/**
- * An agent definition is either a user agent or an LLM agent.
- * Discriminated by the `type` field (user agents must have `type: "user"`,
- * LLM agents may omit `type` or set `type: "llm"`).
- */
+/** A custom registered agent with implementation-specific configuration. */
+export declare const CustomAgentDefSchema: z.ZodObject<{
+    /** Name registered with `registerAgent`. */
+    type: z.ZodEffects<z.ZodString, string, string>;
+    /** Optional human-readable description. */
+    description: z.ZodOptional<z.ZodString>;
+    /** Configuration validated by the registered agent type. */
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    type: string;
+    description?: string | undefined;
+    config?: Record<string, unknown> | undefined;
+}, {
+    type: string;
+    description?: string | undefined;
+    config?: Record<string, unknown> | undefined;
+}>;
+/** A built-in user, built-in LLM, or registered custom agent definition. */
 export declare const AgentDefSchema: z.ZodUnion<[z.ZodObject<{
     type: z.ZodLiteral<"user">;
     description: z.ZodOptional<z.ZodString>;
@@ -256,16 +268,15 @@ export declare const AgentDefSchema: z.ZodUnion<[z.ZodObject<{
      */
     skills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     /**
-     * Per-call provider options forwarded verbatim to the AI SDK. Used to
-     * enable provider-specific features such as Anthropic extended thinking
-     * or OpenAI reasoning effort. Shape:
+     * Per-call options for provider-specific features such as extended
+     * thinking or reasoning effort. Shape:
      * `{ <providerId>: { <option>: <value>, ... }, ... }`.
      */
     providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     /**
-     * Model-level generation parameters (temperature, maxOutputTokens, topP, seed,
-     * etc.). Forwarded to `streamText` as top-level options. Provider-specific
-     * features should use `providerOptions` instead.
+     * Provider-independent generation parameters such as temperature,
+     * maxOutputTokens, topP, and seed. Provider-specific features belong in
+     * `providerOptions` instead.
      */
     modelOptions: z.ZodOptional<z.ZodObject<{
         temperature: z.ZodOptional<z.ZodNumber>;
@@ -341,13 +352,13 @@ export declare const AgentDefSchema: z.ZodUnion<[z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     type?: "llm" | undefined;
     description?: string | undefined;
+    tools?: string[] | undefined;
     model?: string | undefined;
     systemPrompt?: string | undefined;
     systemPromptTemplate?: {
         template: string;
         variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
     } | undefined;
-    tools?: string[] | undefined;
     providerOptions?: Record<string, Record<string, unknown>> | undefined;
     modelOptions?: {
         temperature?: number | undefined;
@@ -374,13 +385,13 @@ export declare const AgentDefSchema: z.ZodUnion<[z.ZodObject<{
 }, {
     type?: "llm" | undefined;
     description?: string | undefined;
+    tools?: string[] | undefined;
     model?: string | undefined;
     systemPrompt?: string | undefined;
     systemPromptTemplate?: {
         template: string;
         variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
     } | undefined;
-    tools?: string[] | undefined;
     providerOptions?: Record<string, Record<string, unknown>> | undefined;
     modelOptions?: {
         temperature?: number | undefined;
@@ -404,6 +415,21 @@ export declare const AgentDefSchema: z.ZodUnion<[z.ZodObject<{
     } | undefined;
     maxSteps?: number | undefined;
     skills?: string[] | undefined;
+}>, z.ZodObject<{
+    /** Name registered with `registerAgent`. */
+    type: z.ZodEffects<z.ZodString, string, string>;
+    /** Optional human-readable description. */
+    description: z.ZodOptional<z.ZodString>;
+    /** Configuration validated by the registered agent type. */
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strict", z.ZodTypeAny, {
+    type: string;
+    description?: string | undefined;
+    config?: Record<string, unknown> | undefined;
+}, {
+    type: string;
+    description?: string | undefined;
+    config?: Record<string, unknown> | undefined;
 }>]>;
 /** A step that references a named agent from the registry. */
 export declare const AgentStepSchema: z.ZodObject<{
@@ -499,8 +525,28 @@ export declare const BroadcastFlowDefSchema: z.ZodObject<{
     description?: string | undefined;
     separator?: string | undefined;
 }>;
-/** A flow definition — discriminated union by `type`. */
-export declare const FlowDefSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+/** A custom registered flow with implementation-specific configuration. */
+export declare const CustomFlowDefSchema: z.ZodObject<{
+    type: z.ZodEffects<z.ZodString, string, string>;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">;
+}, "strict", z.ZodTypeAny, {
+    type: string;
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+    config?: Record<string, unknown> | undefined;
+}, {
+    type: string;
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+    config?: Record<string, unknown> | undefined;
+}>;
+/** A built-in or registered custom flow definition. */
+export declare const FlowDefSchema: z.ZodUnion<[z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
     type: z.ZodLiteral<"sequential">;
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -575,6 +621,24 @@ export declare const FlowDefSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject
     steps: any[];
     description?: string | undefined;
     separator?: string | undefined;
+}>]>, z.ZodObject<{
+    type: z.ZodEffects<z.ZodString, string, string>;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">;
+}, "strict", z.ZodTypeAny, {
+    type: string;
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+    config?: Record<string, unknown> | undefined;
+}, {
+    type: string;
+    name: string;
+    steps: any[];
+    description?: string | undefined;
+    config?: Record<string, unknown> | undefined;
 }>]>;
 export declare const StrategySchema: z.ZodObject<{
     name: z.ZodString;
@@ -629,16 +693,15 @@ export declare const StrategySchema: z.ZodObject<{
          */
         skills: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         /**
-         * Per-call provider options forwarded verbatim to the AI SDK. Used to
-         * enable provider-specific features such as Anthropic extended thinking
-         * or OpenAI reasoning effort. Shape:
+         * Per-call options for provider-specific features such as extended
+         * thinking or reasoning effort. Shape:
          * `{ <providerId>: { <option>: <value>, ... }, ... }`.
          */
         providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         /**
-         * Model-level generation parameters (temperature, maxOutputTokens, topP, seed,
-         * etc.). Forwarded to `streamText` as top-level options. Provider-specific
-         * features should use `providerOptions` instead.
+         * Provider-independent generation parameters such as temperature,
+         * maxOutputTokens, topP, and seed. Provider-specific features belong in
+         * `providerOptions` instead.
          */
         modelOptions: z.ZodOptional<z.ZodObject<{
             temperature: z.ZodOptional<z.ZodNumber>;
@@ -714,13 +777,13 @@ export declare const StrategySchema: z.ZodObject<{
     }, "strict", z.ZodTypeAny, {
         type?: "llm" | undefined;
         description?: string | undefined;
+        tools?: string[] | undefined;
         model?: string | undefined;
         systemPrompt?: string | undefined;
         systemPromptTemplate?: {
             template: string;
             variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
         } | undefined;
-        tools?: string[] | undefined;
         providerOptions?: Record<string, Record<string, unknown>> | undefined;
         modelOptions?: {
             temperature?: number | undefined;
@@ -747,13 +810,13 @@ export declare const StrategySchema: z.ZodObject<{
     }, {
         type?: "llm" | undefined;
         description?: string | undefined;
+        tools?: string[] | undefined;
         model?: string | undefined;
         systemPrompt?: string | undefined;
         systemPromptTemplate?: {
             template: string;
             variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
         } | undefined;
-        tools?: string[] | undefined;
         providerOptions?: Record<string, Record<string, unknown>> | undefined;
         modelOptions?: {
             temperature?: number | undefined;
@@ -777,8 +840,23 @@ export declare const StrategySchema: z.ZodObject<{
         } | undefined;
         maxSteps?: number | undefined;
         skills?: string[] | undefined;
+    }>, z.ZodObject<{
+        /** Name registered with `registerAgent`. */
+        type: z.ZodEffects<z.ZodString, string, string>;
+        /** Optional human-readable description. */
+        description: z.ZodOptional<z.ZodString>;
+        /** Configuration validated by the registered agent type. */
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strict", z.ZodTypeAny, {
+        type: string;
+        description?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    }, {
+        type: string;
+        description?: string | undefined;
+        config?: Record<string, unknown> | undefined;
     }>]>>;
-    flow: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    flow: z.ZodUnion<[z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         type: z.ZodLiteral<"sequential">;
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
@@ -853,6 +931,24 @@ export declare const StrategySchema: z.ZodObject<{
         steps: any[];
         description?: string | undefined;
         separator?: string | undefined;
+    }>]>, z.ZodObject<{
+        type: z.ZodEffects<z.ZodString, string, string>;
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        steps: z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        type: string;
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    }, {
+        type: string;
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+        config?: Record<string, unknown> | undefined;
     }>]>;
 }, "strict", z.ZodTypeAny, {
     name: string;
@@ -867,13 +963,13 @@ export declare const StrategySchema: z.ZodObject<{
     } | {
         type?: "llm" | undefined;
         description?: string | undefined;
+        tools?: string[] | undefined;
         model?: string | undefined;
         systemPrompt?: string | undefined;
         systemPromptTemplate?: {
             template: string;
             variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
         } | undefined;
-        tools?: string[] | undefined;
         providerOptions?: Record<string, Record<string, unknown>> | undefined;
         modelOptions?: {
             temperature?: number | undefined;
@@ -897,6 +993,10 @@ export declare const StrategySchema: z.ZodObject<{
         } | undefined;
         maxSteps?: number | undefined;
         skills?: string[] | undefined;
+    } | {
+        type: string;
+        description?: string | undefined;
+        config?: Record<string, unknown> | undefined;
     }>;
     flow: {
         type: "sequential";
@@ -918,6 +1018,12 @@ export declare const StrategySchema: z.ZodObject<{
         steps: any[];
         description?: string | undefined;
         separator?: string | undefined;
+    } | {
+        type: string;
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+        config?: Record<string, unknown> | undefined;
     };
     description?: string | undefined;
 }, {
@@ -933,13 +1039,13 @@ export declare const StrategySchema: z.ZodObject<{
     } | {
         type?: "llm" | undefined;
         description?: string | undefined;
+        tools?: string[] | undefined;
         model?: string | undefined;
         systemPrompt?: string | undefined;
         systemPromptTemplate?: {
             template: string;
             variables?: Record<string, string | number | boolean | string[] | Record<string, string>> | undefined;
         } | undefined;
-        tools?: string[] | undefined;
         providerOptions?: Record<string, Record<string, unknown>> | undefined;
         modelOptions?: {
             temperature?: number | undefined;
@@ -963,6 +1069,10 @@ export declare const StrategySchema: z.ZodObject<{
         } | undefined;
         maxSteps?: number | undefined;
         skills?: string[] | undefined;
+    } | {
+        type: string;
+        description?: string | undefined;
+        config?: Record<string, unknown> | undefined;
     }>;
     flow: {
         type: "sequential";
@@ -984,48 +1094,32 @@ export declare const StrategySchema: z.ZodObject<{
         steps: any[];
         description?: string | undefined;
         separator?: string | undefined;
+    } | {
+        type: string;
+        name: string;
+        steps: any[];
+        description?: string | undefined;
+        config?: Record<string, unknown> | undefined;
     };
     description?: string | undefined;
 }>;
-export declare const CommaProjectManifestSchema: z.ZodObject<{
-    name: z.ZodString;
-    version: z.ZodOptional<z.ZodString>;
-    description: z.ZodOptional<z.ZodString>;
-    strategies: z.ZodArray<z.ZodString, "many">;
-    tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    entry: z.ZodOptional<z.ZodString>;
-    dependencies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strict", z.ZodTypeAny, {
-    name: string;
-    strategies: string[];
-    description?: string | undefined;
-    tools?: string[] | undefined;
-    version?: string | undefined;
-    entry?: string | undefined;
-    dependencies?: string[] | undefined;
-}, {
-    name: string;
-    strategies: string[];
-    description?: string | undefined;
-    tools?: string[] | undefined;
-    version?: string | undefined;
-    entry?: string | undefined;
-    dependencies?: string[] | undefined;
-}>;
 export type UserAgentDef = z.infer<typeof UserAgentDefSchema>;
 export type LLMAgentDef = z.infer<typeof LLMAgentDefSchema>;
+export type CustomAgentDef = z.infer<typeof CustomAgentDefSchema>;
 export type AgentDef = z.infer<typeof AgentDefSchema>;
 export type AgentStep = z.infer<typeof AgentStepSchema>;
 export type SequentialFlowDef = z.infer<typeof SequentialFlowDefSchema>;
 export type CycleFlowDef = z.infer<typeof CycleFlowDefSchema>;
 export type BroadcastFlowDef = z.infer<typeof BroadcastFlowDefSchema>;
+export type CustomFlowDef = z.infer<typeof CustomFlowDefSchema>;
 export type FlowDef = z.infer<typeof FlowDefSchema>;
 export type Strategy = z.infer<typeof StrategySchema>;
-export type CommaProjectManifest = z.infer<typeof CommaProjectManifestSchema>;
 /** Check if an agent definition is a user agent. */
 export declare function isUserAgentDef(agentDefinition: AgentDef): agentDefinition is UserAgentDef;
 /** Check if an agent definition is an LLM agent. */
 export declare function isLLMAgentDef(agentDefinition: AgentDef): agentDefinition is LLMAgentDef;
+/** Check if an agent definition references a registered custom agent type. */
+export declare function isCustomAgentDef(agentDefinition: AgentDef): agentDefinition is CustomAgentDef;
 /** Check if a flow step is an agent reference (vs a nested flow). */
 export declare function isAgentStep(step: unknown): step is AgentStep;
 /** Check if a flow step is a nested flow definition. */

package/dist/tools/built-in/list-strategy/list-strategy.d.ts

@@ -6,8 +6,8 @@ export declare const listStrategyParams: z.ZodObject<{}, "strip", z.ZodTypeAny,
  * Build the `list_strategy` tool.
  *
  * Enumerates every strategy that {@link discoverStrategies} can find on
- * disk (bundled, cwd `.comma/strategies/`, cwd projects, data dir, data
- * dir projects) and returns them in a structured payload plus a
+ * disk (cwd `.comma/strategies/`, cwd projects, data dir, data dir
+ * projects, installed Hub packages, and bundled defaults) and returns them in a structured payload plus a
  * human-readable summary. Strategies that fail schema validation are
  * not included; their paths are surfaced in `data.warnings`.
  */