jazz-ai 0.1.0

package/dist/core/types/index.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationSchema = exports.TaskSchema = void 0;
+const effect_1 = require("effect");
+exports.TaskSchema = effect_1.Schema.Struct({
+    id: effect_1.Schema.String,
+    name: effect_1.Schema.String,
+    description: effect_1.Schema.String,
+    type: effect_1.Schema.Literal("command", "script", "api", "file", "webhook", "custom", "gmail"),
+    config: effect_1.Schema.Record({ key: effect_1.Schema.String, value: effect_1.Schema.Unknown }),
+    dependencies: effect_1.Schema.optional(effect_1.Schema.Array(effect_1.Schema.String)),
+    retryCount: effect_1.Schema.optional(effect_1.Schema.Number),
+    maxRetries: effect_1.Schema.optional(effect_1.Schema.Number),
+});
+exports.AutomationSchema = effect_1.Schema.Struct({
+    id: effect_1.Schema.String,
+    name: effect_1.Schema.String,
+    description: effect_1.Schema.String,
+    agents: effect_1.Schema.Array(effect_1.Schema.String),
+    triggers: effect_1.Schema.Array(effect_1.Schema.Struct({
+        id: effect_1.Schema.String,
+        type: effect_1.Schema.Literal("schedule", "file", "webhook", "manual", "event"),
+        config: effect_1.Schema.Record({ key: effect_1.Schema.String, value: effect_1.Schema.Unknown }),
+        enabled: effect_1.Schema.Boolean,
+    })),
+    status: effect_1.Schema.Literal("active", "inactive", "paused", "error"),
+    createdAt: effect_1.Schema.Date,
+    updatedAt: effect_1.Schema.Date,
+});
+//# sourceMappingURL=index.js.map

package/dist/core/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAoOnB,QAAA,UAAU,GAAG,eAAM,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,eAAM,CAAC,MAAM;IACjB,IAAI,EAAE,eAAM,CAAC,MAAM;IACnB,WAAW,EAAE,eAAM,CAAC,MAAM;IAC1B,IAAI,EAAE,eAAM,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC;IACtF,MAAM,EAAE,eAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,eAAM,CAAC,MAAM,EAAE,KAAK,EAAE,eAAM,CAAC,OAAO,EAAE,CAAC;IACpE,YAAY,EAAE,eAAM,CAAC,QAAQ,CAAC,eAAM,CAAC,KAAK,CAAC,eAAM,CAAC,MAAM,CAAC,CAAC;IAC1D,UAAU,EAAE,eAAM,CAAC,QAAQ,CAAC,eAAM,CAAC,MAAM,CAAC;IAC1C,UAAU,EAAE,eAAM,CAAC,QAAQ,CAAC,eAAM,CAAC,MAAM,CAAC;CAC3C,CAAC,CAAC;AAEU,QAAA,gBAAgB,GAAG,eAAM,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,eAAM,CAAC,MAAM;IACjB,IAAI,EAAE,eAAM,CAAC,MAAM;IACnB,WAAW,EAAE,eAAM,CAAC,MAAM;IAC1B,MAAM,EAAE,eAAM,CAAC,KAAK,CAAC,eAAM,CAAC,MAAM,CAAC;IACnC,QAAQ,EAAE,eAAM,CAAC,KAAK,CACpB,eAAM,CAAC,MAAM,CAAC;QACZ,EAAE,EAAE,eAAM,CAAC,MAAM;QACjB,IAAI,EAAE,eAAM,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC;QACtE,MAAM,EAAE,eAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,eAAM,CAAC,MAAM,EAAE,KAAK,EAAE,eAAM,CAAC,OAAO,EAAE,CAAC;QACpE,OAAO,EAAE,eAAM,CAAC,OAAO;KACxB,CAAC,CACH;IACD,MAAM,EAAE,eAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC;IAC/D,SAAS,EAAE,eAAM,CAAC,IAAI;IACtB,SAAS,EAAE,eAAM,CAAC,IAAI;CACvB,CAAC,CAAC"}

package/dist/core/utils/error-handler.d.ts

