@lssm-tech/module.alpic 3.7.29 → 5.0.1

package/README.md

@@ -1,4 +1,4 @@
-# @contractspec/module.alpic
+# @lssm-tech/module.alpic
 
 Website: https://contractspec.io
 
@@ -9,20 +9,20 @@ Website: https://contractspec.io
 - **Layer**: module.
 - **Consumers**: apps (alpic-mcp, chatgpt-app).
 - `src/mcp/` contains MCP handlers, tools, prompts, and resources.
-- Related ContractSpec packages include `@contractspec/lib.contracts-spec`, `@contractspec/lib.logger`, `@contractspec/tool.bun`, `@contractspec/tool.typescript`.
+- Related ContractSpec packages include `@lssm-tech/lib.contracts-spec`, `@lssm-tech/lib.logger`, `@lssm-tech/tool.bun`, `@lssm-tech/tool.typescript`.
 - `src/mcp/` contains MCP handlers, tools, prompts, and resources.
 
 ## Installation
 
-`npm install @contractspec/module.alpic`
+`npm install @lssm-tech/module.alpic`
 
 or
 
-`bun add @contractspec/module.alpic`
+`bun add @lssm-tech/module.alpic`
 
 ## Usage
 
-Import the root entrypoint from `@contractspec/module.alpic`, or choose a documented subpath when you only need one part of the package surface.
+Import the root entrypoint from `@lssm-tech/module.alpic`, or choose a documented subpath when you only need one part of the package surface.
 
 ## Architecture
 
@@ -37,11 +37,11 @@ Import the root entrypoint from `@contractspec/module.alpic`, or choose a docume
 ## Local Commands
 
 - `bun run dev` — contractspec-bun-build dev
-- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run build` — contractspec-bun-build build
 - `bun run lint` — bun lint:fix
 - `bun run lint:check` — biome check .
 - `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
