@nodaro/sdk 2.29.0 → 2.31.0

package/dist/chunk-Z3ZKFI2M.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/executions.ts"],"names":[],"mappings":";;;AAgIO,IAAM,qBAAN,MAAyB;AAAA,EAC9B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAI,EAAA,EAAkD;AACpD,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,KAAA;AAAA,MACA,CAAA,wBAAA,EAA2B,kBAAA,CAAmB,EAAE,CAAC,CAAA;AAAA,KACnD;AAAA,EACF;AAAA;AAAA,EAGA,eAAA,CACE,UAAA,EACA,MAAA,GAA0C,EAAC,EACY;AACvD,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,KAAA;AAAA,MACA,CAAA,cAAA,EAAiB,kBAAA,CAAmB,UAAU,CAAC,CAAA,WAAA,CAAA;AAAA,MAC/C;AAAA,QACE,KAAA,EAAO;AAAA,UACL,OAAO,MAAA,CAAO,KAAA;AAAA,UACd,QAAQ,MAAA,CAAO,MAAA;AAAA,UACf,QAAQ,MAAA,CAAO,MAAA;AAAA,UACf,QAAQ,MAAA,CAAO;AAAA;AACjB;AACF,KACF;AAAA,EACF;AAAA;AAAA,EAGA,MAAA,CAAO,EAAA,EAAY,MAAA,GAAgC,EAAC,EAA+B;AACjF,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,MAAA;AAAA,MACA,CAAA,wBAAA,EAA2B,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA,CAAA;AAAA,MACjD,EAAE,MAAM,MAAA;AAAO,KACjB;AAAA,EACF;AACF","file":"chunk-Z3ZKFI2M.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type { ExecutionOutcome, NodeExecutionStateWire } from \"@nodaro/shared/workflow\"\n\nexport type ExecutionStatus =\n  | \"pending\"\n  | \"running\"\n  | \"completed\"\n  | \"failed\"\n  | \"cancelled\"\n  | \"stopping\"\n  | \"timed_out\"\n  | \"discarded\"\n\nexport type ExecutionTriggerType =\n  | \"manual\"\n  | \"webhook\"\n  | \"schedule\"\n  | \"app_run\"\n  | \"single-node\"\n  | \"telegram\"\n  | \"telegram_account\"\n  | \"api\"\n  | \"mcp\"\n\n/**\n * Per-node state inside an execution's `nodeStates` map. Keys are node IDs.\n *\n * Extends the published wire contract in `@nodaro/shared`, which is what the\n * orchestrator writes and the editor reads — so a field added there reaches\n * SDK consumers as a typed field rather than through the index signature. The\n * synthetic single-node-job shape from `routes/workflow-execution.ts` fits the\n * same contract.\n */\nexport interface NodeExecutionState extends NodeExecutionStateWire {\n  [key: string]: unknown\n}\n\nexport type { NodeExecutionStatus, NodeSkipReason, ExecutionOutcome } from \"@nodaro/shared/workflow\"\nexport { OUTPUT_BEARING_NODE_STATUSES, nodeStateMayCarryOutput, executionOutcome, countEmptyInputSkips } from \"@nodaro/shared/workflow\"\n\n/**\n * Workflow execution record. Returned by `get()` and `cancel()` (the cancel\n * endpoint returns `{ success: true }`, not the execution itself).\n */\nexport interface WorkflowExecution {\n  id: string\n  /**\n   * `\"execution\"` for an orchestrator run; `\"job\"` for a single-node job the\n   * list shows beside the runs (its `triggerType` is the lane that started it,\n   * `\"mcp\"` for an MCP client's one-node job). Absent on an older server.\n   */\n  kind?: \"execution\" | \"job\"\n  workflowId: string | null\n  userId: string\n  status: ExecutionStatus\n  /**\n   * How a `completed` run ended: `\"nothing_new\"` when at least one node was\n   * skipped for want of input (its `nodeStates` entry carries\n   * `skipReason: \"empty_input\"` — a feed that found no new posts, a writer with\n   * nothing to write), `\"succeeded\"` otherwise. Absent until the run completes\n   * and on an older server. Derived by `executionOutcome()` (exported).\n   */\n  outcome?: ExecutionOutcome\n  triggerType: ExecutionTriggerType\n  triggerData?: unknown\n  nodeStates: Record<string, NodeExecutionState>\n  /**\n   * What a continue-from-failed of this run (`continueMode: \"from-failed\"`)\n   * sent no `nodeIds` considers, besides every node the run left failed or\n   * held back: the nodes the first run of its chain was started on (`nodeIds`\n   * on `/run` — Run selected, an API subset, a Render final). `null`: every\n   * node — a run of every node, one started before the nodes were recorded,\n   * or one a trigger started. Absent on an older server (= every node).\n   */\n  nodeScope?: string[] | null\n  totalNodes: number\n  completedNodes: number\n  failedNodes: number\n  totalCreditsUsed: number\n  errorMessage: string | null\n  startedAt: string | null\n  completedAt: string | null\n  createdAt: string\n  updatedAt: string\n}\n\n/** Summary returned by `listForWorkflow()`. Excludes per-row `triggerData`/`updatedAt`. */\nexport interface WorkflowExecutionSummary {\n  id: string\n  /** See {@link WorkflowExecution.kind}. */\n  kind?: \"execution\" | \"job\"\n  status: ExecutionStatus\n  /** See {@link WorkflowExecution.outcome}. */\n  outcome?: ExecutionOutcome\n  triggerType: ExecutionTriggerType\n  nodeStates: Record<string, NodeExecutionState>\n  totalNodes: number\n  completedNodes: number\n  failedNodes: number\n  totalCreditsUsed: number\n  errorMessage: string | null\n  startedAt: string | null\n  completedAt: string | null\n  createdAt: string\n}\n\nexport interface ListExecutionsForWorkflowParams {\n  limit?: number\n  cursor?: string\n  /** Comma-separated list of statuses, e.g. \"pending,running\". */\n  status?: string\n  /** \"editor\" excludes app_run / component / webhook / schedule executions. */\n  source?: \"editor\" | \"all\"\n}\n\nexport interface ListExecutionsPage<T> {\n  data: T[]\n  nextCursor?: string\n}\n\nexport interface CancelExecutionParams {\n  /**\n   * \"after_current\" sets the execution to \"stopping\" (let in-flight nodes\n   * finish, then stop). Default behavior cancels immediately.\n   */\n  mode?: \"after_current\" | \"discard\"\n}\n\nexport class ExecutionsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** Get an execution by ID. Falls back to standalone single-node jobs server-side. */\n  get(id: string): Promise<{ data: WorkflowExecution }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/workflow-executions/${encodeURIComponent(id)}`,\n    )\n  }\n\n  /** List executions for a workflow. Merges workflow_executions + standalone single-node jobs. */\n  listForWorkflow(\n    workflowId: string,\n    params: ListExecutionsForWorkflowParams = {},\n  ): Promise<ListExecutionsPage<WorkflowExecutionSummary>> {\n    return this.client.request(\n      \"GET\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/executions`,\n      {\n        query: {\n          limit: params.limit,\n          cursor: params.cursor,\n          status: params.status,\n          source: params.source,\n        },\n      },\n    )\n  }\n\n  /** Cancel an execution. Returns `{ success: true }`. */\n  cancel(id: string, params: CancelExecutionParams = {}): Promise<{ success: true }> {\n    return this.client.request(\n      \"POST\",\n      `/v1/workflow-executions/${encodeURIComponent(id)}/cancel`,\n      { body: params },\n    )\n  }\n}\n"]}

package/dist/chunk-Z5GLY4R3.js

