@gokiteam/goki-dev 0.2.1 → 0.2.3

package/src/mcp/tools/services.js

@@ -3,6 +3,7 @@ export function registerServicesTools (server, apiClient) {
     'services_list',
     'List all dev-tools platform services and their status',
     {},
+    { readOnlyHint: true },
     async () => {
       try {
         const data = await apiClient.post('/v1/services/list')
@@ -17,6 +18,7 @@ export function registerServicesTools (server, apiClient) {
     'services_status',
     'Get detailed status of all services',
     {},
+    { readOnlyHint: true },
     async () => {
       try {
         const data = await apiClient.post('/v1/services/status')
@@ -29,8 +31,9 @@ export function registerServicesTools (server, apiClient) {
 
   server.tool(
     'services_restart',
-    'Restart dev-tools services',
+    '[DESTRUCTIVE] Restart dev-tools services. Ask the user for confirmation before calling this tool.',
     {},
+    { destructiveHint: true },
     async () => {
       try {
         const data = await apiClient.post('/v1/services/restart')
@@ -57,8 +60,9 @@ export function registerServicesTools (server, apiClient) {
 
   server.tool(
     'scheduler_stop',
-    'Stop the scheduler tick',
+    '[DESTRUCTIVE] Stop the scheduler tick. Ask the user for confirmation before calling this tool.',
     {},
+    { destructiveHint: true },
     async () => {
       try {
         const data = await apiClient.post('/v1/scheduler/tick/stop')
@@ -73,6 +77,7 @@ export function registerServicesTools (server, apiClient) {
     'scheduler_status',
     'Get scheduler tick status (running/stopped, interval)',
     {},
+    { readOnlyHint: true },
     async () => {
       try {
         const data = await apiClient.post('/v1/scheduler/tick/status')
@@ -113,8 +118,9 @@ export function registerServicesTools (server, apiClient) {
 
   server.tool(
     'gateway_stop',
-    'Stop the app gateway service',
+    '[DESTRUCTIVE] Stop the app gateway service. Ask the user for confirmation before calling this tool.',
     {},
+    { destructiveHint: true },
     async () => {
       try {
         const data = await apiClient.post('/v1/gateway/stop')
@@ -129,6 +135,7 @@ export function registerServicesTools (server, apiClient) {
     'gateway_status',
     'Get the app gateway status',
     {},
+    { readOnlyHint: true },
     async () => {
       try {
         const data = await apiClient.post('/v1/gateway/status')
@@ -157,6 +164,7 @@ export function registerServicesTools (server, apiClient) {
     'gateway_health_check',
     'Run health checks on all gateway endpoints',
     {},
+    { readOnlyHint: true },
     async () => {
       try {
         const data = await apiClient.post('/v1/gateway/healthCheck')

package/src/mcp/tools/snapshots.js

@@ -21,11 +21,12 @@ export function registerSnapshotTools (server, apiClient) {
 
   server.tool(
     'snapshots_restore',
-    'Restore development environment from a snapshot. This will stop microservices, restore data, and restart them.',
+    '[DESTRUCTIVE] Restore development environment from a snapshot. This will stop microservices, restore data, and restart them. Ask the user for confirmation before calling this tool.',
     {
       snapshotId: z.string().describe('Snapshot ID to restore from (e.g., "e2e_2026-02-26_10-30-45")'),
       restartServices: z.boolean().optional().describe('Whether to restart microservices after restore (default: true)')
     },
+    { destructiveHint: true },
     async ({ snapshotId, restartServices }) => {
       try {
         const body = { snapshotId }
@@ -42,6 +43,7 @@ export function registerSnapshotTools (server, apiClient) {
     'snapshots_list',
     'List all available snapshots with their metadata',
     {},
+    { readOnlyHint: true },
     async () => {
       try {
         const data = await apiClient.post('/v1/snapshots/list', {})
@@ -58,6 +60,7 @@ export function registerSnapshotTools (server, apiClient) {
     {
       snapshotId: z.string().describe('Snapshot ID to get details for')
     },
+    { readOnlyHint: true },
     async ({ snapshotId }) => {
       try {
         const data = await apiClient.post('/v1/snapshots/details', { snapshotId })
@@ -70,10 +73,11 @@ export function registerSnapshotTools (server, apiClient) {
 
   server.tool(
     'snapshots_delete',
-    'Delete a snapshot and its files',
+    '[DESTRUCTIVE] Delete a snapshot and its files. Ask the user for confirmation before calling this tool.',
     {
       snapshotId: z.string().optional().describe('Snapshot ID to delete. If omitted, deletes all snapshots.')
     },
+    { destructiveHint: true },
     async ({ snapshotId }) => {
       try {
         const body = {}

package/src/mcp/tools/webhooks.js

@@ -27,6 +27,7 @@ export function registerWebhooksTools (server, apiClient) {
     'webhooks_list',
     'List all registered webhooks',
     {},
+    { readOnlyHint: true },
     async () => {
       try {
         const data = await apiClient.post('/v1/webhooks/list')
@@ -39,10 +40,11 @@ export function registerWebhooksTools (server, apiClient) {
 
   server.tool(
     'webhooks_remove',
-    'Remove a registered webhook by its prefix',
+    '[DESTRUCTIVE] Remove a registered webhook by its prefix. Ask the user for confirmation before calling this tool.',
     {
       prefix: z.string().describe('URL prefix of the webhook to remove')
     },
+    { destructiveHint: true },
     async ({ prefix }) => {
       try {
         const data = await apiClient.post('/v1/webhooks/remove', { prefix })
@@ -73,6 +75,7 @@ export function registerWebhooksTools (server, apiClient) {
     'webhooks_tunnel_status',
     'Get ngrok tunnel status (connected/disconnected, public URL)',
     {},
+    { readOnlyHint: true },
     async () => {
       try {
         const data = await apiClient.post('/v1/webhooks/tunnel/status')
@@ -87,6 +90,7 @@ export function registerWebhooksTools (server, apiClient) {
     'webhooks_settings_get',
     'Get current webhook/ngrok settings',
     {},
+    { readOnlyHint: true },
     async () => {
       try {
         const data = await apiClient.post('/v1/webhooks/settings/get')

package/src/singletons/SqliteStore.js

@@ -21,10 +21,15 @@ class SqliteStoreClass {
   initialize (dbPath = null) {
     if (this.isInitialized) return
 
-    const dataDir = Application.storage.dataDir || './data'
+    const dataDir = Application.storage.dataDir
     if (!fs.existsSync(dataDir)) {
       fs.mkdirSync(dataDir, { recursive: true })
     }
+    if (dataDir.includes('.goki-dev') && fs.existsSync('./data/dev-tools.db')) {
+      console.warn('[MIGRATION] Found legacy database at ./data/dev-tools.db')
+      console.warn(`[MIGRATION] Database now lives at ${path.join(dataDir, 'dev-tools.db')}`)
+      console.warn(`[MIGRATION] Copy manually: cp ./data/dev-tools.db ${path.join(dataDir, 'dev-tools.db')}`)
+    }
 
     const finalDbPath = dbPath || path.join(dataDir, 'dev-tools.db')
     this.db = new Database(finalDbPath)

package/client/dist/client.d.ts

@@ -1,380 +0,0 @@
-/**
- * @gokiteam/goki-dev - Main Client
- *
- * HTTP client for Goki Developer Tools
- */
-import { AxiosInstance } from 'axios';
-import type * as Types from './types';
-export interface DevToolsClientConfig {
-    baseUrl?: string;
-    timeout?: number;
-}
-export declare class PubSubClient {
-    private client;
-    constructor(client: AxiosInstance);
-    private call;
-    /**
-     * Extract short topic name from a full path like 'projects/X/topics/Y' -> 'Y'
-     */
-    private extractTopicName;
-    publish(params: {
-        topic: string;
-        message: any;
-        attributes?: Record<string, string>;
-        traceId?: string;
-    }): Promise<{
-        messageIds: string[];
-    } & {
-        traceId: string;
-    }>;
-    waitForMessage(params: Types.WaitForMessageRequest): Promise<Types.WaitForMessageResponse>;
-    assertMessagePublished(params: Types.AssertMessagePublishedRequest): Promise<Types.AssertMessagePublishedResponse>;
-    getMessages(params?: {
-        filter?: Types.PubSubHistoryFilter;
-        page?: Types.PageOptions;
-        traceId?: string;
-    }): Promise<{
-        messages: Types.PubSubMessage[];
-        total: number;
-    } & {
-        traceId: string;
-    }>;
-    searchMessages(params: {
-        query: string;
-        filter?: Partial<Types.PubSubHistoryFilter>;
-        traceId?: string;
-    }): Promise<{
-        messages: Types.PubSubMessage[];
-        total: number;
-    } & {
-        traceId: string;
-    }>;
-    listTopics(params?: {
-        traceId?: string;
-    }): Promise<{
-        topics: Types.PubSubTopic[];
-        total: number;
-    } & {
-        traceId: string;
-    }>;
-    createTopic(params: {
-        topic: string;
-        traceId?: string;
-    }): Promise<{
-        topic: Types.PubSubTopic;
-    } & {
-        traceId: string;
-    }>;
-    deleteTopic(params: {
-        topic: string;
-        traceId?: string;
-    }): Promise<void>;
-}
-export declare class LoggingClient {
-    private client;
-    constructor(client: AxiosInstance);
-    private call;
-    getByTrace(params: {
-        traceId: string;
-        queryTraceId?: string;
-    }): Promise<{
-        traceId: string;
-        entries: Types.LogEntry[];
-        count: number;
-    }>;
-    list(params?: {
-        filter?: Types.LogFilter;
-        page?: Types.PageOptions;
-        traceId?: string;
-    }): Promise<{
-        entries: Types.LogEntry[];
-        total: number;
-    } & {
-        traceId: string;
-    }>;
-    clear(params?: {
-        service?: string;
-        traceId?: string;
-    }): Promise<{
-        deletedCount: number;
-    } & {
-        traceId: string;
-    }>;
-    waitForLog(params: Types.WaitForLogRequest): Promise<Types.WaitForLogResponse>;
-    assertNoErrors(params: Types.AssertNoErrorsRequest): Promise<Types.AssertNoErrorsResponse>;
-}
-export declare class PostgresClient {
-    private client;
-    constructor(client: AxiosInstance);
-    private call;
-    query(params: Types.PostgresQueryRequest): Promise<Types.PostgresQueryResponse>;
-    listTables(params: {
-        database: string;
-        schema?: string;
-        traceId?: string;
-    }): Promise<{
-        tables: {
-            name: string;
-            rowCount: number;
-        }[];
-    } & {
-        traceId: string;
-    }>;
-    listRows(params: {
-        database: string;
-        schema: string;
-        table: string;
-        page?: Types.PageOptions;
-        traceId?: string;
-    }): Promise<{
-        rows: any[];
-        total: number;
-    } & {
-        traceId: string;
-    }>;
-    waitForCondition(params: Types.WaitForConditionRequest & {
-        type: 'postgres';
-    }): Promise<Types.WaitForConditionResponse>;
-}
-export declare class RedisClient {
-    private client;
-    constructor(client: AxiosInstance);
-    private call;
-    get(params: {
-        key: string;
-        traceId?: string;
-    }): Promise<Types.RedisValue>;
-    scan(params: {
-        pattern: string;
-        count?: number;
-        traceId?: string;
-    }): Promise<{
-        keys: Types.RedisKey[];
-        total: number;
-    } & {
-        traceId: string;
-    }>;
-    delete(params: {
-        key: string;
-        traceId?: string;
-    }): Promise<{
-        deleted: boolean;
-    } & {
-        traceId: string;
-    }>;
-    deletePattern(params: {
-        pattern: string;
-        traceId?: string;
-    }): Promise<{
-        deletedCount: number;
-    } & {
-        traceId: string;
-    }>;
-    waitForCondition(params: Types.WaitForConditionRequest & {
-        type: 'redis';
-    }): Promise<Types.WaitForConditionResponse>;
-}
-export declare class FirestoreClient {
-    private client;
-    constructor(client: AxiosInstance);
-    private call;
-    /**
-     * Parses a Firestore REST API typed value into a plain JS value.
-     */
-    private parseFirestoreValue;
-    /**
-     * Parses Firestore REST API fields object into a plain JS object.
-     */
-    private parseFirestoreFields;
-    /**
-     * Converts a raw Firestore REST API document to a clean FirestoreDocument.
-     * Raw format: { name: "projects/.../documents/collection/id", fields: { key: { stringValue: "..." } }, ... }
-     * Clean format: { id: "docId", data: { key: "..." } }
-     */
-    private parseRawDocument;
-    getDocument(params: {
-        collection: string;
-        documentId: string;
-        traceId?: string;
-    }): Promise<{
-        document: Types.FirestoreDocument;
-    }>;
-    query(params: {
-        collection: string;
-        where: Types.FirestoreQuery;
-        traceId?: string;
-    }): Promise<{
-        documents: Types.FirestoreDocument[];
-    }>;
-    listDocuments(params: {
-        collection: string;
-        page?: Types.PageOptions;
-        traceId?: string;
-    }): Promise<{
-        documents: Types.FirestoreDocument[];
-        total: number;
-    }>;
-    deleteByQuery(params: Types.DeleteByQueryRequest): Promise<Types.DeleteByQueryResponse>;
-    deleteByPrefix(params: Types.DeleteByPrefixRequest): Promise<Types.DeleteByPrefixResponse>;
-    deleteBatch(params: Types.DeleteBatchRequest): Promise<Types.DeleteBatchResponse>;
-    waitForCondition(params: Types.WaitForConditionRequest & {
-        type: 'firestore';
-    }): Promise<Types.WaitForConditionResponse>;
-}
-export declare class MqttClient {
-    private client;
-    constructor(client: AxiosInstance);
-    private call;
-    listClients(params?: {
-        traceId?: string;
-    }): Promise<{
-        clients: Types.MqttClientInfo[];
-    } & {
-        traceId: string;
-    }>;
-    getMessages(params?: {
-        filter?: {
-            clientId?: string;
-            topic?: string;
-        };
-        page?: Types.PageOptions;
-        traceId?: string;
-    }): Promise<{
-        messages: Types.MqttMessage[];
-        total: number;
-    } & {
-        traceId: string;
-    }>;
-}
-export declare class DockerClient {
-    private client;
-    constructor(client: AxiosInstance);
-    private call;
-    list(params?: {
-        traceId?: string;
-    }): Promise<{
-        data: Types.DockerContainer[];
-    } & {
-        traceId: string;
-    }>;
-    start(params: {
-        containerName: string;
-        traceId?: string;
-    }): Promise<void>;
-    stop(params: {
-        containerName: string;
-        traceId?: string;
-    }): Promise<void>;
-    restart(params: {
-        containerName: string;
-        traceId?: string;
-    }): Promise<void>;
-    logs(params: {
-        containerName: string;
-        lines?: number;
-        traceId?: string;
-    }): Promise<{
-        data: string;
-    } & {
-        traceId: string;
-    }>;
-}
-export declare class PlatformClient {
-    private client;
-    constructor(client: AxiosInstance);
-    private call;
-    getStats(params?: {
-        traceId?: string;
-    }): Promise<{
-        stats: Types.PlatformStats;
-    } & {
-        traceId: string;
-    }>;
-    clearAll(params?: {
-        traceId?: string;
-    }): Promise<{
-        cleared: Record<string, number>;
-    } & {
-        traceId: string;
-    }>;
-    clearServices(params: Types.ClearServiceDataRequest): Promise<Types.ClearServiceDataResponse>;
-    export(params?: {
-        traceId?: string;
-    }): Promise<{
-        export: Types.ExportData;
-    } & {
-        traceId: string;
-    }>;
-}
-export declare class SchedulerClient {
-    private client;
-    constructor(client: AxiosInstance);
-    private call;
-    triggerTick(params?: {
-        traceId?: string;
-    }): Promise<Types.SchedulerTickResponse>;
-}
-export declare class HttpTrafficClient {
-    private client;
-    constructor(client: AxiosInstance);
-    private call;
-    list(params?: {
-        filter?: Types.HttpTrafficFilter;
-        limit?: number;
-        offset?: number;
-        traceId?: string;
-    }): Promise<{
-        entries: Types.HttpTrafficEntry[];
-        total: number;
-        limit: number;
-        offset: number;
-    } & {
-        traceId: string;
-    }>;
-    getDetails(params: {
-        id: string;
-        traceId?: string;
-    }): Promise<{
-        entry: Types.HttpTrafficEntry;
-    } & {
-        traceId: string;
-    }>;
-    clear(params?: {
-        traceId?: string;
-    }): Promise<{
-        message: string;
-    } & {
-        traceId: string;
-    }>;
-    waitFor(params: {
-        filter: Types.HttpTrafficWaitFilter;
-        timeout?: number;
-        traceId?: string;
-    }): Promise<{
-        entry: Types.HttpTrafficEntry;
-        foundAt: number;
-        traceId: string;
-    }>;
-    stats(params?: {
-        traceId?: string;
-    }): Promise<Types.HttpTrafficStats & {
-        traceId: string;
-    }>;
-}
-export declare class DevToolsClient {
-    private client;
-    private baseUrl;
-    pubsub: PubSubClient;
-    logging: LoggingClient;
-    postgres: PostgresClient;
-    redis: RedisClient;
-    firestore: FirestoreClient;
-    mqtt: MqttClient;
-    docker: DockerClient;
-    platform: PlatformClient;
-    scheduler: SchedulerClient;
-    httpTraffic: HttpTrafficClient;
-    constructor(config?: DevToolsClientConfig);
-    generateTraceId(prefix?: string): string;
-}
-export * from './types';