@agentuity/migrate 3.0.0-alpha.0 → 3.0.0-alpha.1

package/dist/transforms/v3/entry-point.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Transform: app.ts → src/index.ts
+ *
+ * Converts a v2 createApp()-based entry point into a plain Hono application
+ * with agentuity() middleware.
+ *
+ * Strategy: rather than doing complex AST surgery on the user's file, we
+ * generate a clean src/index.ts from the detection data and leave the old
+ * app.ts intact (caller deletes it after confirming).  This avoids edge cases
+ * with custom formatting and gives users a clean starting point.
+ */
+import type { V3DetectionResult } from '../../detect-v3';
+export interface EntryPointTransformResult {
+    /** Generated source for src/index.ts, or null if skipped */
+    source: string | null;
+    /** What was changed */
+    changes: string[];
+}
+/**
+ * Generate a new src/index.ts from the detection result.
+ */
+export declare function generateEntryPoint(detection: V3DetectionResult): EntryPointTransformResult;
+//# sourceMappingURL=entry-point.d.ts.map

package/dist/transforms/v3/entry-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-point.d.ts","sourceRoot":"","sources":["../../../src/transforms/v3/entry-point.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,WAAW,yBAAyB;IACzC,4DAA4D;IAC5D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uBAAuB;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,iBAAiB,GAAG,yBAAyB,CAiE1F"}

package/dist/transforms/v3/entry-point.js

@@ -0,0 +1,67 @@
+/**
+ * Transform: app.ts → src/index.ts
+ *
+ * Converts a v2 createApp()-based entry point into a plain Hono application
+ * with agentuity() middleware.
+ *
+ * Strategy: rather than doing complex AST surgery on the user's file, we
+ * generate a clean src/index.ts from the detection data and leave the old
+ * app.ts intact (caller deletes it after confirming).  This avoids edge cases
+ * with custom formatting and gives users a clean starting point.
+ */
+/**
+ * Generate a new src/index.ts from the detection result.
+ */
+export function generateEntryPoint(detection) {
+    if (!detection.hasCreateApp) {
+        return { source: null, changes: [] };
+    }
+    const changes = [];
+    const imports = [];
+    const middlewares = [];
+    const routes = [];
+    // Core imports
+    imports.push("import { Hono } from 'hono';");
+    imports.push("import { agentuity } from '@agentuity/hono';");
+    // Always add agentuity middleware
+    middlewares.push("app.use('*', agentuity());");
+    changes.push('Added agentuity() middleware (telemetry + services)');
+    // CORS — if the user had cors config in createApp()
+    if (detection.createAppProps.includes('cors')) {
+        imports.push("import { cors } from 'hono/cors';");
+        middlewares.push('// TODO: Configure CORS options — the v2 sameOrigin option is not available in hono/cors.\n' +
+            '// See: https://hono.dev/docs/middleware/builtin/cors\n' +
+            "app.use('*', cors());");
+        changes.push('Added cors() middleware (review config — v2 sameOrigin not available)');
+    }
+    // Router mount — check if there was a router in createApp
+    if (detection.createAppProps.includes('router')) {
+        // Try to figure out the router path from the original app.ts
+        // Default to /api which is the v2 convention
+        imports.push("import router from './api';");
+        routes.push("app.route('/api', router);");
+        changes.push('Mounted API router at /api');
+    }
+    // Build the file
+    const lines = [];
+    lines.push(...imports);
+    lines.push('');
+    lines.push('const app = new Hono();');
+    lines.push('');
+    if (middlewares.length > 0) {
+        lines.push(...middlewares);
+        lines.push('');
+    }
+    if (routes.length > 0) {
+        lines.push(...routes);
+        lines.push('');
+    }
+    lines.push('export default app;');
+    lines.push('');
+    changes.push('Generated src/index.ts with Hono app (replaces app.ts + createApp)');
+    return {
+        source: lines.join('\n'),
+        changes,
+    };
+}
+//# sourceMappingURL=entry-point.js.map

