npm - happy2 - Versions diffs - 0.0.14 → 0.0.15 - Mend

happy2 0.0.14 → 0.0.15

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 (123) hide show

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

@@ -13,7 +13,7 @@
                 background: #131217;
             }
         </style>
-      <script type="module" crossorigin src="/assets/index-Dn5SZu3y.js"></script>
+      <script type="module" crossorigin src="/assets/index-BT_VezYx.js"></script>
       <link rel="stylesheet" crossorigin href="/assets/index-Dys3sWv8.css">
     </head>
     <body>

package/packages/happy2-server/drizzle/0030_personal_synced_drafts.sql ADDED Viewed

@@ -0,0 +1,11 @@
+CREATE TABLE `drafts` (
+	`user_id` text NOT NULL,
+	`chat_id` text NOT NULL,
+	`text` text DEFAULT '' NOT NULL,
+	`sync_sequence` integer DEFAULT 0 NOT NULL,
+	`created_at` text DEFAULT CURRENT_TIMESTAMP NOT NULL,
+	`updated_at` text DEFAULT CURRENT_TIMESTAMP NOT NULL,
+	PRIMARY KEY(`user_id`, `chat_id`),
+	FOREIGN KEY (`user_id`) REFERENCES `users`(`id`) ON UPDATE no action ON DELETE cascade,
+	FOREIGN KEY (`chat_id`) REFERENCES `chats`(`id`) ON UPDATE no action ON DELETE cascade
+);

package/packages/happy2-server/drizzle/0031_agent_image_deactivation.sql ADDED Viewed

	@@ -0,0 +1 @@
1	+ ALTER TABLE `agent_images` ADD `deleted_at` text;

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

@@ -211,6 +211,20 @@
             "when": 1784433600000,
             "tag": "0029_plugin_management_requests",
             "breakpoints": true
+        },
+        {
+            "idx": 30,
+            "version": "6",
+            "when": 1784437200000,
+            "tag": "0030_personal_synced_drafts",
+            "breakpoints": true
+        },
+        {
+            "idx": 31,
+            "version": "6",
+            "when": 1784444400000,
+            "tag": "0031_agent_image_deactivation",
+            "breakpoints": true
         }
     ]
 }

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

@@ -7,7 +7,9 @@ Each child directory is one immutable, built-in plugin package. See
 tool. `chat-management` demonstrates installation-bound chat and referenced-user
 capabilities: it updates the current chat, manages channel membership, and creates
 private channels with either an informational opening message or an agent-triggering
-prompt. `plugin-developer` provides Happy2 plugin authoring/install documentation
+prompt. `environment-management` lets agents inspect, build, select, and safely
+deactivate Dockerfile-backed agent environments while retaining their manifests.
+`plugin-developer` provides Happy2 plugin authoring/install documentation
 and chat-scoped MCP tools that request administrator approval for linked install
 or uninstall actions. Product plugins should be added here as separate,
 reviewable changes.

package/packages/happy2-server/plugins/environment-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/environment-management/plugin.json ADDED Viewed

@@ -0,0 +1,17 @@
+{
+    "schemaVersion": 1,
+    "version": "1.0.0",
+    "displayName": "Environment Management",
+    "shortName": "environment-management",
+    "description": "Lets an agent inspect, create, select, and safely deactivate Happy agent environments.",
+    "variables": [],
+    "container": {
+        "dockerfile": "container/Dockerfile",
+        "permissions": ["environments:read", "environments:manage", "environments:deactivate"]
+    },
+    "mcp": {
+        "type": "stdio",
+        "command": "node",
+        "args": ["/plugin/server.mjs"]
+    }
+}

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

Binary file

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

