@yolk-sdk/agent 0.1.0-canary.61 → 0.1.0-canary.63

package/README.md

@@ -177,7 +177,10 @@ Required authorization and JSON headers cannot be replaced through `extraHeaders
 
 Grok subscription access uses `https://cli-chat-proxy.grok.com/v1/responses`, not the xAI developer
 API-key endpoint. The adapter sends the required CLI-session and model-routing headers and rejects
-mismatched or expired access-token envelopes before HTTP. The package exports browser-PKCE and
+mismatched or expired access-token envelopes before HTTP. `makeXAiGrokProviderLayer` also requires
+a truthful host-owned `clientVersion`, sent as `x-grok-client-version`, because the xAI CLI proxy
+version-gates requests and rejects missing or outdated versions with HTTP 426; required headers
+stay non-overridable through `extraHeaders`. The package exports browser-PKCE and
 device-flow constants; hosts own the callback listener or device polling, token exchange/refresh,
 secure storage, and model discovery. Only set `responsesUrl` to a trusted proxy because it receives
 the OAuth bearer. xAI controls the public CLI OAuth client and private, unsupported proxy contract,

package/dist/providers/xai/grok-provider.d.mts

@@ -8,7 +8,13 @@ import { OAuthAccessToken } from "@yolk-sdk/agent/oauth";
 type XAiGrokReasoningSummary = 'auto' | 'concise' | 'detailed';
 type XAiGrokProviderConfig = {
   readonly token: OAuthAccessToken;
-  readonly maxOutputTokens: number; /** Override only with a trusted proxy because the OAuth bearer is sent to this URL. */
+  readonly maxOutputTokens: number;
+  /**
+   * Grok CLI client version sent as `x-grok-client-version`. The xAI CLI proxy version-gates
+   * requests and rejects missing or outdated versions with HTTP 426. The host owns this value and
+   * must use the proxy only as permitted by xAI's terms.
+   */
+  readonly clientVersion: string; /** Override only with a trusted proxy because the OAuth bearer is sent to this URL. */
   readonly responsesUrl?: string;
   readonly extraHeaders?: Readonly<Record<string, string>>;
   readonly defaultReasoningEffort?: AgentReasoningEffort;

package/dist/providers/xai/grok-provider.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"grok-provider.d.mts","names":[],"sources":["../../../src/providers/xai/grok-provider.ts"],"mappings":";;;;;;;KAaY,uBAAA;AAAA,KAEA,qBAAA;EAAA,SACD,KAAA,EAAO,gBAAA;EAAA,SACP,eAAA;WAEA,YAAA;EAAA,SACA,YAAA,GAAe,QAAA,CAAS,MAAA;EAAA,SACxB,sBAAA,GAAyB,oBAAA;EAAA,SACzB,gBAAA,GAAmB,uBAAA;AAAA;AAAA,KAGzB,oBAAA;EAAA,SACM,IAAA;EAAA,SACA,IAAI;AAAA;AAAA,KAGV,qBAAA;EAAA,SACM,IAAA;EAAA,SACA,SAAS;AAAA;AAAA,KAGf,oBAAA;EAAA,SAEU,IAAA;EAAA,SACA,QAAA;EAAA,SACA,SAAA;AAAA;EAAA,SAGA,IAAA;EAAA,SACA,QAAA;AAAA;AAAA,KAGV,uBAAA,GAA0B,oBAAA,GAAuB,qBAAA,GAAwB,oBAAA;AAAA,KAEzE,mBAAA;EAAA,SACM,IAAA;EAAA,SACA,OAAA,WAAkB,aAAa,CAAC,uBAAA;AAAA;AAAA,KAGtC,wBAAA;EAAA,SACM,IAAA;EAAA,SACA,OAAA;EAAA,SACA,IAAA;EAAA,SACA,SAAA;AAAA;AAAA,KAGN,0BAAA;EAAA,SACM,IAAA;EAAA,SACA,OAAA;EAAA,SACA,MAAA,WAAiB,aAAa,CAAC,uBAAA;AAAA;AAAA,KAGrC,gBAAA,GAAmB,mBAAA,GAAsB,wBAAA,GAA2B,0BAAA;AAAA,KAEpE,WAAA;EAAA,SACM,IAAA;EAAA,SACA,IAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA;AAAA;AAAA,KAGN,kBAAA;EAAA,SACM,KAAA;EAAA,SACA,YAAA;EAAA,SACA,KAAA,EAAO,aAAA,CAAc,gBAAA;EAAA,SACrB,KAAA;EAAA,SACA,MAAA;EAAA,SACA,iBAAA;EAAA,SACA,SAAA;IAAA,SACE,MAAA,EAAQ,oBAAA;IAAA,SACR,OAAA,EAAS,uBAAA;EAAA;EAAA,SAEX,KAAA,GAAQ,aAAA,CAAc,WAAA;EAAA,SACtB,mBAAA;AAAA;AAAA,cASE,oBAAA,GACX,OAAA,EAAS,UAAA,EACT,MAAA;EAAA,SACW,eAAA;EAAA,SACA,sBAAA,GAAyB,oBAAA;EAAA,SACzB,gBAAA,GAAmB,uBAAA;AAAA,MAE7B,MAAA,CAAO,MAAA,CAAO,kBAAA,EAAoB,QAAA;AAAA,cAYxB,qBAAA,GAAyB,QAAA,EAAU,kBAAA,CAAmB,kBAAA,6BAAkB,MAAA,gCAAA,YAAA,kCAAA,iBAAA,kCAAA,OAAA,kCAAA,WAAA,kCAAA,iBAAA,kCAAA,iBAAA,kCAAA,qBAAA,kCAAA,QAAA,EAAA,QAAA;AAAA,cAGxE,wBAAA,GAA4B,MAAA,EAAQ,qBAAqB,4BAAA,KAAA,gCAAA,WAAA,mDAAA,UAAA"}
+{"version":3,"file":"grok-provider.d.mts","names":[],"sources":["../../../src/providers/xai/grok-provider.ts"],"mappings":";;;;;;;KAaY,uBAAA;AAAA,KAEA,qBAAA;EAAA,SACD,KAAA,EAAO,gBAAA;EAAA,SACP,eAAA;;;AAJwB;AAEnC;;WAQW,aAAA,UAPO;EAAA,SASP,YAAA;EAAA,SACA,YAAA,GAAe,QAAA,CAAS,MAAA;EAAA,SACxB,sBAAA,GAAyB,oBAAA;EAAA,SACzB,gBAAA,GAAmB,uBAAA;AAAA;AAAA,KAGzB,oBAAA;EAAA,SACM,IAAA;EAAA,SACA,IAAI;AAAA;AAAA,KAGV,qBAAA;EAAA,SACM,IAAA;EAAA,SACA,SAAS;AAAA;AAAA,KAGf,oBAAA;EAAA,SAEU,IAAA;EAAA,SACA,QAAA;EAAA,SACA,SAAA;AAAA;EAAA,SAGA,IAAA;EAAA,SACA,QAAA;AAAA;AAAA,KAGV,uBAAA,GAA0B,oBAAA,GAAuB,qBAAA,GAAwB,oBAAA;AAAA,KAEzE,mBAAA;EAAA,SACM,IAAA;EAAA,SACA,OAAA,WAAkB,aAAa,CAAC,uBAAA;AAAA;AAAA,KAGtC,wBAAA;EAAA,SACM,IAAA;EAAA,SACA,OAAA;EAAA,SACA,IAAA;EAAA,SACA,SAAA;AAAA;AAAA,KAGN,0BAAA;EAAA,SACM,IAAA;EAAA,SACA,OAAA;EAAA,SACA,MAAA,WAAiB,aAAa,CAAC,uBAAA;AAAA;AAAA,KAGrC,gBAAA,GAAmB,mBAAA,GAAsB,wBAAA,GAA2B,0BAAA;AAAA,KAEpE,WAAA;EAAA,SACM,IAAA;EAAA,SACA,IAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA;AAAA;AAAA,KAGN,kBAAA;EAAA,SACM,KAAA;EAAA,SACA,YAAA;EAAA,SACA,KAAA,EAAO,aAAA,CAAc,gBAAA;EAAA,SACrB,KAAA;EAAA,SACA,MAAA;EAAA,SACA,iBAAA;EAAA,SACA,SAAA;IAAA,SACE,MAAA,EAAQ,oBAAA;IAAA,SACR,OAAA,EAAS,uBAAA;EAAA;EAAA,SAEX,KAAA,GAAQ,aAAA,CAAc,WAAA;EAAA,SACtB,mBAAA;AAAA;AAAA,cASE,oBAAA,GACX,OAAA,EAAS,UAAA,EACT,MAAA;EAAA,SACW,eAAA;EAAA,SACA,sBAAA,GAAyB,oBAAA;EAAA,SACzB,gBAAA,GAAmB,uBAAA;AAAA,MAE7B,MAAA,CAAO,MAAA,CAAO,kBAAA,EAAoB,QAAA;AAAA,cAYxB,qBAAA,GAAyB,QAAA,EAAU,kBAAA,CAAmB,kBAAA,6BAAkB,MAAA,gCAAA,YAAA,kCAAA,iBAAA,kCAAA,OAAA,kCAAA,WAAA,kCAAA,iBAAA,kCAAA,iBAAA,kCAAA,qBAAA,kCAAA,QAAA,EAAA,QAAA;AAAA,cAGxE,wBAAA,GAA4B,MAAA,EAAQ,qBAAqB,4BAAA,KAAA,gCAAA,WAAA,mDAAA,UAAA"}