-- `bun run typecheck` — tsc --noEmit
+- `bun run typecheck` — tsgo --noEmit
 - `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
 - `bun run publish:pkg:canary` — bun publish:pkg --tag canary
 - `bun run clean` — rimraf dist .turbo

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm-tech/module.alpic",
-  "version": "3.7.29",
+  "version": "5.0.1",
   "description": "Alpic MCP and ChatGPT App hosting helpers",
   "keywords": [
     "contractspec",
@@ -13,13 +13,12 @@
   "type": "module",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist",
-    "README.md"
+    "package.json"
   ],
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun run build:bundle && bun run build:types",
+    "build": "contractspec-bun-build build",
     "build:bundle": "contractspec-bun-build transpile",
     "build:types": "contractspec-bun-build types",
     "dev": "contractspec-bun-build dev",
@@ -28,33 +27,30 @@
     "lint:fix": "node ../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../scripts/biome.cjs check --write .",
     "lint:check": "node ../../../scripts/biome.cjs check .",
     "prebuild": "contractspec-bun-build prebuild",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsgo --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts-spec": "6.4.0",
-    "@contractspec/lib.logger": "3.7.22",
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "elysia": "^1.4.28",
-    "zod": "^4.3.5"
+    "@lssm-tech/lib.contracts-spec": "workspace:^",
+    "@lssm-tech/lib.crypto-utils": "workspace:^",
+    "@lssm-tech/lib.logger": "workspace:^",
+    "@modelcontextprotocol/sdk": "catalog:ai",
+    "elysia": "catalog:server",
+    "zod": "catalog:"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.13",
-    "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "3.7.18"
+    "@lssm-tech/tool.typescript": "workspace:*",
+    "typescript": "catalog:",
+    "@lssm-tech/tool.bun": "workspace:*"
   },
   "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "bun": "./dist/index.js",
-      "node": "./dist/node/index.js",
-      "default": "./dist/index.js"
-    }
+    ".": "./src/index.ts"
   },
   "publishConfig": {
     "access": "public",
     "exports": {
       ".": {
         "types": "./dist/index.d.ts",
+        "browser": "./dist/browser/index.js",
         "bun": "./dist/index.js",
         "node": "./dist/node/index.js",
         "default": "./dist/index.js"
@@ -68,5 +64,76 @@
     "url": "https://github.com/lssm-tech/contractspec.git",
     "directory": "packages/modules/alpic"
   },
-  "homepage": "https://contractspec.io"
+  "homepage": "https://contractspec.io",
+  "contractspec": {
+    "catalog": {
+      "family": "solutions",
+      "kind": "module",
+      "status": "active",
+      "adoptionMode": "adoptable",
+      "stability": "stable",
+      "platforms": [
+        "server"
+      ],
+      "runtimes": [
+        "node"
+      ],
+      "entrypoints": [
+        "."
+      ],
+      "documentation": [
+        {
+          "title": "Module Alpic documentation",
+          "url": "https://www.npmjs.com/package/%40lssm-tech%2Fmodule.alpic",
+          "kind": "readme"
+        }
+      ],
+      "examples": [],
+      "replacements": [],
+      "capabilities": [
+        {
+          "id": "package.lssm.tech.module.alpic",
+          "title": "Module Alpic",
+          "description": "Alpic MCP and ChatGPT App hosting helpers",
+          "status": "active",
+          "useCases": [
+            "Adopt alpic mcp and chatgpt app hosting helpers"
+          ],
+          "aliases": [
+            "contractspec",
+            "alpic",
+            "mcp",
+            "chatgpt-app",
+            "hosting",
+            "typescript",
+            "module"
+          ],
+          "pythonEquivalents": [],
+          "canonicalImports": [
+            {
+              "from": "@lssm-tech/module.alpic",
+              "symbols": []
+            }
+          ],
+          "constraints": {
+            "platforms": [
+              "server"
+            ],
+            "runtimes": [
+              "node"
+            ],
+            "avoidWhen": [
+              "The @lssm-tech/module.alpic package constraints do not match the target runtime or platform."
+            ],
+            "requires": [
+              "TypeScript"
+            ]
+          },
+          "alternatives": [],
+          "relationships": [],
+          "resolutionPriority": 50
+        }
+      ]
+    }
+  }
 }

package/dist/alpic.feature.d.ts

@@ -1 +0,0 @@
-export declare const AlpicFeature: import("@contractspec/lib.contracts-spec").FeatureModuleSpec;

package/dist/assets/paths.d.ts

@@ -1,2 +0,0 @@
-export declare function alpicAssetPath(assetPath: string): string;
-export declare function alpicAssetUrl(assetPath: string): string;

package/dist/index.d.ts

@@ -1,3 +0,0 @@
-export * from './alpic.feature';
-export * from './assets/paths';
-export * from './mcp/create-alpic-mcp-app';

package/dist/index.js

@@ -1,2 +0,0 @@
-// @bun
-import{defineFeature as Q}from"@contractspec/lib.contracts-spec/features";var d=Q({meta:{key:"modules.alpic",version:"1.0.0",title:"Alpic",description:"Alpic MCP and ChatGPT App hosting helpers",domain:"alpic",owners:["@contractspec-core"],tags:["package","modules","alpic"],stability:"experimental"}});function O(A){let y=A.trim();if(!y)return"/assets";if(y.startsWith("/assets"))return y;if(y.startsWith("/"))return`/assets${y}`;return`/assets/${y}`}function K(A){return O(A)}function k(A){let y=O(A),E=process.env.ALPIC_HOST?.trim();if(!E)return y;return`https://${E}${y}`}import{Logger as z,LogLevel as D}from"@contractspec/lib.logger";import{McpServer as F}from"@modelcontextprotocol/sdk/server/mcp.js";import{WebStandardStreamableHTTPServerTransport as M}from"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";import{randomUUID as N}from"crypto";import{Elysia as L}from"elysia";var V="alpic_ui",X="app://ui";function J(A,y={}){let E=y.assetPath??"index.html",U=K(E),_=k(E),C=y.resourceKey??V,$=y.resourceUri??X,S=y.title??"ChatGPT App UI",x=y.description??"Entry point for the ChatGPT App UI hosted on Alpic.";A.registerResource(C,$,{title:S,description:x,mimeType:"application/json"},async()=>{return{contents:[{uri:$,mimeType:"application/json",text:JSON.stringify({title:S,description:x,path:U,url:_},null,2)}]}})}import{sanitizeMcpName as Y}from"@contractspec/lib.contracts-spec/jsonschema";import*as P from"zod";var Z="alpic_ping",W=P.object({message:P.string().optional()});function w(A,y={}){let E=Y(y.name??Z),U=y.description??"Ping the MCP server and return basic Alpic info.";A.registerTool(E,{description:U,inputSchema:W},async(_)=>{let $={ok:!0,message:W.parse(_??{}).message??"pong",assetsBase:K(""),timestamp:new Date().toISOString()};return{content:[{type:"text",text:JSON.stringify($,null,2)}]}})}var l="contractspec-alpic-mcp",u="1.0.0";function r(A){if(typeof A==="boolean")return A;return process.env.ALPIC_MCP_DEBUG==="1"||process.env.CONTRACTSPEC_MCP_DEBUG==="1"}function v(A){return new z({level:A?D.DEBUG:D.INFO,environment:"production",enableTracing:!1,enableTiming:!1,enableContext:!1,enableColors:!1})}function I(A,y){let E=(U)=>U.map((_)=>typeof _==="string"?_:JSON.stringify(_)).join(" ");return{log:(...U)=>{if(!y)return;A.info(E(U))},info:(...U)=>{if(!y)return;A.info(E(U))},warn:(...U)=>{A.warn(E(U))},error:(...U)=>{A.error(E(U))},debug:(...U)=>{if(!y)return;A.debug(E(U))}}}function b(A,y){w(A,y.tool),J(A,y.ui)}function m(A,y,E){return new Response(JSON.stringify({jsonrpc:"2.0",error:{code:y,message:E},id:null}),{status:A,headers:{"content-type":"application/json"}})}function H(A,y){let E=new F({name:A.serverName??l,version:A.serverVersion??u},{capabilities:{tools:{},resources:{},prompts:{},logging:{}}});b(E,A);let U=new M({sessionIdGenerator:y?()=>N():void 0,enableJsonResponse:A.enableJsonResponse??!0});return E.connect(U).then(()=>({server:E,transport:U}))}async function R(A){await Promise.allSettled([A.transport.close(),A.server.close()])}function q(A){return A.replace(/[^a-zA-Z0-9]+/g,"-")}function p(A){let y=r(A.enableDebugLogs),E=A.logger??v(y),U=A.stateless??!0,_=new Map,C=`alpic-mcp-handler-${q(A.path)}`;async function $(f){let c=await H(A,!1);try{return await c.transport.handleRequest(f)}finally{await R(c)}}async function S(f){let c=_.get(f);if(!c)return;_.delete(f),await R(c)}async function x(f){let c=f.headers.get("mcp-session-id"),T,j=!1;if(c){let h=_.get(c);if(!h)return m(404,-32001,"Session not found");T=h}else T=await H(A,!0),j=!0;try{let h=await T.transport.handleRequest(f),B=T.transport.sessionId;if(B&&!_.has(B))_.set(B,T);if(f.method==="DELETE"&&B)await S(B);else if(!B&&j)await R(T);return h}catch(h){if(j)await R(T);throw h}}let G=I(E,y);return new L({name:C}).all(A.path,async({request:f})=>{try{if(A.validateAuth){if(!await A.validateAuth(f))return m(401,-32002,"Unauthorized")}if(U)return await $(f);return await x(f)}catch(c){return G.error("Error handling MCP request",{path:A.path,method:f.method,error:c instanceof Error?c.stack??c.message:String(c)}),m(500,-32000,"Internal error")}})}function TA(A={}){let y=new L;return(A.basePaths??["/","/mcp"]).forEach((U)=>{y.use(p({...A,path:U}))}),y}export{p as createAlpicMcpHandler,TA as createAlpicMcpApp,k as alpicAssetUrl,K as alpicAssetPath,d as AlpicFeature};

