@lssm-tech/module.alpic 3.7.29

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+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,64 @@
+# @contractspec/module.alpic
+
+Website: https://contractspec.io
+
+**Alpic MCP and ChatGPT App hosting helpers.**
+
+## What It Provides
+
+- **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`.
+- `src/mcp/` contains MCP handlers, tools, prompts, and resources.
+
+## Installation
+
+`npm install @contractspec/module.alpic`
+
+or
+
+`bun add @contractspec/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.
+
+## Architecture
+
+- `src/assets` is part of the package's public or composition surface.
+- `src/index.ts` is the root public barrel and package entrypoint.
+- `src/mcp/` contains MCP handlers, tools, prompts, and resources.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+
+## 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 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 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
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+- Standardize tool naming to underscore notation.
+- Add changesets and apply pending fixes.
+- Add first-class transport, auth, versioning, and BYOK support across all integrations.
+- Test runner.
+
+## Notes
+
+- Depends on `@modelcontextprotocol/sdk` and `elysia` -- version bumps may break MCP protocol compatibility.
+- Exposes external-facing endpoints; treat all inputs as untrusted.
+- Changes affect MCP tool registration and ChatGPT plugin manifests.

package/dist/alpic.feature.d.ts

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

package/dist/assets/paths.d.ts

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,2 @@
+// @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

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

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

@@ -0,0 +1,24 @@
+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

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1 @@
+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/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@lssm-tech/module.alpic",
+  "version": "3.7.29",
+  "description": "Alpic MCP and ChatGPT App hosting helpers",
+  "keywords": [
+    "contractspec",
+    "alpic",
+    "mcp",
+    "chatgpt-app",
+    "hosting",
+    "typescript"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "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:bundle": "contractspec-bun-build transpile",
+    "build:types": "contractspec-bun-build types",
+    "dev": "contractspec-bun-build dev",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "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"
+  },
+  "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"
+  },
+  "devDependencies": {
+    "@contractspec/tool.typescript": "3.7.13",
+    "typescript": "^5.9.3",
+    "@contractspec/tool.bun": "3.7.18"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./dist/index.js",
+      "node": "./dist/node/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "bun": "./dist/index.js",
+        "node": "./dist/node/index.js",
+        "default": "./dist/index.js"
+      }
+    },
+    "registry": "https://registry.npmjs.org"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/modules/alpic"
+  },
+  "homepage": "https://contractspec.io"
+}