@agentuity/cli 0.0.101 → 0.0.103

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

@@ -1,21 +1,38 @@
 import { createCommand } from '../../../types';
 import { deleteSubcommand } from './delete';
+import { deleteNamespaceSubcommand } from './delete-namespace';
 import { getSubcommand } from './get';
+import { listNamespacesSubcommand } from './list-namespaces';
 import { searchSubcommand } from './search';
+import { statsSubcommand } from './stats';
+import { upsertSubcommand } from './upsert';
 import { getCommand } from '../../../command-prefix';
 export const vectorCommand = createCommand({
     name: 'vector',
     aliases: ['vec'],
     description: 'Manage vector storage for your projects',
-    tags: ['requires-auth', 'destructive', 'deletes-resource', 'slow'],
+    tags: ['requires-auth', 'slow'],
     examples: [
         {
-            command: getCommand('cloud vector search "query text"'),
+            command: getCommand('cloud vector search products "query text"'),
             description: 'Search vector storage',
         },
-        { command: getCommand('cloud vec get <id>'), description: 'Get vector by ID' },
+        {
+            command: getCommand('cloud vec upsert products doc1 --document "text"'),
+            description: 'Upsert a vector',
+        },
+        { command: getCommand('cloud vec get products doc1'), description: 'Get vector by key' },
+        { command: getCommand('cloud vec stats'), description: 'Show namespace statistics' },
+    ],
+    subcommands: [
+        upsertSubcommand,
+        searchSubcommand,
+        getSubcommand,
+        deleteSubcommand,
+        statsSubcommand,
+        listNamespacesSubcommand,
+        deleteNamespaceSubcommand,
     ],
-    subcommands: [searchSubcommand, getSubcommand, deleteSubcommand],
     requires: { auth: true, project: true },
 });
 export default vectorCommand;

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

@@ -1 +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;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,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,QAAQ,EAAE;QACT;YACC,OAAO,EAAE,UAAU,CAAC,kCAAkC,CAAC;YACvD,WAAW,EAAE,uBAAuB;SACpC;QACD,EAAE,OAAO,EAAE,UAAU,CAAC,oBAAoB,CAAC,EAAE,WAAW,EAAE,kBAAkB,EAAE;KAC9E;IACD,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"}
+{"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,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,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,MAAM,CAAC;IAC/B,QAAQ,EAAE;QACT;YACC,OAAO,EAAE,UAAU,CAAC,2CAA2C,CAAC;YAChE,WAAW,EAAE,uBAAuB;SACpC;QACD;YACC,OAAO,EAAE,UAAU,CAAC,kDAAkD,CAAC;YACvE,WAAW,EAAE,iBAAiB;SAC9B;QACD,EAAE,OAAO,EAAE,UAAU,CAAC,6BAA6B,CAAC,EAAE,WAAW,EAAE,mBAAmB,EAAE;QACxF,EAAE,OAAO,EAAE,UAAU,CAAC,iBAAiB,CAAC,EAAE,WAAW,EAAE,2BAA2B,EAAE;KACpF;IACD,WAAW,EAAE;QACZ,gBAAgB;QAChB,gBAAgB;QAChB,aAAa;QACb,gBAAgB;QAChB,eAAe;QACf,wBAAwB;QACxB,yBAAyB;KACzB;IACD,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;CACvC,CAAC,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/cmd/cloud/vector/list-namespaces.d.ts

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

package/dist/cmd/cloud/vector/list-namespaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-namespaces.d.ts","sourceRoot":"","sources":["../../../../src/cmd/cloud/vector/list-namespaces.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,wBAAwB,sCAmCnC,CAAC;AAEH,eAAe,wBAAwB,CAAC"}

package/dist/cmd/cloud/vector/list-namespaces.js

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createStorageAdapter } from './util';
+import { getCommand } from '../../../command-prefix';
+const NamespaceListResponseSchema = z.array(z.string().describe('Namespace name'));
+export const listNamespacesSubcommand = createCommand({
+    name: 'list-namespaces',
+    aliases: ['namespaces', 'ns'],
+    description: 'List all vector namespaces',
+    tags: ['read-only', 'fast', 'requires-auth'],
+    requires: { auth: true, project: true },
+    examples: [
+        { command: getCommand('vector list-namespaces'), description: 'List all namespaces' },
+        { command: getCommand('vector namespaces'), description: 'List namespaces (using alias)' },
+        { command: getCommand('vector ns'), description: 'List namespaces (short alias)' },
+    ],
+    schema: {
+        response: NamespaceListResponseSchema,
+    },
+    webUrl: '/services/vector',
+    idempotent: true,
+    async handler(ctx) {
+        const { options } = ctx;
+        const storage = await createStorageAdapter(ctx);
+        const namespaces = await storage.getNamespaces();
+        if (!options.json) {
+            if (namespaces.length === 0) {
+                tui.info('No vector namespaces found');
+            }
+            else {
+                tui.info(`Found ${namespaces.length} namespace(s):`);
+                for (const name of namespaces) {
+                    tui.arrow(name);
+                }
+            }
+        }
+        return namespaces;
+    },
+});
+export default listNamespacesSubcommand;
+//# sourceMappingURL=list-namespaces.js.map