@@ -0,0 +1,112 @@
+// src/resources/workspaces.ts
+var WorkspacesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Every workspace this account belongs to, across all its organizations.
+   *
+   * An identity read: a stale workspace binding cannot lock a caller out of
+   * it, which is what makes it safe to call when a selection has gone bad.
+   *
+   * Byte-for-byte the list `GET /v1/me` carries, so a client reconciles
+   * against one truth rather than two. That is why these are SUMMARIES —
+   * enough to render a switcher, not the full view; use {@link get} for that.
+   */
+  list() {
+    return this.client.request("GET", "/v1/workspaces");
+  }
+  listForOrg(orgId, opts = {}) {
+    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/workspaces`, {
+      query: { includeArchived: opts.includeArchived }
+    });
+  }
+  get(id) {
+    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}`);
+  }
+  create(orgId, input) {
+    return this.client.request("POST", `/v1/orgs/${encodeURIComponent(orgId)}/workspaces`, { body: input });
+  }
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/workspaces/${encodeURIComponent(id)}`, { body: input });
+  }
+  /**
+   * Archive or restore. Archiving is REVERSIBLE and destroys nothing: the
+   * workspace stops accepting new work and stays fully readable, which is
+   * what a finished class term needs and a delete would not survive.
+   */
+  setArchived(id, archived) {
+    return this.client.request(
+      "POST",
+      `/v1/workspaces/${encodeURIComponent(id)}/${archived ? "archive" : "unarchive"}`
+    );
+  }
+  // -- members --------------------------------------------------------------
+  listMembers(id, opts = {}) {
+    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}/members`, {
+      query: { ...opts }
+    });
+  }
+  /** Add someone who is ALREADY in the organization. To bring in a new person, invite them. */
+  addMember(id, input) {
+    return this.client.request("POST", `/v1/workspaces/${encodeURIComponent(id)}/members`, { body: input });
+  }
+  updateMember(id, userId, input) {
+    return this.client.request(
+      "PATCH",
+      `/v1/workspaces/${encodeURIComponent(id)}/members/${encodeURIComponent(userId)}`,
+      { body: input }
+    );
+  }
+  removeMember(id, userId) {
+    return this.client.request(
+      "DELETE",
+      `/v1/workspaces/${encodeURIComponent(id)}/members/${encodeURIComponent(userId)}`
+    );
+  }
+  // -- join codes -----------------------------------------------------------
+  /** The workspace's join code, or `null` if none has been created. Admins only. */
+  getJoinCode(id) {
+    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}/join-code`);
+  }
+  /**
+   * Rotate, enable or disable the code. Rotating invalidates the old one
+   * immediately — that is the point of it, and anyone still holding a link
+   * with the old code will be refused.
+   */
+  actOnJoinCode(id, action) {
+    return this.client.request("POST", `/v1/workspaces/${encodeURIComponent(id)}/join-code`, {
+      body: { action }
+    });
+  }
+  /**
+   * Join by code. Another way IN, so a stale workspace binding must not block
+   * it — the server treats this as an identity route for that reason.
+   */
+  join(code) {
+    return this.client.request("POST", "/v1/workspaces/join", { body: { code } });
+  }
+  // -- usage ----------------------------------------------------------------
+  /**
+   * Credits by member, model or day for this workspace. A plain member sees
+   * their OWN runs (the report is self-narrowed and `groupBy: "member"` is
+   * refused); a workspace admin sees everyone and may filter `userId`.
+   * Inclusive dates, IANA `tz` (default UTC), ≤ 366 days (default last 30).
+   */
+  usage(id, opts = {}) {
+    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts } });
+  }
+  /** The individual runs behind a report, newest first, cursor-paged. */
+  usageRows(id, opts = {}) {
+    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, groupBy: "none" } });
+  }
+  /** The same report (or the rows, with `groupBy: "none"`) as CSV text. */
+  usageCsv(id, opts = {}) {
+    return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
+  }
+};
+
+export { WorkspacesResource };
+//# sourceMappingURL=chunk-Z5GLY4R3.js.map
+//# sourceMappingURL=chunk-Z5GLY4R3.js.map

package/dist/chunk-Z5GLY4R3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/workspaces.ts"],"names":[],"mappings":"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","file":"chunk-Z5GLY4R3.js","sourcesContent":["import type {\n  JoinCodeView,\n  MemberStatus,\n  OrgPage,\n  UsageLogEntry,\n  UsageQuery,\n  UsageReport,\n  WorkspaceMemberView,\n  WorkspaceRole,\n  WorkspaceSettings,\n  WorkspaceSummary,\n  WorkspaceView,\n} from \"@nodaro/shared/organizations\"\nimport type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Workspaces — the inner tenancy axis, where work actually lives.\n *\n * Selecting a workspace and belonging to one are different things, and this\n * resource is only about the second. Use {@link NodaroClient.withWorkspace}\n * to decide which workspace a REQUEST acts in; these methods read and change\n * the workspaces themselves.\n */\n\nexport interface CreateWorkspaceInput {\n  name: string\n  slug?: string\n  description?: string\n  settings?: WorkspaceSettings\n}\n\nexport class WorkspacesResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Every workspace this account belongs to, across all its organizations.\n   *\n   * An identity read: a stale workspace binding cannot lock a caller out of\n   * it, which is what makes it safe to call when a selection has gone bad.\n   *\n   * Byte-for-byte the list `GET /v1/me` carries, so a client reconciles\n   * against one truth rather than two. That is why these are SUMMARIES —\n   * enough to render a switcher, not the full view; use {@link get} for that.\n   */\n  list(): Promise<{ data: WorkspaceSummary[]; lastWorkspaceId: string | null }> {\n    return this.client.request(\"GET\", \"/v1/workspaces\")\n  }\n\n  listForOrg(orgId: string, opts: { includeArchived?: boolean } = {}): Promise<{ data: WorkspaceView[] }> {\n    return this.client.request(\"GET\", `/v1/orgs/${encodeURIComponent(orgId)}/workspaces`, {\n      query: { includeArchived: opts.includeArchived },\n    })\n  }\n\n  get(id: string): Promise<{ data: WorkspaceView }> {\n    return this.client.request(\"GET\", `/v1/workspaces/${encodeURIComponent(id)}`)\n  }\n\n  create(orgId: string, input: CreateWorkspaceInput): Promise<{ data: WorkspaceView }> {\n    return this.client.request(\"POST\", `/v1/orgs/${encodeURIComponent(orgId)}/workspaces`, { body: input })\n  }\n\n  update(\n    id: string,\n    input: { name?: string; description?: string | null; settings?: WorkspaceSettings },\n  ): Promise<{ data: WorkspaceView }> {\n    return this.client.request(\"PATCH\", `/v1/workspaces/${encodeURIComponent(id)}`, { body: input })\n  }\n\n  /**\n   * Archive or restore. Archiving is REVERSIBLE and destroys nothing: the\n   * workspace stops accepting new work and stays fully readable, which is\n   * what a finished class term needs and a delete would not survive.\n   */\n  setArchived(id: string, archived: boolean): Promise<{ data: WorkspaceView }> {\n    return this.client.request(\n      \"POST\",\n      `/v1/workspaces/${encodeURIComponent(id)}/${archived ? \"archive\" : \"unarchive\"}`,\n    )\n  }\n\n  // -- members --------------------------------------------------------------\n\n  listMembers(id: string, opts: { cursor?: string; limit?: number } = {}): Promise<OrgPage<WorkspaceMemberView>> {\n    return this.client.request(\"GET\", `/v1/workspaces/${encodeURIComponent(id)}/members`, {\n      query: { ...opts },\n    })\n  }\n\n  /** Add someone who is ALREADY in the organization. To bring in a new person, invite them. */\n  addMember(id: string, input: { userId: string; role: WorkspaceRole }): Promise<{ data: WorkspaceMemberView }> {\n    return this.client.request(\"POST\", `/v1/workspaces/${encodeURIComponent(id)}/members`, { body: input })\n  }\n\n  updateMember(\n    id: string,\n    userId: string,\n    input: { role?: WorkspaceRole; status?: MemberStatus; creditCap?: number | null },\n  ): Promise<{ data: WorkspaceMemberView }> {\n    return this.client.request(\n      \"PATCH\",\n      `/v1/workspaces/${encodeURIComponent(id)}/members/${encodeURIComponent(userId)}`,\n      { body: input },\n    )\n  }\n\n  removeMember(id: string, userId: string): Promise<{ data: { removed: boolean } }> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/workspaces/${encodeURIComponent(id)}/members/${encodeURIComponent(userId)}`,\n    )\n  }\n\n  // -- join codes -----------------------------------------------------------\n\n  /** The workspace's join code, or `null` if none has been created. Admins only. */\n  getJoinCode(id: string): Promise<{ data: JoinCodeView | null }> {\n    return this.client.request(\"GET\", `/v1/workspaces/${encodeURIComponent(id)}/join-code`)\n  }\n\n  /**\n   * Rotate, enable or disable the code. Rotating invalidates the old one\n   * immediately — that is the point of it, and anyone still holding a link\n   * with the old code will be refused.\n   */\n  actOnJoinCode(id: string, action: \"rotate\" | \"enable\" | \"disable\"): Promise<{ data: JoinCodeView }> {\n    return this.client.request(\"POST\", `/v1/workspaces/${encodeURIComponent(id)}/join-code`, {\n      body: { action },\n    })\n  }\n\n  /**\n   * Join by code. Another way IN, so a stale workspace binding must not block\n   * it — the server treats this as an identity route for that reason.\n   */\n  join(code: string): Promise<{ data: { orgId: string; workspaceId: string } }> {\n    return this.client.request(\"POST\", \"/v1/workspaces/join\", { body: { code } })\n  }\n\n  // -- usage ----------------------------------------------------------------\n\n  /**\n   * Credits by member, model or day for this workspace. A plain member sees\n   * their OWN runs (the report is self-narrowed and `groupBy: \"member\"` is\n   * refused); a workspace admin sees everyone and may filter `userId`.\n   * Inclusive dates, IANA `tz` (default UTC), ≤ 366 days (default last 30).\n   */\n  usage(\n    id: string,\n    opts: Omit<UsageQuery, \"cursor\" | \"limit\" | \"workspaceId\" | \"groupBy\"> & { groupBy?: \"member\" | \"model\" | \"day\" } = {},\n  ): Promise<{ data: UsageReport }> {\n    return this.client.request(\"GET\", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts } })\n  }\n\n  /** The individual runs behind a report, newest first, cursor-paged. */\n  usageRows(id: string, opts: Omit<UsageQuery, \"groupBy\" | \"workspaceId\"> = {}): Promise<OrgPage<UsageLogEntry>> {\n    return this.client.request(\"GET\", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, groupBy: \"none\" } })\n  }\n\n  /** The same report (or the rows, with `groupBy: \"none\"`) as CSV text. */\n  usageCsv(id: string, opts: Omit<UsageQuery, \"cursor\" | \"limit\" | \"workspaceId\"> = {}): Promise<string> {\n    return this.client.requestText(\"GET\", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: \"csv\" } })\n  }\n}\n"]}

