@agentuity/cli 0.0.58 → 0.0.59

package/dist/cmd/cloud/stream/list.js

@@ -0,0 +1,131 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createStorageAdapter } from './util';
+import { getCommand } from '../../../command-prefix';
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(2)} KB`;
+    if (bytes < 1024 * 1024 * 1024)
+        return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+    return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GB`;
+}
+const StreamInfoSchema = z.object({
+    id: z.string().describe('Stream ID'),
+    name: z.string().describe('Stream name'),
+    metadata: z.record(z.string(), z.string()).describe('Stream metadata'),
+    url: z.string().describe('Public URL'),
+    sizeBytes: z.number().describe('Size in bytes'),
+});
+const ListStreamsResponseSchema = z.object({
+    streams: z.array(StreamInfoSchema).describe('List of streams'),
+    total: z.number().describe('Total count of matching streams'),
+});
+export const listSubcommand = createCommand({
+    name: 'list',
+    aliases: ['ls'],
+    description: 'List recent streams with optional filtering',
+    tags: ['read-only', 'slow', 'requires-auth'],
+    requires: { auth: true, project: true },
+    idempotent: true,
+    examples: [
+        `${getCommand('stream list')} - List all streams`,
+        `${getCommand('stream ls --size 50')} - List 50 most recent streams`,
+        `${getCommand('stream list --name agent-logs')} - Filter by name`,
+        `${getCommand('stream list --metadata type=export')} - Filter by metadata`,
+        `${getCommand('stream ls --json')} - Output as JSON`,
+    ],
+    schema: {
+        options: z.object({
+            size: z.number().optional().describe('maximum number of streams to return (default: 100)'),
+            offset: z.number().optional().describe('number of streams to skip for pagination'),
+            name: z.string().optional().describe('filter by stream name'),
+            metadata: z
+                .string()
+                .optional()
+                .describe('filter by metadata (format: key=value or key1=value1,key2=value2)'),
+        }),
+        response: ListStreamsResponseSchema,
+    },
+    async handler(ctx) {
+        const { opts, options } = ctx;
+        const storage = await createStorageAdapter(ctx);
+        // Parse metadata filter if provided
+        let metadataFilter;
+        if (opts.metadata) {
+            const validPairs = {};
+            const malformed = [];
+            const pairs = opts.metadata.split(',');
+            for (const pair of pairs) {
+                const trimmedPair = pair.trim();
+                if (!trimmedPair)
+                    continue;
+                const firstEqualIdx = trimmedPair.indexOf('=');
+                if (firstEqualIdx === -1) {
+                    malformed.push(trimmedPair);
+                    continue;
+                }
+                const key = trimmedPair.substring(0, firstEqualIdx).trim();
+                const value = trimmedPair.substring(firstEqualIdx + 1).trim();
+                if (!key || !value) {
+                    malformed.push(trimmedPair);
+                    continue;
+                }
+                validPairs[key] = value;
+            }
+            if (malformed.length > 0) {
+                ctx.logger.warn(`Skipping malformed metadata pairs: ${malformed.join(', ')}`);
+            }
+            if (Object.keys(validPairs).length > 0) {
+                metadataFilter = validPairs;
+            }
+        }
+        const result = await storage.list({
+            limit: opts.size,
+            offset: opts.offset,
+            name: opts.name,
+            metadata: metadataFilter,
+        });
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return {
+                streams: result.streams,
+                total: result.total,
+            };
+        }
+        if (result.streams.length === 0) {
+            tui.info('No streams found');
+        }
+        else {
+            const tableData = result.streams.map((stream) => {
+                const sizeBytes = stream.sizeBytes ?? 0;
+                const metadataStr = Object.keys(stream.metadata).length > 0 ? JSON.stringify(stream.metadata) : '-';
+                return {
+                    Name: stream.name,
+                    ID: stream.id,
+                    Size: formatBytes(sizeBytes),
+                    Metadata: metadataStr.length > 40 ? metadataStr.substring(0, 37) + '...' : metadataStr,
+                    URL: tui.link(stream.url),
+                };
+            });
+            tui.table(tableData, [
+                { name: 'Name', alignment: 'left' },
+                { name: 'ID', alignment: 'left' },
+                { name: 'Size', alignment: 'right' },
+                { name: 'Metadata', alignment: 'left' },
+                { name: 'URL', alignment: 'left' },
+            ]);
+            tui.info(`Total: ${result.total} stream(s)`);
+        }
+        return {
+            streams: result.streams,
+            total: result.total,
+        };
+    },
+});
+export default listSubcommand;
+//# sourceMappingURL=list.js.map