package/dist/cmd/cloud/vector/list-namespaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-namespaces.js","sourceRoot":"","sources":["../../../../src/cmd/cloud/vector/list-namespaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAEnF,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAa,CAAC;IACrD,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC;IAC7B,WAAW,EAAE,4BAA4B;IACzC,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,CAAC;IAC5C,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;IACvC,QAAQ,EAAE;QACT,EAAE,OAAO,EAAE,UAAU,CAAC,wBAAwB,CAAC,EAAE,WAAW,EAAE,qBAAqB,EAAE;QACrF,EAAE,OAAO,EAAE,UAAU,CAAC,mBAAmB,CAAC,EAAE,WAAW,EAAE,+BAA+B,EAAE;QAC1F,EAAE,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,WAAW,EAAE,+BAA+B,EAAE;KAClF;IACD,MAAM,EAAE;QACP,QAAQ,EAAE,2BAA2B;KACrC;IACD,MAAM,EAAE,kBAAkB;IAC1B,UAAU,EAAE,IAAI;IAEhB,KAAK,CAAC,OAAO,CAAC,GAAG;QAChB,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;QACxB,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,aAAa,EAAE,CAAC;QAEjD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACnB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,GAAG,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACP,GAAG,CAAC,IAAI,CAAC,SAAS,UAAU,CAAC,MAAM,gBAAgB,CAAC,CAAC;gBACrD,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;oBAC/B,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjB,CAAC;YACF,CAAC;QACF,CAAC;QAED,OAAO,UAAU,CAAC;IACnB,CAAC;CACD,CAAC,CAAC;AAEH,eAAe,wBAAwB,CAAC"}

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

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

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

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

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

