kennel 0.1.9 → 0.2.1

package/node_modules/@raggle-ai/local/dist/service/generated/schemas/projectSearch200ItemsItem.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Raggle Scout Service
+ * Read-only access to the local Scout project catalog.
+ * OpenAPI spec version: 1.0.0
+ */
+import type { Match } from "./match";
+import type { ServiceProject } from "./serviceProject";
+export type ProjectSearch200ItemsItem = ServiceProject & {
+    match: Match;
+};

package/node_modules/@raggle-ai/local/dist/service/generated/schemas/projectSearch200ItemsItem.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/node_modules/@raggle-ai/local/dist/service/generated/schemas/projectSearchParams.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Raggle Scout Service
+ * Read-only access to the local Scout project catalog.
+ * OpenAPI spec version: 1.0.0
+ */
+export type ProjectSearchParams = {
+    /**
+     * Project search query
+     * @minLength 1
+     */
+    query: string;
+    /**
+     * Maximum results
+     * @minimum 1
+     * @maximum 100
+     */
+    limit?: number;
+};

package/node_modules/@raggle-ai/local/dist/service/generated/schemas/projectSearchParams.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Raggle Scout Service
+ * Read-only access to the local Scout project catalog.
+ * OpenAPI spec version: 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/node_modules/@raggle-ai/local/dist/service/generated/schemas/serviceProject.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Raggle Scout Service
+ * Read-only access to the local Scout project catalog.
+ * OpenAPI spec version: 1.0.0
+ */
+export interface ServiceProject {
+    id: string;
+    name: string;
+    description?: string;
+    keywords?: string[];
+    relativePath?: string;
+    repositoryLabel?: string;
+    subtitle?: string;
+    lastCommitAt?: number;
+    localEditAt?: number;
+    activityAt?: number;
+}

package/node_modules/@raggle-ai/local/dist/service/generated/schemas/serviceProject.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Raggle Scout Service
+ * Read-only access to the local Scout project catalog.
+ * OpenAPI spec version: 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/node_modules/@raggle-ai/local/dist/service/generated/schemas/serviceVersion200.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Raggle Scout Service
+ * Read-only access to the local Scout project catalog.
+ * OpenAPI spec version: 1.0.0
+ */
+export type ServiceVersion200 = {
+    schemaVersion: 1;
+    service: "raggle-scout";
+    packageVersion: string;
+};

package/node_modules/@raggle-ai/local/dist/service/generated/schemas/serviceVersion200.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Generated by orval 🍺
+ * Do not edit manually.
+ * Raggle Scout Service
+ * Read-only access to the local Scout project catalog.
+ * OpenAPI spec version: 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/node_modules/@raggle-ai/local/dist/service/scout-service.d.ts

@@ -0,0 +1,17 @@
+export declare const scoutServiceHost = "127.0.0.1";
+export declare const scoutServicePort = 4789;
+export declare const scoutServiceContractVersion = 1;
+export type ScoutServiceOptions = {
+    folder: string;
+    token: string;
+    host?: string;
+    port?: number;
+    refreshIntervalMs?: number;
+};
+export type ScoutService = {
+    host: string;
+    port: number;
+    url: string;
+    close(): Promise<void>;
+};
+export declare function startScoutService(options: ScoutServiceOptions): Promise<ScoutService>;

package/node_modules/@raggle-ai/local/dist/service/scout-service.js

