@grackle-ai/plugin-core 0.96.3

package/dist/test-utils/mock-database.d.ts

@@ -0,0 +1,152 @@
+/** Create a complete mock of the `@grackle-ai/database` barrel export. */
+export declare function createDatabaseMock(): {
+    db: {};
+    sqlite: undefined;
+    openDatabase: import("vitest").Mock<(...args: any[]) => any>;
+    initDatabase: import("vitest").Mock<(...args: any[]) => any>;
+    seedDatabase: import("vitest").Mock<(...args: any[]) => any>;
+    schema: {};
+    sessionStore: {
+        createSession: import("vitest").Mock<(...args: any[]) => any>;
+        getSession: import("vitest").Mock<() => undefined>;
+        listSessions: import("vitest").Mock<() => never[]>;
+        listByEnv: import("vitest").Mock<() => never[]>;
+        listSessionsForTask: import("vitest").Mock<() => never[]>;
+        listSessionsByTaskIds: import("vitest").Mock<() => never[]>;
+        getLatestSessionForTask: import("vitest").Mock<() => undefined>;
+        getActiveForEnv: import("vitest").Mock<() => undefined>;
+        getActiveSessionsForTask: import("vitest").Mock<() => never[]>;
+        getSuspendedForEnv: import("vitest").Mock<() => never[]>;
+        getChildSessions: import("vitest").Mock<() => never[]>;
+        updateSession: import("vitest").Mock<(...args: any[]) => any>;
+        updateSessionStatus: import("vitest").Mock<(...args: any[]) => any>;
+        updateSessionUsage: import("vitest").Mock<(...args: any[]) => any>;
+        updateRuntimeSessionId: import("vitest").Mock<(...args: any[]) => any>;
+        incrementTurns: import("vitest").Mock<(...args: any[]) => any>;
+        suspendSession: import("vitest").Mock<(...args: any[]) => any>;
+        reanimateSession: import("vitest").Mock<(...args: any[]) => any>;
+        setSigtermSentAt: import("vitest").Mock<(...args: any[]) => any>;
+        clearSigtermSentAt: import("vitest").Mock<(...args: any[]) => any>;
+        setSessionTask: import("vitest").Mock<(...args: any[]) => any>;
+        deleteByEnvironment: import("vitest").Mock<(...args: any[]) => any>;
+        aggregateUsage: import("vitest").Mock<() => {
+            inputTokens: number;
+            outputTokens: number;
+            costUsd: number;
+            sessionCount: number;
+        }>;
+    };
+    taskStore: {
+        createTask: import("vitest").Mock<(...args: any[]) => any>;
+        insertTask: import("vitest").Mock<(...args: any[]) => any>;
+        getTask: import("vitest").Mock<() => undefined>;
+        listTasks: import("vitest").Mock<() => never[]>;
+        updateTask: import("vitest").Mock<(...args: any[]) => any>;
+        updateTaskStatus: import("vitest").Mock<(...args: any[]) => any>;
+        markTaskComplete: import("vitest").Mock<(...args: any[]) => any>;
+        deleteTask: import("vitest").Mock<(...args: any[]) => any>;
+        setTaskWorkspace: import("vitest").Mock<(...args: any[]) => any>;
+        setTaskDependsOn: import("vitest").Mock<(...args: any[]) => any>;
+        getUnblockedTasks: import("vitest").Mock<() => never[]>;
+        checkAndUnblock: import("vitest").Mock<() => never[]>;
+        areDependenciesMet: import("vitest").Mock<() => boolean>;
+        buildChildIdsMap: import("vitest").Mock<() => Map<any, any>>;
+        getChildren: import("vitest").Mock<() => never[]>;
+        getDescendants: import("vitest").Mock<() => never[]>;
+        getAncestors: import("vitest").Mock<() => never[]>;
+        getChildStatusCounts: import("vitest").Mock<() => {}>;
+        reparentTask: import("vitest").Mock<(...args: any[]) => any>;
+        getOrphanedTasks: import("vitest").Mock<() => never[]>;
+    };
+    workspaceStore: {
+        createWorkspace: import("vitest").Mock<(...args: any[]) => any>;
+        getWorkspace: import("vitest").Mock<() => undefined>;
+        listWorkspaces: import("vitest").Mock<() => never[]>;
+        updateWorkspace: import("vitest").Mock<(...args: any[]) => any>;
+        archiveWorkspace: import("vitest").Mock<(...args: any[]) => any>;
+        countWorkspacesByEnvironment: import("vitest").Mock<() => number>;
+    };
+    personaStore: {
+        createPersona: import("vitest").Mock<(...args: any[]) => any>;
+        getPersona: import("vitest").Mock<() => undefined>;
+        getPersonaByName: import("vitest").Mock<() => undefined>;
+        listPersonas: import("vitest").Mock<() => never[]>;
+        updatePersona: import("vitest").Mock<(...args: any[]) => any>;
+        deletePersona: import("vitest").Mock<(...args: any[]) => any>;
+    };
+    findingStore: {
+        postFinding: import("vitest").Mock<(...args: any[]) => any>;
+        queryFindings: import("vitest").Mock<() => never[]>;
+    };
+    settingsStore: {
+        getSetting: import("vitest").Mock<() => undefined>;
+        setSetting: import("vitest").Mock<(...args: any[]) => any>;
+        isAllowedSettingKey: import("vitest").Mock<() => boolean>;
+        WRITABLE_SETTING_KEYS: Set<string>;
+    };
+    envRegistry: {
+        listEnvironments: import("vitest").Mock<() => never[]>;
+        getEnvironment: import("vitest").Mock<() => undefined>;
+        addEnvironment: import("vitest").Mock<(...args: any[]) => any>;
+        removeEnvironment: import("vitest").Mock<(...args: any[]) => any>;
+        updateEnvironmentStatus: import("vitest").Mock<(...args: any[]) => any>;
+        markBootstrapped: import("vitest").Mock<(...args: any[]) => any>;
+        setEnvInfo: import("vitest").Mock<(...args: any[]) => any>;
+        updateAdapterConfig: import("vitest").Mock<(...args: any[]) => any>;
+        updateEnvironment: import("vitest").Mock<(...args: any[]) => any>;
+        resetAllStatuses: import("vitest").Mock<(...args: any[]) => any>;
+    };
+    tokenStore: {
+        setToken: import("vitest").Mock<(...args: any[]) => any>;
+        deleteToken: import("vitest").Mock<(...args: any[]) => any>;
+        listTokens: import("vitest").Mock<() => never[]>;
+        getBundle: import("vitest").Mock<() => {
+            tokens: never[];
+        }>;
+    };
+    workspaceEnvironmentLinkStore: {
+        linkEnvironment: import("vitest").Mock<(...args: any[]) => any>;
+        unlinkEnvironment: import("vitest").Mock<(...args: any[]) => any>;
+        getLinkedEnvironmentIds: import("vitest").Mock<() => never[]>;
+        getLinkedEnvironmentIdsByWorkspaces: import("vitest").Mock<() => Map<any, any>>;
+        getWorkspaceIdsLinkedToEnvironment: import("vitest").Mock<() => never[]>;
+        isLinked: import("vitest").Mock<() => boolean>;
+        countLinksForEnvironment: import("vitest").Mock<() => number>;
+        deleteLinksForEnvironment: import("vitest").Mock<(...args: any[]) => any>;
+        deleteLinksForWorkspace: import("vitest").Mock<(...args: any[]) => any>;
+    };
+    escalationStore: {
+        createEscalation: import("vitest").Mock<(...args: any[]) => any>;
+        getEscalation: import("vitest").Mock<() => undefined>;
+        listEscalations: import("vitest").Mock<() => never[]>;
+        listPendingEscalations: import("vitest").Mock<() => never[]>;
+        updateEscalationStatus: import("vitest").Mock<(...args: any[]) => any>;
+    };
+    credentialProviders: {
+        getCredentialProviders: import("vitest").Mock<() => {
+            claude: string;
+            github: string;
+            copilot: string;
+            codex: string;
+            goose: string;
+        }>;
+        setCredentialProviders: import("vitest").Mock<(...args: any[]) => any>;
+        parseCredentialProviderConfig: import("vitest").Mock<(...args: any[]) => any>;
+        isValidCredentialProviderConfig: import("vitest").Mock<() => boolean>;
+        VALID_PROVIDERS: string[];
+        VALID_CLAUDE_VALUES: Set<string>;
+        VALID_TOGGLE_VALUES: Set<string>;
+    };
+    isAllowedSettingKey: import("vitest").Mock<() => boolean>;
+    WRITABLE_SETTING_KEYS: Set<string>;
+    VALID_PROVIDERS: string[];
+    VALID_CLAUDE_VALUES: Set<string>;
+    VALID_TOGGLE_VALUES: Set<string>;
+    persistEvent: import("vitest").Mock<(...args: any[]) => any>;
+    grackleHome: string;
+    safeParseJsonArray: (value: unknown) => string[];
+    slugify: (text: string) => string;
+    encrypt: import("vitest").Mock<(x: unknown) => unknown>;
+    decrypt: import("vitest").Mock<(x: unknown) => unknown>;
+};
+//# sourceMappingURL=mock-database.d.ts.map

