@thatopen/services 0.18.0 → 0.19.0

package/README.md

@@ -32,6 +32,10 @@ To use beta engine libraries instead of the stable ones, see:
 
 Once scaffolded, open `AGENTS.md` in the scaffolded project root — it has everything needed to start building.
 
+Reading this repository without a scaffolded project (as a person or an AI agent)? The same
+guide lives here: [`resources/AGENTS.md`](./resources/AGENTS.md), alongside
+[`docs/ai-quickstart.md`](./docs/ai-quickstart.md) for the zero-to-running-app path.
+
 ## Beta engine libraries (Founding Members)
 
 Founding Members get early access to the private beta engine libraries (`@thatopen-platform/*-beta`). The CLI configures access automatically — no npm account or manual token needed.

package/dist/built-in/index.d.ts

@@ -27,7 +27,7 @@ export interface CDENamingSchema {
     separator: string;
     segments: CDENamingSegment[];
 }
-export interface CDEFile extends Omit<Item, 'creatingUser'> {
+export interface CDEFile extends Omit<Item, 'createdBy'> {
     createdBy: string;
     metadata: Record<string, CDEMetadataValue>;
     versions?: ItemVersion[];

package/dist/cli/commands/mcp.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+
+export declare const mcpCommand: Command;

package/dist/cli/lib/cli-client.d.ts

@@ -0,0 +1,13 @@
+import { EngineServicesClient } from '../../core/client';
+
+/**
+ * The one way the CLI builds a client.
+ *
+ * Every CLI client sends its platform token as `Authorization: Bearer`
+ * instead of `?accessToken=`. The CLI holds long-lived API tokens, and the
+ * query form reproduces them in proxy logs, error bodies and anything a user
+ * pastes while asking for help. Requires a backend that accepts bearer
+ * platform tokens (deployed 2026-10); older backends answer 401, in which
+ * case upgrading the platform comes first, not flipping this off.
+ */
+export declare function cliClient(accessToken: string, apiUrl: string): EngineServicesClient;

package/dist/cli/lib/config.d.ts

@@ -15,6 +15,8 @@ export interface ThatOpenLocalConfig {
     itemType?: ProjectType;
     /** Path to an icon file (PNG, WebP, or ICO) uploaded on publish. */
     iconPath?: string;
+    /** Project the first publish lands the app/component in (see `--project-id`). */
+    projectId?: string;
     /** Whether this project uses beta engine libraries (@thatopen-platform/*-beta). */
     beta?: boolean;
 }

package/dist/cli/lib/zip.test.d.ts

@@ -0,0 +1 @@
+export {};