@musher-dev/musher-sdk 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Musher Dev
+
+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/README.md

@@ -0,0 +1,102 @@
+# @musher-dev/musher-sdk
+
+Official TypeScript SDK for the [Musher](https://musher.dev) platform. Pull, cache, and load bundled AI agent assets — skills, prompts, toolsets, and agent specs — from the Musher registry.
+
+## Install
+
+```bash
+npm install @musher-dev/musher-sdk
+```
+
+## Usage
+
+### Pull and access a bundle
+
+```typescript
+import { pull } from "@musher-dev/musher-sdk";
+
+const bundle = await pull("acme/code-review-kit:1.2.0");
+
+// Typed handle access
+bundle.prompt("system").content();       // prompt text
+bundle.skill("lint-rules").files();      // skill files
+bundle.toolset("review-tools").content(); // toolset definition
+bundle.agentSpec("reviewer").content();  // agent spec
+
+// Raw file access
+bundle.file("prompts/system.md")?.text();
+bundle.files();  // all FileHandle[]
+```
+
+### Resolve metadata only
+
+```typescript
+import { resolve } from "@musher-dev/musher-sdk";
+
+const meta = await resolve("acme/code-review-kit:1.2.0");
+console.log(meta.version, meta.ref);
+```
+
+### Verify integrity and lock
+
+```typescript
+const result = bundle.verify();  // SHA-256 check on every file
+await bundle.writeLockfile("./musher-lock.json");
+```
+
+### Custom client configuration
+
+```typescript
+import { MusherClient } from "@musher-dev/musher-sdk";
+
+const client = new MusherClient({
+  cacheDir: "/tmp/musher-cache",
+  manifestTtlSeconds: 3600,
+});
+
+const bundle = await client.pull("acme/code-review-kit:1.2.0");
+```
+
+### Platform adapters
+
+```typescript
+import {
+  installClaudeSkills,
+  exportClaudePlugin,
+  exportOpenAILocalSkill,
+  exportOpenAIInlineSkill,
+  installVSCodeSkills,
+} from "@musher-dev/musher-sdk";
+
+// Claude Code — install skills into .claude/skills/<skill-name>/
+await installClaudeSkills(bundle, process.cwd());
+
+// OpenAI — export a skill for local shell agents
+const local = await exportOpenAILocalSkill(bundle.skill("lint-rules"), "./skills");
+
+// VS Code — install into .agents/skills/
+await installVSCodeSkills(bundle, process.cwd());
+```
+
+## Key exports
+
+| Export | Kind | Description |
+|--------|------|-------------|
+| `pull` | function | Pull a bundle (resolve + download + verify + cache) |
+| `resolve` | function | Resolve bundle metadata without downloading |
+| `configure` | function | Set default client config for convenience functions |
+| `MusherClient` | class | Client with custom config, cache management |
+| `Bundle` | class | Typed bundle with handle access and verification |
+| `BundleRef` | class | Parse and represent `namespace/slug:version` refs |
+| `Selection` | class | Lazy filtered view over a bundle |
+| `FileHandle` | class | File content access (text, bytes, stream) |
+| `SkillHandle` | class | Skill file grouping with definition access |
+| `PromptHandle` | class | Single-file prompt with `.content()` |
+| `ToolsetHandle` | class | Single-file toolset with `.content()` |
+| `AgentSpecHandle` | class | Single-file agent spec with `.content()` |
+
+See [`examples/`](../../examples/) for runnable integration examples.
+
+## License
+
+MIT