npm - happy2 - Versions diffs - 0.0.11 → 0.0.13 - Mend

happy2 0.0.11 → 0.0.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (443) hide show

package/packages/happy2-server/dist/web/index.html CHANGED Viewed

@@ -13,8 +13,8 @@
                 background: #131217;
             }
         </style>
-      <script type="module" crossorigin src="/assets/index-9SGCQLg7.js"></script>
-      <link rel="stylesheet" crossorigin href="/assets/index-DWXBQDJB.css">
+      <script type="module" crossorigin src="/assets/index-BnhFxR3U.js"></script>
+      <link rel="stylesheet" crossorigin href="/assets/index-BaPUPGPe.css">
     </head>
     <body>
         <div id="root"></div>

package/packages/happy2-server/drizzle/0022_plugin_container_runtime_tools.sql ADDED Viewed

@@ -0,0 +1,16 @@
+ALTER TABLE `plugin_installations` ADD `mcp_tools_synced_at` text;
+--> statement-breakpoint
+ALTER TABLE `plugin_installations` ADD `container_instance_id` text;
+--> statement-breakpoint
+CREATE TABLE `plugin_mcp_tools` (
+	`installation_id` text NOT NULL,
+	`name` text NOT NULL,
+	`title` text,
+	`description` text,
+	`input_schema_json` text NOT NULL,
+	`output_schema_json` text,
+	`annotations_json` text,
+	`synced_at` text NOT NULL,
+	PRIMARY KEY(`installation_id`, `name`),
+	FOREIGN KEY (`installation_id`) REFERENCES `plugin_installations`(`id`) ON UPDATE no action ON DELETE cascade
+);

package/packages/happy2-server/drizzle/0023_roles_and_permissions.sql ADDED Viewed

