@boboddy/sdk 0.1.45-alpha → 0.2.3-alpha

package/dist/push/index.js

@@ -11235,7 +11235,7 @@ function finalize(ctx, schema) {
     result.$schema = "http://json-schema.org/draft-07/schema#";
   } else if (ctx.target === "draft-04") {
     result.$schema = "http://json-schema.org/draft-04/schema#";
-  } else if (ctx.target === "openapi-3.0") {} else {}
+  } else if (ctx.target === "openapi-3.0") {}
   if (ctx.external?.uri) {
     const id = ctx.external.registry.get(schema)?.id;
     if (!id)
@@ -11479,7 +11479,7 @@ var literalProcessor = (schema, ctx, json, _params) => {
     if (val === undefined) {
       if (ctx.unrepresentable === "throw") {
         throw new Error("Literal `undefined` cannot be represented in JSON Schema");
-      } else {}
+      }
     } else if (typeof val === "bigint") {
       if (ctx.unrepresentable === "throw") {
         throw new Error("BigInt literals cannot be represented in JSON Schema");
@@ -11984,29 +11984,29 @@ function renderPromptTemplate(template, contextJson) {
 }
 
 // src/definitions/steps/define-step.ts
-var UNWRAP_TYPES = new Set(["optional", "nullable", "default"]);
-function unwrapZodType(schema) {
-  while (UNWRAP_TYPES.has(schema._def.type)) {
-    const inner = schema._def.innerType;
-    if (!inner)
-      break;
-    schema = inner;
+function resolveZodSchemaAtPath(schema, path) {
+  if (!schema)
+    return;
+  const segments = path.split(".");
+  let current = schema;
+  for (const segment of segments) {
+    if (!current)
+      return;
+    current = unwrapZodWrappers(current);
+    const def = current.def;
+    if (!def || def.type !== "object" || !def.shape)
+      return;
+    current = def.shape[segment];
   }
-  return schema;
+  return current;
 }
-function deriveSignalType(schema, path) {
+function zodTypeToSignalType(schema) {
   if (!schema)
-    return "string";
-  let current = unwrapZodType(schema);
-  for (const part of path.split(".")) {
-    if (current._def.type !== "object")
-      return "string";
-    const next = current._def.shape?.[part];
-    if (!next)
-      return "string";
-    current = unwrapZodType(next);
-  }
-  switch (current._def.type) {
+    return;
+  const unwrapped = unwrapZodWrappers(schema);
+  const def = unwrapped.def;
+  const typeName = def?.type;
+  switch (typeName) {
     case "string":
       return "string";
     case "number":
@@ -12016,11 +12016,20 @@ function deriveSignalType(schema, path) {
     case "array":
       return "array";
     case "object":
-    case "record":
       return "object";
     default:
-      return "string";
+      return;
+  }
+}
+function unwrapZodWrappers(schema) {
+  const def = schema.def;
+  if (!def)
+    return schema;
+  if (def.type === "optional" || def.type === "nullable" || def.type === "default" || def.type === "catch") {
+    if (def.innerType)
+      return unwrapZodWrappers(def.innerType);
   }
+  return schema;
 }
 function defineStep(config2) {
   const features = config2.features ?? [];
@@ -12052,7 +12061,7 @@ ${feature._promptAddition}` : feature._promptAddition;
       ...(config2.signals ?? []).map((s) => ({
         key: s.key ?? s.sourcePath,
         sourcePath: s.sourcePath,
-        type: s.type ?? deriveSignalType(config2.result, s.sourcePath),
+        type: s.type ?? zodTypeToSignalType(resolveZodSchemaAtPath(effectiveResult, s.sourcePath)) ?? "string",
         required: s.required ?? true,
         availableWhenResultStatusIn: s.availableWhenResultStatusIn ?? null
       })),
@@ -12992,6 +13001,32 @@ class StepDefinitions extends HeyApiClient {
 }
 
 class StepExecutions extends HeyApiClient {
+  createArtifactUploadUrl(options) {
+    return (options.client ?? this.client).post({
+      url: "/api/step-executions/{stepExecutionId}/artifact-upload-url",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  listStepExecutionArtifacts(options) {
+    return (options.client ?? this.client).get({ url: "/api/step-executions/{stepExecutionId}/artifacts", ...options });
+  }
+  recordStepExecutionArtifact(options) {
+    return (options.client ?? this.client).post({
+      url: "/api/step-executions/{stepExecutionId}/artifacts",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  getArtifactDownloadUrl(options) {
+    return (options.client ?? this.client).get({ url: "/api/step-executions/{stepExecutionId}/artifacts/{artifactId}/download-url", ...options });
+  }
   claimStepExecutions(options) {
     return (options.client ?? this.client).post({
       url: "/api/step-executions/claims",
@@ -13064,6 +13099,22 @@ class StepExecutions extends HeyApiClient {
   getStepExecution(options) {
     return (options.client ?? this.client).get({ url: "/api/step-executions/{stepExecutionId}", ...options });
   }
+  readStepExecutionLogs(options) {
+    return (options.client ?? this.client).get({ url: "/api/step-executions/{stepExecutionId}/logs", ...options });
+  }
+  appendStepExecutionLogs(options) {
+    return (options.client ?? this.client).post({
+      url: "/api/step-executions/{stepExecutionId}/logs",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  getStepExecutionLogArchive(options) {
+    return (options.client ?? this.client).get({ url: "/api/step-executions/{stepExecutionId}/logs/archive", ...options });
+  }
 }
 
 class PipelineDefinitions extends HeyApiClient {
@@ -13402,6 +13453,12 @@ class ProjectInvites extends HeyApiClient {
   }
 }
 
+class Billing extends HeyApiClient {
+  getOrgUsage(options) {
+    return (options.client ?? this.client).get({ url: "/api/orgs/{orgId}/usage", ...options });
+  }
+}
+
 class BoboddyClient extends HeyApiClient {
   static __registry = new HeyApiRegistry;
   constructor(args) {
@@ -13464,6 +13521,10 @@ class BoboddyClient extends HeyApiClient {
   get projectInvites() {
     return this._projectInvites ??= new ProjectInvites({ client: this.client });
   }
+  _billing;
+  get billing() {
+    return this._billing ??= new Billing({ client: this.client });
+  }
 }
 
 // src/definitions/steps/step-definitions-client.ts
@@ -15864,7 +15925,7 @@ var notificationItemSchema = exports_external.object({
   title: exports_external.string().describe("Short, human-readable notification title."),
   body: exports_external.string().describe("The notification body / details."),
   priority: exports_external.enum(["low", "normal", "high", "urgent"]).describe("How important this notification is for the user."),
-  suggestedChannels: exports_external.array(exports_external.enum(["in_app", "jira_comment", "email", "slack"])).optional().describe("Channels the agent thinks are worth using. The platform policy decides the final channels."),
+  suggestedChannels: exports_external.array(exports_external.enum(["in_app", "work_item_platform_comment", "email", "slack"])).optional().describe("Channels the agent thinks are worth using. The platform policy decides the final channels."),
   payload: exports_external.record(exports_external.string(), exports_external.unknown()).optional().describe('Kind-specific structured data. For "feedback_request": { category, urgency, suggestedKey? }.')
 }).describe("A single user notification emitted by the agent.");
 var notificationsFeature = {
@@ -15880,7 +15941,7 @@ var notificationsFeature = {
     "- **title**: A short, human-readable title.",
     "- **body**: The details of the notification.",
     "- **priority**: One of `low`, `normal`, `high`, `urgent`.",
-    '- **suggestedChannels** *(optional)*: Channels you think are worth using (e.g. `["in_app", "jira_comment"]`).',
+    '- **suggestedChannels** *(optional)*: Channels you think are worth using (e.g. `["in_app", "work_item_platform_comment"]`).',
     "  You only *suggest* channels \u2014 the platform policy decides the final delivery channels.",
     '- **payload** *(optional)*: Kind-specific data. For `feedback_request`, include `{ "category": string, "urgency": "blocking"|"clarification"|"assumption"|"informational", "suggestedKey"?: string }`.'
   ].join(`
@@ -16266,6 +16327,82 @@ function materializeAccessor(accessor) {
   };
 }
 
+// src/definitions/pipelines/builder-helpers.ts
+var WORK_ITEM_ACCESSOR = Object.freeze({
+  title: Object.freeze({ source: "work_item", field: "title" }),
+  description: Object.freeze({
+    source: "work_item",
+    field: "description"
+  }),
+  field: (fieldName) => Object.freeze({ source: "work_item", field: `fields.${fieldName}` })
+});
+var WORK_ITEM_FIELD_BINDINGS = {
+  workItemTitle: { source: "work_item", field: "title" },
+  workItemDescription: { source: "work_item", field: "description" }
+};
+function makeStepInputCtx(inputSchema) {
+  const baseAccessor = createInputAccessor(inputSchema);
+  const input = new Proxy(baseAccessor, {
+    get(target, prop) {
+      if (typeof prop === "string" && prop in WORK_ITEM_FIELD_BINDINGS) {
+        return WORK_ITEM_FIELD_BINDINGS[prop];
+      }
+      return target[prop];
+    }
+  });
+  return {
+    input,
+    signal(step, key) {
+      return { source: "step_signal", step, signalKey: key };
+    },
+    output(step) {
+      return { source: "step_output", step };
+    },
+    literal: literal2
+  };
+}
+function literal2(value) {
+  return { source: "literal", value };
+}
+function normalizeInputMapping(mapping) {
+  if (!mapping)
+    return;
+  const out = {};
+  for (const [key, value] of Object.entries(mapping)) {
+    if (value === undefined)
+      continue;
+    out[key] = isInputAccessor(value) ? materializeAccessor(value) : value;
+  }
+  return out;
+}
+function resolveAdditionalStepInputBindings(label, definition) {
+  if (!definition) {
+    return {};
+  }
+  const raw = definition.bindings({
+    workItemField: (fieldName) => ({
+      source: "work_item",
+      field: `fields.${fieldName}`
+    }),
+    literal: literal2
+  });
+  if (definition.schema instanceof exports_external.ZodObject) {
+    const validKeys = new Set(Object.keys(definition.schema.shape));
+    const unknown2 = Object.keys(raw).filter((key) => !validKeys.has(key));
+    if (unknown2.length > 0) {
+      throw new Error(`${label}.bindings returned key${unknown2.length > 1 ? "s" : ""} not in schema: ${unknown2.map((key) => `"${key}"`).join(", ")}`);
+    }
+  }
+  return normalizeInputMapping(raw) ?? {};
+}
+function mergeStepBindings(pipelineBindings, explicitBindings) {
+  const merged = {
+    ...pipelineBindings,
+    ...explicitBindings ?? {}
+  };
+  return Object.keys(merged).length > 0 ? merged : undefined;
+}
+
 // src/definitions/pipelines/builder.ts
 class PipelineStepAdvancementBuilder {
   inputSchema;
@@ -16282,6 +16419,8 @@ class PipelineStepAdvancementBuilder {
   }
   advance(callback) {
     const last = this.steps.at(-1);
+    if (!last)
+      throw new Error("Internal error: no steps available");
     const ctx = makeAdvanceCtx();
     const result = callback(ctx);
     const policy = {
@@ -16378,80 +16517,6 @@ class PipelineBuilder {
     return new PipelineStepAdvancementBuilder(this.inputSchema, this.meta, this.steps, this.pipelineInputBindings, this.pipelineStepInputBindings);
   }
 }
-var WORK_ITEM_ACCESSOR = Object.freeze({
-  title: Object.freeze({ source: "work_item", field: "title" }),
-  description: Object.freeze({
-    source: "work_item",
-    field: "description"
-  }),
-  field: (fieldName) => Object.freeze({ source: "work_item", field: `fields.${fieldName}` })
-});
-var WORK_ITEM_FIELD_BINDINGS = {
-  workItemTitle: { source: "work_item", field: "title" },
-  workItemDescription: { source: "work_item", field: "description" }
-};
-function makeStepInputCtx(inputSchema) {
-  const baseAccessor = createInputAccessor(inputSchema);
-  const input = new Proxy(baseAccessor, {
-    get(target, prop) {
-      if (typeof prop === "string" && prop in WORK_ITEM_FIELD_BINDINGS) {
-        return WORK_ITEM_FIELD_BINDINGS[prop];
-      }
-      return target[prop];
-    }
-  });
-  return {
-    input,
-    signal(step, key) {
-      return { source: "step_signal", step, signalKey: key };
-    },
-    output(step) {
-      return { source: "step_output", step };
-    },
-    literal: literal2
-  };
-}
-function literal2(value) {
-  return { source: "literal", value };
-}
-function normalizeInputMapping(mapping) {
-  if (!mapping)
-    return;
-  const out = {};
-  for (const [key, value] of Object.entries(mapping)) {
-    if (value === undefined)
-      continue;
-    out[key] = isInputAccessor(value) ? materializeAccessor(value) : value;
-  }
-  return out;
-}
-function resolveAdditionalStepInputBindings(label, definition) {
-  if (!definition) {
-    return {};
-  }
-  const raw = definition.bindings({
-    workItemField: (fieldName) => ({
-      source: "work_item",
-      field: `fields.${fieldName}`
-    }),
-    literal: literal2
-  });
-  if (definition.schema instanceof exports_external.ZodObject) {
-    const validKeys = new Set(Object.keys(definition.schema.shape));
-    const unknown2 = Object.keys(raw).filter((key) => !validKeys.has(key));
-    if (unknown2.length > 0) {
-      throw new Error(`${label}.bindings returned key${unknown2.length > 1 ? "s" : ""} not in schema: ${unknown2.map((key) => `"${key}"`).join(", ")}`);
-    }
-  }
-  return normalizeInputMapping(raw) ?? {};
-}
-function mergeStepBindings(pipelineBindings, explicitBindings) {
-  const merged = {
-    ...pipelineBindings,
-    ...explicitBindings ?? {}
-  };
-  return Object.keys(merged).length > 0 ? merged : undefined;
-}
 function pipeline(meta3) {
   return new PipelineBuilder(meta3);
 }
@@ -16469,7 +16534,7 @@ var buildPipelineDefinitionsClient = (pipelineDefinitions) => {
       });
       if (result.error)
         throw new Error(JSON.stringify(result.error));
-      return result.data ?? [];
+      return result.data;
     },
     upsertFromSpec: async (projectId, spec, stepDefs, options) => {
       const stepDefMap = new Map;
@@ -16549,7 +16614,7 @@ function makeFieldRef(fact, path) {
   };
 }
 function makeAssign(pipeline2) {
-  if (typeof pipeline2 !== "object" || pipeline2 === null || typeof pipeline2["key"] !== "string" || !Array.isArray(pipeline2["steps"])) {
+  if (typeof pipeline2 !== "object" || typeof pipeline2["key"] !== "string" || !Array.isArray(pipeline2["steps"])) {
     throw new Error("assign() requires a pipeline spec produced by pipeline().build(). " + "Pass the default-exported value from a pipeline definition file.");
   }
   return { _tag: "assign", pipeline: pipeline2 };
@@ -16598,13 +16663,10 @@ function serializeConditionNode(condition) {
       value: condition.value
     };
   }
-  if (condition._tag === "group") {
-    if (condition.mode === "all") {
-      return { all: condition.conditions.map(serializeConditionNode) };
-    }
-    return { any: condition.conditions.map(serializeConditionNode) };
+  if (condition.mode === "all") {
+    return { all: condition.conditions.map(serializeConditionNode) };
   }
-  throw new Error(`Unknown condition tag: ${JSON.stringify(condition["_tag"])}`);
+  return { any: condition.conditions.map(serializeConditionNode) };
 }
 function serializeOutcome(outcome) {
   if (outcome._tag === "skip")
@@ -16682,7 +16744,9 @@ function extractRoutePipelineKeys(policy) {
 }
 var PUSH_SCRIPT_NAMES = new Set(["push.ts", "push.mjs", "push.js"]);
 async function pushFromDirectory(dir, opts) {
-  const log = opts.log ?? ((msg) => console.log(msg));
+  const log = opts.log ?? ((msg) => {
+    console.warn(msg);
+  });
   const headers = { Authorization: `Bearer ${opts.accessToken}` };
   const absDir = resolve(dir);
   const allFiles = readdirSync(absDir).filter((f) => f.endsWith(".ts") || f.endsWith(".js"));
@@ -16740,7 +16804,7 @@ async function pushFromDirectory(dir, opts) {
     const serverSteps = await stepsClient.listByProjectId(opts.projectId, {
       headers
     });
-    const stepDefs = (serverSteps ?? []).map((s) => ({
+    const stepDefs = serverSteps.map((s) => ({
       id: s.id,
       key: s.key,
       version: s.version
@@ -16791,6 +16855,9 @@ async function syncDefaultPipelineAssignment(spec, opts, headers, pipelinesClien
     }
   }
   const linearPipelineDefinitionId = pipelineKeyToId.get(serialized.linearPipelineDefinitionKey);
+  if (!linearPipelineDefinitionId) {
+    throw new Error(`Pipeline key "${serialized.linearPipelineDefinitionKey}" was not found on the server.`);
+  }
   const resolvedRules = serialized.rulesJson.rules.map((rule) => {
     if (rule.event.type === "assign" && typeof rule.event.params?.["pipelineKey"] === "string") {
       const pKey = rule.event.params["pipelineKey"];

package/dist/step-execution-plane-client.d.ts

@@ -1,4 +1,7 @@
 import { StepExecutions } from "./generated/sdk.gen";
+import type { PostApiStepExecutionsByStepExecutionIdArtifactUploadUrlData, PostApiStepExecutionsByStepExecutionIdArtifactsData } from "./generated/types.gen";
+type CreateArtifactUploadUrlInput = PostApiStepExecutionsByStepExecutionIdArtifactUploadUrlData["body"];
+type RecordStepExecutionArtifactInput = PostApiStepExecutionsByStepExecutionIdArtifactsData["body"];
 type RequestOptions = {
     headers?: Record<string, unknown> | undefined;
 };
@@ -186,5 +189,51 @@ declare const buildStepExecutionPlaneClient: (stepExecutions: StepExecutions) =>
         resultJson: JsonValue;
         errorJson: JsonValue;
     }, options?: RequestOptions) => Promise<void>;
+    createArtifactUploadUrl: (stepExecutionId: string, body: CreateArtifactUploadUrlInput, options?: RequestOptions) => Promise<{
+        uploadUrl: string;
+        storeRef: string;
+        objectKey: string;
+        expiresInSeconds: number;
+    }>;
+    recordStepExecutionArtifact: (stepExecutionId: string, body: RecordStepExecutionArtifactInput, options?: RequestOptions) => Promise<{
+        id: string;
+        stepExecutionId: string;
+        relativeStorePath: string;
+        storeRef: string;
+        objectKey: string;
+        sizeBytes: number;
+        contentType: string | unknown;
+        kind: "generic" | "playwright-trace";
+        createdAt: string;
+    }>;
+    listStepExecutionArtifacts: (stepExecutionId: string, options?: RequestOptions) => Promise<{
+        id: string;
+        stepExecutionId: string;
+        relativeStorePath: string;
+        storeRef: string;
+        objectKey: string;
+        sizeBytes: number;
+        contentType: string | unknown;
+        kind: "generic" | "playwright-trace";
+        createdAt: string;
+    }[]>;
+    getArtifactDownloadUrl: (stepExecutionId: string, artifactId: string, options?: RequestOptions) => Promise<{
+        url: string | unknown;
+        sizeBytes: number;
+        contentType: string | unknown;
+        relativeStorePath: string;
+    }>;
+    appendStepExecutionLogs: (stepExecutionId: string, body: {
+        claimToken: string;
+        lines: {
+            seq: number;
+            stream: "worker" | "ai-server" | "conversation";
+            ts: string;
+            content: string;
+            level: "debug" | "info" | "warn" | "error";
+        }[];
+    }, options?: RequestOptions) => Promise<{
+        nextOffset: number;
+    }>;
 };
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@boboddy/sdk",
-  "version": "0.1.45-alpha",
+  "version": "0.2.3-alpha",
   "type": "module",
   "exports": {
     ".": {