@liquidmetal-ai/raindrop 0.4.0 → 0.4.2

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @liquidmetal-ai/raindrop
 $ raindrop COMMAND
 running command...
 $ raindrop (--version)
-@liquidmetal-ai/raindrop/0.4.0 darwin-arm64 node-v23.10.0
+@liquidmetal-ai/raindrop/0.4.2 darwin-arm64 node-v23.10.0
 $ raindrop --help [COMMAND]
 USAGE
   $ raindrop COMMAND
@@ -31,6 +31,9 @@ USAGE
 # Commands
 
 <!-- commands -->
+* [`raindrop annotation get MRN`](#raindrop-annotation-get-mrn)
+* [`raindrop annotation list [MRNPREFIX]`](#raindrop-annotation-list-mrnprefix)
+* [`raindrop annotation put MRN ANNOTATION`](#raindrop-annotation-put-mrn-annotation)
 * [`raindrop auth list`](#raindrop-auth-list)
 * [`raindrop auth login`](#raindrop-auth-login)
 * [`raindrop auth logout`](#raindrop-auth-logout)
@@ -71,9 +74,108 @@ USAGE
 * [`raindrop plugins unlink [PLUGIN]`](#raindrop-plugins-unlink-plugin)
 * [`raindrop plugins update`](#raindrop-plugins-update)
 * [`raindrop query chunk-search QUERY`](#raindrop-query-chunk-search-query)
+* [`raindrop query document QUERY`](#raindrop-query-document-query)
 * [`raindrop query search [QUERY]`](#raindrop-query-search-query)
 * [`raindrop tail`](#raindrop-tail)
 
+## `raindrop annotation get MRN`
+
+Get an annotation by MRN
+
+```
+USAGE
+  $ raindrop annotation get MRN [-f text|json]
+
+ARGUMENTS
+  MRN  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:)
+
+FLAGS
+  -f, --format=<option>  [default: text] output format
+                         <options: text|json>
+
+DESCRIPTION
+  Get an annotation by MRN
+
+EXAMPLES
+  $ raindrop annotation get my-module:my-item^my-key:
+  Get annotation by partial MRN (prefilled with app/version from manifest and config)
+
+  $ raindrop annotation get annotation:my-app:v1.0.0:my-module:my-item^my-key:
+  Get annotation with the full MRN
+
+  $ raindrop annotation get my-module:my-key: --format json
+  Get annotation by partial MRN and output as JSON
+```
+
+_See code: [src/commands/annotation/get.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/annotation/get.ts)_
+
+## `raindrop annotation list [MRNPREFIX]`
+
+List annotations by MRN prefix
+
+```
+USAGE
+  $ raindrop annotation list [MRNPREFIX] [-o table|text|json] [-l <value>]
+
+ARGUMENTS
+  MRNPREFIX  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.
+
+FLAGS
+  -l, --limit=<value>    [default: 100] maximum number of annotations to return
+  -o, --output=<option>  [default: table] output format
+                         <options: table|text|json>
+
+DESCRIPTION
+  List annotations by MRN prefix
+
+EXAMPLES
+  $ raindrop annotation list
+  List all annotations for the current app/version from manifest and config
+
+  $ raindrop annotation list my-module
+  List annotations for 'my-module' (prefilled with app/version from manifest and config)
+
+  $ raindrop 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
+```
+
+_See code: [src/commands/annotation/list.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/annotation/list.ts)_
+
+## `raindrop annotation put MRN ANNOTATION`
+
+Create or update an annotation by MRN
+
+```
+USAGE
+  $ raindrop annotation put MRN ANNOTATION [-o text|json]
+
+ARGUMENTS
+  MRN         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:)
+  ANNOTATION  annotation content (use "-" to read from stdin)
+
+FLAGS
+  -o, --output=<option>  [default: text] output format
+                         <options: text|json>
+
+DESCRIPTION
+  Create or update an annotation by MRN
+
+EXAMPLES
+  $ raindrop annotation put my-module:my-key: "This is my annotation"
+  Create an annotation with partial MRN (prefilled with app/version from manifest and config)
+
+  $ raindrop 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
+
+  $ raindrop annotation put my-module:my-key: - < input.txt
+  Create an annotation from stdin using partial MRN
+```
+
+_See code: [src/commands/annotation/put.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/annotation/put.ts)_
+
 ## `raindrop auth list`
 
 List authentications
@@ -90,7 +192,7 @@ DESCRIPTION
   List authentications
 ```
 
-_See code: [src/commands/auth/list.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/auth/list.ts)_
+_See code: [src/commands/auth/list.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/auth/list.ts)_
 
 ## `raindrop auth login`
 
@@ -104,7 +206,7 @@ DESCRIPTION
   Logs a user into the LiquidMetal platform. Supports browser-based authentication.
 ```
 
-_See code: [src/commands/auth/login.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/auth/login.ts)_
+_See code: [src/commands/auth/login.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/auth/login.ts)_
 
 ## `raindrop auth logout`
 
@@ -118,7 +220,7 @@ DESCRIPTION
   Logout authentications
 ```
 
-_See code: [src/commands/auth/logout.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/auth/logout.ts)_
+_See code: [src/commands/auth/logout.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/auth/logout.ts)_
 
 ## `raindrop auth select`
 
@@ -135,7 +237,7 @@ DESCRIPTION
   Select active organization
 ```
 
-_See code: [src/commands/auth/select.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/auth/select.ts)_
+_See code: [src/commands/auth/select.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/auth/select.ts)_
 
 ## `raindrop build branch BRANCH`
 
@@ -152,7 +254,7 @@ FLAGS
   -M, --manifest=<value>   [default: raindrop.manifest] project manifest
   -o, --output=<value>     [default: dist] output directory
   -p, --versionId=<value>  branch from this version
-  -r, --root=<value>       [default: /Users/dstaley/Work/liquidmetal/packages/raindrop] root directory
+  -r, --root=<value>       [default: /Users/ian/liquidmetal/packages/raindrop] root directory
       --show               show the current branch
       --start              start the application after deploying
 
@@ -164,7 +266,7 @@ EXAMPLES
   Branch a Raindrop application.
 ```
 
-_See code: [src/commands/build/branch.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/branch.ts)_
+_See code: [src/commands/build/branch.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/branch.ts)_
 
 ## `raindrop build checkout [VERSION]`
 
@@ -190,7 +292,7 @@ EXAMPLES
   Switched to version: 01jux6z20m4gbhn5kaa4mcm2jr
 ```
 
-_See code: [src/commands/build/checkout.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/checkout.ts)_
+_See code: [src/commands/build/checkout.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/checkout.ts)_
 
 ## `raindrop build clone ID [PATH]`
 
@@ -218,7 +320,7 @@ EXAMPLES
   Clone a project in the specified directory.
 ```
 
-_See code: [src/commands/build/clone.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/clone.ts)_
+_See code: [src/commands/build/clone.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/clone.ts)_
 
 ## `raindrop build delete [APPLICATION]`
 
@@ -236,7 +338,7 @@ FLAGS
   -a, --all               delete all application versions
   -o, --output=<option>   [default: table] output format
                           <options: text|table|json>
-  -r, --root=<value>      [default: /Users/dstaley/Work/liquidmetal/packages/raindrop] root directory
+  -r, --root=<value>      [default: /Users/ian/liquidmetal/packages/raindrop] root directory
   -v, --version=<value>   application version to delete
 
 DESCRIPTION
@@ -247,7 +349,7 @@ EXAMPLES
   Deleted (application) at version (version)
 ```
 
-_See code: [src/commands/build/delete.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/delete.ts)_
+_See code: [src/commands/build/delete.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/delete.ts)_
 
 ## `raindrop build deploy`
 
@@ -261,7 +363,7 @@ FLAGS
   -M, --manifest=<value>   [default: raindrop.manifest] project manifest
   -a, --amend              amend an existing application
   -o, --output=<value>     [default: dist] output directory
-  -r, --root=<value>       [default: /Users/dstaley/Work/liquidmetal/packages/raindrop] root directory
+  -r, --root=<value>       [default: /Users/ian/liquidmetal/packages/raindrop] root directory
   -s, --start              start the application after deploying
   -v, --versionId=<value>  version ID
       --lock=<value>       override lock ID to resume deployment
@@ -275,7 +377,7 @@ EXAMPLES
   Deploy a Raindrop application version.
 ```
 
-_See code: [src/commands/build/deploy.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/deploy.ts)_
+_See code: [src/commands/build/deploy.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/deploy.ts)_
 
 ## `raindrop build env get VAR`
 
@@ -302,7 +404,7 @@ EXAMPLES
   sets an env var/secret.
 ```
 
-_See code: [src/commands/build/env/get.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/env/get.ts)_
+_See code: [src/commands/build/env/get.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/env/get.ts)_
 
 ## `raindrop build env set VAR [VALUE]`
 
@@ -320,7 +422,7 @@ FLAGS
   -M, --manifest=<value>     [default: raindrop.manifest] project manifest
   -a, --application=<value>  application to start
   -o, --output=<value>       [default: table] output format
-  -r, --root=<value>         [default: /Users/dstaley/Work/liquidmetal/packages/raindrop] root directory
+  -r, --root=<value>         [default: /Users/ian/liquidmetal/packages/raindrop] root directory
   -v, --versionId=<value>    version ID
 
 DESCRIPTION
@@ -331,7 +433,7 @@ EXAMPLES
   sets an env var/secret.
 ```
 
-_See code: [src/commands/build/env/set.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/env/set.ts)_
+_See code: [src/commands/build/env/set.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/env/set.ts)_
 
 ## `raindrop build find`
 
@@ -347,7 +449,7 @@ FLAGS
   -a, --application=<value>  application
   -o, --output=<option>      [default: table] output format
                              <options: text|table|json>
-  -r, --root=<value>         [default: /Users/dstaley/Work/liquidmetal/packages/raindrop] root directory
+  -r, --root=<value>         [default: /Users/ian/liquidmetal/packages/raindrop] root directory
   -v, --version=<value>      application version
       --all                  query modules for all applications
       --moduleType=<value>   filter by module type (e.g. smartbucket)
@@ -359,7 +461,7 @@ EXAMPLES
   $ raindrop build find .
 ```
 
-_See code: [src/commands/build/find.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/find.ts)_
+_See code: [src/commands/build/find.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/find.ts)_
 
 ## `raindrop build generate`
 
@@ -372,7 +474,7 @@ USAGE
 FLAGS
   -M, --manifest=<value>  [default: raindrop.manifest] project manifest
   -o, --output=<value>    [default: dist] output directory
-  -r, --root=<value>      [default: /Users/dstaley/Work/liquidmetal/packages/raindrop] root directory
+  -r, --root=<value>      [default: /Users/ian/liquidmetal/packages/raindrop] root directory
 
 DESCRIPTION
   (re)generate all code for a LiquidMetal.AI project
@@ -381,7 +483,7 @@ EXAMPLES
   $ raindrop build generate
 ```
 
-_See code: [src/commands/build/generate.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/generate.ts)_
+_See code: [src/commands/build/generate.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/generate.ts)_
 
 ## `raindrop build init [PATH]`
 
@@ -405,7 +507,7 @@ EXAMPLES
   Initialize a project in the current directory.
 ```
 
-_See code: [src/commands/build/init.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/init.ts)_
+_See code: [src/commands/build/init.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/init.ts)_
 
 ## `raindrop build list`
 
@@ -428,7 +530,7 @@ EXAMPLES
   List Raindrop catalog resources.
 ```
 
-_See code: [src/commands/build/list.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/list.ts)_
+_See code: [src/commands/build/list.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/list.ts)_
 
 ## `raindrop build sandbox`
 
@@ -449,7 +551,7 @@ EXAMPLES
   $ raindrop build sandbox
 ```
 
-_See code: [src/commands/build/sandbox.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/sandbox.ts)_
+_See code: [src/commands/build/sandbox.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/sandbox.ts)_
 
 ## `raindrop build start`
 
@@ -462,7 +564,7 @@ USAGE
 FLAGS
   -M, --manifest=<value>     [default: raindrop.manifest] project manifest
   -a, --application=<value>  application to start
-  -r, --root=<value>         [default: /Users/dstaley/Work/liquidmetal/packages/raindrop] root directory
+  -r, --root=<value>         [default: /Users/ian/liquidmetal/packages/raindrop] root directory
   -v, --version=<value>      application version to start
 
 DESCRIPTION
@@ -473,7 +575,7 @@ EXAMPLES
   Start a Raindrop application.
 ```
 
-_See code: [src/commands/build/start.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/start.ts)_
+_See code: [src/commands/build/start.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/start.ts)_
 
 ## `raindrop build status`
 
@@ -488,7 +590,7 @@ FLAGS
   -a, --application=<value>  application
   -o, --output=<option>      [default: table] output format
                              <options: watch|table|json>
-  -r, --root=<value>         [default: /Users/dstaley/Work/liquidmetal/packages/raindrop] root directory
+  -r, --root=<value>         [default: /Users/ian/liquidmetal/packages/raindrop] root directory
   -v, --version=<value>      application version
 
 DESCRIPTION
@@ -498,7 +600,7 @@ EXAMPLES
   $ raindrop build status .
 ```
 
-_See code: [src/commands/build/status.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/status.ts)_
+_See code: [src/commands/build/status.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/status.ts)_
 
 ## `raindrop build stop`
 
@@ -511,7 +613,7 @@ USAGE
 FLAGS
   -M, --manifest=<value>     [default: raindrop.manifest] project manifest
   -a, --application=<value>  application to stop
-  -r, --root=<value>         [default: /Users/dstaley/Work/liquidmetal/packages/raindrop] root directory
+  -r, --root=<value>         [default: /Users/ian/liquidmetal/packages/raindrop] root directory
   -v, --version=<value>      application version to start
 
 DESCRIPTION
@@ -522,7 +624,7 @@ EXAMPLES
   Stop a Raindrop application.
 ```
 
-_See code: [src/commands/build/stop.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/stop.ts)_
+_See code: [src/commands/build/stop.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/stop.ts)_
 
 ## `raindrop build tools check`
 
@@ -534,7 +636,7 @@ USAGE
 
 FLAGS
   -m, --manifest=<value>  [default: raindrop.manifest] project manifest
-  -r, --root=<value>      [default: /Users/dstaley/Work/liquidmetal/packages/raindrop] root directory
+  -r, --root=<value>      [default: /Users/ian/liquidmetal/packages/raindrop] root directory
 
 DESCRIPTION
   validate a LiquidMetal.AI raindrop.manifest
@@ -543,7 +645,7 @@ EXAMPLES
   $ raindrop build tools check
 ```
 
-_See code: [src/commands/build/tools/check.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/tools/check.ts)_
+_See code: [src/commands/build/tools/check.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/tools/check.ts)_
 
 ## `raindrop build tools fmt`
 
@@ -555,7 +657,7 @@ USAGE
 
 FLAGS
   -m, --manifest=<value>  [default: raindrop.manifest] project manifest
-  -r, --root=<value>      [default: /Users/dstaley/Work/liquidmetal/packages/raindrop] root directory
+  -r, --root=<value>      [default: /Users/ian/liquidmetal/packages/raindrop] root directory
 
 DESCRIPTION
   format a LiquidMetal.AI raindrop.manifest
@@ -564,7 +666,7 @@ EXAMPLES
   $ raindrop build tools fmt
 ```
 
-_See code: [src/commands/build/tools/fmt.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/tools/fmt.ts)_
+_See code: [src/commands/build/tools/fmt.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/tools/fmt.ts)_
 
 ## `raindrop build unsandbox`
 
@@ -585,7 +687,7 @@ EXAMPLES
   $ raindrop build unsandbox
 ```
 
-_See code: [src/commands/build/unsandbox.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/unsandbox.ts)_
+_See code: [src/commands/build/unsandbox.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/unsandbox.ts)_
 
 ## `raindrop build upload`
 
@@ -598,7 +700,7 @@ USAGE
 FLAGS
   -M, --manifest=<value>   [default: raindrop.manifest] project manifest
   -o, --output=<value>     [default: dist] output directory
-  -r, --root=<value>       [default: /Users/dstaley/Work/liquidmetal/packages/raindrop] root directory
+  -r, --root=<value>       [default: /Users/ian/liquidmetal/packages/raindrop] root directory
   -v, --versionId=<value>  (required) version ID
 
 DESCRIPTION
@@ -608,7 +710,7 @@ EXAMPLES
   $ raindrop build upload
 ```
 
-_See code: [src/commands/build/upload.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/upload.ts)_
+_See code: [src/commands/build/upload.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/upload.ts)_
 
 ## `raindrop build validate`
 
@@ -621,7 +723,7 @@ USAGE
 FLAGS
   -M, --manifest=<value>  [default: raindrop.manifest] project manifest
   -o, --output=<value>    [default: dist] output directory
-  -r, --root=<value>      [default: /Users/dstaley/Work/liquidmetal/packages/raindrop] root directory
+  -r, --root=<value>      [default: /Users/ian/liquidmetal/packages/raindrop] root directory
 
 DESCRIPTION
   build and validate a LiquidMetal.AI project
@@ -630,7 +732,7 @@ EXAMPLES
   $ raindrop build validate
 ```
 
-_See code: [src/commands/build/validate.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/build/validate.ts)_
+_See code: [src/commands/build/validate.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/build/validate.ts)_
 
 ## `raindrop help [COMMAND]`
 
@@ -664,7 +766,7 @@ ARGUMENTS
   KEY  key/path in the bucket to delete
 
 FLAGS
-  -b, --bucket=<value>    bucket name
+  -b, --bucket=<value>    bucket name version can be specified with #, e.g. my-bucket#versionId
   -m, --moduleId=<value>  moduleId
   -o, --output=<option>   [default: text] output format
                           <options: text|json>
@@ -677,7 +779,7 @@ EXAMPLES
   Delete file with key 'my-key' from my-bucket
 ```
 
-_See code: [src/commands/object/delete.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/object/delete.ts)_
+_See code: [src/commands/object/delete.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/object/delete.ts)_
 
 ## `raindrop object get KEY [OUTPUT]`
 
@@ -692,7 +794,7 @@ ARGUMENTS
   OUTPUT  output file (defaults to key basename)
 
 FLAGS
-  -b, --bucket=<value>    bucket name
+  -b, --bucket=<value>    bucket name version can be specified with #, e.g. my-bucket#versionId
   -f, --format=<option>   [default: file] output format
                           <options: file|stdout|json>
   -m, --moduleId=<value>  moduleId
@@ -708,7 +810,7 @@ EXAMPLES
   Download file with key 'my-key' from my-bucket to output.txt
 ```
 
-_See code: [src/commands/object/get.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/object/get.ts)_
+_See code: [src/commands/object/get.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/object/get.ts)_
 
 ## `raindrop object list`
 
@@ -719,7 +821,7 @@ USAGE
   $ raindrop object list [-b <value>] [-m <value>] [-o text|json|table]
 
 FLAGS
-  -b, --bucket=<value>    bucket name
+  -b, --bucket=<value>    bucket name version can be specified with #, e.g. my-bucket#versionId
   -m, --moduleId=<value>  moduleId
   -o, --output=<option>   [default: text] output format
                           <options: text|json|table>
@@ -732,7 +834,7 @@ EXAMPLES
   List all objects in my-bucket
 ```
 
-_See code: [src/commands/object/list.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/object/list.ts)_
+_See code: [src/commands/object/list.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/object/list.ts)_
 
 ## `raindrop object put FILE KEY`
 
@@ -747,7 +849,7 @@ ARGUMENTS
   KEY   key/path in the bucket
 
 FLAGS
-  -b, --bucket=<value>       bucket name
+  -b, --bucket=<value>       bucket name version can be specified with #, e.g. my-bucket#versionId
   -m, --moduleId=<value>     moduleId
   -o, --output=<option>      [default: text] output format
                              <options: text|json>
@@ -761,7 +863,7 @@ EXAMPLES
   Upload myfile.txt to my-bucket with key 'my-key'
 ```
 
-_See code: [src/commands/object/put.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/object/put.ts)_
+_See code: [src/commands/object/put.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/object/put.ts)_
 
 ## `raindrop plugins`
 
@@ -1065,7 +1167,7 @@ ARGUMENTS
   QUERY  search query to run
 
 FLAGS
-  -b, --buckets=<value>...    Bucket names to search in, version can be specified with @, e.g. my-bucket@versionId
+  -b, --buckets=<value>...    Bucket names to search in, version can be specified with #, e.g. my-bucket#versionId
   -m, --moduleIds=<value>...  Module IDs to search in
   -o, --output=<option>       [default: text] output format
                               <options: text|json>
@@ -1078,7 +1180,38 @@ EXAMPLES
   Run a RAG search query against a Smart Bucket.
 ```
 
-_See code: [src/commands/query/chunk-search.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/query/chunk-search.ts)_
+_See code: [src/commands/query/chunk-search.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/query/chunk-search.ts)_
+
+## `raindrop query document QUERY`
+
+Chat with a document stored in a Smart Bucket
+
+```
+USAGE
+  $ raindrop query document QUERY -o <value> [-b <value>] [-m <value>] [-O text|json]
+
+ARGUMENTS
+  QUERY  question or query about the document
+
+FLAGS
+  -O, --output=<option>   [default: text] output format
+                          <options: text|json>
+  -b, --bucket=<value>    Bucket name containing the document, version can be specified with #, e.g. my-bucket#versionId
+  -m, --moduleId=<value>  Module ID containing the document
+  -o, --objectId=<value>  (required) Object ID of the document to chat with
+
+DESCRIPTION
+  Chat with a document stored in a Smart Bucket
+
+EXAMPLES
+  $ raindrop query document "What is the main topic of this document?" -b my-bucket -o document.pdf
+  Chat with a document in a Smart Bucket using bucket name.
+
+  $ raindrop query document "What is the main topic of this document?" -m module-id -o document.pdf
+  Chat with a document in a Smart Bucket using module ID.
+```
+
+_See code: [src/commands/query/document.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/query/document.ts)_
 
 ## `raindrop query search [QUERY]`
 
@@ -1092,7 +1225,7 @@ ARGUMENTS
   QUERY  search query
 
 FLAGS
-  -b, --buckets=<value>...    Bucket names to search in, version can be specified with @, e.g. my-bucket@versionId
+  -b, --buckets=<value>...    Bucket names to search in, version can be specified with #, e.g. my-bucket#versionId
   -m, --moduleIds=<value>...  Module IDs to search in
   -o, --output=<option>       [default: text] output format
                               <options: text|json>
@@ -1110,7 +1243,7 @@ EXAMPLES
   Get page 2 of previous search results.
 ```
 
-_See code: [src/commands/query/search.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/query/search.ts)_
+_See code: [src/commands/query/search.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/query/search.ts)_
 
 ## `raindrop tail`
 
@@ -1124,5 +1257,5 @@ DESCRIPTION
   tail logs of applications deployed
 ```
 
-_See code: [src/commands/tail.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.0/src/commands/tail.ts)_
+_See code: [src/commands/tail.ts](https://github.com/liquidmetal-ai/liquidmetal/blob/v0.4.2/src/commands/tail.ts)_
 <!-- commandsstop -->

package/dist/base-command.d.ts

@@ -3,6 +3,7 @@ import { CatalogService } from '@liquidmetal-ai/drizzle/liquidmetal/v1alpha1/cat
 import { ObjectService } from '@liquidmetal-ai/drizzle/liquidmetal/v1alpha1/object_pb';
 import { RainbowAuthService } from '@liquidmetal-ai/drizzle/liquidmetal/v1alpha1/rainbow_auth_pb';
 import { SearchAgentService } from '@liquidmetal-ai/drizzle/liquidmetal/v1alpha1/search_agent_pb';
+import { AnnotationService } from '@liquidmetal-ai/protogen2/annotation_pb';
 import { Command, Interfaces } from '@oclif/core';
 import { Config } from './config.js';
 import { ServiceIdentity } from './index.js';
@@ -17,6 +18,7 @@ export declare abstract class BaseCommand<T extends typeof Command> extends Comm
         rainbowAuthToken: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
         rainbowOrganizationId: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
         rainbowUserId: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        sendVersionMetadata: Interfaces.OptionFlag<string, Interfaces.CustomOptions>;
     };
     static baseFlags: {};
     static baseArgs: {};
@@ -48,6 +50,11 @@ export declare abstract class BaseCommand<T extends typeof Command> extends Comm
         organizationId: string;
         userId: string;
     }>;
+    protected annotationService(appName: string, versionId: string): Promise<{
+        client: StrictClient<typeof AnnotationService>;
+        organizationId: string;
+        userId: string;
+    }>;
     protected rainbowAuthService(): Promise<{
         client: StrictClient<typeof RainbowAuthService>;
     }>;

package/dist/base-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,yDAAyD,CAAC;AACzF,OAAO,EAAE,aAAa,EAAE,MAAM,wDAAwD,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,MAAM,8DAA8D,CAAC;AAGlG,OAAO,EAAE,OAAO,EAAS,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,MAAM,EAA0B,MAAM,aAAa,CAAC;AAC7D,OAAO,EAML,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,OAAO,OAAO,IAAI,UAAU,CAAC,aAAa,CAAC,CAAC,OAAO,WAAW,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AACvH,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,OAAO,OAAO,IAAI,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAEhF,8BAAsB,WAAW,CAAC,CAAC,SAAS,OAAO,OAAO,CAAE,SAAQ,OAAO;IACzE,MAAM,CAAC,YAAY;;;;;;;MAiCjB;IAEF,MAAM,CAAC,SAAS,KAAM;IACtB,MAAM,CAAC,QAAQ,KAAM;IAErB,SAAS,CAAC,KAAK,EAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,SAAS,CAAC,IAAI,EAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAEzB,SAAS,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAErB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;cAclB,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;cAKvD,OAAO,CAAC,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC;IAIrD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAK7B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAuB5C,SAAS,CAAC,SAAS,IAAI,MAAM;cAIb,eAAe,IAAI,OAAO,CAAC,eAAe,CAAC;IA6BrD,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAChD,MAAM,EAAE,YAAY,CAAC,OAAO,cAAc,CAAC,CAAC;QAC5C,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;cAcc,kBAAkB,IAAI,OAAO,CAAC;QAC5C,MAAM,EAAE,YAAY,CAAC,OAAO,kBAAkB,CAAC,CAAC;QAChD,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;cAac,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QACvD,MAAM,EAAE,YAAY,CAAC,OAAO,aAAa,CAAC,CAAC;QAC3C,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;cAkBc,kBAAkB,IAAI,OAAO,CAAC;QAC5C,MAAM,EAAE,YAAY,CAAC,OAAO,kBAAkB,CAAC,CAAC;KACjD,CAAC;IAMI,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC;IAWjD,GAAG,CAAC,OAAO,GAAE,MAAW,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAGhD"}
+{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"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"}