@@ -0,0 +1,82 @@
+CREATE TABLE `roles` (
+	`id` text PRIMARY KEY NOT NULL,
+	`name` text NOT NULL COLLATE NOCASE,
+	`description` text,
+	`builtin_kind` text,
+	`created_by_user_id` text,
+	`created_at` text DEFAULT CURRENT_TIMESTAMP NOT NULL,
+	`updated_at` text DEFAULT CURRENT_TIMESTAMP NOT NULL,
+	FOREIGN KEY (`created_by_user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE set null,
+	CHECK (`builtin_kind` IS NULL OR `builtin_kind` IN ('admin', 'member'))
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `roles_name_unique` ON `roles` (`name`);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `roles_builtin_kind_unique` ON `roles` (`builtin_kind`) WHERE `builtin_kind` IS NOT NULL;
+--> statement-breakpoint
+CREATE TABLE `role_permissions` (
+	`role_id` text NOT NULL,
+	`permission` text NOT NULL,
+	`created_at` text DEFAULT CURRENT_TIMESTAMP NOT NULL,
+	PRIMARY KEY(`role_id`, `permission`),
+	FOREIGN KEY (`role_id`) REFERENCES `roles`(`id`) ON UPDATE no action ON DELETE cascade,
+	CHECK (`permission` IN ('manageSecrets', 'assignSecrets', 'manageImages', 'assignImagesToChats', 'managePlugins', 'viewAllMembers', 'manageAdminRoles'))
+);
+--> statement-breakpoint
+CREATE TABLE `user_roles` (
+	`user_id` text NOT NULL,
+	`role_id` text NOT NULL,
+	`assigned_by_user_id` text,
+	`created_at` text DEFAULT CURRENT_TIMESTAMP NOT NULL,
+	PRIMARY KEY(`user_id`, `role_id`),
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE cascade,
+	FOREIGN KEY (`role_id`) REFERENCES `roles`(`id`) ON UPDATE no action ON DELETE cascade,
+	FOREIGN KEY (`assigned_by_user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE set null
+);
+--> statement-breakpoint
+CREATE INDEX `user_roles_role_id_index` ON `user_roles` (`role_id`);
+--> statement-breakpoint
+CREATE TABLE `user_permissions` (
+	`user_id` text NOT NULL,
+	`permission` text NOT NULL,
+	`granted_by_user_id` text,
+	`created_at` text DEFAULT CURRENT_TIMESTAMP NOT NULL,
+	PRIMARY KEY(`user_id`, `permission`),
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE cascade,
+	FOREIGN KEY (`granted_by_user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE set null,
+	CHECK (`permission` IN ('manageSecrets', 'assignSecrets', 'manageImages', 'assignImagesToChats', 'managePlugins', 'viewAllMembers', 'manageAdminRoles'))
+);
+--> statement-breakpoint
+INSERT INTO `roles` (`id`, `name`, `description`, `builtin_kind`)
+VALUES
+	('happy2_builtin_admins', 'Admins', 'Server administrators', 'admin'),
+	('happy2_builtin_members', 'Members', 'All server members', 'member');
+--> statement-breakpoint
+INSERT INTO `role_permissions` (`role_id`, `permission`)
+VALUES
+	('happy2_builtin_admins', 'manageSecrets'),
+	('happy2_builtin_admins', 'assignSecrets'),
+	('happy2_builtin_admins', 'manageImages'),
+	('happy2_builtin_admins', 'assignImagesToChats'),
+	('happy2_builtin_admins', 'managePlugins'),
+	('happy2_builtin_admins', 'viewAllMembers');
+--> statement-breakpoint
+INSERT INTO `user_roles` (`user_id`, `role_id`)
+SELECT `id`, 'happy2_builtin_members' FROM `users` WHERE `kind` = 'human' AND `deleted_at` IS NULL;
+--> statement-breakpoint
+INSERT INTO `user_roles` (`user_id`, `role_id`)
+SELECT `id`, 'happy2_builtin_admins' FROM `users` WHERE `kind` = 'human' AND `role` = 'admin' AND `deleted_at` IS NULL;
+--> statement-breakpoint
+CREATE TRIGGER `roles_prevent_builtin_delete`
+BEFORE DELETE ON `roles`
+WHEN OLD.`builtin_kind` IS NOT NULL
+BEGIN
+	SELECT RAISE(ABORT, 'built-in roles cannot be deleted');
+END;
+--> statement-breakpoint
+CREATE TRIGGER `roles_prevent_builtin_kind_change`
+BEFORE UPDATE OF `builtin_kind` ON `roles`
+WHEN OLD.`builtin_kind` IS NOT NEW.`builtin_kind`
+BEGIN
+	SELECT RAISE(ABORT, 'built-in role markers cannot be changed');
+END;

package/packages/happy2-server/drizzle/0024_session_bound_dev_tokens.sql ADDED Viewed

@@ -0,0 +1,11 @@
+CREATE TABLE `auth_dev_tokens` (
+	`id` text PRIMARY KEY NOT NULL,
+	`session_id` text NOT NULL,
+	`token_hash` text NOT NULL,
+	`created_at` text DEFAULT CURRENT_TIMESTAMP NOT NULL,
+	FOREIGN KEY (`session_id`) REFERENCES `auth_sessions`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `auth_dev_tokens_token_hash_unique` ON `auth_dev_tokens` (`token_hash`);
+--> statement-breakpoint
+CREATE INDEX `auth_dev_tokens_session_id_index` ON `auth_dev_tokens` (`session_id`);

package/packages/happy2-server/drizzle/0025_plugin_skills.sql ADDED Viewed

@@ -0,0 +1,8 @@
+CREATE TABLE `plugin_skills` (
+	`plugin_id` text NOT NULL,
+	`name` text NOT NULL,
+	`description` text NOT NULL,
+	`directory` text NOT NULL,
+	PRIMARY KEY(`plugin_id`, `name`),
+	FOREIGN KEY (`plugin_id`) REFERENCES `plugins`(`id`) ON UPDATE no action ON DELETE cascade
+);

package/packages/happy2-server/drizzle/0026_agent_turn_traces.sql ADDED Viewed

@@ -0,0 +1,35 @@
+ALTER TABLE `agent_turns` ADD `trace_latest_kind` text;
+--> statement-breakpoint
+ALTER TABLE `agent_turns` ADD `trace_latest_title` text;
+--> statement-breakpoint
+ALTER TABLE `agent_turns` ADD `trace_latest_detail` text;
+--> statement-breakpoint
+ALTER TABLE `agent_turns` ADD `trace_latest_at` integer;
+--> statement-breakpoint
+ALTER TABLE `agent_turns` ADD `trace_entry_count` integer DEFAULT 0 NOT NULL;
+--> statement-breakpoint
+ALTER TABLE `agent_turns` ADD `trace_subagents_json` text DEFAULT '[]' NOT NULL;
+--> statement-breakpoint
+ALTER TABLE `agent_turns` ADD `trace_background_terminals_json` text DEFAULT '[]' NOT NULL;
+--> statement-breakpoint
+CREATE TABLE `agent_turn_trace_entries` (
+	`id` text PRIMARY KEY NOT NULL,
+	`user_message_id` text NOT NULL,
+	`agent_user_id` text NOT NULL,
+	`trace_key` text NOT NULL,
+	`session_event_id` text NOT NULL,
+	`kind` text NOT NULL,
+	`title` text NOT NULL,
+	`detail` text,
+	`status` text NOT NULL,
+	`occurred_at` integer NOT NULL,
+	`completed_at` integer,
+	`created_at` text DEFAULT CURRENT_TIMESTAMP NOT NULL,
+	`updated_at` text DEFAULT CURRENT_TIMESTAMP NOT NULL,
+	FOREIGN KEY (`user_message_id`) REFERENCES `messages`(`id`) ON UPDATE no action ON DELETE cascade,
+	FOREIGN KEY (`agent_user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE cascade
+);
+--> statement-breakpoint
+CREATE UNIQUE INDEX `agent_turn_trace_entries_turn_key_unique` ON `agent_turn_trace_entries` (`user_message_id`,`agent_user_id`,`trace_key`);
+--> statement-breakpoint
+CREATE INDEX `agent_turn_trace_entries_turn_time_index` ON `agent_turn_trace_entries` (`user_message_id`,`agent_user_id`,`occurred_at`);

package/packages/happy2-server/drizzle/0027_chat_agent_effort.sql ADDED Viewed

@@ -0,0 +1,9 @@
+ALTER TABLE `agent_rig_bindings` ADD COLUMN `effort` TEXT;
+--> statement-breakpoint
+UPDATE `agent_rig_bindings`
+SET `effort` = (
+    SELECT `users`.`agent_effort`
+    FROM `users`
+    WHERE `users`.`id` = `agent_rig_bindings`.`user_id`
+)
+WHERE `effort` IS NULL;

package/packages/happy2-server/drizzle/meta/_journal.json CHANGED Viewed

@@ -155,6 +155,48 @@
             "when": 1784418000000,
             "tag": "0021_plugin_function_results",
             "breakpoints": true
+        },
+        {
+            "idx": 22,
+            "version": "6",
+            "when": 1784420000000,
+            "tag": "0022_plugin_container_runtime_tools",
+            "breakpoints": true
+        },
+        {
+            "idx": 23,
+            "version": "6",
+            "when": 1784421000000,
+            "tag": "0023_roles_and_permissions",
+            "breakpoints": true
+        },
+        {
+            "idx": 24,
+            "version": "6",
+            "when": 1784422000000,
+            "tag": "0024_session_bound_dev_tokens",
+            "breakpoints": true
+        },
+        {
+            "idx": 25,
+            "version": "6",
+            "when": 1784425000000,
+            "tag": "0025_plugin_skills",
+            "breakpoints": true
+        },
+        {
+            "idx": 26,
+            "version": "6",
+            "when": 1784426000000,
+            "tag": "0026_agent_turn_traces",
+            "breakpoints": true
+        },
+        {
+            "idx": 27,
+            "version": "6",
+            "when": 1784427000000,
+            "tag": "0027_chat_agent_effort",
+            "breakpoints": true
         }
     ]
 }