package/dist/chunk-Z5OMWAQX.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-Z5OMWAQX.js.map
+//# sourceMappingURL=chunk-Z5OMWAQX.js.map

package/dist/chunk-Z5OMWAQX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-Z5OMWAQX.js"}

package/dist/chunk-Z7LGWNI7.js

@@ -0,0 +1,38 @@
+// src/resources/oauth.ts
+var OAuthResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Server-side authorization-code exchange. Sends the standard OAuth 2.0
+   * `application/json` body to `POST /v1/oauth/token`.
+   *
+   * NEVER call this from a browser — `client_secret` must stay on the server.
+   */
+  exchangeCode(input) {
+    return this.client.request("POST", "/v1/oauth/token", {
+      body: { grant_type: "authorization_code", ...input }
+    });
+  }
+  /**
+   * Revoke an access token (RFC 7009). Always returns `{ success: true }`,
+   * even for unknown tokens — the spec forbids leaking token validity.
+   */
+  revoke(token) {
+    return this.client.request("POST", "/v1/oauth/revoke", { body: { token } });
+  }
+  /**
+   * Get public app metadata for a consent screen.
+   * `GET /v1/oauth/app-info?client_id=<id>`. Public route — no auth needed.
+   */
+  getAppInfo(clientId, redirectUri) {
+    return this.client.request("GET", "/v1/oauth/app-info", {
+      query: redirectUri ? { client_id: clientId, redirect_uri: redirectUri } : { client_id: clientId }
+    });
+  }
+};
+
+export { OAuthResource };
+//# sourceMappingURL=chunk-Z7LGWNI7.js.map
+//# sourceMappingURL=chunk-Z7LGWNI7.js.map

package/dist/chunk-Z7LGWNI7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/oauth.ts"],"names":[],"mappings":";AA8CO,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQpB,aAAa,KAAA,EAAwD;AACnE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,iBAAA,EAAmB;AAAA,MACpD,IAAA,EAAM,EAAE,UAAA,EAAY,oBAAA,EAAsB,GAAG,KAAA;AAAM,KACpD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,KAAA,EAA2C;AAChD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,kBAAA,EAAoB,EAAE,IAAA,EAAM,EAAE,KAAA,EAAM,EAAG,CAAA;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAA,CAAW,UAAkB,WAAA,EAA6C;AACxE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,oBAAA,EAAsB;AAAA,MACtD,KAAA,EAAO,WAAA,GAAc,EAAE,SAAA,EAAW,QAAA,EAAU,cAAc,WAAA,EAAY,GAAI,EAAE,SAAA,EAAW,QAAA;AAAS,KACjG,CAAA;AAAA,EACH;AACF","file":"chunk-Z7LGWNI7.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type { DeveloperAppScope } from \"./developer-apps.js\"\n\n/**\n * Server-side authorization-code exchange payload. Field names are snake_case\n * per OAuth 2.0 (RFC 6749).\n */\nexport interface ExchangeCodeInput {\n  client_id: string\n  client_secret: string\n  /** Authorization code received from the consent redirect. */\n  code: string\n  /** Must match the redirect_uri used when issuing the code. */\n  redirect_uri: string\n}\n\n/**\n * `POST /v1/oauth/token` response — snake_case per RFC 6749. `expires_in` is\n * the token's lifetime in seconds.\n */\nexport interface AccessTokenResponse {\n  access_token: string\n  token_type: \"Bearer\"\n  /** Space-separated list of granted scopes. */\n  scope: string\n  expires_in: number\n}\n\n/**\n * Public app metadata for consent screens. Only safe-to-display fields —\n * no secret, no full origin list, no owner_user_id.\n */\nexport interface OAuthAppInfo {\n  name: string\n  description: string | null\n  logoUrl: string | null\n  homepageUrl: string | null\n  scopesRequested: DeveloperAppScope[]\n  /**\n   * Present when `getAppInfo` was given a `redirectUri`: whether that exact\n   * URI is registered for the app. `null` when none was given. Lets a consent\n   * screen refuse to redirect anywhere unregistered without exposing the list.\n   */\n  redirectUriRegistered?: boolean | null\n}\n\nexport class OAuthResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Server-side authorization-code exchange. Sends the standard OAuth 2.0\n   * `application/json` body to `POST /v1/oauth/token`.\n   *\n   * NEVER call this from a browser — `client_secret` must stay on the server.\n   */\n  exchangeCode(input: ExchangeCodeInput): Promise<AccessTokenResponse> {\n    return this.client.request(\"POST\", \"/v1/oauth/token\", {\n      body: { grant_type: \"authorization_code\", ...input },\n    })\n  }\n\n  /**\n   * Revoke an access token (RFC 7009). Always returns `{ success: true }`,\n   * even for unknown tokens — the spec forbids leaking token validity.\n   */\n  revoke(token: string): Promise<{ success: true }> {\n    return this.client.request(\"POST\", \"/v1/oauth/revoke\", { body: { token } })\n  }\n\n  /**\n   * Get public app metadata for a consent screen.\n   * `GET /v1/oauth/app-info?client_id=<id>`. Public route — no auth needed.\n   */\n  getAppInfo(clientId: string, redirectUri?: string): Promise<OAuthAppInfo> {\n    return this.client.request(\"GET\", \"/v1/oauth/app-info\", {\n      query: redirectUri ? { client_id: clientId, redirect_uri: redirectUri } : { client_id: clientId },\n    })\n  }\n}\n"]}

