opencode-discord-presence 0.1.0

package/dist/plugin.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Main plugin implementation for OpenCode Discord Presence
+ * @module opencode-discord-presence/plugin
+ *
+ * This is the core plugin that integrates with OpenCode to display
+ * Rich Presence in Discord, showing:
+ * - Current AI agent being used
+ * - Current model
+ * - Activity status (active/idle)
+ * - Optional: session time, token usage, project name
+ */
+import type { Plugin } from "@opencode-ai/plugin";
+/**
+ * OpenCode Discord Presence Plugin
+ *
+ * Displays your current OpenCode session status in Discord Rich Presence.
+ * Integrates with OpenCode's event system to track agent changes,
+ * model usage, and session state.
+ *
+ * @param ctx - Plugin context from OpenCode
+ * @returns Plugin hooks object
+ *
+ * @example
+ * ```typescript
+ * // In opencode.json
+ * {
+ *   "plugins": ["opencode-discord-presence"],
+ *   "discordPresence": {
+ *     "enabled": true,
+ *     "showSessionTime": true,
+ *     "showTokenUsage": true,
+ *     "showProjectName": true
+ *   }
+ * }
+ * ```
+ */
+export declare const OpenCodeDiscordPresence: Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAQjD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,uBAAuB,EAAE,MA0HrC,CAAA"}

package/dist/services/discord-rpc.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @fileoverview Discord RPC Service for Rich Presence
+ * @module opencode-discord-presence/services/discord-rpc
+ *
+ * Provides a singleton service for managing Discord Rich Presence connection.
+ * Features:
+ * - Singleton pattern for single connection per application
+ * - Automatic reconnection with exponential backoff
+ * - Debounced presence updates to avoid rate limiting
+ * - Event-driven connection management
+ */
+import type { PresenceState } from "../types";
+/**
+ * Singleton service for managing Discord Rich Presence
+ *
+ * @example
+ * ```typescript
+ * const rpc = DiscordRPCService.getInstance("your-client-id")
+ * await rpc.connect()
+ * await rpc.updatePresence({
+ *   details: "Working on project",
+ *   state: "Using Claude",
+ *   largeImageKey: "opencode-logo"
+ * })
+ * ```
+ */
+export declare class DiscordRPCService {
+    private static instance;
+    private static currentClientId;
+    private client;
+    private _isConnected;
+    private reconnectAttempts;
+    private debounceTimer;
+    private pendingPresence;
+    /**
+     * Private constructor - use getInstance() instead
+     */
+    private constructor();
+    /**
+     * Get the singleton instance of DiscordRPCService
+     *
+     * @param clientId - Discord Application ID
+     * @returns The singleton instance
+     */
+    static getInstance(clientId: string): DiscordRPCService;
+    /**
+     * Reset the singleton instance (mainly for testing)
+     */
+    static resetInstance(): void;
+    /**
+     * Whether the service is currently connected to Discord
+     */
+    get isConnected(): boolean;
+    /**
+     * Set up event handlers for the Discord RPC client
+     */
+    private setupEventHandlers;
+    /**
+     * Attempt to reconnect with exponential backoff
+     */
+    private attemptReconnect;
+    /**
+     * Connect to Discord RPC
+     *
+     * @throws Error if connection fails and not retrying
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from Discord RPC
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Update the Rich Presence with debouncing
+     *
+     * @param presence - The presence state to set
+     */
+    updatePresence(presence: PresenceState): Promise<void>;
+    /**
+     * Clear the Rich Presence
+     */
+    clearPresence(): Promise<void>;
+}
+//# sourceMappingURL=discord-rpc.d.ts.map

package/dist/services/discord-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discord-rpc.d.ts","sourceRoot":"","sources":["../../src/services/discord-rpc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAS7C;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IACxD,OAAO,CAAC,MAAM,CAAC,eAAe,CAAsB;IAEpD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,aAAa,CAA6C;IAClE,OAAO,CAAC,eAAe,CAA2B;IAElD;;OAEG;IACH,OAAO;IAKP;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB;IAQvD;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAQ5B;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;YACW,gBAAgB;IAwB9B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAe9B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC;;;;OAIG;IACG,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC5D;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;CAgBrC"}

