@constructive-sdk/cli 0.24.1 → 0.25.1

package/agent/cli/commands/agent.js

@@ -0,0 +1,396 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * CLI commands for Agent
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+const inquirerer_1 = require("inquirerer");
+const executor_1 = require("../executor");
+const utils_1 = require("../utils");
+const fieldSchema = {
+    id: 'uuid',
+    createdAt: 'string',
+    updatedAt: 'string',
+    ownerId: 'uuid',
+    personaId: 'uuid',
+    parentId: 'uuid',
+    name: 'string',
+    systemPrompt: 'string',
+    config: 'json',
+    status: 'string',
+    isEphemeral: 'boolean',
+};
+const usage = '\nagent <command>\n\nCommands:\n  list                  List agent records\n  find-first            Find first matching agent record\n  get                   Get a agent by ID\n  create                Create a new agent\n  update                Update an existing agent\n  delete                Delete a agent\n\nList Options:\n  --limit <n>           Max number of records to return (forward pagination)\n  --last <n>            Number of records from the end (backward pagination)\n  --after <cursor>      Cursor for forward pagination\n  --before <cursor>     Cursor for backward pagination\n  --offset <n>          Number of records to skip\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.name.equalTo foo)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\nFind-First Options:\n  --select <fields>     Comma-separated list of fields to return\n  --where.<field>.<op>  Filter (dot-notation, e.g. --where.status.equalTo active)\n  --condition.<f>.<op>  Condition filter (dot-notation)\n  --orderBy <values>    Comma-separated ordering values (e.g. NAME_ASC,CREATED_AT_DESC)\n\n  --help, -h            Show this help message\n';
+exports.default = async (argv, prompter, _options) => {
+    if (argv.help || argv.h) {
+        console.log(usage);
+        process.exit(0);
+    }
+    const { first: subcommand, newArgv } = (0, inquirerer_1.extractFirst)(argv);
+    if (!subcommand) {
+        const answer = await prompter.prompt(argv, [
+            {
+                type: 'autocomplete',
+                name: 'subcommand',
+                message: 'What do you want to do?',
+                options: ['list', 'find-first', 'get', 'create', 'update', 'delete'],
+            },
+        ]);
+        return handleTableSubcommand(answer.subcommand, newArgv, prompter);
+    }
+    return handleTableSubcommand(subcommand, newArgv, prompter);
+};
+async function handleTableSubcommand(subcommand, argv, prompter) {
+    switch (subcommand) {
+        case 'list':
+            return handleList(argv, prompter);
+        case 'find-first':
+            return handleFindFirst(argv, prompter);
+        case 'get':
+            return handleGet(argv, prompter);
+        case 'create':
+            return handleCreate(argv, prompter);
+        case 'update':
+            return handleUpdate(argv, prompter);
+        case 'delete':
+            return handleDelete(argv, prompter);
+        default:
+            console.log(usage);
+            process.exit(1);
+    }
+}
+async function handleList(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            createdAt: true,
+            updatedAt: true,
+            ownerId: true,
+            personaId: true,
+            parentId: true,
+            name: true,
+            systemPrompt: true,
+            config: true,
+            status: true,
+            isEphemeral: true,
+        };
+        const findManyArgs = (0, utils_1.parseFindManyArgs)(argv, defaultSelect);
+        const client = (0, executor_1.getClient)();
+        const result = await client.agent.findMany(findManyArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to list records.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
+async function handleFindFirst(argv, _prompter) {
+    try {
+        const defaultSelect = {
+            id: true,
+            createdAt: true,
+            updatedAt: true,
+            ownerId: true,
+            personaId: true,
+            parentId: true,
+            name: true,
+            systemPrompt: true,
+            config: true,
+            status: true,
+            isEphemeral: true,
+        };
+        const findFirstArgs = (0, utils_1.parseFindFirstArgs)(argv, defaultSelect);
+        const client = (0, executor_1.getClient)();
+        const result = await client.agent.findFirst(findFirstArgs).execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to find record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
+async function handleGet(argv, prompter) {
+    try {
+        const answers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'id',
+                message: 'id',
+                required: true,
+            },
+        ]);
+        const client = (0, executor_1.getClient)();
+        const result = await client.agent
+            .findOne({
+            id: answers.id,
+            select: {
+                id: true,
+                createdAt: true,
+                updatedAt: true,
+                ownerId: true,
+                personaId: true,
+                parentId: true,
+                name: true,
+                systemPrompt: true,
+                config: true,
+                status: true,
+                isEphemeral: true,
+            },
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Record not found.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
+async function handleCreate(argv, prompter) {
+    try {
+        const rawAnswers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'ownerId',
+                message: 'ownerId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'personaId',
+                message: 'personaId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'parentId',
+                message: 'parentId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'name',
+                message: 'name',
+                required: true,
+            },
+            {
+                type: 'text',
+                name: 'systemPrompt',
+                message: 'systemPrompt',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'json',
+                name: 'config',
+                message: 'config',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'status',
+                message: 'status',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'boolean',
+                name: 'isEphemeral',
+                message: 'isEphemeral',
+                required: false,
+                skipPrompt: true,
+            },
+        ]);
+        const answers = (0, utils_1.coerceAnswers)(rawAnswers, fieldSchema);
+        const cleanedData = (0, utils_1.stripUndefined)(answers, fieldSchema);
+        const client = (0, executor_1.getClient)();
+        const result = await client.agent
+            .create({
+            data: {
+                ownerId: cleanedData.ownerId,
+                personaId: cleanedData.personaId,
+                parentId: cleanedData.parentId,
+                name: cleanedData.name,
+                systemPrompt: cleanedData.systemPrompt,
+                config: cleanedData.config,
+                status: cleanedData.status,
+                isEphemeral: cleanedData.isEphemeral,
+            },
+            select: {
+                id: true,
+                createdAt: true,
+                updatedAt: true,
+                ownerId: true,
+                personaId: true,
+                parentId: true,
+                name: true,
+                systemPrompt: true,
+                config: true,
+                status: true,
+                isEphemeral: true,
+            },
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to create record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
+async function handleUpdate(argv, prompter) {
+    try {
+        const rawAnswers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'id',
+                message: 'id',
+                required: true,
+            },
+            {
+                type: 'text',
+                name: 'ownerId',
+                message: 'ownerId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'personaId',
+                message: 'personaId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'parentId',
+                message: 'parentId',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'name',
+                message: 'name',
+                required: false,
+            },
+            {
+                type: 'text',
+                name: 'systemPrompt',
+                message: 'systemPrompt',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'json',
+                name: 'config',
+                message: 'config',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'text',
+                name: 'status',
+                message: 'status',
+                required: false,
+                skipPrompt: true,
+            },
+            {
+                type: 'boolean',
+                name: 'isEphemeral',
+                message: 'isEphemeral',
+                required: false,
+                skipPrompt: true,
+            },
+        ]);
+        const answers = (0, utils_1.coerceAnswers)(rawAnswers, fieldSchema);
+        const cleanedData = (0, utils_1.stripUndefined)(answers, fieldSchema);
+        const client = (0, executor_1.getClient)();
+        const result = await client.agent
+            .update({
+            where: {
+                id: answers.id,
+            },
+            data: {
+                ownerId: cleanedData.ownerId,
+                personaId: cleanedData.personaId,
+                parentId: cleanedData.parentId,
+                name: cleanedData.name,
+                systemPrompt: cleanedData.systemPrompt,
+                config: cleanedData.config,
+                status: cleanedData.status,
+                isEphemeral: cleanedData.isEphemeral,
+            },
+            select: {
+                id: true,
+                createdAt: true,
+                updatedAt: true,
+                ownerId: true,
+                personaId: true,
+                parentId: true,
+                name: true,
+                systemPrompt: true,
+                config: true,
+                status: true,
+                isEphemeral: true,
+            },
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to update record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}
+async function handleDelete(argv, prompter) {
+    try {
+        const rawAnswers = await prompter.prompt(argv, [
+            {
+                type: 'text',
+                name: 'id',
+                message: 'id',
+                required: true,
+            },
+        ]);
+        const answers = (0, utils_1.coerceAnswers)(rawAnswers, fieldSchema);
+        const client = (0, executor_1.getClient)();
+        const result = await client.agent
+            .delete({
+            where: {
+                id: answers.id,
+            },
+            select: {
+                id: true,
+            },
+        })
+            .execute();
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (error) {
+        console.error('Failed to delete record.');
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        process.exit(1);
+    }
+}

package/agent/cli/commands.js

@@ -0,0 +1,68 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commands = void 0;
+/**
+ * CLI command map and entry point
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+const inquirerer_1 = require("inquirerer");
+const context_1 = __importDefault(require("./commands/context"));
+const auth_1 = __importDefault(require("./commands/auth"));
+const agent_plan_1 = __importDefault(require("./commands/agent-plan"));
+const agent_1 = __importDefault(require("./commands/agent"));
+const agent_thread_1 = __importDefault(require("./commands/agent-thread"));
+const agent_message_1 = __importDefault(require("./commands/agent-message"));
+const agent_task_1 = __importDefault(require("./commands/agent-task"));
+const agent_prompt_1 = __importDefault(require("./commands/agent-prompt"));
+const agent_resource_chunk_1 = __importDefault(require("./commands/agent-resource-chunk"));
+const agent_persona_1 = __importDefault(require("./commands/agent-persona"));
+const agent_resource_1 = __importDefault(require("./commands/agent-resource"));
+const provision_bucket_1 = __importDefault(require("./commands/provision-bucket"));
+const createCommandMap = () => ({
+    context: context_1.default,
+    auth: auth_1.default,
+    'agent-plan': agent_plan_1.default,
+    agent: agent_1.default,
+    'agent-thread': agent_thread_1.default,
+    'agent-message': agent_message_1.default,
+    'agent-task': agent_task_1.default,
+    'agent-prompt': agent_prompt_1.default,
+    'agent-resource-chunk': agent_resource_chunk_1.default,
+    'agent-persona': agent_persona_1.default,
+    'agent-resource': agent_resource_1.default,
+    'provision-bucket': provision_bucket_1.default,
+});
+const usage = '\ncsdk <command>\n\nCommands:\n  context               Manage API contexts\n  auth                  Manage authentication\n  agent-plan           agentPlan CRUD operations\n  agent                agent CRUD operations\n  agent-thread         agentThread CRUD operations\n  agent-message        agentMessage CRUD operations\n  agent-task           agentTask CRUD operations\n  agent-prompt         agentPrompt CRUD operations\n  agent-resource-chunk agentResourceChunk CRUD operations\n  agent-persona        agentPersona CRUD operations\n  agent-resource       agentResource CRUD operations\n  provision-bucket     Provision an S3 bucket for a logical bucket in the database.\nReads the bucket config via RLS, then creates and configures\nthe S3 bucket with the appropriate privacy policies, CORS rules,\nand lifecycle settings.\n\n  --help, -h            Show this help message\n  --version, -v         Show version\n';
+const commands = async (argv, prompter, options) => {
+    if (argv.help || argv.h) {
+        console.log(usage);
+        process.exit(0);
+    }
+    let { first: command, newArgv } = (0, inquirerer_1.extractFirst)(argv);
+    const commandMap = createCommandMap();
+    if (!command) {
+        const answer = await prompter.prompt(argv, [
+            {
+                type: 'autocomplete',
+                name: 'command',
+                message: 'What do you want to do?',
+                options: Object.keys(commandMap),
+            },
+        ]);
+        command = answer.command;
+    }
+    const commandFn = commandMap[command];
+    if (!commandFn) {
+        console.log(usage);
+        console.error(`Unknown command: ${command}`);
+        process.exit(1);
+    }
+    await commandFn(newArgv, prompter, options);
+    prompter.close();
+    return argv;
+};
+exports.commands = commands;

package/agent/cli/embedder.d.ts

@@ -0,0 +1,56 @@
+export type EmbedderFunction = (text: string) => Promise<number[]>;
+export interface EmbedderConfig {
+    /** Provider name: 'ollama' or 'custom' */
+    provider: string;
+    /** Model identifier (e.g. 'nomic-embed-text') */
+    model?: string;
+    /** Base URL for the provider (e.g. 'http://localhost:11434' for Ollama) */
+    baseUrl?: string;
+}
+/**
+ * Resolve an embedder function from environment variables or appstash config.
+ *
+ * Resolution order:
+ *   1. EMBEDDER_PROVIDER env var (+ EMBEDDER_MODEL, EMBEDDER_BASE_URL)
+ *   2. appstash config keys: embedder.provider, embedder.model, embedder.baseUrl
+ *   3. null (no embedder configured)
+ *
+ * @param store - Optional appstash config store for reading persisted config
+ * @returns An EmbedderFunction or null if no embedder is configured
+ */
+export declare function resolveEmbedder(store?: {
+    getVar: (key: string) => string | undefined;
+}): EmbedderFunction | null;
+/**
+ * Auto-embed text values in vector where-clause fields.
+ *
+ * When --auto-embed is passed, any vector field in the where clause that
+ * contains a text string (instead of a float array) will be converted to
+ * an embedding vector using the configured embedder.
+ *
+ * @param where - The where clause object (mutated in place)
+ * @param vectorFieldNames - Names of vector embedding fields (e.g. ['vectorEmbedding'])
+ * @param embedder - The resolved embedder function
+ * @returns The modified where clause
+ */
+export declare function autoEmbedWhere<T extends object>(where: T, vectorFieldNames: string[], embedder: EmbedderFunction): Promise<T>;
+/**
+ * Auto-embed text values in mutation input data (create/update).
+ *
+ * When --auto-embed is passed on create or update, any vector field in
+ * the input data that contains a text string will be converted to an
+ * embedding vector using the configured embedder.
+ *
+ * Usage:
+ *   csdk article create --input.embedding "Machine learning concepts" --auto-embed
+ *   csdk article update --id xxx --input.embedding "Updated description" --auto-embed
+ *
+ * This is a CLI-only convenience — in production, database triggers or
+ * a job queue should handle embedding generation.
+ *
+ * @param data - The mutation input data object (mutated in place)
+ * @param vectorFieldNames - Names of vector embedding fields (e.g. ['embedding'])
+ * @param embedder - The resolved embedder function
+ * @returns The modified data object with text values replaced by vectors
+ */
+export declare function autoEmbedInput<T extends object>(data: T, vectorFieldNames: string[], embedder: EmbedderFunction): Promise<T>;

package/agent/cli/embedder.js

@@ -0,0 +1,136 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveEmbedder = resolveEmbedder;
+exports.autoEmbedWhere = autoEmbedWhere;
+exports.autoEmbedInput = autoEmbedInput;
+/**
+ * CLI embedder — pluggable text-to-vector embedding for search commands
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+const ollama_1 = __importDefault(require("@agentic-kit/ollama"));
+// ─── Built-in Ollama Provider ────────────────────────────────────────────────
+function createOllamaEmbedder(baseUrl = 'http://localhost:11434', model = 'nomic-embed-text') {
+    const client = new ollama_1.default(baseUrl);
+    return async (text) => {
+        const result = await client.generateEmbedding(text, model);
+        return result.embedding;
+    };
+}
+// ─── Embedder Resolution ─────────────────────────────────────────────────────
+/**
+ * Resolve an embedder function from environment variables or appstash config.
+ *
+ * Resolution order:
+ *   1. EMBEDDER_PROVIDER env var (+ EMBEDDER_MODEL, EMBEDDER_BASE_URL)
+ *   2. appstash config keys: embedder.provider, embedder.model, embedder.baseUrl
+ *   3. null (no embedder configured)
+ *
+ * @param store - Optional appstash config store for reading persisted config
+ * @returns An EmbedderFunction or null if no embedder is configured
+ */
+function resolveEmbedder(store) {
+    // 1. Check environment variables first
+    const envProvider = process.env.EMBEDDER_PROVIDER;
+    if (envProvider) {
+        return buildEmbedder({
+            provider: envProvider,
+            model: process.env.EMBEDDER_MODEL,
+            baseUrl: process.env.EMBEDDER_BASE_URL,
+        });
+    }
+    // 2. Check appstash config
+    if (store) {
+        const configProvider = store.getVar('embedder.provider');
+        if (configProvider) {
+            return buildEmbedder({
+                provider: configProvider,
+                model: store.getVar('embedder.model'),
+                baseUrl: store.getVar('embedder.baseUrl'),
+            });
+        }
+    }
+    // 3. No embedder configured
+    return null;
+}
+/**
+ * Build an embedder function from a config object.
+ */
+function buildEmbedder(config) {
+    switch (config.provider) {
+        case 'ollama':
+            return createOllamaEmbedder(config.baseUrl, config.model);
+        default:
+            console.error(`Unknown embedder provider: '${config.provider}'. Supported: ollama`);
+            return null;
+    }
+}
+/**
+ * Auto-embed text values in vector where-clause fields.
+ *
+ * When --auto-embed is passed, any vector field in the where clause that
+ * contains a text string (instead of a float array) will be converted to
+ * an embedding vector using the configured embedder.
+ *
+ * @param where - The where clause object (mutated in place)
+ * @param vectorFieldNames - Names of vector embedding fields (e.g. ['vectorEmbedding'])
+ * @param embedder - The resolved embedder function
+ * @returns The modified where clause
+ */
+async function autoEmbedWhere(where, vectorFieldNames, embedder) {
+    const rec = where;
+    for (const fieldName of vectorFieldNames) {
+        const fieldValue = rec[fieldName];
+        if (fieldValue && typeof fieldValue === 'object') {
+            const input = fieldValue;
+            // If 'vector' is a string, embed it
+            if (typeof input.vector === 'string') {
+                const text = input.vector;
+                const embedding = await embedder(text);
+                input.vector = embedding;
+            }
+        }
+        else if (typeof fieldValue === 'string') {
+            // Shorthand: --where.vectorEmbedding "text" with --auto-embed
+            // becomes { vector: [embedded], metric: 'COSINE' }
+            const embedding = await embedder(fieldValue);
+            rec[fieldName] = { vector: embedding };
+        }
+    }
+    return where;
+}
+/**
+ * Auto-embed text values in mutation input data (create/update).
+ *
+ * When --auto-embed is passed on create or update, any vector field in
+ * the input data that contains a text string will be converted to an
+ * embedding vector using the configured embedder.
+ *
+ * Usage:
+ *   csdk article create --input.embedding "Machine learning concepts" --auto-embed
+ *   csdk article update --id xxx --input.embedding "Updated description" --auto-embed
+ *
+ * This is a CLI-only convenience — in production, database triggers or
+ * a job queue should handle embedding generation.
+ *
+ * @param data - The mutation input data object (mutated in place)
+ * @param vectorFieldNames - Names of vector embedding fields (e.g. ['embedding'])
+ * @param embedder - The resolved embedder function
+ * @returns The modified data object with text values replaced by vectors
+ */
+async function autoEmbedInput(data, vectorFieldNames, embedder) {
+    const rec = data;
+    for (const fieldName of vectorFieldNames) {
+        const fieldValue = rec[fieldName];
+        if (typeof fieldValue === 'string') {
+            // Text string → embed to vector array
+            const embedding = await embedder(fieldValue);
+            rec[fieldName] = embedding;
+        }
+        // If it's already an array (pre-computed vector), leave it as-is
+    }
+    return data;
+}

package/agent/cli/executor.d.ts

@@ -0,0 +1,19 @@
+export declare const getStore: () => import("appstash").ConfigStore;
+export declare function getClient(contextName?: string): {
+    agentPlan: import("../orm").AgentPlanModel;
+    agent: import("../orm").AgentModel;
+    agentThread: import("../orm").AgentThreadModel;
+    agentMessage: import("../orm").AgentMessageModel;
+    agentTask: import("../orm").AgentTaskModel;
+    agentPrompt: import("../orm").AgentPromptModel;
+    agentResourceChunk: import("../orm").AgentResourceChunkModel;
+    agentPersona: import("../orm").AgentPersonaModel;
+    agentResource: import("../orm").AgentResourceModel;
+    mutation: {
+        provisionBucket: <S extends import("../orm/input-types").ProvisionBucketPayloadSelect>(args: import("../orm/mutation").ProvisionBucketVariables, options: {
+            select: S;
+        } & import("../orm").StrictSelect<S, import("../orm/input-types").ProvisionBucketPayloadSelect>) => import("../orm").QueryBuilder<{
+            provisionBucket: import("../orm").InferSelectResult<import("../orm/input-types").ProvisionBucketPayload, S> | null;
+        }>;
+    };
+};