@ogment-ai/cli 0.3.5 → 0.4.0

package/dist/shared/errors.d.ts

@@ -1,35 +1,126 @@
+import { ERROR_CODE, type ErrorCategory, type ErrorCode } from "./error-codes.js";
+type AuthErrorCode = typeof ERROR_CODE.authDeviceExpired | typeof ERROR_CODE.authDevicePending | typeof ERROR_CODE.authInvalidCredentials | typeof ERROR_CODE.authRequired;
+type RemoteErrorCode = typeof ERROR_CODE.remoteRateLimited | typeof ERROR_CODE.remoteUnavailable | typeof ERROR_CODE.transportRequestFailed;
+type ValidationErrorCode = typeof ERROR_CODE.toolInputSchemaViolation | typeof ERROR_CODE.validationInvalidInput;
+type ContractMismatchErrorCode = typeof ERROR_CODE.contractVersionUnsupported;
+interface BaseAppErrorFields {
+    category: ErrorCategory;
+    code: ErrorCode;
+    retryable: boolean;
+    suggestedCommand: string | undefined;
+}
 declare const ValidationErrorBase: import("better-result").TaggedErrorClass<"ValidationError", {
-    message: string;
     details?: string;
+    message: string;
 }>;
-export declare class ValidationError extends ValidationErrorBase {
+interface ValidationErrorPayload {
+    code?: ValidationErrorCode;
+    details?: string;
+    message: string;
+    suggestedCommand?: string;
+}
+export declare class ValidationError extends ValidationErrorBase implements BaseAppErrorFields {
+    readonly category: "validation";
+    readonly code: ValidationErrorCode;
+    readonly retryable = false;
+    readonly suggestedCommand: string | undefined;
+    constructor(payload: ValidationErrorPayload);
 }
 declare const AuthErrorBase: import("better-result").TaggedErrorClass<"AuthError", {
-    message: string;
     details?: string;
+    message: string;
 }>;
-export declare class AuthError extends AuthErrorBase {
+interface AuthErrorPayload {
+    code?: AuthErrorCode;
+    details?: string;
+    message: string;
+    retryable?: boolean;
+    suggestedCommand?: string;
+}
+export declare class AuthError extends AuthErrorBase implements BaseAppErrorFields {
+    readonly category: "auth";
+    readonly code: AuthErrorCode;
+    readonly retryable: boolean;
+    readonly suggestedCommand: string | undefined;
+    constructor(payload: AuthErrorPayload);
 }
 declare const NotFoundErrorBase: import("better-result").TaggedErrorClass<"NotFoundError", {
     message: string;
     resource: string;
 }>;
-export declare class NotFoundError extends NotFoundErrorBase {
+interface NotFoundErrorPayload {
+    code?: typeof ERROR_CODE.toolNotFound;
+    message: string;
+    resource: string;
+    suggestedCommand?: string;
+}
+export declare class NotFoundError extends NotFoundErrorBase implements BaseAppErrorFields {
+    readonly category: "not_found";
+    readonly code: typeof ERROR_CODE.toolNotFound;
+    readonly retryable = false;
+    readonly suggestedCommand: string | undefined;
+    constructor(payload: NotFoundErrorPayload);
 }
 declare const RemoteRequestErrorBase: import("better-result").TaggedErrorClass<"RemoteRequestError", {
+    body?: string;
     message: string;
     status?: number;
+}>;
+interface RemoteRequestErrorPayload {
     body?: string;
+    code?: RemoteErrorCode;
+    message: string;
+    status?: number;
+    suggestedCommand?: string;
+}
+export declare class RemoteRequestError extends RemoteRequestErrorBase implements BaseAppErrorFields {
+    readonly category: ErrorCategory;
+    readonly code: RemoteErrorCode;
+    readonly retryable: boolean;
+    readonly suggestedCommand: string | undefined;
+    constructor(payload: RemoteRequestErrorPayload);
+}
+declare const ContractMismatchErrorBase: import("better-result").TaggedErrorClass<"ContractMismatchError", {
+    details?: string;
+    message: string;
 }>;
-export declare class RemoteRequestError extends RemoteRequestErrorBase {
+interface ContractMismatchErrorPayload {
+    code?: ContractMismatchErrorCode;
+    details?: string;
+    message: string;
+    suggestedCommand?: string;
+}
+export declare class ContractMismatchError extends ContractMismatchErrorBase implements BaseAppErrorFields {
+    readonly category: "contract_mismatch";
+    readonly code: ContractMismatchErrorCode;
+    readonly retryable = false;
+    readonly suggestedCommand: string | undefined;
+    constructor(payload: ContractMismatchErrorPayload);
 }
 declare const UnexpectedErrorBase: import("better-result").TaggedErrorClass<"UnexpectedError", {
-    message: string;
     cause?: unknown;
+    message: string;
 }>;
-export declare class UnexpectedError extends UnexpectedErrorBase {
+interface UnexpectedErrorPayload {
+    cause?: unknown;
+    code?: typeof ERROR_CODE.internalUnexpected;
+    message: string;
+}
+export declare class UnexpectedError extends UnexpectedErrorBase implements BaseAppErrorFields {
+    readonly category: "internal";
+    readonly code: typeof ERROR_CODE.internalUnexpected;
+    readonly retryable = false;
+    readonly suggestedCommand: undefined;
+    constructor(payload: UnexpectedErrorPayload);
+}
+export type AppError = AuthError | ContractMismatchError | NotFoundError | RemoteRequestError | UnexpectedError | ValidationError;
+export interface AppErrorMeta {
+    category: ErrorCategory;
+    code: ErrorCode;
+    retryable: boolean;
+    suggestedCommand: string | undefined;
 }
-export type AppError = AuthError | NotFoundError | RemoteRequestError | UnexpectedError | ValidationError;
+export declare const appErrorMeta: (error: AppError) => AppErrorMeta;
 export declare const formatAppError: (error: AppError) => string;
 export {};
 //# sourceMappingURL=errors.d.ts.map

package/dist/shared/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,mBAAmB;aACd,MAAM;cACL,MAAM;EACd,CAAC;AAEL,qBAAa,eAAgB,SAAQ,mBAAmB;CAAG;AAE3D,QAAA,MAAM,aAAa;aACR,MAAM;cACL,MAAM;EACd,CAAC;AAEL,qBAAa,SAAU,SAAQ,aAAa;CAAG;AAE/C,QAAA,MAAM,iBAAiB;aACZ,MAAM;cACL,MAAM;EACd,CAAC;AAEL,qBAAa,aAAc,SAAQ,iBAAiB;CAAG;AAEvD,QAAA,MAAM,sBAAsB;aACjB,MAAM;aACN,MAAM;WACR,MAAM;EACX,CAAC;AAEL,qBAAa,kBAAmB,SAAQ,sBAAsB;CAAG;AAEjE,QAAA,MAAM,mBAAmB;aACd,MAAM;YACP,OAAO;EACb,CAAC;AAEL,qBAAa,eAAgB,SAAQ,mBAAmB;CAAG;AAE3D,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT,aAAa,GACb,kBAAkB,GAClB,eAAe,GACf,eAAe,CAAC;AAMpB,eAAO,MAAM,cAAc,GAAI,OAAO,QAAQ,KAAG,MAchD,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/shared/errors.ts"],"names":[],"mappings":"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"}

package/dist/shared/errors.js

@@ -1,22 +1,125 @@
 import { TaggedError } from "better-result";
+import { ERROR_CATEGORY, ERROR_CODE } from "./error-codes.js";
 const ValidationErrorBase = TaggedError("ValidationError")();
 export class ValidationError extends ValidationErrorBase {
+    category = ERROR_CATEGORY.validation;
+    code;
+    retryable = false;
+    suggestedCommand;
+    constructor(payload) {
+        super({
+            message: payload.message,
+            ...(payload.details === undefined ? {} : { details: payload.details }),
+        });
+        this.code = payload.code ?? ERROR_CODE.validationInvalidInput;
+        this.suggestedCommand = payload.suggestedCommand;
+    }
 }
 const AuthErrorBase = TaggedError("AuthError")();
 export class AuthError extends AuthErrorBase {
+    category = ERROR_CATEGORY.auth;
+    code;
+    retryable;
+    suggestedCommand;
+    constructor(payload) {
+        super({
+            message: payload.message,
+            ...(payload.details === undefined ? {} : { details: payload.details }),
+        });
+        this.code = payload.code ?? ERROR_CODE.authRequired;
+        this.retryable = payload.retryable ?? this.code === ERROR_CODE.authDeviceExpired;
+        this.suggestedCommand = payload.suggestedCommand;
+    }
 }
 const NotFoundErrorBase = TaggedError("NotFoundError")();
 export class NotFoundError extends NotFoundErrorBase {
+    category = ERROR_CATEGORY.notFound;
+    code;
+    retryable = false;
+    suggestedCommand;
+    constructor(payload) {
+        super({
+            message: payload.message,
+            resource: payload.resource,
+        });
+        this.code = payload.code ?? ERROR_CODE.toolNotFound;
+        this.suggestedCommand = payload.suggestedCommand;
+    }
 }
 const RemoteRequestErrorBase = TaggedError("RemoteRequestError")();
+const resolveRemoteErrorCode = (payload) => {
+    if (payload.code !== undefined) {
+        return payload.code;
+    }
+    if (payload.status === 429) {
+        return ERROR_CODE.remoteRateLimited;
+    }
+    if (payload.status !== undefined && payload.status >= 500) {
+        return ERROR_CODE.remoteUnavailable;
+    }
+    return ERROR_CODE.transportRequestFailed;
+};
 export class RemoteRequestError extends RemoteRequestErrorBase {
+    category;
+    code;
+    retryable;
+    suggestedCommand;
+    constructor(payload) {
+        super({
+            message: payload.message,
+            ...(payload.body === undefined ? {} : { body: payload.body }),
+            ...(payload.status === undefined ? {} : { status: payload.status }),
+        });
+        this.code = resolveRemoteErrorCode(payload);
+        this.category =
+            this.code === ERROR_CODE.remoteRateLimited ? ERROR_CATEGORY.rateLimit : ERROR_CATEGORY.remote;
+        this.retryable =
+            this.code === ERROR_CODE.remoteRateLimited ||
+                this.code === ERROR_CODE.remoteUnavailable ||
+                this.code === ERROR_CODE.transportRequestFailed;
+        this.suggestedCommand = payload.suggestedCommand;
+    }
+}
+const ContractMismatchErrorBase = TaggedError("ContractMismatchError")();
+export class ContractMismatchError extends ContractMismatchErrorBase {
+    category = ERROR_CATEGORY.contractMismatch;
+    code;
+    retryable = false;
+    suggestedCommand;
+    constructor(payload) {
+        super({
+            message: payload.message,
+            ...(payload.details === undefined ? {} : { details: payload.details }),
+        });
+        this.code = payload.code ?? ERROR_CODE.contractVersionUnsupported;
+        this.suggestedCommand = payload.suggestedCommand;
+    }
 }
 const UnexpectedErrorBase = TaggedError("UnexpectedError")();
 export class UnexpectedError extends UnexpectedErrorBase {
+    category = ERROR_CATEGORY.internal;
+    code;
+    retryable = false;
+    suggestedCommand = undefined;
+    constructor(payload) {
+        super({
+            message: payload.message,
+            ...(payload.cause === undefined ? {} : { cause: payload.cause }),
+        });
+        this.code = payload.code ?? ERROR_CODE.internalUnexpected;
+    }
 }
 const hasDetails = (error) => {
     return error._tag === "AuthError" || error._tag === "ValidationError";
 };
+export const appErrorMeta = (error) => {
+    return {
+        category: error.category,
+        code: error.code,
+        retryable: error.retryable,
+        suggestedCommand: error.suggestedCommand,
+    };
+};
 export const formatAppError = (error) => {
     if (error._tag === "NotFoundError") {
         return `${error.message} (${error.resource})`;

package/dist/shared/exit-codes.d.ts

@@ -1,11 +1,14 @@
 import type { AppError } from "./errors.js";
 export declare const EXIT_CODE: {
-    readonly auth: 20;
-    readonly notFound: 40;
-    readonly remoteRequest: 30;
+    readonly authFailed: 4;
+    readonly authRequired: 3;
+    readonly contractMismatch: 8;
+    readonly internal: 9;
+    readonly notFound: 5;
+    readonly rateLimit: 6;
+    readonly remote: 7;
     readonly success: 0;
-    readonly unexpected: 50;
-    readonly validation: 10;
+    readonly validation: 2;
 };
 export type ExitCode = (typeof EXIT_CODE)[keyof typeof EXIT_CODE];
 export declare const exitCodeForError: (error: AppError) => ExitCode;

package/dist/shared/exit-codes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/shared/exit-codes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,SAAS;;;;;;;CAOZ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAElE,eAAO,MAAM,gBAAgB,GAAI,OAAO,QAAQ,KAAG,QAkBlD,CAAC"}
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/shared/exit-codes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI5C,eAAO,MAAM,SAAS;;;;;;;;;;CAUZ,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAElE,eAAO,MAAM,gBAAgB,GAAI,OAAO,QAAQ,KAAG,QA+BlD,CAAC"}

package/dist/shared/exit-codes.js

@@ -1,27 +1,44 @@
+import { ERROR_CATEGORY, ERROR_CODE } from "./error-codes.js";
+import { appErrorMeta } from "./errors.js";
 export const EXIT_CODE = {
-    auth: 20,
-    notFound: 40,
-    remoteRequest: 30,
+    authFailed: 4,
+    authRequired: 3,
+    contractMismatch: 8,
+    internal: 9,
+    notFound: 5,
+    rateLimit: 6,
+    remote: 7,
     success: 0,
-    unexpected: 50,
-    validation: 10,
+    validation: 2,
 };
 export const exitCodeForError = (error) => {
-    switch (error._tag) {
-        case "AuthError": {
-            return EXIT_CODE.auth;
+    const { category, code } = appErrorMeta(error);
+    switch (category) {
+        case ERROR_CATEGORY.auth: {
+            if (code === ERROR_CODE.authRequired) {
+                return EXIT_CODE.authRequired;
+            }
+            return EXIT_CODE.authFailed;
         }
-        case "NotFoundError": {
+        case ERROR_CATEGORY.notFound: {
             return EXIT_CODE.notFound;
         }
-        case "RemoteRequestError": {
-            return EXIT_CODE.remoteRequest;
+        case ERROR_CATEGORY.rateLimit: {
+            return EXIT_CODE.rateLimit;
         }
-        case "UnexpectedError": {
-            return EXIT_CODE.unexpected;
+        case ERROR_CATEGORY.remote:
+        case ERROR_CATEGORY.transport:
+        case ERROR_CATEGORY.authorization: {
+            return EXIT_CODE.remote;
         }
-        case "ValidationError": {
+        case ERROR_CATEGORY.contractMismatch: {
+            return EXIT_CODE.contractMismatch;
+        }
+        case ERROR_CATEGORY.validation: {
             return EXIT_CODE.validation;
         }
+        case ERROR_CATEGORY.internal: {
+            return EXIT_CODE.internal;
+        }
     }
 };

package/dist/shared/guards.d.ts

@@ -1,6 +1,10 @@
 import type { Result as ResultType } from "better-result";
 import type { ZodTypeAny } from "zod";
 import { z } from "zod";
+import { ERROR_CODE } from "./error-codes.js";
 import { ValidationError } from "./errors.js";
-export declare const parseWithSchema: <TSchema extends ZodTypeAny>(schema: TSchema, payload: unknown, context: string) => ResultType<z.infer<TSchema>, ValidationError>;
+export declare const parseWithSchema: <TSchema extends ZodTypeAny>(schema: TSchema, payload: unknown, context: string, options?: {
+    code?: typeof ERROR_CODE.toolInputSchemaViolation | typeof ERROR_CODE.validationInvalidInput;
+    suggestedCommand?: string;
+}) => ResultType<z.infer<TSchema>, ValidationError>;
 //# sourceMappingURL=guards.d.ts.map

package/dist/shared/guards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/shared/guards.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAoB9C,eAAO,MAAM,eAAe,GAAI,OAAO,SAAS,UAAU,EACxD,QAAQ,OAAO,EACf,SAAS,OAAO,EAChB,SAAS,MAAM,KACd,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,eAAe,CAa9C,CAAC"}
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../src/shared/guards.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAoB9C,eAAO,MAAM,eAAe,GAAI,OAAO,SAAS,UAAU,EACxD,QAAQ,OAAO,EACf,SAAS,OAAO,EAChB,SAAS,MAAM,EACf,UAAS;IACP,IAAI,CAAC,EAAE,OAAO,UAAU,CAAC,wBAAwB,GAAG,OAAO,UAAU,CAAC,sBAAsB,CAAC;IAC7F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACtB,KACL,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,eAAe,CAiB9C,CAAC"}

package/dist/shared/guards.js

@@ -1,5 +1,6 @@
 import { Result } from "better-result";
 import { z } from "zod";
+import { ERROR_CODE } from "./error-codes.js";
 import { ValidationError } from "./errors.js";
 const formatIssues = (issues) => {
     return issues
@@ -14,12 +15,16 @@ const formatIssues = (issues) => {
     })
         .join("; ");
 };
-export const parseWithSchema = (schema, payload, context) => {
+export const parseWithSchema = (schema, payload, context, options = {}) => {
     const parsed = schema.safeParse(payload);
     if (!parsed.success) {
         return Result.err(new ValidationError({
             details: formatIssues(parsed.error.issues),
             message: `Invalid ${context}`,
+            ...(options.code === undefined ? {} : { code: options.code }),
+            ...(options.suggestedCommand === undefined
+                ? {}
+                : { suggestedCommand: options.suggestedCommand }),
         }));
     }
     return Result.ok(parsed.data);

package/dist/shared/retry.d.ts

@@ -0,0 +1,17 @@
+interface RetryableErrorLike {
+    _tag?: string;
+    retryable?: boolean;
+}
+export declare const REMOTE_RETRY_DELAY_MS: number;
+export declare const REMOTE_RETRY_TIMES = 2;
+export declare const isRetryableRemoteError: (error: RetryableErrorLike) => boolean;
+export declare const remoteRetryConfig: () => {
+    retry: {
+        backoff: "exponential";
+        delayMs: number;
+        shouldRetry: (error: RetryableErrorLike) => boolean;
+        times: number;
+    };
+};
+export {};
+//# sourceMappingURL=retry.d.ts.map

package/dist/shared/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/shared/retry.ts"],"names":[],"mappings":"AAAA,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAkBD,eAAO,MAAM,qBAAqB,QAAqD,CAAC;AACxF,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,eAAO,MAAM,sBAAsB,GAAI,OAAO,kBAAkB,KAAG,OAElE,CAAC;AAEF,eAAO,MAAM,iBAAiB,QAAO;IACnC,KAAK,EAAE;QACL,OAAO,EAAE,aAAa,CAAC;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC;QACpD,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CAUH,CAAC"}

package/dist/shared/retry.js

@@ -0,0 +1,27 @@
+const RETRY_DELAY_ENV_NAME = "OGMENT_REMOTE_RETRY_DELAY_MS";
+const REMOTE_RETRY_DELAY_DEFAULT_MS = 10_000;
+const parseRetryDelay = (value) => {
+    if (value === undefined) {
+        return REMOTE_RETRY_DELAY_DEFAULT_MS;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        return REMOTE_RETRY_DELAY_DEFAULT_MS;
+    }
+    return parsed;
+};
+export const REMOTE_RETRY_DELAY_MS = parseRetryDelay(process.env[RETRY_DELAY_ENV_NAME]);
+export const REMOTE_RETRY_TIMES = 2;
+export const isRetryableRemoteError = (error) => {
+    return error._tag === "RemoteRequestError" && error.retryable === true;
+};
+export const remoteRetryConfig = () => {
+    return {
+        retry: {
+            backoff: "exponential",
+            delayMs: REMOTE_RETRY_DELAY_MS,
+            shouldRetry: isRetryableRemoteError,
+            times: REMOTE_RETRY_TIMES,
+        },
+    };
+};

package/dist/shared/schema-example.d.ts

@@ -0,0 +1,2 @@
+export declare const buildJsonSchemaExample: (schema: Record<string, unknown>) => unknown;
+//# sourceMappingURL=schema-example.d.ts.map

package/dist/shared/schema-example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-example.d.ts","sourceRoot":"","sources":["../../src/shared/schema-example.ts"],"names":[],"mappings":"AAyJA,eAAO,MAAM,sBAAsB,GAAI,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAExE,CAAC"}

package/dist/shared/schema-example.js

@@ -0,0 +1,128 @@
+const MAX_EXAMPLE_DEPTH = 6;
+const isRecord = (value) => {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+};
+const asStringArray = (value) => {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.filter((item) => typeof item === "string");
+};
+const firstKnown = (value) => {
+    if (Array.isArray(value) && value.length > 0) {
+        return value[0];
+    }
+    return undefined;
+};
+const deriveType = (schema) => {
+    const typeValue = schema["type"];
+    if (typeof typeValue === "string") {
+        return typeValue;
+    }
+    if (Array.isArray(typeValue)) {
+        const firstType = typeValue.find((entry) => typeof entry === "string");
+        return firstType;
+    }
+    if (isRecord(schema["properties"])) {
+        return "object";
+    }
+    if (schema["items"] !== undefined) {
+        return "array";
+    }
+    return undefined;
+};
+const baseScalarExample = (typeName, schema) => {
+    switch (typeName) {
+        case "string": {
+            const format = schema["format"];
+            if (format === "email") {
+                return "agent@example.com";
+            }
+            if (format === "uri" || format === "url") {
+                return "https://example.com";
+            }
+            if (format === "date-time") {
+                return "2026-01-01T00:00:00Z";
+            }
+            if (format === "uuid") {
+                return "00000000-0000-0000-0000-000000000000";
+            }
+            return "string";
+        }
+        case "integer": {
+            return 0;
+        }
+        case "number": {
+            return 0;
+        }
+        case "boolean": {
+            return false;
+        }
+        case "null": {
+            return null;
+        }
+        default: {
+            return {};
+        }
+    }
+};
+const buildExample = (value, depth) => {
+    if (!isRecord(value)) {
+        return {};
+    }
+    if (depth > MAX_EXAMPLE_DEPTH) {
+        return {};
+    }
+    if (value["default"] !== undefined) {
+        return value["default"];
+    }
+    if (value["const"] !== undefined) {
+        return value["const"];
+    }
+    const enumValue = firstKnown(value["enum"]);
+    if (enumValue !== undefined) {
+        return enumValue;
+    }
+    const examplesValue = firstKnown(value["examples"]);
+    if (examplesValue !== undefined) {
+        return examplesValue;
+    }
+    const oneOfCandidate = firstKnown(value["oneOf"]);
+    if (oneOfCandidate !== undefined) {
+        return buildExample(oneOfCandidate, depth + 1);
+    }
+    const anyOfCandidate = firstKnown(value["anyOf"]);
+    if (anyOfCandidate !== undefined) {
+        return buildExample(anyOfCandidate, depth + 1);
+    }
+    const allOfCandidate = firstKnown(value["allOf"]);
+    if (allOfCandidate !== undefined) {
+        return buildExample(allOfCandidate, depth + 1);
+    }
+    const typeName = deriveType(value);
+    if (typeName === "object") {
+        const result = {};
+        const properties = isRecord(value["properties"]) ? value["properties"] : {};
+        const required = asStringArray(value["required"]);
+        for (const propertyName of required) {
+            const propertySchema = properties[propertyName];
+            if (propertySchema !== undefined) {
+                result[propertyName] = buildExample(propertySchema, depth + 1);
+            }
+        }
+        if (required.length === 0 && isRecord(value["additionalProperties"])) {
+            result["example"] = buildExample(value["additionalProperties"], depth + 1);
+        }
+        return result;
+    }
+    if (typeName === "array") {
+        return [buildExample(value["items"], depth + 1)];
+    }
+    if (typeName === undefined) {
+        return {};
+    }
+    return baseScalarExample(typeName, value);
+};
+export const buildJsonSchemaExample = (schema) => {
+    return buildExample(schema, 0);
+};

package/dist/shared/schemas.d.ts

@@ -1,57 +1,15 @@
 import { accountMeSchema, browserAgentCallbackSchema, cliExchangeErrorSchema, cliExchangeRequestSchema, cliExchangeSuccessSchema, deviceCodeStartSchema, deviceTokenApprovedSchema, oauthClientRegistrationSchema, oauthTokenSchema, orgServerSchema, organizationSchema } from "@ogment-ai/cli-contract/v1";
 import { z } from "zod";
 export { accountMeSchema, browserAgentCallbackSchema, cliExchangeErrorSchema, cliExchangeRequestSchema, cliExchangeSuccessSchema, deviceCodeStartSchema, deviceTokenApprovedSchema, oauthClientRegistrationSchema, oauthTokenSchema, orgServerSchema, organizationSchema, };
-export type OrgServerSchemaData = z.infer<typeof orgServerSchema>;
-export type OrganizationSchemaData = z.infer<typeof organizationSchema>;
-export type AccountMeData = z.infer<typeof accountMeSchema>["data"];
-export type AccountMeResponse = z.infer<typeof accountMeSchema>;
-export type DeviceCodeStartData = z.infer<typeof deviceCodeStartSchema>["data"];
-export type DeviceCodeStartResponse = z.infer<typeof deviceCodeStartSchema>;
-export type DeviceTokenApprovedData = z.infer<typeof deviceTokenApprovedSchema>["data"];
-export type DeviceTokenApprovedResponse = z.infer<typeof deviceTokenApprovedSchema>;
-export type OauthClientRegistrationResponse = z.infer<typeof oauthClientRegistrationSchema>;
-export type OauthTokenResponse = z.infer<typeof oauthTokenSchema>;
 export declare const credentialsFileSchema: z.ZodObject<{
     accessToken: z.ZodOptional<z.ZodString>;
     agentName: z.ZodOptional<z.ZodString>;
     apiKey: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type CredentialsFile = z.infer<typeof credentialsFileSchema>;
 export declare const toolDefinitionSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     name: z.ZodString;
     outputSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
-export type ToolDefinitionData = z.infer<typeof toolDefinitionSchema>;
-export declare const describeToolSchema: z.ZodObject<{
-    description: z.ZodString;
-    name: z.ZodString;
-    outputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-}, z.core.$strip>;
-export type DescribeTool = z.infer<typeof describeToolSchema>;
-export declare const describePayloadSchema: z.ZodObject<{
-    tools: z.ZodArray<z.ZodObject<{
-        description: z.ZodString;
-        name: z.ZodString;
-        outputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-export type DescribePayload = z.infer<typeof describePayloadSchema>;
-export declare const cliJsonSuccessSchema: z.ZodObject<{
-    data: z.ZodUnknown;
-    status: z.ZodLiteral<"success">;
-}, z.core.$strip>;
-export type CliJsonSuccess = z.infer<typeof cliJsonSuccessSchema>;
-export declare const cliJsonErrorSchema: z.ZodObject<{
-    error: z.ZodObject<{
-        details: z.ZodOptional<z.ZodString>;
-        message: z.ZodString;
-        type: z.ZodString;
-    }, z.core.$strip>;
-    status: z.ZodLiteral<"error">;
-}, z.core.$strip>;
-export type CliJsonError = z.infer<typeof cliJsonErrorSchema>;
 //# sourceMappingURL=schemas.d.ts.map

package/dist/shared/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/shared/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAClE,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACxE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AACpE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAChE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAChF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC5E,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AACxF,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACpF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAC5F,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAIlE,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEtE,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,qBAAqB;;;;;;;iBAEhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,kBAAkB;;;;;;;iBAO7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/shared/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,6BAA6B,EAC7B,gBAAgB,EAChB,eAAe,EACf,kBAAkB,GACnB,CAAC;AAIF,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAC"}