@@ -0,0 +1,142 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createStorageAdapter } from './util';
+import { getCommand } from '../../../command-prefix';
+const VectorItemStatsSchema = z.object({
+    embedding: z.array(z.number()).optional().describe('The embedding vector'),
+    document: z.string().optional().describe('Original document text'),
+    size: z.number().describe('Size in bytes'),
+    metadata: z.record(z.string(), z.unknown()).optional().describe('Metadata'),
+    firstUsed: z.number().describe('First access timestamp (ms)'),
+    lastUsed: z.number().describe('Last access timestamp (ms)'),
+    count: z.number().optional().describe('Access count (only available in cloud storage)'),
+});
+const VectorNamespaceStatsSchema = z.object({
+    sum: z.number().describe('Total size in bytes'),
+    count: z.number().describe('Number of vectors'),
+    createdAt: z.number().optional().describe('Creation timestamp (ms)'),
+    lastUsed: z.number().optional().describe('Last used timestamp (ms)'),
+});
+const VectorStatsResponseSchema = z.union([
+    VectorNamespaceStatsSchema.extend({
+        namespace: z.string().describe('Namespace name'),
+        sampledResults: z.record(z.string(), VectorItemStatsSchema).optional(),
+    }),
+    z.record(z.string(), VectorNamespaceStatsSchema),
+]);
+export const statsSubcommand = createCommand({
+    name: 'stats',
+    description: 'Get statistics for vector storage',
+    tags: ['read-only', 'fast', 'requires-auth'],
+    requires: { auth: true, project: true },
+    idempotent: true,
+    examples: [
+        { command: getCommand('vector stats'), description: 'Show stats for all namespaces' },
+        {
+            command: getCommand('vector stats products'),
+            description: 'Show detailed stats for products namespace',
+        },
+        { command: getCommand('vector stats embeddings'), description: 'Show stats for embeddings' },
+    ],
+    schema: {
+        args: z.object({
+            name: z.string().optional().describe('the vector namespace (optional)'),
+        }),
+        response: VectorStatsResponseSchema,
+    },
+    webUrl: (ctx) => ctx.args.name ? `/services/vector/${encodeURIComponent(ctx.args.name)}` : '/services/vector',
+    async handler(ctx) {
+        const { args, options } = ctx;
+        const storage = await createStorageAdapter(ctx);
+        if (args.name) {
+            const stats = await storage.getStats(args.name);
+            if (!options.json) {
+                if (stats.count === 0 && stats.sum === 0) {
+                    tui.info(`Namespace ${tui.bold(args.name)} is empty or does not exist`);
+                }
+                else {
+                    tui.info(`Statistics for ${tui.bold(args.name)}:`);
+                    tui.info(`  Vectors: ${stats.count}`);
+                    const sizeDisplay = stats.sum < 1024 * 1024
+                        ? `${stats.sum.toLocaleString()} bytes`
+                        : `${(stats.sum / (1024 * 1024)).toFixed(2)} MB`;
+                    tui.info(`  Total size: ${sizeDisplay}`);
+                    if (stats.createdAt) {
+                        tui.info(`  Created: ${new Date(stats.createdAt).toLocaleString()}`);
+                    }
+                    if (stats.lastUsed) {
+                        tui.info(`  Last used: ${new Date(stats.lastUsed).toLocaleString()}`);
+                    }
+                    if (stats.sampledResults && Object.keys(stats.sampledResults).length > 0) {
+                        tui.info('');
+                        tui.info(`  Sample vectors (${Object.keys(stats.sampledResults).length}):`);
+                        const tableData = Object.entries(stats.sampledResults).map(([key, item]) => {
+                            const docPreview = item.document
+                                ? item.document.length > 30
+                                    ? item.document.substring(0, 27) + '...'
+                                    : item.document
+                                : '-';
+                            return {
+                                Key: key,
+                                Size: `${item.size} bytes`,
+                                Accesses: item.count ?? '-',
+                                'Last Used': new Date(item.lastUsed).toLocaleDateString(),
+                                Document: docPreview,
+                            };
+                        });
+                        tui.table(tableData, [
+                            { name: 'Key', alignment: 'left' },
+                            { name: 'Size', alignment: 'right' },
+                            { name: 'Accesses', alignment: 'right' },
+                            { name: 'Last Used', alignment: 'left' },
+                            { name: 'Document', alignment: 'left' },
+                        ]);
+                    }
+                }
+            }
+            return {
+                namespace: args.name,
+                ...stats,
+            };
+        }
+        else {
+            const allStats = await storage.getAllStats();
+            const entries = Object.entries(allStats);
+            if (!options.json) {
+                if (entries.length === 0) {
+                    tui.info('No vector namespaces found');
+                }
+                else {
+                    tui.info(`Found ${entries.length} ${tui.plural(entries.length, 'namespace', 'namespaces')}:`);
+                    const tableData = entries.map(([name, stats]) => {
+                        const sizeDisplay = stats.sum < 1024 * 1024
+                            ? `${stats.sum.toLocaleString()} bytes`
+                            : `${(stats.sum / (1024 * 1024)).toFixed(2)} MB`;
+                        return {
+                            Namespace: name,
+                            Vectors: stats.count,
+                            Size: sizeDisplay,
+                            Created: stats.createdAt
+                                ? new Date(stats.createdAt).toLocaleDateString()
+                                : '-',
+                            'Last Used': stats.lastUsed
+                                ? new Date(stats.lastUsed).toLocaleDateString()
+                                : '-',
+                        };
+                    });
+                    tui.table(tableData, [
+                        { name: 'Namespace', alignment: 'left' },
+                        { name: 'Vectors', alignment: 'right' },
+                        { name: 'Size', alignment: 'right' },
+                        { name: 'Created', alignment: 'left' },
+                        { name: 'Last Used', alignment: 'left' },
+                    ]);
+                }
+            }
+            return allStats;
+        }
+    },
+});
+export default statsSubcommand;
+//# sourceMappingURL=stats.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,192 @@
+import { z } from 'zod';
+import { createCommand } from '../../../types';
+import * as tui from '../../../tui';
+import { createStorageAdapter } from './util';
+import { getCommand } from '../../../command-prefix';
+const VectorUpsertResponseSchema = z.object({
+    success: z.boolean().describe('Whether the operation succeeded'),
+    namespace: z.string().describe('Namespace name'),
+    count: z.number().describe('Number of vectors upserted'),
+    results: z
+        .array(z.object({
+        key: z.string().describe('Vector key'),
+        id: z.string().describe('Vector ID'),
+    }))
+        .describe('Upsert results with key-to-id mappings'),
+    durationMs: z.number().describe('Operation duration in milliseconds'),
+});
+export const upsertSubcommand = createCommand({
+    name: 'upsert',
+    aliases: ['put', 'add'],
+    description: 'Add or update vectors in the vector storage',
+    tags: ['mutating', 'updates-resource', 'slow', 'requires-auth'],
+    idempotent: true,
+    requires: { auth: true, project: true },
+    examples: [
+        {
+            command: getCommand('vector upsert products doc1 --document "Comfortable office chair"'),
+            description: 'Upsert a single vector with document text',
+        },
+        {
+            command: getCommand('vector upsert products doc1 --document "Chair" --metadata \'{"category":"furniture"}\''),
+            description: 'Upsert with metadata',
+        },
+        {
+            command: getCommand('vector upsert embeddings vec1 --embeddings "[0.1, 0.2, 0.3]"'),
+            description: 'Upsert with pre-computed embeddings',
+        },
+        {
+            command: getCommand('vector upsert products --file vectors.json'),
+            description: 'Bulk upsert from JSON file',
+        },
+        {
+            command: `cat vectors.json | ${getCommand('vector upsert products -')}`,
+            description: 'Bulk upsert from stdin',
+        },
+    ],
+    schema: {
+        args: z.object({
+            namespace: z.string().min(1).describe('the vector storage namespace'),
+            key: z
+                .string()
+                .optional()
+                .describe('the key for single vector upsert (not used with --file or stdin)'),
+        }),
+        options: z.object({
+            document: z.string().optional().describe('document text to embed'),
+            embeddings: z.string().optional().describe('pre-computed embeddings as JSON array'),
+            metadata: z.string().optional().describe('metadata as JSON object'),
+            file: z
+                .string()
+                .optional()
+                .describe('path to JSON file containing vectors, or "-" for stdin'),
+        }),
+        response: VectorUpsertResponseSchema,
+    },
+    webUrl: (ctx) => `/services/vector/${encodeURIComponent(ctx.args.namespace)}`,
+    async handler(ctx) {
+        const { args, opts, options, logger } = ctx;
+        const storage = await createStorageAdapter(ctx);
+        let documents = [];
+        // Check if reading from file or stdin
+        const fileArg = opts.file || (args.key === '-' ? '-' : undefined);
+        if (fileArg) {
+            let content;
+            if (fileArg === '-') {
+                // Read from stdin
+                const chunks = [];
+                const reader = Bun.stdin.stream().getReader();
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    chunks.push(value);
+                }
+                const decoder = new TextDecoder();
+                content = chunks.map((chunk) => decoder.decode(chunk, { stream: true })).join('');
+            }
+            else {
+                // Read from file
+                const file = Bun.file(fileArg);
+                if (!(await file.exists())) {
+                    tui.fatal(`File not found: ${fileArg}`);
+                }
+                content = await file.text();
+            }
+            try {
+                const parsed = JSON.parse(content.trim());
+                if (Array.isArray(parsed)) {
+                    documents = parsed;
+                }
+                else {
+                    documents = [parsed];
+                }
+            }
+            catch {
+                tui.fatal('Invalid JSON in input file/stdin');
+            }
+            // Validate documents
+            for (const doc of documents) {
+                if (!doc.key || typeof doc.key !== 'string') {
+                    tui.fatal('Each document must have a non-empty "key" property');
+                }
+                if (!doc.document && !('embeddings' in doc)) {
+                    tui.fatal(`Document with key "${doc.key}" must have either "document" or "embeddings" property`);
+                }
+            }
+        }
+        else {
+            // Single vector upsert via command line arguments
+            if (!args.key) {
+                tui.fatal('Key is required for single vector upsert. Use --file for bulk upsert.');
+            }
+            if (!opts.document && !opts.embeddings) {
+                tui.fatal('Either --document or --embeddings is required');
+            }
+            if (opts.document && opts.embeddings) {
+                tui.fatal('Cannot use both --document and --embeddings');
+            }
+            let metadata;
+            if (opts.metadata) {
+                try {
+                    metadata = JSON.parse(opts.metadata);
+                }
+                catch {
+                    tui.fatal('Invalid JSON in --metadata');
+                }
+            }
+            if (opts.document) {
+                documents = [
+                    {
+                        key: args.key,
+                        document: opts.document,
+                        metadata,
+                    },
+                ];
+            }
+            else if (opts.embeddings) {
+                let embeddings;
+                try {
+                    embeddings = JSON.parse(opts.embeddings);
+                    if (!Array.isArray(embeddings) || !embeddings.every((n) => typeof n === 'number')) {
+                        throw new Error('Not an array of numbers');
+                    }
+                }
+                catch {
+                    tui.fatal('Invalid embeddings: must be a JSON array of numbers');
+                }
+                documents = [
+                    {
+                        key: args.key,
+                        embeddings,
+                        metadata,
+                    },
+                ];
+            }
+        }
+        if (documents.length === 0) {
+            tui.fatal('No documents to upsert');
+        }
+        const started = Date.now();
+        logger.debug(`Upserting ${documents.length} vector(s) to ${args.namespace}`);
+        const results = await storage.upsert(args.namespace, ...documents);
+        const durationMs = Date.now() - started;
+        if (!options.json) {
+            tui.success(`Upserted ${results.length} vector(s) to ${tui.bold(args.namespace)} (${durationMs}ms)`);
+            if (results.length <= 10) {
+                for (const result of results) {
+                    tui.arrow(`${result.key} → ${result.id}`);
+                }
+            }
+        }
+        return {
+            success: true,
+            namespace: args.namespace,
+            count: results.length,
+            results,
+            durationMs,
+        };
+    },
+});
+export default upsertSubcommand;
+//# sourceMappingURL=upsert.js.map

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

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

