@5ss/ai-tools 3.5.1 → 3.6.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@5ss/ai-tools` are documented here.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Releases are cut by [semantic-release](https://semantic-release.gitbook.io/) from [conventional commits](https://www.conventionalcommits.org/).
 
+## [3.6.0](https://github.com/five-star-solutions-co/ai-tools/compare/v3.5.1...v3.6.0) (2026-08-28)
+
+### Features
+
+* **core:** add shipment functionality ([beb0d84](https://github.com/five-star-solutions-co/ai-tools/commit/beb0d84898c786380b56ac83c5f0d8d1d1d1178e))
+
 ## [3.5.1](https://github.com/five-star-solutions-co/ai-tools/compare/v3.5.0...v3.5.1) (2026-08-27)
 
 ## [3.5.0](https://github.com/five-star-solutions-co/ai-tools/compare/v3.4.0...v3.5.0) (2026-08-27)
@@ -135,6 +141,10 @@ Public surfaces removed or renamed since **v1.6.1** — next release **must** be
 | `mergeToolContext` / adapter `createContext` | Explicit `undefined` fields **do not** erase base `signal` / `fetch` / `auth` / `now` |
 | MCP `context` | Still accepts static `ToolContext` **or** factory `() => ToolContext \| Promise<…>` (and deprecated `contextFactory`) |
 
+### Added
+
+- ShipStation V2 vendor pack with API-key auth and paginated label and shipment read tools.
+
 ### Notes (compat preserved)
 
 - Adapter `createContext` callbacks use the installed framework execution-context types.

package/README.md

@@ -161,6 +161,7 @@ defineTool / defineModule
 | `@5ss/ai-tools/woocommerce` | orders, notes, refunds, products, variations, customers, coupons, categories | [woocommerce](./docs/vendors/woocommerce.md) |
 | `@5ss/ai-tools/katana` | sales/purchase/manufacturing orders, products, materials, customers, suppliers, inventory | [katana](./docs/vendors/katana.md) |
 | `@5ss/ai-tools/amazon-sp-api` | orders + items, FBA inventory, reports + documents, catalog search | [amazon-sp-api](./docs/vendors/amazon-sp-api.md) |
+| `@5ss/ai-tools/shipstation` | paginated labels and shipments | [shipstation](./docs/vendors/shipstation.md) |
 
 Auth fields are **snake_case** (`api_key`, `bot_token`, `access_key_id`, …).
 

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/core/bind.ts","../../src/generated/module-keys.ts","../../src/core/contracts.ts","../../src/core/catalog.ts"],"sourcesContent":["/**\n * Per-invocation auth/context bind for multi-tenant hosts.\n */\n\nimport { mergeToolContext } from './context'\nimport type { ToolSelection } from './filter-tools'\nimport { filterModuleTools } from './filter-tools'\nimport type { ToolHooks } from './hooks'\nimport { ToolError } from './errors'\nimport type { AuthDefinition, ModuleDefinition, ToolContext, ToolDefinition, ToolExecution } from './types'\n\nfunction assertAuth<TAuth>(auth: AuthDefinition<TAuth>, value: unknown): TAuth | undefined {\n\tif (auth.type === 'none') {\n\t\tif (value !== undefined) throw new ToolError('This tool does not accept auth', { code: 'bad_auth' })\n\t\treturn undefined\n\t}\n\tconst parsed = auth.schema.safeParse(value)\n\tif (!parsed.success) {\n\t\tthrow new ToolError('Invalid auth credentials', {\n\t\t\tcode: 'bad_auth',\n\t\t\tdetails: { issues: parsed.error.issues.map((i) => i.message) }\n\t\t})\n\t}\n\treturn parsed.data\n}\n\nexport type BindModuleOptions<TAuth = unknown> = {\n\tresolveAuth?: (ctx: ToolContext) => TAuth | Promise<TAuth>\n\tresolveContext?: (ctx: ToolContext) => ToolContext | Promise<ToolContext>\n\thooks?: ToolHooks\n\t/**\n\t * Restrict the tool surface after bind.\n\t * Prefer composable `onlyTools` / `exceptTools` when filtering outside bind.\n\t */\n\ttools?: ToolSelection\n}\n\nasync function resolveBoundContext<TAuth>(\n\tmoduleAuth: AuthDefinition<TAuth>,\n\tincoming: ToolContext,\n\toptions: BindModuleOptions<TAuth>\n): Promise<ToolContext> {\n\tconst base = options.resolveContext\n\t\t? mergeToolContext(incoming, await options.resolveContext(incoming))\n\t\t: { ...incoming }\n\tif (moduleAuth.type === 'none') return base\n\tif (!options.resolveAuth) {\n\t\tthrow new ToolError('resolveAuth is required for modules that declare auth', { code: 'bad_auth' })\n\t}\n\tconst auth = assertAuth(moduleAuth, await options.resolveAuth(base))\n\treturn {\n\t\t...base,\n\t\t...(auth !== undefined && { auth })\n\t}\n}\n\nexport function bindTool<TInput, TOutput, TAuth = unknown>(\n\ttool: ToolDefinition<TInput, TOutput>,\n\tmoduleAuth: AuthDefinition<TAuth>,\n\toptions: BindModuleOptions<TAuth>\n): ToolDefinition<TInput, TOutput> {\n\tconst previous = tool.execution ?? { run: tool.execute }\n\tconst bindContext = async (ctx: ToolContext): Promise<ToolContext> => {\n\t\tconst base = previous.bindContext ? await previous.bindContext(ctx) : ctx\n\t\treturn resolveBoundContext(moduleAuth, base, options)\n\t}\n\tconst execution: ToolExecution = {\n\t\t...previous,\n\t\tbindContext,\n\t\t...(options.hooks && { hooks: options.hooks })\n\t}\n\treturn {\n\t\t...tool,\n\t\texecution,\n\t\texecute: async (input, ctx) => execution.run(input, await bindContext(ctx))\n\t}\n}\n\nexport function bindModule<TAuth>(\n\tmodule: ModuleDefinition<TAuth>,\n\toptions: BindModuleOptions<TAuth>\n): ModuleDefinition<TAuth> {\n\tif (module.auth.type !== 'none' && !options.resolveAuth) {\n\t\tthrow new ToolError(`Module ${module.id} requires resolveAuth`, { code: 'bad_auth' })\n\t}\n\tconst scoped = options.tools !== undefined ? filterModuleTools(module, options.tools) : module\n\treturn {\n\t\t...scoped,\n\t\ttools: scoped.tools.map((tool) => bindTool(tool, scoped.auth, options))\n\t}\n}\n","// AUTO-GENERATED by `bun run codegen`. Do not edit by hand.\n/** Flat public export keys under src/{modules,vendors}. */\nexport const moduleKeys = [\n\t'amazon-sp-api',\n\t'artifacts',\n\t'bedrock-agentcore-browser',\n\t'bedrock-agentcore-code-interpreter',\n\t'browser',\n\t'calendar',\n\t'cloudflare-browser',\n\t'cloudflare-email',\n\t'cloudflare-sandbox',\n\t'code-sandbox',\n\t'content-type',\n\t'crypto',\n\t'document-extract',\n\t'document-render',\n\t'email',\n\t'email-message',\n\t'eventbridge-scheduler',\n\t'files',\n\t'image',\n\t'imessage',\n\t'katana',\n\t'mastra-vector',\n\t'messaging',\n\t'pinecone',\n\t'qdrant',\n\t'queue',\n\t'rag',\n\t'resend',\n\t's3',\n\t'scheduler',\n\t'skills',\n\t'slack',\n\t'sqs',\n\t'supabase-vector',\n\t'tasks',\n\t'teams',\n\t'telegram',\n\t'textract',\n\t'vector-store',\n\t'web-fetch',\n\t'woocommerce'\n] as const\n\nexport type ModuleKey = (typeof moduleKeys)[number]\n\n/** Capability seams under src/modules (brand-neutral model copy). */\nexport const moduleSeamKeys = [\n\t'artifacts',\n\t'browser',\n\t'calendar',\n\t'code-sandbox',\n\t'content-type',\n\t'crypto',\n\t'document-extract',\n\t'document-render',\n\t'email',\n\t'email-message',\n\t'files',\n\t'image',\n\t'messaging',\n\t'queue',\n\t'rag',\n\t'scheduler',\n\t'skills',\n\t'tasks',\n\t'vector-store',\n\t'web-fetch'\n] as const\n\nexport type ModuleSeamKey = (typeof moduleSeamKeys)[number]\n","import { flatMap, isPlainObject, isString } from 'es-toolkit'\nimport { isArray } from 'es-toolkit/compat'\nimport { toJSONSchema } from 'zod'\n\nimport { moduleSeamKeys } from '../generated/module-keys'\nimport type { ModuleDefinition, ToolDefinition } from './types'\nimport { duplicatesBy } from './unique'\n\nconst FORBIDDEN_MODEL_COPY =\n\t/\\b(api[_ ]?key|apiKey|bearer token|process\\.env|vault|secret key|authorization header|withAuth)\\b/i\n\n/**\n * Brand / vendor product names banned on **capability seam** model-facing copy\n * (module + tool description and input .describe()). Vendors may name their product.\n * Keep list brand-focused; avoid bare words like \"teams\" that appear in normal English.\n */\nconst FORBIDDEN_SEAM_BRAND_COPY =\n\t/\\b(Telegram|Slack|iMessage|Resend|Cloudflare|Textract|Pinecone|Qdrant|Supabase|WooCommerce|Katana|Amazon|Bot Framework|Microsoft Teams|Photon|Spectrum|Mastra|PgVector|OpenAI)\\b|\\bS3\\b|\\bR2\\b/\n\n/** Seam module ids from codegen (`src/modules/*` only — not hand-maintained). */\nconst SEAM_MODULE_IDS = new Set<string>(moduleSeamKeys)\n\nconst KEBAB_ID = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/\n\nexport type ContractIssue = {\n\tcode:\n\t\t| 'duplicate_tool_id'\n\t\t| 'empty_description'\n\t\t| 'empty_field_description'\n\t\t| 'forbidden_model_copy'\n\t\t| 'invalid_tool_id'\n\t\t| 'missing_name'\n\tmessage: string\n\tpath: string\n}\n\nexport type ContractResult = {\n\tok: boolean\n\tissues: ContractIssue[]\n}\n\nexport type CheckModelCopyOptions = {\n\t/** When true, also ban vendor brand names (capability seams). */\n\tseam?: boolean\n}\n\nfunction issue(path: string, code: ContractIssue['code'], message: string): ContractIssue {\n\treturn { path, code, message }\n}\n\nfunction checkModelCopy(\n\tpath: string,\n\ttext: string,\n\tissues: ContractIssue[],\n\toptions: CheckModelCopyOptions = {}\n): void {\n\tconst trimmed = text.trim()\n\tif (!trimmed) {\n\t\tissues.push(issue(path, 'empty_description', 'Model-facing description is empty'))\n\t\treturn\n\t}\n\tif (FORBIDDEN_MODEL_COPY.test(trimmed)) {\n\t\tissues.push(\n\t\t\tissue(\n\t\t\t\tpath,\n\t\t\t\t'forbidden_model_copy',\n\t\t\t\t'Model-facing copy must not mention credentials, env vars, vaults, or host wiring'\n\t\t\t)\n\t\t)\n\t}\n\tif (options.seam && FORBIDDEN_SEAM_BRAND_COPY.test(trimmed)) {\n\t\tissues.push(\n\t\t\tissue(\n\t\t\t\tpath,\n\t\t\t\t'forbidden_model_copy',\n\t\t\t\t'Seam model-facing copy must not name vendors or products (use channel / bound store / provider-neutral language)'\n\t\t\t)\n\t\t)\n\t}\n}\n\nfunction fieldDescribes(\n\tschema: ToolDefinition['inputSchema'],\n\tpath: string,\n\tissues: ContractIssue[],\n\toptions: CheckModelCopyOptions = {}\n): void {\n\tcheckFieldDescriptions(toJSONSchema(schema), `${path}.input`, issues, options)\n}\n\nfunction checkFieldDescriptions(\n\tschema: unknown,\n\tpath: string,\n\tissues: ContractIssue[],\n\toptions: CheckModelCopyOptions\n): void {\n\tif (!isPlainObject(schema)) return\n\tconst properties = schema['properties']\n\tif (isPlainObject(properties)) {\n\t\tfor (const [key, value] of Object.entries(properties)) {\n\t\t\tif (!isPlainObject(value)) continue\n\t\t\tconst fieldPath = `${path}.${key}`\n\t\t\tconst description = value['description']\n\t\t\tif (!isString(description) || description.trim().length === 0) {\n\t\t\t\tissues.push(\n\t\t\t\t\tissue(fieldPath, 'empty_field_description', `Input field \"${key}\" is missing a .describe() for the model`)\n\t\t\t\t)\n\t\t\t} else {\n\t\t\t\tcheckModelCopy(fieldPath, description, issues, options)\n\t\t\t}\n\t\t\tcheckFieldDescriptions(value, fieldPath, issues, options)\n\t\t}\n\t}\n\n\tfor (const [key, value] of Object.entries(schema)) {\n\t\tif (key === 'properties') continue\n\t\tif (isArray(value)) {\n\t\t\tfor (const [index, item] of value.entries()) {\n\t\t\t\tcheckFieldDescriptions(item, `${path}.${key}[${index}]`, issues, options)\n\t\t\t}\n\t\t\tcontinue\n\t\t}\n\t\tcheckFieldDescriptions(value, `${path}.${key}`, issues, options)\n\t}\n}\n\nexport function validateTool(\n\ttool: ToolDefinition,\n\tpathPrefix = tool.id,\n\toptions: CheckModelCopyOptions = {}\n): ContractResult {\n\tconst issues: ContractIssue[] = []\n\n\tif (!tool.id.trim() || !KEBAB_ID.test(tool.id)) {\n\t\tissues.push(issue(`${pathPrefix}.id`, 'invalid_tool_id', `Tool id must be kebab-case (got \"${tool.id}\")`))\n\t}\n\tif (!tool.name.trim()) {\n\t\tissues.push(issue(`${pathPrefix}.name`, 'missing_name', 'Tool name is required'))\n\t}\n\tcheckModelCopy(`${pathPrefix}.description`, tool.description, issues, options)\n\tfieldDescribes(tool.inputSchema, pathPrefix, issues, options)\n\n\treturn { ok: issues.length === 0, issues }\n}\n\nexport function validateModule(module: ModuleDefinition): ContractResult {\n\tconst issues: ContractIssue[] = []\n\tconst seam = SEAM_MODULE_IDS.has(module.id)\n\tconst copyOpts: CheckModelCopyOptions = seam ? { seam: true } : {}\n\n\tcheckModelCopy(`module.${module.id}.description`, module.description, issues, copyOpts)\n\n\tfor (const id of duplicatesBy(module.tools, (tool) => tool.id)) {\n\t\tissues.push(issue(`module.${module.id}.tools.${id}`, 'duplicate_tool_id', `Duplicate tool id \"${id}\"`))\n\t}\n\n\tissues.push(\n\t\t...flatMap(module.tools, (tool) => validateTool(tool, `module.${module.id}.tools.${tool.id}`, copyOpts).issues)\n\t)\n\n\treturn { ok: issues.length === 0, issues }\n}\n\nexport function assertContracts(result: ContractResult, label = 'contract'): void {\n\tif (result.ok) return\n\tconst detail = result.issues.map((i) => `${i.path}: ${i.message}`).join('\\n')\n\tthrow new Error(`${label} failed:\\n${detail}`)\n}\n","import { toJSONSchema } from 'zod'\n\nimport type { AuthDefinition, ModuleDefinition, ToolDefinition } from './types'\n\nexport type ToolCatalogEntry = {\n\tdescription: string\n\tid: string\n\tinputJsonSchema: Record<string, unknown>\n\tname: string\n\toutputJsonSchema: Record<string, unknown>\n\truntime: ToolDefinition['meta']['runtime']\n\tsideEffect: ToolDefinition['meta']['sideEffect']\n\ttags: readonly string[]\n\tidempotent?: boolean | undefined\n\tlongRunning?: boolean | undefined\n\trequiresConfirmation?: boolean | undefined\n\tsupportsCancel?: boolean | undefined\n\tsupportsProgress?: boolean | undefined\n\tnetwork?: boolean | undefined\n\tartifacts?: boolean | undefined\n}\n\nexport type ModuleCatalogEntry = {\n\tauthType: AuthDefinition<unknown>['type']\n\tdescription: string\n\tid: string\n\truntime: ModuleDefinition['runtime']\n\ttitle: string\n\ttools: ToolCatalogEntry[]\n\t/** Inline SVG when the pack has a logo. */\n\tlogo?: string | undefined\n\tcategories: readonly string[]\n\tclassification?: ModuleDefinition['classification']\n\ttags: readonly string[]\n}\n\nexport function toToolCatalogEntry(tool: ToolDefinition): ToolCatalogEntry {\n\treturn {\n\t\tid: tool.id,\n\t\tname: tool.name,\n\t\tdescription: tool.description,\n\t\truntime: tool.meta.runtime,\n\t\tsideEffect: tool.meta.sideEffect,\n\t\ttags: tool.meta.tags ?? [],\n\t\tidempotent: tool.meta.idempotent,\n\t\tlongRunning: tool.meta.longRunning,\n\t\trequiresConfirmation: tool.meta.requiresConfirmation,\n\t\tsupportsCancel: tool.meta.supportsCancel,\n\t\tsupportsProgress: tool.meta.supportsProgress,\n\t\tnetwork: tool.meta.network,\n\t\tartifacts: tool.meta.artifacts,\n\t\tinputJsonSchema: toJSONSchema(tool.inputSchema),\n\t\toutputJsonSchema: toJSONSchema(tool.outputSchema)\n\t}\n}\n\nexport function toModuleCatalogEntry(module: ModuleDefinition): ModuleCatalogEntry {\n\treturn {\n\t\tid: module.id,\n\t\ttitle: module.title,\n\t\tdescription: module.description,\n\t\truntime: module.runtime,\n\t\tauthType: module.auth.type,\n\t\ttools: module.tools.map(toToolCatalogEntry),\n\t\tcategories: module.categories,\n\t\ttags: module.tags ?? [],\n\t\t...(module.classification !== undefined && { classification: module.classification }),\n\t\t...(module.logo !== undefined && { logo: module.logo })\n\t}\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/core/bind.ts","../../src/generated/module-keys.ts","../../src/core/contracts.ts","../../src/core/catalog.ts"],"sourcesContent":["/**\n * Per-invocation auth/context bind for multi-tenant hosts.\n */\n\nimport { mergeToolContext } from './context'\nimport type { ToolSelection } from './filter-tools'\nimport { filterModuleTools } from './filter-tools'\nimport type { ToolHooks } from './hooks'\nimport { ToolError } from './errors'\nimport type { AuthDefinition, ModuleDefinition, ToolContext, ToolDefinition, ToolExecution } from './types'\n\nfunction assertAuth<TAuth>(auth: AuthDefinition<TAuth>, value: unknown): TAuth | undefined {\n\tif (auth.type === 'none') {\n\t\tif (value !== undefined) throw new ToolError('This tool does not accept auth', { code: 'bad_auth' })\n\t\treturn undefined\n\t}\n\tconst parsed = auth.schema.safeParse(value)\n\tif (!parsed.success) {\n\t\tthrow new ToolError('Invalid auth credentials', {\n\t\t\tcode: 'bad_auth',\n\t\t\tdetails: { issues: parsed.error.issues.map((i) => i.message) }\n\t\t})\n\t}\n\treturn parsed.data\n}\n\nexport type BindModuleOptions<TAuth = unknown> = {\n\tresolveAuth?: (ctx: ToolContext) => TAuth | Promise<TAuth>\n\tresolveContext?: (ctx: ToolContext) => ToolContext | Promise<ToolContext>\n\thooks?: ToolHooks\n\t/**\n\t * Restrict the tool surface after bind.\n\t * Prefer composable `onlyTools` / `exceptTools` when filtering outside bind.\n\t */\n\ttools?: ToolSelection\n}\n\nasync function resolveBoundContext<TAuth>(\n\tmoduleAuth: AuthDefinition<TAuth>,\n\tincoming: ToolContext,\n\toptions: BindModuleOptions<TAuth>\n): Promise<ToolContext> {\n\tconst base = options.resolveContext\n\t\t? mergeToolContext(incoming, await options.resolveContext(incoming))\n\t\t: { ...incoming }\n\tif (moduleAuth.type === 'none') return base\n\tif (!options.resolveAuth) {\n\t\tthrow new ToolError('resolveAuth is required for modules that declare auth', { code: 'bad_auth' })\n\t}\n\tconst auth = assertAuth(moduleAuth, await options.resolveAuth(base))\n\treturn {\n\t\t...base,\n\t\t...(auth !== undefined && { auth })\n\t}\n}\n\nexport function bindTool<TInput, TOutput, TAuth = unknown>(\n\ttool: ToolDefinition<TInput, TOutput>,\n\tmoduleAuth: AuthDefinition<TAuth>,\n\toptions: BindModuleOptions<TAuth>\n): ToolDefinition<TInput, TOutput> {\n\tconst previous = tool.execution ?? { run: tool.execute }\n\tconst bindContext = async (ctx: ToolContext): Promise<ToolContext> => {\n\t\tconst base = previous.bindContext ? await previous.bindContext(ctx) : ctx\n\t\treturn resolveBoundContext(moduleAuth, base, options)\n\t}\n\tconst execution: ToolExecution = {\n\t\t...previous,\n\t\tbindContext,\n\t\t...(options.hooks && { hooks: options.hooks })\n\t}\n\treturn {\n\t\t...tool,\n\t\texecution,\n\t\texecute: async (input, ctx) => execution.run(input, await bindContext(ctx))\n\t}\n}\n\nexport function bindModule<TAuth>(\n\tmodule: ModuleDefinition<TAuth>,\n\toptions: BindModuleOptions<TAuth>\n): ModuleDefinition<TAuth> {\n\tif (module.auth.type !== 'none' && !options.resolveAuth) {\n\t\tthrow new ToolError(`Module ${module.id} requires resolveAuth`, { code: 'bad_auth' })\n\t}\n\tconst scoped = options.tools !== undefined ? filterModuleTools(module, options.tools) : module\n\treturn {\n\t\t...scoped,\n\t\ttools: scoped.tools.map((tool) => bindTool(tool, scoped.auth, options))\n\t}\n}\n","// AUTO-GENERATED by `bun run codegen`. Do not edit by hand.\n/** Flat public export keys under src/{modules,vendors}. */\nexport const moduleKeys = [\n\t'amazon-sp-api',\n\t'artifacts',\n\t'bedrock-agentcore-browser',\n\t'bedrock-agentcore-code-interpreter',\n\t'browser',\n\t'calendar',\n\t'cloudflare-browser',\n\t'cloudflare-email',\n\t'cloudflare-sandbox',\n\t'code-sandbox',\n\t'content-type',\n\t'crypto',\n\t'document-extract',\n\t'document-render',\n\t'email',\n\t'email-message',\n\t'eventbridge-scheduler',\n\t'files',\n\t'image',\n\t'imessage',\n\t'katana',\n\t'mastra-vector',\n\t'messaging',\n\t'pinecone',\n\t'qdrant',\n\t'queue',\n\t'rag',\n\t'resend',\n\t's3',\n\t'scheduler',\n\t'shipstation',\n\t'skills',\n\t'slack',\n\t'sqs',\n\t'supabase-vector',\n\t'tasks',\n\t'teams',\n\t'telegram',\n\t'textract',\n\t'vector-store',\n\t'web-fetch',\n\t'woocommerce'\n] as const\n\nexport type ModuleKey = (typeof moduleKeys)[number]\n\n/** Capability seams under src/modules (brand-neutral model copy). */\nexport const moduleSeamKeys = [\n\t'artifacts',\n\t'browser',\n\t'calendar',\n\t'code-sandbox',\n\t'content-type',\n\t'crypto',\n\t'document-extract',\n\t'document-render',\n\t'email',\n\t'email-message',\n\t'files',\n\t'image',\n\t'messaging',\n\t'queue',\n\t'rag',\n\t'scheduler',\n\t'skills',\n\t'tasks',\n\t'vector-store',\n\t'web-fetch'\n] as const\n\nexport type ModuleSeamKey = (typeof moduleSeamKeys)[number]\n","import { flatMap, isPlainObject, isString } from 'es-toolkit'\nimport { isArray } from 'es-toolkit/compat'\nimport { toJSONSchema } from 'zod'\n\nimport { moduleSeamKeys } from '../generated/module-keys'\nimport type { ModuleDefinition, ToolDefinition } from './types'\nimport { duplicatesBy } from './unique'\n\nconst FORBIDDEN_MODEL_COPY =\n\t/\\b(api[_ ]?key|apiKey|bearer token|process\\.env|vault|secret key|authorization header|withAuth)\\b/i\n\n/**\n * Brand / vendor product names banned on **capability seam** model-facing copy\n * (module + tool description and input .describe()). Vendors may name their product.\n * Keep list brand-focused; avoid bare words like \"teams\" that appear in normal English.\n */\nconst FORBIDDEN_SEAM_BRAND_COPY =\n\t/\\b(Telegram|Slack|iMessage|Resend|Cloudflare|Textract|Pinecone|Qdrant|Supabase|WooCommerce|Katana|Amazon|Bot Framework|Microsoft Teams|Photon|Spectrum|Mastra|PgVector|OpenAI)\\b|\\bS3\\b|\\bR2\\b/\n\n/** Seam module ids from codegen (`src/modules/*` only — not hand-maintained). */\nconst SEAM_MODULE_IDS = new Set<string>(moduleSeamKeys)\n\nconst KEBAB_ID = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/\n\nexport type ContractIssue = {\n\tcode:\n\t\t| 'duplicate_tool_id'\n\t\t| 'empty_description'\n\t\t| 'empty_field_description'\n\t\t| 'forbidden_model_copy'\n\t\t| 'invalid_tool_id'\n\t\t| 'missing_name'\n\tmessage: string\n\tpath: string\n}\n\nexport type ContractResult = {\n\tok: boolean\n\tissues: ContractIssue[]\n}\n\nexport type CheckModelCopyOptions = {\n\t/** When true, also ban vendor brand names (capability seams). */\n\tseam?: boolean\n}\n\nfunction issue(path: string, code: ContractIssue['code'], message: string): ContractIssue {\n\treturn { path, code, message }\n}\n\nfunction checkModelCopy(\n\tpath: string,\n\ttext: string,\n\tissues: ContractIssue[],\n\toptions: CheckModelCopyOptions = {}\n): void {\n\tconst trimmed = text.trim()\n\tif (!trimmed) {\n\t\tissues.push(issue(path, 'empty_description', 'Model-facing description is empty'))\n\t\treturn\n\t}\n\tif (FORBIDDEN_MODEL_COPY.test(trimmed)) {\n\t\tissues.push(\n\t\t\tissue(\n\t\t\t\tpath,\n\t\t\t\t'forbidden_model_copy',\n\t\t\t\t'Model-facing copy must not mention credentials, env vars, vaults, or host wiring'\n\t\t\t)\n\t\t)\n\t}\n\tif (options.seam && FORBIDDEN_SEAM_BRAND_COPY.test(trimmed)) {\n\t\tissues.push(\n\t\t\tissue(\n\t\t\t\tpath,\n\t\t\t\t'forbidden_model_copy',\n\t\t\t\t'Seam model-facing copy must not name vendors or products (use channel / bound store / provider-neutral language)'\n\t\t\t)\n\t\t)\n\t}\n}\n\nfunction fieldDescribes(\n\tschema: ToolDefinition['inputSchema'],\n\tpath: string,\n\tissues: ContractIssue[],\n\toptions: CheckModelCopyOptions = {}\n): void {\n\tcheckFieldDescriptions(toJSONSchema(schema), `${path}.input`, issues, options)\n}\n\nfunction checkFieldDescriptions(\n\tschema: unknown,\n\tpath: string,\n\tissues: ContractIssue[],\n\toptions: CheckModelCopyOptions\n): void {\n\tif (!isPlainObject(schema)) return\n\tconst properties = schema['properties']\n\tif (isPlainObject(properties)) {\n\t\tfor (const [key, value] of Object.entries(properties)) {\n\t\t\tif (!isPlainObject(value)) continue\n\t\t\tconst fieldPath = `${path}.${key}`\n\t\t\tconst description = value['description']\n\t\t\tif (!isString(description) || description.trim().length === 0) {\n\t\t\t\tissues.push(\n\t\t\t\t\tissue(fieldPath, 'empty_field_description', `Input field \"${key}\" is missing a .describe() for the model`)\n\t\t\t\t)\n\t\t\t} else {\n\t\t\t\tcheckModelCopy(fieldPath, description, issues, options)\n\t\t\t}\n\t\t\tcheckFieldDescriptions(value, fieldPath, issues, options)\n\t\t}\n\t}\n\n\tfor (const [key, value] of Object.entries(schema)) {\n\t\tif (key === 'properties') continue\n\t\tif (isArray(value)) {\n\t\t\tfor (const [index, item] of value.entries()) {\n\t\t\t\tcheckFieldDescriptions(item, `${path}.${key}[${index}]`, issues, options)\n\t\t\t}\n\t\t\tcontinue\n\t\t}\n\t\tcheckFieldDescriptions(value, `${path}.${key}`, issues, options)\n\t}\n}\n\nexport function validateTool(\n\ttool: ToolDefinition,\n\tpathPrefix = tool.id,\n\toptions: CheckModelCopyOptions = {}\n): ContractResult {\n\tconst issues: ContractIssue[] = []\n\n\tif (!tool.id.trim() || !KEBAB_ID.test(tool.id)) {\n\t\tissues.push(issue(`${pathPrefix}.id`, 'invalid_tool_id', `Tool id must be kebab-case (got \"${tool.id}\")`))\n\t}\n\tif (!tool.name.trim()) {\n\t\tissues.push(issue(`${pathPrefix}.name`, 'missing_name', 'Tool name is required'))\n\t}\n\tcheckModelCopy(`${pathPrefix}.description`, tool.description, issues, options)\n\tfieldDescribes(tool.inputSchema, pathPrefix, issues, options)\n\n\treturn { ok: issues.length === 0, issues }\n}\n\nexport function validateModule(module: ModuleDefinition): ContractResult {\n\tconst issues: ContractIssue[] = []\n\tconst seam = SEAM_MODULE_IDS.has(module.id)\n\tconst copyOpts: CheckModelCopyOptions = seam ? { seam: true } : {}\n\n\tcheckModelCopy(`module.${module.id}.description`, module.description, issues, copyOpts)\n\n\tfor (const id of duplicatesBy(module.tools, (tool) => tool.id)) {\n\t\tissues.push(issue(`module.${module.id}.tools.${id}`, 'duplicate_tool_id', `Duplicate tool id \"${id}\"`))\n\t}\n\n\tissues.push(\n\t\t...flatMap(module.tools, (tool) => validateTool(tool, `module.${module.id}.tools.${tool.id}`, copyOpts).issues)\n\t)\n\n\treturn { ok: issues.length === 0, issues }\n}\n\nexport function assertContracts(result: ContractResult, label = 'contract'): void {\n\tif (result.ok) return\n\tconst detail = result.issues.map((i) => `${i.path}: ${i.message}`).join('\\n')\n\tthrow new Error(`${label} failed:\\n${detail}`)\n}\n","import { toJSONSchema } from 'zod'\n\nimport type { AuthDefinition, ModuleDefinition, ToolDefinition } from './types'\n\nexport type ToolCatalogEntry = {\n\tdescription: string\n\tid: string\n\tinputJsonSchema: Record<string, unknown>\n\tname: string\n\toutputJsonSchema: Record<string, unknown>\n\truntime: ToolDefinition['meta']['runtime']\n\tsideEffect: ToolDefinition['meta']['sideEffect']\n\ttags: readonly string[]\n\tidempotent?: boolean | undefined\n\tlongRunning?: boolean | undefined\n\trequiresConfirmation?: boolean | undefined\n\tsupportsCancel?: boolean | undefined\n\tsupportsProgress?: boolean | undefined\n\tnetwork?: boolean | undefined\n\tartifacts?: boolean | undefined\n}\n\nexport type ModuleCatalogEntry = {\n\tauthType: AuthDefinition<unknown>['type']\n\tdescription: string\n\tid: string\n\truntime: ModuleDefinition['runtime']\n\ttitle: string\n\ttools: ToolCatalogEntry[]\n\t/** Inline SVG when the pack has a logo. */\n\tlogo?: string | undefined\n\tcategories: readonly string[]\n\tclassification?: ModuleDefinition['classification']\n\ttags: readonly string[]\n}\n\nexport function toToolCatalogEntry(tool: ToolDefinition): ToolCatalogEntry {\n\treturn {\n\t\tid: tool.id,\n\t\tname: tool.name,\n\t\tdescription: tool.description,\n\t\truntime: tool.meta.runtime,\n\t\tsideEffect: tool.meta.sideEffect,\n\t\ttags: tool.meta.tags ?? [],\n\t\tidempotent: tool.meta.idempotent,\n\t\tlongRunning: tool.meta.longRunning,\n\t\trequiresConfirmation: tool.meta.requiresConfirmation,\n\t\tsupportsCancel: tool.meta.supportsCancel,\n\t\tsupportsProgress: tool.meta.supportsProgress,\n\t\tnetwork: tool.meta.network,\n\t\tartifacts: tool.meta.artifacts,\n\t\tinputJsonSchema: toJSONSchema(tool.inputSchema),\n\t\toutputJsonSchema: toJSONSchema(tool.outputSchema)\n\t}\n}\n\nexport function toModuleCatalogEntry(module: ModuleDefinition): ModuleCatalogEntry {\n\treturn {\n\t\tid: module.id,\n\t\ttitle: module.title,\n\t\tdescription: module.description,\n\t\truntime: module.runtime,\n\t\tauthType: module.auth.type,\n\t\ttools: module.tools.map(toToolCatalogEntry),\n\t\tcategories: module.categories,\n\t\ttags: module.tags ?? [],\n\t\t...(module.classification !== undefined && { classification: module.classification }),\n\t\t...(module.logo !== undefined && { logo: module.logo })\n\t}\n}\n"],"mappings":"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"}

package/dist/vendors/shipstation/index.d.ts

@@ -0,0 +1,256 @@
+import { a as ModuleDefinition, o as ToolContext, s as ToolDefinition } from "../../types-Ccb0DXY9.js";
+import "../../index-CZX5OeOF.js";
+import { s as HttpServiceOptions } from "../../http-service-CerzWwQO.js";
+import { z } from "zod";
+//#region src/vendors/shipstation/contracts.d.ts
+declare const shipstationAuthSchema: z.ZodObject<{
+  api_key: z.ZodString;
+}, z.core.$strip>;
+type ShipstationAuth = z.infer<typeof shipstationAuthSchema>;
+declare const shipstationLabelRawSchema: z.ZodObject<{
+  label_id: z.ZodString;
+  shipment_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  external_order_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  tracking_number: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  modified_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  ship_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  voided_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+declare const shipstationShipmentRawSchema: z.ZodObject<{
+  shipment_id: z.ZodString;
+  external_order_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  shipment_number: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  modified_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  shipment_status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$loose>;
+declare const shipstationPaginationSchema: z.ZodObject<{
+  total: z.ZodInt;
+  page: z.ZodInt;
+  pages: z.ZodInt;
+  page_size: z.ZodInt;
+  has_more: z.ZodBoolean;
+}, z.core.$strip>;
+declare const shipstationListLabelsPageInputSchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodInt>;
+  page_size: z.ZodOptional<z.ZodInt>;
+  label_status: z.ZodOptional<z.ZodString>;
+  service_code: z.ZodOptional<z.ZodString>;
+  carrier_id: z.ZodOptional<z.ZodString>;
+  tracking_number: z.ZodOptional<z.ZodString>;
+  batch_id: z.ZodOptional<z.ZodString>;
+  rate_id: z.ZodOptional<z.ZodString>;
+  shipment_id: z.ZodOptional<z.ZodString>;
+  external_shipment_id: z.ZodOptional<z.ZodString>;
+  warehouse_id: z.ZodOptional<z.ZodString>;
+  created_at_start: z.ZodOptional<z.ZodISODateTime>;
+  created_at_end: z.ZodOptional<z.ZodISODateTime>;
+  refund_status: z.ZodOptional<z.ZodString>;
+  sort_dir: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  sort_by: z.ZodOptional<z.ZodEnum<{
+    created_at: "created_at";
+    modified_at: "modified_at";
+    voided_at: "voided_at";
+  }>>;
+}, z.core.$strict>;
+declare const shipstationListLabelsPageOutputSchema: z.ZodObject<{
+  items: z.ZodArray<z.ZodObject<{
+    label_id: z.ZodString;
+    shipment_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    external_order_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tracking_number: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    modified_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ship_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    voided_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$loose>>;
+  pagination: z.ZodObject<{
+    total: z.ZodInt;
+    page: z.ZodInt;
+    pages: z.ZodInt;
+    page_size: z.ZodInt;
+    has_more: z.ZodBoolean;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+declare const shipstationListShipmentsPageInputSchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodInt>;
+  page_size: z.ZodOptional<z.ZodInt>;
+  shipment_status: z.ZodOptional<z.ZodString>;
+  batch_id: z.ZodOptional<z.ZodString>;
+  pickup_id: z.ZodOptional<z.ZodString>;
+  created_at_start: z.ZodOptional<z.ZodISODateTime>;
+  created_at_end: z.ZodOptional<z.ZodISODateTime>;
+  modified_at_start: z.ZodOptional<z.ZodISODateTime>;
+  modified_at_end: z.ZodOptional<z.ZodISODateTime>;
+  sales_order_id: z.ZodOptional<z.ZodString>;
+  shipment_number: z.ZodOptional<z.ZodString>;
+  ship_to_name: z.ZodOptional<z.ZodString>;
+  item_keyword: z.ZodOptional<z.ZodString>;
+  payment_date_start: z.ZodOptional<z.ZodISODateTime>;
+  payment_date_end: z.ZodOptional<z.ZodISODateTime>;
+  store_id: z.ZodOptional<z.ZodString>;
+  external_shipment_id: z.ZodOptional<z.ZodString>;
+  sort_dir: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  sort_by: z.ZodOptional<z.ZodEnum<{
+    created_at: "created_at";
+    modified_at: "modified_at";
+  }>>;
+}, z.core.$strict>;
+declare const shipstationListShipmentsPageOutputSchema: z.ZodObject<{
+  items: z.ZodArray<z.ZodObject<{
+    shipment_id: z.ZodString;
+    external_order_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    shipment_number: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    modified_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    shipment_status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$loose>>;
+  pagination: z.ZodObject<{
+    total: z.ZodInt;
+    page: z.ZodInt;
+    pages: z.ZodInt;
+    page_size: z.ZodInt;
+    has_more: z.ZodBoolean;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+declare const shipstationListLabelsResponseSchema: z.ZodObject<{
+  labels: z.ZodArray<z.ZodObject<{
+    label_id: z.ZodString;
+    shipment_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    external_order_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tracking_number: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    modified_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    ship_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    voided_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$loose>>;
+  total: z.ZodInt;
+  page: z.ZodInt;
+  pages: z.ZodInt;
+}, z.core.$loose>;
+declare const shipstationListShipmentsResponseSchema: z.ZodObject<{
+  shipments: z.ZodArray<z.ZodObject<{
+    shipment_id: z.ZodString;
+    external_order_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    shipment_number: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    modified_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    shipment_status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  }, z.core.$loose>>;
+  total: z.ZodInt;
+  page: z.ZodInt;
+  pages: z.ZodInt;
+}, z.core.$loose>;
+type ShipstationLabelRaw = z.infer<typeof shipstationLabelRawSchema>;
+type ShipstationShipmentRaw = z.infer<typeof shipstationShipmentRawSchema>;
+type ShipstationPagination = z.infer<typeof shipstationPaginationSchema>;
+type ShipstationListLabelsPageInput = z.infer<typeof shipstationListLabelsPageInputSchema>;
+type ShipstationListLabelsPageOutput = z.infer<typeof shipstationListLabelsPageOutputSchema>;
+type ShipstationListShipmentsPageInput = z.infer<typeof shipstationListShipmentsPageInputSchema>;
+type ShipstationListShipmentsPageOutput = z.infer<typeof shipstationListShipmentsPageOutputSchema>;
+//#endregion
+//#region src/vendors/shipstation/client.d.ts
+type ShipstationClientOptions = Pick<HttpServiceOptions, 'fetch' | 'signal'>;
+declare class ShipstationClient {
+  #private;
+  constructor(auth: ShipstationAuth, options?: ShipstationClientOptions);
+  static fromContext(ctx: ToolContext): ShipstationClient;
+  /** One GET /labels request with provider pagination and filters. */
+  listLabelsPage(input?: ShipstationListLabelsPageInput): Promise<ShipstationListLabelsPageOutput>;
+  /** One GET /shipments request with provider pagination and filters. */
+  listShipmentsPage(input?: ShipstationListShipmentsPageInput): Promise<ShipstationListShipmentsPageOutput>;
+}
+//#endregion
+//#region src/vendors/shipstation/module.d.ts
+declare const shipstationListLabelsTool: ToolDefinition<{
+  page?: number | undefined;
+  page_size?: number | undefined;
+  label_status?: string | undefined;
+  service_code?: string | undefined;
+  carrier_id?: string | undefined;
+  tracking_number?: string | undefined;
+  batch_id?: string | undefined;
+  rate_id?: string | undefined;
+  shipment_id?: string | undefined;
+  external_shipment_id?: string | undefined;
+  warehouse_id?: string | undefined;
+  created_at_start?: string | undefined;
+  created_at_end?: string | undefined;
+  refund_status?: string | undefined;
+  sort_dir?: "asc" | "desc" | undefined;
+  sort_by?: "created_at" | "modified_at" | "voided_at" | undefined;
+}, {
+  items: {
+    [x: string]: unknown;
+    label_id: string;
+    shipment_id?: string | null | undefined;
+    external_order_id?: string | null | undefined;
+    tracking_number?: string | null | undefined;
+    created_at?: string | null | undefined;
+    modified_at?: string | null | undefined;
+    ship_date?: string | null | undefined;
+    voided_at?: string | null | undefined;
+    status?: string | null | undefined;
+  }[];
+  pagination: {
+    total: number;
+    page: number;
+    pages: number;
+    page_size: number;
+    has_more: boolean;
+  };
+}>;
+declare const shipstationListShipmentsTool: ToolDefinition<{
+  page?: number | undefined;
+  page_size?: number | undefined;
+  shipment_status?: string | undefined;
+  batch_id?: string | undefined;
+  pickup_id?: string | undefined;
+  created_at_start?: string | undefined;
+  created_at_end?: string | undefined;
+  modified_at_start?: string | undefined;
+  modified_at_end?: string | undefined;
+  sales_order_id?: string | undefined;
+  shipment_number?: string | undefined;
+  ship_to_name?: string | undefined;
+  item_keyword?: string | undefined;
+  payment_date_start?: string | undefined;
+  payment_date_end?: string | undefined;
+  store_id?: string | undefined;
+  external_shipment_id?: string | undefined;
+  sort_dir?: "asc" | "desc" | undefined;
+  sort_by?: "created_at" | "modified_at" | undefined;
+}, {
+  items: {
+    [x: string]: unknown;
+    shipment_id: string;
+    external_order_id?: string | null | undefined;
+    shipment_number?: string | null | undefined;
+    created_at?: string | null | undefined;
+    modified_at?: string | null | undefined;
+    shipment_status?: string | null | undefined;
+  }[];
+  pagination: {
+    total: number;
+    page: number;
+    pages: number;
+    page_size: number;
+    has_more: boolean;
+  };
+}>;
+declare const shipstationModule: ModuleDefinition<{
+  api_key: string;
+}>;
+//#endregion
+export { type ShipstationAuth, ShipstationClient, type ShipstationClientOptions, type ShipstationLabelRaw, type ShipstationListLabelsPageInput, type ShipstationListLabelsPageOutput, type ShipstationListShipmentsPageInput, type ShipstationListShipmentsPageOutput, type ShipstationPagination, type ShipstationShipmentRaw, shipstationAuthSchema, shipstationLabelRawSchema, shipstationListLabelsPageInputSchema, shipstationListLabelsPageOutputSchema, shipstationListLabelsResponseSchema, shipstationListLabelsTool, shipstationListShipmentsPageInputSchema, shipstationListShipmentsPageOutputSchema, shipstationListShipmentsResponseSchema, shipstationListShipmentsTool, shipstationModule, shipstationPaginationSchema, shipstationShipmentRawSchema };
+//# sourceMappingURL=index.d.ts.map

package/dist/vendors/shipstation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/vendors/shipstation/contracts.ts","../../../src/vendors/shipstation/client.ts","../../../src/vendors/shipstation/module.ts"],"mappings":";;;;;cAEa,uBAAqB,EAAA;;GAEhC,EAAA,KAAA;KAEU,kBAAkB,EAAE,aAAa;cAUhC,2BAAyB,EAAA;;;;;;;;;;GAUpC,EAAA,KAAA;cAEW,8BAA4B,EAAA;;;;;;;GAOvC,EAAA,KAAA;cAEW,6BAA2B,EAAA;;;;;;GAMtC,EAAA,KAAA;cAEW,sCAAoC,EAAA;;;;;;;;;;;;;;;;;;;;;;;;GA0B/C,EAAA,KAAA;cAEW,uCAAqC,EAAA;;;;;;;;;;;;;;;;;;;GAGhD,EAAA,KAAA;cAEW,yCAAuC,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GAsClD,EAAA,KAAA;cAEW,0CAAwC,EAAA;;;;;;;;;;;;;;;;GAGnD,EAAA,KAAA;cAEW,qCAAmC,EAAA;;;;;;;;;;;;;;;GAK9C,EAAA,KAAA;cAEW,wCAAsC,EAAA;;;;;;;;;;;;GAKjD,EAAA,KAAA;KAEU,sBAAsB,EAAE,aAAa;KACrC,yBAAyB,EAAE,aAAa;KACxC,wBAAwB,EAAE,aAAa;KACvC,iCAAiC,EAAE,aAAa;KAChD,kCAAkC,EAAE,aAAa;KACjD,oCAAoC,EAAE,aAAa;KACnD,qCAAqC,EAAE,aAAa;;;KCnHpD,2BAA2B,KAAK;cAE/B;;EAGZ,YAAY,MAAM,iBAAiB,UAAS;SAoBrC,YAAY,KAAK,cAAc;;EAShC,eAAe,QAAO,iCAAsC,QAAQ;;EAoCpE,kBAAkB,QAAO,oCAAyC,QAAQ;;;;cCxFpE,2BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAgBA,8BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAgBA,mBAAA;EAAiB"}

package/dist/vendors/shipstation/index.js

@@ -0,0 +1,261 @@
+import { t as ToolError } from "../../errors-DoSpNHvs.js";
+import { n as defineModule, r as defineTool } from "../../define-ieoksEQ0.js";
+import { n as requireAuth } from "../../provider-CgDAlg6K.js";
+import { t as HttpService } from "../../http-service-BMBIryAL.js";
+import { z } from "zod";
+//#region src/vendors/shipstation/contracts.ts
+const shipstationAuthSchema = z.object({ api_key: z.string().min(1).describe("ShipStation V2 API key") });
+const shipstationPageSchema = z.int().min(1).optional().describe("Provider page number, starting at 1");
+const shipstationPageSizeSchema = z.int().min(1).max(500).optional().describe("Records per page, from 1 to 500; defaults to 25");
+const shipstationLabelRawSchema = z.looseObject({
+	label_id: z.string().min(1),
+	shipment_id: z.string().nullable().optional(),
+	external_order_id: z.string().nullable().optional(),
+	tracking_number: z.string().nullable().optional(),
+	created_at: z.string().nullable().optional(),
+	modified_at: z.string().nullable().optional(),
+	ship_date: z.string().nullable().optional(),
+	voided_at: z.string().nullable().optional(),
+	status: z.string().nullable().optional()
+});
+const shipstationShipmentRawSchema = z.looseObject({
+	shipment_id: z.string().min(1),
+	external_order_id: z.string().nullable().optional(),
+	shipment_number: z.string().nullable().optional(),
+	created_at: z.string().nullable().optional(),
+	modified_at: z.string().nullable().optional(),
+	shipment_status: z.string().nullable().optional()
+});
+const shipstationPaginationSchema = z.object({
+	total: z.int().nonnegative(),
+	page: z.int().min(1),
+	pages: z.int().nonnegative(),
+	page_size: z.int().min(1).max(500),
+	has_more: z.boolean()
+});
+const shipstationListLabelsPageInputSchema = z.strictObject({
+	page: shipstationPageSchema,
+	page_size: shipstationPageSizeSchema,
+	label_status: z.string().min(1).optional().describe("Label status filter"),
+	service_code: z.string().min(1).optional().describe("Carrier service code filter"),
+	carrier_id: z.string().min(1).optional().describe("ShipStation carrier id filter"),
+	tracking_number: z.string().min(1).optional().describe("Exact tracking number filter"),
+	batch_id: z.string().min(1).optional().describe("ShipStation batch id filter"),
+	rate_id: z.string().min(1).optional().describe("ShipStation rate id filter"),
+	shipment_id: z.string().min(1).optional().describe("ShipStation shipment id filter"),
+	external_shipment_id: z.string().min(1).optional().describe("External shipment id filter"),
+	warehouse_id: z.string().min(1).optional().describe("ShipStation warehouse id filter"),
+	created_at_start: z.iso.datetime({ offset: true }).optional().describe("Include labels created at or after this ISO 8601 timestamp"),
+	created_at_end: z.iso.datetime({ offset: true }).optional().describe("Include labels created at or before this ISO 8601 timestamp"),
+	refund_status: z.string().min(1).optional().describe("Label refund status filter"),
+	sort_dir: z.enum(["asc", "desc"]).optional().describe("Provider slice direction; defaults to desc"),
+	sort_by: z.enum([
+		"modified_at",
+		"created_at",
+		"voided_at"
+	]).optional().describe("Label field used to sort the provider slice")
+});
+const shipstationListLabelsPageOutputSchema = z.object({
+	items: z.array(shipstationLabelRawSchema),
+	pagination: shipstationPaginationSchema
+});
+const shipstationListShipmentsPageInputSchema = z.strictObject({
+	page: shipstationPageSchema,
+	page_size: shipstationPageSizeSchema,
+	shipment_status: z.string().min(1).optional().describe("Shipment status filter"),
+	batch_id: z.string().min(1).optional().describe("ShipStation batch id filter"),
+	pickup_id: z.string().min(1).optional().describe("ShipStation pickup id filter"),
+	created_at_start: z.iso.datetime({ offset: true }).optional().describe("Include shipments created at or after this ISO 8601 timestamp"),
+	created_at_end: z.iso.datetime({ offset: true }).optional().describe("Include shipments created at or before this ISO 8601 timestamp"),
+	modified_at_start: z.iso.datetime({ offset: true }).optional().describe("Include shipments modified at or after this ISO 8601 timestamp"),
+	modified_at_end: z.iso.datetime({ offset: true }).optional().describe("Include shipments modified at or before this ISO 8601 timestamp"),
+	sales_order_id: z.string().min(1).optional().describe("Sales order id filter"),
+	shipment_number: z.string().min(1).optional().describe("Shipment number filter"),
+	ship_to_name: z.string().min(1).optional().describe("Recipient name filter"),
+	item_keyword: z.string().min(1).optional().describe("Shipment item keyword filter"),
+	payment_date_start: z.iso.datetime({ offset: true }).optional().describe("Include shipments paid at or after this ISO 8601 timestamp"),
+	payment_date_end: z.iso.datetime({ offset: true }).optional().describe("Include shipments paid at or before this ISO 8601 timestamp"),
+	store_id: z.string().min(1).optional().describe("ShipStation store id filter"),
+	external_shipment_id: z.string().min(1).optional().describe("External shipment id filter"),
+	sort_dir: z.enum(["asc", "desc"]).optional().describe("Provider slice direction; defaults to desc"),
+	sort_by: z.enum(["modified_at", "created_at"]).optional().describe("Shipment field used to sort the provider slice")
+});
+const shipstationListShipmentsPageOutputSchema = z.object({
+	items: z.array(shipstationShipmentRawSchema),
+	pagination: shipstationPaginationSchema
+});
+const shipstationListLabelsResponseSchema = z.looseObject({
+	labels: z.array(shipstationLabelRawSchema),
+	total: z.int().nonnegative(),
+	page: z.int().min(1),
+	pages: z.int().nonnegative()
+});
+const shipstationListShipmentsResponseSchema = z.looseObject({
+	shipments: z.array(shipstationShipmentRawSchema),
+	total: z.int().nonnegative(),
+	page: z.int().min(1),
+	pages: z.int().nonnegative()
+});
+//#endregion
+//#region src/vendors/shipstation/client.ts
+/**
+* ShipStation V2 vendor client.
+* Host: `new ShipstationClient(auth)`. Agent tools: `fromContext(ctx)`.
+*/
+const SHIPSTATION_API_BASE = "https://api.shipstation.com/v2";
+const DEFAULT_PAGE_SIZE = 25;
+var ShipstationClient = class ShipstationClient {
+	#http;
+	constructor(auth, options = {}) {
+		const parsed = shipstationAuthSchema.safeParse(auth);
+		if (!parsed.success) throw new ToolError("Invalid ShipStation auth credentials", {
+			code: "bad_auth",
+			details: { issues: parsed.error.issues.map((issue) => issue.message) }
+		});
+		this.#http = new HttpService({
+			...options,
+			baseURL: SHIPSTATION_API_BASE,
+			headers: {
+				Accept: "application/json",
+				"API-Key": parsed.data.api_key
+			},
+			label: "ShipStation"
+		});
+	}
+	static fromContext(ctx) {
+		const auth = requireAuth(ctx, shipstationAuthSchema);
+		return new ShipstationClient(auth, {
+			...ctx.fetch && { fetch: ctx.fetch },
+			...ctx.signal && { signal: ctx.signal }
+		});
+	}
+	/** One GET /labels request with provider pagination and filters. */
+	async listLabelsPage(input = {}) {
+		const parsedInput = shipstationListLabelsPageInputSchema.safeParse(input);
+		if (!parsedInput.success) throw new ToolError("Invalid ShipStation labels page input", {
+			code: "bad_input",
+			details: { issues: parsedInput.error.issues.map((issue) => issue.message) }
+		});
+		const page = parsedInput.data.page ?? 1;
+		const pageSize = parsedInput.data.page_size ?? DEFAULT_PAGE_SIZE;
+		const { data } = await this.#http.get("/labels", {
+			label: "ShipStation listLabelsPage",
+			query: {
+				...parsedInput.data,
+				page,
+				page_size: pageSize
+			}
+		});
+		const parsedResponse = shipstationListLabelsResponseSchema.safeParse(data);
+		if (!parsedResponse.success) throw new ToolError("ShipStation returned an invalid labels page", {
+			code: "upstream",
+			details: { issues: parsedResponse.error.issues.map((issue) => issue.message) }
+		});
+		return {
+			items: parsedResponse.data.labels,
+			pagination: {
+				total: parsedResponse.data.total,
+				page: parsedResponse.data.page,
+				pages: parsedResponse.data.pages,
+				page_size: pageSize,
+				has_more: parsedResponse.data.page < parsedResponse.data.pages
+			}
+		};
+	}
+	/** One GET /shipments request with provider pagination and filters. */
+	async listShipmentsPage(input = {}) {
+		const parsedInput = shipstationListShipmentsPageInputSchema.safeParse(input);
+		if (!parsedInput.success) throw new ToolError("Invalid ShipStation shipments page input", {
+			code: "bad_input",
+			details: { issues: parsedInput.error.issues.map((issue) => issue.message) }
+		});
+		const page = parsedInput.data.page ?? 1;
+		const pageSize = parsedInput.data.page_size ?? DEFAULT_PAGE_SIZE;
+		const { data } = await this.#http.get("/shipments", {
+			label: "ShipStation listShipmentsPage",
+			query: {
+				...parsedInput.data,
+				page,
+				page_size: pageSize
+			}
+		});
+		const parsedResponse = shipstationListShipmentsResponseSchema.safeParse(data);
+		if (!parsedResponse.success) throw new ToolError("ShipStation returned an invalid shipments page", {
+			code: "upstream",
+			details: { issues: parsedResponse.error.issues.map((issue) => issue.message) }
+		});
+		return {
+			items: parsedResponse.data.shipments,
+			pagination: {
+				total: parsedResponse.data.total,
+				page: parsedResponse.data.page,
+				pages: parsedResponse.data.pages,
+				page_size: pageSize,
+				has_more: parsedResponse.data.page < parsedResponse.data.pages
+			}
+		};
+	}
+};
+//#endregion
+//#region src/vendors/shipstation/module.ts
+const shipstationListLabelsTool = defineTool({
+	id: "shipstation-list-labels",
+	name: "shipstationListLabels",
+	description: "List one page of ShipStation labels. Filter by creation time, status, carrier, service, tracking number, shipment, warehouse, batch, rate, or refund status.",
+	inputSchema: shipstationListLabelsPageInputSchema,
+	outputSchema: shipstationListLabelsPageOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"labels",
+		"shipping",
+		"tracking",
+		"fulfillment"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listLabelsPage(input)
+});
+const shipstationListShipmentsTool = defineTool({
+	id: "shipstation-list-shipments",
+	name: "shipstationListShipments",
+	description: "List one page of ShipStation shipments. Filter by creation, modification, or payment time plus status, order, store, recipient, item, batch, pickup, or shipment identifiers.",
+	inputSchema: shipstationListShipmentsPageInputSchema,
+	outputSchema: shipstationListShipmentsPageOutputSchema,
+	sideEffect: "read",
+	runtime: "both",
+	idempotent: true,
+	network: true,
+	supportsCancel: true,
+	tags: [
+		"shipments",
+		"shipping",
+		"orders",
+		"fulfillment"
+	],
+	execute: async (input, ctx) => ShipstationClient.fromContext(ctx).listShipmentsPage(input)
+});
+const shipstationModule = defineModule({
+	id: "shipstation",
+	title: "ShipStation",
+	description: "ShipStation V2 vendor pack for paginated label and shipment reads.",
+	runtime: "both",
+	auth: {
+		type: "custom",
+		schema: shipstationAuthSchema
+	},
+	categories: ["commerce", "shipping"],
+	classification: "pii",
+	tags: [
+		"labels",
+		"shipments",
+		"tracking",
+		"fulfillment"
+	],
+	tools: [shipstationListLabelsTool, shipstationListShipmentsTool]
+});
+//#endregion
+export { ShipstationClient, shipstationAuthSchema, shipstationLabelRawSchema, shipstationListLabelsPageInputSchema, shipstationListLabelsPageOutputSchema, shipstationListLabelsResponseSchema, shipstationListLabelsTool, shipstationListShipmentsPageInputSchema, shipstationListShipmentsPageOutputSchema, shipstationListShipmentsResponseSchema, shipstationListShipmentsTool, shipstationModule, shipstationPaginationSchema, shipstationShipmentRawSchema };
+
+//# sourceMappingURL=index.js.map

package/dist/vendors/shipstation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["#http"],"sources":["../../../src/vendors/shipstation/contracts.ts","../../../src/vendors/shipstation/client.ts","../../../src/vendors/shipstation/module.ts"],"sourcesContent":["import { z } from 'zod'\n\nexport const shipstationAuthSchema = z.object({\n\tapi_key: z.string().min(1).describe('ShipStation V2 API key')\n})\n\nexport type ShipstationAuth = z.infer<typeof shipstationAuthSchema>\n\nconst shipstationPageSchema = z.int().min(1).optional().describe('Provider page number, starting at 1')\nconst shipstationPageSizeSchema = z\n\t.int()\n\t.min(1)\n\t.max(500)\n\t.optional()\n\t.describe('Records per page, from 1 to 500; defaults to 25')\n\nexport const shipstationLabelRawSchema = z.looseObject({\n\tlabel_id: z.string().min(1),\n\tshipment_id: z.string().nullable().optional(),\n\texternal_order_id: z.string().nullable().optional(),\n\ttracking_number: z.string().nullable().optional(),\n\tcreated_at: z.string().nullable().optional(),\n\tmodified_at: z.string().nullable().optional(),\n\tship_date: z.string().nullable().optional(),\n\tvoided_at: z.string().nullable().optional(),\n\tstatus: z.string().nullable().optional()\n})\n\nexport const shipstationShipmentRawSchema = z.looseObject({\n\tshipment_id: z.string().min(1),\n\texternal_order_id: z.string().nullable().optional(),\n\tshipment_number: z.string().nullable().optional(),\n\tcreated_at: z.string().nullable().optional(),\n\tmodified_at: z.string().nullable().optional(),\n\tshipment_status: z.string().nullable().optional()\n})\n\nexport const shipstationPaginationSchema = z.object({\n\ttotal: z.int().nonnegative(),\n\tpage: z.int().min(1),\n\tpages: z.int().nonnegative(),\n\tpage_size: z.int().min(1).max(500),\n\thas_more: z.boolean()\n})\n\nexport const shipstationListLabelsPageInputSchema = z.strictObject({\n\tpage: shipstationPageSchema,\n\tpage_size: shipstationPageSizeSchema,\n\tlabel_status: z.string().min(1).optional().describe('Label status filter'),\n\tservice_code: z.string().min(1).optional().describe('Carrier service code filter'),\n\tcarrier_id: z.string().min(1).optional().describe('ShipStation carrier id filter'),\n\ttracking_number: z.string().min(1).optional().describe('Exact tracking number filter'),\n\tbatch_id: z.string().min(1).optional().describe('ShipStation batch id filter'),\n\trate_id: z.string().min(1).optional().describe('ShipStation rate id filter'),\n\tshipment_id: z.string().min(1).optional().describe('ShipStation shipment id filter'),\n\texternal_shipment_id: z.string().min(1).optional().describe('External shipment id filter'),\n\twarehouse_id: z.string().min(1).optional().describe('ShipStation warehouse id filter'),\n\tcreated_at_start: z.iso\n\t\t.datetime({ offset: true })\n\t\t.optional()\n\t\t.describe('Include labels created at or after this ISO 8601 timestamp'),\n\tcreated_at_end: z.iso\n\t\t.datetime({ offset: true })\n\t\t.optional()\n\t\t.describe('Include labels created at or before this ISO 8601 timestamp'),\n\trefund_status: z.string().min(1).optional().describe('Label refund status filter'),\n\tsort_dir: z.enum(['asc', 'desc']).optional().describe('Provider slice direction; defaults to desc'),\n\tsort_by: z\n\t\t.enum(['modified_at', 'created_at', 'voided_at'])\n\t\t.optional()\n\t\t.describe('Label field used to sort the provider slice')\n})\n\nexport const shipstationListLabelsPageOutputSchema = z.object({\n\titems: z.array(shipstationLabelRawSchema),\n\tpagination: shipstationPaginationSchema\n})\n\nexport const shipstationListShipmentsPageInputSchema = z.strictObject({\n\tpage: shipstationPageSchema,\n\tpage_size: shipstationPageSizeSchema,\n\tshipment_status: z.string().min(1).optional().describe('Shipment status filter'),\n\tbatch_id: z.string().min(1).optional().describe('ShipStation batch id filter'),\n\tpickup_id: z.string().min(1).optional().describe('ShipStation pickup id filter'),\n\tcreated_at_start: z.iso\n\t\t.datetime({ offset: true })\n\t\t.optional()\n\t\t.describe('Include shipments created at or after this ISO 8601 timestamp'),\n\tcreated_at_end: z.iso\n\t\t.datetime({ offset: true })\n\t\t.optional()\n\t\t.describe('Include shipments created at or before this ISO 8601 timestamp'),\n\tmodified_at_start: z.iso\n\t\t.datetime({ offset: true })\n\t\t.optional()\n\t\t.describe('Include shipments modified at or after this ISO 8601 timestamp'),\n\tmodified_at_end: z.iso\n\t\t.datetime({ offset: true })\n\t\t.optional()\n\t\t.describe('Include shipments modified at or before this ISO 8601 timestamp'),\n\tsales_order_id: z.string().min(1).optional().describe('Sales order id filter'),\n\tshipment_number: z.string().min(1).optional().describe('Shipment number filter'),\n\tship_to_name: z.string().min(1).optional().describe('Recipient name filter'),\n\titem_keyword: z.string().min(1).optional().describe('Shipment item keyword filter'),\n\tpayment_date_start: z.iso\n\t\t.datetime({ offset: true })\n\t\t.optional()\n\t\t.describe('Include shipments paid at or after this ISO 8601 timestamp'),\n\tpayment_date_end: z.iso\n\t\t.datetime({ offset: true })\n\t\t.optional()\n\t\t.describe('Include shipments paid at or before this ISO 8601 timestamp'),\n\tstore_id: z.string().min(1).optional().describe('ShipStation store id filter'),\n\texternal_shipment_id: z.string().min(1).optional().describe('External shipment id filter'),\n\tsort_dir: z.enum(['asc', 'desc']).optional().describe('Provider slice direction; defaults to desc'),\n\tsort_by: z.enum(['modified_at', 'created_at']).optional().describe('Shipment field used to sort the provider slice')\n})\n\nexport const shipstationListShipmentsPageOutputSchema = z.object({\n\titems: z.array(shipstationShipmentRawSchema),\n\tpagination: shipstationPaginationSchema\n})\n\nexport const shipstationListLabelsResponseSchema = z.looseObject({\n\tlabels: z.array(shipstationLabelRawSchema),\n\ttotal: z.int().nonnegative(),\n\tpage: z.int().min(1),\n\tpages: z.int().nonnegative()\n})\n\nexport const shipstationListShipmentsResponseSchema = z.looseObject({\n\tshipments: z.array(shipstationShipmentRawSchema),\n\ttotal: z.int().nonnegative(),\n\tpage: z.int().min(1),\n\tpages: z.int().nonnegative()\n})\n\nexport type ShipstationLabelRaw = z.infer<typeof shipstationLabelRawSchema>\nexport type ShipstationShipmentRaw = z.infer<typeof shipstationShipmentRawSchema>\nexport type ShipstationPagination = z.infer<typeof shipstationPaginationSchema>\nexport type ShipstationListLabelsPageInput = z.infer<typeof shipstationListLabelsPageInputSchema>\nexport type ShipstationListLabelsPageOutput = z.infer<typeof shipstationListLabelsPageOutputSchema>\nexport type ShipstationListShipmentsPageInput = z.infer<typeof shipstationListShipmentsPageInputSchema>\nexport type ShipstationListShipmentsPageOutput = z.infer<typeof shipstationListShipmentsPageOutputSchema>\n","/**\n * ShipStation V2 vendor client.\n * Host: `new ShipstationClient(auth)`. Agent tools: `fromContext(ctx)`.\n */\n\nimport { ToolError } from '../../core/errors'\nimport { requireAuth } from '../../core/provider'\nimport type { ToolContext } from '../../core/types'\nimport { HttpService } from '../../transport/http-service'\nimport type { HttpServiceOptions } from '../../transport/http-service'\nimport type {\n\tShipstationAuth,\n\tShipstationListLabelsPageInput,\n\tShipstationListLabelsPageOutput,\n\tShipstationListShipmentsPageInput,\n\tShipstationListShipmentsPageOutput\n} from './contracts'\nimport {\n\tshipstationAuthSchema,\n\tshipstationListLabelsPageInputSchema,\n\tshipstationListLabelsResponseSchema,\n\tshipstationListShipmentsPageInputSchema,\n\tshipstationListShipmentsResponseSchema\n} from './contracts'\n\nconst SHIPSTATION_API_BASE = 'https://api.shipstation.com/v2'\nconst DEFAULT_PAGE_SIZE = 25\n\nexport type ShipstationClientOptions = Pick<HttpServiceOptions, 'fetch' | 'signal'>\n\nexport class ShipstationClient {\n\treadonly #http: HttpService\n\n\tconstructor(auth: ShipstationAuth, options: ShipstationClientOptions = {}) {\n\t\tconst parsed = shipstationAuthSchema.safeParse(auth)\n\t\tif (!parsed.success) {\n\t\t\tthrow new ToolError('Invalid ShipStation auth credentials', {\n\t\t\t\tcode: 'bad_auth',\n\t\t\t\tdetails: { issues: parsed.error.issues.map((issue) => issue.message) }\n\t\t\t})\n\t\t}\n\n\t\tthis.#http = new HttpService({\n\t\t\t...options,\n\t\t\tbaseURL: SHIPSTATION_API_BASE,\n\t\t\theaders: {\n\t\t\t\tAccept: 'application/json',\n\t\t\t\t'API-Key': parsed.data.api_key\n\t\t\t},\n\t\t\tlabel: 'ShipStation'\n\t\t})\n\t}\n\n\tstatic fromContext(ctx: ToolContext): ShipstationClient {\n\t\tconst auth = requireAuth(ctx, shipstationAuthSchema)\n\t\treturn new ShipstationClient(auth, {\n\t\t\t...(ctx.fetch && { fetch: ctx.fetch }),\n\t\t\t...(ctx.signal && { signal: ctx.signal })\n\t\t})\n\t}\n\n\t/** One GET /labels request with provider pagination and filters. */\n\tasync listLabelsPage(input: ShipstationListLabelsPageInput = {}): Promise<ShipstationListLabelsPageOutput> {\n\t\tconst parsedInput = shipstationListLabelsPageInputSchema.safeParse(input)\n\t\tif (!parsedInput.success) {\n\t\t\tthrow new ToolError('Invalid ShipStation labels page input', {\n\t\t\t\tcode: 'bad_input',\n\t\t\t\tdetails: { issues: parsedInput.error.issues.map((issue) => issue.message) }\n\t\t\t})\n\t\t}\n\n\t\tconst page = parsedInput.data.page ?? 1\n\t\tconst pageSize = parsedInput.data.page_size ?? DEFAULT_PAGE_SIZE\n\t\tconst { data } = await this.#http.get('/labels', {\n\t\t\tlabel: 'ShipStation listLabelsPage',\n\t\t\tquery: { ...parsedInput.data, page, page_size: pageSize }\n\t\t})\n\t\tconst parsedResponse = shipstationListLabelsResponseSchema.safeParse(data)\n\t\tif (!parsedResponse.success) {\n\t\t\tthrow new ToolError('ShipStation returned an invalid labels page', {\n\t\t\t\tcode: 'upstream',\n\t\t\t\tdetails: { issues: parsedResponse.error.issues.map((issue) => issue.message) }\n\t\t\t})\n\t\t}\n\n\t\treturn {\n\t\t\titems: parsedResponse.data.labels,\n\t\t\tpagination: {\n\t\t\t\ttotal: parsedResponse.data.total,\n\t\t\t\tpage: parsedResponse.data.page,\n\t\t\t\tpages: parsedResponse.data.pages,\n\t\t\t\tpage_size: pageSize,\n\t\t\t\thas_more: parsedResponse.data.page < parsedResponse.data.pages\n\t\t\t}\n\t\t}\n\t}\n\n\t/** One GET /shipments request with provider pagination and filters. */\n\tasync listShipmentsPage(input: ShipstationListShipmentsPageInput = {}): Promise<ShipstationListShipmentsPageOutput> {\n\t\tconst parsedInput = shipstationListShipmentsPageInputSchema.safeParse(input)\n\t\tif (!parsedInput.success) {\n\t\t\tthrow new ToolError('Invalid ShipStation shipments page input', {\n\t\t\t\tcode: 'bad_input',\n\t\t\t\tdetails: { issues: parsedInput.error.issues.map((issue) => issue.message) }\n\t\t\t})\n\t\t}\n\n\t\tconst page = parsedInput.data.page ?? 1\n\t\tconst pageSize = parsedInput.data.page_size ?? DEFAULT_PAGE_SIZE\n\t\tconst { data } = await this.#http.get('/shipments', {\n\t\t\tlabel: 'ShipStation listShipmentsPage',\n\t\t\tquery: { ...parsedInput.data, page, page_size: pageSize }\n\t\t})\n\t\tconst parsedResponse = shipstationListShipmentsResponseSchema.safeParse(data)\n\t\tif (!parsedResponse.success) {\n\t\t\tthrow new ToolError('ShipStation returned an invalid shipments page', {\n\t\t\t\tcode: 'upstream',\n\t\t\t\tdetails: { issues: parsedResponse.error.issues.map((issue) => issue.message) }\n\t\t\t})\n\t\t}\n\n\t\treturn {\n\t\t\titems: parsedResponse.data.shipments,\n\t\t\tpagination: {\n\t\t\t\ttotal: parsedResponse.data.total,\n\t\t\t\tpage: parsedResponse.data.page,\n\t\t\t\tpages: parsedResponse.data.pages,\n\t\t\t\tpage_size: pageSize,\n\t\t\t\thas_more: parsedResponse.data.page < parsedResponse.data.pages\n\t\t\t}\n\t\t}\n\t}\n}\n","import { defineModule, defineTool } from '../../core/define'\nimport { ShipstationClient } from './client'\nimport {\n\tshipstationAuthSchema,\n\tshipstationListLabelsPageInputSchema,\n\tshipstationListLabelsPageOutputSchema,\n\tshipstationListShipmentsPageInputSchema,\n\tshipstationListShipmentsPageOutputSchema\n} from './contracts'\n\nexport const shipstationListLabelsTool = defineTool({\n\tid: 'shipstation-list-labels',\n\tname: 'shipstationListLabels',\n\tdescription:\n\t\t'List one page of ShipStation labels. Filter by creation time, status, carrier, service, tracking number, shipment, warehouse, batch, rate, or refund status.',\n\tinputSchema: shipstationListLabelsPageInputSchema,\n\toutputSchema: shipstationListLabelsPageOutputSchema,\n\tsideEffect: 'read',\n\truntime: 'both',\n\tidempotent: true,\n\tnetwork: true,\n\tsupportsCancel: true,\n\ttags: ['labels', 'shipping', 'tracking', 'fulfillment'],\n\texecute: async (input, ctx) => ShipstationClient.fromContext(ctx).listLabelsPage(input)\n})\n\nexport const shipstationListShipmentsTool = defineTool({\n\tid: 'shipstation-list-shipments',\n\tname: 'shipstationListShipments',\n\tdescription:\n\t\t'List one page of ShipStation shipments. Filter by creation, modification, or payment time plus status, order, store, recipient, item, batch, pickup, or shipment identifiers.',\n\tinputSchema: shipstationListShipmentsPageInputSchema,\n\toutputSchema: shipstationListShipmentsPageOutputSchema,\n\tsideEffect: 'read',\n\truntime: 'both',\n\tidempotent: true,\n\tnetwork: true,\n\tsupportsCancel: true,\n\ttags: ['shipments', 'shipping', 'orders', 'fulfillment'],\n\texecute: async (input, ctx) => ShipstationClient.fromContext(ctx).listShipmentsPage(input)\n})\n\nexport const shipstationModule = defineModule({\n\tid: 'shipstation',\n\ttitle: 'ShipStation',\n\tdescription: 'ShipStation V2 vendor pack for paginated label and shipment reads.',\n\truntime: 'both',\n\tauth: { type: 'custom', schema: shipstationAuthSchema },\n\tcategories: ['commerce', 'shipping'],\n\tclassification: 'pii',\n\ttags: ['labels', 'shipments', 'tracking', 'fulfillment'],\n\ttools: [shipstationListLabelsTool, shipstationListShipmentsTool]\n})\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@5ss/ai-tools",
-	"version": "3.5.1",
+	"version": "3.6.0",
 	"description": "Reusable AI tools with strict schemas and model-facing contracts. Define once; project to Node, edge, Mastra, AI SDK, TanStack AI, Cloudflare Workers AI, or MCP.",
 	"license": "MIT",
 	"author": "harryy",
@@ -166,6 +166,10 @@
 			"types": "./dist/modules/scheduler/index.d.ts",
 			"default": "./dist/modules/scheduler/index.js"
 		},
+		"./shipstation": {
+			"types": "./dist/vendors/shipstation/index.d.ts",
+			"default": "./dist/vendors/shipstation/index.js"
+		},
 		"./skills": {
 			"types": "./dist/modules/skills/index.d.ts",
 			"default": "./dist/modules/skills/index.js"