package/dist/cmd/cloud/stream/list.js.map

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

package/dist/cmd/cloud/stream/util.d.ts

@@ -0,0 +1,8 @@
+import { StreamStorageService, Logger } from '@agentuity/core';
+import type { Config } from '../../../types';
+export declare function createStorageAdapter(ctx: {
+    logger: Logger;
+    projectDir: string;
+    config: Config | null;
+}): Promise<StreamStorageService>;
+//# sourceMappingURL=util.d.ts.map

package/dist/cmd/cloud/stream/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/stream/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAI/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG7C,wBAAsB,oBAAoB,CAAC,GAAG,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,iCAoBA"}

package/dist/cmd/cloud/stream/util.js

@@ -0,0 +1,19 @@
+import { StreamStorageService } from '@agentuity/core';
+import { createServerFetchAdapter } from '@agentuity/server';
+import { loadProjectSDKKey } from '../../../config';
+import { ErrorCode } from '../../../errors';
+import * as tui from '../../../tui';
+export async function createStorageAdapter(ctx) {
+    const sdkKey = await loadProjectSDKKey(ctx.projectDir);
+    if (!sdkKey) {
+        tui.fatal(`Couldn't find the AGENTUITY_SDK_KEY in ${ctx.projectDir} .env file`, ErrorCode.CONFIG_NOT_FOUND);
+    }
+    const adapter = createServerFetchAdapter({
+        headers: {
+            Authorization: `Bearer ${sdkKey}`,
+        },
+    }, ctx.logger);
+    const baseUrl = ctx.config?.overrides?.stream_url ?? 'https://stream.agentuity.cloud';
+    return new StreamStorageService(baseUrl, adapter);
+}
+//# sourceMappingURL=util.js.map

package/dist/cmd/cloud/stream/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../../src/cmd/cloud/stream/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAU,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAI1C;IACA,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,GAAG,CAAC,KAAK,CACR,0CAA0C,GAAG,CAAC,UAAU,YAAY,EACpE,SAAS,CAAC,gBAAgB,CAC1B,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,wBAAwB,CACvC;QACC,OAAO,EAAE;YACR,aAAa,EAAE,UAAU,MAAM,EAAE;SACjC;KACD,EACD,GAAG,CAAC,MAAM,CACV,CAAC;IAEF,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,IAAI,gCAAgC,CAAC;IACtF,OAAO,IAAI,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC"}

package/dist/cmd/cloud/vector/delete.d.ts

@@ -0,0 +1,3 @@
+export declare const deleteSubcommand: import("../../..").CommandDefinition;
+export default deleteSubcommand;
+//# sourceMappingURL=delete.d.ts.map

