@johpaz/hive-sdk 0.1.1

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@johpaz/hive-sdk",
+  "version": "0.1.1",
+  "description": "Hive SDK — Build skills, channels and integrations for Hive",
+  "main": "./src/index.ts",
+  "license": "MIT",
+  "files": [
+    "src/"
+  ],
+  "scripts": {
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@johpaz/hive-core": "workspace:*",
+    "zod": "latest"
+  },
+  "devDependencies": {
+    "typescript": "latest",
+    "@types/bun": "latest"
+  }
+}

package/src/channel.ts

@@ -0,0 +1,32 @@
+import type { IChannel, ChannelConfig, IncomingMessage, OutboundMessage } from "@hive/core";
+
+export interface CustomChannelConfig extends ChannelConfig {
+  [key: string]: unknown;
+}
+
+export abstract class CustomChannel implements IChannel {
+  abstract name: string;
+  abstract accountId: string;
+  abstract config: ChannelConfig;
+  
+  protected messageHandler?: (message: IncomingMessage) => Promise<void>;
+  protected running = false;
+
+  abstract start(): Promise<void>;
+  abstract stop(): Promise<void>;
+  abstract send(sessionId: string, message: OutboundMessage): Promise<void>;
+
+  onMessage(handler: (message: IncomingMessage) => Promise<void>): void {
+    this.messageHandler = handler;
+  }
+
+  isRunning(): boolean {
+    return this.running;
+  }
+
+  protected async handleMessage(message: IncomingMessage): Promise<void> {
+    if (this.messageHandler) {
+      await this.messageHandler(message);
+    }
+  }
+}

package/src/hook.ts

@@ -0,0 +1,27 @@
+export type HookName =
+  | "on_session_start"
+  | "on_session_end"
+  | "on_message_in"
+  | "on_message_out"
+  | "on_tool_start"
+  | "on_tool_end"
+  | "on_error"
+  | "on_compaction_start"
+  | "on_compaction_end"
+  | "on_context_overflow"
+  | "on_stuck_loop"
+  | "on_rate_limit"
+  | "on_channel_connect"
+  | "on_channel_disconnect";
+
+export type HookHandler = (context: Record<string, unknown>) => Promise<void>;
+
+export interface HookRegistration {
+  name: HookName;
+  handler: HookHandler;
+  priority?: number;
+}
+
+export function defineHook(name: HookName, handler: HookHandler): HookRegistration {
+  return { name, handler };
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from "./skill.ts";
+export * from "./channel.ts";
+export * from "./hook.ts";
+export * from "./types.ts";

package/src/skill.ts

@@ -0,0 +1,31 @@
+import type { Tool, ToolResult } from "@hive/core";
+
+export interface SkillDefinition {
+  name: string;
+  description: string;
+  parameters: Record<string, unknown>;
+  run: (params: Record<string, unknown>, ctx: SkillContext) => Promise<unknown>;
+}
+
+export interface SkillContext {
+  sessionId: string;
+  agentId: string;
+  workspacePath: string;
+  config: Record<string, unknown>;
+}
+
+export function defineSkill(definition: SkillDefinition): Tool {
+  return {
+    name: definition.name,
+    description: definition.description,
+    parameters: definition.parameters,
+    execute: async (params: Record<string, unknown>): Promise<ToolResult> => {
+      try {
+        const result = await definition.run(params, {} as SkillContext);
+        return { success: true, result };
+      } catch (error) {
+        return { success: false, error: (error as Error).message };
+      }
+    },
+  };
+}

package/src/types.ts

@@ -0,0 +1,5 @@
+export type { Tool, ToolResult } from "@hive/core";
+export type { IChannel, ChannelConfig, IncomingMessage, OutboundMessage } from "@hive/core";
+export type { Config } from "@hive/core";
+export type { AgentInstance } from "@hive/core";
+export type { SessionInfo } from "@hive/core";