poe-code 0.1.26

package/dist/services/roo-code.d.ts

@@ -0,0 +1,22 @@
+import type { FileSystem } from "../utils/file-system.js";
+import { type ServiceRunOptions } from "./service-manifest.js";
+export interface ConfigureRooCodeOptions {
+    fs: FileSystem;
+    configPath: string;
+    settingsPath: string;
+    configName: string;
+    apiKey: string;
+    model: string;
+    baseUrl: string;
+    autoImportPath: string;
+    rateLimitSeconds?: number;
+}
+export interface RemoveRooCodeOptions {
+    fs: FileSystem;
+    configPath: string;
+    settingsPath: string;
+    configName: string;
+    autoImportPath: string;
+}
+export declare function configureRooCode(options: ConfigureRooCodeOptions, runOptions?: ServiceRunOptions): Promise<void>;
+export declare function removeRooCode(options: RemoveRooCodeOptions, runOptions?: ServiceRunOptions): Promise<boolean>;

package/dist/services/roo-code.js

@@ -0,0 +1,134 @@
+import crypto from "node:crypto";
+import path from "node:path";
+import { isJsonObject } from "../utils/json.js";
+import { ensureDirectory, jsonMergeMutation, runServiceConfigure, runServiceRemove } from "./service-manifest.js";
+const DEFAULT_RATE_LIMIT_SECONDS = 0;
+const ROO_CODE_MANIFEST = {
+    id: "roo-code",
+    summary: "Configure Roo Code auto-import to use the Poe API.",
+    configure: [
+        ensureDirectory({
+            path: ({ options }) => path.dirname(options.configPath),
+            label: "Ensure Roo configuration directory"
+        }),
+        createConfigMutation(),
+        ensureDirectory({
+            path: ({ options }) => path.dirname(options.settingsPath),
+            label: "Ensure VSCode settings directory"
+        }),
+        jsonMergeMutation({
+            target: ({ options }) => options.settingsPath,
+            label: "Configure Roo auto-import path",
+            value: ({ options }) => ({
+                "roo-cline.autoImportSettingsPath": options.autoImportPath
+            })
+        })
+    ],
+    remove: [createRemoveConfigMutation()]
+};
+export async function configureRooCode(options, runOptions) {
+    await runServiceConfigure(ROO_CODE_MANIFEST, {
+        fs: options.fs,
+        options
+    }, runOptions);
+}
+export async function removeRooCode(options, runOptions) {
+    return runServiceRemove(ROO_CODE_MANIFEST, {
+        fs: options.fs,
+        options
+    }, runOptions);
+}
+function createConfigMutation() {
+    return {
+        kind: "transformFile",
+        label: "Merge Roo configuration",
+        target: ({ options }) => options.configPath,
+        async transform({ content, context }) {
+            const existing = content ? parseJson(content) : {};
+            const nextConfig = { ...existing };
+            const providerProfiles = cloneObject(nextConfig.providerProfiles);
+            const apiConfigs = cloneObject(providerProfiles.apiConfigs);
+            const existingEntry = cloneObject(apiConfigs[context.options.configName]);
+            const modeApiConfigs = cloneObject(providerProfiles.modeApiConfigs);
+            const profileId = readString(existingEntry.id) ?? generateProfileId();
+            const entry = {
+                id: profileId,
+                apiProvider: "openai",
+                openAiApiKey: context.options.apiKey,
+                openAiModelId: context.options.model,
+                openAiBaseUrl: context.options.baseUrl,
+                rateLimitSeconds: context.options.rateLimitSeconds ?? DEFAULT_RATE_LIMIT_SECONDS,
+                diffEnabled: true
+            };
+            apiConfigs[context.options.configName] = entry;
+            providerProfiles.apiConfigs = apiConfigs;
+            providerProfiles.modeApiConfigs = modeApiConfigs;
+            providerProfiles.currentApiConfigName = context.options.configName;
+            nextConfig.providerProfiles = providerProfiles;
+            const serialized = `${JSON.stringify(nextConfig, null, 2)}\n`;
+            return {
+                content: serialized,
+                changed: serialized !== content
+            };
+        }
+    };
+}
+function createRemoveConfigMutation() {
+    return {
+        kind: "transformFile",
+        label: "Remove Roo configuration",
+        target: ({ options }) => options.configPath,
+        async transform({ content, context }) {
+            if (content == null) {
+                return { content: null, changed: false };
+            }
+            const existing = parseJson(content);
+            if (!isJsonObject(existing.providerProfiles)) {
+                return { content, changed: false };
+            }
+            const providerProfiles = cloneObject(existing.providerProfiles);
+            const apiConfigs = cloneObject(providerProfiles.apiConfigs);
+            if (!(context.options.configName in apiConfigs)) {
+                return { content, changed: false };
+            }
+            delete apiConfigs[context.options.configName];
+            providerProfiles.apiConfigs = apiConfigs;
+            const remainingNames = Object.keys(apiConfigs);
+            if (remainingNames.length === 0) {
+                providerProfiles.currentApiConfigName = "";
+            }
+            else if (providerProfiles.currentApiConfigName === context.options.configName) {
+                providerProfiles.currentApiConfigName = remainingNames[0];
+            }
+            if (!isJsonObject(providerProfiles.modeApiConfigs)) {
+                providerProfiles.modeApiConfigs = {};
+            }
+            const nextConfig = { ...existing, providerProfiles };
+            const serialized = `${JSON.stringify(nextConfig, null, 2)}\n`;
+            return {
+                content: serialized,
+                changed: serialized !== content
+            };
+        }
+    };
+}
+function parseJson(content) {
+    const parsed = JSON.parse(content);
+    if (!isJsonObject(parsed)) {
+        throw new Error("Expected JSON object for Roo Code configuration.");
+    }
+    return parsed;
+}
+function cloneObject(value) {
+    if (!isJsonObject(value)) {
+        return {};
+    }
+    return { ...value };
+}
+function readString(value) {
+    return typeof value === "string" ? value : null;
+}
+function generateProfileId() {
+    return crypto.randomBytes(5).toString("hex");
+}
+//# sourceMappingURL=roo-code.js.map