package/dist/test-utils/mock-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-database.d.ts","sourceRoot":"","sources":["../../src/test-utils/mock-database.ts"],"names":[],"mappings":"AAeA,0EAA0E;AAE1E,wBAAgB,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAoJF,OAAO,KAAG,MAAM,EAAE;oBAS9B,MAAM,KAAG,MAAM;uCACZ,OAAO;uCACP,OAAO;EAE7B"}

package/dist/test-utils/mock-database.js

@@ -0,0 +1,169 @@
+/**
+ * Shared mock factory for `@grackle-ai/database` used by server test files.
+ *
+ * Usage in test files:
+ * ```typescript
+ * import { createDatabaseMock } from "./test-utils/mock-database.js";
+ * vi.mock("@grackle-ai/database", () => createDatabaseMock());
+ * ```
+ *
+ * All store namespaces are provided with vi.fn() stubs that return safe defaults
+ * (empty arrays, undefined, etc.). Individual tests can override specific functions
+ * via `vi.mocked(store.someMethod).mockReturnValue(...)`.
+ */
+import { vi } from "vitest";
+/** Create a complete mock of the `@grackle-ai/database` barrel export. */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+export function createDatabaseMock() {
+    return {
+        db: {},
+        sqlite: undefined,
+        openDatabase: vi.fn(),
+        initDatabase: vi.fn(),
+        seedDatabase: vi.fn(),
+        schema: {},
+        sessionStore: {
+            createSession: vi.fn(),
+            getSession: vi.fn(() => undefined),
+            listSessions: vi.fn(() => []),
+            listByEnv: vi.fn(() => []),
+            listSessionsForTask: vi.fn(() => []),
+            listSessionsByTaskIds: vi.fn(() => []),
+            getLatestSessionForTask: vi.fn(() => undefined),
+            getActiveForEnv: vi.fn(() => undefined),
+            getActiveSessionsForTask: vi.fn(() => []),
+            getSuspendedForEnv: vi.fn(() => []),
+            getChildSessions: vi.fn(() => []),
+            updateSession: vi.fn(),
+            updateSessionStatus: vi.fn(),
+            updateSessionUsage: vi.fn(),
+            updateRuntimeSessionId: vi.fn(),
+            incrementTurns: vi.fn(),
+            suspendSession: vi.fn(),
+            reanimateSession: vi.fn(),
+            setSigtermSentAt: vi.fn(),
+            clearSigtermSentAt: vi.fn(),
+            setSessionTask: vi.fn(),
+            deleteByEnvironment: vi.fn(),
+            aggregateUsage: vi.fn(() => ({ inputTokens: 0, outputTokens: 0, costUsd: 0, sessionCount: 0 })),
+        },
+        taskStore: {
+            createTask: vi.fn(),
+            insertTask: vi.fn(),
+            getTask: vi.fn(() => undefined),
+            listTasks: vi.fn(() => []),
+            updateTask: vi.fn(),
+            updateTaskStatus: vi.fn(),
+            markTaskComplete: vi.fn(),
+            deleteTask: vi.fn(),
+            setTaskWorkspace: vi.fn(),
+            setTaskDependsOn: vi.fn(),
+            getUnblockedTasks: vi.fn(() => []),
+            checkAndUnblock: vi.fn(() => []),
+            areDependenciesMet: vi.fn(() => true),
+            buildChildIdsMap: vi.fn(() => new Map()),
+            getChildren: vi.fn(() => []),
+            getDescendants: vi.fn(() => []),
+            getAncestors: vi.fn(() => []),
+            getChildStatusCounts: vi.fn(() => ({})),
+            reparentTask: vi.fn(),
+            getOrphanedTasks: vi.fn(() => []),
+        },
+        workspaceStore: {
+            createWorkspace: vi.fn(),
+            getWorkspace: vi.fn(() => undefined),
+            listWorkspaces: vi.fn(() => []),
+            updateWorkspace: vi.fn(),
+            archiveWorkspace: vi.fn(),
+            countWorkspacesByEnvironment: vi.fn(() => 0),
+        },
+        personaStore: {
+            createPersona: vi.fn(),
+            getPersona: vi.fn(() => undefined),
+            getPersonaByName: vi.fn(() => undefined),
+            listPersonas: vi.fn(() => []),
+            updatePersona: vi.fn(),
+            deletePersona: vi.fn(),
+        },
+        findingStore: {
+            postFinding: vi.fn(),
+            queryFindings: vi.fn(() => []),
+        },
+        settingsStore: {
+            getSetting: vi.fn(() => undefined),
+            setSetting: vi.fn(),
+            isAllowedSettingKey: vi.fn(() => true),
+            WRITABLE_SETTING_KEYS: new Set(["default_persona_id", "onboarding_completed"]),
+        },
+        envRegistry: {
+            listEnvironments: vi.fn(() => []),
+            getEnvironment: vi.fn(() => undefined),
+            addEnvironment: vi.fn(),
+            removeEnvironment: vi.fn(),
+            updateEnvironmentStatus: vi.fn(),
+            markBootstrapped: vi.fn(),
+            setEnvInfo: vi.fn(),
+            updateAdapterConfig: vi.fn(),
+            updateEnvironment: vi.fn(),
+            resetAllStatuses: vi.fn(),
+        },
+        tokenStore: {
+            setToken: vi.fn(),
+            deleteToken: vi.fn(),
+            listTokens: vi.fn(() => []),
+            getBundle: vi.fn(() => ({ tokens: [] })),
+        },
+        workspaceEnvironmentLinkStore: {
+            linkEnvironment: vi.fn(),
+            unlinkEnvironment: vi.fn(),
+            getLinkedEnvironmentIds: vi.fn(() => []),
+            getLinkedEnvironmentIdsByWorkspaces: vi.fn(() => new Map()),
+            getWorkspaceIdsLinkedToEnvironment: vi.fn(() => []),
+            isLinked: vi.fn(() => false),
+            countLinksForEnvironment: vi.fn(() => 0),
+            deleteLinksForEnvironment: vi.fn(),
+            deleteLinksForWorkspace: vi.fn(),
+        },
+        escalationStore: {
+            createEscalation: vi.fn(),
+            getEscalation: vi.fn(() => undefined),
+            listEscalations: vi.fn(() => []),
+            listPendingEscalations: vi.fn(() => []),
+            updateEscalationStatus: vi.fn(),
+        },
+        credentialProviders: {
+            getCredentialProviders: vi.fn(() => ({ claude: "off", github: "off", copilot: "off", codex: "off", goose: "off" })),
+            setCredentialProviders: vi.fn(),
+            parseCredentialProviderConfig: vi.fn(),
+            isValidCredentialProviderConfig: vi.fn(() => true),
+            VALID_PROVIDERS: ["claude", "github", "copilot", "codex", "goose"],
+            VALID_CLAUDE_VALUES: new Set(["off", "subscription", "api_key"]),
+            VALID_TOGGLE_VALUES: new Set(["off", "on"]),
+        },
+        // Direct barrel exports
+        isAllowedSettingKey: vi.fn(() => true),
+        WRITABLE_SETTING_KEYS: new Set(["default_persona_id", "onboarding_completed"]),
+        VALID_PROVIDERS: ["claude", "github", "copilot", "codex", "goose"],
+        VALID_CLAUDE_VALUES: new Set(["off", "subscription", "api_key"]),
+        VALID_TOGGLE_VALUES: new Set(["off", "on"]),
+        persistEvent: vi.fn(),
+        // Utilities
+        grackleHome: "/tmp/test-grackle",
+        safeParseJsonArray: (value) => {
+            if (!value) {
+                return [];
+            }
+            try {
+                const p = JSON.parse(value);
+                return Array.isArray(p) ? p.filter((i) => typeof i === "string") : [];
+            }
+            catch {
+                return [];
+            }
+        },
+        slugify: (text) => text.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 40),
+        encrypt: vi.fn((x) => x),
+        decrypt: vi.fn((x) => x),
+    };
+}
+//# sourceMappingURL=mock-database.js.map