package/dist/providers/xai/grok-provider.mjs

@@ -21,7 +21,10 @@ const makeXAiGrokProviderLayer = (config) => makeOpenAiResponsesProviderLayer({
 	providerId: xAiGrokProviderDescriptor.providerId,
 	providerName: xAiGrokProviderDescriptor.providerName,
 	responsesUrl: config.responsesUrl ?? "https://cli-chat-proxy.grok.com/v1/responses",
-	authorizationHeaders: xAiGrokAuthorizationHeaders,
+	authorizationHeaders: (token, model) => ({
+		...xAiGrokAuthorizationHeaders(token, model),
+		"x-grok-client-version": config.clientVersion
+	}),
 	alwaysIncludeReasoning: false,
 	allowEofCompletion: false,
 	expectedTokenProvider: xAiGrokProviderId

package/dist/providers/xai/grok-provider.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"grok-provider.mjs","names":[],"sources":["../../../src/providers/xai/grok-provider.ts"],"sourcesContent":["import type { AgentReasoningEffort } from '@yolk-sdk/agent/protocol'\nimport { Effect } from 'effect'\nimport type { LLMError, LLMRequest } from '@yolk-sdk/agent/loop'\nimport type { OAuthAccessToken } from '@yolk-sdk/agent/oauth'\nimport type { HttpClientResponse } from 'effect/unstable/http'\nimport {\n  makeOpenAiResponsesProviderLayer,\n  streamOpenAiResponsesResponse,\n  toOpenAiResponsesRequestBody,\n  withOpenAiResponsesProviderName\n} from '../openai-responses-provider-internal.ts'\nimport { xAiGrokAuthorizationHeaders, xAiGrokProviderId, xAiGrokResponsesUrl } from './grok.ts'\n\nexport type XAiGrokReasoningSummary = 'auto' | 'concise' | 'detailed'\n\nexport type XAiGrokProviderConfig = {\n  readonly token: OAuthAccessToken\n  readonly maxOutputTokens: number\n  /** Override only with a trusted proxy because the OAuth bearer is sent to this URL. */\n  readonly responsesUrl?: string\n  readonly extraHeaders?: Readonly<Record<string, string>>\n  readonly defaultReasoningEffort?: AgentReasoningEffort\n  readonly reasoningSummary?: XAiGrokReasoningSummary\n}\n\ntype XAiGrokInputTextPart = {\n  readonly type: 'input_text'\n  readonly text: string\n}\n\ntype XAiGrokInputImagePart = {\n  readonly type: 'input_image'\n  readonly image_url: string\n}\n\ntype XAiGrokInputFilePart =\n  | {\n      readonly type: 'input_file'\n      readonly filename: string\n      readonly file_data: string\n    }\n  | {\n      readonly type: 'input_file'\n      readonly file_url: string\n    }\n\ntype XAiGrokInputContentPart = XAiGrokInputTextPart | XAiGrokInputImagePart | XAiGrokInputFilePart\n\ntype XAiGrokMessageInput = {\n  readonly role: 'user' | 'assistant'\n  readonly content: string | ReadonlyArray<XAiGrokInputContentPart>\n}\n\ntype XAiGrokFunctionCallInput = {\n  readonly type: 'function_call'\n  readonly call_id: string\n  readonly name: string\n  readonly arguments: string\n}\n\ntype XAiGrokFunctionOutputInput = {\n  readonly type: 'function_call_output'\n  readonly call_id: string\n  readonly output: string | ReadonlyArray<XAiGrokInputContentPart>\n}\n\ntype XAiGrokInputItem = XAiGrokMessageInput | XAiGrokFunctionCallInput | XAiGrokFunctionOutputInput\n\ntype XAiGrokTool = {\n  readonly type: 'function'\n  readonly name: string\n  readonly description: string\n  readonly parameters: unknown\n}\n\ntype XAiGrokRequestBody = {\n  readonly model: string\n  readonly instructions: string\n  readonly input: ReadonlyArray<XAiGrokInputItem>\n  readonly store: false\n  readonly stream: true\n  readonly max_output_tokens: number\n  readonly reasoning?: {\n    readonly effort: AgentReasoningEffort\n    readonly summary: XAiGrokReasoningSummary\n  }\n  readonly tools?: ReadonlyArray<XAiGrokTool>\n  readonly parallel_tool_calls?: true\n}\n\nconst xAiGrokProviderDescriptor = {\n  providerId: 'xai_grok',\n  providerName: 'xAI Grok subscription',\n  allowEofCompletion: false\n} as const\n\nexport const toXAiGrokRequestBody = (\n  request: LLMRequest,\n  config: {\n    readonly maxOutputTokens: number\n    readonly defaultReasoningEffort?: AgentReasoningEffort\n    readonly reasoningSummary?: XAiGrokReasoningSummary\n  }\n): Effect.Effect<XAiGrokRequestBody, LLMError> =>\n  toOpenAiResponsesRequestBody(request, {\n    ...config,\n    providerName: xAiGrokProviderDescriptor.providerName,\n    alwaysIncludeReasoning: false\n  }).pipe(\n    Effect.map(body => ({ ...body, max_output_tokens: config.maxOutputTokens })),\n    Effect.mapError(error =>\n      withOpenAiResponsesProviderName(xAiGrokProviderDescriptor.providerName, error)\n    )\n  )\n\nexport const streamXAiGrokResponse = (response: HttpClientResponse.HttpClientResponse) =>\n  streamOpenAiResponsesResponse(xAiGrokProviderDescriptor, response)\n\nexport const makeXAiGrokProviderLayer = (config: XAiGrokProviderConfig) =>\n  makeOpenAiResponsesProviderLayer({\n    ...config,\n    providerId: xAiGrokProviderDescriptor.providerId,\n    providerName: xAiGrokProviderDescriptor.providerName,\n    responsesUrl: config.responsesUrl ?? xAiGrokResponsesUrl,\n    authorizationHeaders: xAiGrokAuthorizationHeaders,\n    alwaysIncludeReasoning: false,\n    allowEofCompletion: false,\n    expectedTokenProvider: xAiGrokProviderId\n  })\n"],"mappings":";;;;AA0FA,MAAM,4BAA4B;CAChC,YAAY;CACZ,cAAc;CACd,oBAAoB;AACtB;AAEA,MAAa,wBACX,SACA,WAMA,6BAA6B,SAAS;CACpC,GAAG;CACH,cAAc,0BAA0B;CACxC,wBAAwB;AAC1B,CAAC,EAAE,KACD,OAAO,KAAI,UAAS;CAAE,GAAG;CAAM,mBAAmB,OAAO;AAAgB,EAAE,GAC3E,OAAO,UAAS,UACd,gCAAgC,0BAA0B,cAAc,KAAK,CAC/E,CACF;AAEF,MAAa,yBAAyB,aACpC,8BAA8B,2BAA2B,QAAQ;AAEnE,MAAa,4BAA4B,WACvC,iCAAiC;CAC/B,GAAG;CACH,YAAY,0BAA0B;CACtC,cAAc,0BAA0B;CACxC,cAAc,OAAO,gBAAA;CACrB,sBAAsB;CACtB,wBAAwB;CACxB,oBAAoB;CACpB,uBAAuB;AACzB,CAAC"}
+{"version":3,"file":"grok-provider.mjs","names":[],"sources":["../../../src/providers/xai/grok-provider.ts"],"sourcesContent":["import type { AgentReasoningEffort } from '@yolk-sdk/agent/protocol'\nimport { Effect } from 'effect'\nimport type { LLMError, LLMRequest } from '@yolk-sdk/agent/loop'\nimport type { OAuthAccessToken } from '@yolk-sdk/agent/oauth'\nimport type { HttpClientResponse } from 'effect/unstable/http'\nimport {\n  makeOpenAiResponsesProviderLayer,\n  streamOpenAiResponsesResponse,\n  toOpenAiResponsesRequestBody,\n  withOpenAiResponsesProviderName\n} from '../openai-responses-provider-internal.ts'\nimport { xAiGrokAuthorizationHeaders, xAiGrokProviderId, xAiGrokResponsesUrl } from './grok.ts'\n\nexport type XAiGrokReasoningSummary = 'auto' | 'concise' | 'detailed'\n\nexport type XAiGrokProviderConfig = {\n  readonly token: OAuthAccessToken\n  readonly maxOutputTokens: number\n  /**\n   * Grok CLI client version sent as `x-grok-client-version`. The xAI CLI proxy version-gates\n   * requests and rejects missing or outdated versions with HTTP 426. The host owns this value and\n   * must use the proxy only as permitted by xAI's terms.\n   */\n  readonly clientVersion: string\n  /** Override only with a trusted proxy because the OAuth bearer is sent to this URL. */\n  readonly responsesUrl?: string\n  readonly extraHeaders?: Readonly<Record<string, string>>\n  readonly defaultReasoningEffort?: AgentReasoningEffort\n  readonly reasoningSummary?: XAiGrokReasoningSummary\n}\n\ntype XAiGrokInputTextPart = {\n  readonly type: 'input_text'\n  readonly text: string\n}\n\ntype XAiGrokInputImagePart = {\n  readonly type: 'input_image'\n  readonly image_url: string\n}\n\ntype XAiGrokInputFilePart =\n  | {\n      readonly type: 'input_file'\n      readonly filename: string\n      readonly file_data: string\n    }\n  | {\n      readonly type: 'input_file'\n      readonly file_url: string\n    }\n\ntype XAiGrokInputContentPart = XAiGrokInputTextPart | XAiGrokInputImagePart | XAiGrokInputFilePart\n\ntype XAiGrokMessageInput = {\n  readonly role: 'user' | 'assistant'\n  readonly content: string | ReadonlyArray<XAiGrokInputContentPart>\n}\n\ntype XAiGrokFunctionCallInput = {\n  readonly type: 'function_call'\n  readonly call_id: string\n  readonly name: string\n  readonly arguments: string\n}\n\ntype XAiGrokFunctionOutputInput = {\n  readonly type: 'function_call_output'\n  readonly call_id: string\n  readonly output: string | ReadonlyArray<XAiGrokInputContentPart>\n}\n\ntype XAiGrokInputItem = XAiGrokMessageInput | XAiGrokFunctionCallInput | XAiGrokFunctionOutputInput\n\ntype XAiGrokTool = {\n  readonly type: 'function'\n  readonly name: string\n  readonly description: string\n  readonly parameters: unknown\n}\n\ntype XAiGrokRequestBody = {\n  readonly model: string\n  readonly instructions: string\n  readonly input: ReadonlyArray<XAiGrokInputItem>\n  readonly store: false\n  readonly stream: true\n  readonly max_output_tokens: number\n  readonly reasoning?: {\n    readonly effort: AgentReasoningEffort\n    readonly summary: XAiGrokReasoningSummary\n  }\n  readonly tools?: ReadonlyArray<XAiGrokTool>\n  readonly parallel_tool_calls?: true\n}\n\nconst xAiGrokProviderDescriptor = {\n  providerId: 'xai_grok',\n  providerName: 'xAI Grok subscription',\n  allowEofCompletion: false\n} as const\n\nexport const toXAiGrokRequestBody = (\n  request: LLMRequest,\n  config: {\n    readonly maxOutputTokens: number\n    readonly defaultReasoningEffort?: AgentReasoningEffort\n    readonly reasoningSummary?: XAiGrokReasoningSummary\n  }\n): Effect.Effect<XAiGrokRequestBody, LLMError> =>\n  toOpenAiResponsesRequestBody(request, {\n    ...config,\n    providerName: xAiGrokProviderDescriptor.providerName,\n    alwaysIncludeReasoning: false\n  }).pipe(\n    Effect.map(body => ({ ...body, max_output_tokens: config.maxOutputTokens })),\n    Effect.mapError(error =>\n      withOpenAiResponsesProviderName(xAiGrokProviderDescriptor.providerName, error)\n    )\n  )\n\nexport const streamXAiGrokResponse = (response: HttpClientResponse.HttpClientResponse) =>\n  streamOpenAiResponsesResponse(xAiGrokProviderDescriptor, response)\n\nexport const makeXAiGrokProviderLayer = (config: XAiGrokProviderConfig) =>\n  makeOpenAiResponsesProviderLayer({\n    ...config,\n    providerId: xAiGrokProviderDescriptor.providerId,\n    providerName: xAiGrokProviderDescriptor.providerName,\n    responsesUrl: config.responsesUrl ?? xAiGrokResponsesUrl,\n    authorizationHeaders: (token, model) => ({\n      ...xAiGrokAuthorizationHeaders(token, model),\n      'x-grok-client-version': config.clientVersion\n    }),\n    alwaysIncludeReasoning: false,\n    allowEofCompletion: false,\n    expectedTokenProvider: xAiGrokProviderId\n  })\n"],"mappings":";;;;AAgGA,MAAM,4BAA4B;CAChC,YAAY;CACZ,cAAc;CACd,oBAAoB;AACtB;AAEA,MAAa,wBACX,SACA,WAMA,6BAA6B,SAAS;CACpC,GAAG;CACH,cAAc,0BAA0B;CACxC,wBAAwB;AAC1B,CAAC,EAAE,KACD,OAAO,KAAI,UAAS;CAAE,GAAG;CAAM,mBAAmB,OAAO;AAAgB,EAAE,GAC3E,OAAO,UAAS,UACd,gCAAgC,0BAA0B,cAAc,KAAK,CAC/E,CACF;AAEF,MAAa,yBAAyB,aACpC,8BAA8B,2BAA2B,QAAQ;AAEnE,MAAa,4BAA4B,WACvC,iCAAiC;CAC/B,GAAG;CACH,YAAY,0BAA0B;CACtC,cAAc,0BAA0B;CACxC,cAAc,OAAO,gBAAA;CACrB,uBAAuB,OAAO,WAAW;EACvC,GAAG,4BAA4B,OAAO,KAAK;EAC3C,yBAAyB,OAAO;CAClC;CACA,wBAAwB;CACxB,oBAAoB;CACpB,uBAAuB;AACzB,CAAC"}

package/dist/skillset/merge.d.mts

@@ -27,6 +27,7 @@ declare const mergeSkillsets: (sources: ReadonlyArray<SkillsetSource>) => Effect
     readonly template: string;
     readonly description?: string | undefined;
     readonly source?: string | undefined;
+    readonly location?: string | undefined;
     readonly arguments?: readonly {
       readonly required: boolean;
       readonly name: string;
@@ -34,7 +35,6 @@ declare const mergeSkillsets: (sources: ReadonlyArray<SkillsetSource>) => Effect
     }[] | undefined;
     readonly access?: "read" | "write" | "destructive" | undefined;
     readonly fileRefs?: boolean | undefined;
-    readonly location?: string | undefined;
   }[];
 }, SkillsetError, never>;
 //#endregion