package/dist/cmd/cloud/vector/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/vector/delete.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,gBAAgB,sCAsF3B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/cmd/cloud/vector/delete.js

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import { ErrorCode } from '../../../errors';
+import * as tui from '../../../tui';
+import { createStorageAdapter } from './util';
+import { getCommand } from '../../../command-prefix';
+const VectorDeleteResponseSchema = z.object({
+    success: z.boolean().describe('Whether the operation succeeded'),
+    namespace: z.string().describe('Namespace name'),
+    keys: z.array(z.string()).describe('Keys that were deleted'),
+    deleted: z.number().describe('Number of vectors deleted'),
+    durationMs: z.number().describe('Operation duration in milliseconds'),
+    message: z.string().optional().describe('Confirmation message'),
+});
+export const deleteSubcommand = createCommand({
+    name: 'delete',
+    aliases: ['del', 'rm'],
+    description: 'Delete one or more vectors by key',
+    tags: ['destructive', 'deletes-resource', 'slow', 'requires-auth'],
+    requires: { auth: true, project: true },
+    idempotent: true,
+    examples: [
+        `${getCommand('vector delete products chair-001')} - Delete a single vector (interactive)`,
+        `${getCommand('vector rm knowledge-base doc-123 doc-456 --confirm')} - Delete multiple vectors without confirmation`,
+        `${getCommand('vector del embeddings old-profile-1 old-profile-2 --confirm')} - Bulk delete without confirmation`,
+    ],
+    schema: {
+        args: z.object({
+            namespace: z.string().min(1).describe('the vector storage namespace'),
+            keys: z.array(z.string().min(1)).min(1).describe('one or more keys to delete'),
+        }),
+        options: z.object({
+            confirm: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('if true will not prompt for confirmation'),
+        }),
+        response: VectorDeleteResponseSchema,
+    },
+    async handler(ctx) {
+        const { args, options, opts } = ctx;
+        if (!opts.confirm) {
+            if (!process.stdin.isTTY) {
+                tui.fatal('No TTY and --confirm is not set. Refusing to delete', ErrorCode.VALIDATION_FAILED);
+            }
+            const keyList = args.keys.length > 3 ? `${args.keys.slice(0, 3).join(', ')}...` : args.keys.join(', ');
+            tui.warning(`This will delete ${args.keys.length} vector(s) from ${tui.bold(args.namespace)}: ${keyList}`);
+            const confirm = await new Promise((resolve) => {
+                process.stdout.write('Are you sure? (yes/no): ');
+                process.stdin.once('data', (data) => {
+                    const answer = data.toString().trim().toLowerCase();
+                    resolve(answer === 'yes' || answer === 'y');
+                });
+            });
+            if (!confirm) {
+                tui.info('Cancelled');
+                return {
+                    success: false,
+                    namespace: args.namespace,
+                    keys: args.keys,
+                    deleted: 0,
+                    durationMs: 0,
+                    message: 'Cancelled',
+                };
+            }
+        }
+        const storage = await createStorageAdapter(ctx);
+        const started = Date.now();
+        const deleted = await storage.delete(args.namespace, ...args.keys);
+        const durationMs = Date.now() - started;
+        if (!options.json) {
+            if (deleted > 0) {
+                tui.success(`Deleted ${deleted} vector(s) from ${tui.bold(args.namespace)} (${durationMs}ms)`);
+            }
+            else {
+                tui.warning(`No vectors were deleted from ${tui.bold(args.namespace)} (keys may not exist)`);
+            }
+        }
+        return {
+            success: true,
+            namespace: args.namespace,
+            keys: args.keys,
+            deleted,
+            durationMs,
+        };
+    },
+});
+export default deleteSubcommand;
+//# sourceMappingURL=delete.js.map

package/dist/cmd/cloud/vector/delete.js.map

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

package/dist/cmd/cloud/vector/get.d.ts

@@ -0,0 +1,3 @@
+export declare const getSubcommand: import("../../..").CommandDefinition;
+export default getSubcommand;
+//# sourceMappingURL=get.d.ts.map

