npm - shraga - Versions diffs - 0.1.2 → 0.1.4 - Mend

shraga 0.1.2 → 0.1.4

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

package/README.md +63 -1
package/defaults/agents/trace-extractor.md +1 -1
package/defaults/extensions/stripe-webhook.ext.ts +29 -21
package/defaults/scripts/agent-once.ts +1 -1
package/defaults/skills/communications.md +1 -1
package/defaults/skills/mcps-sync.md +2 -2
package/defaults/skills/self-aware.md +1 -1
package/dist/client/assets/{index-BoHttkMt.js → index-BnArwb7g.js} +43 -43
package/dist/client/index.html +1 -1
package/package.json +8 -5
package/src/cli.ts +3 -1
package/src/client/components/ArtifactPanel.tsx +16 -3
package/src/index.ts +172 -0
package/src/server/artifacts/artifacts.routes.ts +2 -19
package/src/server/boot.ts +1779 -0
package/src/server/engine/claude-code.ts +2 -2
package/src/server/events/bus.ts +21 -5
package/src/server/events/types.ts +26 -3
package/src/server/events/webhook.ts +64 -0
package/src/server/extensions.ts +34 -0
package/src/server/hooks.ts +2 -2
package/src/server/index.ts +8 -1712
package/src/server/slack/bot.ts +1 -1
package/src/server/slack/feature.ts +1 -1
package/src/server/turn-context.ts +7 -0
package/src/server/artifacts/artifacts.export.ts +0 -85

package/dist/client/index.html CHANGED Viewed

@@ -13,7 +13,7 @@
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600&display=swap" rel="stylesheet" />
-    <script type="module" crossorigin src="/assets/index-BoHttkMt.js"></script>
+    <script type="module" crossorigin src="/assets/index-BnArwb7g.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-DdibEb2O.css">
   </head>
   <body>

package/package.json CHANGED Viewed

@@ -1,8 +1,14 @@
 {
   "name": "shraga",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "The teammate you delegate coding to — a self-hostable, multi-user AI coding agent web UI (Claude Code, with a pluggable engine seam).",
   "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./package.json": "./package.json"
+  },
   "license": "MIT",
   "author": "Elya Livshitz",
   "homepage": "https://livx.cc/shraga",
@@ -63,7 +69,7 @@
     "express": "^4.21.1",
     "firebase": "^11.0.0",
     "lucide-react": "^0.468.0",
-    "mcp-slack-use": "github:Livshitz/mcp-slack-use#0c877d3397f7",
+    "mcp-slack-use": "github:Livshitz/mcp-slack-use#1dde291",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "react-markdown": "^9.0.0",
@@ -88,8 +94,5 @@
     "tailwindcss-animate": "^1.0.7",
     "typescript": "^5.7.0",
     "vite": "^6.0.7"
-  },
-  "optionalDependencies": {
-    "puppeteer": "^25.0.2"
   }
 }

package/src/cli.ts CHANGED Viewed