@@ -0,0 +1,234 @@
+import { createInterface } from "node:readline";
+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 environment operation failed.",
+                },
+            ],
+        },
+    }));
+    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-environment-management", version: "1.0.0" },
+            },
+        };
+    }
+    if (request.method === "ping") return { result: {} };
+    if (request.method === "tools/list") return { result: { tools: toolDefinitions() } };
+    if (request.method !== "tools/call")
+        return {
+            error: { code: -32601, message: `Method not found: ${String(request.method)}` },
+        };
+    const input = request.params?.arguments ?? {};
+    switch (request.params?.name) {
+        case "happy2_environments_list":
+            return { result: await listEnvironments() };
+        case "happy2_environment_get_dockerfile":
+            return { result: await getDockerfile(input) };
+        case "happy2_environment_create":
+            return { result: await createEnvironment(input) };
+        case "happy2_environment_set_default":
+            return { result: await setDefaultEnvironment(input) };
+        case "happy2_environment_deactivate":
+            return { result: await deactivateEnvironment(input) };
+        default:
+            return {
+                error: {
+                    code: -32601,
+                    message: `Tool not found: ${String(request.params?.name)}`,
+                },
+            };
+    }
+}
+function toolDefinitions() {
+    const environmentId = {
+        type: "string",
+        minLength: 1,
+        maxLength: 128,
+        description: "The environment ID returned by happy2_environments_list or creation.",
+    };
+    return [
+        {
+            name: "happy2_environments_list",
+            title: "List agent environments",
+            description:
+                "Lists active and inactive Happy agent environments, their build status, and the current default environment.",
+            inputSchema: {
+                type: "object",
+                properties: {},
+                additionalProperties: false,
+            },
+        },
+        {
+            name: "happy2_environment_get_dockerfile",
+            title: "Read an environment Dockerfile",
+            description:
+                "Returns the retained immutable Dockerfile and active state for one Happy agent environment.",
+            inputSchema: {
+                type: "object",
+                properties: { environmentId },
+                required: ["environmentId"],
+                additionalProperties: false,
+            },
+        },
+        {
+            name: "happy2_environment_create",
+            title: "Create or reactivate an agent environment",
+            description:
+                "Creates an immutable Happy agent environment and queues its Docker image build. The exact definition of an inactive environment is reactivated under the same ID and rebuilt. Creation returns before the build is ready.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    name: {
+                        type: "string",
+                        minLength: 1,
+                        maxLength: 100,
+                        description: "A concise human-readable environment name.",
+                    },
+                    dockerfile: {
+                        type: "string",
+                        minLength: 1,
+                        maxLength: 262144,
+                        description: "The complete Dockerfile used to build the environment.",
+                    },
+                },
+                required: ["name", "dockerfile"],
+                additionalProperties: false,
+            },
+        },
+        {
+            name: "happy2_environment_set_default",
+            title: "Set the default agent environment",
+            description:
+                "Selects a ready environment as the default for agents created in the future. Existing agents keep their assigned environment.",
+            inputSchema: {
+                type: "object",
+                properties: { environmentId },
+                required: ["environmentId"],
+                additionalProperties: false,
+            },
+        },
+        {
+            name: "happy2_environment_deactivate",
+            title: "Deactivate an unused agent environment",
+            description:
+                "Deactivates a custom environment only when it is unused. Happy permanently retains its manifest and Dockerfile so the same definition can be reactivated and rebuilt later.",
+            inputSchema: {
+                type: "object",
+                properties: { environmentId },
+                required: ["environmentId"],
+                additionalProperties: false,
+            },
+        },
+    ];
+}
+async function listEnvironments() {
+    const result = await callHost("/environments");
+    return toolResult(
+        `Found ${result.environments.length} agent environment${result.environments.length === 1 ? "" : "s"}.`,
+        result,
+    );
+}
+async function getDockerfile(input) {
+    const environmentId = requiredString(input, "environmentId");
+    const result = await callHost(`/environments/${encodeURIComponent(environmentId)}/dockerfile`);
+    return toolResult(`Read the Dockerfile for ${result.environment.name}.`, result);
+}
+async function createEnvironment(input) {
+    const name = requiredString(input, "name");
+    const dockerfile = requiredString(input, "dockerfile", false);
+    const result = await callHost("/environments/createEnvironment", {
+        method: "POST",
+        body: { name, dockerfile },
+    });
+    return toolResult(
+        `Environment ${result.environment.name} is active; its image build is ${result.environment.status}.`,
+        result,
+    );
+}
+async function setDefaultEnvironment(input) {
+    const environmentId = requiredString(input, "environmentId");
+    const result = await callHost(
+        `/environments/${encodeURIComponent(environmentId)}/setDefaultEnvironment`,
+        { method: "POST", body: {} },
+    );
+    return toolResult(`Set ${result.environment.name} as the default environment.`, result);
+}
+async function deactivateEnvironment(input) {
+    const environmentId = requiredString(input, "environmentId");
+    const result = await callHost(
+        `/environments/${encodeURIComponent(environmentId)}/deactivateEnvironment`,
+        { method: "POST", body: {} },
+    );
+    return toolResult(`Deactivated environment ${result.environmentId}.`, result);
+}
+function requiredString(input, name, trim = true) {
+    if (!input || typeof input !== "object" || Array.isArray(input))
+        throw new Error("Tool arguments must be an object.");
+    const value = input[name];
+    if (typeof value !== "string" || !value.trim())
+        throw new Error(`${name} must be a non-empty string.`);
+    return trim ? value.trim() : value;
+}
+function toolResult(text, structuredContent) {
+    return {
+        content: [{ type: "text", text }],
+        structuredContent,
+    };
+}
+async function callHost(path, options = {}) {
+    const apiUrl = process.env.HAPPY2_PLUGIN_API_URL;
+    const token = process.env.HAPPY2_PLUGIN_API_TOKEN;
+    if (!apiUrl || !token) throw new Error("Happy did not provide plugin host credentials.");
+    const response = await fetch(new URL(path, `${apiUrl}/`), {
+        method: options.method ?? "GET",
+        headers: {
+            authorization: `Bearer ${token}`,
+            ...(options.body === undefined ? {} : { "content-type": "application/json" }),
+        },
+        ...(options.body === undefined ? {} : { body: JSON.stringify(options.body) }),
+    });
+    const payload = await response.json().catch(() => undefined);
+    if (!response.ok) {
+        const message =
+            payload && typeof payload.message === "string"
+                ? payload.message
+                : `Happy environment API returned HTTP ${response.status}.`;
+        throw new Error(message);
+    }
+    return payload;
+}

