@serviceme/devtools-protocol 0.0.3

package/LICENSE.md

@@ -0,0 +1,46 @@
+SERVICEME Protocol Package — Commercial License
+
+Copyright (c) 2024 Medalsoft Technology Co., Ltd. All rights reserved.
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential to Medalsoft Technology Co., Ltd. ("Medalsoft").
+
+GRANT OF LICENSE
+Medalsoft grants authorized users a non-exclusive, non-transferable, limited license
+to use the Software solely for internal business purposes in connection with
+Medalsoft's SERVICEME platform.
+
+RESTRICTIONS
+You may not, and may not permit others to:
+1. Copy, modify, merge, publish, distribute, sublicense, or sell copies of the Software;
+2. Reverse engineer, decompile, disassemble, or attempt to derive the source code;
+3. Remove or alter any proprietary notices, labels, or marks on the Software;
+4. Use the Software for any purpose other than as expressly authorized above;
+5. Transfer, assign, or sublicense your rights under this license to any third party.
+
+INTELLECTUAL PROPERTY
+The Software is protected by copyright laws and international treaties. Medalsoft
+retains all intellectual property rights in and to the Software, including all
+copyright, patent, trade secret, and other proprietary rights.
+
+NO WARRANTY
+THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+LIMITATION OF LIABILITY
+IN NO EVENT SHALL MEDALSOFT BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR IN CONNECTION WITH THIS
+LICENSE OR THE USE OF THE SOFTWARE.
+
+TERMINATION
+This license is effective until terminated. It will terminate automatically if you
+fail to comply with any term or condition. Upon termination, you must destroy all
+copies of the Software in your possession.
+
+GOVERNING LAW
+This license shall be governed by and construed in accordance with the laws of
+the People's Republic of China.
+
+CONTACT
+For licensing inquiries, contact: marketing@medalsoft.com

package/README.md

@@ -0,0 +1,21 @@
+# @serviceme/devtools-protocol
+
+Shared protocol contracts and runtime validators for SERVICEME CLI, bridge communication, and extension integration boundaries.
+
+## Install
+
+```bash
+npm install @serviceme/devtools-protocol
+```
+
+## Build
+
+```bash
+pnpm -F @serviceme/devtools-protocol run build
+```
+
+## Test
+
+```bash
+pnpm -F @serviceme/devtools-protocol run test
+```

package/dist/bridge.d.ts