package/dist/transforms/v3/entry-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-point.js","sourceRoot":"","sources":["../../../src/transforms/v3/entry-point.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAA4B;IAC9D,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;QAC7B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,eAAe;IACf,OAAO,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC7C,OAAO,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAE7D,kCAAkC;IAClC,WAAW,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IAEpE,oDAAoD;IACpD,IAAI,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/C,OAAO,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAClD,WAAW,CAAC,IAAI,CACf,6FAA6F;YAC5F,yDAAyD;YACzD,uBAAuB,CACxB,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;IACvF,CAAC;IAED,0DAA0D;IAC1D,IAAI,SAAS,CAAC,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjD,6DAA6D;QAC7D,6CAA6C;QAC7C,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC5C,CAAC;IAED,iBAAiB;IACjB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;IAEnF,OAAO;QACN,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QACxB,OAAO;KACP,CAAC;AACH,CAAC"}

package/dist/transforms/v3/package-json.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Transform: package.json for v2 → v3 migration.
+ *
+ * - Removes @agentuity/runtime
+ * - Adds hono and @agentuity/hono
+ * - Adds individual service packages based on detected usage
+ * - Bumps all @agentuity/* packages to ^3.0.0
+ * - Updates start script if it references old entry point
+ */
+import { type V3OutdatedPackage } from '../../detect-v3';
+export interface V3PackageJsonResult {
+    /** Transformed package.json content, or null if no changes */
+    content: string | null;
+    /** Description of each change */
+    changes: string[];
+}
+/**
+ * Transform package.json for v3 migration.
+ */
+export declare function transformPackageJsonV3(source: string, outdatedPackages: V3OutdatedPackage[], servicesUsed: string[], options?: {
+    /** Whether the project had @agentuity/runtime */
+    removeRuntime?: boolean;
+    /** Whether to remove @agentuity/react */
+    removeReact?: boolean;
+    /** Dev scripts to add (from dev-setup transform) */
+    devScripts?: Record<string, string>;
+}): V3PackageJsonResult;
+//# sourceMappingURL=package-json.d.ts.map

package/dist/transforms/v3/package-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-json.d.ts","sourceRoot":"","sources":["../../../src/transforms/v3/package-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE9E,MAAM,WAAW,mBAAmB;IACnC,8DAA8D;IAC9D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,iCAAiC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,iBAAiB,EAAE,EACrC,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,CAAC,EAAE;IACT,iDAAiD;IACjD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC,GACC,mBAAmB,CAuIrB"}

package/dist/transforms/v3/package-json.js

