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/AGENTS.md +3 -0
- package/LICENSE +17 -15
- package/dist/index.cjs +58 -1
- package/dist/index.js +58 -1
- package/dist/tools.cjs +245 -0
- package/dist/tools.js +245 -0
- package/dist/types/core/version.d.ts +1 -1
- package/dist/types/generated/api.d.ts +24 -0
- package/dist/types/generated/index.d.ts +1 -1
- package/dist/types/generated/ops.d.ts +39 -0
- package/dist/types/generated/types.d.ts +90 -0
- package/dist/types-cjs/core/version.d.ts +1 -1
- package/dist/types-cjs/generated/api.d.ts +24 -0
- package/dist/types-cjs/generated/index.d.ts +1 -1
- package/dist/types-cjs/generated/ops.d.ts +39 -0
- package/dist/types-cjs/generated/types.d.ts +90 -0
- package/llms.txt +3 -0
- package/package.json +2 -2
package/AGENTS.md
CHANGED
|
@@ -108,6 +108,8 @@ const repo = sf.repo("acme/api");
|
|
|
108
108
|
|
|
109
109
|
### issues
|
|
110
110
|
|
|
111
|
+
- `sf.issues.answer(input)`: 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. Scope `repo:write`, write, retry idempotent.
|
|
112
|
+
- `sf.issues.ask(input)`: 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. Scope `repo:write`, write, retry once.
|
|
111
113
|
- `sf.issues.claim(input)`: Delegate an issue to yourself or your agent for a lease, or renew the lease. The issue returns to ready if the lease lapses. Scope `repo:write`, write, retry idempotent.
|
|
112
114
|
- `sf.issues.close(input)`: Close an issue with a reason, after posting an optional comment. Without a `reason` it is `done`, or `duplicate` when `duplicateOf` names the issue it repeats. Scope `repo:write`, destructive, retry idempotent.
|
|
113
115
|
- `sf.issues.comment(input)`: Comment on an issue, or post a progress update as whoever holds its lease. Scope `repo:write`, write, retry idempotent.
|
|
@@ -128,6 +130,7 @@ const repo = sf.repo("acme/api");
|
|
|
128
130
|
- `sf.issues.similar(input)`: Check for issues the title reads like, open ones closest first, to look through before filing a duplicate. Scope `repo:read`, read, retry safe.
|
|
129
131
|
- `sf.issues.start(input)`: Claim an issue and open a caisson on its branch, or return the live caisson already working on it. Safe to repeat. Scope `repo:write`, write, retry idempotent.
|
|
130
132
|
- `sf.issues.subscribe(input)`: Follow an issue to be notified of its activity, or stop following it. Needs only read access. Scope `repo:read`, write, retry idempotent.
|
|
133
|
+
- `sf.issues.unask(input)`: 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. Scope `repo:write`, write, retry idempotent.
|
|
131
134
|
- `sf.issues.unreact(input)`: Take your reaction back from an issue. Scope `repo:read`, write, retry idempotent.
|
|
132
135
|
- `sf.issues.update(input)`: Change any field of an issue. A field left out stays; `null` clears the ones that can be cleared. An issue's author may change its words and whether it is open without write access. Scope `repo:write`, write, retry idempotent.
|
|
133
136
|
|
package/LICENSE
CHANGED
|
@@ -1,19 +1,21 @@
|
|
|
1
|
-
|
|
1
|
+
MIT License
|
|
2
2
|
|
|
3
|
-
Copyright (c) 2026 Sailfork
|
|
3
|
+
Copyright (c) 2026 Sailfork
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
9
11
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
12
14
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/dist/index.cjs
CHANGED
|
@@ -604,7 +604,7 @@ async function resolveToken(host, option) {
|
|
|
604
604
|
}
|
|
605
605
|
|
|
606
606
|
// src/core/version.ts
|
|
607
|
-
var VERSION = "0.
|
|
607
|
+
var VERSION = "0.3.0";
|
|
608
608
|
var API_VERSION = "2026-12-01";
|
|
609
609
|
|
|
610
610
|
// src/core/client.ts
|
|
@@ -1705,6 +1705,32 @@ var ops = {
|
|
|
1705
1705
|
long: false,
|
|
1706
1706
|
paginated: false
|
|
1707
1707
|
},
|
|
1708
|
+
"issues.answer": {
|
|
1709
|
+
id: "issues.answer",
|
|
1710
|
+
method: "POST",
|
|
1711
|
+
path: "/api/repos/{owner}/{repo}/issues/{number}/asks/{id}/answer",
|
|
1712
|
+
pathParams: ["owner", "repo", "number", "id"],
|
|
1713
|
+
queryParams: [],
|
|
1714
|
+
bodyParams: ["choices", "text"],
|
|
1715
|
+
effect: "write",
|
|
1716
|
+
retry: "idempotent",
|
|
1717
|
+
held: false,
|
|
1718
|
+
long: false,
|
|
1719
|
+
paginated: false
|
|
1720
|
+
},
|
|
1721
|
+
"issues.ask": {
|
|
1722
|
+
id: "issues.ask",
|
|
1723
|
+
method: "POST",
|
|
1724
|
+
path: "/api/repos/{owner}/{repo}/issues/{number}/asks",
|
|
1725
|
+
pathParams: ["owner", "repo", "number"],
|
|
1726
|
+
queryParams: [],
|
|
1727
|
+
bodyParams: ["kind", "text", "options", "recommended", "other"],
|
|
1728
|
+
effect: "write",
|
|
1729
|
+
retry: "none",
|
|
1730
|
+
held: false,
|
|
1731
|
+
long: false,
|
|
1732
|
+
paginated: false
|
|
1733
|
+
},
|
|
1708
1734
|
"issues.claim": {
|
|
1709
1735
|
id: "issues.claim",
|
|
1710
1736
|
method: "POST",
|
|
@@ -1965,6 +1991,19 @@ var ops = {
|
|
|
1965
1991
|
long: false,
|
|
1966
1992
|
paginated: false
|
|
1967
1993
|
},
|
|
1994
|
+
"issues.unask": {
|
|
1995
|
+
id: "issues.unask",
|
|
1996
|
+
method: "DELETE",
|
|
1997
|
+
path: "/api/repos/{owner}/{repo}/issues/{number}/asks/{id}",
|
|
1998
|
+
pathParams: ["owner", "repo", "number", "id"],
|
|
1999
|
+
queryParams: [],
|
|
2000
|
+
bodyParams: [],
|
|
2001
|
+
effect: "write",
|
|
2002
|
+
retry: "idempotent",
|
|
2003
|
+
held: false,
|
|
2004
|
+
long: false,
|
|
2005
|
+
paginated: false
|
|
2006
|
+
},
|
|
1968
2007
|
"issues.unreact": {
|
|
1969
2008
|
id: "issues.unreact",
|
|
1970
2009
|
method: "DELETE",
|
|
@@ -2971,6 +3010,12 @@ class IssuesResource {
|
|
|
2971
3010
|
constructor(core) {
|
|
2972
3011
|
this.core = core;
|
|
2973
3012
|
}
|
|
3013
|
+
answer(input, opts) {
|
|
3014
|
+
return this.core.request(ops["issues.answer"], input, opts);
|
|
3015
|
+
}
|
|
3016
|
+
ask(input, opts) {
|
|
3017
|
+
return this.core.request(ops["issues.ask"], input, opts);
|
|
3018
|
+
}
|
|
2974
3019
|
claim(input, opts) {
|
|
2975
3020
|
return this.core.request(ops["issues.claim"], input, opts);
|
|
2976
3021
|
}
|
|
@@ -3032,6 +3077,9 @@ class IssuesResource {
|
|
|
3032
3077
|
subscribe(input, opts) {
|
|
3033
3078
|
return this.core.request(ops["issues.subscribe"], input, opts);
|
|
3034
3079
|
}
|
|
3080
|
+
unask(input, opts) {
|
|
3081
|
+
return this.core.request(ops["issues.unask"], input, opts);
|
|
3082
|
+
}
|
|
3035
3083
|
unreact(input, opts) {
|
|
3036
3084
|
return this.core.request(ops["issues.unreact"], input, opts);
|
|
3037
3085
|
}
|
|
@@ -3584,6 +3632,12 @@ class RepoIssuesResource {
|
|
|
3584
3632
|
this.core = core;
|
|
3585
3633
|
this.bound = bound;
|
|
3586
3634
|
}
|
|
3635
|
+
answer(input, opts) {
|
|
3636
|
+
return this.core.request(ops["issues.answer"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
|
|
3637
|
+
}
|
|
3638
|
+
ask(input, opts) {
|
|
3639
|
+
return this.core.request(ops["issues.ask"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
|
|
3640
|
+
}
|
|
3587
3641
|
claim(input, opts) {
|
|
3588
3642
|
return this.core.request(ops["issues.claim"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
|
|
3589
3643
|
}
|
|
@@ -3642,6 +3696,9 @@ class RepoIssuesResource {
|
|
|
3642
3696
|
subscribe(input, opts) {
|
|
3643
3697
|
return this.core.request(ops["issues.subscribe"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
|
|
3644
3698
|
}
|
|
3699
|
+
unask(input, opts) {
|
|
3700
|
+
return this.core.request(ops["issues.unask"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
|
|
3701
|
+
}
|
|
3645
3702
|
unreact(input, opts) {
|
|
3646
3703
|
return this.core.request(ops["issues.unreact"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
|
|
3647
3704
|
}
|
package/dist/index.js
CHANGED
|
@@ -500,7 +500,7 @@ async function resolveToken(host, option) {
|
|
|
500
500
|
}
|
|
501
501
|
|
|
502
502
|
// src/core/version.ts
|
|
503
|
-
var VERSION = "0.
|
|
503
|
+
var VERSION = "0.3.0";
|
|
504
504
|
var API_VERSION = "2026-12-01";
|
|
505
505
|
|
|
506
506
|
// src/core/client.ts
|
|
@@ -1601,6 +1601,32 @@ var ops = {
|
|
|
1601
1601
|
long: false,
|
|
1602
1602
|
paginated: false
|
|
1603
1603
|
},
|
|
1604
|
+
"issues.answer": {
|
|
1605
|
+
id: "issues.answer",
|
|
1606
|
+
method: "POST",
|
|
1607
|
+
path: "/api/repos/{owner}/{repo}/issues/{number}/asks/{id}/answer",
|
|
1608
|
+
pathParams: ["owner", "repo", "number", "id"],
|
|
1609
|
+
queryParams: [],
|
|
1610
|
+
bodyParams: ["choices", "text"],
|
|
1611
|
+
effect: "write",
|
|
1612
|
+
retry: "idempotent",
|
|
1613
|
+
held: false,
|
|
1614
|
+
long: false,
|
|
1615
|
+
paginated: false
|
|
1616
|
+
},
|
|
1617
|
+
"issues.ask": {
|
|
1618
|
+
id: "issues.ask",
|
|
1619
|
+
method: "POST",
|
|
1620
|
+
path: "/api/repos/{owner}/{repo}/issues/{number}/asks",
|
|
1621
|
+
pathParams: ["owner", "repo", "number"],
|
|
1622
|
+
queryParams: [],
|
|
1623
|
+
bodyParams: ["kind", "text", "options", "recommended", "other"],
|
|
1624
|
+
effect: "write",
|
|
1625
|
+
retry: "none",
|
|
1626
|
+
held: false,
|
|
1627
|
+
long: false,
|
|
1628
|
+
paginated: false
|
|
1629
|
+
},
|
|
1604
1630
|
"issues.claim": {
|
|
1605
1631
|
id: "issues.claim",
|
|
1606
1632
|
method: "POST",
|
|
@@ -1861,6 +1887,19 @@ var ops = {
|
|
|
1861
1887
|
long: false,
|
|
1862
1888
|
paginated: false
|
|
1863
1889
|
},
|
|
1890
|
+
"issues.unask": {
|
|
1891
|
+
id: "issues.unask",
|
|
1892
|
+
method: "DELETE",
|
|
1893
|
+
path: "/api/repos/{owner}/{repo}/issues/{number}/asks/{id}",
|
|
1894
|
+
pathParams: ["owner", "repo", "number", "id"],
|
|
1895
|
+
queryParams: [],
|
|
1896
|
+
bodyParams: [],
|
|
1897
|
+
effect: "write",
|
|
1898
|
+
retry: "idempotent",
|
|
1899
|
+
held: false,
|
|
1900
|
+
long: false,
|
|
1901
|
+
paginated: false
|
|
1902
|
+
},
|
|
1864
1903
|
"issues.unreact": {
|
|
1865
1904
|
id: "issues.unreact",
|
|
1866
1905
|
method: "DELETE",
|
|
@@ -2867,6 +2906,12 @@ class IssuesResource {
|
|
|
2867
2906
|
constructor(core) {
|
|
2868
2907
|
this.core = core;
|
|
2869
2908
|
}
|
|
2909
|
+
answer(input, opts) {
|
|
2910
|
+
return this.core.request(ops["issues.answer"], input, opts);
|
|
2911
|
+
}
|
|
2912
|
+
ask(input, opts) {
|
|
2913
|
+
return this.core.request(ops["issues.ask"], input, opts);
|
|
2914
|
+
}
|
|
2870
2915
|
claim(input, opts) {
|
|
2871
2916
|
return this.core.request(ops["issues.claim"], input, opts);
|
|
2872
2917
|
}
|
|
@@ -2928,6 +2973,9 @@ class IssuesResource {
|
|
|
2928
2973
|
subscribe(input, opts) {
|
|
2929
2974
|
return this.core.request(ops["issues.subscribe"], input, opts);
|
|
2930
2975
|
}
|
|
2976
|
+
unask(input, opts) {
|
|
2977
|
+
return this.core.request(ops["issues.unask"], input, opts);
|
|
2978
|
+
}
|
|
2931
2979
|
unreact(input, opts) {
|
|
2932
2980
|
return this.core.request(ops["issues.unreact"], input, opts);
|
|
2933
2981
|
}
|
|
@@ -3480,6 +3528,12 @@ class RepoIssuesResource {
|
|
|
3480
3528
|
this.core = core;
|
|
3481
3529
|
this.bound = bound;
|
|
3482
3530
|
}
|
|
3531
|
+
answer(input, opts) {
|
|
3532
|
+
return this.core.request(ops["issues.answer"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
|
|
3533
|
+
}
|
|
3534
|
+
ask(input, opts) {
|
|
3535
|
+
return this.core.request(ops["issues.ask"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
|
|
3536
|
+
}
|
|
3483
3537
|
claim(input, opts) {
|
|
3484
3538
|
return this.core.request(ops["issues.claim"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
|
|
3485
3539
|
}
|
|
@@ -3538,6 +3592,9 @@ class RepoIssuesResource {
|
|
|
3538
3592
|
subscribe(input, opts) {
|
|
3539
3593
|
return this.core.request(ops["issues.subscribe"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
|
|
3540
3594
|
}
|
|
3595
|
+
unask(input, opts) {
|
|
3596
|
+
return this.core.request(ops["issues.unask"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
|
|
3597
|
+
}
|
|
3541
3598
|
unreact(input, opts) {
|
|
3542
3599
|
return this.core.request(ops["issues.unreact"], { ...input, owner: this.bound["owner"], repo: this.bound["repo"] }, opts);
|
|
3543
3600
|
}
|
package/dist/tools.cjs
CHANGED
|
@@ -801,6 +801,32 @@ var ops = {
|
|
|
801
801
|
long: false,
|
|
802
802
|
paginated: false
|
|
803
803
|
},
|
|
804
|
+
"issues.answer": {
|
|
805
|
+
id: "issues.answer",
|
|
806
|
+
method: "POST",
|
|
807
|
+
path: "/api/repos/{owner}/{repo}/issues/{number}/asks/{id}/answer",
|
|
808
|
+
pathParams: ["owner", "repo", "number", "id"],
|
|
809
|
+
queryParams: [],
|
|
810
|
+
bodyParams: ["choices", "text"],
|
|
811
|
+
effect: "write",
|
|
812
|
+
retry: "idempotent",
|
|
813
|
+
held: false,
|
|
814
|
+
long: false,
|
|
815
|
+
paginated: false
|
|
816
|
+
},
|
|
817
|
+
"issues.ask": {
|
|
818
|
+
id: "issues.ask",
|
|
819
|
+
method: "POST",
|
|
820
|
+
path: "/api/repos/{owner}/{repo}/issues/{number}/asks",
|
|
821
|
+
pathParams: ["owner", "repo", "number"],
|
|
822
|
+
queryParams: [],
|
|
823
|
+
bodyParams: ["kind", "text", "options", "recommended", "other"],
|
|
824
|
+
effect: "write",
|
|
825
|
+
retry: "none",
|
|
826
|
+
held: false,
|
|
827
|
+
long: false,
|
|
828
|
+
paginated: false
|
|
829
|
+
},
|
|
804
830
|
"issues.claim": {
|
|
805
831
|
id: "issues.claim",
|
|
806
832
|
method: "POST",
|
|
@@ -1061,6 +1087,19 @@ var ops = {
|
|
|
1061
1087
|
long: false,
|
|
1062
1088
|
paginated: false
|
|
1063
1089
|
},
|
|
1090
|
+
"issues.unask": {
|
|
1091
|
+
id: "issues.unask",
|
|
1092
|
+
method: "DELETE",
|
|
1093
|
+
path: "/api/repos/{owner}/{repo}/issues/{number}/asks/{id}",
|
|
1094
|
+
pathParams: ["owner", "repo", "number", "id"],
|
|
1095
|
+
queryParams: [],
|
|
1096
|
+
bodyParams: [],
|
|
1097
|
+
effect: "write",
|
|
1098
|
+
retry: "idempotent",
|
|
1099
|
+
held: false,
|
|
1100
|
+
long: false,
|
|
1101
|
+
paginated: false
|
|
1102
|
+
},
|
|
1064
1103
|
"issues.unreact": {
|
|
1065
1104
|
id: "issues.unreact",
|
|
1066
1105
|
method: "DELETE",
|
|
@@ -4537,6 +4576,171 @@ cursor at or behind the stored one leaves it as it is, so two readers cannot rew
|
|
|
4537
4576
|
tab: "tab"
|
|
4538
4577
|
}
|
|
4539
4578
|
},
|
|
4579
|
+
{
|
|
4580
|
+
name: "issue_answer",
|
|
4581
|
+
op: "issues.answer",
|
|
4582
|
+
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.",
|
|
4583
|
+
schema: {
|
|
4584
|
+
additionalProperties: false,
|
|
4585
|
+
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.",
|
|
4586
|
+
properties: {
|
|
4587
|
+
choices: {
|
|
4588
|
+
default: [],
|
|
4589
|
+
description: "The labels of the options picked.",
|
|
4590
|
+
items: {
|
|
4591
|
+
type: "string"
|
|
4592
|
+
},
|
|
4593
|
+
type: "array"
|
|
4594
|
+
},
|
|
4595
|
+
id: {
|
|
4596
|
+
description: "The question's id, from the issue's context.",
|
|
4597
|
+
type: "string"
|
|
4598
|
+
},
|
|
4599
|
+
number: {
|
|
4600
|
+
description: "Issue number.",
|
|
4601
|
+
format: "int64",
|
|
4602
|
+
type: "integer"
|
|
4603
|
+
},
|
|
4604
|
+
org: {
|
|
4605
|
+
description: "The repository's owner: a user or an org handle.",
|
|
4606
|
+
type: "string"
|
|
4607
|
+
},
|
|
4608
|
+
repo: {
|
|
4609
|
+
description: "The repository's name.",
|
|
4610
|
+
type: "string"
|
|
4611
|
+
},
|
|
4612
|
+
text: {
|
|
4613
|
+
default: "",
|
|
4614
|
+
description: "The answer in your own words.",
|
|
4615
|
+
type: "string"
|
|
4616
|
+
}
|
|
4617
|
+
},
|
|
4618
|
+
required: [
|
|
4619
|
+
"org",
|
|
4620
|
+
"repo",
|
|
4621
|
+
"number",
|
|
4622
|
+
"id"
|
|
4623
|
+
],
|
|
4624
|
+
type: "object"
|
|
4625
|
+
},
|
|
4626
|
+
renames: {
|
|
4627
|
+
choices: "choices",
|
|
4628
|
+
id: "id",
|
|
4629
|
+
number: "number",
|
|
4630
|
+
org: "owner",
|
|
4631
|
+
repo: "repo",
|
|
4632
|
+
text: "text"
|
|
4633
|
+
}
|
|
4634
|
+
},
|
|
4635
|
+
{
|
|
4636
|
+
name: "issue_ask",
|
|
4637
|
+
op: "issues.ask",
|
|
4638
|
+
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.",
|
|
4639
|
+
schema: {
|
|
4640
|
+
$defs: {
|
|
4641
|
+
AskKind: {
|
|
4642
|
+
description: "How a person answers an [`IssueAsk`]: `single` (one option), `multi` (any number of options) or `text` (free text).",
|
|
4643
|
+
enum: [
|
|
4644
|
+
"single",
|
|
4645
|
+
"multi",
|
|
4646
|
+
"text"
|
|
4647
|
+
],
|
|
4648
|
+
type: "string"
|
|
4649
|
+
},
|
|
4650
|
+
AskOptionInput: {
|
|
4651
|
+
anyOf: [
|
|
4652
|
+
{
|
|
4653
|
+
type: "string"
|
|
4654
|
+
},
|
|
4655
|
+
{
|
|
4656
|
+
$ref: "#/$defs/IssueAskOption"
|
|
4657
|
+
}
|
|
4658
|
+
],
|
|
4659
|
+
description: "An option as an asker writes it: its label alone, or the label with a description."
|
|
4660
|
+
},
|
|
4661
|
+
IssueAskOption: {
|
|
4662
|
+
properties: {
|
|
4663
|
+
description: {
|
|
4664
|
+
type: [
|
|
4665
|
+
"string",
|
|
4666
|
+
"null"
|
|
4667
|
+
]
|
|
4668
|
+
},
|
|
4669
|
+
label: {
|
|
4670
|
+
type: "string"
|
|
4671
|
+
}
|
|
4672
|
+
},
|
|
4673
|
+
required: [
|
|
4674
|
+
"label"
|
|
4675
|
+
],
|
|
4676
|
+
type: "object"
|
|
4677
|
+
}
|
|
4678
|
+
},
|
|
4679
|
+
additionalProperties: false,
|
|
4680
|
+
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.",
|
|
4681
|
+
properties: {
|
|
4682
|
+
kind: {
|
|
4683
|
+
$ref: "#/$defs/AskKind",
|
|
4684
|
+
description: "`single` (pick one option), `multi` (pick any) or `text` (free text)."
|
|
4685
|
+
},
|
|
4686
|
+
number: {
|
|
4687
|
+
description: "Issue number.",
|
|
4688
|
+
format: "int64",
|
|
4689
|
+
type: "integer"
|
|
4690
|
+
},
|
|
4691
|
+
options: {
|
|
4692
|
+
default: [],
|
|
4693
|
+
description: "The choices of a `single` or `multi` question, 2 to 10, each a label or `{label, description}`; none for\n`text`.",
|
|
4694
|
+
items: {
|
|
4695
|
+
$ref: "#/$defs/AskOptionInput"
|
|
4696
|
+
},
|
|
4697
|
+
type: "array"
|
|
4698
|
+
},
|
|
4699
|
+
org: {
|
|
4700
|
+
description: "The repository's owner: a user or an org handle.",
|
|
4701
|
+
type: "string"
|
|
4702
|
+
},
|
|
4703
|
+
other: {
|
|
4704
|
+
default: false,
|
|
4705
|
+
description: "true lets a `single` or `multi` question also take an answer in the person's own words.",
|
|
4706
|
+
type: "boolean"
|
|
4707
|
+
},
|
|
4708
|
+
recommended: {
|
|
4709
|
+
description: "The label of the option you suggest.",
|
|
4710
|
+
type: [
|
|
4711
|
+
"string",
|
|
4712
|
+
"null"
|
|
4713
|
+
]
|
|
4714
|
+
},
|
|
4715
|
+
repo: {
|
|
4716
|
+
description: "The repository's name.",
|
|
4717
|
+
type: "string"
|
|
4718
|
+
},
|
|
4719
|
+
text: {
|
|
4720
|
+
description: "The whole question, in Markdown, with what the person needs to answer it (up to 2000 characters).",
|
|
4721
|
+
type: "string"
|
|
4722
|
+
}
|
|
4723
|
+
},
|
|
4724
|
+
required: [
|
|
4725
|
+
"org",
|
|
4726
|
+
"repo",
|
|
4727
|
+
"number",
|
|
4728
|
+
"kind",
|
|
4729
|
+
"text"
|
|
4730
|
+
],
|
|
4731
|
+
type: "object"
|
|
4732
|
+
},
|
|
4733
|
+
renames: {
|
|
4734
|
+
kind: "kind",
|
|
4735
|
+
number: "number",
|
|
4736
|
+
options: "options",
|
|
4737
|
+
org: "owner",
|
|
4738
|
+
other: "other",
|
|
4739
|
+
recommended: "recommended",
|
|
4740
|
+
repo: "repo",
|
|
4741
|
+
text: "text"
|
|
4742
|
+
}
|
|
4743
|
+
},
|
|
4540
4744
|
{
|
|
4541
4745
|
name: "issue_claim",
|
|
4542
4746
|
op: "issues.claim",
|
|
@@ -5727,6 +5931,47 @@ repository.`,
|
|
|
5727
5931
|
repo: "repo"
|
|
5728
5932
|
}
|
|
5729
5933
|
},
|
|
5934
|
+
{
|
|
5935
|
+
name: "issue_unask",
|
|
5936
|
+
op: "issues.unask",
|
|
5937
|
+
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.",
|
|
5938
|
+
schema: {
|
|
5939
|
+
description: `Take a question back from an issue, answered or not, once its answer is used or it no longer matters. You need
|
|
5940
|
+
the issue's lease or write access.`,
|
|
5941
|
+
properties: {
|
|
5942
|
+
id: {
|
|
5943
|
+
description: "The question's id, from the issue's context.",
|
|
5944
|
+
type: "string"
|
|
5945
|
+
},
|
|
5946
|
+
number: {
|
|
5947
|
+
description: "Issue number.",
|
|
5948
|
+
format: "int64",
|
|
5949
|
+
type: "integer"
|
|
5950
|
+
},
|
|
5951
|
+
org: {
|
|
5952
|
+
description: "The repository's owner: a user or an org handle.",
|
|
5953
|
+
type: "string"
|
|
5954
|
+
},
|
|
5955
|
+
repo: {
|
|
5956
|
+
description: "The repository's name.",
|
|
5957
|
+
type: "string"
|
|
5958
|
+
}
|
|
5959
|
+
},
|
|
5960
|
+
required: [
|
|
5961
|
+
"org",
|
|
5962
|
+
"repo",
|
|
5963
|
+
"number",
|
|
5964
|
+
"id"
|
|
5965
|
+
],
|
|
5966
|
+
type: "object"
|
|
5967
|
+
},
|
|
5968
|
+
renames: {
|
|
5969
|
+
id: "id",
|
|
5970
|
+
number: "number",
|
|
5971
|
+
org: "owner",
|
|
5972
|
+
repo: "repo"
|
|
5973
|
+
}
|
|
5974
|
+
},
|
|
5730
5975
|
{
|
|
5731
5976
|
name: "issue_update",
|
|
5732
5977
|
op: "issues.update",
|