exponential-sdk 1.21.0 → 1.24.0

package/dist/index.js

@@ -643,11 +643,21 @@ var DecisionsApi = class {
       linkId
     });
   }
-  /** Publish a draft into the log. */
-  async confirmDraft(workspaceId, decisionId) {
+  /**
+   * Publish a draft into the log. Needs a person's login: agent keys are
+   * refused. Idempotent on a decision that is already confirmed.
+   *
+   * `status` moves it in the same write — `{ status: 'ACCEPTED' }` is
+   * "confirm as accepted", and works on an already-confirmed decision too.
+   * `SUPERSEDED` is refused (it needs a successor; use {@link setStatus}).
+   * A person confirming or accepting a decision that no person stands behind
+   * becomes its decider. `decisionId` may also be a `D-0006` label.
+   */
+  async confirmDraft(workspaceId, decisionId, options = {}) {
     return await this.client.decision.confirmDraft.mutate({
       workspaceId,
-      decisionId
+      decisionId,
+      ...options.status ? { status: options.status } : {}
     });
   }
   /**
@@ -1076,8 +1086,25 @@ var PagesApi = class {
   async list(options) {
     return await this.client.page.list.query(options);
   }
-  async get(id) {
-    return await this.client.page.get.query({ id });
+  /** One page. Markdown body only unless `format` says otherwise. */
+  async get(id, options = {}) {
+    return await this.client.page.get.query({
+      id,
+      format: options.format ?? "markdown",
+      ...options.section ? { section: options.section } : {}
+    });
+  }
+  /** The page's headings (level, text, line) and `bodyBytes`, no body. */
+  async outline(id) {
+    return await this.get(id, { format: "outline" });
+  }
+  /**
+   * Pages about something: semantic hits from the Knowledge index first
+   * (nearest first, with the matching passage as `snippet`), then pages whose
+   * title or body contain the query. Only pages the caller can view.
+   */
+  async search(options) {
+    return await this.client.page.search.query(options);
   }
   async create(input) {
     return await this.client.page.create.mutate(input);
@@ -1085,7 +1112,69 @@ var PagesApi = class {
   async update(input) {
     return await this.client.page.update.mutate(input);
   }
+  /** The page's revisions, newest first — who, when, why, size. Never the bodies. */
+  async history(id, options = {}) {
+    return await this.client.page.history.query({ id, ...options });
+  }
+  /** One revision with its Markdown body. */
+  async revision(pageId, revisionId) {
+    return await this.client.page.revision.query({ id: pageId, revisionId });
+  }
+  /** What a revision changed, as a unified diff of the Markdown. */
+  async diff(pageId, revisionId, options = {}) {
+    return await this.client.page.diff.query({
+      id: pageId,
+      revisionId,
+      against: options.against ?? "previous"
+    });
+  }
+  /**
+   * Put a revision's content back as the page's current content. A forward
+   * write: `docVersion` bumps and a "restore" revision is recorded.
+   */
+  async restore(pageId, revisionId, options = {}) {
+    return await this.client.page.restore.mutate({ id: pageId, revisionId, ...options });
+  }
+};
+
+// src/resources.ts
+var ResourcesApi = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list(options = {}) {
+    return await this.client.resource.list.query(options);
+  }
+  async create(input) {
+    const result = await this.client.resource.create.mutate(input);
+    return result.resource;
+  }
+  /** Save a link to the Reading list: a `bookmark` in `to_read`, not embedded. */
+  async save(input) {
+    return await this.create({
+      title: input.title?.trim() || hostnameOf(input.url) || input.url,
+      url: input.url,
+      description: input.note,
+      contentType: "bookmark",
+      readStatus: input.readStatus ?? "to_read",
+      generateEmbeddings: false,
+      workspaceId: input.workspaceId
+    });
+  }
+  async setReadStatus(id, readStatus) {
+    return await this.client.resource.setReadStatus.mutate({ id, readStatus });
+  }
+  async archive(id) {
+    return await this.client.resource.archive.mutate({ id });
+  }
 };
+function hostnameOf(url) {
+  try {
+    return new URL(url).hostname.replace(/^www\./, "");
+  } catch {
+    return null;
+  }
+}
 
 // src/requirements.ts
 var RequirementsApi = class {
@@ -1154,11 +1243,21 @@ var SearchApi = class {
   /**
    * Global text search across the entities the caller can access — the same
    * coverage as the app's Cmd+K palette (projects, actions, goals,
-   * workspaces, and other entity types as the API grows).
+   * workspaces, and other entity types as the API grows). Matches titles;
+   * for pages by meaning use `knowledge` or `PagesApi.search`.
    */
   async global(options) {
     return await this.client.search.global.query(options);
   }
+  /**
+   * Semantic search over one workspace's Knowledge index — the caller's own
+   * indexed meetings, resources, documents and pages, scored by meaning. Each
+   * source contributes its best-matching passage. Costs an embedding call;
+   * never throws for an index failure (returns no results instead).
+   */
+  async knowledge(options) {
+    return await this.client.search.knowledge.query(options);
+  }
 };
 
 // src/time.ts
@@ -1449,6 +1548,7 @@ var ExponentialClient = class {
     this.areas = new AreasApi(this.client);
     this.meetings = new MeetingsApi(this.client);
     this.pages = new PagesApi(this.client);
+    this.resources = new ResourcesApi(this.client);
     this.requirements = new RequirementsApi(this.client);
     this.scopes = new ScopesApi(this.client);
     this.search = new SearchApi(this.client);
@@ -1479,6 +1579,7 @@ var ExponentialClient = class {
   areas;
   meetings;
   pages;
+  resources;
   requirements;
   scopes;
   search;