package/dist/types/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @fileoverview Type definitions for OpenCode Discord Presence plugin
+ * @module opencode-discord-presence/types
+ */
+/**
+ * Supported languages for the plugin UI
+ * - "auto": Detect from system locale
+ * - "ko": Korean
+ * - "en": English
+ * - "ja": Japanese
+ * - "zh": Chinese (Simplified)
+ */
+export type SupportedLanguage = "auto" | "ko" | "en" | "ja" | "zh";
+/**
+ * Configuration options for the Discord Rich Presence plugin
+ */
+export interface DiscordPresenceConfig {
+    /** Whether the plugin is enabled */
+    enabled: boolean;
+    /** Discord Application ID for Rich Presence */
+    applicationId: string;
+    /** Show elapsed time since session started */
+    showSessionTime: boolean;
+    /** Show token usage count */
+    showTokenUsage: boolean;
+    /** Show current project name */
+    showProjectName: boolean;
+    /** Language for presence messages (default: "auto") */
+    language: SupportedLanguage;
+}
+/**
+ * Token count structure for tracking usage
+ */
+export interface TokenCount {
+    /** Input tokens consumed */
+    input: number;
+    /** Output tokens generated */
+    output: number;
+}
+/**
+ * Model information from OpenCode
+ */
+export interface ModelInfo {
+    /** Provider ID (e.g., "anthropic", "openai") */
+    providerID: string;
+    /** Model ID (e.g., "claude-sonnet-4-20250514") */
+    modelID: string;
+}
+/**
+ * Presence state for Discord Rich Presence
+ */
+export interface PresenceState {
+    /** Main text line (details) */
+    details: string;
+    /** Secondary text line (state) */
+    state?: string;
+    /** Timestamp when activity started */
+    startTimestamp?: number;
+    /** Large image asset key */
+    largeImageKey: string;
+    /** Tooltip for large image */
+    largeImageText?: string;
+    /** Small image asset key */
+    smallImageKey?: string;
+    /** Tooltip for small image */
+    smallImageText?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAElE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,+CAA+C;IAC/C,aAAa,EAAE,MAAM,CAAA;IACrB,8CAA8C;IAC9C,eAAe,EAAE,OAAO,CAAA;IACxB,6BAA6B;IAC7B,cAAc,EAAE,OAAO,CAAA;IACvB,gCAAgC;IAChC,eAAe,EAAE,OAAO,CAAA;IACxB,uDAAuD;IACvD,QAAQ,EAAE,iBAAiB,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAA;IACrB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4BAA4B;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB"}

package/dist/utils/format.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Formatting utilities for tokens and model names
+ * @module opencode-discord-presence/utils/format
+ *
+ * Provides formatting functions for displaying token counts and model names
+ * in a user-friendly way for Discord Rich Presence.
+ */
+import type { ModelInfo, TokenCount } from "../types";
+/**
+ * Format token count for display
+ *
+ * @param tokens - Token count object with input and output
+ * @returns Formatted string like "12.5k tokens" or "700 tokens"
+ *
+ * @example
+ * ```typescript
+ * formatTokens({ input: 8200, output: 4300 }) // "12.5k tokens"
+ * formatTokens({ input: 500, output: 200 })   // "700 tokens"
+ * formatTokens({ input: 0, output: 0 })       // "0 tokens"
+ * ```
+ */
+export declare function formatTokens(tokens: TokenCount): string;
+/**
+ * Format model name for display
+ *
+ * Converts model IDs like "claude-sonnet-4-20250514" to human-readable
+ * names like "Claude Sonnet 4".
+ *
+ * @param model - Model info with providerID and modelID
+ * @returns Human-readable model name
+ *
+ * @example
+ * ```typescript
+ * formatModelName({ providerID: "anthropic", modelID: "claude-sonnet-4-20250514" })
+ * // "Claude Sonnet 4"
+ *
+ * formatModelName({ providerID: "openai", modelID: "gpt-4o" })
+ * // "GPT-4o"
+ *
+ * formatModelName({ providerID: "unknown", modelID: "custom-model" })
+ * // "custom-model"
+ * ```
+ */
+export declare function formatModelName(model: ModelInfo | undefined): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/utils/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAErD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAevD;AAgCD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAuBpE"}

package/dist/utils/particle.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Korean particle utility for proper grammar
+ * @module opencode-discord-presence/utils/particle
+ *
+ * Korean particles (조사) change based on whether the preceding syllable
+ * ends with a consonant (받침) or not.
+ *
+ * - 을/를 (object marker): 을 after 받침, 를 after no 받침
+ * - 은/는 (topic marker): 은 after 받침, 는 after no 받침
+ *
+ * @example
+ * ```typescript
+ * withParticle("빌드", "을/를")     // "빌드를" (ㄷ has 받침)
+ * withParticle("프로메테우스", "을/를") // "프로메테우스를" (스 has no 받침)
+ * withParticle("oracle", "은/는")   // "oracle은" (e is consonant-like)
+ * ```
+ */
+/** Supported particle types */
+export type ParticleType = "을/를" | "은/는";
+/**
+ * Adds the correct Korean particle to a word based on its final character
+ *
+ * @param word - The word to add a particle to
+ * @param particle - The particle type ("을/를" or "은/는")
+ * @returns The word with the correct particle appended
+ *
+ * @example
+ * ```typescript
+ * withParticle("Prometheus", "을/를") // "Prometheus를"
+ * withParticle("build", "은/는")      // "build는"
+ * ```
+ */
+export declare function withParticle(word: string, particle: ParticleType): string;
+//# sourceMappingURL=particle.d.ts.map

package/dist/utils/particle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"particle.d.ts","sourceRoot":"","sources":["../../src/utils/particle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,+BAA+B;AAC/B,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,CAAA;AAExC;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CAOzE"}

package/dist/utils/project.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Project name detection utility
+ * @module opencode-discord-presence/utils/project
+ *
+ * Detects the current project name from Git remote URL or directory name.
+ */
+/**
+ * Get the project name from Git remote URL or directory path
+ *
+ * Priority:
+ * 1. Git remote URL (if provided) - extracts repo name
+ * 2. Directory path (if provided) - extracts folder name
+ * 3. Fallback - "Unknown Project"
+ *
+ * @param remoteUrl - Git remote URL (optional)
+ * @param directory - Current working directory path (optional)
+ * @returns Project name
+ *
+ * @example
+ * ```typescript
+ * getProjectName("git@github.com:user/my-repo.git")
+ * // "my-repo"
+ *
+ * getProjectName(undefined, "/Users/dev/my-project")
+ * // "my-project"
+ *
+ * getProjectName(undefined, undefined)
+ * // "Unknown Project"
+ * ```
+ */
+export declare function getProjectName(remoteUrl?: string, directory?: string): string;
+//# sourceMappingURL=project.d.ts.map

package/dist/utils/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/utils/project.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0CH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAe7E"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "opencode-discord-presence",
+  "version": "0.1.0",
+  "description": "Discord Rich Presence plugin for OpenCode - Display your current AI agent, model, and status in Discord",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "bun run --watch src/index.ts",
+    "build": "bun build src/index.ts --outdir dist --target node && bun run build:types",
+    "build:types": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src/",
+    "lint:fix": "biome check --write src/",
+    "format": "biome format --write src/",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "opencode",
+    "discord",
+    "rich-presence",
+    "rpc",
+    "claude",
+    "ai",
+    "plugin"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Puri12/opencode-rich-presence"
+  },
+  "bugs": {
+    "url": "https://github.com/Puri12/opencode-rich-presence/issues"
+  },
+  "homepage": "https://github.com/Puri12/opencode-rich-presence#readme",
+  "engines": {
+    "node": ">=18.0.0",
+    "bun": ">=1.1.0"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=0.1.0",
+    "typescript": "^5"
+  },
+  "peerDependenciesMeta": {
+    "@opencode-ai/plugin": {
+      "optional": false
+    }
+  },
+  "dependencies": {
+    "@xhayper/discord-rpc": "^1.3.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.13",
+    "@types/bun": "^1.3.8",
+    "typescript": "^5.9.3"
+  }
+}