@scarn/sdk 0.8.9 → 0.8.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -130,6 +130,7 @@ export type HealthChecksInput = HealthCheckInput[];
130
130
  export declare const stepToolHealthCheckSchema: z.ZodObject<{
131
131
  name: z.ZodOptional<z.ZodString>;
132
132
  args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
133
+ tool: z.ZodString;
133
134
  kind: z.ZodDefault<z.ZodLiteral<"tool">>;
134
135
  severity: z.ZodDefault<z.ZodEnum<{
135
136
  required: "required";
@@ -137,12 +138,12 @@ export declare const stepToolHealthCheckSchema: z.ZodObject<{
137
138
  }>>;
138
139
  timeoutSeconds: z.ZodDefault<z.ZodNumber>;
139
140
  serialGroup: z.ZodOptional<z.ZodString>;
140
- tool: z.ZodString;
141
141
  }, z.core.$strict>;
142
142
  /** The value of `defineStep({ healthChecks })`: `cli` and non-MCP `tool` checks. */
143
143
  export declare const stepHealthChecksInputSchema: z.ZodArray<z.ZodPreprocess<z.ZodDiscriminatedUnion<[z.ZodObject<{
144
144
  name: z.ZodOptional<z.ZodString>;
145
145
  args: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
146
+ tool: z.ZodString;
146
147
  kind: z.ZodDefault<z.ZodLiteral<"tool">>;
147
148
  severity: z.ZodDefault<z.ZodEnum<{
148
149
  required: "required";
@@ -150,7 +151,6 @@ export declare const stepHealthChecksInputSchema: z.ZodArray<z.ZodPreprocess<z.Z
150
151
  }>>;
151
152
  timeoutSeconds: z.ZodDefault<z.ZodNumber>;
152
153
  serialGroup: z.ZodOptional<z.ZodString>;
153
- tool: z.ZodString;
154
154
  }, z.core.$strict>, z.ZodObject<{
155
155
  name: z.ZodOptional<z.ZodString>;
156
156
  severity: z.ZodDefault<z.ZodEnum<{
package/dist/index.js CHANGED
@@ -9,7 +9,7 @@ import {
9
9
  WORK_ITEM_TOP_LEVEL_FIELDS,
10
10
  createPipelineDefinitionsClient,
11
11
  resolveWorkItemFieldPath
12
- } from "./chunk-qy3508g1.js";
12
+ } from "./chunk-nxsa7ksc.js";
13
13
  import {
14
14
  after,
15
15
  all,
@@ -62,7 +62,7 @@ import {
62
62
  import {
63
63
  createScarnClient,
64
64
  createTaskPlaneClient
65
- } from "./chunk-738k8p1c.js";
65
+ } from "./chunk-zjp1c7ye.js";
66
66
  import"./chunk-61jf8b6s.js";
67
67
  import"./chunk-cnxaagfj.js";
68
68
  import {
@@ -99,7 +99,7 @@ import {
99
99
  resolveMcpChecks,
100
100
  toStepHandle,
101
101
  toStepSpec
102
- } from "./chunk-hpn4q02f.js";
102
+ } from "./chunk-d4e1kz6h.js";
103
103
  import {
104
104
  collectEnvPlaceholderNames,
105
105
  isEnvPlaceholderValue,
@@ -149,7 +149,7 @@ import {
149
149
  WorkItemCommentDrafts,
150
150
  WorkItemComments,
151
151
  WorkItems
152
- } from "./chunk-vmdn05vj.js";
152
+ } from "./chunk-c3xzrd3w.js";
153
153
  import {
154
154
  ARTIFACT_MARKER_SCHEME,
155
155
  buildArtifactMarker,
@@ -6,18 +6,18 @@ import {
6
6
  import {
7
7
  AutomationsApiError,
8
8
  createAutomationsClient
9
- } from "../chunk-npy0jxfg.js";
9
+ } from "../chunk-aqsa0bpk.js";
10
10
  import {
11
11
  assertValidDefinitionSpecs
12
12
  } from "../chunk-1yb2h6t9.js";
13
13
  import {
14
14
  PipelineDefinitionsApiError,
15
15
  createPipelineDefinitionsClient
16
- } from "../chunk-qy3508g1.js";
16
+ } from "../chunk-nxsa7ksc.js";
17
17
  import {
18
18
  createStepDefinitionsClient,
19
19
  toStepSpec
20
- } from "../chunk-hpn4q02f.js";
20
+ } from "../chunk-d4e1kz6h.js";
21
21
  import"../chunk-e1h021kq.js";
22
22
  import"../chunk-63f90zky.js";
23
23
  import"../chunk-jj9pezwb.js";
@@ -26,7 +26,7 @@ import"../chunk-5zsavw98.js";
26
26
  import"../chunk-4ggr8af6.js";
27
27
  import"../chunk-k4y5qt4y.js";
28
28
  import"../chunk-xzx08r6y.js";
29
- import"../chunk-vmdn05vj.js";
29
+ import"../chunk-c3xzrd3w.js";
30
30
  import"../chunk-ngy1fdcx.js";
31
31
  import"../chunk-y2pv8d6a.js";
32
32
  import"../chunk-01nfqm18.js";
@@ -23,27 +23,27 @@ declare const buildTaskPlaneClient: (taskRuns: TaskRuns) => {
23
23
  reason: "initial" | "retry" | "continuation";
24
24
  projectId: string;
25
25
  workItemId: string;
26
- taskExecutionConfigId: string | unknown;
27
- name: string | unknown;
26
+ taskExecutionConfigId: string | null;
27
+ name: string | null;
28
28
  kind: "agent" | "code";
29
- previousTaskRunId: string | unknown;
30
- baseBranch: string | unknown;
31
- heartbeatSeconds: number | unknown;
29
+ previousTaskRunId: string | null;
30
+ baseBranch: string | null;
31
+ heartbeatSeconds: number | null;
32
32
  status: "pending" | "queued" | "running" | "succeeded" | "failed" | "timeout" | "abandoned" | "cancelled" | "skipped" | "yielded";
33
- inputJson: unknown;
34
- claimedBy: string | unknown;
35
- claimedAt: string | unknown;
36
- lastHeartbeatAt: string | unknown;
37
- leaseExpiresAt: string | unknown;
38
- executionTimeoutSeconds: number | unknown;
39
- executionDeadlineAt: string | unknown;
40
- startedAt: string | unknown;
41
- completedAt: string | unknown;
42
- resultJson: unknown;
43
- errorJson: unknown;
44
- workBranch: string | unknown;
45
- createdFromBranch: string | unknown;
46
- sessionRestored: boolean | unknown;
33
+ inputJson: unknown | null;
34
+ claimedBy: string | null;
35
+ claimedAt: string | null;
36
+ lastHeartbeatAt: string | null;
37
+ leaseExpiresAt: string | null;
38
+ executionTimeoutSeconds: number | null;
39
+ executionDeadlineAt: string | null;
40
+ startedAt: string | null;
41
+ completedAt: string | null;
42
+ resultJson: unknown | null;
43
+ errorJson: unknown | null;
44
+ workBranch: string | null;
45
+ createdFromBranch: string | null;
46
+ sessionRestored: boolean | null;
47
47
  createdAt: string;
48
48
  updatedAt: string;
49
49
  };
@@ -60,34 +60,34 @@ declare const buildTaskPlaneClient: (taskRuns: TaskRuns) => {
60
60
  reason: "initial" | "retry" | "continuation";
61
61
  projectId: string;
62
62
  workItemId: string;
63
- taskExecutionConfigId: string | unknown;
64
- name: string | unknown;
63
+ taskExecutionConfigId: string | null;
64
+ name: string | null;
65
65
  kind: "agent" | "code";
66
- previousTaskRunId: string | unknown;
67
- baseBranch: string | unknown;
68
- heartbeatSeconds: number | unknown;
66
+ previousTaskRunId: string | null;
67
+ baseBranch: string | null;
68
+ heartbeatSeconds: number | null;
69
69
  status: "pending" | "queued" | "running" | "succeeded" | "failed" | "timeout" | "abandoned" | "cancelled" | "skipped" | "yielded";
70
- inputJson: unknown;
71
- claimedBy: string | unknown;
72
- claimedAt: string | unknown;
73
- lastHeartbeatAt: string | unknown;
74
- leaseExpiresAt: string | unknown;
75
- executionTimeoutSeconds: number | unknown;
76
- executionDeadlineAt: string | unknown;
77
- startedAt: string | unknown;
78
- completedAt: string | unknown;
79
- resultJson: unknown;
80
- errorJson: unknown;
81
- workBranch: string | unknown;
82
- createdFromBranch: string | unknown;
83
- sessionRestored: boolean | unknown;
70
+ inputJson: unknown | null;
71
+ claimedBy: string | null;
72
+ claimedAt: string | null;
73
+ lastHeartbeatAt: string | null;
74
+ leaseExpiresAt: string | null;
75
+ executionTimeoutSeconds: number | null;
76
+ executionDeadlineAt: string | null;
77
+ startedAt: string | null;
78
+ completedAt: string | null;
79
+ resultJson: unknown | null;
80
+ errorJson: unknown | null;
81
+ workBranch: string | null;
82
+ createdFromBranch: string | null;
83
+ sessionRestored: boolean | null;
84
84
  createdAt: string;
85
85
  updatedAt: string;
86
86
  }>;
87
87
  /** Not unwrapped: callers read `error.status` (e.g. a 402 read quota). */
88
88
  getTaskLogArchive: ({ taskRunId }: TaskRunRef) => Promise<({
89
89
  data: {
90
- url: string | unknown;
90
+ url: string | null;
91
91
  sizeBytes: number;
92
92
  };
93
93
  error: undefined;
@@ -288,9 +288,9 @@ declare const buildTaskPlaneClient: (taskRuns: TaskRuns) => {
288
288
  claimToken: string;
289
289
  }) => Promise<{
290
290
  projectId: string;
291
- projectPath: string | unknown;
291
+ projectPath: string | null;
292
292
  gitUrl: string;
293
- baseWorkBranch: string | unknown;
293
+ baseWorkBranch: string | null;
294
294
  projectOpencodeConfig: {
295
295
  relativePath: string;
296
296
  present: boolean;
@@ -298,13 +298,13 @@ declare const buildTaskPlaneClient: (taskRuns: TaskRuns) => {
298
298
  name: string;
299
299
  description: string;
300
300
  run: string;
301
- cwd: string | unknown;
301
+ cwd: string | null;
302
302
  }>;
303
303
  services: Array<{
304
304
  name: string;
305
305
  description: string;
306
306
  run: string;
307
- cwd: string | unknown;
307
+ cwd: string | null;
308
308
  dependsOn: Array<string>;
309
309
  expose: {
310
310
  targetPort: number;
@@ -318,86 +318,86 @@ declare const buildTaskPlaneClient: (taskRuns: TaskRuns) => {
318
318
  kind: "agent" | "code";
319
319
  key: string;
320
320
  name: string;
321
- inputJson: unknown;
322
- executionTimeoutSeconds: number | unknown;
323
- prompt: string | unknown;
321
+ inputJson: unknown | null;
322
+ executionTimeoutSeconds: number | null;
323
+ prompt: string | null;
324
324
  entrypointJson: {
325
325
  sourceFile: string;
326
- } | unknown;
326
+ } | null;
327
327
  resultSchemaJson: {
328
328
  [key: string]: unknown;
329
- } | unknown;
330
- turnsRemaining: number | unknown;
329
+ } | null;
330
+ turnsRemaining: number | null;
331
331
  workItemId: string;
332
332
  grants: Array<{
333
- resource: string;
334
- action: string;
333
+ resource: "workItem";
334
+ action: "read";
335
335
  scope: "self" | "children" | "project";
336
336
  } | {
337
- resource: string;
338
- action: string;
337
+ resource: "workItem";
338
+ action: "update";
339
339
  scope: "self" | "children";
340
340
  } | {
341
- resource: string;
342
- action: string;
341
+ resource: "workItem";
342
+ action: "comment";
343
343
  scope: "self" | "children";
344
344
  } | {
345
- resource: string;
346
- action: string;
345
+ resource: "workItem";
346
+ action: "label";
347
347
  scope: "self" | "children";
348
348
  labels: Array<string>;
349
349
  } | {
350
- resource: string;
351
- action: string;
350
+ resource: "workItem";
351
+ action: "block";
352
352
  scope: "self" | "children";
353
353
  } | {
354
- resource: string;
355
- action: string;
354
+ resource: "workItem";
355
+ action: "close";
356
356
  scope: "self" | "children";
357
357
  } | {
358
- resource: string;
359
- action: string;
360
- scope: string;
358
+ resource: "workItem";
359
+ action: "create";
360
+ scope: "children";
361
361
  labels: Array<string>;
362
362
  }>;
363
363
  };
364
364
  runtime: {
365
365
  executionMode: "workspace" | "no_workspace";
366
- devcontainerConfigPath: string | unknown;
367
- managedRuntime: "bun1" | "node24" | unknown;
366
+ devcontainerConfigPath: string | null;
367
+ managedRuntime: "bun1" | "node24" | null;
368
368
  repo: {
369
- mode: string;
369
+ mode: "none";
370
370
  } | {
371
- mode: string;
371
+ mode: "readOnly";
372
372
  gitCredentials: "auto" | "none";
373
373
  } | {
374
- mode: string;
375
- message: string | unknown;
374
+ mode: "readWrite";
375
+ message: string | null;
376
376
  onPushFailure: "fail" | "warn";
377
377
  gitCredentials: "auto" | "none";
378
378
  };
379
379
  envJson: Array<{
380
380
  name: string;
381
- source: string;
381
+ source: "value";
382
382
  value: string;
383
383
  secret: boolean;
384
384
  applies: "agent" | "setup" | "both";
385
385
  } | {
386
386
  name: string;
387
- source: string;
387
+ source: "inherit";
388
388
  from: string;
389
389
  secret: boolean;
390
390
  optional: boolean;
391
391
  default?: string;
392
392
  mcp?: string;
393
393
  applies: "agent" | "setup" | "both";
394
- }> | unknown;
394
+ }> | null;
395
395
  healthChecksJson: Array<{
396
396
  name?: string;
397
397
  severity: "required" | "warn";
398
398
  timeoutSeconds: number;
399
399
  serialGroup?: string;
400
- kind: string;
400
+ kind: "tool";
401
401
  tool: string;
402
402
  mcp?: string;
403
403
  args?: {
@@ -408,13 +408,13 @@ declare const buildTaskPlaneClient: (taskRuns: TaskRuns) => {
408
408
  severity: "required" | "warn";
409
409
  timeoutSeconds: number;
410
410
  serialGroup?: string;
411
- kind: string;
411
+ kind: "cli";
412
412
  command: Array<string>;
413
413
  expectExitCode: number;
414
- }> | unknown;
414
+ }> | null;
415
415
  opencodeMcpJson: {
416
416
  [key: string]: {
417
- type: string;
417
+ type: "local";
418
418
  command: Array<string>;
419
419
  cwd?: string;
420
420
  environment?: {
@@ -429,7 +429,7 @@ declare const buildTaskPlaneClient: (taskRuns: TaskRuns) => {
429
429
  };
430
430
  protocol?: "legacy" | "auto" | "2026-07-28";
431
431
  } | {
432
- type: string;
432
+ type: "remote";
433
433
  url: string;
434
434
  headers?: {
435
435
  [key: string]: string;
@@ -441,7 +441,7 @@ declare const buildTaskPlaneClient: (taskRuns: TaskRuns) => {
441
441
  callback_port?: number;
442
442
  redirect_uri?: string;
443
443
  auth_server_metadata_url?: string;
444
- } | boolean;
444
+ } | false;
445
445
  disabled?: boolean;
446
446
  codemode?: boolean;
447
447
  timeout?: {
@@ -451,7 +451,7 @@ declare const buildTaskPlaneClient: (taskRuns: TaskRuns) => {
451
451
  };
452
452
  protocol?: "legacy" | "auto" | "2026-07-28";
453
453
  } | {
454
- type: string;
454
+ type: "ref";
455
455
  name?: string;
456
456
  disabled?: boolean;
457
457
  codemode?: boolean;
@@ -462,7 +462,7 @@ declare const buildTaskPlaneClient: (taskRuns: TaskRuns) => {
462
462
  };
463
463
  protocol?: "legacy" | "auto" | "2026-07-28";
464
464
  };
465
- } | unknown;
465
+ } | null;
466
466
  };
467
467
  agentPrompt: {
468
468
  sessionTitle: string;
@@ -474,12 +474,12 @@ declare const buildTaskPlaneClient: (taskRuns: TaskRuns) => {
474
474
  status: "pending" | "queued" | "running" | "succeeded" | "failed" | "timeout" | "abandoned" | "cancelled" | "skipped" | "yielded";
475
475
  transcriptRelativePath: string;
476
476
  findingsRelativePath: string;
477
- findingsJson: unknown;
478
- } | unknown;
477
+ findingsJson: unknown | null;
478
+ } | null;
479
479
  restoreSession: {
480
480
  downloadUrl: string;
481
481
  message: string;
482
- } | unknown;
482
+ } | null;
483
483
  }>;
484
484
  readTaskRunWorkItem: ({ taskRunId, ...body }: TaskRunRef & {
485
485
  claimToken: string;
@@ -488,37 +488,51 @@ declare const buildTaskPlaneClient: (taskRuns: TaskRuns) => {
488
488
  id: string;
489
489
  title: string;
490
490
  labels: Array<string>;
491
- description: string | unknown;
491
+ description: string | null;
492
492
  descriptionVersion: number;
493
493
  fields: {
494
494
  [key: string]: unknown;
495
495
  };
496
496
  platform: "jira" | "github" | "bitbucket" | "linear" | "scarn" | "custom";
497
497
  platformKey: string;
498
- parentWorkItemId: string | unknown;
498
+ parentWorkItemId: string | null;
499
499
  state: "open" | "closed";
500
- closeReason: "completed" | "out_of_scope" | "superseded" | unknown;
501
- resolution: string | unknown;
500
+ closeReason: "completed" | "out_of_scope" | "superseded" | null;
501
+ resolution: string | null;
502
502
  blockers: Array<{
503
503
  id: string;
504
504
  title: string;
505
505
  state: "open" | "closed";
506
506
  labels: Array<string>;
507
- closeReason: "completed" | "out_of_scope" | "superseded" | unknown;
508
- resolution: string | unknown;
507
+ closeReason: "completed" | "out_of_scope" | "superseded" | null;
508
+ resolution: string | null;
509
509
  blockedBy: Array<string>;
510
- latestTaskStatus: "waiting_for_concurrency_slot" | "waiting_for_work" | "queued" | "running" | "waiting_for_person" | "succeeded" | "failed" | "cancelled" | unknown;
510
+ latestTaskStatus: "waiting_for_concurrency_slot" | "waiting_for_work" | "queued" | "running" | "waiting_for_person" | "succeeded" | "failed" | "cancelled" | null;
511
511
  }>;
512
512
  children: Array<{
513
513
  id: string;
514
514
  title: string;
515
515
  state: "open" | "closed";
516
516
  labels: Array<string>;
517
- closeReason: "completed" | "out_of_scope" | "superseded" | unknown;
518
- resolution: string | unknown;
517
+ closeReason: "completed" | "out_of_scope" | "superseded" | null;
518
+ resolution: string | null;
519
519
  blockedBy: Array<string>;
520
- latestTaskStatus: "waiting_for_concurrency_slot" | "waiting_for_work" | "queued" | "running" | "waiting_for_person" | "succeeded" | "failed" | "cancelled" | unknown;
520
+ latestTaskStatus: "waiting_for_concurrency_slot" | "waiting_for_work" | "queued" | "running" | "waiting_for_person" | "succeeded" | "failed" | "cancelled" | null;
521
521
  }>;
522
+ comments: {
523
+ items: Array<{
524
+ id: string;
525
+ parentCommentId: string | null;
526
+ body: string;
527
+ authorKind: "user" | "agent";
528
+ authorName: string;
529
+ isPinned: boolean;
530
+ createdAt: string;
531
+ updatedAt: string;
532
+ }>;
533
+ totalCount: number;
534
+ nextCursor: string | null;
535
+ };
522
536
  }>;
523
537
  completeTaskRun: ({ taskRunId, ...body }: TaskRunRef & Omit<CompletionBody, "status">) => Promise<void>;
524
538
  failTaskRun: ({ taskRunId, ...body }: TaskRunRef & Omit<CompletionBody, "status" | "workBranch" | "createdFromBranch">) => Promise<void>;
@@ -544,19 +558,112 @@ declare const buildTaskPlaneClient: (taskRuns: TaskRuns) => {
544
558
  taskRunId: string;
545
559
  projectId: string;
546
560
  relativeStorePath: string;
547
- storeRef: string | unknown;
548
- objectKey: string | unknown;
549
- sizeBytes: number | unknown;
550
- contentType: string | unknown;
561
+ storeRef: string | null;
562
+ objectKey: string | null;
563
+ sizeBytes: number | null;
564
+ contentType: string | null;
551
565
  kind: "generic" | "playwright-trace" | "video" | "image";
552
566
  createdAt: string;
553
567
  }[]>;
568
+ /** Not unwrapped: callers read `response.status` (404 = push unavailable). */
569
+ issueWorkSignalToken: ({ projectId, workerId, }: {
570
+ projectId: string;
571
+ workerId?: string | undefined;
572
+ }) => Promise<({
573
+ data: {
574
+ url: string;
575
+ token: string;
576
+ expiresAt: string;
577
+ };
578
+ error: undefined;
579
+ } | {
580
+ data: undefined;
581
+ error: {
582
+ type: string;
583
+ title: string;
584
+ status: number;
585
+ detail?: string;
586
+ instance?: string;
587
+ code?: string;
588
+ errors?: Array<{
589
+ path: string;
590
+ message: string;
591
+ summary?: string;
592
+ }>;
593
+ meta?: {
594
+ [key: string]: unknown;
595
+ };
596
+ } | {
597
+ type: string;
598
+ title: string;
599
+ status: number;
600
+ detail?: string;
601
+ instance?: string;
602
+ code?: string;
603
+ errors?: Array<{
604
+ path: string;
605
+ message: string;
606
+ summary?: string;
607
+ }>;
608
+ meta?: {
609
+ [key: string]: unknown;
610
+ };
611
+ } | {
612
+ type: string;
613
+ title: string;
614
+ status: number;
615
+ detail?: string;
616
+ instance?: string;
617
+ code?: string;
618
+ errors?: Array<{
619
+ path: string;
620
+ message: string;
621
+ summary?: string;
622
+ }>;
623
+ meta?: {
624
+ [key: string]: unknown;
625
+ };
626
+ } | {
627
+ type: string;
628
+ title: string;
629
+ status: number;
630
+ detail?: string;
631
+ instance?: string;
632
+ code?: string;
633
+ errors?: Array<{
634
+ path: string;
635
+ message: string;
636
+ summary?: string;
637
+ }>;
638
+ meta?: {
639
+ [key: string]: unknown;
640
+ };
641
+ } | {
642
+ type: string;
643
+ title: string;
644
+ status: number;
645
+ detail?: string;
646
+ instance?: string;
647
+ code?: string;
648
+ errors?: Array<{
649
+ path: string;
650
+ message: string;
651
+ summary?: string;
652
+ }>;
653
+ meta?: {
654
+ [key: string]: unknown;
655
+ };
656
+ };
657
+ }) & {
658
+ request: Request;
659
+ response: Response;
660
+ }>;
554
661
  getArtifactDownloadUrl: ({ taskRunId, artifactId, }: TaskRunRef & {
555
662
  artifactId: string;
556
663
  }) => Promise<{
557
- url: string | unknown;
664
+ url: string | null;
558
665
  sizeBytes: number;
559
- contentType: string | unknown;
666
+ contentType: string | null;
560
667
  relativeStorePath: string;
561
668
  }>;
562
669
  };
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://json.schemastore.org/package.json",
3
3
  "name": "@scarn/sdk",
4
- "version": "0.8.9",
4
+ "version": "0.8.10",
5
5
  "type": "module",
6
6
  "exports": {
7
7
  ".": {