package/dist/chunk-ZCWKX4V6.cjs

@@ -0,0 +1,38 @@
+'use strict';
+
+// src/resources/moodboards.ts
+var MOODBOARD_DIRECTION_PREFIX = "moodboard:";
+function moodboardDirectionId(id) {
+  return `${MOODBOARD_DIRECTION_PREFIX}${id}`;
+}
+var MoodboardsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Your moodboards, newest first. Page with `nextCursor`. */
+  list(params = {}) {
+    return this.client.request("GET", "/v1/moodboards", {
+      query: { limit: params.limit, cursor: params.cursor }
+    });
+  }
+  get(id) {
+    return this.client.request("GET", `/v1/moodboards/${encodeURIComponent(id)}`);
+  }
+  create(input) {
+    return this.client.request("POST", "/v1/moodboards", { body: input });
+  }
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/moodboards/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** Deletes the moodboard only; the images it links to are untouched. */
+  async delete(id) {
+    await this.client.request("DELETE", `/v1/moodboards/${encodeURIComponent(id)}`);
+  }
+};
+
+exports.MOODBOARD_DIRECTION_PREFIX = MOODBOARD_DIRECTION_PREFIX;
+exports.MoodboardsResource = MoodboardsResource;
+exports.moodboardDirectionId = moodboardDirectionId;
+//# sourceMappingURL=chunk-ZCWKX4V6.cjs.map
+//# sourceMappingURL=chunk-ZCWKX4V6.cjs.map

package/dist/chunk-ZCWKX4V6.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/moodboards.ts"],"names":[],"mappings":";;;AAoDO,IAAM,0BAAA,GAA6B;AASnC,SAAS,qBAAqB,EAAA,EAAmC;AACtE,EAAA,OAAO,CAAA,EAAG,0BAA0B,CAAA,EAAG,EAAE,CAAA,CAAA;AAC3C;AASO,IAAM,qBAAN,MAAyB;AAAA,EAC9B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAA,CAAK,MAAA,GAA+B,EAAC,EAA2B;AAC9D,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAuB,KAAA,EAAO,gBAAA,EAAkB;AAAA,MACjE,OAAO,EAAE,KAAA,EAAO,OAAO,KAAA,EAAO,MAAA,EAAQ,OAAO,MAAA;AAAO,KACrD,CAAA;AAAA,EACH;AAAA,EAEA,IAAI,EAAA,EAAgC;AAClC,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAmB,KAAA,EAAO,kBAAkB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACzF;AAAA,EAEA,OAAO,KAAA,EAAiD;AACtD,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAmB,MAAA,EAAQ,kBAAkB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EACjF;AAAA,EAEA,MAAA,CAAO,IAAY,KAAA,EAAiD;AAClE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAmB,OAAA,EAAS,CAAA,eAAA,EAAkB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA,EAAI,EAAE,IAAA,EAAM,KAAA,EAAO,CAAA;AAAA,EAC5G;AAAA;AAAA,EAGA,MAAM,OAAO,EAAA,EAA2B;AACtC,IAAA,MAAM,IAAA,CAAK,OAAO,OAAA,CAA2B,QAAA,EAAU,kBAAkB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACnG;AACF","file":"chunk-ZCWKX4V6.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/** One image of a moodboard — a link, never a copy. */\nexport interface MoodboardImage {\n  /** An http(s) image link (no localhost or private address), up to 2048 characters. */\n  url: string\n  /** Up to 200 characters; it goes along with the image as a style reference. */\n  caption?: string\n}\n\n/** One of your moodboards. */\nexport interface Moodboard {\n  id: string\n  name: string\n  /** The words a run puts into the prompt as the moodboard's look. */\n  description: string | null\n  /** 1–12 images, in order. */\n  images: MoodboardImage[]\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface CreateMoodboardInput {\n  /** 1–80 characters. */\n  name: string\n  /** Up to 1000 characters. */\n  description?: string | null\n  /** 1–12 images. */\n  images: MoodboardImage[]\n}\n\n/** Only the fields you send are written; `images` replaces them all; `description: null` clears it. */\nexport interface UpdateMoodboardInput {\n  name?: string\n  description?: string | null\n  images?: MoodboardImage[]\n}\n\nexport interface ListMoodboardsParams {\n  /** Page size, 1–100 (server default 50). */\n  limit?: number\n  /** The previous page's `nextCursor`. */\n  cursor?: string\n}\n\nexport interface MoodboardPage {\n  data: Moodboard[]\n  /** Pass back as `cursor` for the next page; `null` on the last one. */\n  nextCursor: string | null\n}\n\n/** The prefix of a moodboard's generate-image direction id (`direction.style`). */\nexport const MOODBOARD_DIRECTION_PREFIX = \"moodboard:\" as const\n\n/**\n * A moodboard as a generate-image direction value — put it on\n * `direction.style`. The run puts its description into the prompt and sends\n * its images as style references after your own references, up to the\n * model's reference limit (the answer's `warnings` says when some did not\n * fit). The job keeps the id.\n */\nexport function moodboardDirectionId(id: string): `moodboard:${string}` {\n  return `${MOODBOARD_DIRECTION_PREFIX}${id}`\n}\n\n/**\n * Moodboards — `GET/POST /v1/moodboards`, `GET/PATCH/DELETE /v1/moodboards/:id`.\n *\n * Yours only (another person's id answers 404). Use one on generate-image as\n * `direction: { style: moodboardDirectionId(id) }`. OAuth app tokens need\n * `assets:read` for reads and `assets:write` for writes.\n */\nexport class MoodboardsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** Your moodboards, newest first. Page with `nextCursor`. */\n  list(params: ListMoodboardsParams = {}): Promise<MoodboardPage> {\n    return this.client.request<MoodboardPage>(\"GET\", \"/v1/moodboards\", {\n      query: { limit: params.limit, cursor: params.cursor },\n    })\n  }\n\n  get(id: string): Promise<Moodboard> {\n    return this.client.request<Moodboard>(\"GET\", `/v1/moodboards/${encodeURIComponent(id)}`)\n  }\n\n  create(input: CreateMoodboardInput): Promise<Moodboard> {\n    return this.client.request<Moodboard>(\"POST\", \"/v1/moodboards\", { body: input })\n  }\n\n  update(id: string, input: UpdateMoodboardInput): Promise<Moodboard> {\n    return this.client.request<Moodboard>(\"PATCH\", `/v1/moodboards/${encodeURIComponent(id)}`, { body: input })\n  }\n\n  /** Deletes the moodboard only; the images it links to are untouched. */\n  async delete(id: string): Promise<void> {\n    await this.client.request<{ success: true }>(\"DELETE\", `/v1/moodboards/${encodeURIComponent(id)}`)\n  }\n}\n"]}

package/dist/chunk-ZE5RISBZ.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=chunk-ZE5RISBZ.cjs.map
+//# sourceMappingURL=chunk-ZE5RISBZ.cjs.map

package/dist/chunk-ZE5RISBZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-ZE5RISBZ.cjs"}

package/dist/chunk-ZH4F2P2G.js

@@ -0,0 +1,3 @@
+export { unwrapEditPlanOutput } from '@nodaro/shared/edl';
+//# sourceMappingURL=chunk-ZH4F2P2G.js.map
+//# sourceMappingURL=chunk-ZH4F2P2G.js.map

package/dist/chunk-ZH4F2P2G.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-ZH4F2P2G.js","sourcesContent":[]}

