@kevin5251984/guild 0.2.12

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Guild contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bin/guildd.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+
+const require = createRequire(import.meta.url);
+const loader = require.resolve("tsx");
+const cli = fileURLToPath(new URL("../src/cli.ts", import.meta.url));
+const child = spawn(
+  process.execPath,
+  ["--import", loader, cli, ...process.argv.slice(2)],
+  { stdio: "inherit" },
+);
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 1);
+});

package/cordis.yml

@@ -0,0 +1,24 @@
+- id: logger
+  name: '@cordisjs/plugin-logger-console'
+- id: timer
+  name: '@cordisjs/plugin-timer'
+- id: store
+  name: './src/plugins/store.ts'
+- id: harness
+  name: './src/plugins/harness.ts'
+- id: oauth
+  name: './src/plugins/oauth.ts'
+- id: llm
+  name: './src/plugins/llm.ts'
+- id: tools
+  name: './src/plugins/tools.ts'
+- id: mcp
+  name: './src/plugins/mcp.ts'
+- id: memory
+  name: './src/plugins/memory.ts'
+- id: chat
+  name: './src/plugins/chat.ts'
+- id: server
+  name: './src/plugins/server.ts'
+- id: api
+  name: './src/plugins/api.ts'

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@kevin5251984/guild",
+  "version": "0.2.12",
+  "type": "module",
+  "license": "MIT",
+  "description": "A local guild of adventurers. npx @kevin5251984/guild web",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "bin": {
+    "guild": "./bin/guildd.mjs",
+    "guildd": "./bin/guildd.mjs"
+  },
+  "files": [
+    "bin",
+    "src",
+    "cordis.yml",
+    "vendor"
+  ],
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Jakevin/guild.git",
+    "directory": "packages/daemon"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cordisjs/plugin-include": "1.0.4",
+    "@cordisjs/plugin-loader": "1.0.0-rc.5",
+    "@cordisjs/plugin-logger-console": "1.0.0",
+    "@cordisjs/plugin-timer": "1.1.2",
+    "@earendil-works/pi-ai": "^0.84.2",
+    "@guild/protocol": "file:./vendor/protocol",
+    "cordis": "4.0.0-rc.8",
+    "schemastery": "^3.18.0",
+    "tsx": "4.20.5"
+  },
+  "devDependencies": {
+    "@types/node": "22.19.19",
+    "typescript": "5.9.3"
+  },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "start": "node ./bin/guildd.mjs",
+    "build": "tsc -p tsconfig.json",
+    "test": "tsx --test test/*.test.ts"
+  }
+}

package/src/agent-file.ts

@@ -0,0 +1,125 @@
+import { parseSkillMarkdown } from "./skill-import.ts";
+
+export type ParsedAgent = {
+  name: string;
+  description: string;
+  instructions: string;
+  model?: string;
+  reasoning?: string;
+  sandboxMode?: string;
+  permissionMode?: string;
+  readOnly: boolean;
+};
+
+const READ_ONLY_NAMES = new Set([
+  "explorer",
+  "explore",
+  "plan",
+  "librarian",
+  "reviewer",
+  "researcher",
+]);
+
+export function parseAgentFile(text: string, fallbackName = "agent"): ParsedAgent {
+  const trimmed = String(text || "")
+    .replace(/^\uFEFF/, "")
+    .trim();
+  const parsed = trimmed.startsWith("---")
+    ? parseMarkdownAgent(trimmed, fallbackName)
+    : parseTomlAgent(trimmed, fallbackName);
+  return { ...parsed, readOnly: inferReadOnly(parsed) };
+}
+
+export function renderAgentToml(input: {
+  name: string;
+  description: string;
+  instructions: string;
+  readOnly?: boolean;
+}): string {
+  const name = input.name.trim() || "agent";
+  const description = input.description.replace(/\n/g, " ").trim();
+  const sandbox = input.readOnly ? 'sandbox_mode = "read-only"\n' : "";
+  return (
+    `name = "${escapeToml(name)}"\n` +
+    `description = "${escapeToml(description)}"\n` +
+    sandbox +
+    `developer_instructions = """\n${input.instructions.trim()}\n"""\n`
+  );
+}
+
+function parseMarkdownAgent(text: string, fallbackName: string): Omit<ParsedAgent, "readOnly"> {
+  const parsed = parseSkillMarkdown(text, fallbackName);
+  const fence = text.replace(/^\uFEFF/, "").match(
+    /^---\r?\n([\s\S]*?)\r?\n---/,
+  );
+  const front = fence ? fence[1] : "";
+  return {
+    name: parsed.name || fallbackName,
+    description: parsed.description || "",
+    instructions: parsed.body.trim(),
+    permissionMode: yamlBare(front, "permission_mode") || undefined,
+    model: yamlBare(front, "model") || undefined,
+    reasoning: yamlBare(front, "reasoning_effort") || undefined,
+  };
+}
+
+function parseTomlAgent(text: string, fallbackName: string): Omit<ParsedAgent, "readOnly"> {
+  const instructions =
+    tomlString(text, "developer_instructions") ||
+    tomlString(text, "instructions");
+  return {
+    name: tomlString(text, "name") || fallbackName,
+    description: tomlString(text, "description"),
+    instructions: instructions.trim(),
+    model: tomlString(text, "model") || undefined,
+    reasoning:
+      tomlString(text, "model_reasoning_effort") ||
+      tomlString(text, "reasoning_effort") ||
+      undefined,
+    sandboxMode: tomlString(text, "sandbox_mode") || undefined,
+    permissionMode: tomlString(text, "permission_mode") || undefined,
+  };
+}
+
+export function inferReadOnly(parsed: Omit<ParsedAgent, "readOnly">): boolean {
+  const sandbox = (parsed.sandboxMode || "").toLowerCase();
+  if (/\bread[-_ ]?only\b/.test(sandbox)) return true;
+  if ((parsed.permissionMode || "").toLowerCase() === "plan") return true;
+  const name = (parsed.name || "").toLowerCase();
+  return READ_ONLY_NAMES.has(name);
+}
+
+function yamlBare(front: string, key: string): string {
+  const line = front.match(new RegExp(`^${key}:\\s*(.+)$`, "m"));
+  if (!line) return "";
+  return line[1].trim().replace(/^["']|["']$/g, "");
+}
+
+function tomlString(source: string, key: string): string {
+  const match = source.match(new RegExp(`(?:^|\\n)${key}\\s*=\\s*`));
+  if (!match || match.index === undefined) return "";
+  const rest = source.slice(match.index + match[0].length);
+  if (rest.startsWith('"""')) {
+    const end = rest.indexOf('"""', 3);
+    if (end < 0) return rest.slice(3).trim();
+    return rest.slice(3, end).replace(/^\n/, "").replace(/\s+$/, "");
+  }
+  if (rest.startsWith('"')) {
+    const quoted = rest.match(/^"((?:\\.|[^"\\])*)"/);
+    return quoted ? unquoteToml(quoted[1]) : "";
+  }
+  if (rest.startsWith("'")) {
+    const quoted = rest.match(/^'([^']*)'/);
+    return quoted ? quoted[1] : "";
+  }
+  const bare = rest.match(/^([^\s#\n]+)/);
+  return bare ? bare[1] : "";
+}
+
+function unquoteToml(value: string): string {
+  return value.replace(/\\n/g, "\n").replace(/\\"/g, '"').replace(/\\\\/g, "\\");
+}
+
+function escapeToml(value: string): string {
+  return value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}