@@ -0,0 +1,196 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scoutServiceContractVersion = exports.scoutServicePort = exports.scoutServiceHost = void 0;
+exports.startScoutService = startScoutService;
+const node_crypto_1 = require("node:crypto");
+const node_http_1 = require("node:http");
+const node_fs_1 = require("node:fs");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const live_project_search_1 = require("../core/live-project-search");
+const project_feed_1 = require("../adapters/project-feed");
+exports.scoutServiceHost = "127.0.0.1";
+exports.scoutServicePort = 4789;
+exports.scoutServiceContractVersion = 1;
+const maximumSearchLimit = 100;
+const packageVersion = (() => {
+    const packagePath = node_path_1.default.resolve(__dirname, "../../package.json");
+    const metadata = JSON.parse((0, node_fs_1.readFileSync)(packagePath, "utf8"));
+    if (typeof metadata.version !== "string" || !metadata.version) {
+        throw new Error("Scout package metadata does not contain a version.");
+    }
+    return metadata.version;
+})();
+const openApiDocument = JSON.parse((0, node_fs_1.readFileSync)(node_path_1.default.resolve(__dirname, "../../schemas/scout-service-openapi.json"), "utf8"));
+function sendJson(response, status, body) {
+    const data = JSON.stringify(body);
+    response.writeHead(status, {
+        "cache-control": "no-store",
+        "content-length": Buffer.byteLength(data),
+        "content-type": "application/json; charset=utf-8",
+        "x-content-type-options": "nosniff",
+    });
+    response.end(data);
+}
+function sendError(response, status, code, message) {
+    sendJson(response, status, { schemaVersion: exports.scoutServiceContractVersion, error: { code, message } });
+}
+function authorized(request, expectedToken) {
+    const authorization = request.headers.authorization;
+    if (!authorization?.startsWith("Bearer "))
+        return false;
+    const received = Buffer.from(authorization.slice("Bearer ".length));
+    const expected = Buffer.from(expectedToken);
+    return received.length === expected.length && (0, node_crypto_1.timingSafeEqual)(received, expected);
+}
+function serviceProject(project) {
+    return {
+        id: project.id,
+        name: project.name,
+        description: project.description,
+        keywords: project.keywords,
+        relativePath: project.relativePath,
+        repositoryLabel: project.repositoryLabel,
+        subtitle: project.subtitle,
+        lastCommitAt: project.lastCommitAt,
+        localEditAt: project.localEditAt,
+        activityAt: project.activityAt,
+    };
+}
+function searchLimit(url) {
+    const rawLimit = url.searchParams.get("limit");
+    if (rawLimit === null)
+        return 20;
+    const limit = Number(rawLimit);
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > maximumSearchLimit)
+        return undefined;
+    return limit;
+}
+function closeServer(server) {
+    return new Promise((resolve, reject) => {
+        server.close((error) => (error ? reject(error) : resolve()));
+    });
+}
+async function startScoutService(options) {
+    const folderStatus = await (0, promises_1.stat)(options.folder).catch(() => undefined);
+    if (!folderStatus?.isDirectory())
+        throw new Error(`Service folder does not exist: ${options.folder}`);
+    if (!options.token.trim())
+        throw new Error("Scout service token must not be empty.");
+    const search = (0, live_project_search_1.createLiveProjectSearch)({
+        refreshIntervalMs: options.refreshIntervalMs,
+        loadProjects: async () => (await (0, project_feed_1.listLocalProjectFeed)({
+            cloneDirectory: options.folder,
+            orderBy: "name",
+            includeIcons: false,
+            addEmojis: false,
+            includeActivity: true,
+            includeNestedProjects: true,
+            includeFolderRoot: true,
+            scan: { maxRepos: 2_000, timeoutMs: 15_000 },
+        })).items,
+    });
+    await search.refresh();
+    const server = (0, node_http_1.createServer)((request, response) => {
+        void (async () => {
+            if (request.method !== "GET") {
+                sendError(response, 405, "method_not_allowed", "Scout service only accepts GET requests.");
+                return;
+            }
+            const url = new URL(request.url ?? "/", `http://${exports.scoutServiceHost}`);
+            if (url.pathname === "/v1/health") {
+                sendJson(response, 200, { schemaVersion: exports.scoutServiceContractVersion, status: "ok" });
+                return;
+            }
+            if (url.pathname === "/v1/version") {
+                sendJson(response, 200, {
+                    schemaVersion: exports.scoutServiceContractVersion,
+                    service: "raggle-scout",
+                    packageVersion,
+                });
+                return;
+            }
+            if (url.pathname === "/v1/openapi.json") {
+                sendJson(response, 200, openApiDocument);
+                return;
+            }
+            if (!authorized(request, options.token)) {
+                response.setHeader("www-authenticate", "Bearer");
+                sendError(response, 401, "unauthorized", "A valid Scout service token is required.");
+                return;
+            }
+            await search.refreshIfStale();
+            const projects = search.getSnapshot().projects;
+            if (url.pathname === "/v1/projects") {
+                sendJson(response, 200, {
+                    schemaVersion: exports.scoutServiceContractVersion,
+                    items: projects.map(serviceProject),
+                    total: projects.length,
+                });
+                return;
+            }
+            if (url.pathname === "/v1/search") {
+                const query = url.searchParams.get("query")?.trim();
+                if (!query) {
+                    sendError(response, 400, "invalid_query", "The query parameter is required.");
+                    return;
+                }
+                const limit = searchLimit(url);
+                if (limit === undefined) {
+                    sendError(response, 400, "invalid_limit", `The limit must be an integer from 1 to ${maximumSearchLimit}.`);
+                    return;
+                }
+                const result = search.searchFlat(query, { limit });
+                sendJson(response, 200, {
+                    schemaVersion: exports.scoutServiceContractVersion,
+                    items: result.hits.map((hit) => ({
+                        ...serviceProject(hit.project),
+                        match: { field: hit.matchedField, tier: hit.matchTier, score: hit.score },
+                    })),
+                    total: result.total,
+                    scanned: result.scanned,
+                });
+                return;
+            }
+            const projectMatch = url.pathname.match(/^\/v1\/projects\/([^/]+)\/metadata$/);
+            if (projectMatch) {
+                const project = projects.find((project) => project.id === decodeURIComponent(projectMatch[1]));
+                if (!project) {
+                    sendError(response, 404, "project_not_found", "The project does not exist in this Scout service.");
+                    return;
+                }
+                sendJson(response, 200, { schemaVersion: exports.scoutServiceContractVersion, project: serviceProject(project) });
+                return;
+            }
+            sendError(response, 404, "route_not_found", "The Scout service route does not exist.");
+        })().catch(() => {
+            sendError(response, 500, "internal_error", "Scout service failed.");
+        });
+    });
+    const host = options.host ?? exports.scoutServiceHost;
+    const requestedPort = options.port ?? exports.scoutServicePort;
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(requestedPort, host, () => {
+            server.off("error", reject);
+            resolve();
+        });
+    });
+    const address = server.address();
+    if (!address || typeof address === "string") {
+        await closeServer(server);
+        throw new Error("Scout service did not open a TCP address.");
+    }
+    return {
+        host,
+        port: address.port,
+        url: `http://${host}:${address.port}`,
+        close: () => {
+            search.dispose();
+            return closeServer(server);
+        },
+    };
+}