package/dist/test-utils/mock-database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-database.js","sourceRoot":"","sources":["../../src/test-utils/mock-database.ts"],"names":[],"mappings":"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"}

package/dist/token-handlers.d.ts

@@ -0,0 +1,12 @@
+import { grackle } from "@grackle-ai/common";
+/** Store or update a token. */
+export declare function setToken(req: grackle.TokenEntry): Promise<grackle.Empty>;
+/** List all stored tokens (without values). */
+export declare function listTokens(): Promise<grackle.TokenList>;
+/** Delete a token by name. */
+export declare function deleteToken(req: grackle.TokenName): Promise<grackle.Empty>;
+/** Get the current credential provider configuration. */
+export declare function getCredentialProviders(): Promise<grackle.CredentialProviderConfig>;
+/** Set a specific credential provider value. */
+export declare function setCredentialProvider(req: grackle.SetCredentialProviderRequest): Promise<grackle.CredentialProviderConfig>;
+//# sourceMappingURL=token-handlers.d.ts.map

package/dist/token-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-handlers.d.ts","sourceRoot":"","sources":["../src/token-handlers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAM7C,+BAA+B;AAC/B,wBAAsB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAkB9E;AAED,+CAA+C;AAC/C,wBAAsB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAa7D;AAED,8BAA8B;AAC9B,wBAAsB,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAQhF;AAED,yDAAyD;AACzD,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,CASxF;AAED,gDAAgD;AAChD,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC,4BAA4B,GAAG,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAgChI"}