@@ -0,0 +1,114 @@
+import { Effect } from "effect";
+import type { JazzError } from "../types/errors";
+/**
+ * Enhanced error handling utilities with actionable suggestions
+ */
+export interface ErrorDisplay {
+    readonly title: string;
+    readonly message: string;
+    readonly suggestion?: string;
+    readonly recovery?: string[];
+    readonly documentation?: string;
+    readonly relatedCommands?: string[];
+}
+/**
+ * Format error for display with actionable suggestions
+ *
+ * Takes a JazzError and formats it into a user-friendly string with:
+ * - Clear error title and message
+ * - Actionable suggestions
+ * - Step-by-step recovery instructions
+ * - Related CLI commands
+ *
+ * @param error - The error to format
+ * @returns A formatted string ready for console output
+ *
+ * @example
+ * ```typescript
+ * const error = new AgentNotFoundError({ agentId: "test-agent" });
+ * const formatted = formatError(error);
+ * console.error(formatted);
+ * // Output: "❌ Agent Not Found\n   No agent found with ID: test-agent\n..."
+ * ```
+ */
+export declare function formatError(error: JazzError): string;
+/**
+ * Enhanced error handler that provides actionable suggestions
+ *
+ * Handles both JazzError types (with structured suggestions) and generic Error objects.
+ * For JazzError types, it formats them with actionable suggestions, recovery steps, and related commands.
+ * For generic Error objects, it provides a basic error message with general guidance.
+ *
+ * @param error - The error to handle (JazzError or generic Error)
+ * @returns An Effect that logs the formatted error to the console
+ *
+ * @example
+ * ```typescript
+ * // Handle a structured error
+ * const JazzError = new AgentNotFoundError({ agentId: "test" });
+ * yield* handleError(JazzError);
+ *
+ * // Handle a generic error
+ * const genericError = new Error("Something went wrong");
+ * yield* handleError(genericError);
+ * ```
+ */
+export declare function handleError(error: JazzError | Error): Effect.Effect<void>;
+/**
+ * Common error suggestions for frequently encountered error scenarios
+ *
+ * Provides reusable suggestion templates that can be used across different error types
+ * to maintain consistency in error messaging and reduce duplication.
+ *
+ * @example
+ * ```typescript
+ * const error = new AgentNotFoundError({
+ *   agentId: "test",
+ *   suggestion: CommonSuggestions.checkAgentExists("test")
+ * });
+ * ```
+ */
+export declare const CommonSuggestions: {
+    /**
+     * Suggestion for when an agent is not found
+     * @param _agentId - The agent ID that was not found (unused but kept for consistency)
+     * @returns A suggestion string with commands to list or create agents
+     */
+    readonly checkAgentExists: (_agentId: string) => string;
+    /**
+     * Suggestion for configuration-related errors
+     * @param field - The configuration field that has an issue
+     * @returns A suggestion string with commands to check or update the configuration
+     */
+    readonly checkConfiguration: (field: string) => string;
+    /**
+     * Suggestion for file permission errors
+     * @param path - The file path that has permission issues
+     * @returns A suggestion string with commands to check and fix permissions
+     */
+    readonly checkPermissions: (path: string) => string;
+    /**
+     * Suggestion for network-related errors
+     * @returns A suggestion string for network connectivity issues
+     */
+    readonly checkNetwork: () => string;
+    /**
+     * Suggestion for authentication errors
+     * @param service - The service that requires authentication
+     * @returns A suggestion string with commands to authenticate or check status
+     */
+    readonly checkCredentials: (service: string) => string;
+    /**
+     * Suggestion for timeout errors
+     * @param currentTimeout - The current timeout value in milliseconds
+     * @returns A suggestion string recommending a higher timeout value
+     */
+    readonly increaseTimeout: (currentTimeout: number) => string;
+    /**
+     * Suggestion for task dependency errors
+     * @param taskId - The task ID that has dependency issues
+     * @returns A suggestion string with commands to check task dependencies
+     */
+    readonly checkDependencies: (taskId: string) => string;
+};
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/core/utils/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/core/utils/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CACrC;AAybD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CA6BpD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAczE;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;;;OAIG;0CAC0B,MAAM;IAGnC;;;;OAIG;yCACyB,MAAM;IAGlC;;;;OAIG;sCACsB,MAAM;IAG/B;;;OAGG;;IAIH;;;;OAIG;yCACyB,MAAM;IAGlC;;;;OAIG;+CAC+B,MAAM;IAGxC;;;;OAIG;yCACyB,MAAM;CAE1B,CAAC"}