package/dist/mcp/alpic-mcp.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/mcp/create-alpic-mcp-app.d.ts

@@ -1,24 +0,0 @@
-import { Logger } from '@contractspec/lib.logger';
-import { Elysia } from 'elysia';
-import { type AlpicMcpUiConfig } from './resources';
-import { type AlpicMcpToolConfig } from './tools';
-export interface AlpicMcpAppOptions {
-    serverName?: string;
-    serverVersion?: string;
-    basePaths?: string[];
-    stateless?: boolean;
-    enableJsonResponse?: boolean;
-    enableDebugLogs?: boolean;
-    ui?: AlpicMcpUiConfig;
-    tool?: AlpicMcpToolConfig;
-    logger?: Logger;
-    /** Validate incoming requests against an auth scheme before processing. */
-    validateAuth?: (request: Request) => boolean | Promise<boolean>;
-    /** Auth methods the MCP server requires clients to use. */
-    requiredAuthMethods?: string[];
-}
-export interface AlpicMcpHandlerOptions extends AlpicMcpAppOptions {
-    path: string;
-}
-export declare function createAlpicMcpHandler(options: AlpicMcpHandlerOptions): Elysia;
-export declare function createAlpicMcpApp(options?: AlpicMcpAppOptions): Elysia;

package/dist/mcp/resources.d.ts

