@grackle-ai/web-components 0.107.2 → 0.108.1

package/src/hooks/types.ts

@@ -32,6 +32,8 @@ export interface Environment {
   adapterConfig: string;
   status: string;
   bootstrapped: boolean;
+  /** ID of the GitHub account to use for gh CLI operations, or empty string for default. */
+  githubAccountId: string;
 }
 
 
@@ -223,11 +225,12 @@ export interface UseEnvironmentsResult {
     displayName: string,
     adapterType: string,
     adapterConfig?: Record<string, unknown>,
+    githubAccountId?: string,
   ) => Promise<void>;
   /** Update an existing environment's mutable fields. */
   updateEnvironment: (
     environmentId: string,
-    fields: { displayName?: string; adapterConfig?: Record<string, unknown> },
+    fields: { displayName?: string; adapterConfig?: Record<string, unknown>; githubAccountId?: string },
   ) => Promise<void>;
   /** Provision an environment by ID. When force is true, kills active sessions and forces full provision. */
   provisionEnvironment: (environmentId: string, force?: boolean) => Promise<void>;
@@ -269,6 +272,7 @@ export interface UseSessionsResult {
     prompt: string,
     personaId?: string,
     workingDirectory?: string,
+    workspaceId?: string,
   ) => Promise<void>;
   /** Send text input to a running session. */
   sendInput: (sessionId: string, text: string) => Promise<void>;