package/dist/token-handlers.js

@@ -0,0 +1,85 @@
+import { ConnectError, Code } from "@connectrpc/connect";
+import { create } from "@bufbuild/protobuf";
+import { grackle } from "@grackle-ai/common";
+import { claudeProviderModeToEnum, providerToggleToEnum } from "@grackle-ai/common";
+import { tokenStore, credentialProviders } from "@grackle-ai/database";
+import { tokenPush } from "@grackle-ai/core";
+import { emit } from "@grackle-ai/core";
+/** Store or update a token. */
+export async function setToken(req) {
+    if (!req.name) {
+        throw new ConnectError("name is required", Code.InvalidArgument);
+    }
+    if (!req.value) {
+        throw new ConnectError("value is required", Code.InvalidArgument);
+    }
+    tokenStore.setToken({
+        name: req.name,
+        type: req.type,
+        envVar: req.envVar,
+        filePath: req.filePath,
+        value: req.value,
+        expiresAt: req.expiresAt,
+    });
+    emit("token.changed", {});
+    await tokenPush.pushToAll();
+    return create(grackle.EmptySchema, {});
+}
+/** List all stored tokens (without values). */
+export async function listTokens() {
+    const items = tokenStore.listTokens();
+    return create(grackle.TokenListSchema, {
+        tokens: items.map((t) => create(grackle.TokenInfoSchema, {
+            name: t.name,
+            type: t.type,
+            envVar: t.envVar || "",
+            filePath: t.filePath || "",
+            expiresAt: t.expiresAt || "",
+        })),
+    });
+}
+/** Delete a token by name. */
+export async function deleteToken(req) {
+    if (!req.name) {
+        throw new ConnectError("name is required", Code.InvalidArgument);
+    }
+    tokenStore.deleteToken(req.name);
+    emit("token.changed", {});
+    await tokenPush.pushToAll();
+    return create(grackle.EmptySchema, {});
+}
+/** Get the current credential provider configuration. */
+export async function getCredentialProviders() {
+    const config = credentialProviders.getCredentialProviders();
+    return create(grackle.CredentialProviderConfigSchema, {
+        claude: claudeProviderModeToEnum(config.claude),
+        github: providerToggleToEnum(config.github),
+        copilot: providerToggleToEnum(config.copilot),
+        codex: providerToggleToEnum(config.codex),
+        goose: providerToggleToEnum(config.goose),
+    });
+}
+/** Set a specific credential provider value. */
+export async function setCredentialProvider(req) {
+    if (!credentialProviders.VALID_PROVIDERS.includes(req.provider)) {
+        throw new ConnectError(`Invalid provider: ${req.provider}. Must be one of: ${credentialProviders.VALID_PROVIDERS.join(", ")}`, Code.InvalidArgument);
+    }
+    const allowed = req.provider === "claude"
+        ? credentialProviders.VALID_CLAUDE_VALUES
+        : credentialProviders.VALID_TOGGLE_VALUES;
+    if (!allowed.has(req.value)) {
+        throw new ConnectError(`Invalid value for ${req.provider}: ${req.value}. Must be one of: ${[...allowed].join(", ")}`, Code.InvalidArgument);
+    }
+    const current = credentialProviders.getCredentialProviders();
+    const updated = { ...current, [req.provider]: req.value };
+    credentialProviders.setCredentialProviders(updated);
+    emit("credential.providers_changed", updated);
+    return create(grackle.CredentialProviderConfigSchema, {
+        claude: claudeProviderModeToEnum(updated.claude),
+        github: providerToggleToEnum(updated.github),
+        copilot: providerToggleToEnum(updated.copilot),
+        codex: providerToggleToEnum(updated.codex),
+        goose: providerToggleToEnum(updated.goose),
+    });
+}
+//# sourceMappingURL=token-handlers.js.map