@@ -0,0 +1,151 @@
+/**
+ * Transform: package.json for v2 → v3 migration.
+ *
+ * - Removes @agentuity/runtime
+ * - Adds hono and @agentuity/hono
+ * - Adds individual service packages based on detected usage
+ * - Bumps all @agentuity/* packages to ^3.0.0
+ * - Updates start script if it references old entry point
+ */
+import { SERVICE_PACKAGE_MAP } from '../../detect-v3';
+/**
+ * Transform package.json for v3 migration.
+ */
+export function transformPackageJsonV3(source, outdatedPackages, servicesUsed, options) {
+    const changes = [];
+    let pkg;
+    try {
+        pkg = JSON.parse(source);
+    }
+    catch {
+        return { content: null, changes: ['Failed to parse package.json'] };
+    }
+    const deps = (pkg.dependencies ?? {});
+    const devDeps = (pkg.devDependencies ?? {});
+    // ── 1. Remove @agentuity/runtime ──────────────────────────────────────
+    if (options?.removeRuntime && deps['@agentuity/runtime']) {
+        delete deps['@agentuity/runtime'];
+        changes.push('Removed @agentuity/runtime from dependencies');
+    }
+    if (options?.removeRuntime && devDeps['@agentuity/runtime']) {
+        delete devDeps['@agentuity/runtime'];
+        changes.push('Removed @agentuity/runtime from devDependencies');
+    }
+    // ── 2. Add hono ───────────────────────────────────────────────────────
+    if (!deps['hono']) {
+        deps['hono'] = '^4.0.0';
+        changes.push('Added hono@^4.0.0 to dependencies');
+    }
+    // ── 3. Add @agentuity/hono ────────────────────────────────────────────
+    if (!deps['@agentuity/hono']) {
+        deps['@agentuity/hono'] = '^3.0.0';
+        changes.push('Added @agentuity/hono@^3.0.0 to dependencies');
+    }
+    // ── 4. Add individual service packages based on usage ─────────────────
+    for (const service of servicesUsed) {
+        if (service === 'logger') {
+            // Logger comes from telemetry
+            if (!deps['@agentuity/telemetry']) {
+                deps['@agentuity/telemetry'] = '^3.0.0';
+                changes.push('Added @agentuity/telemetry@^3.0.0 (for logger)');
+            }
+            continue;
+        }
+        const mapping = SERVICE_PACKAGE_MAP[service];
+        if (!mapping)
+            continue;
+        if (!deps[mapping.pkg]) {
+            deps[mapping.pkg] = '^3.0.0';
+            changes.push(`Added ${mapping.pkg}@^3.0.0 (${service} service detected in use)`);
+        }
+    }
+    // ── 5. Bump existing @agentuity/* packages to ^3.0.0 ──────────────────
+    for (const outdated of outdatedPackages) {
+        const section = outdated.section === 'dependencies' ? deps : devDeps;
+        if (section[outdated.name]) {
+            section[outdated.name] = '^3.0.0';
+            changes.push(`Updated ${outdated.name} ${outdated.currentVersion} → ^3.0.0`);
+        }
+    }
+    // ── 6. Remove @agentuity/react if requested ───────────────────────────
+    if (options?.removeReact) {
+        if (deps['@agentuity/react']) {
+            delete deps['@agentuity/react'];
+            changes.push('Removed @agentuity/react from dependencies (deprecated in v3)');
+        }
+        if (devDeps['@agentuity/react']) {
+            delete devDeps['@agentuity/react'];
+            changes.push('Removed @agentuity/react from devDependencies (deprecated in v3)');
+        }
+    }
+    // ── 7. Update scripts for new entry point ─────────────────────────
+    const scripts = (pkg.scripts ?? {});
+    // Replace app.ts references in existing scripts
+    if (scripts.start && scripts.start.includes('app.ts')) {
+        const oldStart = scripts.start;
+        scripts.start = scripts.start.replace('app.ts', 'src/index.ts');
+        changes.push(`Updated start script: "${oldStart}" → "${scripts.start}"`);
+    }
+    if (scripts.dev && scripts.dev.includes('app.ts')) {
+        const oldDev = scripts.dev;
+        scripts.dev = scripts.dev.replace('app.ts', 'src/index.ts');
+        changes.push(`Updated dev script: "${oldDev}" → "${scripts.dev}"`);
+    }
+    // Ensure a start script exists that points to the new entry point.
+    // The buildpack's generic detector uses this to determine how to run the app.
+    if (!scripts.start ||
+        scripts.start.includes('.agentuity') ||
+        scripts.start.includes('agentuity')) {
+        const oldStart = scripts.start;
+        scripts.start = 'bun src/index.ts';
+        if (oldStart) {
+            changes.push(`Replaced start script: "${oldStart}" → "${scripts.start}"`);
+        }
+        else {
+            changes.push(`Added start script: "${scripts.start}"`);
+        }
+    }
+    // Apply dev scripts from dev-setup transform
+    if (options?.devScripts) {
+        for (const [name, value] of Object.entries(options.devScripts)) {
+            const old = scripts[name];
+            scripts[name] = value;
+            if (old) {
+                changes.push(`Updated ${name} script: "${old}" → "${value}"`);
+            }
+            else {
+                changes.push(`Added ${name} script: "${value}"`);
+            }
+        }
+    }
+    // Write back
+    if (Object.keys(deps).length > 0)
+        pkg.dependencies = deps;
+    if (Object.keys(devDeps).length > 0)
+        pkg.devDependencies = devDeps;
+    if (Object.keys(scripts).length > 0)
+        pkg.scripts = scripts;
+    if (changes.length === 0) {
+        return { content: null, changes: [] };
+    }
+    // Preserve the original indentation style
+    const indent = detectIndent(source);
+    return {
+        content: JSON.stringify(pkg, null, indent) + '\n',
+        changes,
+    };
+}
+/**
+ * Detect indentation (tab vs spaces) from package.json source.
+ */
+function detectIndent(source) {
+    const match = source.match(/^(\s+)"/m);
+    if (match) {
+        const whitespace = match[1] ?? '\t';
+        if (whitespace.includes('\t'))
+            return '\t';
+        return whitespace.length;
+    }
+    return '\t'; // default to tabs (project convention)
+}
+//# sourceMappingURL=package-json.js.map

package/dist/transforms/v3/package-json.js.map

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

package/dist/transforms/v3/routes.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Transform: rewrite service access in route files.
+ *
+ * Replaces c.var.kv, c.var.vector, etc. with direct imports from the
+ * shared services module.
+ *
+ * Uses string-level surgery rather than AST round-trip to preserve
+ * formatting and comments.
+ */
+import type { ServiceUsage } from '../../detect-v3';
+export interface RouteServiceTransformResult {
+    /** The transformed source, or null if no changes */
+    source: string | null;
+    /** What was changed */
+    changes: string[];
+}
+/**
+ * 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 declare function removeRuntimeImports(source: string): {
+    source: string;
+    removed: boolean;
+};
+export declare function transformRouteServices(source: string, usage: ServiceUsage, servicesRelativePath: string): RouteServiceTransformResult;
+/**
+ * Compute the relative import path from a source file to src/services.ts.
+ */
+export declare function computeServicesRelativePath(projectDir: string, sourceFilePath: string): string;
+//# sourceMappingURL=routes.d.ts.map

package/dist/transforms/v3/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/transforms/v3/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAGpD,MAAM,WAAW,2BAA2B;IAC3C,oDAAoD;IACpD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uBAAuB;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;GAMG;AACH;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAKzF;AAED,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,YAAY,EACnB,oBAAoB,EAAE,MAAM,GAC1B,2BAA2B,CAgG7B;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAa9F"}

package/dist/transforms/v3/routes.js

@@ -0,0 +1,146 @@
+/**
+ * Transform: rewrite service access in route files.
+ *
+ * Replaces c.var.kv, c.var.vector, etc. with direct imports from the
+ * shared services module.
+ *
+ * Uses string-level surgery rather than AST round-trip to preserve
+ * formatting and comments.
+ */
+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 };
+}
+export function transformRouteServices(source, usage, servicesRelativePath) {
+    let output = source;
+    const changes = [];
+    const servicesAdded = new Set();
+    // Remove @agentuity/runtime imports (Env type, sse, stream, websocket, etc.)
+    const runtimeCleanup = removeRuntimeImports(output);
+    if (runtimeCleanup.removed) {
+        output = runtimeCleanup.source;
+        changes.push('Removed @agentuity/runtime imports');
+    }
+    if (usage.accessPattern === 'c.var') {
+        // Replace c.var.serviceName patterns
+        // We need to handle various Hono context variable names: c, ctx, context
+        const contextNames = ['c', 'ctx', 'context'];
+        for (const service of usage.services) {
+            for (const ctxName of contextNames) {
+                // Match: c.var.kv  c.var.vector  etc.
+                const pattern = new RegExp(`\\b${ctxName}\\.var\\.${service}\\b`, 'g');
+                if (pattern.test(output)) {
+                    output = output.replace(pattern, service);
+                    servicesAdded.add(service);
+                    changes.push(`Replaced ${ctxName}.var.${service} → ${service}`);
+                }
+            }
+        }
+    }
+    else if (usage.accessPattern === 'ctx') {
+        // Replace ctx.serviceName patterns (agent context)
+        const contextNames = ['ctx', 'context', 'c'];
+        for (const service of usage.services) {
+            for (const ctxName of contextNames) {
+                const pattern = new RegExp(`\\b${ctxName}\\.${service}\\b`, 'g');
+                if (pattern.test(output)) {
+                    output = output.replace(pattern, service);
+                    servicesAdded.add(service);
+                    changes.push(`Replaced ${ctxName}.${service} → ${service}`);
+                }
+            }
+        }
+    }
+    // Clean up self-referencing declarations: `const kv = kv;` or `const stream = await stream.create(...)`
+    // These happen when the original code had `const kv = c.var.kv;`
+    if (servicesAdded.size > 0) {
+        for (const service of servicesAdded) {
+            // Pattern: const/let/var service = service; (entire line)
+            const selfRefPattern = new RegExp(`^\\s*(?:const|let|var)\\s+${service}\\s*=\\s*${service}\\s*;?\\s*$`, 'gm');
+            if (selfRefPattern.test(output)) {
+                output = output.replace(selfRefPattern, '');
+                changes.push(`Removed self-referencing declaration: const ${service} = ${service}`);
+            }
+        }
+    }
+    // Add import for services if any were rewritten
+    if (servicesAdded.size > 0) {
+        const importList = [...servicesAdded].sort().join(', ');
+        const importLine = `import { ${importList} } from '${servicesRelativePath}';`;
+        // Check if there's already an import from the services module
+        const existingServicesImport = new RegExp(`import\\s*\\{[^}]*\\}\\s*from\\s*['"]${escapeRegex(servicesRelativePath)}['"]`);
+        if (existingServicesImport.test(output)) {
+            // Merge with existing import
+            output = output.replace(existingServicesImport, (match) => {
+                // Extract existing imports
+                const existingMatch = match.match(/\{([^}]*)\}/);
+                if (!existingMatch)
+                    return match;
+                const existing = existingMatch[1]
+                    .split(',')
+                    .map((s) => s.trim())
+                    .filter(Boolean);
+                const merged = [...new Set([...existing, ...servicesAdded])].sort();
+                return `import { ${merged.join(', ')} } from '${servicesRelativePath}'`;
+            });
+        }
+        else {
+            // Insert new import after existing imports
+            output = insertAfterImports(output, importLine);
+        }
+        changes.push(`Added import for: ${importList}`);
+    }
+    if (changes.length === 0) {
+        return { source: null, changes: [] };
+    }
+    return { source: output, changes };
+}
+/**
+ * Compute the relative import path from a source file to src/services.ts.
+ */
+export function computeServicesRelativePath(projectDir, sourceFilePath) {
+    const servicesPath = 'src/services';
+    const sourceDir = dirname(relative(projectDir, sourceFilePath));
+    let rel = relative(sourceDir, servicesPath);
+    // Ensure it starts with ./ or ../
+    if (!rel.startsWith('.')) {
+        rel = './' + rel;
+    }
+    // Remove .ts extension if present
+    rel = rel.replace(/\.ts$/, '');
+    return rel;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function insertAfterImports(source, importLine) {
+    const sf = ts.createSourceFile('temp.ts', source, ts.ScriptTarget.ESNext, true);
+    let lastImportEnd = -1;
+    for (const stmt of sf.statements) {
+        if (ts.isImportDeclaration(stmt)) {
+            lastImportEnd = stmt.getEnd();
+        }
+    }
+    if (lastImportEnd >= 0) {
+        return (source.substring(0, lastImportEnd) + '\n' + importLine + source.substring(lastImportEnd));
+    }
+    return importLine + '\n' + source;
+}
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=routes.js.map

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

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

package/dist/transforms/v3/services.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Transform: generate src/services.ts
+ *
+ * Creates a shared services module that exports singleton client instances
+ * for all Agentuity services detected in use across the project.
+ *
+ * Only includes services that are actually used — no unnecessary dependencies.
+ */
+export interface ServicesFileResult {
+    /** Generated source for src/services.ts, or null if no services used */
+    source: string | null;
+    /** What was included */
+    changes: string[];
+}
+/**
+ * Generate src/services.ts based on detected service usage.
+ */
+export declare function generateServicesFile(servicesUsed: string[]): ServicesFileResult;
+//# sourceMappingURL=services.d.ts.map

package/dist/transforms/v3/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/transforms/v3/services.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,kBAAkB;IAClC,wEAAwE;IACxE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wBAAwB;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,kBAAkB,CAsD/E"}

package/dist/transforms/v3/services.js

@@ -0,0 +1,61 @@
+/**
+ * Transform: generate src/services.ts
+ *
+ * Creates a shared services module that exports singleton client instances
+ * for all Agentuity services detected in use across the project.
+ *
+ * Only includes services that are actually used — no unnecessary dependencies.
+ */
+import { SERVICE_PACKAGE_MAP } from '../../detect-v3';
+/**
+ * Generate src/services.ts based on detected service usage.
+ */
+export function generateServicesFile(servicesUsed) {
+    if (servicesUsed.length === 0) {
+        return { source: null, changes: [] };
+    }
+    const changes = [];
+    const imports = [];
+    const exports = [];
+    // Header comment
+    const header = [
+        '/**',
+        ' * Shared Agentuity service clients.',
+        ' *',
+        ' * Auto-generated by @agentuity/migrate (v2 → v3 migration).',
+        ' * Each client auto-configures from AGENTUITY_* environment variables.',
+        ' *',
+        ' * Usage:',
+        " *   import { kv, vector } from './services';",
+        " *   const data = await kv.get('namespace', 'key');",
+        ' */',
+        '',
+    ];
+    // Logger is special — comes from @agentuity/telemetry
+    const hasLogger = servicesUsed.includes('logger');
+    const serviceClients = servicesUsed.filter((s) => s !== 'logger');
+    // Generate import + export for each service client
+    for (const service of serviceClients.sort()) {
+        const mapping = SERVICE_PACKAGE_MAP[service];
+        if (!mapping)
+            continue;
+        imports.push(`import { ${mapping.client} } from '${mapping.pkg}';`);
+        exports.push(`export const ${service} = new ${mapping.client}();`);
+        changes.push(`Added ${service} client from ${mapping.pkg}`);
+    }
+    // Logger from telemetry
+    if (hasLogger) {
+        imports.push("import { register } from '@agentuity/telemetry';");
+        exports.push('');
+        exports.push('/** Shared logger instance from telemetry */');
+        exports.push('const telemetry = register();');
+        exports.push('export const logger = telemetry.logger;');
+        changes.push('Added logger from @agentuity/telemetry');
+    }
+    const lines = [...header, ...imports, '', ...exports, ''];
+    return {
+        source: lines.join('\n'),
+        changes,
+    };
+}
+//# sourceMappingURL=services.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"services.js","sourceRoot":"","sources":["../../../src/transforms/v3/services.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAStD;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,YAAsB;IAC1D,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,iBAAiB;IACjB,MAAM,MAAM,GAAG;QACd,KAAK;QACL,sCAAsC;QACtC,IAAI;QACJ,8DAA8D;QAC9D,wEAAwE;QACxE,IAAI;QACJ,WAAW;QACX,+CAA+C;QAC/C,qDAAqD;QACrD,KAAK;QACL,EAAE;KACF,CAAC;IAEF,sDAAsD;IACtD,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,cAAc,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;IAElE,mDAAmD;IACnD,KAAK,MAAM,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,OAAO,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,MAAM,YAAY,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,gBAAgB,OAAO,UAAU,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,SAAS,OAAO,gBAAgB,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,wBAAwB;IACxB,IAAI,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,kDAAkD,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,CAAC;IAE1D,OAAO;QACN,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QACxB,OAAO;KACP,CAAC;AACH,CAAC"}

package/package.json

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