perstack-ai · FL4TLiN3 · Feb 17, 2026 · Feb 17, 2026 · Feb 17, 2026
diff --git a/.changeset/remove-lazy-init.md b/.changeset/remove-lazy-init.md
@@ -0,0 +1,8 @@
+---
+"@perstack/core": patch
+"@perstack/skill-manager": patch
+"@perstack/runtime": patch
+"@perstack/installer": patch
+---
+
+Remove dead `lazyInit` field from schemas, types, and all usages
diff --git a/.github/workflows/e2e.yml b/.github/workflows/e2e.yml
@@ -34,7 +34,6 @@ jobs:
               e2e/perstack-cli/providers.test.ts
               e2e/perstack-cli/error-handling.test.ts
               e2e/perstack-cli/interactive.test.ts
-              e2e/perstack-cli/lazy-init.test.ts
               e2e/perstack-cli/bundled-base.test.ts
               e2e/perstack-cli/versioned-base.test.ts
               e2e/perstack-cli/runtime-version.test.ts

diff --git a/apps/create-expert/perstack.toml b/apps/create-expert/perstack.toml
@@ -59,7 +59,6 @@ pick = ["readTextFile", "writeTextFile", "listDirectory", "think", "attemptCompl
 # args = ["-y", "some-mcp-server"]
 # requiredEnv = ["API_KEY"]
 # rule = "Instructions for using this skill"
-# lazyInit = false
 ```
 
 ## Your Workflow
@@ -115,5 +114,4 @@ description = "Test-run expert definitions to verify they work correctly"
 command = "npx"
 packageName = "@perstack/create-expert-skill"
 requiredEnv = ["PROVIDER_API_KEY"]
-lazyInit = true
 rule = "After creating or modifying an expert in perstack.toml, use runExpert to test it with a simple query. Review the activities to verify correctness."
diff --git a/benchmarks/mcp-startup/perstack.toml b/benchmarks/mcp-startup/perstack.toml
@@ -20,4 +20,3 @@ description = "Browser automation capabilities using Firecrawl"
 command = "npx"
 packageName = "firecrawl-mcp"
 requiredEnv = ["FIRECRAWL_API_KEY"]
-lazyInit = false
diff --git a/benchmarks/production-perf/perstack.toml b/benchmarks/production-perf/perstack.toml
@@ -29,4 +29,3 @@ pick = ["attemptCompletion"]
 type = "mcpStdioSkill"
 command = "node"
 args = ["../../e2e/fixtures/minimal-mcp-server.mjs"]
-lazyInit = false
diff --git a/docs/references/perstack-toml.md b/docs/references/perstack-toml.md
@@ -252,7 +252,6 @@ requiredEnv = ["API_KEY"]
 | `omit`           | string[] | No       | Tools to exclude (blacklist)                |
 | `requiredEnv`    | string[] | No       | Required environment variables              |
 | `allowedDomains` | string[] | No       | Allowed domain patterns for network access  |
-| `lazyInit`       | boolean  | No       | Delay initialization until first use (default: `false`) |
 
 ### MCP SSE Skill
 

diff --git a/e2e/experts/lazy-init.toml b/e2e/experts/lazy-init.toml
diff --git a/e2e/experts/mixed-tools.toml b/e2e/experts/mixed-tools.toml
@@ -22,7 +22,6 @@ description = "Web search"
 command = "npx"
 args = ["-y", "exa-mcp-server"]
 requiredEnv = ["EXA_API_KEY"]
-lazyInit = false
 
 [experts."e2e-mixed-tools".skills."user-input"]
 type = "interactiveSkill"

diff --git a/e2e/experts/skills.toml b/e2e/experts/skills.toml
@@ -49,7 +49,6 @@ description = "Web search"
 command = "npx"
 args = ["-y", "exa-mcp-server"]
 requiredEnv = ["EXA_API_KEY"]
-lazyInit = false
 
 [experts."e2e-multi-skill".skills."@perstack/base"]
 type = "mcpStdioSkill"

diff --git a/e2e/experts/special-tools.toml b/e2e/experts/special-tools.toml
@@ -23,7 +23,6 @@ description = "Web search"
 command = "npx"
 args = ["-y", "exa-mcp-server"]
 requiredEnv = ["EXA_API_KEY"]
-lazyInit = false
 
 [experts."e2e-special-tools".skills."@perstack/base"]
 type = "mcpStdioSkill"

diff --git a/e2e/perstack-cli/lazy-init.test.ts b/e2e/perstack-cli/lazy-init.test.ts
diff --git a/packages/core/src/schemas/expert.ts b/packages/core/src/schemas/expert.ts
@@ -80,7 +80,6 @@ export const expertSchema = z.object({
         pick: [],
         omit: [],
         requiredEnv: [],
-        lazyInit: false,
       } satisfies SkillWithoutName,
     })
     .transform((skills) => {

diff --git a/packages/core/src/schemas/perstack-toml.ts b/packages/core/src/schemas/perstack-toml.ts
@@ -158,7 +158,6 @@ export type PerstackConfigSkill =
       args?: string[]
       requiredEnv?: string[]
       allowedDomains?: string[]
-      lazyInit?: boolean
     }
   | {
       type: "mcpSseSkill"
@@ -264,7 +263,6 @@ export const perstackConfigSchema = z.object({
                 args: z.array(z.string()).optional(),
                 requiredEnv: z.array(z.string()).optional(),
                 allowedDomains: z.array(domainPatternSchema).optional(),
-                lazyInit: z.boolean().optional().default(false),
               }),
               z.object({
                 type: z.literal("mcpSseSkill"),

diff --git a/packages/core/src/schemas/skill.test.ts b/packages/core/src/schemas/skill.test.ts
@@ -13,7 +13,6 @@ describe("@perstack/core: mcpStdioSkillSchema", () => {
     expect(result.name).toBe("test-skill")
     expect(result.pick).toEqual([])
     expect(result.omit).toEqual([])
-    expect(result.lazyInit).toBe(false)
   })
 
   it("applies default values", () => {
@@ -26,7 +25,6 @@ describe("@perstack/core: mcpStdioSkillSchema", () => {
     expect(result.omit).toEqual([])
     expect(result.args).toEqual([])
     expect(result.requiredEnv).toEqual([])
-    expect(result.lazyInit).toBe(false)
   })
 })
 

diff --git a/packages/core/src/schemas/skill.ts b/packages/core/src/schemas/skill.ts
@@ -70,8 +70,6 @@ export interface McpStdioSkill {
   args: string[]
   /** Environment variables required by this skill */
   requiredEnv: string[]
-  /** Whether to delay initialization until first use */
-  lazyInit: boolean
 }
 
 export const mcpStdioSkillSchema = z.object({
@@ -85,7 +83,6 @@ export const mcpStdioSkillSchema = z.object({
   packageName: z.string().optional(),
   args: z.array(z.string()).optional().default([]),
   requiredEnv: z.array(z.string()).optional().default([]),
-  lazyInit: z.boolean().optional().default(false),
 })
 mcpStdioSkillSchema satisfies z.ZodType<McpStdioSkill>
 

diff --git a/packages/installer/src/expert-resolver.ts b/packages/installer/src/expert-resolver.ts
@@ -66,7 +66,6 @@ export function toRuntimeExpert(key: string, expert: PublishedExpertData): Exper
               command: skill.command,
               packageName: skill.packageName,
               requiredEnv: skill.requiredEnv ?? [],
-              lazyInit: false,
             },
           ]
         case "mcpSseSkill":
@@ -80,7 +79,6 @@ export function toRuntimeExpert(key: string, expert: PublishedExpertData): Exper
               pick: skill.pick ?? [],
               omit: skill.omit ?? [],
               endpoint: skill.endpoint,
-              lazyInit: false,
             },
           ]
         case "interactiveSkill":

diff --git a/packages/runtime/src/helpers/resolve-expert.test.ts b/packages/runtime/src/helpers/resolve-expert.test.ts
@@ -65,7 +65,6 @@ function createTestExpert(overrides: Partial<Expert> = {}): Expert {
         requiredEnv: [],
         pick: [],
         omit: [],
-        lazyInit: false,
       },
     },
     delegates: [],

diff --git a/packages/runtime/src/helpers/resolve-expert.ts b/packages/runtime/src/helpers/resolve-expert.ts
@@ -90,7 +90,6 @@ function toRuntimeExpert(
               command: skill.command,
               packageName: skill.packageName,
               requiredEnv: skill.requiredEnv ?? [],
-              lazyInit: false,
             },
           ]
         case "mcpSseSkill":
@@ -104,7 +103,6 @@ function toRuntimeExpert(
               pick: skill.pick ?? [],
               omit: skill.omit ?? [],
               endpoint: skill.endpoint,
-              lazyInit: false,
             },
           ]
         case "interactiveSkill":

diff --git a/packages/runtime/src/messages/message.test.ts b/packages/runtime/src/messages/message.test.ts
@@ -536,7 +536,7 @@ describe("@perstack/messages: instruction-message", () => {
             requiredEnv: [],
             pick: [],
             omit: [],
-            lazyInit: false,
+
             rule: "Always use this skill carefully.",
           },
         },
@@ -565,7 +565,6 @@ describe("@perstack/messages: instruction-message", () => {
             requiredEnv: [],
             pick: [],
             omit: [],
-            lazyInit: false,
           },
         },
         delegates: [],

diff --git a/packages/skill-manager/src/adapters/in-memory-base-adapter.test.ts b/packages/skill-manager/src/adapters/in-memory-base-adapter.test.ts
@@ -45,7 +45,6 @@ function createBaseSkill() {
     requiredEnv: [],
     pick: [],
     omit: [],
-    lazyInit: false,
   }
 }
 

diff --git a/packages/skill-manager/src/adapters/lockfile-adapter.test.ts b/packages/skill-manager/src/adapters/lockfile-adapter.test.ts
@@ -15,7 +15,7 @@ function createMockSkill(overrides: Partial<McpStdioSkill> = {}): McpStdioSkill
     requiredEnv: [],
     pick: [],
     omit: [],
-    lazyInit: false,
+
     ...overrides,
   } as McpStdioSkill
 }

diff --git a/packages/skill-manager/src/adapters/lockfile-adapter.ts b/packages/skill-manager/src/adapters/lockfile-adapter.ts
@@ -127,7 +127,6 @@ export class LockfileSkillAdapter extends SkillAdapter {
         command: overrideCommand,
         packageName: undefined,
         args: overrideArgs,
-        lazyInit: false,
       } as McpStdioSkill
     }
     return skill