sailfork 0.2.0 → 0.3.0

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.
package/dist/tools.js CHANGED
@@ -754,6 +754,32 @@ var ops = {
754
754
  long: false,
755
755
  paginated: false
756
756
  },
757
+ "issues.answer": {
758
+ id: "issues.answer",
759
+ method: "POST",
760
+ path: "/api/repos/{owner}/{repo}/issues/{number}/asks/{id}/answer",
761
+ pathParams: ["owner", "repo", "number", "id"],
762
+ queryParams: [],
763
+ bodyParams: ["choices", "text"],
764
+ effect: "write",
765
+ retry: "idempotent",
766
+ held: false,
767
+ long: false,
768
+ paginated: false
769
+ },
770
+ "issues.ask": {
771
+ id: "issues.ask",
772
+ method: "POST",
773
+ path: "/api/repos/{owner}/{repo}/issues/{number}/asks",
774
+ pathParams: ["owner", "repo", "number"],
775
+ queryParams: [],
776
+ bodyParams: ["kind", "text", "options", "recommended", "other"],
777
+ effect: "write",
778
+ retry: "none",
779
+ held: false,
780
+ long: false,
781
+ paginated: false
782
+ },
757
783
  "issues.claim": {
758
784
  id: "issues.claim",
759
785
  method: "POST",
@@ -1014,6 +1040,19 @@ var ops = {
1014
1040
  long: false,
1015
1041
  paginated: false
1016
1042
  },
1043
+ "issues.unask": {
1044
+ id: "issues.unask",
1045
+ method: "DELETE",
1046
+ path: "/api/repos/{owner}/{repo}/issues/{number}/asks/{id}",
1047
+ pathParams: ["owner", "repo", "number", "id"],
1048
+ queryParams: [],
1049
+ bodyParams: [],
1050
+ effect: "write",
1051
+ retry: "idempotent",
1052
+ held: false,
1053
+ long: false,
1054
+ paginated: false
1055
+ },
1017
1056
  "issues.unreact": {
1018
1057
  id: "issues.unreact",
1019
1058
  method: "DELETE",
@@ -4490,6 +4529,171 @@ cursor at or behind the stored one leaves it as it is, so two readers cannot rew
4490
4529
  tab: "tab"
4491
4530
  }
4492
4531
  },