package/dist/skillset/name.d.mts

@@ -3,8 +3,8 @@ import { Effect } from "effect";
 
 //#region src/skillset/name.d.ts
 declare const isValidSkillsetName: (name: string) => boolean;
-declare const validateSkillsetName: (name: string) => Effect.Effect<string, never, never> | Effect.Effect<never, SkillsetError, never>;
-declare const validateDirectoryName: (expected: string, actual: string) => Effect.Effect<string, never, never> | Effect.Effect<never, SkillsetError, never>;
+declare const validateSkillsetName: (name: string) => Effect.Effect<never, SkillsetError, never> | Effect.Effect<string, never, never>;
+declare const validateDirectoryName: (expected: string, actual: string) => Effect.Effect<never, SkillsetError, never> | Effect.Effect<string, never, never>;
 //#endregion
 export { isValidSkillsetName, validateDirectoryName, validateSkillsetName };
 //# sourceMappingURL=name.d.mts.map

package/dist/skillset/name.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"name.d.mts","names":[],"sources":["../../src/skillset/name.ts"],"mappings":";;;;cAMa,mBAAA,GAAuB,IAAY;AAAA,cAGnC,oBAAA,GAAwB,IAAA,aAAY,MAAA,CAAA,MAAA,yBAAA,MAAA,CAAA,MAAA,QAAA,aAAA;AAAA,cAUpC,qBAAA,GAAyB,QAAA,UAAkB,MAAA,aAAc,MAAA,CAAA,MAAA,yBAAA,MAAA,CAAA,MAAA,QAAA,aAAA"}
+{"version":3,"file":"name.d.mts","names":[],"sources":["../../src/skillset/name.ts"],"mappings":";;;;cAMa,mBAAA,GAAuB,IAAY;AAAA,cAGnC,oBAAA,GAAwB,IAAA,aAAY,MAAA,CAAA,MAAA,QAAA,aAAA,WAAA,MAAA,CAAA,MAAA;AAAA,cAUpC,qBAAA,GAAyB,QAAA,UAAkB,MAAA,aAAc,MAAA,CAAA,MAAA,QAAA,aAAA,WAAA,MAAA,CAAA,MAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yolk-sdk/agent",
-  "version": "0.1.0-canary.61",
+  "version": "0.1.0-canary.63",
   "description": "Protocol, loop, runtime, client, compaction, tools, React, providers, OAuth, skillset, and voice primitives for building Yolk agents.",
   "license": "MIT",
   "type": "module",

package/src/providers/xai/grok-provider.ts

@@ -16,6 +16,12 @@ export type XAiGrokReasoningSummary = 'auto' | 'concise' | 'detailed'
 export type XAiGrokProviderConfig = {
   readonly token: OAuthAccessToken
   readonly maxOutputTokens: number
+  /**
+   * Grok CLI client version sent as `x-grok-client-version`. The xAI CLI proxy version-gates
+   * requests and rejects missing or outdated versions with HTTP 426. The host owns this value and
+   * must use the proxy only as permitted by xAI's terms.
+   */
+  readonly clientVersion: string
   /** Override only with a trusted proxy because the OAuth bearer is sent to this URL. */
   readonly responsesUrl?: string
   readonly extraHeaders?: Readonly<Record<string, string>>
@@ -122,7 +128,10 @@ export const makeXAiGrokProviderLayer = (config: XAiGrokProviderConfig) =>
     providerId: xAiGrokProviderDescriptor.providerId,
     providerName: xAiGrokProviderDescriptor.providerName,
     responsesUrl: config.responsesUrl ?? xAiGrokResponsesUrl,
-    authorizationHeaders: xAiGrokAuthorizationHeaders,
+    authorizationHeaders: (token, model) => ({
+      ...xAiGrokAuthorizationHeaders(token, model),
+      'x-grok-client-version': config.clientVersion
+    }),
     alwaysIncludeReasoning: false,
     allowEofCompletion: false,
     expectedTokenProvider: xAiGrokProviderId