package/dist/cmd/cloud/vector/get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/vector/get.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,aAAa,sCA4ExB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/cmd/cloud/vector/get.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createStorageAdapter } from './util';
+import { getCommand } from '../../../command-prefix';
+const VectorGetResponseSchema = z.object({
+    exists: z.boolean().describe('Whether the vector exists'),
+    key: z.string().optional().describe('Vector key'),
+    id: z.string().optional().describe('Vector ID'),
+    metadata: z.record(z.string(), z.unknown()).optional().describe('Vector metadata'),
+    document: z.string().optional().describe('Original document text'),
+    similarity: z.number().optional().describe('Similarity score'),
+});
+export const getSubcommand = createCommand({
+    name: 'get',
+    description: 'Get a specific vector entry by key',
+    tags: ['read-only', 'fast', 'requires-auth'],
+    requires: { auth: true, project: true },
+    idempotent: true,
+    examples: [
+        `${getCommand('vector get products chair-001')} - Get a specific product vector`,
+        `${getCommand('vector get knowledge-base doc-123')} - Get a document from knowledge base`,
+        `${getCommand('vector get embeddings user-profile-456')} - Get user profile embedding`,
+    ],
+    schema: {
+        args: z.object({
+            namespace: z.string().min(1).describe('the vector storage namespace'),
+            key: z.string().min(1).describe('the key of the vector to retrieve'),
+        }),
+        response: VectorGetResponseSchema,
+    },
+    async handler(ctx) {
+        const { args, options } = ctx;
+        const storage = await createStorageAdapter(ctx);
+        const started = Date.now();
+        const result = await storage.get(args.namespace, args.key);
+        const durationMs = Date.now() - started;
+        if (!options.json) {
+            if (result.exists) {
+                tui.success(`Found vector "${tui.bold(args.key)}" in ${tui.bold(args.namespace)} (${durationMs}ms)`);
+                const data = result.data;
+                tui.info(`  ID: ${data.id}`);
+                tui.info(`  Key: ${data.key}`);
+                if (data.similarity !== undefined) {
+                    tui.info(`  Similarity: ${(data.similarity * 100).toFixed(1)}%`);
+                }
+                if (data.document) {
+                    const docPreview = data.document.length > 200
+                        ? data.document.substring(0, 197) + '...'
+                        : data.document;
+                    tui.info(`  Document: ${docPreview}`);
+                }
+                if (data.metadata && Object.keys(data.metadata).length > 0) {
+                    tui.info(`  Metadata: ${JSON.stringify(data.metadata, null, 2)}`);
+                }
+                if (data.embeddings) {
+                    tui.info(`  Embeddings: [${data.embeddings.length} dimensions]`);
+                }
+            }
+            else {
+                tui.warning(`Vector "${tui.bold(args.key)}" not found in ${tui.bold(args.namespace)}`);
+            }
+        }
+        if (result.exists) {
+            return {
+                exists: true,
+                key: result.data.key,
+                id: result.data.id,
+                metadata: result.data.metadata,
+                document: result.data.document,
+                similarity: result.data.similarity,
+            };
+        }
+        return {
+            exists: false,
+        };
+    },
+});
+export default getSubcommand;
+//# sourceMappingURL=get.js.map

package/dist/cmd/cloud/vector/get.js.map

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

package/dist/cmd/cloud/vector/index.d.ts

@@ -0,0 +1,3 @@
+export declare const vectorCommand: import("../../..").CommandDefinition;
+export default vectorCommand;
+//# sourceMappingURL=index.d.ts.map

package/dist/cmd/cloud/vector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/vector/index.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,aAAa,sCAOxB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/cmd/cloud/vector/index.js

@@ -0,0 +1,14 @@
+import { createCommand } from '../../../types';
+import { deleteSubcommand } from './delete';
+import { getSubcommand } from './get';
+import { searchSubcommand } from './search';
+export const vectorCommand = createCommand({
+    name: 'vector',
+    aliases: ['vec'],
+    description: 'Manage vector storage for your projects',
+    tags: ['requires-auth', 'destructive', 'deletes-resource', 'slow'],
+    subcommands: [searchSubcommand, getSubcommand, deleteSubcommand],
+    requires: { auth: true, project: true },
+});
+export default vectorCommand;
+//# sourceMappingURL=index.js.map

package/dist/cmd/cloud/vector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cmd/cloud/vector/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,CAAC,KAAK,CAAC;IAChB,WAAW,EAAE,yCAAyC;IACtD,IAAI,EAAE,CAAC,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,CAAC;IAClE,WAAW,EAAE,CAAC,gBAAgB,EAAE,aAAa,EAAE,gBAAgB,CAAC;IAChE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;CACvC,CAAC,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/cmd/cloud/vector/search.d.ts

@@ -0,0 +1,3 @@
+export declare const searchSubcommand: import("../../..").CommandDefinition;
+export default searchSubcommand;
+//# sourceMappingURL=search.d.ts.map

package/dist/cmd/cloud/vector/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/vector/search.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,gBAAgB,sCAqI3B,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/cmd/cloud/vector/search.js