package/dist/chunk-ZJGFLJ2Z.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=chunk-ZJGFLJ2Z.cjs.map
+//# sourceMappingURL=chunk-ZJGFLJ2Z.cjs.map

package/dist/chunk-ZJGFLJ2Z.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-ZJGFLJ2Z.cjs"}

package/dist/chunk-ZKBHD27K.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=chunk-ZKBHD27K.cjs.map
+//# sourceMappingURL=chunk-ZKBHD27K.cjs.map

package/dist/chunk-ZKBHD27K.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-ZKBHD27K.cjs"}

package/dist/chunk-ZQPLRNKX.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=chunk-ZQPLRNKX.cjs.map
+//# sourceMappingURL=chunk-ZQPLRNKX.cjs.map

package/dist/chunk-ZQPLRNKX.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-ZQPLRNKX.cjs"}

package/dist/chunk-ZQQABQMH.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+// src/resources/uploads.ts
+var UploadsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Upload one file (`POST /v1/upload`, multipart — the file rides the `file`
+   * field). The SDK's `request` detects the `FormData` body and lets the
+   * runtime set the multipart boundary. Returns the persisted asset's public
+   * URL + storage metadata (unwraps the `{ data }` envelope). Throws
+   * `StorageExceededError` (413) over the storage cap and the SDK's other typed
+   * errors on the usual statuses.
+   */
+  async upload(file) {
+    const form = new FormData();
+    form.append("file", file);
+    const res = await this.client.request(
+      "POST",
+      "/v1/upload",
+      { body: form }
+    );
+    return res.data;
+  }
+};
+
+exports.UploadsResource = UploadsResource;
+//# sourceMappingURL=chunk-ZQQABQMH.cjs.map
+//# sourceMappingURL=chunk-ZQQABQMH.cjs.map

package/dist/chunk-ZQQABQMH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/uploads.ts"],"names":[],"mappings":";;;AA4BO,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUpB,MAAM,OAAO,IAAA,EAAmC;AAC9C,IAAA,MAAM,IAAA,GAAO,IAAI,QAAA,EAAS;AAC1B,IAAA,IAAA,CAAK,MAAA,CAAO,QAAQ,IAAI,CAAA;AACxB,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA;AAAA,MAC5B,MAAA;AAAA,MACA,YAAA;AAAA,MACA,EAAE,MAAM,IAAA;AAAK,KACf;AACA,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AACF","file":"chunk-ZQQABQMH.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Result of a successful `POST /v1/upload`. Mirrors the route's `data` envelope\n * (`backend/src/routes/upload.ts`), the source of truth — keep in sync if that\n * response changes. The route also returns loosely-typed extracted `metadata`;\n * it is omitted here until a consumer needs a typed shape (add it shaped to\n * that need rather than inventing `Record<string, unknown>` surface now).\n */\nexport interface UploadResult {\n  /** Public R2 URL of the stored asset (always present on success). */\n  readonly url: string\n  /** Storage row id; `null` when no asset row was written (e.g. unauthenticated). */\n  readonly assetId: string | null\n  /** Generated thumbnail URL (images/video); `null` for audio or on failure. */\n  readonly thumbnailUrl: string | null\n  /** Server-classified asset category (e.g. \"image\" | \"video\" | \"audio\"). */\n  readonly category: string\n  /** Display filename (server override or the original). */\n  readonly filename: string\n  /** Final MIME type after server normalization. */\n  readonly mimeType: string\n  /** Stored byte size. */\n  readonly sizeBytes: number\n  /** R2 object key. */\n  readonly r2Key: string\n}\n\nexport class UploadsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Upload one file (`POST /v1/upload`, multipart — the file rides the `file`\n   * field). The SDK's `request` detects the `FormData` body and lets the\n   * runtime set the multipart boundary. Returns the persisted asset's public\n   * URL + storage metadata (unwraps the `{ data }` envelope). Throws\n   * `StorageExceededError` (413) over the storage cap and the SDK's other typed\n   * errors on the usual statuses.\n   */\n  async upload(file: File): Promise<UploadResult> {\n    const form = new FormData()\n    form.append(\"file\", file)\n    const res = await this.client.request<{ data: UploadResult }>(\n      \"POST\",\n      \"/v1/upload\",\n      { body: form },\n    )\n    return res.data\n  }\n}\n"]}

package/dist/chunk-ZXJQSFIA.js