package/packages/happy2-server/happy2.example.toml CHANGED Viewed

@@ -9,6 +9,14 @@ public_url = "http://127.0.0.1:3000"
 # A wrong nonzero value lets clients spoof rate-limit and access telemetry IPs.
 trusted_proxy_hops = 0
+[plugins]
+# Dedicated capability-only listener reached by plugin containers through the
+# happy2.host.internal container-host mapping.
+# The cross-platform host-gateway path requires a non-loopback bind. Firewall
+# this fixed port from untrusted LANs; it is not a public product API.
+host_api_host = "0.0.0.0"
+host_api_port = 3001
 [database]
 # A local file works for one host. Use a shared libSQL endpoint when auth and
 # API are independently deployed, so every instance sees the same sessions.
@@ -82,6 +90,12 @@ expiry_days = 30
 [auth.password]
 enabled = true
+# Allows an authenticated Settings session to create an opaque bearer token for
+# local web development. Every token inherits its backing session's expiry and
+# revocation; leave disabled on servers that do not need remote UI development.
+[auth.dev_tokens]
+enabled = false
 [auth.magic_link]
 enabled = false
 from = "Happy (2) <noreply@happy2.example.com>"

package/packages/happy2-server/plugins/README.md CHANGED Viewed

@@ -4,4 +4,6 @@ Each child directory is one immutable, built-in plugin package. See
 [`../PLUGINS.md`](../PLUGINS.md) for the manifest and package contract.
 `hello` is the minimal built-in example with both a skill and a bundled stdio MCP
-tool. Product plugins should be added here as separate, reviewable changes.
+tool. `chat-management` demonstrates a chat-scoped Plugin API capability without
+accepting a chat identifier from tool arguments. Product plugins should be added
+here as separate, reviewable changes.

package/packages/happy2-server/plugins/chat-management/container/Dockerfile ADDED Viewed

