@lotics/cli 0.315.17 → 0.316.0

package/dist/src/client.d.ts

@@ -75,11 +75,6 @@ export interface LoticsClientOptions {
      *  instance's key to production (`docs/on_premise.md` section 8). */
     apiUrl: string;
     workspaceId?: string;
-    /** Admin "View as": when set, every request carries `x-view-as-member-id`, so
-     *  the backend evaluates IAM scoping (and `is_current_member`) as this member.
-     *  Admin-only — the server rejects a non-admin key. Writes stay attributed to
-     *  the key's owner. */
-    viewAsMemberId?: string;
 }
 export interface WorkspaceInfo {
     id: string;
@@ -139,7 +134,7 @@ export interface ToolInfo {
  * A single knowledge doc with its HYDRATED body — the shape of
  * `GET /v1/knowledge_docs/{id}`, and the one content-read path a non-sandbox
  * client has. `content_sha` is the concurrency token the REST PATCH echoes back
- * as `expected_content_sha`; the `update_knowledge` TOOL CASes internally, so a
+ * as `expected_content_sha`; the `set_knowledge` TOOL CASes internally, so a
  * CLI caller never needs to pass it.
  */
 /** A doc's metadata, as every listing serves it — no body. */
@@ -171,42 +166,6 @@ export interface FileUploadResult {
         error: string;
     }>;
 }
-/** One bound alias: the live thing it names, and what the workspace calls that now. */
-export interface BoundTarget {
-    id: string;
-    /** Null when this workspace no longer holds it — deleted or archived. */
-    live_label: string | null;
-}
-/** One column of a bound entity, with the options of a select under it. */
-export interface BoundField extends BoundTarget {
-    options: Record<string, BoundTarget>;
-}
-/** One entity of the model, as this workspace holds it. */
-export interface BoundEntity {
-    table: string;
-    live_label: string | null;
-    fields: Record<string, BoundField>;
-}
-/**
- * WHAT EACH ALIAS OF A WORKSPACE MODEL BECAME IN ONE WORKSPACE.
- *
- * The join a model file cannot carry, kept by the workspace rather than beside
- * the file — a file is never committed, so memory next to it is one author's
- * disk. Every bound thing arrives with the label the workspace gives it NOW,
- * which is the half a client cannot compute without a read per table, and the
- * half that turns "one missing, one extra" into "renamed".
- */
-export interface ModelBinding {
-    entities: Record<string, BoundEntity>;
-    templates: Record<string, BoundTarget>;
-    roles: Record<string, BoundTarget>;
-    /** `<entity-alias>:<row-ref>` → the record that first row became. */
-    rows: Record<string, string>;
-    /** The path a row attached a document by → the file it was uploaded as. */
-    documents: Record<string, string>;
-    /** A model's app alias → the app created for it here. Absent from an instance too old to bind one. */
-    apps?: Record<string, BoundTarget>;
-}
 /**
  * A request the API refused. The message carries the status and the server's
  * sentence, which is what reaches a person; `status` and `body` are for the
@@ -272,8 +231,6 @@ export declare function pollCliLogin(apiUrl: string, request_id: string, secret:
 export declare class LoticsClient {
     private apiKey;
     private workspaceId;
-    /** The active "View as" target member id, if any; sent on every request. */
-    private readonly viewAsMemberId;
     /** The instance this client sends every request to. */
     readonly baseUrl: string;
     constructor(options: LoticsClientOptions);
@@ -341,27 +298,6 @@ export declare class LoticsClient {
         timezone?: string;
         default_currency?: string;
     }): Promise<WorkspaceInfo>;