@@ -0,0 +1,200 @@
+// src/resources/workflows.ts
+var WorkflowCollaboratorsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** List a workflow's collaborators (id, name, avatar, role — never email). */
+  list(workflowId) {
+    return this.client.request(
+      "GET",
+      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators`
+    );
+  }
+  /** Add a collaborator by `userId` OR `email` (exactly one), at the given role. */
+  add(workflowId, input) {
+    return this.client.request(
+      "POST",
+      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators`,
+      { body: input }
+    );
+  }
+  /** Change a collaborator's role. */
+  update(workflowId, userId, input) {
+    return this.client.request(
+      "PATCH",
+      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators/${encodeURIComponent(userId)}`,
+      { body: input }
+    );
+  }
+  /** Remove a collaborator — or yourself. Returns `{ success: true }`. */
+  remove(workflowId, userId) {
+    return this.client.request(
+      "DELETE",
+      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators/${encodeURIComponent(userId)}`
+    );
+  }
+};
+var WorkflowsResource = class {
+  constructor(client) {
+    this.client = client;
+    this.collaborators = new WorkflowCollaboratorsResource(client);
+  }
+  client;
+  /** The people this workflow is shared with. See {@link WorkflowCollaboratorsResource}. */
+  collaborators;
+  /** List workflows for a project. Returns metadata only — `nodes`/`edges` are not included. */
+  list(params) {
+    return this.client.request(
+      "GET",
+      `/v1/projects/${encodeURIComponent(params.projectId)}/workflows`
+    );
+  }
+  /** Get a workflow including its full nodes/edges/settings. */
+  get(id) {
+    return this.client.request("GET", `/v1/workflows/${encodeURIComponent(id)}`);
+  }
+  /**
+   * Get a PUBLICLY-SHARED workflow by id (`GET /v1/public/workflows/:id`) — the
+   * unauthenticated share-by-link read. Returns the workflow's nodes/edges/
+   * settings ONLY when it's opted into sharing server-side (`settings.studio.shared
+   * === true`); otherwise the route 404s (→ `NotFoundError`). No auth required —
+   * a share viewer has no session; the SDK omits the bearer when no token exists.
+   */
+  getPublic(id) {
+    return this.client.request("GET", `/v1/public/workflows/${encodeURIComponent(id)}`);
+  }
+  /**
+   * Create a workflow under a project. Returns the full record.
+   * NOTE: server route is `POST /v1/projects/:projectId/workflows`.
+   */
+  create(input) {
+    const { projectId, ...body } = input;
+    return this.client.request(
+      "POST",
+      `/v1/projects/${encodeURIComponent(projectId)}/workflows`,
+      { body }
+    );
+  }
+  /** Patch a workflow. Returns the full updated record. */
+  update(id, input) {
+    return this.client.request(
+      "PATCH",
+      `/v1/workflows/${encodeURIComponent(id)}`,
+      { body: input }
+    );
+  }
+  /** Delete a workflow. Returns `{ success: true }`. Throws `NotFoundError`
+   *  when the id doesn't exist or isn't yours (the delete is not silent). */
+  delete(id) {
+    return this.client.request("DELETE", `/v1/workflows/${encodeURIComponent(id)}`);
+  }
+  /**
+   * Run a workflow. Returns the executionId for polling via
+   * `client.executions.get(executionId)`.
+   */
+  run(id, params = {}, options) {
+    return this.client.request(
+      "POST",
+      `/v1/workflows/${encodeURIComponent(id)}/run`,
+      {
+        body: params,
+        ...options?.idempotencyKey ? { headers: { "Idempotency-Key": options.idempotencyKey } } : {}
+      }
+    );
+  }
+  /**
+   * Render final (`renderFinal` on `POST /v1/workflows/:id/run`): run the
+   * render at Final for this run only, and every node after it, continuing the
+   * execution that stopped at its preview. The server derives the nodes and
+   * the override — send nothing else. Quote it first with
+   * {@link estimateRenderFinal}. Refused with `render_final_node_not_found`,
+   * `render_final_not_a_render`, or a continuation code (see `run`); a run
+   * its payer cannot cover throws `InsufficientCreditsError` (with `required`
+   * and, when it is yours to see, `available`) before any execution exists.
+   */
+  renderFinal(id, params) {
+    return this.client.request("POST", `/v1/workflows/${encodeURIComponent(id)}/run`, {
+      body: {
+        renderFinal: { renderNodeId: params.renderNodeId },
+        continueFromExecutionId: params.continueFromExecutionId
+      }
+    });
+  }
+  /**
+   * Quote a Render final (`POST /v1/workflows/:id/render-final/estimate`): the
+   * nodes it will run, the override it runs with and its estimated credits.
+   * Nothing is created or charged.
+   */
+  estimateRenderFinal(id, params) {
+    return this.client.request("POST", `/v1/workflows/${encodeURIComponent(id)}/render-final/estimate`, {
+      body: { renderNodeId: params.renderNodeId, continueFromExecutionId: params.continueFromExecutionId }
+    });
+  }
+  /**
+   * Export a workflow as a portable JSON bundle.
+   * Pass `opts.assets = true` to include character/object/location entity data.
+   */
+  export(workflowId, opts) {
+    return this.client.request(
+      "GET",
+      `/v1/workflows/${encodeURIComponent(workflowId)}/export`,
+      { query: { assets: opts?.assets ?? false } }
+    );
+  }
+  /**
+   * Import a `WorkflowExport` bundle into the specified project.
+   * Re-creates any bundled assets (characters, objects, creatures, locations)
+   * under your account, and re-points BOTH the entity nodes and every `@`-chip
+   * (`ConnectedReference`) bound in the graph at the rows it created.
+   * Media the bundle references on other hosts is copied onto this instance's
+   * storage where reachable; a bundled entity's images are copied whoever
+   * hosts them, because they are the exporter's bytes and their lifecycle is
+   * not yours. `importReport` says what was copied, what could not be reached
+   * and what was skipped (and why); `assetIdMap` maps each bundled entity id
+   * to the row created for it (for chips you hold outside the graph), and
+   * `assetsSkipped` names the entities your storage quota left uncreated —
+   * the workflow itself still lands.
+   */
+  import(input) {
+    const { projectId, ...workflowJson } = input;
+    return this.client.request("POST", "/v1/workflows/import", {
+      body: { projectId, workflow_json: workflowJson }
+    });
+  }
+  /**
+   * Set a workflow's visibility — `"private"` (creator + explicit collaborators)
+   * or `"workspace"` (everyone in its workspace). Only the creator or a workspace
+   * admin may change it; anyone else gets HTTP 403. Thin wrapper over `update()`:
+   * the visibility lever lives on `PATCH /v1/workflows/:id`.
+   */
+  setVisibility(id, visibility) {
+    return this.client.request("PATCH", `/v1/workflows/${encodeURIComponent(id)}`, {
+      body: { visibility }
+    });
+  }
+  /**
+   * Move a workflow to another project (`POST /v1/workflows/:id/move`); its folder
+   * is cleared. When the move takes the workflow out of a workspace, collaborator
+   * grants that came from that workspace are dropped and returned as
+   * `droppedCollaborators`.
+   */
+  move(id, params) {
+    return this.client.request("POST", `/v1/workflows/${encodeURIComponent(id)}/move`, {
+      body: params
+    });
+  }
+  /**
+   * Workflows other people shared with you (`GET /v1/workflows/shared-with-me`) —
+   * grants on work that is NOT in a workspace you belong to (workspace work already
+   * shows in that workspace's own lists). Each carries the `grantedRole` you hold.
+   * Empty when the organizations feature is off server-side.
+   */
+  sharedWithMe() {
+    return this.client.request("GET", "/v1/workflows/shared-with-me");
+  }
+};
+
+export { WorkflowsResource };
+//# sourceMappingURL=chunk-ZXJQSFIA.js.map
+//# sourceMappingURL=chunk-ZXJQSFIA.js.map

