@agentuity/migrate 3.0.0-alpha.6 → 3.0.0-alpha.7

package/dist/transforms/v3/routes.js

@@ -9,21 +9,27 @@
  */
 import ts from 'typescript';
 import { relative, dirname } from 'node:path';
-/**
- * Rewrite c.var.* service access patterns to direct imports.
- *
- * @param source     - File source text
- * @param usage      - Detected service usage info
- * @param servicesRelativePath - Relative import path to services module (e.g., '../services')
- */
-/**
- * Remove all imports from @agentuity/runtime.
- * In v3, this package is a deprecation stub — nothing should be imported from it.
- */
 export function removeRuntimeImports(source) {
-    const pattern = /import\s+(?:type\s+)?\{[^}]*\}\s*from\s*['"]@agentuity\/runtime['"]\s*;?\s*\n?/g;
-    const replaced = source.replace(pattern, '');
-    return { source: replaced, removed: replaced !== source };
+    let needsEnvType = false;
+    let hadAgentuityValidator = false;
+    let removed = false;
+    // Match both `import { ... } from '@agentuity/runtime'` and
+    // `import type { ... } from '@agentuity/runtime'` (incl. multiline).
+    const pattern = /import\s+(?:type\s+)?\{([^}]*)\}\s*from\s*['"]@agentuity\/runtime['"]\s*;?\s*\n?/g;
+    const output = source.replace(pattern, (_match, inner) => {
+        removed = true;
+        const names = inner
+            .split(',')
+            .map((s) => s.trim())
+            .map((s) => s.replace(/^type\s+/, ''))
+            .filter(Boolean);
+        if (names.includes('Env'))
+            needsEnvType = true;
+        if (names.includes('validator'))
+            hadAgentuityValidator = true;
+        return '';
+    });
+    return { source: output, removed, needsEnvType, hadAgentuityValidator };
 }
 export function transformRouteServices(source, usage, servicesRelativePath) {
     let output = source;
@@ -34,6 +40,29 @@ export function transformRouteServices(source, usage, servicesRelativePath) {
     if (runtimeCleanup.removed) {
         output = runtimeCleanup.source;
         changes.push('Removed @agentuity/runtime imports');
+        // Re-route Env to the generated types file
+        if (runtimeCleanup.needsEnvType) {
+            output = insertAfterImports(output, "import type { Env } from '../types/hono-env';");
+            changes.push("Added: import type { Env } from '../types/hono-env'");
+        }
+        // Strip v2-era validator middleware calls that have no v3 equivalent.
+        const stripped = stripAgentuityValidators(output);
+        if (stripped.changed) {
+            output = stripped.source;
+            changes.push(...stripped.changes);
+        }
+    }
+    // Rewrite v2-era agent method calls in route files.
+    const agentRewrite = rewriteV2AgentMethods(output);
+    if (agentRewrite.changed) {
+        output = agentRewrite.source;
+        changes.push(...agentRewrite.changes);
+    }
+    // Stub out c.var.thread / c.var.sessionId — v2 concepts with no v3 replacement.
+    const stubRewrite = stubV2HonoContext(output);
+    if (stubRewrite.changed) {
+        output = stubRewrite.source;
+        changes.push(...stubRewrite.changes);
     }
     if (usage.accessPattern === 'c.var') {
         // Replace c.var.serviceName patterns
@@ -127,7 +156,94 @@ export function computeServicesRelativePath(projectDir, sourceFilePath) {
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
-function insertAfterImports(source, importLine) {
+/**
+ * Rewrite v2-era agent method invocations to plain function calls in route
+ * files.
+ *
+ *   translate.run(data)   → translate(data)
+ *   translate.validator() → /* stripped above * /
+ *
+ * We also rewrite `c.req.valid('json')` → `await c.req.json()` — the former
+ * was the output of the v2 validator middleware that we stripped.
+ */
+export function rewriteV2AgentMethods(source) {
+    let output = source;
+    const changes = [];
+    // <agent>.run(x) → <agent>(x)
+    const before1 = output;
+    output = output.replace(/\b([A-Za-z_$][A-Za-z0-9_$]*)\.run\(/g, (_m, name) => `${name}(`);
+    if (output !== before1) {
+        changes.push('Rewrote <agent>.run(…) → <agent>(…)');
+    }
+    // c.req.valid('json') → (await c.req.json())
+    const before2 = output;
+    output = output.replace(/\bc\.req\.valid\(\s*['"]json['"]\s*\)/g, '(await c.req.json())');
+    if (output !== before2) {
+        changes.push("Rewrote c.req.valid('json') → await c.req.json()");
+    }
+    return { source: output, changed: changes.length > 0, changes };
+}
+/**
+ * Stub out v2-era Hono context variables that no longer exist in v3.
+ *
+ * v3's Services interface only includes storage clients (kv, vector, stream,
+ * etc.). Thread state, sessionId, and app-level state were removed when v3
+ * dropped the createApp() abstraction.
+ */
+export function stubV2HonoContext(source) {
+    let output = source;
+    const changes = new Set();
+    // c.var.thread.*  — stub out the whole chain as `(undefined as any)`.
+    //
+    // The chain can include:
+    //   • Dotted property access:       c.var.thread.state
+    //   • Generic type arguments:       .get<HistoryEntry[]>
+    //   • Call sites:                   .get<T>('key')
+    //   • Multiple chained calls:       .state.push(…).something()
+    //
+    // We do this greedily by chaining an alternation until we hit a terminator.
+    const before1 = output;
+    output = output.replace(/c\.var\.thread(?:\.[A-Za-z0-9_$]+|<[^>]*>|\([^()]*\))*/g, '(undefined as any) /* v3: c.var.thread removed */');
+    if (output !== before1) {
+        changes.add('Stubbed c.var.thread.* (removed in v3)');
+    }
+    const before2 = output;
+    output = output.replace(/c\.var\.sessionId\b/g, "('v3-no-session-id' as string) /* v3: c.var.sessionId removed */");
+    if (output !== before2) {
+        changes.add('Stubbed c.var.sessionId (removed in v3)');
+    }
+    return { source: output, changed: changes.size > 0, changes: [...changes] };
+}
+/**
+ * Strip v2 validator middleware from a source string.
+ *
+ * Removes two shapes:
+ *   - `validator({ input: ... })` / `validator({ output: ... })` imported
+ *     from @agentuity/runtime (used as Hono middleware)
+ *   - `<agent>.validator()` — the auto-generated method on v2 agents used as
+ *     middleware on routes that forward to the agent
+ *
+ * Both become comments so the file parses but the user can see where to wire
+ * up manual validation (typically via `zod.parse(await c.req.json())`).
+ */
+export function stripAgentuityValidators(source) {
+    let output = source;
+    const changes = [];
+    // validator({ ... }),   — tolerate whitespace/newlines
+    const before1 = output;
+    output = output.replace(/\s*validator\(\s*\{[\s\S]*?\}\s*\)\s*,?/g, ' /* v3: validator() removed — validate inline with zod */ ');
+    if (output !== before1) {
+        changes.push('Stripped Agentuity validator() middleware calls');
+    }
+    // <agent>.validator(),
+    const before2 = output;
+    output = output.replace(/\s*[A-Za-z_$][A-Za-z0-9_$]*\.validator\(\s*\)\s*,?/g, ' /* v3: agent.validator() removed — parse input with zod */ ');
+    if (output !== before2) {
+        changes.push('Stripped <agent>.validator() middleware calls');
+    }
+    return { source: output, changed: changes.length > 0, changes };
+}
+export function insertAfterImports(source, importLine) {
     const sf = ts.createSourceFile('temp.ts', source, ts.ScriptTarget.ESNext, true);
     let lastImportEnd = -1;
     for (const stmt of sf.statements) {

package/dist/transforms/v3/routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/transforms/v3/routes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/transforms/v3/routes.ts"],"names":[],"mappings":"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"}

package/dist/transforms/v3/schema-to-zod.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Transform: port `@agentuity/schema` usage to `zod`.
+ *
+ * v3 still ships @agentuity/schema but the idiomatic path for user-owned
+ * schemas is zod. The migrate tool replaces the import and the `s.*`
+ * namespace calls so downstream code parses with zod at runtime.
+ *
+ * Conservative mapping — we do not try to handle every edge case. Advanced
+ * shapes (e.g. s.toJSONSchema) are flagged with a TODO comment for manual
+ * review rather than silently mistranslated.
+ */
+export interface SchemaToZodResult {
+    source: string;
+    changed: boolean;
+    changes: string[];
+}
+export declare function schemaToZod(source: string): SchemaToZodResult;
+//# sourceMappingURL=schema-to-zod.d.ts.map

package/dist/transforms/v3/schema-to-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-to-zod.d.ts","sourceRoot":"","sources":["../../../src/transforms/v3/schema-to-zod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAwBD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAkF7D"}

package/dist/transforms/v3/schema-to-zod.js

@@ -0,0 +1,140 @@
+/**
+ * Transform: port `@agentuity/schema` usage to `zod`.
+ *
+ * v3 still ships @agentuity/schema but the idiomatic path for user-owned
+ * schemas is zod. The migrate tool replaces the import and the `s.*`
+ * namespace calls so downstream code parses with zod at runtime.
+ *
+ * Conservative mapping — we do not try to handle every edge case. Advanced
+ * shapes (e.g. s.toJSONSchema) are flagged with a TODO comment for manual
+ * review rather than silently mistranslated.
+ */
+const BUILDERS = [
+    'object',
+    'string',
+    'number',
+    'boolean',
+    'null_',
+    'undefined_',
+    'unknown',
+    'any',
+    'array',
+    'record',
+    'literal',
+    'optional',
+    'nullable',
+    'enum',
+    'union',
+    'coerceString',
+    'coerceNumber',
+    'coerceBoolean',
+    'coerceDate',
+];
+export function schemaToZod(source) {
+    let output = source;
+    const changes = [];
+    // 1. Import swap: `import { s } from '@agentuity/schema'` → `import { z } from 'zod'`.
+    const importBefore = output;
+    output = output.replace(/import\s*\{\s*s\s*\}\s*from\s*['"]@agentuity\/schema['"]\s*;?/g, "import { z } from 'zod';");
+    if (output !== importBefore) {
+        changes.push("Replaced `import { s } from '@agentuity/schema'` with `import { z } from 'zod'`");
+    }
+    // Also handle `import type { Schema } from '@agentuity/schema'` which is
+    // vestigial — the type isn't used anywhere we care about in the scaffold.
+    // Drop it rather than try to translate.
+    const typeImportBefore = output;
+    output = output.replace(/import\s+type\s*\{[^}]*\}\s*from\s*['"]@agentuity\/schema['"]\s*;?\s*\n?/g, '');
+    if (output !== typeImportBefore) {
+        changes.push('Removed type imports from @agentuity/schema');
+    }
+    // If this file didn't use schema at all, bail early.
+    if (changes.length === 0 && !/\bs\s*\./.test(output)) {
+        return { source: output, changed: false, changes: [] };
+    }
+    // 2. s.<builder>(…) → z.<builder>(…).
+    let replacedBuilders = 0;
+    for (const name of BUILDERS) {
+        const pattern = new RegExp(`(^|[^A-Za-z0-9_$.])s\\.${name}(?=\\b)`, 'g');
+        output = output.replace(pattern, (_m, pre) => {
+            replacedBuilders++;
+            if (name.startsWith('coerce')) {
+                const prim = name.slice('coerce'.length).toLowerCase();
+                return `${pre}z.coerce.${prim}`;
+            }
+            // The @agentuity/schema names `null_` and `undefined_` map to zod's
+            // keyword-named functions `null`/`undefined` but those are reserved,
+            // so zod exposes them as methods on the `z` object just fine.
+            let mapped = name;
+            if (name === 'null_')
+                mapped = 'null';
+            if (name === 'undefined_')
+                mapped = 'undefined';
+            return `${pre}z.${mapped}`;
+        });
+    }
+    if (replacedBuilders > 0) {
+        changes.push(`Replaced ${replacedBuilders} s.<builder>() call(s) with z.<builder>()`);
+    }
+    // 3. Type helpers.
+    const typeBefore = output;
+    output = output.replace(/\bs\.infer\b/g, 'z.infer');
+    if (output !== typeBefore) {
+        changes.push('Replaced s.infer<…> with z.infer<…>');
+    }
+    // 4. Advanced APIs we can't safely auto-translate: s.toJSONSchema.
+    const jsonSchemaBefore = output;
+    output = output.replace(/\bs\.toJSONSchema\b/g, '/* TODO: replace with zodToJsonSchema() from `zod-to-json-schema`, or use `.toJSON()` on zod v4 */ (null as any)');
+    if (output !== jsonSchemaBefore) {
+        changes.push('Stubbed s.toJSONSchema — requires manual swap to a zod equivalent');
+    }
+    // 5. @agentuity/schema's s.union(a, b, c) is variadic; zod's z.union takes
+    // an array. Rewrite call sites with 2+ args to z.union([a, b, c]).
+    const unionBefore = output;
+    output = rewriteZUnionCalls(output);
+    if (output !== unionBefore) {
+        changes.push('Rewrote z.union(a, b, c) → z.union([a, b, c])');
+    }
+    return { source: output, changed: changes.length > 0, changes };
+}
+/**
+ * Walk `z.union(…)` call sites and wrap the args in an array literal unless
+ * they already are one. We scan with a brace-depth counter so nested parens
+ * and generic type arguments don't confuse us.
+ */
+function rewriteZUnionCalls(source) {
+    const needle = 'z.union(';
+    let output = '';
+    let i = 0;
+    while (i < source.length) {
+        const idx = source.indexOf(needle, i);
+        if (idx < 0) {
+            output += source.slice(i);
+            break;
+        }
+        output += source.slice(i, idx) + needle;
+        let depth = 1;
+        let j = idx + needle.length;
+        const start = j;
+        while (j < source.length && depth > 0) {
+            const ch = source[j];
+            if (ch === '(')
+                depth++;
+            else if (ch === ')') {
+                depth--;
+                if (depth === 0)
+                    break;
+            }
+            j++;
+        }
+        const argsStr = source.slice(start, j);
+        if (argsStr.trimStart().startsWith('[')) {
+            output += argsStr + ')';
+        }
+        else {
+            output += '[' + argsStr + '])';
+        }
+        i = j + 1;
+    }
+    return output;
+}
+//# sourceMappingURL=schema-to-zod.js.map

package/dist/transforms/v3/schema-to-zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-to-zod.js","sourceRoot":"","sources":["../../../src/transforms/v3/schema-to-zod.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@agentuity/migrate",
-	"version": "3.0.0-alpha.6",
+	"version": "3.0.0-alpha.7",
 	"description": "Migration tool for Agentuity SDK (v1→v2 and v2→v3)",
 	"license": "Apache-2.0",
 	"author": "Agentuity employees and contributors",
@@ -30,11 +30,10 @@
 		"prepublishOnly": "bun run clean && bun run build"
 	},
 	"dependencies": {
-		"@agentuity/core": "3.0.0-alpha.6",
 		"typescript": "^5.9.0"
 	},
 	"devDependencies": {
-		"@agentuity/test-utils": "3.0.0-alpha.6",
+		"@agentuity/test-utils": "3.0.0-alpha.7",
 		"@types/bun": "latest",
 		"bun-types": "latest"
 	},

package/src/detect-v3.ts

@@ -628,9 +628,11 @@ export async function detectV3(projectDir: string): Promise<V3DetectionResult> {
 	const agentDir = join(absDir, 'src', 'agent');
 	if (existsSync(agentDir)) {
 		for (const file of walkFiles(agentDir, ['.ts', '.tsx'])) {
-			const base = file.split('/').pop() ?? '';
-			// Skip index.ts barrel
-			if (base === 'index.ts' || base === 'index.tsx') continue;
+			// Skip ONLY the top-level src/agent/index.ts barrel. Inside subdirectories,
+			// index.ts is the agent itself, e.g. src/agent/translate/index.ts.
+			if (file === join(agentDir, 'index.ts') || file === join(agentDir, 'index.tsx')) {
+				continue;
+			}
 
 			const sourceFile = await parseTs(file);
 			const src = await Bun.file(file).text();