@usenaive-sdk/managed-agents 0.12.0 → 0.12.2

package/dist/index.js

@@ -466,6 +466,8 @@ var LedgerEntrySchema = z2.object({
   session_id: idOf("ses").nullable(),
   agent_id: idOf("agt").nullable(),
   deployment_id: idOf("dep").nullable(),
+  /** The computer (`cmp_`), browser (`brw_`) or phone (`mob_`) a debit bills; `null` for anything else, and from a server older than the field. */
+  resource_id: z2.string().nullable().default(null),
   line_items: z2.array(z2.object({ tier: LineItemTierSchema, amount_micro_usd: MicroUsdField })),
   created_at: Timestamp
 });
@@ -1932,7 +1934,11 @@ var transposed = (a, b) => {
 };
 function toolNameProblem(name) {
   if (BUILTIN_TOOLS.includes(name) || name in FOLLOWS_TOOL || PLATFORM_TOOLS.includes(name)) return null;
-  if (!/^[a-z0-9_-]+(\.[a-z0-9_-]+)+$/i.test(name)) return `\`${name}\` is not a tool: name a built-in, or a namespaced \`<namespace>.<tool>\``;
+  if (!/^[a-z0-9_-]+(\.[a-z0-9_-]+)+$/i.test(name)) {
+    const bare = [...BUILTIN_TOOLS, ...Object.keys(FOLLOWS_TOOL)].find((tool) => transposed(tool, name));
+    const hint = bare === void 0 ? "name a built-in, or a namespaced `<namespace>.<tool>`" : `did you mean \`${bare}\`?`;
+    return `\`${name}\` is not a tool; ${hint}`;
+  }
   const namespace = name.slice(0, name.indexOf("."));
   if (PLATFORM_NAMESPACES.has(namespace)) {
     const known = [...PLATFORM_TOOLS, ...Object.keys(FOLLOWS_TOOL)].filter((tool) => tool.startsWith(`${namespace}.`));
@@ -1943,7 +1949,8 @@ function toolNameProblem(name) {
 }
 var isToolName = (name) => toolNameProblem(name) === null;
 var ToolConfigSchema = z12.object({
-  enabled: z12.boolean(),
+  /** Absent is enabled (ADR-1911): naming a tool to set its permission already says it is wanted. */
+  enabled: z12.boolean().default(true),
   permission: ToolPermissionSchema,
   config: z12.record(z12.string(), z12.unknown()).optional()
 });
@@ -2206,7 +2213,24 @@ var CREATOR_PROGRAM = {
     upload_token_minutes: 15,
     skill_max_bytes: 32 * 1024,
     /** The reviewer's install check (§42.5): the hard cap on its one session, never charged to the draft. */
-    review_check_budget_micro_usd: 5e6
+    review_check_budget_micro_usd: 5e6,
+    /** A `video` origin build (§42.14): one raw clip and its characters, recast by Mira. */
+    video: {
+      min_seconds: 3,
+      max_seconds: 15,
+      video_max_bytes: 95 * 1024 * 1024,
+      image_max_bytes: 10 * 1024 * 1024,
+      characters_min: 1,
+      characters_max: 3,
+      /** After the first render. A refused or failed render does not use one up. */
+      revisions: 5,
+      /** Per doomscroll account, until one of its templates is approved. */
+      unapproved_templates: 2,
+      /** Upload tickets a doomscroll account may ask for, per template. */
+      upload_tickets: 20,
+      /** A draft never submitted loses its source and character bytes this long after `updated_at`. */
+      draft_retention_days: 30
+    }
   }
 };
 var DOOMSCROLL_PROGRAM = {
@@ -2250,6 +2274,8 @@ var StudioStateSchema = z13.enum([
   "setup",
   "building",
   "ready",
+  /** A `video` origin only: a version was submitted and its author is writing the skill. */
+  "finalizing",
   "in_review",
   "live",
   "changes_requested"
@@ -2313,10 +2339,26 @@ var StudioSkillSchema = SavedSkillSchema.extend({
   id: idOf("skl").nullable(),
   version: z13.number().int().positive().nullable()
 });
+var StudioImageContentTypeSchema = z13.enum(["image/png", "image/jpeg", "image/webp"]);
+var StudioSourceVideoSchema = z13.object({
+  file_id: z13.string().nullable(),
+  bytes: z13.number().int().positive().max(CREATOR_PROGRAM.studio.video.video_max_bytes),
+  content_type: StudioUploadContentTypeSchema,
+  filename: z13.string().min(1).max(200),
+  seconds: z13.number().nonnegative().nullable()
+});
+var CharacterPosition = z13.number().int().min(1).max(CREATOR_PROGRAM.studio.video.characters_max);
+var StudioCharacterSchema = z13.object({
+  position: CharacterPosition,
+  file_id: z13.string().nullable(),
+  bytes: z13.number().int().positive().max(CREATOR_PROGRAM.studio.video.image_max_bytes),
+  content_type: StudioImageContentTypeSchema,
+  filename: z13.string().min(1).max(200)
+});
 var CreatorStudioSchema = z13.object({
   uploads: z13.array(StudioUploadSchema).max(CREATOR_PROGRAM.studio.uploads).default([]),
-  /** `links`: built from 1–3 reel links (`imports`), prompts optional; `upload`: the creator's three videos. */
-  origin: z13.enum(["upload", "links"]).default("upload"),
+  /** `links`: built from 1–3 reel links (`imports`), prompts optional; `upload`: the creator's three videos; `video`: one raw clip recast by Mira (§42.14). */
+  origin: z13.enum(["upload", "links", "video"]).default("upload"),
   imports: z13.array(StudioImportSchema).max(CREATOR_PROGRAM.studio.uploads).default([]),
   state: StudioStateSchema.default("setup"),
   spend_micro_usd: MicroUsdField.nonnegative().default(0),
@@ -2327,7 +2369,11 @@ var CreatorStudioSchema = z13.object({
   /** An org build's asked sample length (§57.2, ADR-1762); `null` is `sample_seconds`. */
   seconds: z13.number().int().min(10).max(60).nullable().default(null),
   /** An org build's own catalog text: its request's description when that fits a tagline; `null` lets the judge write one. */
-  tagline: z13.string().max(140).nullable().default(null)
+  tagline: z13.string().max(140).nullable().default(null),
+  /** A `video` origin's raw clip, its characters, and the round submitted (§42.14). */
+  source_video: StudioSourceVideoSchema.nullable().default(null),
+  characters: z13.array(StudioCharacterSchema).max(CREATOR_PROGRAM.studio.video.characters_max).default([]),
+  chosen_round: z13.number().int().positive().nullable().default(null)
 });
 var CreatorTemplateListingSchema = z13.object({
   listed: z13.boolean(),
@@ -2381,7 +2427,15 @@ var CreatorTemplateRoundSchema = z13.object({
   spend_micro_usd: MicroUsdField.nonnegative(),
   error: z13.string().nullable(),
   created_at: Timestamp,
-  finished_at: Timestamp.nullable()
+  finished_at: Timestamp.nullable(),
+  /** A `video` origin round's Mira edit and its result (migration 0172, §42.14). */
+  edit_job_id: z13.string().nullable().default(null),
+  sample_file_id: z13.string().nullable().default(null)
+});
+var StudioPlateSchema = z13.object({
+  file: z13.string().min(1),
+  kind: z13.enum(["video", "image"]),
+  file_id: z13.string().min(1)
 });
 var NicheVersionStudioSchema = z13.object({
   round: z13.number().int().positive(),
@@ -2390,7 +2444,9 @@ var NicheVersionStudioSchema = z13.object({
   frames: z13.array(StudioFrameSchema),
   samples: z13.array(StudioSampleSchema),
   tagline: z13.string().max(140),
-  hero_sample_index: z13.number().int().nonnegative()
+  hero_sample_index: z13.number().int().nonnegative(),
+  /** A `video` origin's default clip and characters. */
+  plates: z13.array(StudioPlateSchema).optional()
 });
 var CreatorTemplateSchema = z13.object({
   id: idOf("ctp"),
@@ -2487,13 +2543,26 @@ var CreatorAnalyticsSchema = z13.object({
   install_windows: z13.array(z13.object({ install_id: idOf("bpi"), from: Day, until: Day })).optional()
 });
 var CreatorTemplateCreateKindSchema = z13.object({
-  kind: CreatorTemplateKindSchema.default("crew")
+  kind: CreatorTemplateKindSchema.default("crew"),
+  /** `video` makes a draft built from one raw clip (§42.14); it needs `kind: niche`. */
+  origin: z13.literal("video").optional()
 });
 var StudioUploadCreateSchema = z13.object({
-  position: UploadPosition,
+  purpose: z13.enum(["source", "character"]).optional(),
+  position: UploadPosition.optional(),
   filename: z13.string().min(1).max(200),
-  content_type: StudioUploadContentTypeSchema,
-  bytes: z13.number().int().positive().max(CREATOR_PROGRAM.studio.upload_max_bytes)
+  content_type: z13.union([StudioUploadContentTypeSchema, StudioImageContentTypeSchema]),
+  bytes: z13.number().int().positive()
+}).superRefine((body, ctx) => {
+  const { video, upload_max_bytes } = CREATOR_PROGRAM.studio;
+  const character = body.purpose === "character";
+  const issue = (path, message) => ctx.addIssue({ code: "custom", path: [path], message });
+  if (body.purpose !== "source" && body.position === void 0) issue("position", "position is required");
+  if (character !== StudioImageContentTypeSchema.safeParse(body.content_type).success) {
+    issue("content_type", character ? "a character must be a PNG, JPEG or WebP image" : "this upload must be an MP4, MOV or WebM video");
+  }
+  const max = character ? video.image_max_bytes : body.purpose === "source" ? video.video_max_bytes : upload_max_bytes;
+  if (body.bytes > max) issue("bytes", `this upload may be at most ${max} bytes`);
 });
 var StudioUploadTicketSchema = z13.object({
   object: z13.literal("studio_upload_ticket"),
@@ -2507,6 +2576,12 @@ var StudioUploadResultSchema = z13.object({
   template_id: idOf("ctp"),
   upload: StudioUploadSchema
 });
+var StudioVideoUploadResultSchema = z13.object({
+  object: z13.literal("studio_upload"),
+  template_id: idOf("ctp"),
+  source_video: StudioSourceVideoSchema.nullable(),
+  characters: z13.array(StudioCharacterSchema)
+});
 var StudioRoundCreateSchema = z13.object({
   feedback: z13.string().min(1).max(4e3).optional(),
   rights_attested: z13.boolean().optional()
@@ -2519,9 +2594,12 @@ var StudioBudgetSchema = z13.object({
 var CreatorStudioViewSchema = z13.object({
   object: z13.literal("creator_studio"),
   template_id: idOf("ctp"),
-  studio: CreatorStudioSchema,
-  /** Newest first. */
-  rounds: z13.array(CreatorTemplateRoundSchema),
+  /** A `video` origin's `source_video` also carries a signed `url` once its bytes landed. */
+  studio: CreatorStudioSchema.extend({
+    source_video: StudioSourceVideoSchema.extend({ url: z13.string().nullable().optional() }).nullable().default(null)
+  }),
+  /** Newest first. A `video` round also carries a signed `sample_url`. */
+  rounds: z13.array(CreatorTemplateRoundSchema.extend({ sample_url: z13.string().nullable().optional() })),
   budget: StudioBudgetSchema
 });
 var NicheSubmitSchema = z13.object({
@@ -2531,6 +2609,7 @@ var NicheSubmitSchema = z13.object({
     hero_sample_index: z13.number().int().nonnegative()
   })
 });
+var VideoSubmitSchema = z13.object({ round: z13.number().int().positive() });
 var CreatorListingPatchSchema = CreatorTemplateListingSchema.partial();
 var CreatorListingSchema = z13.object({
   object: z13.literal("creator_listing"),
@@ -2758,6 +2837,10 @@ var EventTypeSchema = z16.enum([
   "span.harness_build.end",
   "span.box_resume.start",
   "span.box_resume.end",
+  "span.tools_resolve.start",
+  "span.tools_resolve.end",
+  "span.model_gate.start",
+  "span.model_gate.end",
   /**
    * A delegated thread's lifecycle, on the **coordinator's** stream (§28). The child's own
    * `ses_…` rides inside `data.thread_id` — the event schema gains no field and `vetta.event` gains
@@ -4392,11 +4475,12 @@ var MusicGenerationSchema = z33.object({
   duration_seconds: Seconds2.nullable(),
   cost_micro_usd: MicroUsdField
 });
+var EditModeSchema = z33.enum(["scene", "outfit_or_object", "person_swap", "recast"]);
 var EditRequestSchema = z33.object({
   video: z33.string().min(1),
   prompt: z33.string().min(1).max(1e3),
   references: z33.array(z33.string().min(1)).max(4).optional(),
-  mode: z33.enum(["scene", "outfit_or_object", "person_swap"]).optional()
+  mode: EditModeSchema.optional()
 });
 var EditFailureCodeSchema = z33.enum(["bad_source", "refused", "timed_out", "provider_error", "cancelled"]);
 var EditJobSchema = z33.object({
@@ -4406,7 +4490,7 @@ var EditJobSchema = z33.object({
   video: z33.string(),
   prompt: z33.string(),
   references: z33.array(z33.string()),
-  mode: z33.enum(["scene", "outfit_or_object", "person_swap"]).nullable(),
+  mode: EditModeSchema.nullable(),
   result: z33.object({ file_id: z33.string().startsWith("fil_") }).nullable(),
   error: z33.object({ code: EditFailureCodeSchema, message: z33.string() }).nullable(),
   cost_micro_usd: MicroUsdField.nullable(),
@@ -5444,6 +5528,11 @@ function tolerantPage(item) {
   });
 }
 var DOT_SEGMENT = /^(?:\.|%2e){1,2}$/i;
+function pathId(value, name) {
+  if (value !== void 0 && value !== null && String(value) !== "") return encodeURIComponent(value);
+  const message = `${name} is required`;
+  throw new ApiError(400, { type: "invalid_request", code: "validation_failed", message, param: name, request_id: "" });
+}
 function url(config, call) {
   const segments = call.path.split("/");
   if (segments.some((segment) => DOT_SEGMENT.test(segment)) || segments.at(-1) === "") {
@@ -5496,6 +5585,7 @@ var CODE_BY_STATUS = {
 var BLOCKED_AT_EDGE = "the request was blocked before it reached the API (HTTP 403); this can happen when a request body looks like SQL";
 function unreadableMessage(status) {
   if (status === 403) return BLOCKED_AT_EDGE;
+  if (status === 401) return "HTTP 401: the API key was rejected and the response had no readable details; check the API key and that baseUrl points at the API";
   return `HTTP ${status}: the error response had no readable details`;
 }
 function apiErrorFrom(response, text3) {
@@ -6293,77 +6383,77 @@ var domains = (config) => ({
   delete: (id) => request(config, DeletedSchema, { method: "DELETE", path: `/v1/domains/${encodeURIComponent(id)}` })
 });
 var emails = (config) => ({
-  create: (identityId, body) => request(config, EmailInboxSchema, {
+  create: async (identityId, body) => request(config, EmailInboxSchema, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/emails`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/emails`,
     body
   }),
-  list: (identityId, query2 = {}) => request(config, page(EmailInboxSchema), {
+  list: async (identityId, query2 = {}) => request(config, page(EmailInboxSchema), {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/emails`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/emails`,
     query: query2
   }),
   /** Turn on or off whether mail to the inbox wakes its owner. An inbox from before the wake shipped is off. */
-  update: (identityId, inboxId, body) => request(config, EmailInboxSchema, {
+  update: async (identityId, inboxId, body) => request(config, EmailInboxSchema, {
     method: "PATCH",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/emails/${encodeURIComponent(inboxId)}`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/emails/${encodeURIComponent(inboxId)}`,
     body
   }),
-  delete: (identityId, inboxId) => request(config, DeletedSchema, {
+  delete: async (identityId, inboxId) => request(config, DeletedSchema, {
     method: "DELETE",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/emails/${encodeURIComponent(inboxId)}`
+    path: `/v1/identities/${pathId(identityId, "identityId")}/emails/${encodeURIComponent(inboxId)}`
   }),
   /** Gated on the domain's `dns_status`; a premature send is a retryable `job_not_ready`. */
-  send: (identityId, inboxId, body) => request(config, EmailSendSchema, {
+  send: async (identityId, inboxId, body) => request(config, EmailSendSchema, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/emails/${encodeURIComponent(inboxId)}/send`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/emails/${encodeURIComponent(inboxId)}/send`,
     body
   }),
   /** Everything that arrived for this persona, both channels unless one is named. */
-  messages: (identityId, query2 = {}) => request(config, page(InboundMessageSchema), {
+  messages: async (identityId, query2 = {}) => request(config, page(InboundMessageSchema), {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/messages`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/messages`,
     query: query2
   }),
   /** Mark one arrived message read or unread; a message already read keeps its first time. */
-  markRead: (identityId, messageId, read) => request(config, InboundMessageSchema, {
+  markRead: async (identityId, messageId, read) => request(config, InboundMessageSchema, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/messages/${encodeURIComponent(messageId)}/read`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/messages/${encodeURIComponent(messageId)}/read`,
     body: { read }
   }),
   /** What the persona sent, newest first — through the API and through its agent alike. */
-  sent: (identityId, query2 = {}) => request(config, page(OutboundMessageSchema), {
+  sent: async (identityId, query2 = {}) => request(config, page(OutboundMessageSchema), {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/sent`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/sent`,
     query: query2
   })
 });
 var phones = (config) => ({
   /** 202, not 201: the number exists and can receive, but outbound waits on a carrier decision. */
-  provision: (identityId, body) => request(config, PhoneNumberSchema, {
+  provision: async (identityId, body) => request(config, PhoneNumberSchema, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/phones`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/phones`,
     body
   }),
-  list: (identityId, query2 = {}) => request(config, page(PhoneNumberSchema), {
+  list: async (identityId, query2 = {}) => request(config, page(PhoneNumberSchema), {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/phones`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/phones`,
     query: query2
   }),
   /** Set, or clear with `null`, the agent this number's inbound texts are for. */
-  update: (identityId, phoneId, body) => request(config, PhoneNumberSchema, {
+  update: async (identityId, phoneId, body) => request(config, PhoneNumberSchema, {
     method: "PATCH",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/phones/${encodeURIComponent(phoneId)}`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/phones/${encodeURIComponent(phoneId)}`,
     body
   }),
-  release: (identityId, phoneId) => request(config, DeletedSchema, {
+  release: async (identityId, phoneId) => request(config, DeletedSchema, {
     method: "DELETE",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/phones/${encodeURIComponent(phoneId)}`
+    path: `/v1/identities/${pathId(identityId, "identityId")}/phones/${encodeURIComponent(phoneId)}`
   }),
   /** Refused with `compliance_pending` until the campaign is approved. That is a carrier rule. */
-  send: (identityId, phoneId, body) => request(config, SmsSendSchema, {
+  send: async (identityId, phoneId, body) => request(config, SmsSendSchema, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identityId)}/phones/${encodeURIComponent(phoneId)}/send`,
+    path: `/v1/identities/${pathId(identityId, "identityId")}/phones/${encodeURIComponent(phoneId)}/send`,
     body
   })
 });
@@ -6954,7 +7044,7 @@ var wallet = (config) => {
     updatePolicy: (identity, body, select = {}) => request(config, WalletSchema, { method: "PATCH", path: `/v1/identities/${encodeURIComponent(identity)}/wallet/policy`, body, query: select }),
     freeze: (identity, select = {}) => request(config, WalletSchema, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity)}/wallet/freeze`, query: select }),
     unfreeze: (identity, select = {}) => request(config, WalletSchema, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity)}/wallet/unfreeze`, query: select }),
-    /** The three money moves take an `idempotencyKey` so a retry of one move reuses its key and moves the money once. */
+    /** The money moves (and `pay`) take an `idempotencyKey` so a retry of one move reuses its key and moves the money once. */
     fund: (identity, body, select = {}, opts = {}) => request(config, WalletTransactionSchema, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity)}/wallet/fund`, body, query: select, headers: keyed(opts) }),
     transfer: (identity, body, select = {}, opts = {}) => request(config, WalletTransactionSchema, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity)}/wallet/transfer`, body, query: select, headers: keyed(opts) }),
     sweep: (identity, body = {}, select = {}, opts = {}) => request(config, WalletTransactionSchema, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity)}/wallet/sweep`, body, query: select, headers: keyed(opts) }),
@@ -6966,7 +7056,7 @@ var wallet = (config) => {
       query: { ...query2, kind: "pay" }
     }),
     quote: (identity, body, select = {}) => request(config, WalletQuoteSchema, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity)}/wallet/quote`, body, query: select }),
-    pay: (identity, body, select = {}) => request(config, WalletPaymentSchema, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity)}/wallet/pay`, body, query: select })
+    pay: (identity, body, select = {}, opts = {}) => request(config, WalletPaymentSchema, { method: "POST", path: `/v1/identities/${encodeURIComponent(identity)}/wallet/pay`, body, query: select, headers: keyed(opts) })
   };
 };
 
@@ -7176,65 +7266,65 @@ var SocialWorkspaceSchema = z62.object({
 });
 var SocialPortalSchema = z62.object({ object: z62.literal("social_portal_link"), url: z62.url() });
 var setup = (config) => ({
-  activate: (identity) => request(config, SocialWorkspaceSchema, {
+  activate: async (identity) => request(config, SocialWorkspaceSchema, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identity)}/social/activate`
+    path: `/v1/identities/${pathId(identity, "identity")}/social/activate`
   }),
-  status: (identity) => request(config, SocialWorkspaceSchema, {
+  status: async (identity) => request(config, SocialWorkspaceSchema, {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identity)}/social`
+    path: `/v1/identities/${pathId(identity, "identity")}/social`
   }),
-  portal: (identity, body = {}) => request(config, SocialPortalSchema, {
+  portal: async (identity, body = {}) => request(config, SocialPortalSchema, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identity)}/social/portal`,
+    path: `/v1/identities/${pathId(identity, "identity")}/social/portal`,
     body
   }),
-  accounts: (identity, query2 = {}) => request(config, page(SocialAccountSchema), {
+  accounts: async (identity, query2 = {}) => request(config, page(SocialAccountSchema), {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identity)}/social/accounts`,
+    path: `/v1/identities/${pathId(identity, "identity")}/social/accounts`,
     query: query2
   }),
-  accountAnalytics: (identity, account) => request(config, SocialAnalyticsSchema, {
+  accountAnalytics: async (identity, account) => request(config, SocialAnalyticsSchema, {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identity)}/social/accounts/${encodeURIComponent(account)}/analytics`
+    path: `/v1/identities/${pathId(identity, "identity")}/social/accounts/${encodeURIComponent(account)}/analytics`
   }),
-  upload: (identity, body) => request(config, SocialUploadSchema, {
+  upload: async (identity, body) => request(config, SocialUploadSchema, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identity)}/social/uploads`,
+    path: `/v1/identities/${pathId(identity, "identity")}/social/uploads`,
     body
   })
 });
 var publishing = (config) => ({
-  createPost: (identity, body) => request(config, SocialPostSchema, {
+  createPost: async (identity, body) => request(config, SocialPostSchema, {
     method: "POST",
-    path: `/v1/identities/${encodeURIComponent(identity)}/social/posts`,
+    path: `/v1/identities/${pathId(identity, "identity")}/social/posts`,
     body
   }),
-  getPost: (identity, post) => request(config, SocialPostSchema, {
+  getPost: async (identity, post) => request(config, SocialPostSchema, {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identity)}/social/posts/${encodeURIComponent(post)}`
+    path: `/v1/identities/${pathId(identity, "identity")}/social/posts/${encodeURIComponent(post)}`
   }),
-  deletePost: (identity, post) => request(config, DeletedSchema, {
+  deletePost: async (identity, post) => request(config, DeletedSchema, {
     method: "DELETE",
-    path: `/v1/identities/${encodeURIComponent(identity)}/social/posts/${encodeURIComponent(post)}`
+    path: `/v1/identities/${pathId(identity, "identity")}/social/posts/${encodeURIComponent(post)}`
   }),
-  postAnalytics: (identity, post) => request(config, SocialAnalyticsSchema, {
+  postAnalytics: async (identity, post) => request(config, SocialAnalyticsSchema, {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identity)}/social/posts/${encodeURIComponent(post)}/analytics`
+    path: `/v1/identities/${pathId(identity, "identity")}/social/posts/${encodeURIComponent(post)}/analytics`
   }),
   /**
    * `GET /v1/posts` — every post the company files, across identities and sessions (§27.1): the
    * `social.post` calls waiting on a person (`pending`), and the ones sent, with their latest numbers.
    * `reconcile: false` lists what is stored without asking the provider about due posts first.
    */
-  listPosts: ({ reconcile, ...query2 } = {}) => request(config, page(PostSchema), {
+  listPosts: async ({ reconcile, ...query2 } = {}) => request(config, page(PostSchema), {
     method: "GET",
     path: "/v1/posts",
     query: { ...query2, ...reconcile === void 0 ? {} : { reconcile: String(reconcile) } }
   }),
-  comments: (identity, post, query2 = {}) => request(config, page(SocialCommentSchema), {
+  comments: async (identity, post, query2 = {}) => request(config, page(SocialCommentSchema), {
     method: "GET",
-    path: `/v1/identities/${encodeURIComponent(identity)}/social/posts/${encodeURIComponent(post)}/comments`,
+    path: `/v1/identities/${pathId(identity, "identity")}/social/posts/${encodeURIComponent(post)}/comments`,
     query: query2
   })
 });
@@ -7407,10 +7497,10 @@ async function* streamFrames(config, schema, call) {
     yield parsed.data;
   }
 }
-function settled(session, afterSeq, throughGrades) {
-  if (session.status === "running" || session.status === "queued") return false;
-  if (throughGrades && session.stop_reason === "awaiting_delegation") return false;
-  return session.last_seq <= afterSeq;
+function settledAt(session, throughGrades) {
+  if (session.status === "running" || session.status === "queued") return null;
+  if (throughGrades && session.stop_reason === "awaiting_delegation") return null;
+  return session.last_seq;
 }
 async function* streamEvents(config, sessionId, options = {}) {
   const maxRetries = options.maxRetries ?? 5;
@@ -7419,7 +7509,8 @@ async function* streamEvents(config, sessionId, options = {}) {
   let failures = 0;
   const grading = /* @__PURE__ */ new Set();
   let held = false;
-  if (lastSeq > 0 && settled(await sessions(config).get(sessionId), lastSeq, throughGrades)) return;
+  const endAt = lastSeq > 0 ? settledAt(await sessions(config).get(sessionId), throughGrades) : null;
+  if (endAt !== null && endAt <= lastSeq) return;
   for (; ; ) {
     try {
       const call = {
@@ -7437,6 +7528,7 @@ async function* streamEvents(config, sessionId, options = {}) {
         if (event.type === "outcome.evaluation.started") grading.add(gradeKey(event));
         if (event.type === "outcome.evaluation.completed") grading.delete(gradeKey(event));
         yield event;
+        if (endAt !== null && event.seq >= endAt) return;
         if (event.type === "session.idle") {
           held = throughGrades && grading.size > 0 && parkedOnGrade(event);
           if (!held) return;
@@ -7508,7 +7600,7 @@ var computers = (config) => ({
     path: `/v1/computers/${encodeURIComponent(id)}/exec`,
     body: { command, ...timeoutMs === void 0 ? {} : { timeout_ms: timeoutMs } }
   }),
-  /** Paused bills storage only — the first efficiency lever (`memory/context.md`). */
+  /** Paused bills nothing (disk is never metered) — the first efficiency lever (`memory/context.md`). */
   pause: (id) => request(config, ComputerSchema, { method: "POST", path: `/v1/computers/${encodeURIComponent(id)}/pause`, body: {} }),
   resume: (id) => request(config, ComputerSchema, { method: "POST", path: `/v1/computers/${encodeURIComponent(id)}/resume`, body: {} }),
   /** An agent's computer only (§41.8): a person holds it, and its sessions wait until it is handed back. */
@@ -7733,9 +7825,11 @@ function withTool(tools, name, settings) {
 }
 
 // src/index.ts
+var DEFAULT_BASE_URL = "https://api.vetta.sh";
 function createClient(options) {
   const config = {
     ...options,
+    baseUrl: (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "").replace(/\/v1$/, ""),
     fetch: options.fetch ?? ((input, init) => globalThis.fetch(input, init)),
     idempotencyKey: options.idempotencyKey ?? (() => crypto.randomUUID())
   };
@@ -7794,6 +7888,7 @@ function createClient(options) {
 export {
   ApiError,
   CONNECTION_AUTHS,
+  DEFAULT_BASE_URL,
   ResponseParseError,
   SOCIAL_PLATFORMS,
   SOCIAL_TEXT_PLATFORMS,