@contractspec/example.integration-hub 3.8.9 → 3.8.10

package/dist/node/integration-hub.feature.js

@@ -1,330 +1 @@
-// src/visualizations/catalog.ts
-import {
-  defineVisualization,
-  VisualizationRegistry
-} from "@contractspec/lib.contracts-spec/visualizations";
-var INTEGRATION_LIST_REF = {
-  key: "integration.list",
-  version: "1.0.0"
-};
-var CONNECTION_LIST_REF = {
-  key: "integration.connection.list",
-  version: "1.0.0"
-};
-var SYNC_CONFIG_REF = {
-  key: "integration.syncConfig.list",
-  version: "1.0.0"
-};
-var META = {
-  version: "1.0.0",
-  domain: "integration",
-  stability: "experimental",
-  owners: ["@example.integration-hub"],
-  tags: ["integration", "visualization", "sync"]
-};
-var IntegrationTypeVisualization = defineVisualization({
-  meta: {
-    ...META,
-    key: "integration-hub.visualization.integration-types",
-    title: "Integration Types",
-    description: "Distribution of configured integration categories.",
-    goal: "Show where integration coverage is concentrated.",
-    context: "Integration overview."
-  },
-  source: { primary: INTEGRATION_LIST_REF, resultPath: "data" },
-  visualization: {
-    kind: "pie",
-    nameDimension: "type",
-    valueMeasure: "count",
-    dimensions: [
-      { key: "type", label: "Type", dataPath: "type", type: "category" }
-    ],
-    measures: [
-      { key: "count", label: "Count", dataPath: "count", format: "number" }
-    ],
-    table: { caption: "Integration counts by type." }
-  }
-});
-var ConnectionStatusVisualization = defineVisualization({
-  meta: {
-    ...META,
-    key: "integration-hub.visualization.connection-status",
-    title: "Connection Status",
-    description: "Status distribution across configured connections.",
-    goal: "Highlight connection health and instability.",
-    context: "Connection monitoring."
-  },
-  source: { primary: CONNECTION_LIST_REF, resultPath: "data" },
-  visualization: {
-    kind: "cartesian",
-    variant: "bar",
-    xDimension: "status",
-    yMeasures: ["count"],
-    dimensions: [
-      { key: "status", label: "Status", dataPath: "status", type: "category" }
-    ],
-    measures: [
-      {
-        key: "count",
-        label: "Connections",
-        dataPath: "count",
-        format: "number",
-        color: "#1d4ed8"
-      }
-    ],
-    table: { caption: "Connection counts by status." }
-  }
-});
-var HealthySyncMetricVisualization = defineVisualization({
-  meta: {
-    ...META,
-    key: "integration-hub.visualization.sync-healthy",
-    title: "Healthy Syncs",
-    description: "Sync configurations currently healthy or recently successful.",
-    goal: "Summarize healthy synchronization capacity.",
-    context: "Sync-state comparison."
-  },
-  source: { primary: SYNC_CONFIG_REF, resultPath: "data" },
-  visualization: {
-    kind: "metric",
-    measure: "value",
-    measures: [
-      { key: "value", label: "Syncs", dataPath: "value", format: "number" }
-    ],
-    table: { caption: "Healthy sync count." }
-  }
-});
-var AttentionSyncMetricVisualization = defineVisualization({
-  meta: {
-    ...META,
-    key: "integration-hub.visualization.sync-attention",
-    title: "Attention Needed",
-    description: "Sync configurations paused, failing, or otherwise needing review.",
-    goal: "Summarize syncs needing action.",
-    context: "Sync-state comparison."
-  },
-  source: { primary: SYNC_CONFIG_REF, resultPath: "data" },
-  visualization: {
-    kind: "metric",
-    measure: "value",
-    measures: [
-      { key: "value", label: "Syncs", dataPath: "value", format: "number" }
-    ],
-    table: { caption: "Syncs requiring attention." }
-  }
-});
-var IntegrationVisualizationSpecs = [
-  IntegrationTypeVisualization,
-  ConnectionStatusVisualization,
-  HealthySyncMetricVisualization,
-  AttentionSyncMetricVisualization
-];
-var IntegrationVisualizationRegistry = new VisualizationRegistry([
-  ...IntegrationVisualizationSpecs
-]);
-var IntegrationVisualizationRefs = IntegrationVisualizationSpecs.map((spec) => ({
-  key: spec.meta.key,
-  version: spec.meta.version
-}));
-
-// src/visualizations/selectors.ts
-function isHealthySync(status) {
-  return status === "ACTIVE" || status === "SUCCESS";
-}
-function createIntegrationVisualizationSections(integrations, connections, syncConfigs) {
-  const integrationTypes = new Map;
-  const connectionStatuses = new Map;
-  let healthySyncs = 0;
-  let attentionSyncs = 0;
-  for (const integration of integrations) {
-    integrationTypes.set(integration.type, (integrationTypes.get(integration.type) ?? 0) + 1);
-  }
-  for (const connection of connections) {
-    connectionStatuses.set(connection.status, (connectionStatuses.get(connection.status) ?? 0) + 1);
-  }
-  for (const syncConfig of syncConfigs) {
-    if (isHealthySync(syncConfig.status)) {
-      healthySyncs += 1;
-    } else {
-      attentionSyncs += 1;
-    }
-  }
-  const primaryItems = [
-    {
-      key: "integration-types",
-      spec: IntegrationTypeVisualization,
-      data: {
-        data: Array.from(integrationTypes.entries()).map(([type, count]) => ({
-          type,
-          count
-        }))
-      },
-      title: "Integration Types",
-      description: "Configured integrations grouped by category.",
-      height: 260
-    },
-    {
-      key: "connection-status",
-      spec: ConnectionStatusVisualization,
-      data: {
-        data: Array.from(connectionStatuses.entries()).map(([status, count]) => ({
-          status,
-          count
-        }))
-      },
-      title: "Connection Status",
-      description: "Operational health across current connections."
-    }
-  ];
-  const comparisonItems = [
-    {
-      key: "healthy-syncs",
-      spec: HealthySyncMetricVisualization,
-      data: { data: [{ value: healthySyncs }] },
-      title: "Healthy Syncs",
-      description: "Active or recently successful sync configurations.",
-      height: 200
-    },
-    {
-      key: "attention-syncs",
-      spec: AttentionSyncMetricVisualization,
-      data: { data: [{ value: attentionSyncs }] },
-      title: "Attention Needed",
-      description: "Paused, failed, or degraded sync configurations.",
-      height: 200
-    }
-  ];
-  return {
-    primaryItems,
-    comparisonItems
-  };
-}
-// src/integration-hub.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var IntegrationHubFeature = defineFeature({
-  meta: {
-    key: "integration-hub",
-    version: "1.0.0",
-    title: "Integration Hub",
-    description: "Connect and sync data with external systems through configurable integrations",
-    domain: "integration",
-    owners: ["@integration-team"],
-    tags: ["integration", "sync", "etl", "connectors"],
-    stability: "experimental"
-  },
-  operations: [
-    { key: "integration.create", version: "1.0.0" },
-    { key: "integration.connection.create", version: "1.0.0" },
-    { key: "integration.syncConfig.create", version: "1.0.0" },
-    { key: "integration.fieldMapping.add", version: "1.0.0" },
-    { key: "integration.sync.trigger", version: "1.0.0" },
-    { key: "integration.syncRun.list", version: "1.0.0" }
-  ],
-  events: [
-    { key: "integration.created", version: "1.0.0" },
-    { key: "integration.connection.created", version: "1.0.0" },
-    { key: "integration.connection.statusChanged", version: "1.0.0" },
-    { key: "integration.syncConfig.created", version: "1.0.0" },
-    { key: "integration.sync.started", version: "1.0.0" },
-    { key: "integration.sync.completed", version: "1.0.0" },
-    { key: "integration.sync.failed", version: "1.0.0" },
-    { key: "integration.record.synced", version: "1.0.0" },
-    { key: "integration.fieldMapping.added", version: "1.0.0" }
-  ],
-  presentations: [
-    { key: "integration.list", version: "1.0.0" },
-    { key: "integration.detail", version: "1.0.0" },
-    { key: "integration.connection.list", version: "1.0.0" },
-    { key: "integration.connection.setup", version: "1.0.0" },
-    { key: "integration.syncConfig.list", version: "1.0.0" },
-    { key: "integration.syncConfig.editor", version: "1.0.0" },
-    { key: "integration.fieldMapping.editor", version: "1.0.0" },
-    { key: "integration.syncRun.viewList", version: "1.0.0" },
-    { key: "integration.syncRun.detail", version: "1.0.0" },
-    { key: "integration.health", version: "1.0.0" },
-    { key: "integration.sync.activity", version: "1.0.0" }
-  ],
-  opToPresentation: [
-    {
-      op: { key: "integration.syncConfig.create", version: "1.0.0" },
-      pres: { key: "integration.syncConfig.editor", version: "1.0.0" }
-    },
-    {
-      op: { key: "integration.fieldMapping.add", version: "1.0.0" },
-      pres: { key: "integration.fieldMapping.editor", version: "1.0.0" }
-    },
-    {
-      op: { key: "integration.syncRun.list", version: "1.0.0" },
-      pres: { key: "integration.syncRun.viewList", version: "1.0.0" }
-    }
-  ],
-  presentationsTargets: [
-    {
-      key: "integration.list",
-      version: "1.0.0",
-      targets: ["react", "markdown"]
-    },
-    {
-      key: "integration.detail",
-      version: "1.0.0",
-      targets: ["react", "markdown"]
-    },
-    {
-      key: "integration.syncConfig.list",
-      version: "1.0.0",
-      targets: ["react", "markdown"]
-    },
-    {
-      key: "integration.syncConfig.editor",
-      version: "1.0.0",
-      targets: ["react"]
-    },
-    {
-      key: "integration.fieldMapping.editor",
-      version: "1.0.0",
-      targets: ["react"]
-    },
-    {
-      key: "integration.syncRun.viewList",
-      version: "1.0.0",
-      targets: ["react", "markdown"]
-    },
-    {
-      key: "integration.syncRun.detail",
-      version: "1.0.0",
-      targets: ["react", "markdown"]
-    }
-  ],
-  visualizations: IntegrationVisualizationRefs,
-  capabilities: {
-    requires: [
-      { key: "identity", version: "1.0.0" },
-      { key: "audit-trail", version: "1.0.0" },
-      { key: "feature-flags", version: "1.0.0" },
-      { key: "jobs", version: "1.0.0" },
-      { key: "files", version: "1.0.0" }
-    ],
-    provides: [
-      { key: "integration", version: "1.0.0" },
-      { key: "sync", version: "1.0.0" },
-      { key: "etl", version: "1.0.0" }
-    ]
-  },
-  integrations: [
-    { key: "integration-hub.integration.default-connector", version: "1.0.0" }
-  ],
-  telemetry: [{ key: "integration-hub.telemetry", version: "1.0.0" }],
-  jobs: [
-    { key: "integration-hub.job.sync-run", version: "1.0.0" },
-    { key: "integration-hub.job.health-check", version: "1.0.0" }
-  ],
-  docs: [
-    "docs.examples.integration-hub",
-    "docs.examples.integration-hub.goal",
-    "docs.examples.integration-hub.usage",
-    "docs.examples.integration-hub.constraints"
-  ]
-});
-export {
-  IntegrationHubFeature
-};
+import{defineVisualization as j,VisualizationRegistry as v}from"@contractspec/lib.contracts-spec/visualizations";var L={key:"integration.list",version:"1.0.0"},Y={key:"integration.connection.list",version:"1.0.0"},W={key:"integration.syncConfig.list",version:"1.0.0"},k={version:"1.0.0",domain:"integration",stability:"experimental",owners:["@example.integration-hub"],tags:["integration","visualization","sync"]},D=j({meta:{...k,key:"integration-hub.visualization.integration-types",title:"Integration Types",description:"Distribution of configured integration categories.",goal:"Show where integration coverage is concentrated.",context:"Integration overview."},source:{primary:L,resultPath:"data"},visualization:{kind:"pie",nameDimension:"type",valueMeasure:"count",dimensions:[{key:"type",label:"Type",dataPath:"type",type:"category"}],measures:[{key:"count",label:"Count",dataPath:"count",format:"number"}],table:{caption:"Integration counts by type."}}}),J=j({meta:{...k,key:"integration-hub.visualization.connection-status",title:"Connection Status",description:"Status distribution across configured connections.",goal:"Highlight connection health and instability.",context:"Connection monitoring."},source:{primary:Y,resultPath:"data"},visualization:{kind:"cartesian",variant:"bar",xDimension:"status",yMeasures:["count"],dimensions:[{key:"status",label:"Status",dataPath:"status",type:"category"}],measures:[{key:"count",label:"Connections",dataPath:"count",format:"number",color:"#1d4ed8"}],table:{caption:"Connection counts by status."}}}),K=j({meta:{...k,key:"integration-hub.visualization.sync-healthy",title:"Healthy Syncs",description:"Sync configurations currently healthy or recently successful.",goal:"Summarize healthy synchronization capacity.",context:"Sync-state comparison."},source:{primary:W,resultPath:"data"},visualization:{kind:"metric",measure:"value",measures:[{key:"value",label:"Syncs",dataPath:"value",format:"number"}],table:{caption:"Healthy sync count."}}}),P=j({meta:{...k,key:"integration-hub.visualization.sync-attention",title:"Attention Needed",description:"Sync configurations paused, failing, or otherwise needing review.",goal:"Summarize syncs needing action.",context:"Sync-state comparison."},source:{primary:W,resultPath:"data"},visualization:{kind:"metric",measure:"value",measures:[{key:"value",label:"Syncs",dataPath:"value",format:"number"}],table:{caption:"Syncs requiring attention."}}}),X=[D,J,K,P],f=new v([...X]),Z=X.map((x)=>({key:x.meta.key,version:x.meta.version}));function G(x){return x==="ACTIVE"||x==="SUCCESS"}function F(x,$,b){let q=new Map,w=new Map,Q=0,U=0;for(let m of x)q.set(m.type,(q.get(m.type)??0)+1);for(let m of $)w.set(m.status,(w.get(m.status)??0)+1);for(let m of b)if(G(m.status))Q+=1;else U+=1;return{primaryItems:[{key:"integration-types",spec:D,data:{data:Array.from(q.entries()).map(([m,B])=>({type:m,count:B}))},title:"Integration Types",description:"Configured integrations grouped by category.",height:260},{key:"connection-status",spec:J,data:{data:Array.from(w.entries()).map(([m,B])=>({status:m,count:B}))},title:"Connection Status",description:"Operational health across current connections."}],comparisonItems:[{key:"healthy-syncs",spec:K,data:{data:[{value:Q}]},title:"Healthy Syncs",description:"Active or recently successful sync configurations.",height:200},{key:"attention-syncs",spec:P,data:{data:[{value:U}]},title:"Attention Needed",description:"Paused, failed, or degraded sync configurations.",height:200}]}}import{defineFeature as H}from"@contractspec/lib.contracts-spec";var p=H({meta:{key:"integration-hub",version:"1.0.0",title:"Integration Hub",description:"Connect and sync data with external systems through configurable integrations",domain:"integration",owners:["@integration-team"],tags:["integration","sync","etl","connectors"],stability:"experimental"},operations:[{key:"integration.create",version:"1.0.0"},{key:"integration.connection.create",version:"1.0.0"},{key:"integration.syncConfig.create",version:"1.0.0"},{key:"integration.fieldMapping.add",version:"1.0.0"},{key:"integration.sync.trigger",version:"1.0.0"},{key:"integration.syncRun.list",version:"1.0.0"}],events:[{key:"integration.created",version:"1.0.0"},{key:"integration.connection.created",version:"1.0.0"},{key:"integration.connection.statusChanged",version:"1.0.0"},{key:"integration.syncConfig.created",version:"1.0.0"},{key:"integration.sync.started",version:"1.0.0"},{key:"integration.sync.completed",version:"1.0.0"},{key:"integration.sync.failed",version:"1.0.0"},{key:"integration.record.synced",version:"1.0.0"},{key:"integration.fieldMapping.added",version:"1.0.0"}],presentations:[{key:"integration.list",version:"1.0.0"},{key:"integration.detail",version:"1.0.0"},{key:"integration.connection.list",version:"1.0.0"},{key:"integration.connection.setup",version:"1.0.0"},{key:"integration.syncConfig.list",version:"1.0.0"},{key:"integration.syncConfig.editor",version:"1.0.0"},{key:"integration.fieldMapping.editor",version:"1.0.0"},{key:"integration.syncRun.viewList",version:"1.0.0"},{key:"integration.syncRun.detail",version:"1.0.0"},{key:"integration.health",version:"1.0.0"},{key:"integration.sync.activity",version:"1.0.0"}],opToPresentation:[{op:{key:"integration.syncConfig.create",version:"1.0.0"},pres:{key:"integration.syncConfig.editor",version:"1.0.0"}},{op:{key:"integration.fieldMapping.add",version:"1.0.0"},pres:{key:"integration.fieldMapping.editor",version:"1.0.0"}},{op:{key:"integration.syncRun.list",version:"1.0.0"},pres:{key:"integration.syncRun.viewList",version:"1.0.0"}}],presentationsTargets:[{key:"integration.list",version:"1.0.0",targets:["react","markdown"]},{key:"integration.detail",version:"1.0.0",targets:["react","markdown"]},{key:"integration.syncConfig.list",version:"1.0.0",targets:["react","markdown"]},{key:"integration.syncConfig.editor",version:"1.0.0",targets:["react"]},{key:"integration.fieldMapping.editor",version:"1.0.0",targets:["react"]},{key:"integration.syncRun.viewList",version:"1.0.0",targets:["react","markdown"]},{key:"integration.syncRun.detail",version:"1.0.0",targets:["react","markdown"]}],visualizations:Z,capabilities:{requires:[{key:"identity",version:"1.0.0"},{key:"audit-trail",version:"1.0.0"},{key:"feature-flags",version:"1.0.0"},{key:"jobs",version:"1.0.0"},{key:"files",version:"1.0.0"}],provides:[{key:"integration",version:"1.0.0"},{key:"sync",version:"1.0.0"},{key:"etl",version:"1.0.0"}]},integrations:[{key:"integration-hub.integration.default-connector",version:"1.0.0"}],telemetry:[{key:"integration-hub.telemetry",version:"1.0.0"}],jobs:[{key:"integration-hub.job.sync-run",version:"1.0.0"},{key:"integration-hub.job.health-check",version:"1.0.0"}],docs:["docs.examples.integration-hub","docs.examples.integration-hub.goal","docs.examples.integration-hub.usage","docs.examples.integration-hub.constraints"]});export{p as IntegrationHubFeature};