@@ -0,0 +1,159 @@
+import type { ServicemeErrorDetails } from "./errors";
+import type { AgentSessionStatus, OpenCodeAgentEvent, OpenCodeRuntimeOptions, OpenCodeServerState } from "./opencode";
+export declare const SERVICEME_PROTOCOL_VERSION: 1;
+export interface BridgeCapabilities {
+    bridge: true;
+    opencode: 1;
+    json: 1;
+    env: 1;
+}
+export declare function isBridgeCapabilities(value: unknown): value is BridgeCapabilities;
+export interface BridgeMethodMap {
+    "system.hello": {
+        params: {
+            clientName: string;
+            clientVersion: string;
+            wantedCapabilities?: string[];
+        };
+        result: {
+            cliVersion: string;
+            protocolVersion: typeof SERVICEME_PROTOCOL_VERSION;
+            capabilities: BridgeCapabilities;
+            pid: number;
+        };
+    };
+    "system.ping": {
+        params: Record<string, never>;
+        result: {
+            now: string;
+        };
+    };
+    "system.shutdown": {
+        params: Record<string, never>;
+        result: {
+            shuttingDown: true;
+        };
+    };
+    "opencode.server.ensure": {
+        params: OpenCodeRuntimeOptions;
+        result: OpenCodeServerState;
+    };
+    "opencode.server.status": {
+        params: OpenCodeRuntimeOptions;
+        result: OpenCodeServerState;
+    };
+    "opencode.session.create": {
+        params: {
+            chatSessionId: string;
+            workspaceRoot?: string;
+            runtime?: OpenCodeRuntimeOptions;
+        };
+        result: {
+            sessionId: string;
+            title?: string;
+            status: AgentSessionStatus;
+        };
+    };
+    "opencode.session.prompt": {
+        params: {
+            sessionId: string;
+            promptId: string;
+            prompt: string;
+            workspaceRoot?: string;
+            runtime?: OpenCodeRuntimeOptions;
+        };
+        result: {
+            accepted: true;
+            sessionId: string;
+            promptId: string;
+        };
+    };
+    "opencode.session.status": {
+        params: {
+            sessionId: string;
+            workspaceRoot?: string;
+        };
+        result: {
+            sessionId: string;
+            status: AgentSessionStatus;
+        };
+    };
+    "opencode.session.abort": {
+        params: {
+            sessionId: string;
+            workspaceRoot?: string;
+        };
+        result: {
+            aborted: true;
+            sessionId: string;
+        };
+    };
+    "opencode.session.dispose": {
+        params: {
+            sessionId: string;
+        };
+        result: {
+            disposed: true;
+            sessionId: string;
+        };
+    };
+}
+export declare const BRIDGE_METHODS: readonly ["system.hello", "system.ping", "system.shutdown", "opencode.server.ensure", "opencode.server.status", "opencode.session.create", "opencode.session.prompt", "opencode.session.status", "opencode.session.abort", "opencode.session.dispose"];
+export type BridgeMethod = keyof BridgeMethodMap;
+export type BridgeParams<M extends BridgeMethod> = BridgeMethodMap[M]["params"];
+export type BridgeResult<M extends BridgeMethod> = BridgeMethodMap[M]["result"];
+export interface BridgeEventMap {
+    "opencode.session.event": {
+        sessionId: string;
+        promptId?: string;
+        payload: OpenCodeAgentEvent;
+    };
+}
+export declare const BRIDGE_EVENTS: readonly ["opencode.session.event"];
+export type BridgeEventName = keyof BridgeEventMap;
+export type BridgeEventParams<E extends BridgeEventName> = BridgeEventMap[E];
+export interface BridgeRequest<M extends BridgeMethod = BridgeMethod> {
+    protocolVersion: typeof SERVICEME_PROTOCOL_VERSION;
+    kind: "request";
+    id: string;
+    method: M;
+    params: BridgeParams<M>;
+}
+export interface BridgeSuccessResponse<M extends BridgeMethod = BridgeMethod> {
+    protocolVersion: typeof SERVICEME_PROTOCOL_VERSION;
+    kind: "response";
+    id: string;
+    ok: true;
+    result: BridgeResult<M>;
+}
+export interface BridgeErrorResponse {
+    protocolVersion: typeof SERVICEME_PROTOCOL_VERSION;
+    kind: "response";
+    id: string;
+    ok: false;
+    error: ServicemeErrorDetails;
+}
+export type BridgeResponse<M extends BridgeMethod = BridgeMethod> = BridgeSuccessResponse<M> | BridgeErrorResponse;
+export interface BridgeEvent<E extends BridgeEventName = BridgeEventName> {
+    protocolVersion: typeof SERVICEME_PROTOCOL_VERSION;
+    kind: "event";
+    event: E;
+    params: BridgeEventParams<E>;
+}
+export type BridgeMessage = BridgeRequest | BridgeResponse | BridgeEvent;
+export declare function isSystemHelloResult(value: unknown): value is BridgeResult<"system.hello">;
+export declare function isSystemPingResult(value: unknown): value is BridgeResult<"system.ping">;
+export declare function isSystemShutdownResult(value: unknown): value is BridgeResult<"system.shutdown">;
+export declare function isOpenCodeSessionCreateResult(value: unknown): value is BridgeResult<"opencode.session.create">;
+export declare function isOpenCodeSessionPromptResult(value: unknown): value is BridgeResult<"opencode.session.prompt">;
+export declare function isOpenCodeSessionStatusResult(value: unknown): value is BridgeResult<"opencode.session.status">;
+export declare function isOpenCodeSessionAbortResult(value: unknown): value is BridgeResult<"opencode.session.abort">;
+export declare function isOpenCodeSessionDisposeResult(value: unknown): value is BridgeResult<"opencode.session.dispose">;
+export declare function getBridgeResultValidator(method: BridgeMethod): ((value: unknown) => boolean) | undefined;
+export declare function isOpenCodeSessionEventParams(value: unknown): value is BridgeEventParams<"opencode.session.event">;
+export declare function getBridgeEventParamsValidator(event: BridgeEventName): ((value: unknown) => boolean) | undefined;
+export declare function isBridgeMethod(value: unknown): value is BridgeMethod;
+export declare function isBridgeEventName(value: unknown): value is BridgeEventName;
+export declare function isBridgeRequest(value: unknown): value is BridgeRequest;
+export declare function isBridgeResponse(value: unknown): value is BridgeResponse;
+export declare function isBridgeEvent(value: unknown): value is BridgeEvent;