@@ -0,0 +1,6 @@
+FROM node:22-alpine
+WORKDIR /plugin
+COPY server.mjs /plugin/server.mjs
+CMD ["sleep", "infinity"]

package/packages/happy2-server/plugins/chat-management/plugin.json ADDED Viewed

@@ -0,0 +1,17 @@
+{
+    "schemaVersion": 1,
+    "version": "1.0.0",
+    "displayName": "Chat Management",
+    "shortName": "chat-management",
+    "description": "Lets an agent update the title and description of its current chat.",
+    "variables": [],
+    "container": {
+        "dockerfile": "container/Dockerfile",
+        "permissions": ["chats:update"]
+    },
+    "mcp": {
+        "type": "stdio",
+        "command": "node",
+        "args": ["/plugin/server.mjs"]
+    }
+}

package/packages/happy2-server/plugins/chat-management/plugin.png ADDED Viewed

Binary file

package/packages/happy2-server/plugins/chat-management/server.mjs ADDED Viewed

@@ -0,0 +1,113 @@
+import { createInterface } from "node:readline";
+const CHAT_META_KEY = "happy2/chat";
+const lines = createInterface({ input: process.stdin, crlfDelay: Infinity });
+for await (const line of lines) {
+    if (!line.trim()) continue;
+    let request;
+    try {
+        request = JSON.parse(line);
+    } catch {
+        continue;
+    }
+    if (request.id === undefined) continue;
+    const response = await handle(request).catch((error) => ({
+        result: {
+            isError: true,
+            content: [
+                {
+                    type: "text",
+                    text: error instanceof Error ? error.message : "The chat could not be updated.",
+                },
+            ],
+        },
+    }));
+    process.stdout.write(`${JSON.stringify({ jsonrpc: "2.0", id: request.id, ...response })}\n`);
+}
+async function handle(request) {
+    if (request.method === "initialize") {
+        return {
+            result: {
+                protocolVersion: request.params?.protocolVersion ?? "2025-06-18",
+                capabilities: { tools: {} },
+                serverInfo: { name: "happy2-chat-management", version: "1.0.0" },
+            },
+        };
+    }
+    if (request.method === "ping") return { result: {} };
+    if (request.method === "tools/list") {
+        return {
+            result: {
+                tools: [
+                    {
+                        name: "chat_update",
+                        title: "Update current chat",
+                        description:
+                            "Changes the title or description of the current chat. Omit a field to leave it unchanged; pass null or an empty string to clear the description.",
+                        inputSchema: {
+                            type: "object",
+                            properties: {
+                                title: {
+                                    type: "string",
+                                    minLength: 1,
+                                    maxLength: 100,
+                                    description: "The new title for the current chat.",
+                                },
+                                description: {
+                                    type: ["string", "null"],
+                                    maxLength: 500,
+                                    description:
+                                        "The new description, or null to clear the current description.",
+                                },
+                            },
+                            anyOf: [{ required: ["title"] }, { required: ["description"] }],
+                            additionalProperties: false,
+                        },
+                    },
+                ],
+            },
+        };
+    }
+    if (request.method === "tools/call" && request.params?.name === "chat_update")
+        return { result: await updateChat(request.params) };
+    return {
+        error: { code: -32601, message: `Method not found: ${String(request.method)}` },
+    };
+}
+async function updateChat(params) {
+    const chat = params?._meta?.[CHAT_META_KEY];
+    if (!chat || typeof chat.id !== "string" || typeof chat.token !== "string")
+        throw new Error("This tool must be called from an active Happy chat.");
+    const apiUrl = process.env.HAPPY2_PLUGIN_API_URL;
+    const runtimeToken = process.env.HAPPY2_PLUGIN_API_TOKEN;
+    if (!apiUrl || !runtimeToken) throw new Error("The Happy Plugin API is unavailable.");
+    const input = params.arguments;
+    if (!input || typeof input !== "object" || Array.isArray(input))
+        throw new Error("A chat update is required.");
+    const response = await fetch(`${apiUrl}/chats/updateChat`, {
+        method: "POST",
+        headers: {
+            authorization: `Bearer ${runtimeToken}`,
+            "content-type": "application/json",
+            "x-happy2-chat-token": chat.token,
+        },
+        body: JSON.stringify(input),
+    });
+    const result = await response.json().catch(() => undefined);
+    if (!response.ok)
+        throw new Error(
+            typeof result?.message === "string" ? result.message : "The chat could not be updated.",
+        );
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Updated chat ${result.chat.id}.`,
+            },
+        ],
+        structuredContent: { chat: result.chat },
+    };
+}