@blogic-cz/agent-tools 1.16.2 → 1.17.0

package/README.md

@@ -286,6 +286,12 @@ approval permits exact nonsensitive reads, not script execution or environment f
 
 All tools support `--help` for full usage documentation. Legacy `agent-tools-*` binary names (e.g. `agent-tools-gh`) still work for backwards compatibility.
 
+### GitHub issue subscriptions
+
+`gh-tool issue list --format json` returns `author.login` for each issue. Use `gh-tool viewer --format json` to read the authenticated login.
+
+To unsubscribe from an issue, run `gh-tool issue unsubscribe --issue 123 --repo owner/name --format json`. The command uses GitHub GraphQL and fails if GitHub cannot complete the mutation.
+
 ### Kubernetes command safety
 
 `k8s-tool` parses generic kubectl commands into arguments and invokes `kubectl` directly. Shell pipelines, chaining, substitution, user overrides of the configured cluster or credentials, mutating `config`/`auth` subcommands, and `cluster-info dump` are rejected. Direct Secret reads, raw kubeconfig output, filename/kustomize reads, and `kubectl diff` are also blocked.

package/dist/gh-tool/issue/commands.d.ts

@@ -38,6 +38,11 @@ export declare const issueReopenCommand: Command.Command<"reopen", {
     readonly issue: number;
     readonly repo: Option.Option<string>;
 }, {}, import("#gh/read/transport").GhError, GitHubService>;
+export declare const issueUnsubscribeCommand: Command.Command<"unsubscribe", {
+    readonly format: "json" | "toon";
+    readonly issue: number;
+    readonly repo: Option.Option<string>;
+}, {}, import("#gh/read/transport").GhError, GitHubService>;
 export declare const issueCreateCommand: Command.Command<"create", {
     readonly assignee: Option.Option<string>;
     readonly body: Option.Option<string>;

package/dist/gh-tool/issue/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/gh-tool/issue/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAQ,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAmBxC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAanD,eAAO,MAAM,gBAAgB;;;;;;;;2DAwCwD,CAAC;AAEtF,eAAO,MAAM,gBAAgB;;;;2DAmB5B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;2DAgCiC,CAAC;AAEnE,eAAO,MAAM,iBAAiB;;;;;;;2DAwCoD,CAAC;AAEnF,eAAO,MAAM,kBAAkB;;;;;;2DAmCyB,CAAC;AAEzD,eAAO,MAAM,kBAAkB;;;;;;;;;2DAiDsB,CAAC;AAEtD,eAAO,MAAM,mBAAmB;;;;;;2DA6B6B,CAAC;AAE9D,eAAO,MAAM,gBAAgB;;;;;;;;;;;2DAiEkD,CAAC"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/gh-tool/issue/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAQ,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAoBxC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAanD,eAAO,MAAM,gBAAgB;;;;;;;;2DAwCwD,CAAC;AAEtF,eAAO,MAAM,gBAAgB;;;;2DAmB5B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;2DAgCiC,CAAC;AAEnE,eAAO,MAAM,iBAAiB;;;;;;;2DAwCoD,CAAC;AAEnF,eAAO,MAAM,kBAAkB;;;;;;2DAmCyB,CAAC;AAEzD,eAAO,MAAM,uBAAuB;;;;2DAe+C,CAAC;AAEpF,eAAO,MAAM,kBAAkB;;;;;;;;;2DAiDsB,CAAC;AAEtD,eAAO,MAAM,mBAAmB;;;;;;2DA6B6B,CAAC;AAE9D,eAAO,MAAM,gBAAgB;;;;;;;;;;;2DAiEkD,CAAC"}

package/dist/gh-tool/issue/core.d.ts

@@ -29,8 +29,16 @@ export type IssueListItem = {
     assignees: Array<{
         login: string;
     }>;
+    author: {
+        login: string;
+    } | null;
     createdAt: string;
 };