package/dist/token-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-handlers.js","sourceRoot":"","sources":["../src/token-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,+BAA+B;AAC/B,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAuB;IACpD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,mBAAmB,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACpE,CAAC;IACD,UAAU,CAAC,QAAQ,CAAC;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC,CAAC;IACH,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAC1B,MAAM,SAAS,CAAC,SAAS,EAAE,CAAC;IAC5B,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,UAAU;IAC9B,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,EAAE,CAAC;IACtC,OAAO,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE;QACrC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACtB,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE;YAC9B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;YACtB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,EAAE;YAC1B,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,EAAE;SAC7B,CAAC,CACH;KACF,CAAC,CAAC;AACL,CAAC;AAED,8BAA8B;AAC9B,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAsB;IACtD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;IACnE,CAAC;IACD,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAC1B,MAAM,SAAS,CAAC,SAAS,EAAE,CAAC;IAC5B,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,sBAAsB;IAC1C,MAAM,MAAM,GAAG,mBAAmB,CAAC,sBAAsB,EAAE,CAAC;IAC5D,OAAO,MAAM,CAAC,OAAO,CAAC,8BAA8B,EAAE;QACpD,MAAM,EAAE,wBAAwB,CAAC,MAAM,CAAC,MAAM,CAAC;QAC/C,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3C,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7C,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC;QACzC,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAyC;IACnF,IAAI,CAAC,mBAAmB,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,YAAY,CACpB,qBAAqB,GAAG,CAAC,QAAQ,qBAAqB,mBAAmB,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACtG,IAAI,CAAC,eAAe,CACrB,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,KAAK,QAAQ;QACvC,CAAC,CAAC,mBAAmB,CAAC,mBAAmB;QACzC,CAAC,CAAC,mBAAmB,CAAC,mBAAmB,CAAC;IAE5C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,YAAY,CACpB,qBAAqB,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,KAAK,qBAAqB,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC7F,IAAI,CAAC,eAAe,CACrB,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,mBAAmB,CAAC,sBAAsB,EAAE,CAAC;IAC7D,MAAM,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;IAC1D,mBAAmB,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAEpD,IAAI,CAAC,8BAA8B,EAAE,OAA6C,CAAC,CAAC;IAEpF,OAAO,MAAM,CAAC,OAAO,CAAC,8BAA8B,EAAE;QACpD,MAAM,EAAE,wBAAwB,CAAC,OAAO,CAAC,MAAM,CAAC;QAChD,MAAM,EAAE,oBAAoB,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5C,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC;QAC9C,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC;QAC1C,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,KAAK,CAAC;KAC3C,CAAC,CAAC;AACL,CAAC"}