package/dist/node/mcp-example.js

@@ -1,154 +1 @@
-// src/mcp-example.ts
-import {
-  createMcpToolsets
-} from "@contractspec/lib.ai-agent/tools/mcp-client";
-import { randomUUID } from "crypto";
-var DEFAULT_STDIO_ARGS = [
-  "-y",
-  "@modelcontextprotocol/server-filesystem",
-  "."
-];
-async function runIntegrationHubMcpExampleFromEnv() {
-  const mode = resolveMode();
-  const transport = resolveTransport();
-  const config = buildMcpConfigFromEnv();
-  const toolset = await createMcpToolsets([config], {
-    onNameCollision: "error"
-  });
-  try {
-    const toolNames = Object.keys(toolset.tools).sort();
-    const output = {
-      mode,
-      server: {
-        name: config.name,
-        transport
-      },
-      authMethod: process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_AUTH_METHOD,
-      apiVersion: process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_API_VERSION,
-      tools: toolNames
-    };
-    if (mode === "call") {
-      const toolName = requireEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_NAME");
-      const toolArgs = parseRecordEnvOrDefault("CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_ARGS_JSON", {});
-      const tool = toolset.tools[toolName];
-      if (!tool?.execute) {
-        throw new Error(`Tool "${toolName}" was not found. Available tools: ${toolNames.join(", ")}`);
-      }
-      const toolOutput = await tool.execute(toolArgs, {
-        toolCallId: `integration-hub-${randomUUID()}`,
-        messages: []
-      });
-      output.toolCall = {
-        name: toolName,
-        args: toolArgs,
-        output: toolOutput
-      };
-    }
-    return output;
-  } finally {
-    await toolset.cleanup().catch(() => {
-      return;
-    });
-  }
-}
-function buildMcpConfigFromEnv() {
-  const name = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_NAME ?? "filesystem";
-  const transport = resolveTransport();
-  const toolPrefix = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_PREFIX;
-  if (transport === "stdio") {
-    return {
-      name,
-      transport,
-      command: process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_COMMAND ?? "npx",
-      args: parseStringArrayEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_ARGS_JSON", DEFAULT_STDIO_ARGS),
-      toolPrefix
-    };
-  }
-  const accessToken = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN;
-  const accessTokenEnvVar = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN_ENV;
-  const mcpTransport = transport === "webhook" || transport === "http" ? "http" : "sse";
-  return {
-    name,
-    transport: mcpTransport,
-    url: requireEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_URL"),
-    headers: parseStringRecordEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_HEADERS_JSON"),
-    accessToken,
-    accessTokenEnvVar,
-    toolPrefix
-  };
-}
-function resolveMode() {
-  const rawMode = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE?.toLowerCase() ?? "list";
-  if (rawMode === "list" || rawMode === "call") {
-    return rawMode;
-  }
-  throw new Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE: ${rawMode}. Use "list" or "call".`);
-}
-function resolveTransport() {
-  const rawTransport = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT?.toLowerCase() ?? "stdio";
-  if (rawTransport === "stdio" || rawTransport === "http" || rawTransport === "sse" || rawTransport === "webhook") {
-    return rawTransport;
-  }
-  throw new Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT: ${rawTransport}. Use "stdio", "http", "sse", or "webhook".`);
-}
-function parseStringArrayEnv(key, fallback) {
-  const raw = process.env[key];
-  if (!raw) {
-    return fallback;
-  }
-  const parsed = parseJsonEnv(key);
-  if (!Array.isArray(parsed) || parsed.some((value) => typeof value !== "string")) {
-    throw new Error(`${key} must be a JSON string array.`);
-  }
-  return parsed;
-}
-function parseRecordEnv(key) {
-  const raw = process.env[key];
-  if (!raw) {
-    return;
-  }
-  const parsed = parseJsonEnv(key);
-  if (!isRecord(parsed)) {
-    throw new Error(`${key} must be a JSON object.`);
-  }
-  return parsed;
-}
-function parseRecordEnvOrDefault(key, fallback) {
-  return parseRecordEnv(key) ?? fallback;
-}
-function parseStringRecordEnv(key) {
-  const parsed = parseRecordEnv(key);
-  if (!parsed) {
-    return;
-  }
-  const entries = Object.entries(parsed);
-  const invalidEntry = entries.find(([, value]) => typeof value !== "string");
-  if (invalidEntry) {
-    throw new Error(`${key} must contain only string values.`);
-  }
-  return Object.fromEntries(entries);
-}
-function parseJsonEnv(key) {
-  const raw = process.env[key];
-  if (!raw) {
-    return;
-  }
-  try {
-    return JSON.parse(raw);
-  } catch {
-    throw new Error(`${key} contains invalid JSON.`);
-  }
-}
-function requireEnv(key) {
-  const value = process.env[key];
-  if (!value) {
-    throw new Error(`Missing required env var: ${key}`);
-  }
-  return value;
-}
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-export {
-  runIntegrationHubMcpExampleFromEnv
-};
+import{createMcpToolsets as L}from"@contractspec/lib.ai-agent/tools/mcp-client";import{randomUUID as V}from"crypto";var q=["-y","@modelcontextprotocol/server-filesystem","."];async function D(){let h=F(),j=Y(),z=x(),B=await L([z],{onNameCollision:"error"});try{let H=Object.keys(B.tools).sort(),K={mode:h,server:{name:z.name,transport:j},authMethod:process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_AUTH_METHOD,apiVersion:process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_API_VERSION,tools:H};if(h==="call"){let Q=C("CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_NAME"),W=J("CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_ARGS_JSON",{}),X=B.tools[Q];if(!X?.execute)throw Error(`Tool "${Q}" was not found. Available tools: ${H.join(", ")}`);let G=await X.execute(W,{toolCallId:`integration-hub-${V()}`,messages:[]});K.toolCall={name:Q,args:W,output:G}}return K}finally{await B.cleanup().catch(()=>{return})}}function x(){let h=process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_NAME??"filesystem",j=Y(),z=process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_PREFIX;if(j==="stdio")return{name:h,transport:j,command:process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_COMMAND??"npx",args:I("CONTRACTSPEC_INTEGRATION_HUB_MCP_ARGS_JSON",q),toolPrefix:z};let B=process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN,H=process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN_ENV;return{name:h,transport:j==="webhook"||j==="http"?"http":"sse",url:C("CONTRACTSPEC_INTEGRATION_HUB_MCP_URL"),headers:P("CONTRACTSPEC_INTEGRATION_HUB_MCP_HEADERS_JSON"),accessToken:B,accessTokenEnvVar:H,toolPrefix:z}}function F(){let h=process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE?.toLowerCase()??"list";if(h==="list"||h==="call")return h;throw Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE: ${h}. Use "list" or "call".`)}function Y(){let h=process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT?.toLowerCase()??"stdio";if(h==="stdio"||h==="http"||h==="sse"||h==="webhook")return h;throw Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT: ${h}. Use "stdio", "http", "sse", or "webhook".`)}function I(h,j){if(!process.env[h])return j;let B=$(h);if(!Array.isArray(B)||B.some((H)=>typeof H!=="string"))throw Error(`${h} must be a JSON string array.`);return B}function Z(h){if(!process.env[h])return;let z=$(h);if(!_(z))throw Error(`${h} must be a JSON object.`);return z}function J(h,j){return Z(h)??j}function P(h){let j=Z(h);if(!j)return;let z=Object.entries(j);if(z.find(([,H])=>typeof H!=="string"))throw Error(`${h} must contain only string values.`);return Object.fromEntries(z)}function $(h){let j=process.env[h];if(!j)return;try{return JSON.parse(j)}catch{throw Error(`${h} contains invalid JSON.`)}}function C(h){let j=process.env[h];if(!j)throw Error(`Missing required env var: ${h}`);return j}function _(h){return typeof h==="object"&&h!==null&&!Array.isArray(h)}export{D as runIntegrationHubMcpExampleFromEnv};