@@ -84,4 +84,6 @@ function cleanup() {
 process.on('SIGINT', cleanup);
 process.on('SIGTERM', cleanup);
-await import('./server/index.ts');
+// Dogfood the public library surface — the CLI's server-run path IS createShraga(...).start().
+const { createShraga, fromEnv } = await import('./index.ts');
+await createShraga(fromEnv()).start();

package/src/client/components/ArtifactPanel.tsx CHANGED Viewed

@@ -17,6 +17,7 @@ interface Props {
 export function ArtifactPanel({ artifacts, selectedId, sessionId, getToken, onSelect, onClose }: Props) {
   const [expanded, setExpanded] = useState(false);
   const [exporting, setExporting] = useState(false);
+  const [pngExport, setPngExport] = useState(false); // PNG export is an EE overlay capability; hidden in CE
   const [scale, setScale] = useState(1);
   const containerRef = useRef<HTMLDivElement>(null);
   const selected = artifacts.find(a => a.id === selectedId);
@@ -31,6 +32,16 @@ export function ArtifactPanel({ artifacts, selectedId, sessionId, getToken, onSe
     setScale(Math.min(availW / w, availH / h, 1));
   }, [selected]);
+  useEffect(() => {
+    let alive = true;
+    getToken()
+      .then(t => fetch('/api/features', { headers: t ? { Authorization: `Bearer ${t}` } : {} }))
+      .then(r => r.json())
+      .then((f: { artifactPngExport?: boolean }) => { if (alive) setPngExport(!!f.artifactPngExport); })
+      .catch(err => console.error('[artifact] features fetch failed:', err));
+    return () => { alive = false; };
+  }, [getToken]);
   useEffect(() => {
     recalcScale();
     const el = containerRef.current;
@@ -106,9 +117,11 @@ export function ArtifactPanel({ artifacts, selectedId, sessionId, getToken, onSe
           </span>
         )}
         <div className="flex-1" />
-        <Button variant="ghost" size="icon" className="h-6 w-6" onClick={handleExport} disabled={!selected || exporting} title="Export PNG">
-          {exporting ? <span className="w-3 h-3 border-2 border-current border-t-transparent rounded-full animate-spin" /> : <Image className="w-3.5 h-3.5" />}
-        </Button>
+        {pngExport && (
+          <Button variant="ghost" size="icon" className="h-6 w-6" onClick={handleExport} disabled={!selected || exporting} title="Export PNG">
+            {exporting ? <span className="w-3 h-3 border-2 border-current border-t-transparent rounded-full animate-spin" /> : <Image className="w-3.5 h-3.5" />}
+          </Button>
+        )}
         <Button variant="ghost" size="icon" className="h-6 w-6 hidden sm:inline-flex" onClick={() => setExpanded(!expanded)} title={expanded ? 'Minimize' : 'Maximize'}>
           {expanded ? <Minimize2 className="w-3.5 h-3.5" /> : <Maximize2 className="w-3.5 h-3.5" />}
         </Button>

package/src/index.ts ADDED Viewed

@@ -0,0 +1,172 @@
+// Shraga — public library surface.
+//
+// The FIRST-CLASS way to consume Shraga: `import { createShraga } from 'shraga'`, configure with
+// typed options, register/extend programmatically through the same seams the built-ins use
+// (features, engines, the event bus, verified webhooks, data-side extensions), then `start()`.
+//
+//   import { createShraga } from 'shraga';
+//   const app = createShraga({ port: 3032, dataDir: './data', authProvider: 'local' });
+//   app.registerFeature(myFeature);
+//   app.on('gmail', (payload) => { … });
+//   await app.start();
+//   // … app.stop() to shut down.
+//
+// The run-from-source entry (`src/server/index.ts`, used by prod `bun run src/server/index.ts`) and
+// the `shraga` CLI both dogfood this exact surface — createShraga(fromEnv()).start(). File-based
+// `data/extensions/*.ext.ts` drop-ins and `SHRAGA_OVERLAY` keep working: they reach the SAME
+// programmatic registries, just via a different door.
+// Type-only imports below: importing this module must NOT eagerly load the server graph (which
+// resolves DATA_DIR at import time). The runtime boot is a dynamic import inside start(), AFTER
+// options have been mapped onto the environment.
+import type { BootRegistrations, ServerHandle } from './server/boot.ts';
+import type { ServerFeature, FeatureContext } from './server/features.ts';
+import type { AgentEngine, EngineModel, EngineStreamOpts } from './server/engine/types.ts';
+import type { ExtRegisterFn, ExtensionContext } from './server/extensions.ts';
+import type { WebhookOptions } from './server/events/webhook.ts';
+import type { ShragaEvent, ShragaEventMap, PayloadOf } from './server/events/types.ts';
+export type {
+  ServerHandle,
+  ServerFeature,
+  FeatureContext,
+  AgentEngine,
+  EngineModel,
+  EngineStreamOpts,
+  ExtRegisterFn,
+  ExtensionContext,
+  WebhookOptions,
+  ShragaEvent,
+  ShragaEventMap,
+  PayloadOf,
+};
+/** Typed configuration for a Shraga instance. Follows the repo's ModuleOptions convention:
+ *  defaults live here and are merged with the caller's partial. Anything not modelled is still
+ *  reachable via `env` (Shraga is heavily env-driven) — those are set before the server boots. */
+export class ShragaOptions {
+  /** HTTP/WS port. Default 3032 (or PORT env). */
+  port?: number;
+  /** Data directory (flat-file storage root). Default ./data (or DATA_DIR env). */
+  dataDir?: string;
+  /** Auth backend. 'local' (default) = username/password; 'firebase' needs the firebase add-on. */
+  authProvider?: 'local' | 'firebase';
+  /** Passive mode — HTTP serving only, no schedulers/consumers/background writers (standby twins). */
+  passive?: boolean;
+  /** Install process SIGTERM/SIGINT handlers (default true — the standalone server/CLI wants them).
+   *  A library embedder owning its own lifecycle sets false and uses stop(). */
+  installSignalHandlers?: boolean = true;
+  /** Arbitrary extra environment to apply before boot (e.g. ANTHROPIC_API_KEY, SHRAGA_FEAT_*). */
+  env?: Record<string, string>;
+}
+export interface ShragaInstance {
+  /** Register a server feature (routes/WS/consumers) — the same seam Slack uses. */
+  registerFeature(feature: ServerFeature): this;
+  /** Register a pluggable agent engine (runtime). */
+  registerEngine(engine: AgentEngine): this;
+  /** Register a programmatic extension — the same shape as a data/extensions/*.ext.ts default export. */
+  registerExtension(fn: ExtRegisterFn): this;
+  /** Declare a verified vendor webhook (public POST /api/webhooks/<source> → typed event). */
+  registerWebhook<K extends string>(opts: WebhookOptions<K>): this;
+  /** Subscribe to a typed event source on the in-process bus. */
+  on<K extends string>(source: K, handler: (payload: PayloadOf<K>, evt: ShragaEvent<K>) => void): this;
+  /** Publish an event onto the bus (after start()). */
+  emit<K extends string>(source: K, payload: PayloadOf<K>): this;
+  /** Boot HTTP + WS. Resolves once listening. Idempotent — repeated calls return the same handle. */
+  start(): Promise<ServerHandle>;
+  /** Drain and shut down without exiting the process. */
+  stop(): Promise<void>;
+  /** The live Express app (advanced use) — available after start(). */
+  readonly app: ServerHandle['app'] | undefined;
+  /** Publish onto the bus directly (advanced use) — available after start(). */
+  readonly emitEvent: ServerHandle['emitEvent'] | undefined;
+}
+class Shraga implements ShragaInstance {
+  public options: ShragaOptions;
+  private reg: Required<BootRegistrations> = { features: [], engines: [], extensions: [], eventSubs: [] };
+  private handle: ServerHandle | null = null;
+  private starting: Promise<ServerHandle> | null = null;
+  constructor(options?: Partial<ShragaOptions>) {
+    this.options = { ...new ShragaOptions(), ...options };
+    // Map options onto the environment NOW, before any server module (which resolves DATA_DIR /
+    // AUTH_PROVIDER at import time) can load. start()'s dynamic import happens strictly after this.
+    this.applyEnv();
+  }
+  private applyEnv(): void {
+    const o = this.options;
+    if (o.port != null) process.env.PORT = String(o.port);
+    if (o.dataDir != null) process.env.DATA_DIR = o.dataDir;
+    if (o.authProvider != null) process.env.AUTH_PROVIDER = o.authProvider;
+    if (o.passive != null) process.env.SHRAGA_PASSIVE = o.passive ? '1' : '0';
+    if (o.installSignalHandlers === false) process.env.SHRAGA_INSTALL_SIGNALS = '0';
+    for (const [k, v] of Object.entries(o.env ?? {})) process.env[k] = v;
+  }
+  private assertNotStarted(what: string): void {
+    if (this.handle || this.starting) throw new Error(`[shraga] ${what} must be called before start()`);
+  }
+  registerFeature(feature: ServerFeature): this { this.assertNotStarted('registerFeature'); this.reg.features.push(feature); return this; }
+  registerEngine(engine: AgentEngine): this { this.assertNotStarted('registerEngine'); this.reg.engines.push(engine); return this; }
+  registerExtension(fn: ExtRegisterFn): this { this.assertNotStarted('registerExtension'); this.reg.extensions.push(fn); return this; }
+  registerWebhook<K extends string>(opts: WebhookOptions<K>): this {
+    this.assertNotStarted('registerWebhook');
+    // A webhook is just an extension that mounts a verified route on the extension router (before the
+    // SPA catch-all) — identical to a file-based webhook. Reuse the seam; don't invent a parallel one.
+    this.reg.extensions.push((_router, ctx: ExtensionContext) => { ctx.registerWebhook(opts); });
+    return this;
+  }
+  on<K extends string>(source: K, handler: (payload: PayloadOf<K>, evt: ShragaEvent<K>) => void): this {
+    this.assertNotStarted('on');
+    this.reg.eventSubs.push({ source, handler: handler as (payload: unknown, evt: unknown) => void });
+    return this;
+  }
+  emit<K extends string>(source: K, payload: PayloadOf<K>): this {
+    if (!this.handle) throw new Error('[shraga] emit() requires start() first');
+    this.handle.emitEvent(source, payload);
+    return this;
+  }
+  async start(): Promise<ServerHandle> {
+    if (this.handle) return this.handle;
+    if (this.starting) return this.starting;
+    this.starting = (async () => {
+      const { bootServer } = await import('./server/boot.ts');
+      this.handle = await bootServer(this.reg);
+      return this.handle;
+    })();
+    return this.starting;
+  }
+  async stop(): Promise<void> {
+    if (this.handle) { await this.handle.stop(); this.handle = null; }
+    this.starting = null;
+  }
+  get app() { return this.handle?.app; }
+  get emitEvent() { return this.handle?.emitEvent; }
+}
+/** Create a Shraga instance. Configure it, register/extend, then `await instance.start()`. */
+export function createShraga(options?: Partial<ShragaOptions>): ShragaInstance {
+  return new Shraga(options);
+}
+/** Derive options from the environment (PORT / DATA_DIR / AUTH_PROVIDER / SHRAGA_PASSIVE). The
+ *  run-from-source entry and the CLI pass this straight into createShraga. */
+export function fromEnv(): Partial<ShragaOptions> {
+  const passive = process.env.SHRAGA_PASSIVE ?? process.env.UNCLAW_PASSIVE;
+  return {
+    port: process.env.PORT ? Number(process.env.PORT) : undefined,
+    dataDir: process.env.DATA_DIR || undefined,
+    authProvider: (process.env.AUTH_PROVIDER as 'local' | 'firebase' | undefined) || undefined,
+    passive: passive === '1' || passive === 'true' ? true : undefined,
+  };
+}

package/src/server/artifacts/artifacts.routes.ts CHANGED Viewed

@@ -1,9 +1,6 @@
 import { Router, type Request } from 'express';
 import { requireAuth } from '../auth.ts';
 import { getArtifact, getArtifactHtml, listArtifacts } from './artifacts.service.ts';
-import { exportToPng } from './artifacts.export.ts';
-const PREFIX = '[artifacts:http]';
 export const artifactsRouter = Router();
@@ -25,19 +22,5 @@ artifactsRouter.get('/api/artifacts/:sid/:id/meta', requireAuth, (req: Request<{
   res.json(artifact.meta);
 });
-artifactsRouter.post('/api/artifacts/:sid/:id/export', requireAuth, async (req: Request<{ sid: string; id: string }>, res) => {
-  const { sid, id } = req.params;
-  const artifact = getArtifact(sid, id);
-  if (!artifact) return res.sendStatus(404);
-  const dimensions: [number, number] = req.body?.dimensions ?? artifact.meta.dimensions;
-  try {
-    const png = await exportToPng(artifact.html, dimensions);
-    console.log(PREFIX, `exported ${id} → ${png.length} bytes`);
-    res.type('png').send(png);
-  } catch (err: any) {
-    console.error(PREFIX, 'export failed:', err.message);
-    res.status(500).json({ error: err.message });
-  }
-});
+// PNG export (Puppeteer) is not part of CE. An EE overlay adds the
+// `POST /api/artifacts/:sid/:id/export` route and declares the `artifactPngExport` capability flag.