package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.57.7"
+    }
+  ]
+}

package/dist/utils/format-gh-error.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Translate a raw `gh` CLI error into a user-friendly message.
+ * The raw error is still logged server-side for diagnostics.
+ */
+export declare function formatGhError(err: unknown, operation: string): string;
+//# sourceMappingURL=format-gh-error.d.ts.map

package/dist/utils/format-gh-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-gh-error.d.ts","sourceRoot":"","sources":["../../src/utils/format-gh-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA4BrE"}

package/dist/utils/format-gh-error.js

@@ -0,0 +1,30 @@
+/**
+ * Translate a raw `gh` CLI error into a user-friendly message.
+ * The raw error is still logged server-side for diagnostics.
+ */
+export function formatGhError(err, operation) {
+    const message = err instanceof Error ? err.message : String(err);
+    const rawStderr = err instanceof Error && "stderr" in err
+        ? err.stderr
+        : undefined;
+    const stderr = typeof rawStderr === "string" && rawStderr.length > 0
+        ? rawStderr
+        : Buffer.isBuffer(rawStderr) && rawStderr.length > 0
+            ? rawStderr.toString()
+            : "";
+    const code = err instanceof Error && "code" in err
+        ? String(err.code)
+        : "";
+    if (code === "ENOENT" || message.includes("ENOENT")) {
+        return "Could not find the `gh` CLI. Ensure GitHub CLI is installed and available on your system PATH, then restart the Grackle server.";
+    }
+    if (code === "EACCES" || message.includes("EACCES")) {
+        return "`gh` CLI found but not executable. Check file permissions.";
+    }
+    const combined = `${stderr} ${message}`.toLowerCase();
+    if (combined.includes("auth") || combined.includes("login")) {
+        return "GitHub CLI is not authenticated. Run `gh auth login` and restart.";
+    }
+    return `Failed to ${operation}: ${stderr || message}`;
+}
+//# sourceMappingURL=format-gh-error.js.map

