@stacklink/sdk 0.2.0

package/LICENSE

@@ -0,0 +1,9 @@
+Copyright (c) 2026 Stacklink. All rights reserved.
+
+This software is proprietary. You may install and use it only to access
+Stacklink services under an agreement with Stacklink. You may not copy,
+modify, redistribute, sublicense, sell, or otherwise make this software
+available to another party except where your agreement with Stacklink
+expressly permits it.
+
+This notice must remain with every permitted copy.

package/README.md

@@ -0,0 +1,50 @@
+# Stacklink TypeScript SDK
+
+Stacklink supplies executable, governed tools to an agent harness. The selected harness owns the model call, tool loop, and final answer.
+
+Install the public Stacklink package with only the harness packages your application uses:
+
+```bash
+npm install @stacklink/sdk
+```
+
+The complete guides and certified recipes live at [docs.stacklink.in](https://docs.stacklink.in/docs/quickstart). npm is the package delivery system, not the primary documentation surface. Stacklink does not display registry download badges in its product or documentation.
+
+## Certified agent harnesses
+
+| Harness | Stacklink adapter | Supported language |
+|---|---|---|
+| Vercel AI SDK | `createStacklinkVercelTools(session)` from `@stacklink/sdk/vercel-ai` | TypeScript |
+| OpenAI Agents SDK | `createStacklinkOpenAIAgentsTools(session)` from `@stacklink/sdk/openai-agents` | TypeScript |
+| Claude Agent SDK | `createStacklinkClaudeAgentToolConfig(session)` from `@stacklink/sdk/claude-agent` | TypeScript |
+
+Every recipe follows the same lifecycle:
+
+```ts
+import { Stacklink } from '@stacklink/sdk';
+
+const stacklink = new Stacklink({
+  apiKey: process.env.STACKLINK_API_KEY,
+  baseUrl: process.env.STACKLINK_BASE_URL ?? 'https://api.stacklink.in',
+});
+
+const session = await stacklink.create({
+  tenantId: 'acme',
+  userId: 'user_123',
+  metaTools: { surface: 'connector' },
+});
+
+try {
+  // Pass the selected Stacklink adapter output to your agent harness.
+} finally {
+  await session.close();
+}
+```
+
+The complete Vercel, OpenAI Agents, and Claude Agent examples shown by the Stacklink Overview are generated from the executable files under `examples/sdk/`. The dashboard, documentation, and certification tests all read those same files.
+
+## Memory adapters are separate
+
+The `withStacklinkMemory` exports for Vercel AI SDK, the raw OpenAI client, and OpenAI Agents remain separate Memory integrations. They do not replace the agent-tool adapters above and are not part of basic Overview onboarding.
+
+Exact tested versions are published in `@stacklink/sdk/compatibility.json`. The SDK is proprietary and is provided under the applicable Stacklink agreement.

package/compatibility.json

@@ -0,0 +1,30 @@
+{
+  "schemaVersion": 1,
+  "sdkVersion": "0.2.0",
+  "node": ">=22.0.0",
+  "tested": {
+    "ai": "7.0.31",
+    "@ai-sdk/openai": "4.0.16",
+    "@openai/agents": "0.13.5",
+    "@anthropic-ai/claude-agent-sdk": "0.3.214"
+  },
+  "pythonTested": {
+    "openai-agents": "0.18.3",
+    "claude-agent-sdk": "0.2.122"
+  },
+  "supported": {
+    "ai": "^7.0.0",
+    "@ai-sdk/openai": "^4.0.0",
+    "@openai/agents": "^0.13.3",
+    "@anthropic-ai/claude-agent-sdk": "^0.3.214"
+  },
+  "pythonSupported": {
+    "openai-agents": ">=0.18,<0.19",
+    "claude-agent-sdk": ">=0.2,<0.3"
+  },
+  "adapters": {
+    "vercelAi": "@stacklink/sdk/vercel-ai",
+    "openaiAgents": "@stacklink/sdk/openai-agents",
+    "claudeAgent": "@stacklink/sdk/claude-agent"
+  }
+}

package/dist/src/domain/knowledge-meta-tools.d.ts

@@ -0,0 +1,12 @@
+export declare const knowledgeDefaultMetaTools: readonly ["KNOWLEDGE_LIST_PACKS", "KNOWLEDGE_GET_CAPABILITIES", "KNOWLEDGE_SEARCH", "KNOWLEDGE_LOOKUP_CITATION", "KNOWLEDGE_GET_AMENDMENT_TRAIL", "KNOWLEDGE_VERIFY_EVIDENCE", "KNOWLEDGE_VERIFY_ANSWER"];
+export declare const gstComplianceRuleMetaTools: readonly ["GST_GET_COMPLIANCE_RULE", "GST_GET_DUE_DATE_RULE", "GST_CALCULATE_DUE_DATE", "GST_GET_LATE_FEE_RULE", "GST_CALCULATE_LATE_FEE", "GST_GET_INTEREST_RULE", "GST_CALCULATE_INTEREST", "GST_LOOKUP_HSN_SAC_RATE", "GST_CHECK_RCM", "GST_GET_NOTICE_RULE", "GST_GET_APPEAL_STAGE_RULE"];
+export declare const businessComplianceKnowledgePackKey = "in.business_compliance.authority";
+export type KnowledgeMetaToolName = typeof knowledgeDefaultMetaTools[number] | typeof gstComplianceRuleMetaTools[number];
+export interface KnowledgePackSelection {
+    enable: string[];
+    disable: string[];
+}
+export declare function listKnowledgeMetaToolNames(input?: {
+    knowledgePacks?: KnowledgePackSelection | undefined;
+}): KnowledgeMetaToolName[];
+//# sourceMappingURL=knowledge-meta-tools.d.ts.map

package/dist/src/domain/knowledge-meta-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-meta-tools.d.ts","sourceRoot":"","sources":["../../../../../src/domain/knowledge-meta-tools.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,2MAQ5B,CAAC;AAEX,eAAO,MAAM,0BAA0B,+RAY7B,CAAC;AAEX,eAAO,MAAM,kCAAkC,qCAAqC,CAAC;AAErF,MAAM,MAAM,qBAAqB,GAC7B,OAAO,yBAAyB,CAAC,MAAM,CAAC,GACxC,OAAO,0BAA0B,CAAC,MAAM,CAAC,CAAC;AAE9C,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAgB,0BAA0B,CAAC,KAAK,GAAE;IAChD,cAAc,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;CAChD,GAAG,qBAAqB,EAAE,CAY/B"}

package/dist/src/domain/knowledge-meta-tools.js

@@ -0,0 +1,38 @@
+export const knowledgeDefaultMetaTools = [
+    'KNOWLEDGE_LIST_PACKS',
+    'KNOWLEDGE_GET_CAPABILITIES',
+    'KNOWLEDGE_SEARCH',
+    'KNOWLEDGE_LOOKUP_CITATION',
+    'KNOWLEDGE_GET_AMENDMENT_TRAIL',
+    'KNOWLEDGE_VERIFY_EVIDENCE',
+    'KNOWLEDGE_VERIFY_ANSWER',
+];
+export const gstComplianceRuleMetaTools = [
+    'GST_GET_COMPLIANCE_RULE',
+    'GST_GET_DUE_DATE_RULE',
+    'GST_CALCULATE_DUE_DATE',
+    'GST_GET_LATE_FEE_RULE',
+    'GST_CALCULATE_LATE_FEE',
+    'GST_GET_INTEREST_RULE',
+    'GST_CALCULATE_INTEREST',
+    'GST_LOOKUP_HSN_SAC_RATE',
+    'GST_CHECK_RCM',
+    'GST_GET_NOTICE_RULE',
+    'GST_GET_APPEAL_STAGE_RULE',
+];
+export const businessComplianceKnowledgePackKey = 'in.business_compliance.authority';
+export function listKnowledgeMetaToolNames(input = {}) {
+    const selection = input.knowledgePacks;
+    if (!selection || selection.enable.length === 0)
+        return [];
+    const enabledPackKeys = selection.enable.filter((packKey) => !selection.disable.includes(packKey));
+    const exposesAllTools = enabledPackKeys.includes('enabled-by-session');
+    const hasKnowledgePack = enabledPackKeys.length > 0;
+    const businessComplianceEnabled = enabledPackKeys.includes(businessComplianceKnowledgePackKey);
+    const names = exposesAllTools || hasKnowledgePack ? [...knowledgeDefaultMetaTools] : [];
+    if (exposesAllTools || businessComplianceEnabled) {
+        names.push(...gstComplianceRuleMetaTools);
+    }
+    return names;
+}
+//# sourceMappingURL=knowledge-meta-tools.js.map

package/dist/src/domain/knowledge-meta-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-meta-tools.js","sourceRoot":"","sources":["../../../../../src/domain/knowledge-meta-tools.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,sBAAsB;IACtB,4BAA4B;IAC5B,kBAAkB;IAClB,2BAA2B;IAC3B,+BAA+B;IAC/B,2BAA2B;IAC3B,yBAAyB;CACjB,CAAC;AAEX,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,yBAAyB;IACzB,uBAAuB;IACvB,wBAAwB;IACxB,uBAAuB;IACvB,wBAAwB;IACxB,uBAAuB;IACvB,wBAAwB;IACxB,yBAAyB;IACzB,eAAe;IACf,qBAAqB;IACrB,2BAA2B;CACnB,CAAC;AAEX,MAAM,CAAC,MAAM,kCAAkC,GAAG,kCAAkC,CAAC;AAWrF,MAAM,UAAU,0BAA0B,CAAC,QAEvC,EAAE;IACJ,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,CAAC;IACvC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3D,MAAM,eAAe,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;IACnG,MAAM,eAAe,GAAG,eAAe,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IACvE,MAAM,gBAAgB,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;IACpD,MAAM,yBAAyB,GAAG,eAAe,CAAC,QAAQ,CAAC,kCAAkC,CAAC,CAAC;IAC/F,MAAM,KAAK,GAA4B,eAAe,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAAG,yBAAyB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACjH,IAAI,eAAe,IAAI,yBAAyB,EAAE,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,GAAG,0BAA0B,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}