package/dist/bridge.js

@@ -0,0 +1,139 @@
+import { isAgentSessionStatus, isOpenCodeAgentEvent, isOpenCodeServerState } from "./opencode";
+export const SERVICEME_PROTOCOL_VERSION = 1;
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+export function isBridgeCapabilities(value) {
+    return (isRecord(value) &&
+        value.bridge === true &&
+        value.opencode === 1 &&
+        value.json === 1 &&
+        value.env === 1);
+}
+export const BRIDGE_METHODS = [
+    "system.hello",
+    "system.ping",
+    "system.shutdown",
+    "opencode.server.ensure",
+    "opencode.server.status",
+    "opencode.session.create",
+    "opencode.session.prompt",
+    "opencode.session.status",
+    "opencode.session.abort",
+    "opencode.session.dispose",
+];
+export const BRIDGE_EVENTS = ["opencode.session.event"];
+export function isSystemHelloResult(value) {
+    return (isRecord(value) &&
+        typeof value.cliVersion === "string" &&
+        value.protocolVersion === SERVICEME_PROTOCOL_VERSION &&
+        isBridgeCapabilities(value.capabilities) &&
+        typeof value.pid === "number");
+}
+export function isSystemPingResult(value) {
+    return isRecord(value) && typeof value.now === "string";
+}
+export function isSystemShutdownResult(value) {
+    return isRecord(value) && value.shuttingDown === true;
+}
+export function isOpenCodeSessionCreateResult(value) {
+    return (isRecord(value) &&
+        typeof value.sessionId === "string" &&
+        (value.title === undefined || typeof value.title === "string") &&
+        isAgentSessionStatus(value.status));
+}
+export function isOpenCodeSessionPromptResult(value) {
+    return (isRecord(value) &&
+        value.accepted === true &&
+        typeof value.sessionId === "string" &&
+        typeof value.promptId === "string");
+}
+export function isOpenCodeSessionStatusResult(value) {
+    return (isRecord(value) && typeof value.sessionId === "string" && isAgentSessionStatus(value.status));
+}
+export function isOpenCodeSessionAbortResult(value) {
+    return isRecord(value) && value.aborted === true && typeof value.sessionId === "string";
+}
+export function isOpenCodeSessionDisposeResult(value) {
+    return isRecord(value) && value.disposed === true && typeof value.sessionId === "string";
+}
+export function getBridgeResultValidator(method) {
+    switch (method) {
+        case "system.hello":
+            return isSystemHelloResult;
+        case "system.ping":
+            return isSystemPingResult;
+        case "system.shutdown":
+            return isSystemShutdownResult;
+        case "opencode.server.ensure":
+        case "opencode.server.status":
+            return isOpenCodeServerState;
+        case "opencode.session.create":
+            return isOpenCodeSessionCreateResult;
+        case "opencode.session.prompt":
+            return isOpenCodeSessionPromptResult;
+        case "opencode.session.status":
+            return isOpenCodeSessionStatusResult;
+        case "opencode.session.abort":
+            return isOpenCodeSessionAbortResult;
+        case "opencode.session.dispose":
+            return isOpenCodeSessionDisposeResult;
+        default:
+            return undefined;
+    }
+}
+export function isOpenCodeSessionEventParams(value) {
+    return (isRecord(value) &&
+        typeof value.sessionId === "string" &&
+        (value.promptId === undefined || typeof value.promptId === "string") &&
+        isOpenCodeAgentEvent(value.payload));
+}
+export function getBridgeEventParamsValidator(event) {
+    switch (event) {
+        case "opencode.session.event":
+            return isOpenCodeSessionEventParams;
+        default:
+            return undefined;
+    }
+}
+export function isBridgeMethod(value) {
+    return typeof value === "string" && BRIDGE_METHODS.includes(value);
+}
+export function isBridgeEventName(value) {
+    return typeof value === "string" && BRIDGE_EVENTS.includes(value);
+}
+export function isBridgeRequest(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return (value.protocolVersion === SERVICEME_PROTOCOL_VERSION &&
+        value.kind === "request" &&
+        typeof value.id === "string" &&
+        isBridgeMethod(value.method) &&
+        "params" in value);
+}
+export function isBridgeResponse(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    if (value.protocolVersion !== SERVICEME_PROTOCOL_VERSION ||
+        value.kind !== "response" ||
+        typeof value.id !== "string" ||
+        typeof value.ok !== "boolean") {
+        return false;
+    }
+    if (value.ok) {
+        return "result" in value;
+    }
+    return "error" in value;
+}
+export function isBridgeEvent(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return (value.protocolVersion === SERVICEME_PROTOCOL_VERSION &&
+        value.kind === "event" &&
+        isBridgeEventName(value.event) &&
+        "params" in value);
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,16 @@
+import type { ServicemeErrorDetails } from "./errors";
+export declare const SERVICEME_CLI_SCHEMA_VERSION: 1;
+export interface CliSuccess<T> {
+    schemaVersion: typeof SERVICEME_CLI_SCHEMA_VERSION;
+    ok: true;
+    data: T;
+}
+export interface CliFailure {
+    schemaVersion: typeof SERVICEME_CLI_SCHEMA_VERSION;
+    ok: false;
+    error: ServicemeErrorDetails;
+}
+export type CliEnvelope<T> = CliSuccess<T> | CliFailure;
+export declare function createCliSuccess<T>(data: T): CliSuccess<T>;
+export declare function createCliFailure(error: ServicemeErrorDetails): CliFailure;
+export declare function isCliEnvelope(value: unknown): value is CliEnvelope<unknown>;

package/dist/cli.js

@@ -0,0 +1,31 @@
+export const SERVICEME_CLI_SCHEMA_VERSION = 1;
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+export function createCliSuccess(data) {
+    return {
+        schemaVersion: SERVICEME_CLI_SCHEMA_VERSION,
+        ok: true,
+        data,
+    };
+}
+export function createCliFailure(error) {
+    return {
+        schemaVersion: SERVICEME_CLI_SCHEMA_VERSION,
+        ok: false,
+        error,
+    };
+}
+export function isCliEnvelope(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    if (value.schemaVersion !== SERVICEME_CLI_SCHEMA_VERSION || typeof value.ok !== "boolean") {
+        return false;
+    }
+    if (value.ok) {
+        return "data" in value;
+    }
+    return "error" in value;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAU,CAAC;AAgBvD,SAAS,QAAQ,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAI,IAAO;IAC1C,OAAO;QACN,aAAa,EAAE,4BAA4B;QAC3C,EAAE,EAAE,IAAI;QACR,IAAI;KACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAA4B;IAC5D,OAAO;QACN,aAAa,EAAE,4BAA4B;QAC3C,EAAE,EAAE,KAAK;QACT,KAAK;KACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC3C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACd,CAAC;IAED,IAAI,KAAK,CAAC,aAAa,KAAK,4BAA4B,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC3F,OAAO,KAAK,CAAC;IACd,CAAC;IAED,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,MAAM,IAAI,KAAK,CAAC;IACxB,CAAC;IAED,OAAO,OAAO,IAAI,KAAK,CAAC;AACzB,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,12 @@
+export declare const KNOWN_ENVIRONMENT_TOOLS: readonly ["git", "node", "npm", "pnpm", "nvm", "nrm", "dotnet", "nuget"];
+export type KnownEnvironmentTool = (typeof KNOWN_ENVIRONMENT_TOOLS)[number];
+export interface ToolCheckResult {
+    installed: boolean;
+    version?: string;
+    path?: string;
+    error?: string;
+}
+export type EnvironmentCheckResult = Record<KnownEnvironmentTool, ToolCheckResult>;
+export declare function isKnownEnvironmentTool(value: string): value is KnownEnvironmentTool;
+export declare function isToolCheckResult(value: unknown): value is ToolCheckResult;
+export declare function isEnvironmentCheckResult(value: unknown): value is EnvironmentCheckResult;

package/dist/env.js

@@ -0,0 +1,32 @@
+export const KNOWN_ENVIRONMENT_TOOLS = [
+    "git",
+    "node",
+    "npm",
+    "pnpm",
+    "nvm",
+    "nrm",
+    "dotnet",
+    "nuget",
+];
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+export function isKnownEnvironmentTool(value) {
+    return KNOWN_ENVIRONMENT_TOOLS.includes(value);
+}
+export function isToolCheckResult(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return (typeof value.installed === "boolean" &&
+        (value.version === undefined || typeof value.version === "string") &&
+        (value.path === undefined || typeof value.path === "string") &&
+        (value.error === undefined || typeof value.error === "string"));
+}
+export function isEnvironmentCheckResult(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return KNOWN_ENVIRONMENT_TOOLS.every((tool) => isToolCheckResult(value[tool]));
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACtC,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,QAAQ;IACR,OAAO;CACE,CAAC;AAaX,SAAS,QAAQ,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAa;IACnD,OAAO,uBAAuB,CAAC,QAAQ,CAAC,KAA6B,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC/C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACd,CAAC;IAED,OAAO,CACN,OAAO,KAAK,CAAC,SAAS,KAAK,SAAS;QACpC,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC;QAClE,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;QAC5D,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAC9D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACtD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACd,CAAC;IAED,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,25 @@
+export type ServicemeErrorCode = "protocol_mismatch" | "cli_not_found" | "cli_start_failed" | "command_timeout" | "request_cancelled" | "invalid_params" | "opencode_not_installed" | "opencode_startup_timeout" | "opencode_request_failed" | "opencode_backend_not_running" | "opencode_session_not_found" | "json_invalid_input" | "env_tool_not_found" | "internal_error";
+export declare const SERVICEME_ERROR_CODES: readonly ["protocol_mismatch", "cli_not_found", "cli_start_failed", "command_timeout", "request_cancelled", "invalid_params", "opencode_not_installed", "opencode_startup_timeout", "opencode_request_failed", "opencode_backend_not_running", "opencode_session_not_found", "json_invalid_input", "env_tool_not_found", "internal_error"];
+export interface ServicemeErrorDetails {
+    code: ServicemeErrorCode;
+    message: string;
+    retryable: boolean;
+    details?: unknown;
+}
+export declare function isServicemeErrorCode(value: unknown): value is ServicemeErrorCode;
+export declare function isServicemeErrorDetails(value: unknown): value is ServicemeErrorDetails;
+export declare function isRetryableErrorCode(code: ServicemeErrorCode): boolean;
+export declare class ServicemeProtocolError extends Error {
+    readonly code: ServicemeErrorCode;
+    readonly retryable: boolean;
+    readonly details?: unknown;
+    constructor(input: {
+        code: ServicemeErrorCode;
+        message: string;
+        retryable?: boolean;
+        details?: unknown;
+    });
+    toJSON(): ServicemeErrorDetails;
+}
+export declare function createServicemeError(code: ServicemeErrorCode, message: string, details?: unknown): ServicemeProtocolError;
+export declare function normalizeServicemeError(error: unknown, fallbackCode?: ServicemeErrorCode): ServicemeErrorDetails;

package/dist/errors.js

@@ -0,0 +1,98 @@
+export const SERVICEME_ERROR_CODES = [
+    "protocol_mismatch",
+    "cli_not_found",
+    "cli_start_failed",
+    "command_timeout",
+    "request_cancelled",
+    "invalid_params",
+    "opencode_not_installed",
+    "opencode_startup_timeout",
+    "opencode_request_failed",
+    "opencode_backend_not_running",
+    "opencode_session_not_found",
+    "json_invalid_input",
+    "env_tool_not_found",
+    "internal_error",
+];
+const RETRYABLE_ERROR_CODES = new Set([
+    "command_timeout",
+    "request_cancelled",
+    "opencode_startup_timeout",
+    "opencode_request_failed",
+    "opencode_backend_not_running",
+    "internal_error",
+]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+export function isServicemeErrorCode(value) {
+    return typeof value === "string" && SERVICEME_ERROR_CODES.includes(value);
+}
+export function isServicemeErrorDetails(value) {
+    if (!isRecord(value)) {
+        return false;
+    }
+    return (isServicemeErrorCode(value.code) &&
+        typeof value.message === "string" &&
+        typeof value.retryable === "boolean");
+}
+export function isRetryableErrorCode(code) {
+    return RETRYABLE_ERROR_CODES.has(code);
+}
+export class ServicemeProtocolError extends Error {
+    constructor(input) {
+        super(input.message);
+        this.name = "ServicemeProtocolError";
+        this.code = input.code;
+        this.retryable = input.retryable ?? isRetryableErrorCode(input.code);
+        this.details = input.details;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            retryable: this.retryable,
+            details: this.details,
+        };
+    }
+}
+export function createServicemeError(code, message, details) {
+    return new ServicemeProtocolError({
+        code,
+        message,
+        details,
+    });
+}
+export function normalizeServicemeError(error, fallbackCode = "internal_error") {
+    if (error instanceof ServicemeProtocolError) {
+        return error.toJSON();
+    }
+    if (isServicemeErrorDetails(error)) {
+        return error;
+    }
+    if (isRecord(error)) {
+        const code = isServicemeErrorCode(error.code) ? error.code : fallbackCode;
+        const message = typeof error.message === "string" ? error.message : "Unexpected serviceme error.";
+        const retryable = typeof error.retryable === "boolean" ? error.retryable : isRetryableErrorCode(code);
+        return {
+            code,
+            message,
+            retryable,
+            details: error.details,
+        };
+    }
+    if (error instanceof Error) {
+        return {
+            code: fallbackCode,
+            message: error.message,
+            retryable: isRetryableErrorCode(fallbackCode),
+        };
+    }
+    return {
+        code: fallbackCode,
+        message: typeof error === "string" ? error : "Unexpected serviceme error.",
+        retryable: isRetryableErrorCode(fallbackCode),
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,mBAAmB;IACnB,eAAe;IACf,kBAAkB;IAClB,iBAAiB;IACjB,mBAAmB;IACnB,gBAAgB;IAChB,wBAAwB;IACxB,0BAA0B;IAC1B,yBAAyB;IACzB,8BAA8B;IAC9B,4BAA4B;IAC5B,oBAAoB;IACpB,oBAAoB;IACpB,gBAAgB;CACiC,CAAC;AASnD,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAqB;IACzD,iBAAiB;IACjB,mBAAmB;IACnB,0BAA0B;IAC1B,yBAAyB;IACzB,8BAA8B;IAC9B,gBAAgB;CAChB,CAAC,CAAC;AAEH,SAAS,QAAQ,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,qBAAqB,CAAC,QAAQ,CAAC,KAA2B,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACrD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACd,CAAC;IAED,OAAO,CACN,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC;QAChC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,OAAO,KAAK,CAAC,SAAS,KAAK,SAAS,CACpC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAwB;IAC5D,OAAO,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAKhD,YAAY,KAKX;QACA,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;IAED,MAAM;QACL,OAAO;YACN,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC;IACH,CAAC;CACA;AAEF,MAAM,UAAU,oBAAoB,CACnC,IAAwB,EACxB,OAAe,EACf,OAAiB;IAEjB,OAAO,IAAI,sBAAsB,CAAC;QACjC,IAAI;QACJ,OAAO;QACP,OAAO;KACP,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACtC,KAAc,EACd,eAAmC,gBAAgB;IAEnD,IAAI,KAAK,YAAY,sBAAsB,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IAED,IAAI,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,KAAK,CAAC;IACd,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;QAC1E,MAAM,OAAO,GACZ,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAC;QACnF,MAAM,SAAS,GACd,OAAO,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAErF,OAAO;YACN,IAAI;YACJ,OAAO;YACP,SAAS;YACT,OAAO,EAAE,KAAK,CAAC,OAAO;SACtB,CAAC;IACH,CAAC;IAED,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC5B,OAAO;YACN,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,oBAAoB,CAAC,YAAY,CAAC;SAC7C,CAAC;IACH,CAAC;IAED,OAAO;QACN,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,6BAA6B;QAC1E,SAAS,EAAE,oBAAoB,CAAC,YAAY,CAAC;KAC7C,CAAC;AACH,CAAC"}

package/dist/image.d.ts

@@ -0,0 +1,31 @@
+export type ServiceMeImageFormat = "jpeg" | "png" | "webp";
+export declare const SERVICEME_IMAGE_FORMATS: readonly ["jpeg", "png", "webp"];
+export interface ServiceMeImageCompressOptions {
+    quality: number;
+    replaceOriginImage: boolean;
+    outputPath?: string;
+    format?: ServiceMeImageFormat;
+    sharpModulePath?: string;
+    minimumCompressionRatio?: number;
+}
+export interface ServiceMeImageCompressResult {
+    originalSize: number;
+    compressedSize: number;
+    compressionRatio: number;
+    outputPath: string;
+}
+export interface ServiceMeImageInfo {
+    width: number;
+    height: number;
+    format: string;
+    size: number;
+    colorSpace?: string;
+}
+export interface ServiceMeImageValidationResult {
+    valid: boolean;
+}
+export declare function isServiceMeImageFormat(value: unknown): value is ServiceMeImageFormat;
+export declare function isServiceMeImageCompressOptions(value: unknown): value is ServiceMeImageCompressOptions;
+export declare function isServiceMeImageCompressResult(value: unknown): value is ServiceMeImageCompressResult;
+export declare function isServiceMeImageInfo(value: unknown): value is ServiceMeImageInfo;
+export declare function isServiceMeImageValidationResult(value: unknown): value is ServiceMeImageValidationResult;