package/dist/utils/format-gh-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-gh-error.js","sourceRoot":"","sources":["../../src/utils/format-gh-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY,EAAE,SAAiB;IAC3D,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,MAAM,SAAS,GACb,GAAG,YAAY,KAAK,IAAI,QAAQ,IAAI,GAAG;QACrC,CAAC,CAAE,GAAmC,CAAC,MAAM;QAC7C,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,MAAM,GACV,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QACnD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAClD,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE;YACtB,CAAC,CAAC,EAAE,CAAC;IACX,MAAM,IAAI,GACR,GAAG,YAAY,KAAK,IAAI,MAAM,IAAI,GAAG;QACnC,CAAC,CAAC,MAAM,CAAE,GAAiC,CAAC,IAAI,CAAC;QACjD,CAAC,CAAC,EAAE,CAAC;IAET,IAAI,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,OAAO,iIAAiI,CAAC;IAC3I,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,OAAO,4DAA4D,CAAC;IACtE,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC;IACtD,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5D,OAAO,mEAAmE,CAAC;IAC7E,CAAC;IACD,OAAO,aAAa,SAAS,KAAK,MAAM,IAAI,OAAO,EAAE,CAAC;AACxD,CAAC"}

package/dist/workspace-handlers.d.ts

@@ -0,0 +1,16 @@
+import { grackle } from "@grackle-ai/common";
+/** List all workspaces, optionally filtered by environment. */
+export declare function listWorkspaces(req: grackle.ListWorkspacesRequest): Promise<grackle.WorkspaceList>;
+/** Create a new workspace. */
+export declare function createWorkspace(req: grackle.CreateWorkspaceRequest): Promise<grackle.Workspace>;
+/** Get a workspace by ID. */
+export declare function getWorkspace(req: grackle.WorkspaceId): Promise<grackle.Workspace>;
+/** Archive a workspace. */
+export declare function archiveWorkspace(req: grackle.WorkspaceId): Promise<grackle.Empty>;
+/** Update workspace properties. */
+export declare function updateWorkspace(req: grackle.UpdateWorkspaceRequest): Promise<grackle.Workspace>;
+/** Link an additional environment to a workspace's pool. */
+export declare function linkEnvironment(req: grackle.LinkEnvironmentRequest): Promise<grackle.Workspace>;
+/** Remove a linked environment from a workspace's pool. */
+export declare function unlinkEnvironment(req: grackle.UnlinkEnvironmentRequest): Promise<grackle.Workspace>;
+//# sourceMappingURL=workspace-handlers.d.ts.map

package/dist/workspace-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-handlers.d.ts","sourceRoot":"","sources":["../src/workspace-handlers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAO7C,+DAA+D;AAC/D,wBAAsB,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CASvG;AAED,8BAA8B;AAC9B,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAqCrG;AAED,6BAA6B;AAC7B,wBAAsB,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAMvF;AAED,2BAA2B;AAC3B,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAKvF;AAED,mCAAmC;AACnC,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAoCrG;AAED,4DAA4D;AAC5D,wBAAsB,eAAe,CAAC,GAAG,EAAE,OAAO,CAAC,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAuCrG;AAED,2DAA2D;AAC3D,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAezG"}