package/dist/services/roo-code.js.map

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

package/dist/services/service-install.d.ts

@@ -0,0 +1,21 @@
+import type { CommandRunner, PrerequisiteDefinition } from "../utils/prerequisites.js";
+export interface InstallContext {
+    isDryRun: boolean;
+    runCommand: CommandRunner;
+    logger: (message: string) => void;
+}
+export interface InstallCommand {
+    id: string;
+    description: string;
+    command: string;
+    args: string[];
+}
+export interface ServiceInstallDefinition {
+    id: string;
+    summary: string;
+    check: PrerequisiteDefinition;
+    steps: InstallCommand[];
+    postChecks?: PrerequisiteDefinition[];
+    successMessage?: string;
+}
+export declare function runServiceInstall(definition: ServiceInstallDefinition, context: InstallContext): Promise<boolean>;

package/dist/services/service-install.js

@@ -0,0 +1,47 @@
+export async function runServiceInstall(definition, context) {
+    const checkContext = {
+        isDryRun: context.isDryRun,
+        runCommand: context.runCommand
+    };
+    let needsInstall = false;
+    try {
+        await definition.check.run(checkContext);
+        context.logger(`${definition.summary} already installed.`);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        context.logger(`${definition.summary} not detected: ${detail}`);
+        needsInstall = true;
+    }
+    if (!needsInstall) {
+        return false;
+    }
+    if (context.isDryRun) {
+        context.logger(`Dry run: would install ${definition.summary}.`);
+        for (const step of definition.steps) {
+            context.logger(`Dry run: ${step.description} -> ${formatCommand(step.command, step.args)}`);
+        }
+        return true;
+    }
+    for (const step of definition.steps) {
+        context.logger(`${step.description}...`);
+        const result = await context.runCommand(step.command, step.args);
+        if (result.exitCode !== 0) {
+            const stderr = result.stderr.trim();
+            const suffix = stderr.length > 0 ? `: ${stderr}` : "";
+            throw new Error(`${step.description} failed with exit code ${result.exitCode}${suffix}`);
+        }
+    }
+    await definition.check.run(checkContext);
+    if (definition.postChecks) {
+        for (const postCheck of definition.postChecks) {
+            await postCheck.run(checkContext);
+        }
+    }
+    context.logger(definition.successMessage ?? `${definition.summary} installed.`);
+    return true;
+}
+function formatCommand(command, args) {
+    return [command, ...args].join(" ");
+}
+//# sourceMappingURL=service-install.js.map

package/dist/services/service-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-install.js","sourceRoot":"","sources":["../../src/services/service-install.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAoC,EACpC,OAAuB;IAEvB,MAAM,YAAY,GAAwB;QACxC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC;IAEF,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACzC,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GACV,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,OAAO,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,kBAAkB,MAAM,EAAE,CAAC,CAAC;QAChE,YAAY,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,0BAA0B,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC;QAChE,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;YACpC,OAAO,CAAC,MAAM,CACZ,YAAY,IAAI,CAAC,WAAW,OAAO,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5E,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACpC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,KAAK,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CACb,GAAG,IAAI,CAAC,WAAW,0BAA0B,MAAM,CAAC,QAAQ,GAAG,MAAM,EAAE,CACxE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAEzC,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;QAC1B,KAAK,MAAM,SAAS,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;YAC9C,MAAM,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,CAAC,MAAM,CACZ,UAAU,CAAC,cAAc,IAAI,GAAG,UAAU,CAAC,OAAO,aAAa,CAChE,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,aAAa,CAAC,OAAe,EAAE,IAAc;IACpD,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC"}

package/dist/services/service-manifest.d.ts