@@ -0,0 +1,136 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createStorageAdapter } from './util';
+import { getCommand } from '../../../command-prefix';
+const VectorSearchResultSchema = z.object({
+    id: z.string().describe('Vector ID'),
+    key: z.string().describe('Vector key'),
+    similarity: z.number().describe('Similarity score (0-1)'),
+    metadata: z.record(z.string(), z.unknown()).optional().describe('Vector metadata'),
+});
+const VectorSearchResponseSchema = z.object({
+    namespace: z.string().describe('Namespace name'),
+    query: z.string().describe('Search query used'),
+    results: z.array(VectorSearchResultSchema).describe('Search results'),
+    count: z.number().describe('Number of results found'),
+});
+export const searchSubcommand = createCommand({
+    name: 'search',
+    aliases: ['list', 'ls'],
+    description: 'Search for vectors using semantic similarity',
+    tags: ['read-only', 'slow', 'requires-auth'],
+    requires: { auth: true, project: true },
+    idempotent: true,
+    examples: [
+        `${getCommand('vector search products "comfortable office chair"')} - Search for similar products`,
+        `${getCommand('vector list knowledge-base "machine learning"')} - Search knowledge base`,
+        `${getCommand('vector search docs "API documentation" --limit 5')} - Limit results`,
+        `${getCommand('vector search products "ergonomic" --similarity 0.8')} - Set minimum similarity`,
+        `${getCommand('vector ls embeddings "neural networks" --metadata category=ai')} - Filter by metadata`,
+    ],
+    schema: {
+        args: z.object({
+            namespace: z.string().min(1).describe('the vector storage namespace'),
+            query: z.string().min(1).describe('the search query text'),
+        }),
+        options: z.object({
+            limit: z.number().optional().describe('maximum number of results to return (default: 10)'),
+            similarity: z
+                .number()
+                .min(0)
+                .max(1)
+                .optional()
+                .describe('minimum similarity threshold (0.0-1.0)'),
+            metadata: z
+                .string()
+                .optional()
+                .describe('filter by metadata (format: key=value or key1=value1,key2=value2)'),
+        }),
+        response: VectorSearchResponseSchema,
+    },
+    async handler(ctx) {
+        const { args, opts, options } = ctx;
+        const storage = await createStorageAdapter(ctx);
+        const started = Date.now();
+        // Parse metadata filter if provided
+        let metadataFilter;
+        if (opts.metadata) {
+            const validPairs = {};
+            const malformed = [];
+            const pairs = opts.metadata.split(',');
+            for (const pair of pairs) {
+                const trimmedPair = pair.trim();
+                if (!trimmedPair)
+                    continue;
+                const firstEqualIdx = trimmedPair.indexOf('=');
+                if (firstEqualIdx === -1) {
+                    malformed.push(trimmedPair);
+                    continue;
+                }
+                const key = trimmedPair.substring(0, firstEqualIdx).trim();
+                const value = trimmedPair.substring(firstEqualIdx + 1).trim();
+                if (!key || !value) {
+                    malformed.push(trimmedPair);
+                    continue;
+                }
+                // Try to parse as JSON for complex values, otherwise use as string
+                try {
+                    validPairs[key] = JSON.parse(value);
+                }
+                catch {
+                    validPairs[key] = value;
+                }
+            }
+            if (malformed.length > 0) {
+                ctx.logger.warn(`Skipping malformed metadata pairs: ${malformed.join(', ')}`);
+            }
+            if (Object.keys(validPairs).length > 0) {
+                metadataFilter = validPairs;
+            }
+        }
+        const results = await storage.search(args.namespace, {
+            query: args.query,
+            limit: opts.limit,
+            similarity: opts.similarity,
+            metadata: metadataFilter,
+        });
+        const durationMs = Date.now() - started;
+        if (!options.json) {
+            if (results.length === 0) {
+                tui.info(`No vectors found matching "${tui.bold(args.query)}" in ${tui.bold(args.namespace)}`);
+            }
+            else {
+                tui.info(`Found ${results.length} result(s) in ${tui.bold(args.namespace)} (${durationMs}ms):`);
+                const tableData = results.map((result) => {
+                    const metadataStr = result.metadata ? JSON.stringify(result.metadata) : '-';
+                    return {
+                        Key: result.key,
+                        ID: result.id,
+                        Similarity: `${(result.similarity * 100).toFixed(1)}%`,
+                        Metadata: metadataStr.length > 50 ? metadataStr.substring(0, 47) + '...' : metadataStr,
+                    };
+                });
+                tui.table(tableData, [
+                    { name: 'Key', alignment: 'left' },
+                    { name: 'ID', alignment: 'left' },
+                    { name: 'Similarity', alignment: 'right' },
+                    { name: 'Metadata', alignment: 'left' },
+                ]);
+            }
+        }
+        return {
+            namespace: args.namespace,
+            query: args.query,
+            results: results.map((r) => ({
+                id: r.id,
+                key: r.key,
+                similarity: r.similarity,
+                metadata: r.metadata,
+            })),
+            count: results.length,
+        };
+    },
+});
+export default searchSubcommand;
+//# sourceMappingURL=search.js.map