package/dist/chunk-ZXJQSFIA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/workflows.ts"],"names":[],"mappings":"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","file":"chunk-ZXJQSFIA.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type {\n  GenericNode,\n  GenericEdge,\n} from \"@nodaro/shared/types\"\nimport type {\n  WorkflowExport,\n  WorkflowImportReport,\n} from \"@nodaro/shared/workflow\"\nimport type {\n  WorkflowVisibility,\n  CollaboratorRole,\n} from \"@nodaro/shared/organizations\"\n\n/**\n * Workflow metadata + (when fetched as a single record) full nodes/edges/settings.\n *\n * The list endpoint returns metadata only; `get`, `create`, and `update` return the\n * full record. `nodes`, `edges`, `settings`, and `sourcePrompt` are present only on\n * full records and omitted in list responses.\n */\nexport interface Workflow {\n  id: string\n  projectId: string | null\n  userId: string\n  name: string\n  description?: string | null\n  folderId?: string | null\n  isTemplate?: boolean\n  version?: number\n  thumbnailUrl?: string | null\n  nodes?: GenericNode[]\n  edges?: GenericEdge[]\n  settings?: Record<string, unknown>\n  sourcePrompt?: string | null\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface ListWorkflowsParams {\n  /** Required — list endpoint is `/v1/projects/:projectId/workflows`. */\n  projectId: string\n}\n\nexport interface CreateWorkflowInput {\n  /** Required — workflow is created under this project. */\n  projectId: string\n  name: string\n  description?: string\n  folderId?: string | null\n  nodes?: GenericNode[]\n  edges?: GenericEdge[]\n  settings?: Record<string, unknown>\n  sourcePrompt?: string\n}\n\nexport interface UpdateWorkflowInput {\n  name?: string\n  description?: string\n  folderId?: string | null\n  nodes?: GenericNode[]\n  edges?: GenericEdge[]\n  settings?: Record<string, unknown>\n  sourcePrompt?: string\n  thumbnailUrl?: string | null\n  /**\n   * Optimistic concurrency: the `updatedAt` your copy of the workflow was\n   * loaded with. When the row has since been written by another tab/device,\n   * the update is rejected with HTTP 409 `workflow_conflict`\n   * (`WorkflowConflictError`) carrying the current record — re-read/merge and\n   * retry instead of last-writer-wins clobbering the other writer's changes.\n   * Omit for the legacy unconditional replace.\n   */\n  expectedUpdatedAt?: string\n  /**\n   * Optimistic concurrency by monotonic version — preferred over\n   * `expectedUpdatedAt` (integer bumped by the DB on every content change).\n   */\n  expectedVersion?: number\n}\n\nexport interface RunWorkflowParams {\n  /**\n   * Optional subset of node IDs to execute. Omit to run the full workflow.\n   * With `continueMode: \"from-failed\"`, the nodes to consider (default: the\n   * nodes the run's chain was first started on, plus every node left failed or\n   * held back; see `continueMode`); the run executes only those the failed run\n   * did not complete. Every id sent counts as named: a node of work no run of\n   * the chain ever ran (each only handed on its saved results) runs and is\n   * priced, while a source, trigger, parameter picker or container keeps what\n   * the run handed on and a node set to skip never runs.\n   */\n  nodeIds?: string[]\n  /**\n   * Per-node field overrides for this run only, `{ [nodeId]: { field: value } }`,\n   * shallow-merged over each node's saved data (the node's saved results are\n   * not used). A run through the API has nobody to review a Preview render, so\n   * a workflow whose Apply EDL render is set to Preview is refused\n   * (`preview_review_required`) unless the run sets it to Final:\n   * `{ [renderNodeId]: { quality: \"final\" } }`. A node with Review before\n   * render on (Tighten Episode, Trailer) is refused the same way (turn its\n   * review off). A failed execution records what held it —\n   * `preview_review_required` / `preview_render_nested` (a render),\n   * `…_review_on` (a review-on node) or `…_mixed` (both); match all six with\n   * `isPreviewRefusalCode` from `@nodaro/shared`. A review-on Tighten Episode\n   * fed by a List is refused with `use_case_review_list_driven`; a Trailer fed\n   * by a List, with `use_case_list_driven`.\n   */\n  inputOverrides?: Record<string, Record<string, unknown>>\n  /**\n   * Continue from an earlier execution of this workflow — Render final after a\n   * run that stopped at its preview, or (with `continueMode: \"from-failed\"`) a\n   * failed run from where it stopped. The run executes `nodeIds` only\n   * (required with this field, except with `continueMode`); every other node\n   * hands on what that execution produced, not the workflow's saved results,\n   * and an Edit Plan hands on its plan with the person's review applied. The\n   * execution must be your own `completed` run of this workflow (`failed`,\n   * with `continueMode`), not of a published app version. Refused with\n   * `continuation_subset_required`, `continuation_not_found` (404),\n   * `continuation_workflow_mismatch`, `continuation_version_mismatch` or\n   * `continuation_not_completed` (409). A continuation its payer cannot cover\n   * (with or without `continueMode`, priced on the nodes it runs) throws\n   * `InsufficientCreditsError` before any execution exists, checked as a\n   * {@link WorkflowsResource.renderFinal} is.\n   */\n  continueFromExecutionId?: string\n  /**\n   * `\"from-failed\"`: continue a FAILED run (`continueFromExecutionId`) from\n   * where it stopped. It runs every node that run did not complete — of\n   * `nodeIds`, which default to the nodes the run was started on (a run\n   * started on named nodes is continued on those, a run of every node on every\n   * node; a continuation of a continuation keeps those of the first run of its\n   * chain) plus every node the run left failed or held back — and hands on\n   * what it completed,\n   * never run or charged again. That is per node: a node that failed runs\n   * again in full, every list item included. When a later continuation of it\n   * completed only part of what it left (a narrower `nodeIds`), the run builds\n   * on the newest such one: it is seeded from that run and runs only what is\n   * still left ({@link RunWorkflowResult.continuedFrom} names it). A node\n   * `nodeIds` names that no run of the chain ever ran runs too, and is priced\n   * (see `nodeIds`). A Render\n   * final, or a run of named nodes, continuing the newest of those counts as\n   * one of them too. Not combinable with {@link renderFinal}. Refused with\n   * `continuation_not_failed` (409) for a run that did not fail,\n   * `continuation_superseded` (409) when a later continuation supersedes it —\n   * the message names that run: one that failed (continue that one instead),\n   * or one that completed all this run left (the work is done, and its results\n   * are on that run) — `continuation_preview_pending` (409, a\n   * `ContinuationPreviewPendingError`) when the newest later continuation\n   * stopped at a Preview review of a render or of a Tighten Episode (the error\n   * names that run, what holds it, and in `next` the run that finishes it:\n   * `client.workflows.run(workflowId, error.next)` first — for a single render,\n   * its {@link renderFinal}), and\n   * `continuation_subset_required` (409) when nothing is left to run. Send an\n   * {@link RunWorkflowOptions.idempotencyKey} with each continuation.\n   */\n  continueMode?: \"from-failed\"\n}\n\n/** Per-call options for {@link WorkflowsResource.run}. */\nexport interface RunWorkflowOptions {\n  /**\n   * Sent as the `Idempotency-Key` header (at least 8 characters; the server\n   * ignores a shorter one). Reuse the same value when retrying the same\n   * request: the server answers the run it already started (`deduped: true`)\n   * instead of starting a second one — or, once that run is under way or has\n   * superseded the one it continued, refuses with `already_running` (an\n   * `AlreadyRunningError` carrying its `executionId`) or\n   * `continuation_superseded` naming it. Either way nothing runs twice.\n   */\n  idempotencyKey?: string\n}\n\nexport interface RunWorkflowResult {\n  executionId: string\n  status: \"pending\" | \"running\"\n  /** `true` when an `idempotencyKey` retry found the run already started: `executionId` is that run. */\n  deduped?: boolean\n  /**\n   * With `continueMode: \"from-failed\"`: the execution the run continued from —\n   * its states seed the run. The run asked for (`continueFromExecutionId`), or\n   * the newest later continuation of it that completed part of what it left.\n   * Absent on any other run, and on a `deduped` answer.\n   */\n  continuedFrom?: string\n}\n\n/**\n * A Render final: the Apply EDL render at Final for this run only, and every\n * node after it (Camera Switch first, in multicam). The server works out which\n * nodes run — the same rule as the editor's Render final button.\n */\nexport interface RenderFinalParams {\n  /** The Apply EDL render node to finalize. */\n  renderNodeId: string\n  /**\n   * The execution that stopped at the preview: your own `completed` run of\n   * this workflow. Every node the Render final does not run hands on what it\n   * produced (an Edit Plan hands on its plan with the review applied).\n   */\n  continueFromExecutionId: string\n}\n\n/** What a Render final will run and charge. Nothing is created by the quote. */\nexport interface RenderFinalQuote {\n  renderNodeId: string\n  /** The nodes the run executes, in canvas order. */\n  nodeIds: string[]\n  /** The one-shot override it runs with: `{ [renderNodeId]: { quality: \"final\" } }`. */\n  inputOverrides: Record<string, Record<string, unknown>>\n  /** Estimated credits; `null` in an edition without credits. */\n  estimatedCredits: number | null\n  /**\n   * Whether the payer can cover `estimatedCredits`; `null` in an edition\n   * without credits. When `false`, {@link WorkflowsResource.renderFinal} is\n   * refused with `InsufficientCreditsError` before any execution exists.\n   */\n  sufficient: boolean | null\n  /**\n   * The payer's spendable credits; `null` when it is not yours to see (a\n   * deployment's operator pays) or a workspace budget pays.\n   */\n  available: number | null\n}\n\n/** A person granted access to a workflow. Email is never returned (privacy). */\nexport interface Collaborator {\n  userId: string\n  name?: string | null\n  avatar?: string | null\n  role: CollaboratorRole\n}\n\nexport interface AddCollaboratorInput {\n  /** Provide exactly one of `userId` or `email`. */\n  userId?: string\n  email?: string\n  role: CollaboratorRole\n}\n\n/** A workflow someone else shared with you, plus the role you hold on it. */\nexport interface SharedWorkflow extends Workflow {\n  grantedRole: CollaboratorRole\n}\n\n/** A grant dropped because a move took the workflow out of the workspace the\n *  access came from. */\nexport interface DroppedCollaborator {\n  userId: string\n  name: string | null\n}\n\n/**\n * The people a workflow is shared with — reached as `client.workflows.collaborators`.\n * All four endpoints are served by the organizations feature and exist only when\n * it is enabled server-side; against an install without it they 404\n * (→ `NotFoundError`). The active workspace travels on the request like every\n * other call, so a workspace admin's grants apply automatically.\n */\nexport class WorkflowCollaboratorsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** List a workflow's collaborators (id, name, avatar, role — never email). */\n  list(workflowId: string): Promise<{ data: Collaborator[] }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators`,\n    )\n  }\n\n  /** Add a collaborator by `userId` OR `email` (exactly one), at the given role. */\n  add(\n    workflowId: string,\n    input: AddCollaboratorInput,\n  ): Promise<{ data: { userId: string; role: CollaboratorRole } }> {\n    return this.client.request(\n      \"POST\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators`,\n      { body: input },\n    )\n  }\n\n  /** Change a collaborator's role. */\n  update(\n    workflowId: string,\n    userId: string,\n    input: { role: CollaboratorRole },\n  ): Promise<{ data: { userId: string; role: CollaboratorRole } }> {\n    return this.client.request(\n      \"PATCH\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators/${encodeURIComponent(userId)}`,\n      { body: input },\n    )\n  }\n\n  /** Remove a collaborator — or yourself. Returns `{ success: true }`. */\n  remove(workflowId: string, userId: string): Promise<{ success: true }> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators/${encodeURIComponent(userId)}`,\n    )\n  }\n}\n\nexport class WorkflowsResource {\n  /** The people this workflow is shared with. See {@link WorkflowCollaboratorsResource}. */\n  readonly collaborators: WorkflowCollaboratorsResource\n\n  constructor(private client: NodaroClientCore) {\n    this.collaborators = new WorkflowCollaboratorsResource(client)\n  }\n\n  /** List workflows for a project. Returns metadata only — `nodes`/`edges` are not included. */\n  list(params: ListWorkflowsParams): Promise<{ data: Workflow[] }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/projects/${encodeURIComponent(params.projectId)}/workflows`,\n    )\n  }\n\n  /** Get a workflow including its full nodes/edges/settings. */\n  get(id: string): Promise<{ data: Workflow }> {\n    return this.client.request(\"GET\", `/v1/workflows/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Get a PUBLICLY-SHARED workflow by id (`GET /v1/public/workflows/:id`) — the\n   * unauthenticated share-by-link read. Returns the workflow's nodes/edges/\n   * settings ONLY when it's opted into sharing server-side (`settings.studio.shared\n   * === true`); otherwise the route 404s (→ `NotFoundError`). No auth required —\n   * a share viewer has no session; the SDK omits the bearer when no token exists.\n   */\n  getPublic(id: string): Promise<{ data: Workflow }> {\n    return this.client.request(\"GET\", `/v1/public/workflows/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Create a workflow under a project. Returns the full record.\n   * NOTE: server route is `POST /v1/projects/:projectId/workflows`.\n   */\n  create(input: CreateWorkflowInput): Promise<{ data: Workflow }> {\n    const { projectId, ...body } = input\n    return this.client.request(\n      \"POST\",\n      `/v1/projects/${encodeURIComponent(projectId)}/workflows`,\n      { body },\n    )\n  }\n\n  /** Patch a workflow. Returns the full updated record. */\n  update(id: string, input: UpdateWorkflowInput): Promise<{ data: Workflow }> {\n    return this.client.request(\n      \"PATCH\",\n      `/v1/workflows/${encodeURIComponent(id)}`,\n      { body: input },\n    )\n  }\n\n  /** Delete a workflow. Returns `{ success: true }`. Throws `NotFoundError`\n   *  when the id doesn't exist or isn't yours (the delete is not silent). */\n  delete(id: string): Promise<{ success: true }> {\n    return this.client.request(\"DELETE\", `/v1/workflows/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Run a workflow. Returns the executionId for polling via\n   * `client.executions.get(executionId)`.\n   */\n  run(id: string, params: RunWorkflowParams = {}, options?: RunWorkflowOptions): Promise<RunWorkflowResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/workflows/${encodeURIComponent(id)}/run`,\n      {\n        body: params,\n        ...(options?.idempotencyKey ? { headers: { \"Idempotency-Key\": options.idempotencyKey } } : {}),\n      },\n    )\n  }\n\n  /**\n   * Render final (`renderFinal` on `POST /v1/workflows/:id/run`): run the\n   * render at Final for this run only, and every node after it, continuing the\n   * execution that stopped at its preview. The server derives the nodes and\n   * the override — send nothing else. Quote it first with\n   * {@link estimateRenderFinal}. Refused with `render_final_node_not_found`,\n   * `render_final_not_a_render`, or a continuation code (see `run`); a run\n   * its payer cannot cover throws `InsufficientCreditsError` (with `required`\n   * and, when it is yours to see, `available`) before any execution exists.\n   */\n  renderFinal(id: string, params: RenderFinalParams): Promise<RunWorkflowResult> {\n    return this.client.request(\"POST\", `/v1/workflows/${encodeURIComponent(id)}/run`, {\n      body: {\n        renderFinal: { renderNodeId: params.renderNodeId },\n        continueFromExecutionId: params.continueFromExecutionId,\n      },\n    })\n  }\n\n  /**\n   * Quote a Render final (`POST /v1/workflows/:id/render-final/estimate`): the\n   * nodes it will run, the override it runs with and its estimated credits.\n   * Nothing is created or charged.\n   */\n  estimateRenderFinal(id: string, params: RenderFinalParams): Promise<{ data: RenderFinalQuote }> {\n    return this.client.request(\"POST\", `/v1/workflows/${encodeURIComponent(id)}/render-final/estimate`, {\n      body: { renderNodeId: params.renderNodeId, continueFromExecutionId: params.continueFromExecutionId },\n    })\n  }\n\n  /**\n   * Export a workflow as a portable JSON bundle.\n   * Pass `opts.assets = true` to include character/object/location entity data.\n   */\n  export(\n    workflowId: string,\n    opts?: { assets?: boolean },\n  ): Promise<{ data: WorkflowExport }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/workflows/${encodeURIComponent(workflowId)}/export`,\n      { query: { assets: opts?.assets ?? false } },\n    )\n  }\n\n  /**\n   * Import a `WorkflowExport` bundle into the specified project.\n   * Re-creates any bundled assets (characters, objects, creatures, locations)\n   * under your account, and re-points BOTH the entity nodes and every `@`-chip\n   * (`ConnectedReference`) bound in the graph at the rows it created.\n   * Media the bundle references on other hosts is copied onto this instance's\n   * storage where reachable; a bundled entity's images are copied whoever\n   * hosts them, because they are the exporter's bytes and their lifecycle is\n   * not yours. `importReport` says what was copied, what could not be reached\n   * and what was skipped (and why); `assetIdMap` maps each bundled entity id\n   * to the row created for it (for chips you hold outside the graph), and\n   * `assetsSkipped` names the entities your storage quota left uncreated —\n   * the workflow itself still lands.\n   */\n  import(input: WorkflowExport & { projectId: string }): Promise<{ data: Workflow; importReport?: WorkflowImportReport }> {\n    const { projectId, ...workflowJson } = input\n    return this.client.request(\"POST\", \"/v1/workflows/import\", {\n      body: { projectId, workflow_json: workflowJson },\n    })\n  }\n\n  /**\n   * Set a workflow's visibility — `\"private\"` (creator + explicit collaborators)\n   * or `\"workspace\"` (everyone in its workspace). Only the creator or a workspace\n   * admin may change it; anyone else gets HTTP 403. Thin wrapper over `update()`:\n   * the visibility lever lives on `PATCH /v1/workflows/:id`.\n   */\n  setVisibility(id: string, visibility: WorkflowVisibility): Promise<{ data: Workflow }> {\n    return this.client.request(\"PATCH\", `/v1/workflows/${encodeURIComponent(id)}`, {\n      body: { visibility },\n    })\n  }\n\n  /**\n   * Move a workflow to another project (`POST /v1/workflows/:id/move`); its folder\n   * is cleared. When the move takes the workflow out of a workspace, collaborator\n   * grants that came from that workspace are dropped and returned as\n   * `droppedCollaborators`.\n   */\n  move(\n    id: string,\n    params: { projectId: string },\n  ): Promise<{ data: Workflow; droppedCollaborators: DroppedCollaborator[] }> {\n    return this.client.request(\"POST\", `/v1/workflows/${encodeURIComponent(id)}/move`, {\n      body: params,\n    })\n  }\n\n  /**\n   * Workflows other people shared with you (`GET /v1/workflows/shared-with-me`) —\n   * grants on work that is NOT in a workspace you belong to (workspace work already\n   * shows in that workspace's own lists). Each carries the `grantedRole` you hold.\n   * Empty when the organizations feature is off server-side.\n   */\n  sharedWithMe(): Promise<{ data: SharedWorkflow[] }> {\n    return this.client.request(\"GET\", \"/v1/workflows/shared-with-me\")\n  }\n}\n"]}