-    /**
-     * What each alias of a workspace model became here, with what this workspace
-     * calls every one of them now.
-     *
-     * ONE request for a join a client would otherwise make by label — and by label
-     * a renamed table is one thing missing and one thing extra, which is what an
-     * additive verb creates a second table over. Admin-only, like the scaffold it
-     * is the memory of.
-     */
-    getModelBinding(): Promise<ModelBinding>;
-    /**
-     * Record which file each of a model's document PATHS was uploaded as.
-     *
-     * The one part of a binding the server cannot observe — a path is this
-     * machine's filesystem and never reaches the wire — so the uploader states the
-     * pair. It is what makes re-attaching a model's documents upload nothing a
-     * second time.
-     */
-    recordModelDocuments(documents: Record<string, string>): Promise<{
-        recorded: number;
-    }>;
     /** Renames (and re-settings) the CURRENT workspace — the endpoint reads the
      *  target from the request's workspace, never a path id. */
     updateWorkspace(body: {
@@ -403,13 +339,13 @@ export declare class LoticsClient {
     }): Promise<ToolExecuteResult>;
     /**
      * Fetch one knowledge doc with its hydrated `content` — the single content-read
-     * path for a non-sandbox client (the `list_knowledge` tool returns metadata
+     * path for a non-sandbox client (the `get_workspace` tool returns metadata
      * only, and the sandbox-staging read path is unavailable here). Works for both
      * the file-model and legacy parked-column rows. Mirrors GET /v1/knowledge_docs/{id}.
      */
     getKnowledgeDoc(knowledge_doc_id: string): Promise<KnowledgeDocDetail>;
     /**
-     * Every doc's metadata — REST rather than the `list_knowledge` tool, because
+     * Every doc's metadata — REST rather than the `get_workspace` tool, because
      * this is the surface a PERSON manages the corpus from and the tool is bound
      * to what the assistant may browse. That distinction is the whole point of
      * `include_hidden`: a hidden doc is out of the assistant's corpus by design,
@@ -446,6 +382,14 @@ export declare class LoticsClient {
         workspace_id: string;
         current_version_id: string | null;
     }>;
+    /** The `.lotics/` declarations that type a custom-code app's hooks by its live bindings — `GET /v1/apps/{app_id}/types`. */
+    getAppTypes(appId: string, sdk: "@lotics/app-sdk" | "@lotics/app-runtime/sdk"): Promise<{
+        app_id: string;
+        files: Array<{
+            path: string;
+            content: string;
+        }>;
+    }>;
     /** A built app version's project source, as the `source.tar.gz` its deploy uploaded. */
     downloadAppVersionSource(appId: string, versionId: string): Promise<Buffer>;
     /**
@@ -462,26 +406,6 @@ export declare class LoticsClient {
             name: string;
         };
     }>>;
-    /**
-     * Resolve the display name + fields (incl. select options) of the given tables.
-     * One `get_table` call per id (the tool surface has no batch variant); a
-     * missing/inaccessible table is dropped rather than throwing, so a stale id in
-     * the scope set never fails the caller.
-     */
-    getWorkspaceSchema(tableIds: string[]): Promise<Array<{
-        id: string;
-        name: string;
-        fields: Array<{
-            id: string;
-            name: string;
-            type: string;
-            multi?: boolean;
-            options?: Array<{
-                id: string;
-                label: string;
-            }>;
-        }>;
-    }>>;
     /**
      * Run a named query declared in the app's manifest, scoped to the app's IAM
      * principal. Mirrors POST /v1/apps/{app_id}/query.
@@ -535,7 +459,7 @@ export declare class LoticsClient {
         filename: string;
         stored_filename: string;
     }>;
-    downloadRecordFiles(recordId: string, fieldKey: string, outputDir?: string): Promise<Array<{
+    downloadRecordFiles(recordId: string, fieldAlias: string, outputDir?: string): Promise<Array<{
         path: string;
         filename: string;
         file_id: string;

package/dist/src/client.js

@@ -210,14 +210,11 @@ function unparsedAnswer(text) {
 var LoticsClient = class {
   apiKey;
   workspaceId;
-  /** The active "View as" target member id, if any; sent on every request. */
-  viewAsMemberId;
   /** The instance this client sends every request to. */
   baseUrl;
   constructor(options) {
     this.apiKey = options.apiKey;
     this.workspaceId = options.workspaceId;
-    this.viewAsMemberId = options.viewAsMemberId;
     this.baseUrl = options.apiUrl;
   }
   /**
@@ -277,9 +274,6 @@ var LoticsClient = class {
     if (this.workspaceId) {
       headers["x-workspace-id"] = this.workspaceId;
     }
-    if (this.viewAsMemberId) {
-      headers["x-view-as-member-id"] = this.viewAsMemberId;
-    }
     if (invocation2) {
       headers["x-lotics-cli-command"] = invocation2.command;
       headers[CLI_CAPABILITIES_HEADER] = CLI_CAPABILITIES.join(",");
@@ -341,29 +335,6 @@ var LoticsClient = class {
   async createWorkspace(body) {
     return this.request("POST", "/v1/workspaces", body);
   }
-  /**
-   * What each alias of a workspace model became here, with what this workspace
-   * calls every one of them now.
-   *
-   * ONE request for a join a client would otherwise make by label — and by label
-   * a renamed table is one thing missing and one thing extra, which is what an
-   * additive verb creates a second table over. Admin-only, like the scaffold it
-   * is the memory of.
-   */
-  async getModelBinding() {
-    return this.request("GET", "/v1/workspaces/model/binding");
-  }
-  /**
-   * Record which file each of a model's document PATHS was uploaded as.
-   *
-   * The one part of a binding the server cannot observe — a path is this
-   * machine's filesystem and never reaches the wire — so the uploader states the
-   * pair. It is what makes re-attaching a model's documents upload nothing a
-   * second time.
-   */
-  async recordModelDocuments(documents) {
-    return this.request("PUT", "/v1/workspaces/model/binding/documents", { documents });
-  }
   /** Renames (and re-settings) the CURRENT workspace — the endpoint reads the
    *  target from the request's workspace, never a path id. */
   async updateWorkspace(body) {
@@ -411,7 +382,7 @@ var LoticsClient = class {
   // --- Knowledge docs ---
   /**
    * Fetch one knowledge doc with its hydrated `content` — the single content-read
-   * path for a non-sandbox client (the `list_knowledge` tool returns metadata
+   * path for a non-sandbox client (the `get_workspace` tool returns metadata
    * only, and the sandbox-staging read path is unavailable here). Works for both
    * the file-model and legacy parked-column rows. Mirrors GET /v1/knowledge_docs/{id}.
    */
@@ -419,7 +390,7 @@ var LoticsClient = class {
     return this.request("GET", `/v1/knowledge_docs/${encodeURIComponent(knowledge_doc_id)}`);
   }
   /**
-   * Every doc's metadata — REST rather than the `list_knowledge` tool, because
+   * Every doc's metadata — REST rather than the `get_workspace` tool, because
    * this is the surface a PERSON manages the corpus from and the tool is bound
    * to what the assistant may browse. That distinction is the whole point of
    * `include_hidden`: a hidden doc is out of the assistant's corpus by design,
@@ -441,6 +412,10 @@ var LoticsClient = class {
   async getApp(appId) {
     return this.request("GET", `/v1/apps/${encodeURIComponent(appId)}`);
   }
+  /** The `.lotics/` declarations that type a custom-code app's hooks by its live bindings — `GET /v1/apps/{app_id}/types`. */
+  async getAppTypes(appId, sdk) {
+    return this.request("GET", `/v1/apps/${encodeURIComponent(appId)}/types?sdk=${encodeURIComponent(sdk)}`);
+  }
   /** A built app version's project source, as the `source.tar.gz` its deploy uploaded. */
   async downloadAppVersionSource(appId, versionId) {
     const { url } = await this.request(
@@ -459,45 +434,6 @@ var LoticsClient = class {
   async getWorkspaceDanglingReferences() {
     return this.request("GET", "/v1/workspaces/dangling-references");
   }
-  /**
-   * Resolve the display name + fields (incl. select options) of the given tables.
-   * One `get_table` call per id (the tool surface has no batch variant); a
-   * missing/inaccessible table is dropped rather than throwing, so a stale id in
-   * the scope set never fails the caller.
-   */
-  async getWorkspaceSchema(tableIds) {
-    const tables = await Promise.all(
-      tableIds.map(async (table_id) => {
-        const res = await this.execute("get_table", { table_id });
-        if (res.error || res.result === null || typeof res.result !== "object") return null;
-        const table = res.result;
-        if (typeof table.id !== "string" || typeof table.name !== "string" || !Array.isArray(table.fields)) {
-          return null;
-        }
-        const fields = table.fields.flatMap((field) => {
-          if (field === null || typeof field !== "object") return [];
-          const f = field;
-          if (typeof f.key !== "string" || typeof f.name !== "string" || typeof f.type !== "string") return [];
-          const options = Array.isArray(f.options) ? f.options.flatMap((opt) => {
-            if (opt === null || typeof opt !== "object") return [];
-            const o = opt;
-            return typeof o.key === "string" && typeof o.name === "string" ? [{ id: o.key, label: o.name }] : [];
-          }) : void 0;
-          return [
-            {
-              id: f.key,
-              name: f.name,
-              type: f.type,
-              ...f.multi === true ? { multi: true } : {},
-              ...options && options.length > 0 ? { options } : {}
-            }
-          ];
-        });
-        return { id: table.id, name: table.name, fields };
-      })
-    );
-    return tables.filter((t) => t !== null);
-  }
   // ── App iframe RPC endpoints ──────────────────────────────────────────────
   // These mirror the two ops handled by frontend/features/app_ui/app_iframe_host.tsx.
   // The deployed iframe sends postMessage to the parent frontend, which calls
@@ -588,17 +524,17 @@ var LoticsClient = class {
     await fs.promises.writeFile(absolutePath, buffer);
     return { path: absolutePath, filename, stored_filename: originalFilename };
   }
-  async downloadRecordFiles(recordId, fieldKey, outputDir) {
+  async downloadRecordFiles(recordId, fieldAlias, outputDir) {
     const result = await this.execute("get_record", { record_id: recordId }, { format: "text" });
     if (result.error) throw new Error(result.error);
     const record = result.result;
-    const files = record?.data?.[fieldKey];
+    const files = record?.data?.[fieldAlias];
     if (!Array.isArray(files)) {
-      throw new Error(`Field ${fieldKey} on ${recordId} is not a file field or has no value`);
+      throw new Error(`Field ${fieldAlias} on ${recordId} is not a file field or has no value`);
     }
     const fileIds = files.map((f, i) => {
       if (typeof f !== "object" || f === null || !("id" in f) || typeof f.id !== "string") {
-        throw new Error(`Invalid file entry [${i}] in ${recordId}.${fieldKey}: ${JSON.stringify(f)}`);
+        throw new Error(`Invalid file entry [${i}] in ${recordId}.${fieldAlias}: ${JSON.stringify(f)}`);
       }
       return f.id;
     });

package/dist/src/invocation.d.ts

@@ -1,7 +1,7 @@
 /** Enabled by an explicit `LOTICS_TELEMETRY=1`. Anything else, including unset, is off. */
 export declare function telemetryEnabled(env?: NodeJS.ProcessEnv): boolean;
 /**
- * The verb path of an invocation — `model.apply`, `run.query_records` —
+ * The verb path of an invocation — `app.apply`, `run.query_records` —
  * from the raw argv positionals.
  *
  * Positionals stop at the first token that is a flag, a JSON blob, an `@file`,