package/dist/cmd/cloud/vector/search.js.map

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

package/dist/cmd/cloud/vector/util.d.ts

@@ -0,0 +1,8 @@
+import { Logger, VectorStorageService } from '@agentuity/core';
+import type { Config } from '../../../types';
+export declare function createStorageAdapter(ctx: {
+    logger: Logger;
+    projectDir: string;
+    config: Config | null;
+}): Promise<VectorStorageService>;
+//# sourceMappingURL=util.d.ts.map

package/dist/cmd/cloud/vector/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/vector/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG7C,wBAAsB,oBAAoB,CAAC,GAAG,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,iCAiBA"}

package/dist/cmd/cloud/vector/util.js

@@ -0,0 +1,18 @@
+import { VectorStorageService } from '@agentuity/core';
+import { createServerFetchAdapter } from '@agentuity/server';
+import { loadProjectSDKKey } from '../../../config';
+import * as tui from '../../../tui';
+export async function createStorageAdapter(ctx) {
+    const sdkKey = await loadProjectSDKKey(ctx.projectDir);
+    if (!sdkKey) {
+        tui.fatal(`Couldn't find the AGENTUITY_SDK_KEY in ${ctx.projectDir} .env file`);
+    }
+    const adapter = createServerFetchAdapter({
+        headers: {
+            Authorization: `Bearer ${sdkKey}`,
+        },
+    }, ctx.logger);
+    const baseUrl = ctx.config?.overrides?.catalyst_url ?? 'https://catalyst.agentuity.cloud';
+    return new VectorStorageService(baseUrl, adapter);
+}
+//# sourceMappingURL=util.js.map

package/dist/cmd/cloud/vector/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../../src/cmd/cloud/vector/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAI1C;IACA,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,GAAG,CAAC,KAAK,CAAC,0CAA0C,GAAG,CAAC,UAAU,YAAY,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,OAAO,GAAG,wBAAwB,CACvC;QACC,OAAO,EAAE;YACR,aAAa,EAAE,UAAU,MAAM,EAAE;SACjC;KACD,EACD,GAAG,CAAC,MAAM,CACV,CAAC;IAEF,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,IAAI,kCAAkC,CAAC;IAC1F,OAAO,IAAI,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC"}

package/dist/cmd/dev/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/cmd/dev/agents.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,gBAAgB,sCA2G3B,CAAC"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../src/cmd/dev/agents.ts"],"names":[],"mappings":"AAkCA,eAAO,MAAM,gBAAgB,sCA4G3B,CAAC"}

package/dist/cmd/dev/agents.js

@@ -7,7 +7,7 @@ const AgentSchema = z.object({
     id: z.string(),
     name: z.string(),
     description: z.string().nullable(),
-    identifier: z.string(),
+    identifier: z.string().nullable(), // nullable for legacy records
     version: z.string().nullable(),
     deploymentId: z.string().nullable(),
     devmode: z.boolean(),
@@ -58,7 +58,8 @@ export const agentsSubcommand = createSubcommand({
         if (!response.success) {
             tui.fatal(`Failed to fetch agents: ${response.message ?? 'Unknown error'}`);
         }
-        const agents = response.data;
+        // Filter out legacy agents without identifiers
+        const agents = response.data.filter((agent) => agent.identifier !== null);
         if (format === 'json' && !options.json) {
             console.log(JSON.stringify(agents, null, 2));
             return agents;