package/packages/happy2-server/plugins/environment-management/skills/happy2-environment-management/SKILL.md ADDED Viewed

@@ -0,0 +1,41 @@
+---
+name: happy2-environment-management
+description: Inspect, create, select, and safely deactivate Happy agent environments. Use when a user asks to change the default Docker image or environment, inspect an environment Dockerfile, build or reactivate an agent environment, or deactivate an unused custom environment.
+---
+# Happy2 environment management
+Treat an environment as an immutable Dockerfile-backed agent image. Use the
+environment tools for the server-wide catalog; do not edit container state or
+claim that changing the default rewrites an existing agent.
+## Workflow
+1. Call `happy2_environments_list` before referring to an existing environment.
+2. Call `happy2_environment_get_dockerfile` when the current Dockerfile matters
+   or when a new environment should be derived from an existing definition.
+3. Create with a complete, reproducible Dockerfile and a concise distinct name.
+   Creation queues an asynchronous image build. Creating the exact definition
+   of an inactive environment reactivates the retained manifest and queues a
+   fresh build under the same environment ID.
+4. Poll `happy2_environments_list` until the new environment is `ready` before
+   calling `happy2_environment_set_default`. Report a `failed` status rather
+   than repeatedly creating equivalent definitions.
+5. Explain that the default applies to agents created later. Existing agents
+   retain their assigned environment.
+6. Deactivate only the exact custom environment the user requested. Happy
+   rejects deactivation while an environment is the default, assigned to an
+   agent or live runtime, selected by a plugin, queued/building, or built in.
+   Deactivation never deletes its manifest or Dockerfile; inactive definitions
+   remain readable and can be reactivated and rebuilt.
+## Safety
+- Create, set, or deactivate only when the user explicitly requests that mutation.
+- Never guess an environment ID; resolve it from the list response.
+- Inspect the Dockerfile before copying or modifying an unfamiliar environment.
+- Do not put credentials, tokens, private keys, or user data in a Dockerfile.
+- Prefer pinned, reproducible dependencies when the user supplies or approves
+  exact versions. Do not silently invent version requirements.
+- If a name matches multiple environments, ask which ID the user means before a
+  mutation.

package/packages/happy2-server/plugins/plugin-developer/skills/happy2-plugin-development/references/host-api.md CHANGED Viewed

@@ -20,6 +20,31 @@ Authorization: Bearer …
 The response includes the calling installation ID and non-secret installation identity, short name, version, and status. It does not expose variables, users, filesystem paths, package internals, or administrator APIs.
+## Agent environments
+Manifest permissions: `environments:read` for listing and Dockerfile reads;
+`environments:manage` for creation and default selection;
+`environments:deactivate` separately for safe deactivation.
+```http
+GET /environments
+GET /environments/:environmentId/dockerfile
+POST /environments/createEnvironment
+POST /environments/:environmentId/setDefaultEnvironment
+POST /environments/:environmentId/deactivateEnvironment
+Authorization: Bearer …
+```
+Creation accepts `{ "name": string, "dockerfile": string }`, creates an immutable
+definition, and queues its image build. Creating the same inactive definition
+reactivates its retained manifest and queues a fresh build under the same ID.
+Only a ready environment can become the default. Deactivation accepts an empty
+body and rejects built-ins, queued or active builds, the default, agent
+assignments and bindings, and plugin container-image selections. It never
+deletes the immutable manifest or Dockerfile. `GET /environments` supplies
+active state, IDs, and lifecycle status required to drive those operations
+without exposing build logs or provider identifiers.
 ## Request linked installation
 Manifest permission: `plugins:request-install`

package/packages/happy2-server/plugins/plugin-developer/skills/happy2-plugin-development/references/package-format.md CHANGED Viewed

@@ -124,6 +124,9 @@ Variable keys use environment-variable syntax. Each installation must provide ev
 Supported local host permissions:
+- `environments:read`: list agent environments and read one immutable Dockerfile.
+- `environments:manage`: create an agent environment and select a ready default.
+- `environments:deactivate`: deactivate an unused custom agent environment without deleting its retained manifest or Dockerfile.
 - `plugins:list`: read non-secret installed-plugin identity and health.
 - `plugins:request-install`: during a contextual agent tool call, stage a linked ZIP and create a durable approval in that exact chat.
 - `plugins:request-uninstall`: during a contextual agent tool call, create a durable approval to remove one exact installation.