4532
+ {
4533
+ name: "issue_answer",
4534
+ op: "issues.answer",
4535
+ description: "Answer a question on an issue, replacing an earlier answer: `choices` are option labels (one for `single`, any for `multi`), `text` the free-text answer of a `text` question or an `other` answer. You need write access or the issue's lease.",
4536
+ schema: {
4537
+ additionalProperties: false,
4538
+ description: "Answer a question on an issue, replacing an earlier answer: `choices` are option labels (one for `single`, any for\n`multi`), `text` the free-text answer of a `text` question or an `other` answer. You need write access or the\nissue's lease.",
4539
+ properties: {
4540
+ choices: {
4541
+ default: [],
4542
+ description: "The labels of the options picked.",
4543
+ items: {
4544
+ type: "string"
4545
+ },
4546
+ type: "array"
4547
+ },
4548
+ id: {
4549
+ description: "The question's id, from the issue's context.",
4550
+ type: "string"
4551
+ },
4552
+ number: {
4553
+ description: "Issue number.",
4554
+ format: "int64",
4555
+ type: "integer"
4556
+ },
4557
+ org: {
4558
+ description: "The repository's owner: a user or an org handle.",
4559
+ type: "string"
4560
+ },
4561
+ repo: {
4562
+ description: "The repository's name.",
4563
+ type: "string"
4564
+ },
4565
+ text: {
4566
+ default: "",
4567
+ description: "The answer in your own words.",
4568
+ type: "string"
4569
+ }
4570
+ },
4571
+ required: [
4572
+ "org",
4573
+ "repo",
4574
+ "number",
4575
+ "id"
4576
+ ],
4577
+ type: "object"
4578
+ },
4579
+ renames: {
4580
+ choices: "choices",
4581
+ id: "id",
4582
+ number: "number",
4583
+ org: "owner",
4584
+ repo: "repo",
4585
+ text: "text"
4586
+ }
4587
+ },
4588
+ {
4589
+ name: "issue_ask",
4590
+ op: "issues.ask",
4591
+ description: "Ask a person a question on an issue and read the answer back later from the issue's context (`asks`). `single` takes one of 2 to 10 options, `multi` any number of them, `text` free text; `other` lets a choice question also take free text. The issue reads as needing input, and its assignee is told, until it is answered. You need the issue's lease or write access.",
4592
+ schema: {
4593
+ $defs: {
4594
+ AskKind: {
4595
+ description: "How a person answers an [`IssueAsk`]: `single` (one option), `multi` (any number of options) or `text` (free text).",
4596
+ enum: [
4597
+ "single",
4598
+ "multi",
4599
+ "text"
4600
+ ],
4601
+ type: "string"
4602
+ },
4603
+ AskOptionInput: {
4604
+ anyOf: [
4605
+ {
4606
+ type: "string"
4607
+ },
4608
+ {
4609
+ $ref: "#/$defs/IssueAskOption"
4610
+ }
4611
+ ],
4612
+ description: "An option as an asker writes it: its label alone, or the label with a description."
4613
+ },
4614
+ IssueAskOption: {
4615
+ properties: {
4616
+ description: {
4617
+ type: [
4618
+ "string",
4619
+ "null"
4620
+ ]
4621
+ },
4622
+ label: {
4623
+ type: "string"
4624
+ }
4625
+ },
4626
+ required: [
4627
+ "label"
4628
+ ],
4629
+ type: "object"
4630
+ }
4631
+ },
4632
+ additionalProperties: false,
4633
+ description: "Ask a person a question on an issue and read the answer back later from the issue's context (`asks`). `single`\ntakes one of 2 to 10 options, `multi` any number of them, `text` free text; `other` lets a choice question also take\nfree text. The issue reads as needing input, and its assignee is told, until it is answered. You need the issue's\nlease or write access.",
4634
+ properties: {
4635
+ kind: {
4636
+ $ref: "#/$defs/AskKind",
4637
+ description: "`single` (pick one option), `multi` (pick any) or `text` (free text)."
4638
+ },
4639
+ number: {
4640
+ description: "Issue number.",
4641
+ format: "int64",
4642
+ type: "integer"
4643
+ },
4644
+ options: {
4645
+ default: [],
4646
+ description: "The choices of a `single` or `multi` question, 2 to 10, each a label or `{label, description}`; none for\n`text`.",
4647
+ items: {
4648
+ $ref: "#/$defs/AskOptionInput"
4649
+ },
4650
+ type: "array"
4651
+ },
4652
+ org: {
4653
+ description: "The repository's owner: a user or an org handle.",
4654
+ type: "string"
4655
+ },
4656
+ other: {
4657
+ default: false,
4658
+ description: "true lets a `single` or `multi` question also take an answer in the person's own words.",
4659
+ type: "boolean"
4660
+ },
4661
+ recommended: {
4662
+ description: "The label of the option you suggest.",
4663
+ type: [
4664
+ "string",
4665
+ "null"
4666
+ ]
4667
+ },
4668
+ repo: {
4669
+ description: "The repository's name.",
4670
+ type: "string"
4671
+ },
4672
+ text: {
4673
+ description: "The whole question, in Markdown, with what the person needs to answer it (up to 2000 characters).",
4674
+ type: "string"
4675
+ }
4676
+ },
4677
+ required: [
4678
+ "org",
4679
+ "repo",
4680
+ "number",
4681
+ "kind",
4682
+ "text"
4683
+ ],
4684
+ type: "object"
4685
+ },
4686
+ renames: {
4687
+ kind: "kind",
4688
+ number: "number",
4689
+ options: "options",
4690
+ org: "owner",
4691
+ other: "other",
4692
+ recommended: "recommended",
4693
+ repo: "repo",
4694
+ text: "text"
4695
+ }
4696
+ },
4493
4697
  {
4494
4698
  name: "issue_claim",
4495
4699
  op: "issues.claim",
@@ -5680,6 +5884,47 @@ repository.`,
5680
5884
  repo: "repo"
5681
5885
  }
5682
5886
  },
5887
+ {
5888
+ name: "issue_unask",
5889
+ op: "issues.unask",
5890
+ description: "Take a question back from an issue, answered or not, once its answer is used or it no longer matters. You need the issue's lease or write access.",
5891
+ schema: {
5892
+ description: `Take a question back from an issue, answered or not, once its answer is used or it no longer matters. You need
5893
+ the issue's lease or write access.`,
5894
+ properties: {
5895
+ id: {
5896
+ description: "The question's id, from the issue's context.",
5897
+ type: "string"
5898
+ },
5899
+ number: {
5900
+ description: "Issue number.",
5901
+ format: "int64",
5902
+ type: "integer"
5903
+ },
5904
+ org: {
5905
+ description: "The repository's owner: a user or an org handle.",
5906
+ type: "string"
5907
+ },
5908
+ repo: {
5909
+ description: "The repository's name.",
5910
+ type: "string"
5911
+ }
5912
+ },
5913
+ required: [
5914
+ "org",
5915
+ "repo",
5916
+ "number",
5917
+ "id"
5918
+ ],
5919
+ type: "object"
5920
+ },
5921
+ renames: {
5922
+ id: "id",
5923
+ number: "number",
5924
+ org: "owner",
5925
+ repo: "repo"
5926
+ }
5927
+ },
5683
5928
  {
5684
5929
  name: "issue_update",
5685
5930
  op: "issues.update",
@@ -1,2 +1,2 @@
1
- export declare const VERSION = "0.2.0";
1
+ export declare const VERSION = "0.3.0";
2
2
  export declare const API_VERSION = "2026-12-01";
@@ -267,6 +267,14 @@ export declare class InboxResource {
267
267
  export declare class IssuesResource {
268
268
  private readonly core;
269
269
  constructor(core: Core);
270
+ /**
271
+ * Answer a question on an issue, replacing an earlier answer: `choices` are option labels (one for `single`, any for `multi`), `text` the free-text answer of a `text` question or an `other` answer. You need write access or the issue's lease.
272
+ */
273
+ answer(input: T.IssuesAnswerInput, opts?: RequestOptions): Promise<T.IssuesAnswerOutput>;
274
+ /**
275
+ * Ask a person a question on an issue and read the answer back later from the issue's context (`asks`). `single` takes one of 2 to 10 options, `multi` any number of them, `text` free text; `other` lets a choice question also take free text. The issue reads as needing input, and its assignee is told, until it is answered. You need the issue's lease or write access.
276
+ */
277
+ ask(input: T.IssuesAskInput, opts?: RequestOptions): Promise<T.IssuesAskOutput>;
270
278
  /**
271
279
  * Delegate an issue to yourself or your agent for a lease, or renew the lease. The issue returns to ready if the lease lapses.
272
280
  */
@@ -349,6 +357,10 @@ export declare class IssuesResource {
349
357
  * Follow an issue to be notified of its activity, or stop following it. Needs only read access.
350
358
  */
351
359
  subscribe(input: T.IssuesSubscribeInput, opts?: RequestOptions): Promise<T.IssuesSubscribeOutput>;
360
+ /**
361
+ * Take a question back from an issue, answered or not, once its answer is used or it no longer matters. You need the issue's lease or write access.
362
+ */
363
+ unask(input: T.IssuesUnaskInput, opts?: RequestOptions): Promise<T.IssuesUnaskOutput>;
352
364
  /**
353
365
  * Take your reaction back from an issue.
354
366
  */
@@ -972,6 +984,14 @@ export declare class RepoIssuesResource {
972
984
  private readonly core;
973
985
  private readonly bound;
974
986
  constructor(core: Core, bound: RepoBound);
987
+ /**
988
+ * Answer a question on an issue, replacing an earlier answer: `choices` are option labels (one for `single`, any for `multi`), `text` the free-text answer of a `text` question or an `other` answer. You need write access or the issue's lease.
989
+ */
990
+ answer(input: Omit<T.IssuesAnswerInput, 'owner' | 'repo'>, opts?: RequestOptions): Promise<T.IssuesAnswerOutput>;
991
+ /**
992
+ * Ask a person a question on an issue and read the answer back later from the issue's context (`asks`). `single` takes one of 2 to 10 options, `multi` any number of them, `text` free text; `other` lets a choice question also take free text. The issue reads as needing input, and its assignee is told, until it is answered. You need the issue's lease or write access.
993
+ */
994
+ ask(input: Omit<T.IssuesAskInput, 'owner' | 'repo'>, opts?: RequestOptions): Promise<T.IssuesAskOutput>;
975
995
  /**
976
996
  * Delegate an issue to yourself or your agent for a lease, or renew the lease. The issue returns to ready if the lease lapses.
977
997
  */
@@ -1050,6 +1070,10 @@ export declare class RepoIssuesResource {
1050
1070
  * Follow an issue to be notified of its activity, or stop following it. Needs only read access.
1051
1071
  */
1052
1072
  subscribe(input: Omit<T.IssuesSubscribeInput, 'owner' | 'repo'>, opts?: RequestOptions): Promise<T.IssuesSubscribeOutput>;
1073
+ /**
1074
+ * Take a question back from an issue, answered or not, once its answer is used or it no longer matters. You need the issue's lease or write access.
1075
+ */
1076
+ unask(input: Omit<T.IssuesUnaskInput, 'owner' | 'repo'>, opts?: RequestOptions): Promise<T.IssuesUnaskOutput>;
1053
1077
  /**
1054
1078
  * Take your reaction back from an issue.
1055
1079
  */
@@ -2,4 +2,4 @@ export * from "./api.js";
2
2
  export { type OpId, ops } from "./ops.js";
3
3
  export * as tools from "./tools.js";
4
4
  export type * as types from "./types.js";
5
- export type { AffectedMode, AffectedStep, AgentTrackingState, Annotation, ApiError, Artifacts, AutoMerge, BatchItem, BranchUpdated, CaissonAffected, CaissonAsk, CaissonAstMatch, CaissonAstMatches, CaissonBase, CaissonBashResult, CaissonBatchResult, CaissonChange, CaissonChangeRequest, CaissonChanged, CaissonCommitted, CaissonEdit, CaissonFileRead, CaissonFilesRead, CaissonGlob, CaissonGrep, CaissonGrepCount, CaissonGrepLine, CaissonGrepMatch, CaissonLocated, CaissonLspAnswer, CaissonLspPlace, CaissonLspProgress, CaissonLspQuestion, CaissonLspRenamed, CaissonLspStopped, CaissonPage, CaissonPolicy, CaissonPull, CaissonRefused, CaissonReview, CaissonReviewStatus, CaissonRow, CaissonShipped, CaissonTested, Check, CheckRun, CheckRunAction, CheckRunApp, CheckRunApp2, CheckRunBody, CheckRunBrief, CheckRunList, CheckRunOutput, CheckRunText, CheckSource, CheckState, CheckStep, ChecksState, Claim, CloneDefaults, CloneDefaultsEdit, CloseReason, CodeLine, CodeSnippet, CommentKind, CommentProof, ConflictFile, ConflictKind, ConflictResolution, ConflictSide, ConflictTake, ContextVisibility, CreatedIssue, Delegate, DelegateAsk, DelegateRequest, DeletionScheduled, DiffSide, ErrorCode, ErrorLocation, Event, EventPage, EventSubscription, FailedStep, FileHit, FindingResolution, GithubInstallUrl, GithubInstallation, GithubRepo, GrepMode, Held, HeldDecided, HeldListing, HeldRequest, Hidden, HideReason, Inbox, InboxCounts, InboxItem, Issue, IssueComment, IssueContext, IssueDetail, IssueEvent, IssuePage, IssuePriority, IssueStage, IssueStarted, IssueState, IssueStatus, ItemRef, KeyProof, Label, LabelItem, LabelList, MeUpdated, MergeMethod, Mergeable, Milestone, MilestoneItem, MilestoneList, MilestoneState, MyIssue, MyIssues, NoContent, Opener, PathHit, PathRule, Proof, ProofSource, Pull, PullChecks, PullComment, PullCommit, PullConflicts, PullDetail, PullFile, PullHunk, PullLine, PullMerge, PullPage, PullPatchState, PullThread, QueueBatch, QueueDropped, QueueEntry, QueueStatus, Reaction, Reaction2, ReactionKind, RecoveryCodeList, RefHit, RefHit2, RefResults, RefResults2, RelatedItem, RelatedKind, RelatedLink, RelatedWork, RepoHit, RepoInfo, RepoNote, RepoNoteLimits, RepoNotes, ReviewChange, ReviewComment, ReviewFinding, ReviewFindingInput, ReviewPacket, ReviewRisk, ReviewSince, ReviewSinceFinding, Rollup, Run, RunArtifact, RunCancelled, RunEvent, RunFailures, RunId, RunJob, RunLogPage, RunLogs, RunStep, RunStepLog, RunTests, RunWait, Runs, Sandbox, SandboxBackground, SandboxCaisson, SandboxClass, SandboxExecResult, SandboxHostRef, SandboxIdle, SandboxKind, SandboxOrigin, SandboxPage, SandboxTokenMode, SandboxUsage, SandboxWait, SearchResults, SessionStep, SimilarIssue, SimilarIssues, SkippedWorkflow, SshKey, StackEntry, StopMode, SubIssue, Surface, SymbolHit, SymbolHit2, SymbolResults, SymbolResults2, TestFailure, Token, TokenCreated, TotpSetup, Verdict, Visibility, WaitAnswer, WaitTarget, WorkspaceUnread } from "./types.js";
5
+ export type { AffectedMode, AffectedStep, AgentTrackingState, Annotation, ApiError, Artifacts, AskKind, AskOptionInput, AutoMerge, BatchItem, BranchUpdated, CaissonAffected, CaissonAsk, CaissonAstMatch, CaissonAstMatches, CaissonBase, CaissonBashResult, CaissonBatchResult, CaissonChange, CaissonChangeRequest, CaissonChanged, CaissonCommitted, CaissonEdit, CaissonFileRead, CaissonFilesRead, CaissonGlob, CaissonGrep, CaissonGrepCount, CaissonGrepLine, CaissonGrepMatch, CaissonLocated, CaissonLspAnswer, CaissonLspPlace, CaissonLspProgress, CaissonLspQuestion, CaissonLspRenamed, CaissonLspStopped, CaissonPage, CaissonPolicy, CaissonPull, CaissonRefused, CaissonReview, CaissonReviewStatus, CaissonRow, CaissonShipped, CaissonTested, Check, CheckRun, CheckRunAction, CheckRunApp, CheckRunApp2, CheckRunBody, CheckRunBrief, CheckRunList, CheckRunOutput, CheckRunText, CheckSource, CheckState, CheckStep, ChecksState, Claim, CloneDefaults, CloneDefaultsEdit, CloseReason, CodeLine, CodeSnippet, CommentKind, CommentProof, ConflictFile, ConflictKind, ConflictResolution, ConflictSide, ConflictTake, ContextVisibility, CreatedIssue, Delegate, DelegateAsk, DelegateRequest, DeletionScheduled, DiffSide, ErrorCode, ErrorLocation, Event, EventPage, EventSubscription, FailedStep, FileHit, FindingResolution, GithubInstallUrl, GithubInstallation, GithubRepo, GrepMode, Held, HeldDecided, HeldListing, HeldRequest, Hidden, HideReason, Inbox, InboxCounts, InboxItem, Issue, IssueAsk, IssueAskAnswer, IssueAskOption, IssueComment, IssueContext, IssueDetail, IssueEvent, IssuePage, IssuePriority, IssueStage, IssueStarted, IssueState, IssueStatus, ItemRef, KeyProof, Label, LabelItem, LabelList, MeUpdated, MergeMethod, Mergeable, Milestone, MilestoneItem, MilestoneList, MilestoneState, MyIssue, MyIssues, NoContent, Opener, PathHit, PathRule, Proof, ProofSource, Pull, PullChecks, PullComment, PullCommit, PullConflicts, PullDetail, PullFile, PullHunk, PullLine, PullMerge, PullPage, PullPatchState, PullThread, QueueBatch, QueueDropped, QueueEntry, QueueStatus, Reaction, Reaction2, ReactionKind, RecoveryCodeList, RefHit, RefHit2, RefResults, RefResults2, RelatedItem, RelatedKind, RelatedLink, RelatedWork, RepoHit, RepoInfo, RepoNote, RepoNoteLimits, RepoNotes, ReviewChange, ReviewComment, ReviewFinding, ReviewFindingInput, ReviewPacket, ReviewRisk, ReviewSince, ReviewSinceFinding, Rollup, Run, RunArtifact, RunCancelled, RunEvent, RunFailures, RunId, RunJob, RunLogPage, RunLogs, RunStep, RunStepLog, RunTests, RunWait, Runs, Sandbox, SandboxBackground, SandboxCaisson, SandboxClass, SandboxExecResult, SandboxHostRef, SandboxIdle, SandboxKind, SandboxOrigin, SandboxPage, SandboxTokenMode, SandboxUsage, SandboxWait, SearchResults, SessionStep, SimilarIssue, SimilarIssues, SkippedWorkflow, SshKey, StackEntry, StopMode, SubIssue, Surface, SymbolHit, SymbolHit2, SymbolResults, SymbolResults2, TestFailure, Token, TokenCreated, TotpSetup, Verdict, Visibility, WaitAnswer, WaitTarget, WorkspaceUnread } from "./types.js";
@@ -753,6 +753,32 @@ export declare const ops: {
753
753
  long: false;
754
754
  paginated: false;
755
755
  };
756
+ 'issues.answer': {
757
+ id: string;
758
+ method: 'POST';
759
+ path: string;
760
+ pathParams: string[];
761
+ queryParams: never[];
762
+ bodyParams: string[];
763
+ effect: 'write';
764
+ retry: 'idempotent';
765
+ held: false;
766
+ long: false;
767
+ paginated: false;
768
+ };
769
+ 'issues.ask': {
770
+ id: string;
771
+ method: 'POST';
772
+ path: string;
773
+ pathParams: string[];
774
+ queryParams: never[];
775
+ bodyParams: string[];
776
+ effect: 'write';
777
+ retry: 'none';
778
+ held: false;
779
+ long: false;
780
+ paginated: false;
781
+ };
756
782
  'issues.claim': {
757
783
  id: string;
758
784
  method: 'POST';
@@ -1013,6 +1039,19 @@ export declare const ops: {
1013
1039
  long: false;
1014
1040
  paginated: false;
1015
1041
  };
1042
+ 'issues.unask': {
1043
+ id: string;
1044
+ method: 'DELETE';
1045
+ path: string;
1046
+ pathParams: string[];
1047
+ queryParams: never[];
1048
+ bodyParams: never[];
1049
+ effect: 'write';
1050
+ retry: 'idempotent';
1051
+ held: false;
1052
+ long: false;
1053
+ paginated: false;
1054
+ };
1016
1055
  'issues.unreact': {
1017
1056
  id: string;
1018
1057
  method: 'DELETE';
@@ -38,6 +38,10 @@ export type ApiError = {
38
38
  export type Artifacts = {
39
39
  artifacts: RunArtifact[];
40
40
  };
41
+ /** How a person answers an [`IssueAsk`]: `single` (one option), `multi` (any number of options) or `text` (free text). */
42
+ export type AskKind = 'single' | 'multi' | 'text';
43
+ /** An option as an asker writes it: its label alone, or the label with a description. */
44
+ export type AskOptionInput = string | IssueAskOption;
41
45
  /** A pull request's auto-merge: `GET`, `PUT` and `DELETE pulls/{n}/auto-merge`. */
42
46
  export type AutoMerge = {
43
47
  /** Who turned it on; the merge is made as them. */
@@ -914,6 +918,36 @@ export type Issue = {
914
918
  /** Last write of any kind. */
915
919
  updatedAt: string;
916
920
  };
921
+ /** A question for a person, answered in place. */
922
+ export type IssueAsk = {
923
+ agent?: string | null;
924
+ /** `None` until someone answers. */
925
+ answer?: IssueAskAnswer | null;
926
+ at: string;
927
+ by: string;
928
+ /** Pass it to `issue answer` and `issue unask`. */
929
+ id: string;
930
+ kind: AskKind;
931
+ options?: IssueAskOption[];
932
+ /** A `single` or `multi` question that also takes free text beside its options. */
933
+ other?: boolean;
934
+ /** The label of the option the asker suggests. */
935
+ recommended?: string | null;
936
+ text: string;
937
+ };
938
+ export type IssueAskAnswer = {
939
+ agent?: string | null;
940
+ at: string;
941
+ by: string;
942
+ /** The labels of the options picked. */
943
+ choices?: string[];
944
+ /** The free text: the whole answer to a `text` question, or what an `other` answer adds. */
945
+ text?: string;
946
+ };
947
+ export type IssueAskOption = {
948
+ description?: string | null;
949
+ label: string;
950
+ };
917
951
  export type IssueComment = {
918
952
  agent: boolean;
919
953
  at: string;
@@ -935,6 +969,8 @@ export type IssueComment = {
935
969
  /** Where the work stands, for whoever picks the issue up next. */
936
970
  export type IssueContext = {
937
971
  agent?: string | null;
972
+ /** Questions with a kind and options, answered in place; an unanswered one makes the issue read as needing input. */
973
+ asks?: IssueAsk[];
938
974
  at: string;
939
975
  branch?: string | null;
940
976
  /** The account that last wrote it. */
@@ -2958,6 +2994,46 @@ export type InboxReadInput = {
2958
2994
  tab?: string | null;
2959
2995
  };
2960
2996
  export type InboxReadOutput = null;
2997
+ /**
2998
+ * Answer a question on an issue, replacing an earlier answer: `choices` are option labels (one for `single`, any for `multi`), `text` the free-text answer of a `text` question or an `other` answer. You need write access or the issue's lease.
2999
+ */
3000
+ export type IssuesAnswerInput = {
3001
+ /** The labels of the options picked. */
3002
+ choices?: string[];
3003
+ /** The question's id, from the issue's context. */
3004
+ id: string;
3005
+ /** Issue number. */
3006
+ number: number;
3007
+ /** The repository's owner: a user or an org handle. */
3008
+ owner: string;
3009
+ /** The repository's name. */
3010
+ repo: string;
3011
+ /** The answer in your own words. */
3012
+ text?: string;
3013
+ };
3014
+ export type IssuesAnswerOutput = Issue;
3015
+ /**
3016
+ * Ask a person a question on an issue and read the answer back later from the issue's context (`asks`). `single` takes one of 2 to 10 options, `multi` any number of them, `text` free text; `other` lets a choice question also take free text. The issue reads as needing input, and its assignee is told, until it is answered. You need the issue's lease or write access.
3017
+ */
3018
+ export type IssuesAskInput = {
3019
+ /** `single` (pick one option), `multi` (pick any) or `text` (free text). */
3020
+ kind: AskKind;
3021
+ /** Issue number. */
3022
+ number: number;
3023
+ /** The choices of a `single` or `multi` question, 2 to 10, each a label or `{label, description}`; none for `text`. */
3024
+ options?: AskOptionInput[];
3025
+ /** true lets a `single` or `multi` question also take an answer in the person's own words. */
3026
+ other?: boolean;
3027
+ /** The repository's owner: a user or an org handle. */
3028
+ owner: string;
3029
+ /** The label of the option you suggest. */
3030
+ recommended?: string | null;
3031
+ /** The repository's name. */
3032
+ repo: string;
3033
+ /** The whole question, in Markdown, with what the person needs to answer it (up to 2000 characters). */
3034
+ text: string;
3035
+ };
3036
+ export type IssuesAskOutput = Issue;
2961
3037
  /**
2962
3038
  * Delegate an issue to yourself or your agent for a lease, or renew the lease. The issue returns to ready if the lease lapses.
2963
3039
  */
@@ -3320,6 +3396,20 @@ export type IssuesSubscribeInput = {
3320
3396
  subscribed: boolean;
3321
3397
  };
3322
3398
  export type IssuesSubscribeOutput = Issue;
3399
+ /**
3400
+ * Take a question back from an issue, answered or not, once its answer is used or it no longer matters. You need the issue's lease or write access.
3401
+ */
3402
+ export type IssuesUnaskInput = {
3403
+ /** The question's id, from the issue's context. */
3404
+ id: string;
3405
+ /** Issue number. */
3406
+ number: number;
3407
+ /** The repository's owner: a user or an org handle. */
3408
+ owner: string;
3409
+ /** The repository's name. */
3410
+ repo: string;
3411
+ };
3412
+ export type IssuesUnaskOutput = Issue;
3323
3413
  /**
3324
3414
  * Take your reaction back from an issue.
3325
3415
  */
@@ -1,2 +1,2 @@
1
- export declare const VERSION = "0.2.0";
1
+ export declare const VERSION = "0.3.0";
2
2
  export declare const API_VERSION = "2026-12-01";
@@ -267,6 +267,14 @@ export declare class InboxResource {
267
267
  export declare class IssuesResource {
268
268
  private readonly core;
269
269
  constructor(core: Core);
270
+ /**
271
+ * Answer a question on an issue, replacing an earlier answer: `choices` are option labels (one for `single`, any for `multi`), `text` the free-text answer of a `text` question or an `other` answer. You need write access or the issue's lease.
272
+ */
273
+ answer(input: T.IssuesAnswerInput, opts?: RequestOptions): Promise<T.IssuesAnswerOutput>;
274
+ /**
275
+ * Ask a person a question on an issue and read the answer back later from the issue's context (`asks`). `single` takes one of 2 to 10 options, `multi` any number of them, `text` free text; `other` lets a choice question also take free text. The issue reads as needing input, and its assignee is told, until it is answered. You need the issue's lease or write access.
276
+ */
277
+ ask(input: T.IssuesAskInput, opts?: RequestOptions): Promise<T.IssuesAskOutput>;
270
278
  /**
271
279
  * Delegate an issue to yourself or your agent for a lease, or renew the lease. The issue returns to ready if the lease lapses.
272
280
  */
@@ -349,6 +357,10 @@ export declare class IssuesResource {
349
357
  * Follow an issue to be notified of its activity, or stop following it. Needs only read access.
350
358
  */
351
359
  subscribe(input: T.IssuesSubscribeInput, opts?: RequestOptions): Promise<T.IssuesSubscribeOutput>;
360
+ /**
361
+ * Take a question back from an issue, answered or not, once its answer is used or it no longer matters. You need the issue's lease or write access.
362
+ */
363
+ unask(input: T.IssuesUnaskInput, opts?: RequestOptions): Promise<T.IssuesUnaskOutput>;
352
364
  /**
353
365
  * Take your reaction back from an issue.
354
366
  */
@@ -972,6 +984,14 @@ export declare class RepoIssuesResource {
972
984
  private readonly core;
973
985
  private readonly bound;
974
986
  constructor(core: Core, bound: RepoBound);
987
+ /**
988
+ * Answer a question on an issue, replacing an earlier answer: `choices` are option labels (one for `single`, any for `multi`), `text` the free-text answer of a `text` question or an `other` answer. You need write access or the issue's lease.
989
+ */
990
+ answer(input: Omit<T.IssuesAnswerInput, 'owner' | 'repo'>, opts?: RequestOptions): Promise<T.IssuesAnswerOutput>;
991
+ /**
992
+ * Ask a person a question on an issue and read the answer back later from the issue's context (`asks`). `single` takes one of 2 to 10 options, `multi` any number of them, `text` free text; `other` lets a choice question also take free text. The issue reads as needing input, and its assignee is told, until it is answered. You need the issue's lease or write access.
993
+ */
994
+ ask(input: Omit<T.IssuesAskInput, 'owner' | 'repo'>, opts?: RequestOptions): Promise<T.IssuesAskOutput>;
975
995
  /**
976
996
  * Delegate an issue to yourself or your agent for a lease, or renew the lease. The issue returns to ready if the lease lapses.
977
997
  */
@@ -1050,6 +1070,10 @@ export declare class RepoIssuesResource {
1050
1070
  * Follow an issue to be notified of its activity, or stop following it. Needs only read access.
1051
1071
  */
1052
1072
  subscribe(input: Omit<T.IssuesSubscribeInput, 'owner' | 'repo'>, opts?: RequestOptions): Promise<T.IssuesSubscribeOutput>;
1073
+ /**
1074
+ * Take a question back from an issue, answered or not, once its answer is used or it no longer matters. You need the issue's lease or write access.
1075
+ */
1076
+ unask(input: Omit<T.IssuesUnaskInput, 'owner' | 'repo'>, opts?: RequestOptions): Promise<T.IssuesUnaskOutput>;
1053
1077
  /**
1054
1078
  * Take your reaction back from an issue.
1055
1079
  */
@@ -2,4 +2,4 @@ export * from "./api.js";
2
2
  export { type OpId, ops } from "./ops.js";
3
3
  export * as tools from "./tools.js";
4
4
  export type * as types from "./types.js";
5
- export type { AffectedMode, AffectedStep, AgentTrackingState, Annotation, ApiError, Artifacts, AutoMerge, BatchItem, BranchUpdated, CaissonAffected, CaissonAsk, CaissonAstMatch, CaissonAstMatches, CaissonBase, CaissonBashResult, CaissonBatchResult, CaissonChange, CaissonChangeRequest, CaissonChanged, CaissonCommitted, CaissonEdit, CaissonFileRead, CaissonFilesRead, CaissonGlob, CaissonGrep, CaissonGrepCount, CaissonGrepLine, CaissonGrepMatch, CaissonLocated, CaissonLspAnswer, CaissonLspPlace, CaissonLspProgress, CaissonLspQuestion, CaissonLspRenamed, CaissonLspStopped, CaissonPage, CaissonPolicy, CaissonPull, CaissonRefused, CaissonReview, CaissonReviewStatus, CaissonRow, CaissonShipped, CaissonTested, Check, CheckRun, CheckRunAction, CheckRunApp, CheckRunApp2, CheckRunBody, CheckRunBrief, CheckRunList, CheckRunOutput, CheckRunText, CheckSource, CheckState, CheckStep, ChecksState, Claim, CloneDefaults, CloneDefaultsEdit, CloseReason, CodeLine, CodeSnippet, CommentKind, CommentProof, ConflictFile, ConflictKind, ConflictResolution, ConflictSide, ConflictTake, ContextVisibility, CreatedIssue, Delegate, DelegateAsk, DelegateRequest, DeletionScheduled, DiffSide, ErrorCode, ErrorLocation, Event, EventPage, EventSubscription, FailedStep, FileHit, FindingResolution, GithubInstallUrl, GithubInstallation, GithubRepo, GrepMode, Held, HeldDecided, HeldListing, HeldRequest, Hidden, HideReason, Inbox, InboxCounts, InboxItem, Issue, IssueComment, IssueContext, IssueDetail, IssueEvent, IssuePage, IssuePriority, IssueStage, IssueStarted, IssueState, IssueStatus, ItemRef, KeyProof, Label, LabelItem, LabelList, MeUpdated, MergeMethod, Mergeable, Milestone, MilestoneItem, MilestoneList, MilestoneState, MyIssue, MyIssues, NoContent, Opener, PathHit, PathRule, Proof, ProofSource, Pull, PullChecks, PullComment, PullCommit, PullConflicts, PullDetail, PullFile, PullHunk, PullLine, PullMerge, PullPage, PullPatchState, PullThread, QueueBatch, QueueDropped, QueueEntry, QueueStatus, Reaction, Reaction2, ReactionKind, RecoveryCodeList, RefHit, RefHit2, RefResults, RefResults2, RelatedItem, RelatedKind, RelatedLink, RelatedWork, RepoHit, RepoInfo, RepoNote, RepoNoteLimits, RepoNotes, ReviewChange, ReviewComment, ReviewFinding, ReviewFindingInput, ReviewPacket, ReviewRisk, ReviewSince, ReviewSinceFinding, Rollup, Run, RunArtifact, RunCancelled, RunEvent, RunFailures, RunId, RunJob, RunLogPage, RunLogs, RunStep, RunStepLog, RunTests, RunWait, Runs, Sandbox, SandboxBackground, SandboxCaisson, SandboxClass, SandboxExecResult, SandboxHostRef, SandboxIdle, SandboxKind, SandboxOrigin, SandboxPage, SandboxTokenMode, SandboxUsage, SandboxWait, SearchResults, SessionStep, SimilarIssue, SimilarIssues, SkippedWorkflow, SshKey, StackEntry, StopMode, SubIssue, Surface, SymbolHit, SymbolHit2, SymbolResults, SymbolResults2, TestFailure, Token, TokenCreated, TotpSetup, Verdict, Visibility, WaitAnswer, WaitTarget, WorkspaceUnread } from "./types.js";
5
+ export type { AffectedMode, AffectedStep, AgentTrackingState, Annotation, ApiError, Artifacts, AskKind, AskOptionInput, AutoMerge, BatchItem, BranchUpdated, CaissonAffected, CaissonAsk, CaissonAstMatch, CaissonAstMatches, CaissonBase, CaissonBashResult, CaissonBatchResult, CaissonChange, CaissonChangeRequest, CaissonChanged, CaissonCommitted, CaissonEdit, CaissonFileRead, CaissonFilesRead, CaissonGlob, CaissonGrep, CaissonGrepCount, CaissonGrepLine, CaissonGrepMatch, CaissonLocated, CaissonLspAnswer, CaissonLspPlace, CaissonLspProgress, CaissonLspQuestion, CaissonLspRenamed, CaissonLspStopped, CaissonPage, CaissonPolicy, CaissonPull, CaissonRefused, CaissonReview, CaissonReviewStatus, CaissonRow, CaissonShipped, CaissonTested, Check, CheckRun, CheckRunAction, CheckRunApp, CheckRunApp2, CheckRunBody, CheckRunBrief, CheckRunList, CheckRunOutput, CheckRunText, CheckSource, CheckState, CheckStep, ChecksState, Claim, CloneDefaults, CloneDefaultsEdit, CloseReason, CodeLine, CodeSnippet, CommentKind, CommentProof, ConflictFile, ConflictKind, ConflictResolution, ConflictSide, ConflictTake, ContextVisibility, CreatedIssue, Delegate, DelegateAsk, DelegateRequest, DeletionScheduled, DiffSide, ErrorCode, ErrorLocation, Event, EventPage, EventSubscription, FailedStep, FileHit, FindingResolution, GithubInstallUrl, GithubInstallation, GithubRepo, GrepMode, Held, HeldDecided, HeldListing, HeldRequest, Hidden, HideReason, Inbox, InboxCounts, InboxItem, Issue, IssueAsk, IssueAskAnswer, IssueAskOption, IssueComment, IssueContext, IssueDetail, IssueEvent, IssuePage, IssuePriority, IssueStage, IssueStarted, IssueState, IssueStatus, ItemRef, KeyProof, Label, LabelItem, LabelList, MeUpdated, MergeMethod, Mergeable, Milestone, MilestoneItem, MilestoneList, MilestoneState, MyIssue, MyIssues, NoContent, Opener, PathHit, PathRule, Proof, ProofSource, Pull, PullChecks, PullComment, PullCommit, PullConflicts, PullDetail, PullFile, PullHunk, PullLine, PullMerge, PullPage, PullPatchState, PullThread, QueueBatch, QueueDropped, QueueEntry, QueueStatus, Reaction, Reaction2, ReactionKind, RecoveryCodeList, RefHit, RefHit2, RefResults, RefResults2, RelatedItem, RelatedKind, RelatedLink, RelatedWork, RepoHit, RepoInfo, RepoNote, RepoNoteLimits, RepoNotes, ReviewChange, ReviewComment, ReviewFinding, ReviewFindingInput, ReviewPacket, ReviewRisk, ReviewSince, ReviewSinceFinding, Rollup, Run, RunArtifact, RunCancelled, RunEvent, RunFailures, RunId, RunJob, RunLogPage, RunLogs, RunStep, RunStepLog, RunTests, RunWait, Runs, Sandbox, SandboxBackground, SandboxCaisson, SandboxClass, SandboxExecResult, SandboxHostRef, SandboxIdle, SandboxKind, SandboxOrigin, SandboxPage, SandboxTokenMode, SandboxUsage, SandboxWait, SearchResults, SessionStep, SimilarIssue, SimilarIssues, SkippedWorkflow, SshKey, StackEntry, StopMode, SubIssue, Surface, SymbolHit, SymbolHit2, SymbolResults, SymbolResults2, TestFailure, Token, TokenCreated, TotpSetup, Verdict, Visibility, WaitAnswer, WaitTarget, WorkspaceUnread } from "./types.js";
@@ -753,6 +753,32 @@ export declare const ops: {
753
753
  long: false;
754
754
  paginated: false;
755
755
  };
756
+ 'issues.answer': {
757
+ id: string;
758
+ method: 'POST';
759
+ path: string;
760
+ pathParams: string[];
761
+ queryParams: never[];
762
+ bodyParams: string[];
763
+ effect: 'write';
764
+ retry: 'idempotent';
765
+ held: false;
766
+ long: false;
767
+ paginated: false;
768
+ };
769
+ 'issues.ask': {
770
+ id: string;
771
+ method: 'POST';
772
+ path: string;
773
+ pathParams: string[];
774
+ queryParams: never[];
775
+ bodyParams: string[];
776
+ effect: 'write';
777
+ retry: 'none';
778
+ held: false;
779
+ long: false;
780
+ paginated: false;
781
+ };
756
782
  'issues.claim': {
757
783
  id: string;
758
784
  method: 'POST';
@@ -1013,6 +1039,19 @@ export declare const ops: {
1013
1039
  long: false;
1014
1040
  paginated: false;
1015
1041
  };
1042
+ 'issues.unask': {
1043
+ id: string;
1044
+ method: 'DELETE';
1045
+ path: string;
1046
+ pathParams: string[];
1047
+ queryParams: never[];
1048
+ bodyParams: never[];
1049
+ effect: 'write';
1050
+ retry: 'idempotent';
1051
+ held: false;
1052
+ long: false;
1053
+ paginated: false;
1054
+ };
1016
1055
  'issues.unreact': {
1017
1056
  id: string;
1018
1057
  method: 'DELETE';