@openagt/skill-github 0.1.9 → 0.1.11

package/dist/profile.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A GitHub user's public profile: the name and picture a person copies into OpenAgent as their
+ * own, once, when they press "Sync from GitHub". Read from GitHub's public API with no login, so
+ * no account of the person's, nor of OpenAgent's, is asked.
+ */
+export type ProfileOutcome = {
+    ok: true;
+    login: string;
+    name?: string;
+    avatar?: string;
+} | {
+    ok: false;
+    reason: 'no-user' | 'not-reached';
+    detail: string;
+};
+/** What fetches the profile: `fetch` by default. */
+export type ProfileFetch = (url: string, init: {
+    headers: Record<string, string>;
+    signal: AbortSignal;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    json(): Promise<unknown>;
+}>;
+export declare function isGithubLogin(login: string): boolean;
+export declare function publicProfile(login: string, fetcher?: ProfileFetch): Promise<ProfileOutcome>;
+//# sourceMappingURL=profile.d.ts.map

package/dist/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,GAAG,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpE,oDAAoD;AACpD,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,KAAK,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC,CAAA;AAK9K,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,YAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAczG"}

package/dist/profile.js

@@ -0,0 +1,29 @@
+/**
+ * A GitHub user's public profile: the name and picture a person copies into OpenAgent as their
+ * own, once, when they press "Sync from GitHub". Read from GitHub's public API with no login, so
+ * no account of the person's, nor of OpenAgent's, is asked.
+ */
+/** A GitHub login, as GitHub allows one. */
+const LOGIN = /^[A-Za-z0-9](?:[A-Za-z0-9-]{0,38})$/;
+export function isGithubLogin(login) {
+    return LOGIN.test(login);
+}
+export async function publicProfile(login, fetcher = fetch) {
+    let answer;
+    try {
+        answer = await fetcher(`https://api.github.com/users/${encodeURIComponent(login)}`, { headers: { accept: 'application/vnd.github+json', 'user-agent': 'openagent' }, signal: AbortSignal.timeout(10_000) });
+    }
+    catch (err) {
+        return { ok: false, reason: 'not-reached', detail: err instanceof Error ? err.message : String(err) };
+    }
+    if (answer.status === 404)
+        return { ok: false, reason: 'no-user', detail: `GitHub has no user ${login}` };
+    if (!answer.ok)
+        return { ok: false, reason: 'not-reached', detail: `GitHub answered ${answer.status}` };
+    const body = ((await answer.json().catch(() => ({}))) ?? {});
+    const text = (value) => (typeof value === 'string' && value.trim() ? value.trim() : undefined);
+    const name = text(body['name']);
+    const avatar = text(body['avatar_url']);
+    return { ok: true, login: text(body['login']) ?? login, ...(name ? { name } : {}), ...(avatar?.startsWith('https://') ? { avatar } : {}) };
+}
+//# sourceMappingURL=profile.js.map

package/dist/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../src/profile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,4CAA4C;AAC5C,MAAM,KAAK,GAAG,qCAAqC,CAAA;AAEnD,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAa,EAAE,OAAO,GAAiB,KAAK;IAC9E,IAAI,MAAiE,CAAA;IACrE,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,OAAO,CAAC,gCAAgC,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,6BAA6B,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IAC7M,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAA;IACvG,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,sBAAsB,KAAK,EAAE,EAAE,CAAA;IACzG,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,mBAAmB,MAAM,CAAC,MAAM,EAAE,EAAE,CAAA;IACvG,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAA4B,CAAA;IACvF,MAAM,IAAI,GAAG,CAAC,KAAc,EAAsB,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAC3H,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAA;IACvC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;AAC5I,CAAC"}

package/dist/repos.d.ts

@@ -0,0 +1,19 @@
+import { type GhRunner } from './gh.js';
+/**
+ * The repositories of a GitHub user or organization, as an account of OpenAgent's sees them:
+ * what the dashboard's project picker lists beside the repos on the computer, to be cloned when
+ * picked. Asked of `gh` as that account, so a private one it can read is listed too.
+ */
+/** A repository as the picker lists it. */
+export interface ListedRepo {
+    /** `github.com/<owner>/<name>`: the repository's one name on every machine. */
+    address: string;
+    url: string;
+    private: boolean;
+    pushedAt?: string;
+    description?: string;
+}
+/** How many repositories one listing asks for. */
+export declare const REPOS_LIMIT = 300;
+export declare function listRepos(gh: GhRunner, cwd: string, owner: string): Promise<ListedRepo[]>;
+//# sourceMappingURL=repos.d.ts.map

package/dist/repos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repos.d.ts","sourceRoot":"","sources":["../src/repos.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AAErD;;;;GAIG;AAEH,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,kDAAkD;AAClD,eAAO,MAAM,WAAW,MAAM,CAAA;AAE9B,wBAAsB,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAoB/F"}

package/dist/repos.js

@@ -0,0 +1,28 @@
+import { HOST } from './accounts.js';
+import { errorMessage } from './gh.js';
+/** How many repositories one listing asks for. */
+export const REPOS_LIMIT = 300;
+export async function listRepos(gh, cwd, owner) {
+    let said;
+    try {
+        said = JSON.parse(await gh(['repo', 'list', owner, '--limit', String(REPOS_LIMIT), '--json', 'nameWithOwner,url,isPrivate,pushedAt,description'], cwd));
+    }
+    catch (err) {
+        throw new Error(`GitHub did not list ${owner}'s repositories: ${errorMessage(err)}`);
+    }
+    const repos = [];
+    for (const row of Array.isArray(said) ? said : []) {
+        const { nameWithOwner, url, isPrivate, pushedAt, description } = (row ?? {});
+        if (typeof nameWithOwner !== 'string' || !/^[\w.-]+\/[\w.-]+$/.test(nameWithOwner) || typeof url !== 'string' || !url.startsWith('https://'))
+            continue;
+        repos.push({
+            address: `${HOST}/${nameWithOwner}`,
+            url,
+            private: isPrivate === true,
+            ...(typeof pushedAt === 'string' ? { pushedAt } : {}),
+            ...(typeof description === 'string' && description.trim() ? { description: description.trim() } : {}),
+        });
+    }
+    return repos.sort((a, b) => (b.pushedAt ?? '').localeCompare(a.pushedAt ?? ''));
+}
+//# sourceMappingURL=repos.js.map

package/dist/repos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repos.js","sourceRoot":"","sources":["../src/repos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,YAAY,EAAiB,MAAM,SAAS,CAAA;AAkBrD,kDAAkD;AAClD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAA;AAE9B,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,EAAY,EAAE,GAAW,EAAE,KAAa;IACtE,IAAI,IAAa,CAAA;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,kDAAkD,CAAC,EAAE,GAAG,CAAC,CAAC,CAAA;IACzJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,oBAAoB,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACtF,CAAC;IACD,MAAM,KAAK,GAAiB,EAAE,CAAA;IAC9B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAClD,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE,CAA4B,CAAA;QACvG,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,SAAQ;QACtJ,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,EAAE,GAAG,IAAI,IAAI,aAAa,EAAE;YACnC,GAAG;YACH,OAAO,EAAE,SAAS,KAAK,IAAI;YAC3B,GAAG,CAAC,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtG,CAAC,CAAA;IACJ,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAA;AACjF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openagt/skill-github",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "GitHub as a skill for coding agents: the project's pull requests and issues through gh, and the one command OpenAgent and the scheduler run for the git host: requests, open, merge, home, and replies, what came on the pull requests this machine's agents opened since each ended.",
   "license": "MIT",
   "repository": {
@@ -37,8 +37,8 @@
     "./SKILL.md": "./SKILL.md"
   },
   "dependencies": {
-    "@openagt/agent-data": "0.0.9",
-    "@openagt/skill-logs": "0.1.7"
+    "@openagt/agent-data": "0.0.14",
+    "@openagt/skill-logs": "0.1.11"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
@@ -47,7 +47,7 @@
   "scripts": {
     "build": "cp ../../skills/github/SKILL.md SKILL.md && tsc -p tsconfig.build.json",
     "typecheck": "tsc --noEmit",
-    "test": "tsc -p tsconfig.test.json && node --test --test-timeout=60000 'dist-test/**/*.test.js'",
+    "test": "tsc -p tsconfig.test.json && XDG_CONFIG_HOME=$(mktemp -d) node --test --test-timeout=60000 'dist-test/**/*.test.js'",
     "clean": "rm -rf dist dist-test SKILL.md"
   }
 }

package/dist/me.d.ts

@@ -1,17 +0,0 @@
-import { type GhRunner } from './gh.js';
-/**
- * Who is signed in to GitHub through `gh`: what OpenAgent shows of the person at the foot of its
- * sidebar, their login, name and picture. Asked of `gh` as `create` asks for the account.
- */
-export type MeOutcome = {
-    ok: true;
-    login: string;
-    name?: string;
-    avatar?: string;
-} | {
-    ok: false;
-    reason: 'not-logged-in';
-    detail: string;
-};
-export declare function signedIn(cwd: string, gh: GhRunner): Promise<MeOutcome>;
-//# sourceMappingURL=me.d.ts.map

package/dist/me.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"me.d.ts","sourceRoot":"","sources":["../src/me.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AAErD;;;GAGG;AAEH,MAAM,MAAM,SAAS,GACjB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1D,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,CAa5E"}

package/dist/me.js

@@ -1,18 +0,0 @@
-import { errorMessage } from './gh.js';
-export async function signedIn(cwd, gh) {
-    let answer;
-    try {
-        answer = JSON.parse(await gh(['api', 'user', '--jq', '{login: .login, name: .name, avatar: .avatar_url}'], cwd));
-    }
-    catch (err) {
-        return { ok: false, reason: 'not-logged-in', detail: errorMessage(err) };
-    }
-    const text = (value) => (typeof value === 'string' && value.trim() ? value.trim() : undefined);
-    const login = text(answer['login']);
-    if (!login)
-        return { ok: false, reason: 'not-logged-in', detail: 'gh named no account' };
-    const name = text(answer['name']);
-    const avatar = text(answer['avatar']);
-    return { ok: true, login, ...(name ? { name } : {}), ...(avatar?.startsWith('https://') ? { avatar } : {}) };
-}
-//# sourceMappingURL=me.js.map

package/dist/me.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"me.js","sourceRoot":"","sources":["../src/me.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiB,MAAM,SAAS,CAAA;AAWrD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,EAAY;IACtD,IAAI,MAA+B,CAAA;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,mDAAmD,CAAC,EAAE,GAAG,CAAC,CAA4B,CAAA;IAC7I,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAA;IAC1E,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,KAAc,EAAsB,EAAE,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAC3H,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAA;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAA;IACxF,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAA;IACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;IACrC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;AAC9G,CAAC"}