@liquidmetal-ai/raindrop 0.4.1 → 0.4.2

package/dist/commands/annotation/get.js

@@ -0,0 +1,142 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { parseMRN } from '@liquidmetal-ai/drizzle/mrn';
+import { create } from '@bufbuild/protobuf';
+import { GetAnnotationRequestSchema, AnnotationLocatorSchema } from '@liquidmetal-ai/protogen2/annotation_pb';
+import { valueOf } from '@liquidmetal-ai/drizzle/appify/build';
+export default class AnnotationGet extends BaseCommand {
+    static args = {
+        mrn: Args.string({
+            description: 'MRN (Machine Resource Name) of the annotation to retrieve. Can be partial (e.g., my-module:my-key:) or full (e.g., annotation:app:v1:my-module:my-key:)',
+            required: true,
+        }),
+    };
+    static description = 'Get an annotation by MRN';
+    static examples = [
+        `<%= config.bin %> annotation get my-module:my-item^my-key:
+Get annotation by partial MRN (prefilled with app/version from manifest and config)
+`,
+        `<%= config.bin %> annotation get annotation:my-app:v1.0.0:my-module:my-item^my-key:
+Get annotation with the full MRN
+`,
+        `<%= config.bin %> annotation get my-module:my-key: --format json
+Get annotation by partial MRN and output as JSON
+`,
+    ];
+    static flags = {
+        ...BaseCommand.HIDDEN_FLAGS,
+        format: Flags.string({
+            char: 'f',
+            description: 'output format',
+            default: 'text',
+            options: ['text', 'json'],
+        }),
+        impersonate: Flags.string({
+            char: 'i',
+            description: 'impersonate organization',
+            required: false,
+            hidden: true,
+        }),
+        manifest: Flags.string({
+            char: 'M',
+            description: 'project manifest',
+            required: false,
+            default: 'raindrop.manifest',
+            hidden: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AnnotationGet);
+        // Determine if we need to prefill MRN with manifest/config data
+        let fullMrn = args.mrn;
+        let mrnParts;
+        if (!args.mrn.startsWith('annotation:') && !args.mrn.startsWith('label:')) {
+            // Partial MRN - need to prefill with app name and version from manifest/config
+            const apps = await this.loadManifest();
+            const config = await this.loadConfig();
+            if (apps.length === 0) {
+                this.error('No applications found in manifest');
+            }
+            const app = apps[0];
+            const appName = valueOf(app.name);
+            const versionId = config.versionId;
+            console.log(`Using application: ${appName}, version: ${versionId}`);
+            if (!appName) {
+                this.error('Application name not found in manifest');
+            }
+            if (!versionId) {
+                this.error('Version ID not found in config. Run a build or deployment first to set the version.');
+            }
+            fullMrn = `annotation:${appName}:${versionId}:${args.mrn}`;
+        }
+        // Auto-fill trailing colons if there are fewer than 6 parts in the MRN
+        const parts = fullMrn.split(':');
+        // A complete annotation MRN has 6 parts (annotation:app:version:module:item:revision)
+        if (parts.length < 6) {
+            // Add as many colons as needed to get to 6 parts
+            const colonsToAdd = 6 - parts.length;
+            fullMrn += ':'.repeat(colonsToAdd);
+        }
+        // Parse MRN to extract components using the common library
+        try {
+            mrnParts = parseMRN(fullMrn);
+        }
+        catch (error) {
+            this.error(`Invalid MRN format: ${error}`);
+        }
+        // Get annotation service client
+        const { client: annotationServiceClient, userId, organizationId, } = await this.annotationService(mrnParts.applicationName, mrnParts.versionId);
+        try {
+            // Create annotation locator from MRN parts
+            const locator = create(AnnotationLocatorSchema, {
+                applicationName: mrnParts.applicationName,
+                applicationVersionId: mrnParts.versionId,
+                moduleName: mrnParts.module,
+                item: mrnParts.item,
+                key: mrnParts.key,
+                revision: mrnParts.revision,
+            });
+            // Call the annotation service
+            const request = create(GetAnnotationRequestSchema, {
+                userId,
+                organizationId,
+                locator,
+            });
+            const response = await annotationServiceClient.getAnnotation(request);
+            switch (flags.format) {
+                case 'json':
+                    console.log(JSON.stringify({
+                        mrn: fullMrn,
+                        inputMrn: args.mrn,
+                        ...mrnParts,
+                        annotation: response.annotation?.annotation || '',
+                        location: response.annotation?.location,
+                    }, null, 2));
+                    break;
+                case 'text':
+                    console.log(`MRN: ${fullMrn}`);
+                    if (fullMrn !== args.mrn) {
+                        console.log(`Input: ${args.mrn} (prefilled with app/version)`);
+                    }
+                    console.log(`Type: ${mrnParts.type}`);
+                    console.log(`Application: ${mrnParts.applicationName}`);
+                    console.log(`Version: ${mrnParts.versionId}`);
+                    if (mrnParts.module)
+                        console.log(`Module: ${mrnParts.module}`);
+                    if (mrnParts.item)
+                        console.log(`Item: ${mrnParts.item}`);
+                    if (mrnParts.key)
+                        console.log(`Key: ${mrnParts.key}`);
+                    if (mrnParts.revision)
+                        console.log(`Revision: ${mrnParts.revision}`);
+                    console.log('');
+                    console.log('Annotation:');
+                    console.log(response.annotation?.annotation || '(no content)');
+                    break;
+            }
+        }
+        catch (error) {
+            this.error(`Failed to get annotation: ${error}`);
+        }
+    }
+}

package/dist/commands/annotation/list.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from '../../base-command.js';
+export default class AnnotationList extends BaseCommand<typeof AnnotationList> {
+    static args: {
+        mrnPrefix: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        impersonate: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        manifest: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthService: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        raindropCatalogService: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthToken: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowOrganizationId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowUserId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sendVersionMetadata: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/annotation/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/annotation/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOpD,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,WAAW,CAAC,OAAO,cAAc,CAAC;IAC5E,MAAM,CAAC,IAAI;;MAMT;IAEF,MAAM,CAAC,WAAW,SAAoC;IAEtD,MAAM,CAAC,QAAQ,WAUb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;;;MA0BV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA+L3B"}

package/dist/commands/annotation/list.js

@@ -0,0 +1,223 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { parseMRN } from '@liquidmetal-ai/drizzle/mrn';
+import { create } from '@bufbuild/protobuf';
+import { ListAnnotationsRequestSchema, AnnotationLocatorSchema } from '@liquidmetal-ai/protogen2/annotation_pb';
+import { valueOf } from '@liquidmetal-ai/drizzle/appify/build';
+export default class AnnotationList extends BaseCommand {
+    static args = {
+        mrnPrefix: Args.string({
+            description: 'MRN prefix to filter annotations (e.g., my-module or annotation:app:v1:my-module). If not provided, uses app/version from manifest and config.',
+            required: false,
+        }),
+    };
+    static description = 'List annotations by MRN prefix';
+    static examples = [
+        `<%= config.bin %> annotation list
+List all annotations for the current app/version from manifest and config
+`,
+        `<%= config.bin %> annotation list my-module
+List annotations for 'my-module' (prefilled with app/version from manifest and config)
+`,
+        `<%= config.bin %> annotation list annotation:my-app:v1.0.0:my-module --format json
+List annotations for a specific module using full MRN prefix in JSON format
+`,
+    ];
+    static flags = {
+        ...BaseCommand.HIDDEN_FLAGS,
+        output: Flags.string({
+            char: 'o',
+            description: 'output format',
+            default: 'table',
+            options: ['table', 'text', 'json'],
+        }),
+        limit: Flags.integer({
+            char: 'l',
+            description: 'maximum number of annotations to return',
+            default: 100,
+        }),
+        impersonate: Flags.string({
+            char: 'i',
+            description: 'impersonate organization',
+            required: false,
+            hidden: true,
+        }),
+        manifest: Flags.string({
+            char: 'M',
+            description: 'project manifest',
+            required: false,
+            default: 'raindrop.manifest',
+            hidden: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AnnotationList);
+        // Parse MRN prefix if provided to extract application info for service connection
+        let appName = '';
+        let versionId = '';
+        let mrnParts = {};
+        let fullMrnPrefix = args.mrnPrefix || '';
+        if (args.mrnPrefix) {
+            // Check if we need to prefill with manifest/config data
+            if (!args.mrnPrefix.startsWith('annotation:') && !args.mrnPrefix.startsWith('label:')) {
+                // Partial MRN - need to prefill with app name and version from manifest/config
+                const apps = await this.loadManifest();
+                const config = await this.loadConfig();
+                if (apps.length === 0) {
+                    this.error('No applications found in manifest');
+                }
+                const app = apps[0];
+                const manifestAppName = valueOf(app.name);
+                const configVersionId = config.versionId;
+                if (!manifestAppName) {
+                    this.error('Application name not found in manifest');
+                }
+                if (!configVersionId) {
+                    this.error('Version ID not found in config. Run a build or deployment first to set the version.');
+                }
+                fullMrnPrefix = `annotation:${manifestAppName}:${configVersionId}:${args.mrnPrefix}`;
+            }
+            try {
+                // Try to parse as full MRN first
+                mrnParts = parseMRN(fullMrnPrefix);
+                appName = mrnParts.applicationName;
+                versionId = mrnParts.versionId;
+            }
+            catch {
+                // If it fails, try to extract at least app:version from prefix
+                const parts = fullMrnPrefix.split(':');
+                if (parts.length >= 3 && parts[0] === 'annotation') {
+                    appName = parts[1];
+                    versionId = parts[2];
+                    mrnParts = {
+                        type: parts[0],
+                        applicationName: parts[1],
+                        versionId: parts[2],
+                        module: parts[3] || undefined,
+                        key: parts[4] || undefined,
+                        revision: parts[5] || undefined,
+                    };
+                }
+                else {
+                    this.error('MRN prefix must at least contain annotation:applicationName:versionId');
+                }
+            }
+        }
+        else {
+            // No MRN prefix provided - use manifest/config data to create default prefix
+            const apps = await this.loadManifest();
+            const config = await this.loadConfig();
+            if (apps.length === 0) {
+                this.error('No applications found in manifest');
+            }
+            const app = apps[0];
+            const manifestAppName = valueOf(app.name);
+            const configVersionId = config.versionId;
+            if (!manifestAppName) {
+                this.error('Application name not found in manifest');
+            }
+            if (!configVersionId) {
+                this.error('Version ID not found in config. Run a build or deployment first to set the version.');
+            }
+            appName = manifestAppName;
+            versionId = configVersionId;
+            fullMrnPrefix = `annotation:${manifestAppName}:${configVersionId}`;
+            mrnParts = {
+                type: 'annotation',
+                applicationName: manifestAppName,
+                versionId: configVersionId,
+            };
+        }
+        // Get annotation service client
+        const { client: annotationServiceClient, userId, organizationId, } = await this.annotationService(appName, versionId);
+        try {
+            // Create annotation locator from MRN parts
+            const locator = create(AnnotationLocatorSchema, {
+                applicationName: mrnParts.applicationName,
+                applicationVersionId: mrnParts.versionId,
+                moduleName: mrnParts.module,
+                item: mrnParts.item,
+                key: mrnParts.key,
+                revision: mrnParts.revision,
+            });
+            // Call the annotation service
+            const request = create(ListAnnotationsRequestSchema, {
+                userId,
+                organizationId,
+                locator,
+            });
+            const response = await annotationServiceClient.listAnnotations(request);
+            const annotations = response.annotation || [];
+            switch (flags.output) {
+                case 'json':
+                    console.log(JSON.stringify({
+                        annotations: annotations.map((loc) => ({
+                            applicationName: loc.applicationName,
+                            applicationVersionId: loc.applicationVersionId,
+                            moduleName: loc.moduleName,
+                            item: loc.item,
+                            key: loc.key,
+                            revision: loc.revision,
+                        })),
+                        total: annotations.length,
+                        prefix: fullMrnPrefix,
+                        inputPrefix: args.mrnPrefix,
+                    }, null, 2));
+                    break;
+                case 'text':
+                    console.log(`Found ${annotations.length} annotations`);
+                    console.log(`Prefix: ${fullMrnPrefix}`);
+                    if (fullMrnPrefix !== (args.mrnPrefix || '')) {
+                        console.log(`Input: ${args.mrnPrefix || '(none)'} (prefilled with app/version)`);
+                    }
+                    console.log('');
+                    annotations.forEach((loc, index) => {
+                        const mrn = `${loc.applicationName}:${loc.applicationVersionId}:${loc.moduleName || ''}:${loc.item || ''}^${loc.key || ''}:${loc.revision || ''}`;
+                        console.log(`${index + 1}. ${mrn}`);
+                        console.log(`   Application: ${loc.applicationName}`);
+                        console.log(`   Version: ${loc.applicationVersionId}`);
+                        if (loc.moduleName)
+                            console.log(`   Module: ${loc.moduleName}`);
+                        if (loc.item)
+                            console.log(`   Item: ${loc.item}`);
+                        if (loc.key)
+                            console.log(`   Key: ${loc.key}`);
+                        if (loc.revision)
+                            console.log(`   Revision: ${loc.revision}`);
+                        console.log('');
+                    });
+                    break;
+                case 'table':
+                    if (annotations.length === 0) {
+                        console.log('No annotations found');
+                        console.log(`Prefix: ${fullMrnPrefix}`);
+                        if (fullMrnPrefix !== (args.mrnPrefix || '')) {
+                            console.log(`Input: ${args.mrnPrefix || '(none)'} (prefilled with app/version)`);
+                        }
+                    }
+                    else {
+                        console.log('Application     Version         Module          Item            Key             Revision');
+                        console.log('--------------- --------------- --------------- --------------- --------------- ---------------');
+                        annotations.forEach((loc) => {
+                            const app = (loc.applicationName || '').padEnd(15).substring(0, 15);
+                            const version = (loc.applicationVersionId || '').padEnd(15).substring(0, 15);
+                            const module = (loc.moduleName || '').padEnd(15).substring(0, 15);
+                            const item = (loc.item || '').padEnd(15).substring(0, 15);
+                            const key = (loc.key || '').padEnd(15).substring(0, 15);
+                            const revision = (loc.revision || '').padEnd(15).substring(0, 15);
+                            console.log(`${app} ${version} ${module} ${item} ${key} ${revision}`);
+                        });
+                        console.log(`\nTotal: ${annotations.length} annotations`);
+                        console.log(`Prefix: ${fullMrnPrefix}`);
+                        if (fullMrnPrefix !== (args.mrnPrefix || '')) {
+                            console.log(`Input: ${args.mrnPrefix || '(none)'} (prefilled with app/version)`);
+                        }
+                    }
+                    break;
+            }
+        }
+        catch (error) {
+            this.error(`Failed to list annotations: ${error}`);
+        }
+    }
+}

package/dist/commands/annotation/put.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from '../../base-command.js';
+export default class AnnotationPut extends BaseCommand<typeof AnnotationPut> {
+    static args: {
+        mrn: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        annotation: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        impersonate: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        manifest: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthService: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        raindropCatalogService: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowAuthToken: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowOrganizationId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        rainbowUserId: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        sendVersionMetadata: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=put.d.ts.map

package/dist/commands/annotation/put.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"put.d.ts","sourceRoot":"","sources":["../../../src/commands/annotation/put.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOpD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW,CAAC,OAAO,aAAa,CAAC;IAC1E,MAAM,CAAC,IAAI;;;MAUT;IAEF,MAAM,CAAC,WAAW,SAA2C;IAE7D,MAAM,CAAC,QAAQ,WAUb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;;MAqBV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAyI3B"}

package/dist/commands/annotation/put.js

@@ -0,0 +1,172 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { parseMRN } from '@liquidmetal-ai/drizzle/mrn';
+import { create } from '@bufbuild/protobuf';
+import { PutAnnotationRequestSchema, AnnotationLocatorSchema } from '@liquidmetal-ai/protogen2/annotation_pb';
+import * as fs from 'node:fs/promises';
+import { valueOf } from '@liquidmetal-ai/drizzle/appify/build';
+export default class AnnotationPut extends BaseCommand {
+    static args = {
+        mrn: Args.string({
+            description: 'MRN (Machine Resource Name) of the annotation to create/update. Can be partial (e.g., my-module:my-key:) or full (e.g., annotation:app:v1:my-module:my-key:)',
+            required: true,
+        }),
+        annotation: Args.string({
+            description: 'annotation content (use "-" to read from stdin)',
+            required: true,
+        }),
+    };
+    static description = 'Create or update an annotation by MRN';
+    static examples = [
+        `<%= config.bin %> annotation put my-module:my-key: "This is my annotation"
+Create an annotation with partial MRN (prefilled with app/version from manifest and config)
+`,
+        `<%= config.bin %> annotation put annotation:my-app:v1.0.0:my-module:my-item^my-key: @file.txt
+Create an annotation from file contents using full MRN
+`,
+        `<%= config.bin %> annotation put my-module:my-key: - < input.txt
+Create an annotation from stdin using partial MRN
+`,
+    ];
+    static flags = {
+        ...BaseCommand.HIDDEN_FLAGS,
+        output: Flags.string({
+            char: 'o',
+            description: 'output format',
+            default: 'text',
+            options: ['text', 'json'],
+        }),
+        impersonate: Flags.string({
+            char: 'i',
+            description: 'impersonate organization',
+            required: false,
+            hidden: true,
+        }),
+        manifest: Flags.string({
+            char: 'M',
+            description: 'project manifest',
+            required: false,
+            default: 'raindrop.manifest',
+            hidden: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AnnotationPut);
+        // Determine if we need to prefill MRN with manifest/config data
+        let fullMrn = args.mrn;
+        let mrnParts;
+        if (!args.mrn.startsWith('annotation:') && !args.mrn.startsWith('label:')) {
+            // Partial MRN - need to prefill with app name and version from manifest/config
+            const apps = await this.loadManifest();
+            const config = await this.loadConfig();
+            if (apps.length === 0) {
+                this.error('No applications found in manifest');
+            }
+            const app = apps[0];
+            const appName = valueOf(app.name);
+            const versionId = config.versionId;
+            if (!appName) {
+                this.error('Application name not found in manifest');
+            }
+            if (!versionId) {
+                this.error('Version ID not found in config. Run a build or deployment first to set the version.');
+            }
+            fullMrn = `annotation:${appName}:${versionId}:${args.mrn}`;
+        }
+        // Auto-fill trailing colons if there are fewer than 6 parts in the MRN
+        const parts = fullMrn.split(':');
+        // A complete annotation MRN has 6 parts (annotation:app:version:module:item:revision)
+        if (parts.length < 6) {
+            // Add as many colons as needed to get to 6 parts
+            const colonsToAdd = 6 - parts.length;
+            fullMrn += ':'.repeat(colonsToAdd);
+        }
+        // Parse MRN to extract components using the common library
+        try {
+            mrnParts = parseMRN(fullMrn);
+        }
+        catch (error) {
+            this.error(`Invalid MRN format: ${error}`);
+        }
+        // Handle different input sources
+        let annotationContent;
+        if (args.annotation === '-') {
+            // Read from stdin
+            const chunks = [];
+            for await (const chunk of process.stdin) {
+                chunks.push(chunk);
+            }
+            annotationContent = Buffer.concat(chunks).toString('utf8').trim();
+        }
+        else if (args.annotation.startsWith('@')) {
+            // Read from file
+            const filePath = args.annotation.slice(1);
+            try {
+                annotationContent = await fs.readFile(filePath, 'utf8');
+            }
+            catch (error) {
+                this.error(`Failed to read file "${filePath}": ${error}`);
+            }
+        }
+        else {
+            // Use as literal content
+            annotationContent = args.annotation;
+        }
+        if (!annotationContent.trim()) {
+            this.error('Annotation content cannot be empty');
+        }
+        // Get annotation service client
+        const { client: annotationServiceClient, userId, organizationId, } = await this.annotationService(mrnParts.applicationName, mrnParts.versionId);
+        try {
+            // Create annotation locator from MRN parts
+            const locator = create(AnnotationLocatorSchema, {
+                applicationName: mrnParts.applicationName,
+                applicationVersionId: mrnParts.versionId,
+                moduleName: mrnParts.module,
+                item: mrnParts.item,
+                key: mrnParts.key,
+                revision: mrnParts.revision,
+            });
+            // Call the annotation service
+            const request = create(PutAnnotationRequestSchema, {
+                userId,
+                organizationId,
+                locator,
+                annotation: annotationContent,
+            });
+            const response = await annotationServiceClient.putAnnotation(request);
+            switch (flags.output) {
+                case 'json':
+                    console.log(JSON.stringify({
+                        mrn: fullMrn,
+                        inputMrn: args.mrn,
+                        ...mrnParts,
+                        annotation: annotationContent,
+                        locator: response.locator,
+                        success: true,
+                    }, null, 2));
+                    break;
+                case 'text':
+                    console.log(`Successfully created/updated annotation for MRN: ${fullMrn}`);
+                    if (fullMrn !== args.mrn) {
+                        console.log(`Input: ${args.mrn} (prefilled with app/version)`);
+                    }
+                    console.log(`Content length: ${annotationContent.length} characters`);
+                    console.log(`Type: ${mrnParts.type}`);
+                    console.log(`Application: ${mrnParts.applicationName}`);
+                    console.log(`Version: ${mrnParts.versionId}`);
+                    if (mrnParts.module)
+                        console.log(`Module: ${mrnParts.module}`);
+                    if (mrnParts.item)
+                        console.log(`Item: ${mrnParts.item}`);
+                    if (mrnParts.key)
+                        console.log(`Key: ${mrnParts.key}`);
+                    console.log('\nAnnotation saved successfully!');
+                    break;
+            }
+        }
+        catch (error) {
+            this.error(`Failed to save annotation: ${error}`);
+        }
+    }
+}

package/dist/index.d.ts

@@ -7,6 +7,7 @@ import { RainbowAuthService } from '@liquidmetal-ai/drizzle/liquidmetal/v1alpha1
 import { type RaindropState } from '@liquidmetal-ai/drizzle/liquidmetal/v1alpha1/raindrop_pb';
 import { SearchAgentService } from '@liquidmetal-ai/drizzle/liquidmetal/v1alpha1/search_agent_pb';
 import { StrictClient } from './strict-client.js';
+import { AnnotationService } from '@liquidmetal-ai/protogen2/annotation_pb';
 export { run } from '@oclif/core';
 export declare const EPOCH_TS: import("@bufbuild/protobuf/wkt").Timestamp;
 export declare function configFromAppFile(appFile: string): Promise<Application[]>;
@@ -35,6 +36,7 @@ export declare function rainbowAuthService(baseUrl: string): Promise<{
 export declare function catalogService(opts: ServiceClientOptions): Promise<ServiceClient<typeof CatalogService>>;
 export declare function searchAgentService(opts: ServiceClientOptions): Promise<ServiceClient<typeof SearchAgentService>>;
 export declare function objectService(opts: ServiceClientOptions): Promise<ServiceClient<typeof ObjectService>>;
+export declare function annotationService(opts: ServiceClientOptions): Promise<ServiceClient<typeof AnnotationService>>;
 export type ServiceClientOptions = {
     rainbowAuth: StrictClient<typeof RainbowAuthService>;
     configDir: string;

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -16,6 +16,7 @@ import { fileURLToPath } from 'node:url';
 import semver from 'semver';
 import { createStrictClient } from './strict-client.js';
 import { traceStore } from './trace.js';
+import { AnnotationService } from '@liquidmetal-ai/protogen2/annotation_pb';
 export { run } from '@oclif/core';
 export const EPOCH_TS = timestampFromDate(new Date(0));
 export async function configFromAppFile(appFile) {
@@ -190,6 +191,9 @@ export async function searchAgentService(opts) {
 export async function objectService(opts) {
     return serviceClient(ObjectService, opts);
 }
+export async function annotationService(opts) {
+    return serviceClient(AnnotationService, opts);
+}
 export async function serviceClient(service, { rainbowAuth, configDir, identity, overrideAuthToken, logger, enableSendVersion }) {
     const { baseUrl, organizationId, userId } = identity;
     const { authenticate } = createAuthenticateInterceptor(configDir, rainbowAuth, overrideAuthToken);

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/base-command.ts","../src/build.test.ts","../src/build.ts","../src/codegen.test.ts","../src/codegen.ts","../src/config.test.ts","../src/config.ts","../src/deploy.ts","../src/index.test.ts","../src/index.ts","../src/strict-client.ts","../src/trace.ts","../src/commands/tail.ts","../src/commands/auth/list.ts","../src/commands/auth/login.ts","../src/commands/auth/logout.ts","../src/commands/auth/select.ts","../src/commands/build/branch.ts","../src/commands/build/checkout.ts","../src/commands/build/clone.ts","../src/commands/build/delete.ts","../src/commands/build/deploy.ts","../src/commands/build/find.ts","../src/commands/build/generate.ts","../src/commands/build/init.ts","../src/commands/build/list.ts","../src/commands/build/sandbox.ts","../src/commands/build/start.ts","../src/commands/build/status.ts","../src/commands/build/stop.ts","../src/commands/build/unsandbox.ts","../src/commands/build/upload.ts","../src/commands/build/validate.ts","../src/commands/build/env/get.ts","../src/commands/build/env/set.ts","../src/commands/build/tools/check.ts","../src/commands/build/tools/fmt.ts","../src/commands/object/delete.ts","../src/commands/object/get.ts","../src/commands/object/list.ts","../src/commands/object/put.ts","../src/commands/query/chunk-search.ts","../src/commands/query/document.ts","../src/commands/query/search.ts"],"version":"5.8.2"}
+{"root":["../src/base-command.ts","../src/build.test.ts","../src/build.ts","../src/codegen.test.ts","../src/codegen.ts","../src/config.test.ts","../src/config.ts","../src/deploy.ts","../src/index.test.ts","../src/index.ts","../src/strict-client.ts","../src/trace.ts","../src/commands/tail.ts","../src/commands/annotation/get.ts","../src/commands/annotation/list.ts","../src/commands/annotation/put.ts","../src/commands/auth/list.ts","../src/commands/auth/login.ts","../src/commands/auth/logout.ts","../src/commands/auth/select.ts","../src/commands/build/branch.ts","../src/commands/build/checkout.ts","../src/commands/build/clone.ts","../src/commands/build/delete.ts","../src/commands/build/deploy.ts","../src/commands/build/find.ts","../src/commands/build/generate.ts","../src/commands/build/init.ts","../src/commands/build/list.ts","../src/commands/build/sandbox.ts","../src/commands/build/start.ts","../src/commands/build/status.ts","../src/commands/build/stop.ts","../src/commands/build/unsandbox.ts","../src/commands/build/upload.ts","../src/commands/build/validate.ts","../src/commands/build/env/get.ts","../src/commands/build/env/set.ts","../src/commands/build/tools/check.ts","../src/commands/build/tools/fmt.ts","../src/commands/object/delete.ts","../src/commands/object/get.ts","../src/commands/object/list.ts","../src/commands/object/put.ts","../src/commands/query/chunk-search.ts","../src/commands/query/document.ts","../src/commands/query/search.ts"],"version":"5.8.2"}