@openengio/cli 0.24.4 → 0.27.1

package/bin/public/openeng.js

@@ -289,6 +289,11 @@ function doc(does, refuses) {
   return Object.freeze({ does, refuses: Object.freeze([...refuses]) });
 }
 var ROUTE_DOCS = Object.freeze({
+  createObjectSet: doc("Saves a named set of 1 to 200 object addresses in the caller's organisation. Concurrent retries with one key return the same saved set and revision.", [...SCOPED, "head-moved"]),
+  listObjectSets: doc("Lists the organisation's saved sets, newest update first, without members or counts.", SIGNED_IN),
+  readObjectSet: doc("Reads a saved set's visible objects on the selected ref, a count of missing visible members and one bit for members outside the caller's scope.", [...SCOPED, "head-moved"]),
+  updateObjectSet: doc("Renames a saved set or replaces its readable members at the expected revision. Members outside the caller's scope remain. A success raises the revision by one.", [...SCOPED, "stale-revision", "head-moved"]),
+  deleteObjectSet: doc("Deletes a saved set and every member at the expected revision.", [...SCOPED, "stale-revision"]),
   health: doc("Answers whether the host is running.", PUBLIC),
   signInStart: doc("Starts a sign-in with the identity provider and redirects the browser to it.", PUBLIC),
   signInCallback: doc("Receives the identity provider's answer and returns a one-time code for the client.", [...PUBLIC, "kind", "lifecycle", "invitation", "token-shape", "signature", "issuer", "audience", "expiry", "algorithm", "claims"]),
@@ -472,6 +477,11 @@ function deepFreeze(value) {
   return value;
 }
 var SCHEMAS = {
+  createObjectSet: { "type": "object", "properties": { "name": { "type": "string" }, "members": { "type": "array", "items": { "type": "object", "properties": { "objectId": { "type": "string" }, "projectId": { "type": "string" } }, "required": ["objectId", "projectId"], "additionalProperties": false } } }, "required": ["name", "members"], "additionalProperties": false },
+  listObjectSets: { "type": "object", "properties": {}, "required": [], "additionalProperties": false },
+  readObjectSet: { "type": "object", "properties": { "setId": { "type": "string" } }, "required": ["setId"], "additionalProperties": false },
+  updateObjectSet: { "type": "object", "properties": { "setId": { "type": "string" }, "revision": { "type": "number" }, "name": { "type": "string" }, "members": { "type": "array", "items": { "type": "object", "properties": { "objectId": { "type": "string" }, "projectId": { "type": "string" } }, "required": ["objectId", "projectId"], "additionalProperties": false } } }, "required": ["setId", "revision"], "additionalProperties": false },
+  deleteObjectSet: { "type": "object", "properties": { "setId": { "type": "string" }, "revision": { "type": "number" } }, "required": ["setId", "revision"], "additionalProperties": false },
   health: { "type": "object", "properties": {}, "required": [], "additionalProperties": false },
   signInStart: { "type": "object", "properties": { "state": { "type": "string" }, "loopback": { "type": "string" }, "code_challenge": { "type": "string" }, "code_challenge_method": { "const": "S256" } }, "required": ["state", "loopback", "code_challenge", "code_challenge_method"], "additionalProperties": false },
   signInCallback: { "oneOf": [{ "type": "object", "properties": { "state": { "type": "string" }, "code": { "type": "string" } }, "required": ["state", "code"], "additionalProperties": false }, { "type": "object", "properties": { "state": { "type": "string" }, "error": { "type": "string" } }, "required": ["state", "error"], "additionalProperties": false }] },
@@ -613,6 +623,11 @@ var SELECTORS = {
 };
 var SELECTOR_SCHEMAS = deepFreeze(SELECTORS);
 var EXAMPLES = {
+  createObjectSet: { "name": "Saved set", "members": [{ "objectId": "obj_aaaaaaaaaaaaaaaaaaaaaaaaaa", "projectId": "<projectId>" }] },
+  listObjectSets: {},
+  readObjectSet: { "setId": "ost_aaaaaaaaaaaaaaaaaaaaaaaaaa" },
+  updateObjectSet: { "setId": "ost_aaaaaaaaaaaaaaaaaaaaaaaaaa", "revision": 1, "name": "Renamed set" },
+  deleteObjectSet: { "setId": "ost_aaaaaaaaaaaaaaaaaaaaaaaaaa", "revision": 1 },
   health: {},
   signInStart: { "state": "<state>", "loopback": "<loopback>", "code_challenge": "<code_challenge>", "code_challenge_method": "S256" },
   signInCallback: { "state": "<state>", "code": "<code>" },
@@ -749,7 +764,7 @@ var EXAMPLES = {
 var ROUTE_INPUT_EXAMPLES = deepFreeze(EXAMPLES);
 
 // packages/api-contract/dist/routes.js
-var PROTOCOL_VERSION = 24;
+var PROTOCOL_VERSION = 27;
 var VERSION_HEADER = "oe2-protocol-version";
 var TOKEN_HEADER = "authorization";
 var IDEMPOTENCY_HEADER = "oe2-idempotency-key";
@@ -775,6 +790,11 @@ function route(entry2) {
   return Object.freeze({ ...entry2, doc: documented });
 }
 var ROUTES = Object.freeze({
+  createObjectSet: route({ name: "createObjectSet", method: "POST", path: "/object-sets", group: "write", selector: "object", subject: "project", idempotent: true, admission: admitting("user"), versioned: true, module: "objects-sdk", capability: "objects.createObjectSet" }),
+  listObjectSets: route({ name: "listObjectSets", method: "POST", path: "/object-sets/list", group: "read", selector: "none", subject: "none", idempotent: false, admission: admitting("user"), versioned: true, module: "objects-sdk", capability: "objects.listObjectSets" }),
+  readObjectSet: route({ name: "readObjectSet", method: "POST", path: "/object-sets/read", group: "read", selector: "object", subject: "project", idempotent: false, admission: admitting("user"), versioned: true, module: "objects-sdk", capability: "objects.readObjectSet" }),
+  updateObjectSet: route({ name: "updateObjectSet", method: "POST", path: "/object-sets/update", group: "write", selector: "object", subject: "project", idempotent: false, admission: admitting("user"), versioned: true, module: "objects-sdk", capability: "objects.updateObjectSet" }),
+  deleteObjectSet: route({ name: "deleteObjectSet", method: "POST", path: "/object-sets/delete", group: "write", selector: "none", subject: "none", idempotent: false, admission: admitting("user"), versioned: true, module: "objects-sdk", capability: "objects.deleteObjectSet" }),
   health: route({ name: "health", method: "GET", path: "/health", group: "platform", selector: "none", subject: "platform", idempotent: false, admission: NO_ACCESS_TOKEN, versioned: false, module: "sdk-core", capability: "core.health" }),
   signInStart: route({ name: "signInStart", method: "GET", path: "/auth/sign-in", group: "platform", selector: "none", subject: "platform", idempotent: false, admission: NO_ACCESS_TOKEN, versioned: false, module: "sdk-core", capability: "core.signInStart" }),
   signInCallback: route({ name: "signInCallback", method: "GET", path: "/auth/callback", group: "platform", selector: "none", subject: "platform", idempotent: false, admission: NO_ACCESS_TOKEN, versioned: false, module: "sdk-core", capability: "core.signInCallback" }),
@@ -909,6 +929,11 @@ var ROUTES = Object.freeze({
   closeImportRun: route({ name: "closeImportRun", method: "POST", path: "/import-run-closes", group: "write", selector: "connection", subject: "connection", idempotent: false, admission: admitting("service", "user"), versioned: true, module: "admin-sdk", capability: "admin.importRunClose" })
 });
 var ROUTE_CARRIES_CREDENTIAL = Object.freeze({
+  createObjectSet: false,
+  listObjectSets: false,
+  readObjectSet: false,
+  updateObjectSet: false,
+  deleteObjectSet: false,
   health: false,
   signInStart: false,
   signInCallback: true,
@@ -1887,6 +1912,9 @@ function exploreViewAddress(address, state) {
   const split = subject.indexOf("?");
   const path = split === -1 ? subject : subject.slice(0, split);
   const query2 = new URLSearchParams(split === -1 ? "" : subject.slice(split + 1));
+  if (state.setId !== void 0 && state.setId !== null && state.setId.length > 0) {
+    query2.set("set", state.setId);
+  }
   if (state.typeKey !== null) {
     query2.set("type", state.typeKey);
   }
@@ -2021,6 +2049,11 @@ function linkPath(organisationId, projectId, subject, ref) {
 // packages/objects-sdk/dist/transport-client.js
 var OBJECTS_ROUTE_ENTRIES = routeEntriesOf("objects-sdk");
 var OBJECTS_ROUTE_NAMES = [
+  "createObjectSet",
+  "listObjectSets",
+  "readObjectSet",
+  "updateObjectSet",
+  "deleteObjectSet",
   "readObject",
   "queryObjects",
   "aggregateObjects",
@@ -9701,12 +9734,13 @@ var IDENTIFIER_FIELD = Object.freeze({
   "app-draft": "appKey"
 });
 var PROJECT_REF_USAGE = "openeng link <explore|branch-diff|project> --project <id> --ref <ref>";
+var SET_USAGE = "openeng link explore --project <id> --ref <ref> --object-set <id>";
 var REF_USAGE = "openeng link <ontology|change-set> --ref <ref>";
 var DRAFT_USAGE = "openeng link app-draft <appKey> --ref <ref>";
 var IDENTIFIED_USAGE = "openeng link <object|type|proposal|app> <identifier> --project <id> --ref <ref>";
 var APP_PAGE_USAGE = "openeng link app-page <appKey> <pageKey> --project <id> --ref <ref>";
 var PAGE_USAGE = "openeng link organisation-page <page>";
-var LINK_HELP = [PROJECT_REF_USAGE, REF_USAGE, DRAFT_USAGE, IDENTIFIED_USAGE, APP_PAGE_USAGE, PAGE_USAGE];
+var LINK_HELP = [PROJECT_REF_USAGE, SET_USAGE, REF_USAGE, DRAFT_USAGE, IDENTIFIED_USAGE, APP_PAGE_USAGE, PAGE_USAGE];
 var refusal = (message) => ({ kind: "client-refusal", message });
 var SCOPE_OF_KIND = Object.freeze({
   object: "project-and-ref",
@@ -9837,12 +9871,21 @@ async function link(context) {
   if (typeof scope === "string") {
     return refusal(`openeng link ${subject.kind} ${scope}`);
   }
-  const path = linkPath(organisation.id, scope.project, subject, scope.ref);
+  if (options.objectSet !== void 0 && (subject.kind !== "explore" || options.objectSet.length === 0)) {
+    return refusal("--object-set needs a saved set identifier and the explore page");
+  }
+  const objectSet = options.objectSet;
+  const path = options.objectSet === void 0 ? linkPath(organisation.id, scope.project, subject, scope.ref) : exploreViewAddress({ organisationId: organisation.id, projectId: scope.project, ref: scope.ref, q: null }, { typeKey: null, objectId: null, setId: options.objectSet });
   const run2 = await runAuthenticated(host, deps, async (clients) => {
-    const [origin, checks] = await Promise.all([
+    const [origin, checks, saved] = await Promise.all([
       clients.admin.readWebOrigin({ input: {} }),
-      Promise.all(subjectReads(clients, subject, scope))
+      Promise.all(subjectReads(clients, subject, scope)),
+      objectSet === void 0 ? Promise.resolve(null) : clients.objects.readObjectSet({
+        selector: { projectId: scope.project, ref: scope.ref },
+        input: { setId: objectSet }
+      })
     ]);
+    if (saved !== null && ("refusal" in saved || saved.replayed === true)) return saved;
     const blocked = checks.find((check) => check.missing === null && ("refusal" in check.answer || check.answer.replayed === true));
     if (blocked !== void 0) return blocked.answer;
     if ("refusal" in origin) {
@@ -10876,6 +10919,7 @@ import { parseArgs } from "node:util";
 
 // packages/cli/src/cli-options.ts
 var CLI_OPTIONS = {
+  "object-set": { type: "string" },
   host: { type: "string" },
   "sign-in-origin": { type: "string" },
   json: { type: "boolean" },
@@ -10912,7 +10956,7 @@ var CLI_OPTIONS = {
 };
 
 // packages/cli/src/cli-version.ts
-var PATCH_VERSION = 4;
+var PATCH_VERSION = 1;
 var CLI_VERSION = `0.${PROTOCOL_VERSION}.${PATCH_VERSION}`;
 
 // packages/cli/src/environment.ts
@@ -11026,6 +11070,7 @@ function parseInvocation(argv) {
         json: values.json === true,
         open: values["no-open"] !== true,
         project: values.project,
+        objectSet: values["object-set"],
         organisation: values.organisation === true,
         readOnly: values["read-only"] === true,
         object: values.object,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openengio/cli",
-  "version": "0.24.4",
+  "version": "0.27.1",
   "license": "Apache-2.0",
   "type": "module",
   "engines": {

package/skill/demo/SKILL.md

@@ -7,12 +7,21 @@ description: Use when a person new to OpenEngineering wants a hands-on tour, or
 
 ## 1. Offer three paths
 
+At every decision in sections 1–3 (path, workflow, next story or step), use your harness's
+multiple-choice question tool if your tool set has one; otherwise ask as a short numbered list.
+Make the first option the happy path: a named next step the person can select to move forward
+without more typing. Offer two or three other real options, never filler. Say once, early, that
+they can always skip a question or type their own answer. Ask every question a step needs together,
+in one multiple-choice call where your tool allows several, so the person answers them in one go;
+run routine commands without permission questions. Each stop point
+asks its own question; an offered option never replaces the person's required words.
+
 After sign-in, when the person has no task of their own, offer once:
 
-- **Seed demo**: create a project, run `openeng demo seed --project <id>`, then follow the
-  [Quickstart](https://docs.openeng.io/get-started/quickstart/) together.
 - **Free-form tour** (the main path): build a small example around their work and explore its
   capabilities together in the app.
+- **Seed demo**: create a project, run `openeng demo seed --project <id>`, then follow the
+  [Quickstart](https://docs.openeng.io/get-started/quickstart/) together.
 - **Something else**: follow the task the person names. They may decline the tour.
 
 Before the tour starts, load every capability below into your own native task or plan tool,
@@ -74,7 +83,6 @@ Ask what the person designs or manages and where the work gets hard. Offer a fit
 or use their own vocabulary. Agree a small story with a visible result. Create a demo organisation
 with `openeng org create` unless asked to use an existing one; say which data is invented.
 Ask before touching existing data, inviting anyone, connecting Onshape or registering an app.
-Ask at most two questions at a time; do not turn routine commands into permission questions.
 
 Whenever the tour designs types, read `openeng skill new-use-case` and follow every stop point
 in order: show the person the work and wait for agreement at each one. Do not skip a stop point

package/skill/openeng/SKILL.md

@@ -263,6 +263,18 @@ project. `openeng link ontology --ref <ref>` and `openeng link change-set --ref
 project, and `openeng link organisation-page <page>` takes neither flag. The organisation is the one
 your session is attached to.
 
+### Save an object set and link to its canvas
+
+1. Run `openeng help objects-sdk createObjectSet` and `openeng help objects-sdk readObjectSet`.
+2. Query the objects you need with `openeng objects-sdk queryObjects --json`. Keep each object's
+   project with its identifier; one set may contain objects of several projects in your organisation.
+3. Call `openeng objects-sdk createObjectSet` with a name and the selected addresses, following its
+   help. Keep the returned set identifier and revision. Retrying with the same idempotency key
+   returns that original answer.
+4. Run `openeng link explore --project <page project> --ref <ref> --object-set <set id>` and give the
+   person the address it prints. It reads the set first; a refused read prints no link. The set
+   stores no ref, so the link's ref chooses which version of its objects opens.
+
 Every kind with `--ref`, including `ontology` and `change-set`, takes `main` or
 `<projectId>/<branch>`, the ref the platform returns. A bare branch name or change-set id is
 refused by `openeng link`. Before printing, the command reads the ref and the page's own subject;