@@ -1,9 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export interface AlpicMcpUiConfig {
-    resourceKey?: string;
-    resourceUri?: string;
-    title?: string;
-    description?: string;
-    assetPath?: string;
-}
-export declare function registerAlpicResources(server: McpServer, config?: AlpicMcpUiConfig): void;

package/dist/mcp/tools.d.ts

@@ -1,6 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export interface AlpicMcpToolConfig {
-    name?: string;
-    description?: string;
-}
-export declare function registerAlpicTools(server: McpServer, config?: AlpicMcpToolConfig): void;

package/dist/node/index.js

@@ -1 +0,0 @@
-import{defineFeature as Q}from"@contractspec/lib.contracts-spec/features";var d=Q({meta:{key:"modules.alpic",version:"1.0.0",title:"Alpic",description:"Alpic MCP and ChatGPT App hosting helpers",domain:"alpic",owners:["@contractspec-core"],tags:["package","modules","alpic"],stability:"experimental"}});function O(A){let y=A.trim();if(!y)return"/assets";if(y.startsWith("/assets"))return y;if(y.startsWith("/"))return`/assets${y}`;return`/assets/${y}`}function K(A){return O(A)}function k(A){let y=O(A),E=process.env.ALPIC_HOST?.trim();if(!E)return y;return`https://${E}${y}`}import{Logger as z,LogLevel as D}from"@contractspec/lib.logger";import{McpServer as F}from"@modelcontextprotocol/sdk/server/mcp.js";import{WebStandardStreamableHTTPServerTransport as M}from"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";import{randomUUID as N}from"crypto";import{Elysia as L}from"elysia";var V="alpic_ui",X="app://ui";function J(A,y={}){let E=y.assetPath??"index.html",U=K(E),_=k(E),C=y.resourceKey??V,$=y.resourceUri??X,S=y.title??"ChatGPT App UI",x=y.description??"Entry point for the ChatGPT App UI hosted on Alpic.";A.registerResource(C,$,{title:S,description:x,mimeType:"application/json"},async()=>{return{contents:[{uri:$,mimeType:"application/json",text:JSON.stringify({title:S,description:x,path:U,url:_},null,2)}]}})}import{sanitizeMcpName as Y}from"@contractspec/lib.contracts-spec/jsonschema";import*as P from"zod";var Z="alpic_ping",W=P.object({message:P.string().optional()});function w(A,y={}){let E=Y(y.name??Z),U=y.description??"Ping the MCP server and return basic Alpic info.";A.registerTool(E,{description:U,inputSchema:W},async(_)=>{let $={ok:!0,message:W.parse(_??{}).message??"pong",assetsBase:K(""),timestamp:new Date().toISOString()};return{content:[{type:"text",text:JSON.stringify($,null,2)}]}})}var l="contractspec-alpic-mcp",u="1.0.0";function r(A){if(typeof A==="boolean")return A;return process.env.ALPIC_MCP_DEBUG==="1"||process.env.CONTRACTSPEC_MCP_DEBUG==="1"}function v(A){return new z({level:A?D.DEBUG:D.INFO,environment:"production",enableTracing:!1,enableTiming:!1,enableContext:!1,enableColors:!1})}function I(A,y){let E=(U)=>U.map((_)=>typeof _==="string"?_:JSON.stringify(_)).join(" ");return{log:(...U)=>{if(!y)return;A.info(E(U))},info:(...U)=>{if(!y)return;A.info(E(U))},warn:(...U)=>{A.warn(E(U))},error:(...U)=>{A.error(E(U))},debug:(...U)=>{if(!y)return;A.debug(E(U))}}}function b(A,y){w(A,y.tool),J(A,y.ui)}function m(A,y,E){return new Response(JSON.stringify({jsonrpc:"2.0",error:{code:y,message:E},id:null}),{status:A,headers:{"content-type":"application/json"}})}function H(A,y){let E=new F({name:A.serverName??l,version:A.serverVersion??u},{capabilities:{tools:{},resources:{},prompts:{},logging:{}}});b(E,A);let U=new M({sessionIdGenerator:y?()=>N():void 0,enableJsonResponse:A.enableJsonResponse??!0});return E.connect(U).then(()=>({server:E,transport:U}))}async function R(A){await Promise.allSettled([A.transport.close(),A.server.close()])}function q(A){return A.replace(/[^a-zA-Z0-9]+/g,"-")}function p(A){let y=r(A.enableDebugLogs),E=A.logger??v(y),U=A.stateless??!0,_=new Map,C=`alpic-mcp-handler-${q(A.path)}`;async function $(f){let c=await H(A,!1);try{return await c.transport.handleRequest(f)}finally{await R(c)}}async function S(f){let c=_.get(f);if(!c)return;_.delete(f),await R(c)}async function x(f){let c=f.headers.get("mcp-session-id"),T,j=!1;if(c){let h=_.get(c);if(!h)return m(404,-32001,"Session not found");T=h}else T=await H(A,!0),j=!0;try{let h=await T.transport.handleRequest(f),B=T.transport.sessionId;if(B&&!_.has(B))_.set(B,T);if(f.method==="DELETE"&&B)await S(B);else if(!B&&j)await R(T);return h}catch(h){if(j)await R(T);throw h}}let G=I(E,y);return new L({name:C}).all(A.path,async({request:f})=>{try{if(A.validateAuth){if(!await A.validateAuth(f))return m(401,-32002,"Unauthorized")}if(U)return await $(f);return await x(f)}catch(c){return G.error("Error handling MCP request",{path:A.path,method:f.method,error:c instanceof Error?c.stack??c.message:String(c)}),m(500,-32000,"Internal error")}})}function TA(A={}){let y=new L;return(A.basePaths??["/","/mcp"]).forEach((U)=>{y.use(p({...A,path:U}))}),y}export{p as createAlpicMcpHandler,TA as createAlpicMcpApp,k as alpicAssetUrl,K as alpicAssetPath,d as AlpicFeature};