thoth-plugin 1.1.0

package/dist/specialization/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Specialization Types
+ *
+ * Defines the types for Thoth's depth-based specialization system.
+ */
+/**
+ * The four hemispheres of Thoth's knowledge base
+ */
+export type Domain = "work" | "life" | "coding" | "kernel";
+/**
+ * Depth levels for specialization
+ * 0 = Root (Pure Thoth)
+ * 1 = Hemisphere (e.g., /work/)
+ * 2 = Category (e.g., /work/projects/)
+ * 3 = Entity/Capsule (e.g., /work/projects/project-x/)
+ */
+export type DepthLevel = 0 | 1 | 2 | 3;
+/**
+ * The result of specialization detection
+ */
+export interface Specialization {
+    /** The calculated depth level (0-3) */
+    depth: DepthLevel;
+    /** The primary domain/hemisphere */
+    domain: Domain | null;
+    /** The category within the domain (depth 2+) */
+    category: string | null;
+    /** The specific entity (depth 3) */
+    entity: string | null;
+    /** The full relative path from knowledge base root */
+    relativePath: string;
+    /** Boot sequence files to load */
+    bootSequence: string[];
+    /** Whether depth was overridden (via AGENTS.md or CONTEXT.md) */
+    depthOverridden: boolean;
+    /** Source of depth override if any */
+    depthSource: "folder" | "agents-md" | "context-md";
+}
+/**
+ * AGENTS.md frontmatter structure
+ */
+export interface AgentsMdFrontmatter {
+    /** Explicit depth override */
+    depth?: number;
+    /** Hemisphere this AGENTS.md belongs to */
+    hemisphere?: Domain;
+    /** Boot sequence files */
+    boot_sequence?: string[];
+    /** Additional tags */
+    tags?: string[];
+}
+/**
+ * Parsed AGENTS.md file
+ */
+export interface ParsedAgentsMd {
+    /** Parsed frontmatter */
+    frontmatter: AgentsMdFrontmatter | null;
+    /** Content after frontmatter */
+    content: string;
+    /** Full file path */
+    path: string;
+}
+/**
+ * Session specialization state
+ */
+export interface SessionSpecializationState {
+    /** Session ID */
+    sessionID: string;
+    /** Detected specialization */
+    specialization: Specialization;
+    /** Whether boot has been executed */
+    bootExecuted: boolean;
+    /** Timestamp of detection */
+    detectedAt: number;
+}
+/**
+ * Boot instruction to inject on first message
+ */
+export interface BootInstruction {
+    /** The instruction text to inject */
+    instruction: string;
+    /** Files that should be read */
+    files: string[];
+    /** Mode description for confirmation output */
+    modeDescription: string;
+}

package/dist/thoth-plugin.schema.json

@@ -0,0 +1,7 @@
+{
+  "$ref": "#/definitions/ThothPluginConfig",
+  "definitions": {
+    "ThothPluginConfig": {}
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}

package/dist/tools/background-task/constants.d.ts

@@ -0,0 +1,3 @@
+export declare const BACKGROUND_TASK_DESCRIPTION = "Run agent task in background. Returns task_id immediately; notifies on completion.\n\nUse `background_output` to get results. Prompts MUST be in English.";
+export declare const BACKGROUND_OUTPUT_DESCRIPTION = "Get output from background task. System notifies on completion, so block=true rarely needed.";
+export declare const BACKGROUND_CANCEL_DESCRIPTION = "Cancel running background task(s). Use all=true to cancel ALL before final answer.";

package/dist/tools/background-task/index.d.ts

@@ -0,0 +1,2 @@
+export { createBackgroundTask, createBackgroundOutput, createBackgroundCancel } from "./tools";
+export type { BackgroundTaskArgs, BackgroundOutputArgs, BackgroundCancelArgs } from "./types";

package/dist/tools/background-task/tools.d.ts

@@ -0,0 +1,7 @@
+import { tool, type PluginInput } from "@opencode-ai/plugin";
+import type { BackgroundManager } from "../../shared-hooks/background-agent";
+type OpencodeClient = PluginInput["client"];
+export declare function createBackgroundTask(manager: BackgroundManager): ReturnType<typeof tool>;
+export declare function createBackgroundOutput(manager: BackgroundManager, client: OpencodeClient): ReturnType<typeof tool>;
+export declare function createBackgroundCancel(manager: BackgroundManager, client: OpencodeClient): ReturnType<typeof tool>;
+export {};

package/dist/tools/background-task/types.d.ts

@@ -0,0 +1,14 @@
+export interface BackgroundTaskArgs {
+    description: string;
+    prompt: string;
+    agent: string;
+}
+export interface BackgroundOutputArgs {
+    task_id: string;
+    block?: boolean;
+    timeout?: number;
+}
+export interface BackgroundCancelArgs {
+    taskId?: string;
+    all?: boolean;
+}

package/dist/tools/index.d.ts

@@ -0,0 +1,2 @@
+export { createBackgroundTask, createBackgroundOutput, createBackgroundCancel } from "./background-task";
+export { createSkillTool } from "./skill";

package/dist/tools/skill/index.d.ts

@@ -0,0 +1,2 @@
+export { createSkillTool } from "./tools";
+export type { SkillScope, SkillMetadata, SkillInfo, LoadedSkill, SkillFrontmatter } from "./types";

package/dist/tools/skill/tools.d.ts

@@ -0,0 +1,2 @@
+import { tool } from "@opencode-ai/plugin";
+export declare function createSkillTool(): ReturnType<typeof tool>;

package/dist/tools/skill/types.d.ts

@@ -0,0 +1,37 @@
+import { z } from "zod/v4";
+export type SkillScope = "user" | "project" | "builtin";
+export declare const SkillFrontmatterSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    license: z.ZodOptional<z.ZodString>;
+    "allowed-tools": z.ZodOptional<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type SkillFrontmatter = z.infer<typeof SkillFrontmatterSchema>;
+export interface SkillMetadata {
+    name: string;
+    description: string;
+    license?: string;
+    allowedTools?: string[];
+    metadata?: Record<string, string>;
+}
+export interface SkillInfo {
+    name: string;
+    path: string;
+    basePath: string;
+    metadata: SkillMetadata;
+    content: string;
+    references: string[];
+    scripts: string[];
+    assets: string[];
+}
+export interface LoadedSkill {
+    name: string;
+    metadata: SkillMetadata;
+    basePath: string;
+    body: string;
+    referencesLoaded: Array<{
+        path: string;
+        content: string;
+    }>;
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "thoth-plugin",
+  "version": "1.1.0",
+  "description": "Thoth - Root-level life orchestrator for OpenCode. Unified AI chief of staff combining Sisyphus execution quality, Personal-OS rhythms, and Thoth relationship model.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "thoth": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./schema.json": "./dist/thoth-plugin.schema.json"
+  },
+  "scripts": {
+    "build": "bun build src/index.ts src/cli.ts --outdir dist --target bun --format esm && cp -r defaults dist/ && (tsc --emitDeclarationOnly || true) && bun run build:schema",
+    "build:schema": "bun run script/build-schema.ts",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run clean && bun run build",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "thoth",
+    "life-orchestrator",
+    "chief-of-staff",
+    "ai",
+    "llm",
+    "personal-os"
+  ],
+  "author": "David Helmus",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/davidhelmus/thoth-core.git"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.0.162",
+    "zod": "^4.1.8"
+  },
+  "devDependencies": {
+    "bun-types": "latest",
+    "typescript": "^5.7.3",
+    "zod-to-json-schema": "^3.25.1"
+  }
+}