@@ -484,8 +488,8 @@ export interface UseCodespacesResult {
   codespaceListError: string;
   /** Whether a codespace creation is currently in progress. */
   codespaceCreating: boolean;
-  /** Request the current codespace list from the server. */
-  listCodespaces: () => Promise<void>;
+  /** Request the current codespace list from the server, optionally filtered to a GitHub account. */
+  listCodespaces: (githubAccountId?: string) => Promise<void>;
   /** Create a new codespace for the given repo. */
   createCodespace: (repo: string, machine?: string) => Promise<void>;
   /** Lifecycle hook for connect/disconnect/event routing. */
@@ -854,6 +858,35 @@ export interface UsePluginsResult {
   domainHook: DomainHook;
 }
 
+/** A registered GitHub account (token is never returned by the server). */
+export interface GitHubAccountData {
+  id: string;
+  label: string;
+  username: string;
+  isDefault: boolean;
+  createdAt: string;
+}
+
+/** Values returned by the GitHub accounts domain hook. */
+export interface UseGitHubAccountsResult {
+  /** All registered GitHub accounts. */
+  githubAccounts: GitHubAccountData[];
+  /** Whether the account list is currently loading. */
+  githubAccountsLoading: boolean;
+  /** Refresh the account list from the server. */
+  loadGitHubAccounts: () => Promise<void>;
+  /** Register a new GitHub account. */
+  addGitHubAccount: (label: string, token: string, username: string, isDefault: boolean) => Promise<void>;
+  /** Update an existing GitHub account. */
+  updateGitHubAccount: (id: string, fields: { label?: string; token?: string; isDefault?: boolean }) => Promise<void>;
+  /** Remove a GitHub account by ID. */
+  removeGitHubAccount: (id: string) => Promise<void>;
+  /** Import accounts from the local gh CLI authentication state. */
+  importGitHubAccounts: () => Promise<{ imported: number; usernames: string[] }>;
+  /** Lifecycle hook for connect/disconnect/event routing. */
+  domainHook: DomainHook;
+}
+
 /** Delay in milliseconds before attempting a WebSocket reconnect. */
 export const WS_RECONNECT_DELAY_MS: number = 3_000;
 

package/src/index.ts

@@ -63,8 +63,8 @@ export type { CalloutVariant } from "./components/notifications/index.js";
 export { UpdateBanner } from "./components/notifications/UpdateBanner.js";
 
 // Panels
-export { FindingsPanel, TokensPanel, AppearancePanel, AboutPanel, TaskEditPanel, TaskActionButtons, TaskOverviewPanel, PluginsPanel } from "./components/panels/index.js";
-export type { PluginsPanelProps } from "./components/panels/index.js";
+export { FindingsPanel, TokensPanel, AppearancePanel, AboutPanel, TaskEditPanel, TaskActionButtons, TaskOverviewPanel, PluginsPanel, GitHubAccountsPanel } from "./components/panels/index.js";
+export type { PluginsPanelProps, GitHubAccountsPanelProps } from "./components/panels/index.js";
 export type { TaskActionButtonsProps } from "./components/panels/TaskActionButtons.js";
 export type { TaskOverviewPanelProps } from "./components/panels/TaskOverviewPanel.js";
 export { EnvironmentEditPanel } from "./components/panels/EnvironmentEditPanel.js";
@@ -134,6 +134,7 @@ export type {
   UseCredentialsResult, UseCodespacesResult, UsePersonasResult,
   UsePluginsResult, PluginData,
   StreamData, StreamSubscriberData, UseStreamsResult,
+  UseGitHubAccountsResult, GitHubAccountData,
   DomainHook,
   ConnectionStatus,
 } from "./hooks/types.js";
@@ -156,7 +157,7 @@ export {
   useAppNavigate, sessionUrl, workspaceUrl, taskUrl, taskEditUrl,
   newTaskUrl, newChatUrl, ENVIRONMENTS_URL, NEW_ENVIRONMENT_URL,
   environmentUrl, environmentEditUrl, SETTINGS_URL,
-  SETTINGS_ENVIRONMENTS_URL, SETTINGS_CREDENTIALS_URL,
+  SETTINGS_ENVIRONMENTS_URL, SETTINGS_CREDENTIALS_URL, SETTINGS_GITHUB_ACCOUNTS_URL,
   PERSONAS_URL, NEW_PERSONA_URL, personaUrl,
   SCHEDULES_URL, NEW_SCHEDULE_URL, scheduleUrl,
   SETTINGS_APPEARANCE_URL, SETTINGS_ABOUT_URL, SETTINGS_SHORTCUTS_URL,

package/src/mocks/MockGrackleProvider.tsx

@@ -1300,6 +1300,27 @@ export function MockGrackleProvider({ children }: MockGrackleProviderProps): JSX
         domainHook: NOOP_DOMAIN_HOOK,
       },
 
+      // ── GitHub Accounts ──────────────────────────────
+
+      githubAccounts: {
+        githubAccounts: [],
+        githubAccountsLoading: false,
+        loadGitHubAccounts: async () => { console.log("[MockGrackle] loadGitHubAccounts"); },
+        addGitHubAccount: async (label: string, _token: string, _username: string, _isDefault: boolean) => {
+          console.log("[MockGrackle] addGitHubAccount", label);
+        },
+        updateGitHubAccount: async (id: string, fields: { label?: string; token?: string; isDefault?: boolean }) => {
+          console.log("[MockGrackle] updateGitHubAccount", id, fields);
+        },
+        removeGitHubAccount: async (id: string) => {
+          console.log("[MockGrackle] removeGitHubAccount", id);
+        },
+        importGitHubAccounts: async () => {
+          console.log("[MockGrackle] importGitHubAccounts");
+          return { imported: 0, usernames: [] };
+        },
+      },
+
       // ── Plugins ─────────────────────────────────────
 
       plugins: {

package/src/mocks/mockData.ts

@@ -29,6 +29,7 @@ export const MOCK_ENVIRONMENTS: Environment[] = [
     adapterConfig: "{}",
     status: "connected",
     bootstrapped: true,
+    githubAccountId: "",
   },
   {
     id: "env-docker-01",
@@ -37,6 +38,7 @@ export const MOCK_ENVIRONMENTS: Environment[] = [
     adapterConfig: '{"image":"node:20"}',
     status: "connected",
     bootstrapped: true,
+    githubAccountId: "",
   },
   {
     id: "env-cs-01",
@@ -45,6 +47,7 @@ export const MOCK_ENVIRONMENTS: Environment[] = [
     adapterConfig: '{"codespaceName":"my-codespace"}',
     status: "connected",
     bootstrapped: true,
+    githubAccountId: "",
   },
   {
     id: "env-remote-01",
@@ -53,6 +56,7 @@ export const MOCK_ENVIRONMENTS: Environment[] = [
     adapterConfig: '{"host":"192.168.1.10","user":"deploy","sshPort":22}',
     status: "disconnected",
     bootstrapped: false,
+    githubAccountId: "",
   },
   {
     id: "error-env",
@@ -61,6 +65,7 @@ export const MOCK_ENVIRONMENTS: Environment[] = [
     adapterConfig: "{}",
     status: "connected",
     bootstrapped: true,
+    githubAccountId: "",
   },
 ];
 

package/src/test-utils/storybook-helpers.ts

@@ -48,6 +48,7 @@ export function makeEnvironment(overrides: Partial<Environment> = {}): Environme
     adapterConfig: "{}",
     status: "connected",
     bootstrapped: true,
+    githubAccountId: "",
     ...overrides,
   };
 }

package/src/utils/breadcrumbs.test.ts

@@ -43,6 +43,7 @@ function makeEnvironment(id: string, displayName: string): Environment {
     adapterConfig: "",
     status: "connected",
     bootstrapped: true,
+    githubAccountId: "",
   };
 }
 

package/src/utils/dashboard.test.ts

@@ -66,6 +66,7 @@ function makeEnvironment(id: string, displayName: string, status: string): Envir
     adapterConfig: "{}",
     status,
     bootstrapped: true,
+    githubAccountId: "",
   };
 }
 

package/src/utils/navigation.ts

@@ -122,6 +122,9 @@ export const SETTINGS_ENVIRONMENTS_URL: string = "/settings/environments";
 /** URL for the settings credentials tab. */
 export const SETTINGS_CREDENTIALS_URL: string = "/settings/credentials";
 
+/** URL for the GitHub accounts settings tab. */
+export const SETTINGS_GITHUB_ACCOUNTS_URL: string = "/settings/github-accounts";
+
 /** URL for the persona management tab. */
 export const PERSONAS_URL: string = "/settings/personas";