package/dist/cmd/dev/file-watcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../../src/cmd/dev/file-watcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAgPjF"}
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../../src/cmd/dev/file-watcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAqTjF"}

package/dist/cmd/dev/file-watcher.js

@@ -4,8 +4,8 @@
  * Watches source files and triggers server restart on changes.
  * Handles both backend (API, agents, lib) and generates restart signals.
  */
-import { watch, statSync, readdirSync } from 'node:fs';
-import { resolve } from 'node:path';
+import { watch, statSync, readdirSync, lstatSync } from 'node:fs';
+import { resolve, relative } from 'node:path';
 import { createAgentTemplates, createAPITemplates } from './templates';
 /**
  * Create a file watcher manager for hot reload
@@ -15,12 +15,28 @@ export function createFileWatcher(options) {
     const watchers = [];
     let paused = false;
     let buildCooldownTimer = null;
-    // Watch the entire root directory recursively
-    // This is simpler and more reliable than watching individual paths
-    const watchDirs = [rootDir];
-    // Directories to ignore
+    // Directories to ignore - these are NEVER traversed into
+    // This prevents EMFILE errors from symlink cycles in node_modules
+    const ignoreDirs = new Set([
+        '.agentuity',
+        '.agents',
+        '.claude',
+        '.code',
+        '.opencode',
+        'node_modules',
+        '.git',
+        'dist',
+        'build',
+        '.next',
+        '.turbo',
+    ]);
+    // Paths to ignore for file change events (but may still be traversed)
     const ignorePaths = [
         '.agentuity',
+        '.agents',
+        '.claude',
+        '.code',
+        '.opencode',
         'node_modules',
         '.git',
         'dist',
@@ -125,43 +141,86 @@ export function createFileWatcher(options) {
         logger.debug('File changed (%s): %s', eventType, changedFile || watchDir);
         onRestart();
     }
+    /**
+     * Recursively collect all directories to watch, skipping ignored directories.
+     * This prevents EMFILE errors from symlink cycles in node_modules.
+     */
+    function collectWatchDirs(dir, visited = new Set()) {
+        const dirs = [dir];
+        try {
+            // Use lstat to check for symlinks - get the real path to detect cycles
+            const stat = lstatSync(dir);
+            // Skip symlinks to prevent following circular symlinks
+            if (stat.isSymbolicLink()) {
+                logger.trace('Skipping symlink: %s', dir);
+                return [];
+            }
+            // Track visited inodes to detect cycles
+            const key = `${stat.dev}:${stat.ino}`;
+            if (visited.has(key)) {
+                logger.trace('Skipping already visited directory (cycle detected): %s', dir);
+                return [];
+            }
+            visited.add(key);
+            const entries = readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const name = entry.name;
+                // Skip ignored directories entirely - this is the key fix
+                if (ignoreDirs.has(name)) {
+                    logger.trace('Skipping ignored directory: %s', resolve(dir, name));
+                    continue;
+                }
+                // Skip hidden directories (except specific ones like .env folders)
+                if (name.startsWith('.')) {
+                    logger.trace('Skipping hidden directory: %s', resolve(dir, name));
+                    continue;
+                }
+                const fullPath = resolve(dir, name);
+                dirs.push(...collectWatchDirs(fullPath, visited));
+            }
+        }
+        catch (error) {
+            logger.trace('Error reading directory %s: %s', dir, error);
+        }
+        return dirs;
+    }
     /**
      * Start watching files
      */
     function start() {
         logger.debug('Starting file watchers for hot reload...');
-        // Watch root directory (already absolute path)
-        for (const watchPath of watchDirs) {
+        // Collect all directories to watch, excluding node_modules and other ignored dirs
+        const allDirs = collectWatchDirs(rootDir);
+        // Add additional paths
+        if (additionalPaths && additionalPaths.length > 0) {
+            for (const additionalPath of additionalPaths) {
+                const fullPath = resolve(rootDir, additionalPath);
+                allDirs.push(...collectWatchDirs(fullPath));
+            }
+        }
+        // De-duplicate directories
+        const uniqueDirs = [...new Set(allDirs)];
+        logger.debug('Collected %d directories to watch', uniqueDirs.length);
+        // Watch each directory non-recursively
+        for (const watchPath of uniqueDirs) {
             try {
-                logger.trace('Setting up watcher for: %s', watchPath);
-                const watcher = watch(watchPath, { recursive: true }, (eventType, changedFile) => {
-                    handleFileChange(eventType, changedFile, watchPath);
+                // Use non-recursive watch to avoid traversing into node_modules
+                const watcher = watch(watchPath, { recursive: false }, (eventType, changedFile) => {
+                    // Construct relative path from rootDir for consistent handling
+                    const relPath = changedFile
+                        ? relative(rootDir, resolve(watchPath, changedFile))
+                        : relative(rootDir, watchPath);
+                    handleFileChange(eventType, relPath || changedFile, rootDir);
                 });
                 watchers.push(watcher);
-                logger.trace('Watcher started for: %s', watchPath);
             }
             catch (error) {
-                logger.warn('Failed to start watcher for %s: %s', watchPath, error);
-            }
-        }
-        // Watch additional paths if provided
-        if (additionalPaths && additionalPaths.length > 0) {
-            for (const additionalPath of additionalPaths) {
-                const fullPath = resolve(rootDir, additionalPath);
-                try {
-                    logger.trace('Setting up watcher for additional path: %s', fullPath);
-                    const watcher = watch(fullPath, { recursive: true }, (eventType, changedFile) => {
-                        handleFileChange(eventType, changedFile, fullPath);
-                    });
-                    watchers.push(watcher);
-                    logger.trace('Watcher started for additional path: %s', fullPath);
-                }
-                catch (error) {
-                    logger.warn('Failed to start watcher for %s: %s', fullPath, error);
-                }
+                logger.trace('Failed to start watcher for %s: %s', watchPath, error);
             }
         }
-        logger.debug('File watchers started (%d paths)', watchers.length);
+        logger.debug('File watchers started (%d directories)', watchers.length);
     }
     /**
      * Stop all watchers