@aspectlylabs/mikka 0.0.256 → 0.0.257

package/cli.js

@@ -4519,7 +4519,7 @@ import { join as join4 } from "node:path";
 // package.json
 var package_default = {
   name: "@mikka/daemon",
-  version: "0.0.256",
+  version: "0.0.257",
   description: "Local Mikka daemon: runs agents through the user's own CLIs",
   type: "module",
   private: true,
@@ -4578,7 +4578,7 @@ var package_default = {
   engines: {
     node: ">=24"
   },
-  gitHead: "dfd54633dbefc8f05c8dfa06477865e10ff5fab0"
+  gitHead: "816eb7fc61aa47fcb43d9448364870c0507c51e0"
 };
 
 // src/paths.ts

package/client.js

@@ -3763,7 +3763,7 @@ import { join } from "node:path";
 // package.json
 var package_default = {
   name: "@mikka/daemon",
-  version: "0.0.256",
+  version: "0.0.257",
   description: "Local Mikka daemon: runs agents through the user's own CLIs",
   type: "module",
   private: true,
@@ -3822,7 +3822,7 @@ var package_default = {
   engines: {
     node: ">=24"
   },
-  gitHead: "dfd54633dbefc8f05c8dfa06477865e10ff5fab0"
+  gitHead: "816eb7fc61aa47fcb43d9448364870c0507c51e0"
 };
 
 // src/paths.ts

package/github-credentials.mjs

@@ -7,6 +7,46 @@ import { pathToFileURL } from 'node:url'
 
 const MAX_CACHE_AGE = 50 * 60_000
 
+/**
+ * The server's reason a run's GitHub token was not issued, in words a person
+ * can act on, English then Chinese. Only these known codes are shown; any
+ * other response says GitHub credentials are unavailable.
+ */
+export const RUN_GITHUB_ERROR_MESSAGES = {
+  githubAppNotConfigured: ['The Mikka GitHub App is not set up on this Mikka server.', '这台 Mikka 服务器还没有配置 Mikka GitHub App。'],
+  githubIdentityRequired: ['Connect a GitHub account in Mikka (Plugins › GitHub) to work on this repository.', '在 Mikka 的插件 › GitHub 里连接一个 GitHub 账号后，才能处理这个仓库。'],
+  githubAppNotInstalled: ['Install the Mikka GitHub App on this repository.', '这个仓库还没有安装 Mikka GitHub App。'],
+  githubAppSuspended: ['The Mikka GitHub App is suspended on this repository.', 'Mikka GitHub App 在这个仓库上已被暂停。'],
+  githubAppPermissionRequired: ['Give the Mikka GitHub App pull request write and contents read access on this repository.', 'Mikka GitHub App 在这个仓库上缺少 Pull request 写权限或 Contents 读权限。'],
+  githubAccountNoWriteAccess: ['Your connected GitHub account cannot write to this repository.', '你连接的 GitHub 账号没有这个仓库的写权限。'],
+  githubRepositoryNotSupported: ['Only github.com repositories are supported.', '目前只支持 github.com 上的仓库。'],
+  githubRateLimited: ['GitHub is rate limiting requests. Try again in a few minutes.', 'GitHub 暂时限流，几分钟后再试。'],
+  runGitHubUnavailable: ['GitHub is unavailable right now. Try again later.', 'GitHub 暂时不可用，稍后再试。'],
+  runGitHubAccessDenied: ['This run can no longer use GitHub: it ended or changed repository.', '这个线程已结束或换了仓库，不能再使用 GitHub。'],
+}
+
+/** A failed token exchange, carrying only the server's known error code. */
+export class RunGitHubCredentialError extends Error {
+  constructor(code) {
+    super('Run GitHub credentials unavailable')
+    this.name = 'RunGitHubCredentialError'
+    this.code = Object.hasOwn(RUN_GITHUB_ERROR_MESSAGES, code) ? code : null
+  }
+}
+
+/** The lines a person sees on stderr for a failure; never a response body. */
+export function credentialFailureMessage(error) {
+  const lines = error instanceof RunGitHubCredentialError && error.code ? RUN_GITHUB_ERROR_MESSAGES[error.code] : null
+  return lines ? `Mikka: ${lines[0]}\nMikka：${lines[1]}\n` : 'Mikka GitHub credentials or CI status unavailable.\n'
+}
+
+async function errorCode(response) {
+  try {
+    const body = await response.json()
+    return typeof body?.error === 'string' ? body.error : null
+  } catch { return null }
+}
+
 export function matchesGitRepository(input, repository) {
   return input.protocol === 'https' && input.host === 'github.com' &&
     [repository, `${repository}.git`].some(path => input.path?.toLowerCase() === path.toLowerCase())
@@ -26,7 +66,7 @@ export async function getRunGitHubToken(config, { fetcher = fetch, now = Date.no
     method: 'POST', redirect: 'error', cache: 'no-store',
     headers: { authorization: `Bearer ${config.runToken}` }, signal: AbortSignal.timeout(15_000),
   })
-  if (!response.ok) throw new Error('Run GitHub credentials unavailable')
+  if (!response.ok) throw new RunGitHubCredentialError(await errorCode(response))
   const result = await response.json()
   if (result.repository?.toLowerCase() !== config.repository.toLowerCase() || typeof result.token !== 'string' || !result.token ||
     !Number.isFinite(Date.parse(result.expiresAt)) || Date.parse(result.expiresAt) - now() <= minValidityMs) throw new Error('Invalid run GitHub credentials')
@@ -90,5 +130,5 @@ async function main() {
 }
 
 if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
-  main().catch(() => { process.stderr.write('Mikka GitHub credentials or CI status unavailable.\n'); process.exitCode = 1 })
+  main().catch(error => { process.stderr.write(credentialFailureMessage(error)); process.exitCode = 1 })
 }

package/http-link.js

@@ -4011,7 +4011,7 @@ var InvalidIdError = class extends DaemonError {
 // package.json
 var package_default = {
   name: "@mikka/daemon",
-  version: "0.0.256",
+  version: "0.0.257",
   description: "Local Mikka daemon: runs agents through the user's own CLIs",
   type: "module",
   private: true,
@@ -4070,7 +4070,7 @@ var package_default = {
   engines: {
     node: ">=24"
   },
-  gitHead: "dfd54633dbefc8f05c8dfa06477865e10ff5fab0"
+  gitHead: "816eb7fc61aa47fcb43d9448364870c0507c51e0"
 };
 
 // src/paths.ts

package/login.js

@@ -3770,7 +3770,7 @@ var ServerUnreachableError = class extends DaemonError {
 // package.json
 var package_default = {
   name: "@mikka/daemon",
-  version: "0.0.256",
+  version: "0.0.257",
   description: "Local Mikka daemon: runs agents through the user's own CLIs",
   type: "module",
   private: true,
@@ -3829,7 +3829,7 @@ var package_default = {
   engines: {
     node: ">=24"
   },
-  gitHead: "dfd54633dbefc8f05c8dfa06477865e10ff5fab0"
+  gitHead: "816eb7fc61aa47fcb43d9448364870c0507c51e0"
 };
 
 // src/paths.ts

package/main.js

@@ -3888,7 +3888,7 @@ import { join as join5 } from "node:path";
 // package.json
 var package_default = {
   name: "@mikka/daemon",
-  version: "0.0.256",
+  version: "0.0.257",
   description: "Local Mikka daemon: runs agents through the user's own CLIs",
   type: "module",
   private: true,
@@ -3947,7 +3947,7 @@ var package_default = {
   engines: {
     node: ">=24"
   },
-  gitHead: "dfd54633dbefc8f05c8dfa06477865e10ff5fab0"
+  gitHead: "816eb7fc61aa47fcb43d9448364870c0507c51e0"
 };
 
 // src/paths.ts

package/mikka-release-manifest.json

@@ -1,11 +1,11 @@
 {
   "version": 1,
-  "sourceSha": "dfd54633dbefc8f05c8dfa06477865e10ff5fab0",
+  "sourceSha": "816eb7fc61aa47fcb43d9448364870c0507c51e0",
   "repository": "alexj11324/Mikka",
-  "buildRunId": "41382673639",
+  "buildRunId": "41382982419",
   "buildKind": "github-actions-main",
   "sourceLockSha256": "d5866677d0c52d856be14efba47832070bc7f2fb92ef64b3bb253a4836587d30",
-  "createdAt": "2026-11-02T03:55:44.159Z",
+  "createdAt": "2026-11-02T03:59:12.759Z",
   "sbom": "sbom.cdx.json",
   "files": [
     {
@@ -36,12 +36,12 @@
     {
       "path": "cli.js",
       "size": 589846,
-      "sha256": "85fe46c3e5d7b0efff94070280f69d854ccc5fb69cc5d627eb9096509fbddeb7"
+      "sha256": "7bfeed0e488d2de9d6057bbc845a7c69cf2a2ada436a3760bbf2a42e0d8e8cb6"
     },
     {
       "path": "client.js",
       "size": 142669,
-      "sha256": "f1c0491781e7d09e0c5129698a49bfcf3b25d7ec7c9e8a2f65622dd8084be26d"
+      "sha256": "7e625a11583d88c7049a8499c8b830634a9a416a9eb47f2d53091808b2109bb7"
     },
     {
       "path": "computer/driver.mjs",
@@ -145,8 +145,8 @@
     },
     {
       "path": "github-credentials.mjs",
-      "size": 4802,
-      "sha256": "de57416ff8ce85d97b82b0c0fc17523bd2e787928d14a601dfd07e7caa1d9ce3"
+      "size": 7484,
+      "sha256": "21731ffcdd0b1cdf186da62f8f1f808fa0b47a791b09ffc30b9e45f9ad72118a"
     },
     {
       "path": "harness/cli.mjs",
@@ -166,7 +166,7 @@
     {
       "path": "http-link.js",
       "size": 175107,
-      "sha256": "98dc34b4d7998c1c6b7d28e2adb13a12f5f7f429079c144ac774e25902a9f929"
+      "sha256": "82d4d087c930ce04731afe0d36a47ca6b31f4872c0eea6680423610f461d5c7a"
     },
     {
       "path": "log.js",
@@ -176,12 +176,12 @@
     {
       "path": "login.js",
       "size": 147404,
-      "sha256": "ad68daecf236d5943c512261796319c5ec044ea2713d18b0d9608801d8cf7afb"
+      "sha256": "5c964730174dcfe0249eb1ad0f8fc4df06aa7f4def38fd23ebb2d4bca9e22ed3"
     },
     {
       "path": "main.js",
       "size": 542495,
-      "sha256": "06b45f08dfb1d5106e836c42e0160286ffe7d314c9e0d99c57bbb17338329b33"
+      "sha256": "3506685f5546bd5ab282e4c0b263bb756df8a90eb4d15bc757c225615b5716b1"
     },
     {
       "path": "mikka-mcp.mjs",
@@ -191,22 +191,22 @@
     {
       "path": "mikka.js",
       "size": 589862,
-      "sha256": "3fe75f1ce5ff7de37370e394a945d5201dec0ec5b772ea3b85d9507c5242e0c6"
+      "sha256": "d6bff3e6e9e4ce142895f80dc1bab9b563dbeaff96ec8bbcea62dc5f71ff541d"
     },
     {
       "path": "npm-shrinkwrap.json",
       "size": 76020,
-      "sha256": "73aa24e68d043465e0137d727fc421f9ad4d8057a07fd6a85741a0580672d9e3"
+      "sha256": "fdf0d18d4a5b8c58074bfb8640d1c1e6eca8667c82ac23701d7d8cf446b31d21"
     },
     {
       "path": "package.json",
       "size": 1200,
-      "sha256": "74c435c6efabc28df65618f8d5a61904dd9cdf0fb372c8710efc9ff2a5e1b98c"
+      "sha256": "89e4d8bd0892d8402df2bcff11514cb67c6e4880d806e404cfc22a5f23cfcc9e"
     },
     {
       "path": "paths.js",
       "size": 4117,
-      "sha256": "c6142c2010a9b4cc0d2ef8bc81ffb86fea8956381e08ff54acac7c3dd8f13316"
+      "sha256": "6e7893f4c9beff2e0c04fd6b7d8dd4603bc751d2aa12cc5ef84289ee9bf427ab"
     },
     {
       "path": "sandbox.js",
@@ -216,7 +216,7 @@
     {
       "path": "sbom.cdx.json",
       "size": 139999,
-      "sha256": "3cf66b754413769471a5234648b439db2b8b7267989171d36dbc375657938569"
+      "sha256": "6bc15972f6e59138687cb280d5c81819747c9e66ad72013a843f2606e3ad1994"
     }
   ]
 }

package/mikka.js

@@ -4520,7 +4520,7 @@ import { join as join4 } from "node:path";
 // package.json
 var package_default = {
   name: "@mikka/daemon",
-  version: "0.0.256",
+  version: "0.0.257",
   description: "Local Mikka daemon: runs agents through the user's own CLIs",
   type: "module",
   private: true,
@@ -4579,7 +4579,7 @@ var package_default = {
   engines: {
     node: ">=24"
   },
-  gitHead: "dfd54633dbefc8f05c8dfa06477865e10ff5fab0"
+  gitHead: "816eb7fc61aa47fcb43d9448364870c0507c51e0"
 };
 
 // src/paths.ts

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@aspectlylabs/mikka",
-  "version": "0.0.256",
+  "version": "0.0.257",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@aspectlylabs/mikka",
-      "version": "0.0.256",
+      "version": "0.0.257",
       "license": "AGPL-3.0-only",
       "dependencies": {
         "@agentclientprotocol/sdk": "1.9.0",

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@aspectlylabs/mikka",
-  "version": "0.0.256",
+  "version": "0.0.257",
   "description": "Local Mikka daemon: runs agents through the user's own CLIs",
-  "gitHead": "dfd54633dbefc8f05c8dfa06477865e10ff5fab0",
+  "gitHead": "816eb7fc61aa47fcb43d9448364870c0507c51e0",
   "type": "module",
   "private": false,
   "license": "AGPL-3.0-only",

package/paths.js

@@ -6,7 +6,7 @@ import { join } from "node:path";
 // package.json
 var package_default = {
   name: "@mikka/daemon",
-  version: "0.0.256",
+  version: "0.0.257",
   description: "Local Mikka daemon: runs agents through the user's own CLIs",
   type: "module",
   private: true,
@@ -65,7 +65,7 @@ var package_default = {
   engines: {
     node: ">=24"
   },
-  gitHead: "dfd54633dbefc8f05c8dfa06477865e10ff5fab0"
+  gitHead: "816eb7fc61aa47fcb43d9448364870c0507c51e0"
 };
 
 // src/paths.ts

package/sbom.cdx.json

@@ -2,10 +2,10 @@
   "$schema": "http://cyclonedx.org/schema/bom-1.5.schema.json",
   "bomFormat": "CycloneDX",
   "specVersion": "1.5",
-  "serialNumber": "urn:uuid:3657027a-160e-49d6-a011-1c14345ebeea",
+  "serialNumber": "urn:uuid:e1229d78-3a9f-4a2c-b871-ab1d234461fa",
   "version": 1,
   "metadata": {
-    "timestamp": "2026-11-02T03:55:43.463Z",
+    "timestamp": "2026-11-02T03:59:12.001Z",
     "lifecycles": [
       {
         "phase": "pre-build"
@@ -19,13 +19,13 @@
       }
     ],
     "component": {
-      "bom-ref": "@aspectlylabs/mikka@0.0.256",
+      "bom-ref": "@aspectlylabs/mikka@0.0.257",
       "type": "library",
-      "name": ".retained-build-ls5o4Q",
-      "version": "0.0.256",
+      "name": ".retained-build-x8XcN6",
+      "version": "0.0.257",
       "scope": "required",
       "description": "Local Mikka daemon: runs agents through the user's own CLIs",
-      "purl": "pkg:npm/%40aspectlylabs/mikka@0.0.256",
+      "purl": "pkg:npm/%40aspectlylabs/mikka@0.0.257",
       "properties": [],
       "externalReferences": [
         {
@@ -4489,7 +4489,7 @@
   ],
   "dependencies": [
     {
-      "ref": "@aspectlylabs/mikka@0.0.256",
+      "ref": "@aspectlylabs/mikka@0.0.257",
       "dependsOn": [
         "@agentclientprotocol/sdk@1.9.0",
         "@anthropic-ai/claude-agent-sdk@0.3.305",