feat(invariants): implement package runtime checks

packages/support/agent-loop-testkit/src/index.ts

@@ -6,12 +6,7 @@
  */
 
 import type { Context } from 'cordis'
-import AgentRegistry from '@deepseek-ai/dsh-agent'
-import LlmService from '@deepseek-ai/dsh-llm'
-import SessionStore from '@deepseek-ai/dsh-session'
-import SystemPrompt from '@deepseek-ai/dsh-system-prompt'
 import type { Config as SystemPromptConfig } from '@deepseek-ai/dsh-system-prompt'
-import ToolRegistry from '@deepseek-ai/dsh-tools'
 import type { Config as ToolRegistryConfig } from '@deepseek-ai/dsh-tools'
 
 /** Configuration forwarded to the prerequisite service plugins. */
@@ -38,6 +33,19 @@ export async function mountAgentLoopTestDependencies(
   ctx: Context,
   options: AgentLoopTestDependenciesOptions = {},
 ): Promise<void> {
+  const [
+    { default: LlmService },
+    { default: SessionStore },
+    { default: SystemPrompt },
+    { default: ToolRegistry },
+    { default: AgentRegistry },
+  ] = await Promise.all([
+    import('@deepseek-ai/dsh-llm'),
+    import('@deepseek-ai/dsh-session'),
+    import('@deepseek-ai/dsh-system-prompt'),
+    import('@deepseek-ai/dsh-tools'),
+    import('@deepseek-ai/dsh-agent'),
+  ])
   await ctx.plugin(LlmService)
   await ctx.plugin(SessionStore)
   await ctx.plugin(SystemPrompt, options.systemPrompt ?? {})

packages/support/agent-loop-testkit/src/invariant.ts

@@ -1,14 +1,8 @@
-/**
- * Generated invariant ownership companion for `@deepseek-ai/dsh-agent-loop-testkit`.
- * Replace this file with package-owned checks while preserving its registration.
- *
- * @generated scripts/gen-package-invariants.ts
- * @module @deepseek-ai/dsh-agent-loop-testkit/invariant
- */
+/** Package-owned runtime contracts for @deepseek-ai/dsh-agent-loop-testkit. @module @deepseek-ai/dsh-agent-loop-testkit/invariant */
 
 /* jscpd:ignore-start */
 import type { Context } from 'cordis'
-import type { InvariantInstaller } from '@deepseek-ai/dsh-invariants'
+import { assertInvariant, type InvariantInstaller } from '@deepseek-ai/dsh-invariants'
 
 const PACKAGE_NAME = '@deepseek-ai/dsh-agent-loop-testkit'
 
@@ -17,8 +11,18 @@ export const name = 'agent-loop-testkit-invariant'
 /** Services required before the companion can register. */
 export const inject = ['invariants']
 
-/** Reserve this package's invariant ownership until it adds relational checks. */
-const install: InvariantInstaller = () => {}
+/** Assert the awaitable helper shape and optional-options call boundary. */
+const install: InvariantInstaller = (ctx, fail) => {
+  ctx.effect(async () => {
+    const { mountAgentLoopTestDependencies } = await import('./index.ts')
+    assertInvariant(fail,
+      mountAgentLoopTestDependencies.constructor.name === 'AsyncFunction',
+      'the prerequisite mount helper must remain awaitable so tests cannot race service activation')
+    assertInvariant(fail, mountAgentLoopTestDependencies.length === 1,
+      'the prerequisite mount helper must keep its options argument optional')
+    return () => {}
+  }, 'agent-loop-testkit: validate prerequisite mount boundary')
+}
 
 /**
  * Register this package's invariant companion.