@@ -0,0 +1,122 @@
+import type { FileSystem } from "../utils/file-system.js";
+import { type JsonObject } from "../utils/json.js";
+type ValueResolver<Options, Value> = Value | ((context: MutationContext<Options>) => Value);
+interface MutationContext<Options> {
+    options: Options;
+    fs: FileSystem;
+}
+interface TransformResult {
+    content: string | null;
+    changed: boolean;
+}
+interface TransformFileMutation<Options> {
+    kind: "transformFile";
+    label?: string;
+    target: ValueResolver<Options, string>;
+    transform(input: {
+        content: string | null;
+        context: MutationContext<Options>;
+    }): Promise<TransformResult> | TransformResult;
+}
+interface EnsureDirectoryMutation<Options> {
+    kind: "ensureDirectory";
+    label?: string;
+    path: ValueResolver<Options, string>;
+}
+interface CreateBackupMutation<Options> {
+    kind: "createBackup";
+    label?: string;
+    target: ValueResolver<Options, string>;
+    timestamp?: ValueResolver<Options, (() => string) | undefined>;
+}
+interface WriteTemplateMutation<Options> {
+    kind: "writeTemplate";
+    label?: string;
+    target: ValueResolver<Options, string>;
+    templateId: string;
+    context?: ValueResolver<Options, JsonObject | undefined>;
+}
+interface RemoveFileMutation<Options> {
+    kind: "removeFile";
+    label?: string;
+    target: ValueResolver<Options, string>;
+    whenEmpty?: boolean;
+    whenContentMatches?: RegExp;
+}
+export type ServiceMutation<Options> = TransformFileMutation<Options> | EnsureDirectoryMutation<Options> | CreateBackupMutation<Options> | WriteTemplateMutation<Options> | RemoveFileMutation<Options>;
+export interface ServiceManifest<ConfigureOptions, RemoveOptions = ConfigureOptions> {
+    id: string;
+    summary: string;
+    prerequisites?: {
+        before?: string[];
+        after?: string[];
+    };
+    configure: ServiceMutation<ConfigureOptions>[];
+    remove?: ServiceMutation<RemoveOptions>[];
+}
+export interface ServiceExecutionContext<Options> {
+    fs: FileSystem;
+    options: Options;
+}
+export interface MutationLogDetails {
+    manifestId: string;
+    kind: ServiceMutationKind;
+    label: string;
+    targetPath?: string;
+}
+export type MutationDetail = "create" | "update" | "delete" | "noop" | "backup";
+export interface ServiceMutationOutcome {
+    changed: boolean;
+    effect: MutationEffect;
+    detail?: MutationDetail;
+}
+export type MutationEffect = "none" | "mkdir" | "copy" | "write" | "delete";
+export interface ServiceMutationHooks {
+    onStart?(details: MutationLogDetails): void;
+    onComplete?(details: MutationLogDetails, outcome: ServiceMutationOutcome): void;
+    onError?(details: MutationLogDetails, error: unknown): void;
+}
+export declare function ensureDirectory<Options>(config: {
+    path: ValueResolver<Options, string>;
+    label?: string;
+}): ServiceMutation<Options>;
+export declare function createBackupMutation<Options>(config: {
+    target: ValueResolver<Options, string>;
+    timestamp?: ValueResolver<Options, (() => string) | undefined>;
+    label?: string;
+}): ServiceMutation<Options>;
+export declare function writeTemplateMutation<Options>(config: {
+    target: ValueResolver<Options, string>;
+    templateId: string;
+    context?: ValueResolver<Options, JsonObject | undefined>;
+    label?: string;
+}): ServiceMutation<Options>;
+export declare function jsonMergeMutation<Options>(config: {
+    target: ValueResolver<Options, string>;
+    value: ValueResolver<Options, JsonObject>;
+    label?: string;
+}): ServiceMutation<Options>;
+export declare function jsonPruneMutation<Options>(config: {
+    target: ValueResolver<Options, string>;
+    shape: ValueResolver<Options, JsonObject>;
+    label?: string;
+}): ServiceMutation<Options>;
+export declare function removePatternMutation<Options>(config: {
+    target: ValueResolver<Options, string>;
+    pattern: RegExp;
+    replacement?: string | ((match: string, context: MutationContext<Options>) => string);
+    label?: string;
+}): ServiceMutation<Options>;
+export declare function removeFileMutation<Options>(config: {
+    target: ValueResolver<Options, string>;
+    whenEmpty?: boolean;
+    whenContentMatches?: RegExp;
+    label?: string;
+}): ServiceMutation<Options>;
+export declare function runServiceConfigure<ConfigureOptions, RemoveOptions = ConfigureOptions>(manifest: ServiceManifest<ConfigureOptions, RemoveOptions>, context: ServiceExecutionContext<ConfigureOptions>, runOptions?: ServiceRunOptions): Promise<void>;
+export declare function runServiceRemove<ConfigureOptions, RemoveOptions = ConfigureOptions>(manifest: ServiceManifest<ConfigureOptions, RemoveOptions>, context: ServiceExecutionContext<RemoveOptions>, runOptions?: ServiceRunOptions): Promise<boolean>;
+export interface ServiceRunOptions {
+    hooks?: ServiceMutationHooks;
+}
+export type ServiceMutationKind = ServiceMutation<unknown>["kind"];
+export {};