+export type IssueSubscription = {
+    number: number;
+    url?: string;
+    viewerSubscription: string;
+};
 export type RawIssueComment = {
     id: number;
     user: {
@@ -57,6 +65,9 @@ export declare const listIssues: (opts: {
     readonly assignees: {
         readonly login: string;
     }[];
+    readonly author: {
+        readonly login: string;
+    } | null;
     readonly createdAt: string;
     readonly body: string;
 } | {
@@ -71,6 +82,9 @@ export declare const listIssues: (opts: {
     readonly assignees: {
         readonly login: string;
     }[];
+    readonly author: {
+        readonly login: string;
+    } | null;
     readonly createdAt: string;
 })[], import("#gh/read/transport").GhError, GitHubService>;
 export declare const viewIssue: (issueNumber: number) => Effect.Effect<Pick<{
@@ -135,6 +149,11 @@ export declare const reopenIssue: (opts: {
     readonly body: string;
     readonly closedAt: string | null;
 }, "assignees" | "author" | "closedAt" | "createdAt" | "labels" | "number" | "state" | "title" | "url">, import("#gh/read/transport").GhError, GitHubService>;
+export declare const unsubscribeIssue: (issue: number) => Effect.Effect<{
+    number: number;
+    url?: string | undefined;
+    viewerSubscription: string;
+}, import("#gh/read/transport").GhError, GitHubService>;
 export declare const commentOnIssue: (opts: {
     issue: number;
     body: string;

package/dist/gh-tool/issue/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/gh-tool/issue/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAyB,YAAY,EAAgC,MAAM,WAAW,CAAC;AAGnG,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMnD,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChC,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChC,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAYF,eAAO,MAAM,UAAU;WACd,MAAM;YACL,MAAM,GAAG,IAAI;WACd,MAAM;kBACC,OAAO;YACb,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;0DAIf,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;6JAapB,CAAC;AAEH,eAAO,MAAM,kBAAkB,uLA0B7B,CAAC;AAEH,eAAO,MAAM,UAAU;WACd,MAAM;aACJ,MAAM,GAAG,IAAI;YACd,MAAM;;;;;;;;;;;;;;;;;;6JAgBd,CAAC;AAEH,eAAO,MAAM,WAAW;WACf,MAAM;aACJ,MAAM,GAAG,IAAI;;;;;;;;;;;;;;;;;;6JAgBtB,CAAC;AAEH,eAAO,MAAM,cAAc;WAClB,MAAM;UACP,MAAM;;;;;;;uDAiDZ,CAAC;AAEH,eAAO,MAAM,WAAW;WACf,MAAM;UACP,MAAM;cACF,MAAM,GAAG,IAAI;YACf,MAAM,GAAG,IAAI;;;;;;;;;;;;;;;;;;6JA2BrB,CAAC;AAEH,eAAO,MAAM,SAAS;WACb,MAAM;WACN,MAAM,GAAG,IAAI;UACd,MAAM,GAAG,IAAI;eACR,MAAM,GAAG,IAAI;kBACV,MAAM,GAAG,IAAI;iBACd,MAAM,GAAG,IAAI;oBACV,MAAM,GAAG,IAAI;;;;;;;;;;;;;;;;;;6JA+B7B,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/gh-tool/issue/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAyB,YAAY,EAAgC,MAAM,WAAW,CAAC;AAGnG,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMnD,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChC,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChC,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAYF,eAAO,MAAM,UAAU;WACd,MAAM;YACL,MAAM,GAAG,IAAI;WACd,MAAM;kBACC,OAAO;YACb,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0DAIf,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;6JAapB,CAAC;AAEH,eAAO,MAAM,kBAAkB,uLA0B7B,CAAC;AAEH,eAAO,MAAM,UAAU;WACd,MAAM;aACJ,MAAM,GAAG,IAAI;YACd,MAAM;;;;;;;;;;;;;;;;;;6JAgBd,CAAC;AAEH,eAAO,MAAM,WAAW;WACf,MAAM;aACJ,MAAM,GAAG,IAAI;;;;;;;;;;;;;;;;;;6JAgBtB,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;uDAmC3B,CAAC;AAEH,eAAO,MAAM,cAAc;WAClB,MAAM;UACP,MAAM;;;;;;;uDAiDZ,CAAC;AAEH,eAAO,MAAM,WAAW;WACf,MAAM;UACP,MAAM;cACF,MAAM,GAAG,IAAI;YACf,MAAM,GAAG,IAAI;;;;;;;;;;;;;;;;;;6JA2BrB,CAAC;AAEH,eAAO,MAAM,SAAS;WACb,MAAM;WACN,MAAM,GAAG,IAAI;UACd,MAAM,GAAG,IAAI;eACR,MAAM,GAAG,IAAI;kBACV,MAAM,GAAG,IAAI;iBACd,MAAM,GAAG,IAAI;oBACV,MAAM,GAAG,IAAI;;;;;;;;;;;;;;;;;;6JA+B7B,CAAC"}

package/dist/gh-tool/issue/index.d.ts

@@ -1,3 +1,3 @@
-export { issueCloseCommand, issueCommentCommand, issueCommentsCommand, issueCreateCommand, issueEditCommand, issueListCommand, issueReopenCommand, issueViewCommand, } from "./commands";
+export { issueCloseCommand, issueCommentCommand, issueCommentsCommand, issueCreateCommand, issueEditCommand, issueListCommand, issueReopenCommand, issueViewCommand, issueUnsubscribeCommand, } from "./commands";
 export { issueSnapshotBatchCommand, issueTriageCommand } from "./triage";
 //# sourceMappingURL=index.d.ts.map

package/dist/gh-tool/issue/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gh-tool/issue/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gh-tool/issue/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}

package/dist/gh-tool/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/gh-tool/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAmFrC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA6IjD,eAAO,MAAM,WAAW,gIAiDvB,CAAC;AAoCF,eAAO,MAAM,OAAO,YAGhB,CAAC"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/gh-tool/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAqFrC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA8IjD,eAAO,MAAM,WAAW,gIAkDvB,CAAC;AAoCF,eAAO,MAAM,OAAO,YAGhB,CAAC"}

package/dist/gh-tool/read/issues.d.ts

@@ -26,7 +26,7 @@ export type IssueListFilter = {
     limit: number;
     includeBody?: boolean;
 };
-export declare const ISSUE_LIST_FIELDS = "number,title,state,url,labels,assignees,createdAt";
+export declare const ISSUE_LIST_FIELDS = "number,title,state,url,labels,assignees,author,createdAt";
 export declare const ISSUE_VIEW_FIELDS = "number,title,state,url,labels,assignees,author,body,createdAt,closedAt";
 export declare const issueView: (repo: RepoRef, issue: number, consistency?: "cached" | "origin" | undefined) => Effect.Effect<{
     readonly number: number;
@@ -46,6 +46,10 @@ export declare const issueView: (repo: RepoRef, issue: number, consistency?: "ca
     readonly body: string;
     readonly closedAt: string | null;
 }, import("#gh/read/transport").GhError, GitHubService>;
+export declare const issueNode: (repo: RepoRef, issue: number) => Effect.Effect<{
+    readonly id: string;
+    readonly url?: string | undefined;
+} | null, import("#gh/read/transport").GhError, GitHubService>;
 export declare const issueList: (repo: RepoRef, filter: IssueListFilter, consistency?: "cached" | "origin" | undefined) => Effect.Effect<({
     readonly number: number;
     readonly title: string;
@@ -57,6 +61,9 @@ export declare const issueList: (repo: RepoRef, filter: IssueListFilter, consist
     readonly assignees: {
         readonly login: string;
     }[];
+    readonly author: {
+        readonly login: string;
+    } | null;
     readonly createdAt: string;
     readonly body: string;
 } | {
@@ -71,6 +78,9 @@ export declare const issueList: (repo: RepoRef, filter: IssueListFilter, consist
     readonly assignees: {
         readonly login: string;
     }[];
+    readonly author: {
+        readonly login: string;
+    } | null;
     readonly createdAt: string;
 })[], import("#gh/read/transport").GhError, GitHubService>;
 export declare const issueComments: (repo: RepoRef, issue: number) => Effect.Effect<{

package/dist/gh-tool/read/issues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../../src/gh-tool/read/issues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAetC,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;EAKb,CAAC;AAQH,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAC;AAC9C,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AACF,eAAO,MAAM,iBAAiB,sDAAsD,CAAC;AACrF,eAAO,MAAM,iBAAiB,2EAC4C,CAAC;AAE3E,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;uDAwBpB,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;0DAsCpB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;yDAYxB,CAAC"}
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../../src/gh-tool/read/issues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAgBtC,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;EAKb,CAAC;AAoBH,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAC;AAC9C,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AACF,eAAO,MAAM,iBAAiB,6DAA6D,CAAC;AAC5F,eAAO,MAAM,iBAAiB,2EAC4C,CAAC;AAE3E,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;uDAwBpB,CAAC;AAEH,eAAO,MAAM,SAAS;;;8DAOpB,CAAC;AAEH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0DAsCpB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;yDAYxB,CAAC"}

package/dist/gh-tool/read/reads.d.ts

@@ -32,6 +32,9 @@ export declare const getPRStatusRateLimit: () => Effect.Effect<{
     core: RateLimitResource;
     graphql: RateLimitResource;
 }, never, GitHubService>;
+export declare const viewerLogin: () => Effect.Effect<{
+    readonly login: string;
+}, import("#gh/read/transport").GhError, GitHubService>;
 export declare const resolveRepo: (repo: string | null) => Effect.Effect<RepoRef, import("#gh/read/transport").GhError, GitHubService>;
 export declare const rawJobLog: (path: string) => Effect.Effect<import("#gh/read/transport").GhResult, import("#gh/read/transport").GhError, GitHubService>;
 export declare const reads: {
@@ -261,6 +264,9 @@ export declare const reads: {
         readonly assignees: {
             readonly login: string;
         }[];
+        readonly author: {
+            readonly login: string;
+        } | null;
         readonly createdAt: string;
         readonly body: string;
     } | {
@@ -275,6 +281,9 @@ export declare const reads: {
         readonly assignees: {
             readonly login: string;
         }[];
+        readonly author: {
+            readonly login: string;
+        } | null;
         readonly createdAt: string;
     })[], import("#gh/read/transport").GhError, GitHubService>;
     issueComments: (repo: RepoRef, issue: number) => Effect.Effect<{
@@ -286,5 +295,12 @@ export declare const reads: {
         readonly created_at: string;
         readonly html_url: string;
     }[], import("#gh/read/transport").GhError, GitHubService>;
+    issueNode: (repo: RepoRef, issue: number) => Effect.Effect<{
+        readonly id: string;
+        readonly url?: string | undefined;
+    } | null, import("#gh/read/transport").GhError, GitHubService>;
+    viewerLogin: () => Effect.Effect<{
+        readonly login: string;
+    }, import("#gh/read/transport").GhError, GitHubService>;
 };
 //# sourceMappingURL=reads.d.ts.map

package/dist/gh-tool/read/reads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reads.d.ts","sourceRoot":"","sources":["../../../src/gh-tool/read/reads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAkB,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAkBhD,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAUjD,MAAM,MAAM,MAAM,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AActE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAC3E,MAAM,MAAM,iBAAiB,GACzB,QAAQ,CAAC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC,GACjE,QAAQ,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEhC,eAAO,MAAM,YAAY;;uDAwCvB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;wBAY/B,CAAC;AA+CH,eAAO,MAAM,WAAW,sGAatB,CAAC;AAgHH,eAAO,MAAM,SAAS,6HAWpB,CAAC;AA+EH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BjB,CAAC"}
+{"version":3,"file":"reads.d.ts","sourceRoot":"","sources":["../../../src/gh-tool/read/reads.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAkB,MAAM,QAAQ,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAkBhD,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAUjD,MAAM,MAAM,MAAM,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAetE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAC3E,MAAM,MAAM,iBAAiB,GACzB,QAAQ,CAAC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE,CAAC,GACjE,QAAQ,CAAC;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEhC,eAAO,MAAM,YAAY;;uDAwCvB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;wBAY/B,CAAC;AAEH,eAAO,MAAM,WAAW;;uDAItB,CAAC;AA+CH,eAAO,MAAM,WAAW,sGAatB,CAAC;AAgHH,eAAO,MAAM,SAAS,6HAWpB,CAAC;AA+EH,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BjB,CAAC"}

package/dist/gh-tool/repo.d.ts

@@ -10,6 +10,9 @@ export declare const repoInfoCommand: Command.Command<"info", {
     readonly format: "json" | "toon";
     readonly repo: Option.Option<string>;
 }, {}, import("./read/transport").GhError, GitHubService>;
+export declare const viewerCommand: Command.Command<"viewer", {
+    readonly format: "json" | "toon";
+}, {}, import("./read/transport").GhError, GitHubService>;
 export declare const repoListCommand: Command.Command<"list", {
     readonly format: "json" | "toon";
     readonly limit: number;

package/dist/gh-tool/repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/gh-tool/repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAQ,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIxC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAoBjD,eAAO,MAAM,uBAAuB;;;;yDAiB6D,CAAC;AAElG,eAAO,MAAM,eAAe;;;yDAcqE,CAAC;AAElG,eAAO,MAAM,eAAe;;;;;yDAyB3B,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;yDAoB6C,CAAC"}
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/gh-tool/repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAQ,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAU,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIxC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAoBjD,eAAO,MAAM,uBAAuB;;;;yDAiB6D,CAAC;AAElG,eAAO,MAAM,eAAe;;;yDAcqE,CAAC;AAElG,eAAO,MAAM,aAAa;;yDAImD,CAAC;AAE9E,eAAO,MAAM,eAAe;;;;;yDAyB3B,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;yDAoB6C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blogic-cz/agent-tools",
-  "version": "1.16.2",
+  "version": "1.17.0",
   "description": "CLI tools for AI coding agent workflows — GitHub, database, Kubernetes, Azure platform, Azure DevOps, logs, sessions, and audit",
   "keywords": [
     "agent",

package/src/gh-tool/issue/commands.ts

@@ -16,6 +16,7 @@ import {
   fetchIssueComments,
   listIssues,
   reopenIssue,
+  unsubscribeIssue,
   viewIssue,
 } from "./core";
 import { GitHubService } from "#gh/read/transport";
@@ -207,6 +208,23 @@ export const issueReopenCommand = Command.make(
     ),
 ).pipe(Command.withDescription("Reopen a closed issue"));
 
+export const issueUnsubscribeCommand = Command.make(
+  "unsubscribe",
+  {
+    format: formatOption,
+    issue: Flag.Int("issue").pipe(Flag.withDescription("Issue number to unsubscribe from")),
+    repo: repoOption,
+  },
+  ({ format, issue, repo }) =>
+    withRepo(
+      repo,
+      Effect.gen(function* () {
+        const result = yield* unsubscribeIssue(issue);
+        yield* logFormatted(result, format);
+      }),
+    ),
+).pipe(Command.withDescription("Unsubscribe the authenticated user from an issue"));
+
 export const issueCreateCommand = Command.make(
   "create",
   {

package/src/gh-tool/issue/core.ts

@@ -2,7 +2,7 @@ import { Effect } from "effect";
 
 import type { GitHubIssueCommentUrl, IssueComment, IssueCommentId, IsoTimestamp } from "#gh/types";
 
-import { GitHubCommandError } from "#gh/errors";
+import { GitHubCommandError, GitHubNotFoundError } from "#gh/errors";
 import { GitHubService } from "#gh/read/transport";
 import { reads, resolveRepo } from "#gh/read/reads";
 import { writes } from "#gh/read/writes";
@@ -28,9 +28,16 @@ export type IssueListItem = {
   url: string;
   labels: Array<{ name: string }>;
   assignees: Array<{ login: string }>;
+  author: { login: string } | null;
   createdAt: string;
 };
 
+export type IssueSubscription = {
+  number: number;
+  url?: string;
+  viewerSubscription: string;
+};
+
 export type RawIssueComment = {
   id: number;
   user: { login: string };
@@ -144,6 +151,43 @@ export const reopenIssue = Effect.fn("issue.reopenIssue")(function* (opts: {
   return yield* viewIssue(opts.issue);
 });
 
+export const unsubscribeIssue = Effect.fn("issue.unsubscribeIssue")(function* (issue: number) {
+  const repo = yield* resolveRepo(null);
+  const issueNode = yield* reads.issueNode(repo, issue);
+
+  if (issueNode === null) {
+    return yield* new GitHubNotFoundError({
+      message: `Issue #${issue} was not found in ${repoSlug(repo)}`,
+      resource: "issue",
+      identifier: `${repoSlug(repo)}#${issue}`,
+    });
+  }
+
+  const subscription = (yield* writes.graphql(
+    "mutation($id: ID!) { updateSubscription(input: {subscribableId: $id, state: UNSUBSCRIBED}) { subscribable { viewerSubscription } } }",
+    { id: issueNode.id },
+    [`issue:${repoSlug(repo)}#${issue}`, `issues:${repoSlug(repo)}`],
+  )) as {
+    updateSubscription: { subscribable: { viewerSubscription: string } | null } | null;
+  } | null;
+  const viewerSubscription = subscription?.updateSubscription?.subscribable?.viewerSubscription;
+
+  if (viewerSubscription === undefined || viewerSubscription === null) {
+    return yield* new GitHubCommandError({
+      command: "gh-tool issue unsubscribe",
+      exitCode: 1,
+      message: `GitHub did not return the subscription state for issue #${issue}`,
+      stderr: "The unsubscribe mutation returned no subscription state.",
+    });
+  }
+
+  return {
+    number: issue,
+    ...(issueNode.url === undefined ? {} : { url: issueNode.url }),
+    viewerSubscription,
+  } satisfies IssueSubscription;
+});
+
 export const commentOnIssue = Effect.fn("issue.commentOnIssue")(function* (opts: {
   issue: number;
   body: string;

package/src/gh-tool/issue/index.ts

@@ -7,5 +7,6 @@ export {
   issueListCommand,
   issueReopenCommand,
   issueViewCommand,
+  issueUnsubscribeCommand,
 } from "./commands";
 export { issueSnapshotBatchCommand, issueTriageCommand } from "./triage";

package/src/gh-tool/main.ts

@@ -19,6 +19,7 @@ import {
   issueReopenCommand,
   issueSnapshotBatchCommand,
   issueTriageCommand,
+  issueUnsubscribeCommand,
   issueViewCommand,
 } from "./issue";
 import {
@@ -80,6 +81,7 @@ import {
   repoInfoCommand,
   repoListCommand,
   repoSearchCodeCommand,
+  viewerCommand,
 } from "./repo";
 import { labelCreateCommand } from "./label";
 import { GitHubService } from "./read/transport";
@@ -144,7 +146,7 @@ const prCommand = Command.make("pr", {}).pipe(
 
 const issueCommand = Command.make("issue", {}).pipe(
   Command.withDescription(
-    "Issue operations (list, view, comments, triage, snapshot-batch, create, close, reopen, comment, edit)",
+    "Issue operations (list, view, comments, triage, snapshot-batch, create, close, reopen, unsubscribe, comment, edit)",
   ),
   Command.withSubcommands([
     issueListCommand,
@@ -155,6 +157,7 @@ const issueCommand = Command.make("issue", {}).pipe(
     issueCreateCommand,
     issueCloseCommand,
     issueReopenCommand,
+    issueUnsubscribeCommand,
     issueCommentCommand,
     issueEditCommand,
   ]),
@@ -264,6 +267,7 @@ WORKFLOW FOR AI AGENTS:
     prCommand,
     issueCommand,
     repoCommand,
+    viewerCommand,
     labelCommand,
     branchCommand,
     workflowCommand,

package/src/gh-tool/read/issues.ts

@@ -17,6 +17,7 @@ const IssueListItem = Schema.Struct({
   url: Schema.String,
   labels: Schema.mutable(Schema.Array(Label)),
   assignees: Schema.mutable(Schema.Array(Login)),
+  author: Schema.NullOr(Login),
   createdAt: Schema.String,
 });
 const IssueView = Schema.Struct({
@@ -25,6 +26,18 @@ const IssueView = Schema.Struct({
   body: Schema.String,
   closedAt: Schema.NullOr(Schema.String),
 });
+const IssueNodeLookup = Schema.Struct({
+  repository: Schema.NullOr(
+    Schema.Struct({
+      issue: Schema.NullOr(
+        Schema.Struct({
+          id: Schema.String,
+          url: Schema.optional(Schema.String),
+        }),
+      ),
+    }),
+  ),
+});
 const IssueComment = Schema.Struct({
   id: Schema.Number,
   user: Login,
@@ -39,7 +52,7 @@ export type IssueListFilter = {
   limit: number;
   includeBody?: boolean;
 };
-export const ISSUE_LIST_FIELDS = "number,title,state,url,labels,assignees,createdAt";
+export const ISSUE_LIST_FIELDS = "number,title,state,url,labels,assignees,author,createdAt";
 export const ISSUE_VIEW_FIELDS =
   "number,title,state,url,labels,assignees,author,body,createdAt,closedAt";
 
@@ -69,6 +82,15 @@ export const issueView = Effect.fn("reads.issueView")(function* (
   });
 });
 
+export const issueNode = Effect.fn("reads.issueNode")(function* (repo: RepoRef, issue: number) {
+  const gh = yield* GitHubService;
+  const response = yield* gh.runGraphQL(
+    "query($owner: String!, $name: String!, $number: Int!) { repository(owner: $owner, name: $name) { issue(number: $number) { id url } } }",
+    { owner: repo.owner, name: repo.name, number: issue },
+  );
+  return parsePreserving(IssueNodeLookup)(response).repository?.issue ?? null;
+});
+
 export const issueList = Effect.fn("reads.issueList")(function* (
   repo: RepoRef,
   filter: IssueListFilter,

package/src/gh-tool/read/reads.ts

@@ -5,7 +5,7 @@ import type { CheckRunAnnotation } from "#gh/types";
 import { cachedRead, ReadCache } from "./cache";
 import { OPS } from "./classes";
 import { repoSlug } from "./keys";
-import { issueView, issueList, issueComments } from "./issues";
+import { issueView, issueList, issueComments, issueNode } from "./issues";
 import {
   prView,
   prList,
@@ -41,6 +41,7 @@ const RateLimitResponse = Schema.Struct({
     }),
   ),
 });
+const ViewerLogin = Schema.Struct({ viewer: Schema.Struct({ login: Schema.String }) });
 
 export type RateLimitResource = {
   readonly limit: number;
@@ -111,6 +112,12 @@ export const getPRStatusRateLimit = Effect.fn("reads.getPRStatusRateLimit")(func
   return { core, graphql } satisfies PRStatusRateLimit;
 });
 
+export const viewerLogin = Effect.fn("reads.viewerLogin")(function* () {
+  const gh = yield* GitHubService;
+  const response = yield* gh.runGraphQL("query { viewer { login } }", {});
+  return parsePreserving(ViewerLogin)(response).viewer;
+});
+
 const completedAttemptJobs = Effect.fn("reads.completedAttemptJobs")(function* (
   repo: RepoRef,
   runId: number,
@@ -398,4 +405,6 @@ export const reads = {
   issueView,
   issueList,
   issueComments,
+  issueNode,
+  viewerLogin,
 };

package/src/gh-tool/repo.ts

@@ -5,7 +5,7 @@ import { formatOption, logFormatted } from "#shared";
 import { passthrough } from "./read/catalog";
 import { GitHubService } from "./read/transport";
 import { commitAuthor } from "./read/commits";
-import { resolveRepo } from "./read/reads";
+import { reads, resolveRepo } from "./read/reads";
 
 // ---------------------------------------------------------------------------
 // Types
@@ -58,6 +58,12 @@ export const repoInfoCommand = Command.make(
     }),
 ).pipe(Command.withDescription("Show repository information (owner, name, default branch, URL)"));
 
+export const viewerCommand = Command.make("viewer", { format: formatOption }, ({ format }) =>
+  Effect.gen(function* () {
+    yield* logFormatted(yield* reads.viewerLogin(), format);
+  }),
+).pipe(Command.withDescription("Show the authenticated GitHub user's login"));
+
 export const repoListCommand = Command.make(
   "list",
   {