package/node_modules/@raggle-ai/local/dist/sessions/create.d.ts

@@ -0,0 +1,7 @@
+import { type AiChatClientId } from "@raggle-ai/clients";
+export type SessionCreateOptions = {
+    client: AiChatClientId;
+    folder: string;
+    query: string;
+};
+export declare function sessionCreateCommand(options: SessionCreateOptions): Promise<string>;

package/node_modules/@raggle-ai/local/dist/sessions/create.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionCreateCommand = sessionCreateCommand;
+const node_fs_1 = require("node:fs");
+const clients_1 = require("@raggle-ai/clients");
+const connected_projects_1 = require("../core/connected-projects");
+async function sessionLinkedFolders(folder) {
+    const connected = await (0, connected_projects_1.listConnectedProjects)(folder, { all: true });
+    return [...connected.linked, ...connected.local].map((project) => ({
+        worktree: (0, node_fs_1.realpathSync)(project.worktree),
+        repository: project.remoteUrl,
+        listed: project.listed === true,
+    }));
+}
+async function sessionCreateCommand(options) {
+    const application = (0, clients_1.loadApplicationSchemas)().find((item) => item.slug === options.client);
+    if (!application)
+        throw new Error(`Unknown AI client: ${options.client}`);
+    const folder = (0, node_fs_1.realpathSync)(options.folder);
+    const openTarget = await (0, clients_1.applicationOpenCommand)(application, {
+        worktree: folder,
+        mode: "new",
+        prompt: (0, clients_1.sessionPromptWithLinkedFolders)(options.query, await sessionLinkedFolders(folder)),
+    });
+    if (!openTarget)
+        throw new Error(`${application.name} cannot create a session with a query`);
+    return openTarget.command;
+}

package/node_modules/@raggle-ai/local/dist/sessions/index.d.ts

@@ -0,0 +1,48 @@
+export { sessionCreateCommand, type SessionCreateOptions } from "./create";
+export { SESSION_RESUME_DEEPLINKS, sessionResumeCommand, sessionResumeTarget, type SessionIdentity, type SessionResumeDeeplink, type SessionResumeTarget, } from "./resume";
+export declare const LOCAL_SESSION_CLIENTS: readonly ["codex", "claude", "pi", "opencode"];
+export type LocalSessionClient = (typeof LOCAL_SESSION_CLIENTS)[number];
+export type LocalSessionContent = {
+    type: "text";
+    text: string;
+} | {
+    type: "tool-call";
+    name: string;
+    input?: unknown;
+} | {
+    type: "tool-result";
+    name?: string;
+    output: string;
+};
+export type LocalSessionMessage = {
+    role: "user" | "assistant" | "tool";
+    timestamp?: string;
+    content: LocalSessionContent[];
+};
+export type LocalSessionSummary = {
+    id: string;
+    client: LocalSessionClient;
+    title: string;
+    folder: string;
+    createdAt?: string;
+    lastMessageAt?: string;
+    messageCount: number;
+    archived: boolean;
+};
+export type LocalSession = LocalSessionSummary & {
+    messages: LocalSessionMessage[];
+};
+export type LocalSessionProjectActivity = {
+    client: LocalSessionClient;
+    folder: string;
+    lastActivityAt: string;
+};
+export declare function listLocalSessionProjectActivity(options?: {
+    client?: LocalSessionClient;
+}): Promise<LocalSessionProjectActivity[]>;
+export declare function listLocalSessions(options: {
+    folder: string;
+    client?: LocalSessionClient;
+    limit?: number;
+}): Promise<LocalSessionSummary[]>;
+export declare function readLocalSession(id: string): Promise<LocalSession>;