@introspection-ai/recipes 0.13.0 → 0.14.1

package/dist/recipe-agent.d.ts

@@ -3,17 +3,23 @@ export interface RecipeSystemInstructions {
     mode: "append" | "replace";
     content: string;
 }
-export interface RecipeAgentExtensions {
-    include?: string[];
-    exclude?: string[];
-}
 export interface RecipeAgentMcpServer {
     /** Exact tool names or the reserved whole-toolset `*` sentinel. */
     include?: string[];
     /** Exact tool names removed after inclusion. */
     exclude?: string[];
+    /** Authorized tools hidden from the model until activated. */
+    defer?: string[];
+    /** Deferred tools made visible at session start. */
+    eager?: string[];
+}
+export type RecipeAgentMcpMode = "cli" | "tools";
+export interface RecipeAgentMcp {
+    /** Omission inherits the parent mode or defaults the resolved root to CLI. */
+    mode?: RecipeAgentMcpMode;
+    /** Authorization selection, still upper-bounded by package.json#pi.mcp. */
+    servers: Record<string, RecipeAgentMcpServer>;
 }
-export type RecipeAgentMcp = Record<string, RecipeAgentMcpServer>;
 export interface RecipeAgentDefinition {
     name: string;
     from?: string;
@@ -32,40 +38,31 @@ export interface RecipeAgentDefinition {
     /** MCP tool selection, separate from the exact Pi/extension tool allowlist. */
     mcp?: RecipeAgentMcp;
     skills: string[];
-    /** True when `skills:` was declared (directly or inherited) rather than defaulted to []. */
-    skillsDeclared?: boolean;
     subagents: string[];
-    subagentsDeclared?: boolean;
-    extensions?: RecipeAgentExtensions;
     systemInstructions?: RecipeSystemInstructions;
+    /** Fields authored on this definition rather than inherited through `from`. */
+    declaredFields?: readonly RecipeAgentConfigField[];
 }
-export type RequiredResolvedRecipeAgentField = "model.name" | "model.thinkingLevel" | "tools" | "skills" | "subagents" | "systemInstructions";
-export declare const REQUIRED_RECIPE_AGENT_FIELDS: RequiredResolvedRecipeAgentField[];
+export type RecipeAgentConfigField = "description" | "model" | "tools" | "mcp" | "skills" | "subagents" | "system_instructions";
 export interface RecipeAgentValidationFinding {
     agentName: string;
-    field: "name" | "from" | "file" | "mcp" | RequiredResolvedRecipeAgentField;
+    field: "name" | "from" | "file" | "mcp" | "model.name";
     code?: string;
-    severity?: "error" | "warning";
     message: string;
 }
-export declare function loadRecipeAgentDefinitions(recipeDir: string): Map<string, RecipeAgentDefinition>;
 export declare function validateResolvedRecipeAgentDefinition(opts: {
     recipeDir: string;
     agentName: string;
-    requireExplicitName?: boolean;
-    requiredFields?: RequiredResolvedRecipeAgentField[];
 }): RecipeAgentValidationFinding[];
+export interface ValidatedRecipeAgentDefinitions {
+    definitions: Map<string, RecipeAgentDefinition>;
+    findings: RecipeAgentValidationFinding[];
+}
+/**
+ * Parse agent YAML once, then validate and resolve the complete inheritance
+ * Recipe snapshot from that exact source.
+ */
+export declare function loadValidatedRecipeAgentDefinitions(recipeDir: string): ValidatedRecipeAgentDefinitions;
 export declare function validateRecipeAgentDefinitions(recipeDir: string): RecipeAgentValidationFinding[];
-export declare function resolveRecipeAgentName(opts: {
-    recipeDir: string;
-    agentName?: string;
-}): string;
-export declare function resolveRecipeAgentDefinition(opts: {
-    recipeDir: string;
-    agentName?: string;
-}): {
-    agentName: string;
-    agent: RecipeAgentDefinition | null;
-};
 export declare function loadRecipeSystemPrompt(recipeDir: string): string | undefined;
 //# sourceMappingURL=recipe-agent.d.ts.map

package/dist/recipe-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recipe-agent.d.ts","sourceRoot":"","sources":["../src/recipe-agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"recipe-agent.d.ts","sourceRoot":"","sources":["../src/recipe-agent.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,mBAAmB,CAAC;AAc3B,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,OAAO,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,8EAA8E;IAC9E,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAC/C;AAQD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF;;;;OAIG;IACH,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+EAA+E;IAC/E,GAAG,CAAC,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;IAC9C,+EAA+E;IAC/E,cAAc,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACpD;AAED,MAAM,MAAM,sBAAsB,GAC9B,aAAa,GACb,OAAO,GACP,OAAO,GACP,KAAK,GACL,QAAQ,GACR,WAAW,GACX,qBAAqB,CAAC;AAW1B,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,YAAY,CAAC;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAynBD,wBAAgB,qCAAqC,CAAC,IAAI,EAAE;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,4BAA4B,EAAE,CAKjC;AA0ED,MAAM,WAAW,+BAA+B;IAC9C,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAChD,QAAQ,EAAE,4BAA4B,EAAE,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,MAAM,GAChB,+BAA+B,CAoBjC;AAED,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,MAAM,GAChB,4BAA4B,EAAE,CAEhC;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM5E"}