package/dist/node/run-mcp.js

@@ -1,159 +1 @@
-// src/mcp-example.ts
-import {
-  createMcpToolsets
-} from "@contractspec/lib.ai-agent/tools/mcp-client";
-import { randomUUID } from "crypto";
-var DEFAULT_STDIO_ARGS = [
-  "-y",
-  "@modelcontextprotocol/server-filesystem",
-  "."
-];
-async function runIntegrationHubMcpExampleFromEnv() {
-  const mode = resolveMode();
-  const transport = resolveTransport();
-  const config = buildMcpConfigFromEnv();
-  const toolset = await createMcpToolsets([config], {
-    onNameCollision: "error"
-  });
-  try {
-    const toolNames = Object.keys(toolset.tools).sort();
-    const output = {
-      mode,
-      server: {
-        name: config.name,
-        transport
-      },
-      authMethod: process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_AUTH_METHOD,
-      apiVersion: process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_API_VERSION,
-      tools: toolNames
-    };
-    if (mode === "call") {
-      const toolName = requireEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_NAME");
-      const toolArgs = parseRecordEnvOrDefault("CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_ARGS_JSON", {});
-      const tool = toolset.tools[toolName];
-      if (!tool?.execute) {
-        throw new Error(`Tool "${toolName}" was not found. Available tools: ${toolNames.join(", ")}`);
-      }
-      const toolOutput = await tool.execute(toolArgs, {
-        toolCallId: `integration-hub-${randomUUID()}`,
-        messages: []
-      });
-      output.toolCall = {
-        name: toolName,
-        args: toolArgs,
-        output: toolOutput
-      };
-    }
-    return output;
-  } finally {
-    await toolset.cleanup().catch(() => {
-      return;
-    });
-  }
-}
-function buildMcpConfigFromEnv() {
-  const name = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_NAME ?? "filesystem";
-  const transport = resolveTransport();
-  const toolPrefix = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_PREFIX;
-  if (transport === "stdio") {
-    return {
-      name,
-      transport,
-      command: process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_COMMAND ?? "npx",
-      args: parseStringArrayEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_ARGS_JSON", DEFAULT_STDIO_ARGS),
-      toolPrefix
-    };
-  }
-  const accessToken = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN;
-  const accessTokenEnvVar = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN_ENV;
-  const mcpTransport = transport === "webhook" || transport === "http" ? "http" : "sse";
-  return {
-    name,
-    transport: mcpTransport,
-    url: requireEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_URL"),
-    headers: parseStringRecordEnv("CONTRACTSPEC_INTEGRATION_HUB_MCP_HEADERS_JSON"),
-    accessToken,
-    accessTokenEnvVar,
-    toolPrefix
-  };
-}
-function resolveMode() {
-  const rawMode = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE?.toLowerCase() ?? "list";
-  if (rawMode === "list" || rawMode === "call") {
-    return rawMode;
-  }
-  throw new Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE: ${rawMode}. Use "list" or "call".`);
-}
-function resolveTransport() {
-  const rawTransport = process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT?.toLowerCase() ?? "stdio";
-  if (rawTransport === "stdio" || rawTransport === "http" || rawTransport === "sse" || rawTransport === "webhook") {
-    return rawTransport;
-  }
-  throw new Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT: ${rawTransport}. Use "stdio", "http", "sse", or "webhook".`);
-}
-function parseStringArrayEnv(key, fallback) {
-  const raw = process.env[key];
-  if (!raw) {
-    return fallback;
-  }
-  const parsed = parseJsonEnv(key);
-  if (!Array.isArray(parsed) || parsed.some((value) => typeof value !== "string")) {
-    throw new Error(`${key} must be a JSON string array.`);
-  }
-  return parsed;
-}
-function parseRecordEnv(key) {
-  const raw = process.env[key];
-  if (!raw) {
-    return;
-  }
-  const parsed = parseJsonEnv(key);
-  if (!isRecord(parsed)) {
-    throw new Error(`${key} must be a JSON object.`);
-  }
-  return parsed;
-}
-function parseRecordEnvOrDefault(key, fallback) {
-  return parseRecordEnv(key) ?? fallback;
-}
-function parseStringRecordEnv(key) {
-  const parsed = parseRecordEnv(key);
-  if (!parsed) {
-    return;
-  }
-  const entries = Object.entries(parsed);
-  const invalidEntry = entries.find(([, value]) => typeof value !== "string");
-  if (invalidEntry) {
-    throw new Error(`${key} must contain only string values.`);
-  }
-  return Object.fromEntries(entries);
-}
-function parseJsonEnv(key) {
-  const raw = process.env[key];
-  if (!raw) {
-    return;
-  }
-  try {
-    return JSON.parse(raw);
-  } catch {
-    throw new Error(`${key} contains invalid JSON.`);
-  }
-}
-function requireEnv(key) {
-  const value = process.env[key];
-  if (!value) {
-    throw new Error(`Missing required env var: ${key}`);
-  }
-  return value;
-}
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-// src/run-mcp.ts
-runIntegrationHubMcpExampleFromEnv().then((result) => {
-  console.log(JSON.stringify(result, null, 2));
-}).catch((error) => {
-  console.error(error);
-  process.exitCode = 1;
-});
+import{createMcpToolsets as V}from"@contractspec/lib.ai-agent/tools/mcp-client";import{randomUUID as q}from"crypto";var J=["-y","@modelcontextprotocol/server-filesystem","."];async function Z(){let h=_(),j=$(),z=P(),B=await V([z],{onNameCollision:"error"});try{let K=Object.keys(B.tools).sort(),Q={mode:h,server:{name:z.name,transport:j},authMethod:process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_AUTH_METHOD,apiVersion:process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_API_VERSION,tools:K};if(h==="call"){let W=H("CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_NAME"),X=F("CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_ARGS_JSON",{}),Y=B.tools[W];if(!Y?.execute)throw Error(`Tool "${W}" was not found. Available tools: ${K.join(", ")}`);let L=await Y.execute(X,{toolCallId:`integration-hub-${q()}`,messages:[]});Q.toolCall={name:W,args:X,output:L}}return Q}finally{await B.cleanup().catch(()=>{return})}}function P(){let h=process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_NAME??"filesystem",j=$(),z=process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TOOL_PREFIX;if(j==="stdio")return{name:h,transport:j,command:process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_COMMAND??"npx",args:x("CONTRACTSPEC_INTEGRATION_HUB_MCP_ARGS_JSON",J),toolPrefix:z};let B=process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN,K=process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_ACCESS_TOKEN_ENV;return{name:h,transport:j==="webhook"||j==="http"?"http":"sse",url:H("CONTRACTSPEC_INTEGRATION_HUB_MCP_URL"),headers:I("CONTRACTSPEC_INTEGRATION_HUB_MCP_HEADERS_JSON"),accessToken:B,accessTokenEnvVar:K,toolPrefix:z}}function _(){let h=process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE?.toLowerCase()??"list";if(h==="list"||h==="call")return h;throw Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_MODE: ${h}. Use "list" or "call".`)}function $(){let h=process.env.CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT?.toLowerCase()??"stdio";if(h==="stdio"||h==="http"||h==="sse"||h==="webhook")return h;throw Error(`Unsupported CONTRACTSPEC_INTEGRATION_HUB_MCP_TRANSPORT: ${h}. Use "stdio", "http", "sse", or "webhook".`)}function x(h,j){if(!process.env[h])return j;let B=G(h);if(!Array.isArray(B)||B.some((K)=>typeof K!=="string"))throw Error(`${h} must be a JSON string array.`);return B}function C(h){if(!process.env[h])return;let z=G(h);if(!O(z))throw Error(`${h} must be a JSON object.`);return z}function F(h,j){return C(h)??j}function I(h){let j=C(h);if(!j)return;let z=Object.entries(j);if(z.find(([,K])=>typeof K!=="string"))throw Error(`${h} must contain only string values.`);return Object.fromEntries(z)}function G(h){let j=process.env[h];if(!j)return;try{return JSON.parse(j)}catch{throw Error(`${h} contains invalid JSON.`)}}function H(h){let j=process.env[h];if(!j)throw Error(`Missing required env var: ${h}`);return j}function O(h){return typeof h==="object"&&h!==null&&!Array.isArray(h)}Z().then((h)=>{console.log(JSON.stringify(h,null,2))}).catch((h)=>{console.error(h),process.exitCode=1});