@lobehub/market-sdk 0.34.0-beta.4 → 0.34.0-beta.5

package/dist/index.d.mts

@@ -5314,17 +5314,10 @@ declare class PluginEnvService extends BaseSDK {
     }>;
 }
 
-/**
- * Organization membership-authority source
- */
-type AdminOrganizationSource = 'native' | 'workspace';
 /**
  * Admin organization list query parameters
  */
-interface AdminOrganizationListQueryParams extends AdminListQueryParams {
-    /** Filter by membership-authority source (defaults to all) */
-    source?: AdminOrganizationSource | 'all';
-}
+type AdminOrganizationListQueryParams = AdminListQueryParams;
 /**
  * Organization list item in admin context
  */
@@ -5338,10 +5331,9 @@ interface AdminOrganizationItem {
     email: string | null;
     memberCount: number;
     namespace: string;
-    source: AdminOrganizationSource;
     updatedAt: string | null;
     websiteUrl: string | null;
-    /** Associated cloud workspace id, derived from clerkId for workspace-source orgs */
+    /** Associated cloud workspace id, derived from the `workspace:<id>` clerkId convention */
     workspaceId: string | null;
 }
 /**
@@ -7338,6 +7330,22 @@ declare class MarketSkillService extends BaseSDK {
     }>;
 }
 
+/**
+ * Organization reference for SDK calls.
+ *
+ * Either the numeric Market `accounts.id` (legacy) or a cloud workspace key.
+ * A workspace ref is sent to the API as the `workspace:<workspaceId>` path
+ * segment, which the Market resolves server-side via the same `clerkId`
+ * convention — so callers can address an org by its cloud workspaceId without
+ * ever holding the integer account id (mirroring how users are addressed by
+ * their cloud userId).
+ */
+type OrgRef = number | {
+    workspaceId: string;
+};
+/** Build the org path segment for a {@link OrgRef}. */
+declare const orgRefToPathSegment: (ref: OrgRef) => string;
+
 /**
  * Organization Credentials Service
  *
@@ -7360,11 +7368,12 @@ declare class MarketSkillService extends BaseSDK {
  */
 declare class OrganizationCredsService extends BaseSDK {
     /**
-     * Numeric organization account ID this service is bound to. Stored so every
-     * URL builder method below can prefix `/v1/organizations/${orgId}/`.
+     * Org path segment this service is bound to — a numeric account id or a
+     * `workspace:<workspaceId>` key. Stored so every URL builder method below can
+     * prefix `/v1/organizations/${orgSegment}/`.
      */
-    private readonly orgId;
-    constructor(orgId: number, options?: MarketSDKOptions, sharedHeaders?: Record<string, string>, sharedTokenState?: SharedTokenState);
+    private readonly orgSegment;
+    constructor(orgId: OrgRef, options?: MarketSDKOptions, sharedHeaders?: Record<string, string>, sharedTokenState?: SharedTokenState);
     private base;
     list(options?: globalThis.RequestInit): Promise<ListCredsResponse>;
     get(id: number, getOptions?: GetCredOptions, options?: globalThis.RequestInit): Promise<CredWithPlaintext>;
@@ -7416,13 +7425,17 @@ declare class OrganizationService extends BaseSDK {
      * Returns a fresh instance per call; suitable for short-lived UIs where the
      * orgId varies. For long-lived use, cache the returned service.
      *
+     * Accepts either a numeric account id or a `{ workspaceId }` ref; the latter
+     * is addressed server-side as `workspace:<workspaceId>`.
+     *
      * @example
      * ```typescript
      * const orgCreds = market.organizations.creds(42);
+     * const byWs = market.organizations.creds({ workspaceId: 'wks_abc' });
      * await orgCreds.list();
      * ```
      */
-    creds(orgId: number): OrganizationCredsService;
+    creds(orgId: OrgRef): OrganizationCredsService;
     /**
      * Retrieves an organization's public profile and everything it has
      * published — agents, agent groups, skills, plugins.
@@ -7463,7 +7476,7 @@ declare class OrganizationService extends BaseSDK {
      * @param data - Fields to update
      * @returns The updated organization
      */
-    updateOrganization(orgId: number, data: UpdateOrganizationRequest, options?: globalThis.RequestInit): Promise<OrganizationItem>;
+    updateOrganization(orgId: OrgRef, data: UpdateOrganizationRequest, options?: globalThis.RequestInit): Promise<OrganizationItem>;
     /**
      * Soft-disables an organization (e.g. its cloud workspace was deleted).
      * Trusted-client only. Reversible; creds and published content are preserved.
@@ -7471,21 +7484,21 @@ declare class OrganizationService extends BaseSDK {
      * @param orgId - Organization account id
      * @returns The archived organization
      */
-    archiveOrganization(orgId: number, options?: globalThis.RequestInit): Promise<OrganizationItem>;
+    archiveOrganization(orgId: OrgRef, options?: globalThis.RequestInit): Promise<OrganizationItem>;
     /**
      * Reactivates a previously archived organization. Trusted-client only.
      *
      * @param orgId - Organization account id
      * @returns The reactivated organization
      */
-    unarchiveOrganization(orgId: number, options?: globalThis.RequestInit): Promise<OrganizationItem>;
+    unarchiveOrganization(orgId: OrgRef, options?: globalThis.RequestInit): Promise<OrganizationItem>;
     /**
      * Lists the members of an organization. Any authenticated org member may call.
      *
      * @param orgId - Organization account id
      * @returns Hydrated member rows
      */
-    listMembers(orgId: number, options?: globalThis.RequestInit): Promise<OrganizationMemberItem[]>;
+    listMembers(orgId: OrgRef, options?: globalThis.RequestInit): Promise<OrganizationMemberItem[]>;
     /**
      * Adds a member to an organization. Trusted-client only. Idempotent: if the
      * user is already a member, the existing role is preserved (`added: false`).
@@ -7495,7 +7508,7 @@ declare class OrganizationService extends BaseSDK {
      * @param role - Role to grant (defaults server-side to `member`)
      * @returns Whether the member was newly added and their effective role
      */
-    addMember(orgId: number, userAccountId: number, role?: OrganizationMemberRole, options?: globalThis.RequestInit): Promise<AddMemberResponse>;
+    addMember(orgId: OrgRef, userAccountId: number, role?: OrganizationMemberRole, options?: globalThis.RequestInit): Promise<AddMemberResponse>;
     /**
      * Removes a member from an organization. Trusted-client only. Refuses to
      * remove the last admin (server returns 409).
@@ -7504,7 +7517,7 @@ declare class OrganizationService extends BaseSDK {
      * @param userAccountId - The user's account id
      * @returns Whether a membership row was removed
      */
-    removeMember(orgId: number, userAccountId: number, options?: globalThis.RequestInit): Promise<{
+    removeMember(orgId: OrgRef, userAccountId: number, options?: globalThis.RequestInit): Promise<{
         removed: boolean;
     }>;
     /**
@@ -7516,7 +7529,7 @@ declare class OrganizationService extends BaseSDK {
      * @param role - The new role
      * @returns The effective role and whether it changed
      */
-    updateMemberRole(orgId: number, userAccountId: number, role: OrganizationMemberRole, options?: globalThis.RequestInit): Promise<UpdateMemberRoleResponse>;
+    updateMemberRole(orgId: OrgRef, userAccountId: number, role: OrganizationMemberRole, options?: globalThis.RequestInit): Promise<UpdateMemberRoleResponse>;
     /**
      * Reconciles the full member list against a desired snapshot (idempotent).
      * Trusted-client only — the canonical way for Cloud to mirror a workspace's
@@ -7528,7 +7541,7 @@ declare class OrganizationService extends BaseSDK {
      * @param members - The complete desired member list
      * @returns Counts of added / removed / updated members and skipped ids
      */
-    reconcileMembers(orgId: number, members: ReconcileMembersRequest['members'], options?: globalThis.RequestInit): Promise<ReconcileMembersResponse>;
+    reconcileMembers(orgId: OrgRef, members: ReconcileMembersRequest['members'], options?: globalThis.RequestInit): Promise<ReconcileMembersResponse>;
 }
 
 /**
@@ -8177,31 +8190,6 @@ declare const SDK_VERSION = "0.31.3";
  */
 declare const SDK_USER_AGENT = "LobeHub-Market-SDK/0.31.3";
 
-/**
- * Trusted Client Token Utilities
- *
- * Provides encryption utilities for creating trusted client tokens
- * that can be used with the Market SDK.
- *
- * @example
- * ```typescript
- * import { createTrustedClientToken, TrustedClientPayload } from '@lobehub/market-sdk';
- *
- * const payload: TrustedClientPayload = {
- *   userId: 'user_xxx',
- *   clientId: 'lobechat-com',
- *   email: 'user@example.com',
- *   timestamp: Date.now(),
- *   nonce: generateNonce(),
- *   name: 'John Doe',
- * };
- *
- * const token = createTrustedClientToken(payload, secret);
- *
- * // Use with MarketSDK
- * const sdk = new MarketSDK({ trustedClientToken: token });
- * ```
- */
 /**
  * Trusted client payload structure
  */
@@ -8220,6 +8208,13 @@ interface TrustedClientPayload {
     timestamp: number;
     /** Clerk user ID (format: user_xxx) */
     userId: string;
+    /**
+     * Cloud workspace id the request acts on behalf of. When present, the caller
+     * acts as the workspace's mirrored organization (resolved server-side via the
+     * `workspace:<workspaceId>` clerkId convention), mirroring how `userId`
+     * identifies the personal account. Omit for personal requests.
+     */
+    workspaceId?: string;
 }
 /**
  * Encrypt a trusted client payload
@@ -8248,6 +8243,7 @@ declare function buildTrustedClientPayload(params: {
     emailVerified?: boolean;
     name?: string;
     userId: string;
+    workspaceId?: string;
 }): TrustedClientPayload;
 
-export { type AccountMeta, type AdminListQueryParams, type AdminListResponse, type AdminPluginParams, type AgentCreateRequest, type AgentCreateResponse, type AgentDetailQuery, type AgentExtension, type AgentForkItem, type AgentForkRequest, type AgentForkResponse, type AgentForkSourceResponse, type AgentForksResponse, type AgentGroupCreateRequest, type AgentGroupCreateResponse, type AgentGroupDetail, type AgentGroupDetailQuery, type AgentGroupForkItem, type AgentGroupForkRequest, type AgentGroupForkResponse, type AgentGroupForkSourceResponse, type AgentGroupForksResponse, type AgentGroupItem, type AgentGroupListQuery, type AgentGroupListResponse, type AgentGroupModifyRequest, type AgentGroupModifyResponse, type AgentGroupStatus, type AgentGroupStatusChangeResponse, type AgentGroupVersionCreateRequest, type AgentGroupVersionCreateResponse, type AgentInstallCountRequest, type AgentInstallCountResponse, type AgentInterface, type AgentItemDetail, type AgentListQuery, type AgentListResponse, type AgentModifyRequest, type AgentModifyResponse, type AgentProfileEntity, type AgentProfileResponse, type AgentSecurityRequirement, type AgentSecurityScheme, type AgentSkill, type AgentStatus, type AgentStatusChangeResponse, type AgentUploadRequest, type AgentUploadResponse, type AgentUploadVersion, type AgentVersionCreateRequest, type AgentVersionCreateResponse, type AgentVersionLocalization, type AgentVersionModifyRequest, type AgentVersionModifyResponse, type AuthorizationCodeTokenRequest, type AuthorizeParams, type AuthorizeResponse, type CallSkillToolResponse, type CheckFavoriteQuery, type CheckFavoriteResponse, type CheckFollowQuery, type CheckFollowResponse, type CheckLikeQuery, type CheckLikeResponse, type CimdClientMetadata, type ClientRegistrationError, type ClientRegistrationRequest, type ClientRegistrationResponse, type CodeInterpreterToolName, type CodeInterpreterToolParams, type ConnectProvider, type ConnectProviderDetail, type ConnectProviderScopes, type ConnectionHealth, type ConnectionStats, type CreateFileCredRequest, type CreateKVCredRequest, type CreateMemberAgent, type CreateOAuthCredRequest, type CredWithPlaintext, type DeleteCredResponse, type DiscoveryDocument, type EditLocalFileParams, type ExecuteCodeParams, type ExportFileParams, type FavoriteListResponse, type FavoriteQuery, type FavoriteRequest, type FeedbackClientInfo, type FollowListItem, type FollowListResponse, type FollowRequest, type GetAllConnectionsHealthResponse, type GetAuthorizeUrlParams, type GetCommandOutputParams, type GetConnectProviderResponse, type GetConnectionHealthResponse, type GetConnectionStatsResponse, type GetConnectionStatusResponse, type GetCredOptions, type GetSkillStatusResponse, type GetSkillToolResponse, type GlobLocalFilesParams, type GrepContentParams, type InteractionTargetType, type KillCommandParams, type LikeListResponse, type LikeQuery, type LikeRequest, type ListConnectProvidersResponse, type ListConnectionsResponse, type ListCredsResponse, type ListLocalFilesParams, type ListSkillProvidersResponse, type ListSkillToolsResponse, MarketAPIError, MarketAdmin, type MarketReportGitHubSkillParams, type MarketReportGitHubSkillResponse, type MarketReportSkillInstallParams, type MarketReportSkillInstallResponse, MarketSDK, type MarketSDKOptions, type MarketSkillAuthor, type MarketSkillCategory, type MarketSkillCategoryQuery, type MarketSkillCollectionDetail, type MarketSkillCollectionDetailQuery, type MarketSkillCollectionItemSort, type MarketSkillCollectionListItem, type MarketSkillCollectionListQuery, type MarketSkillCollectionListResponse, type MarketSkillDetail, type MarketSkillDetailQuery, type MarketSkillGitHubMeta, type MarketSkillListItem, type MarketSkillListQuery, type MarketSkillListResponse, type MarketSkillManifest, type MarketSkillResource, type MarketSkillVersionSummary, type MarketSkillVersionsResponse, type MemberAgent, type MoveLocalFilesParams, type MoveOperation, type OAuthConnection, type OAuthTokenResponse, type OrganizationInfoQuery, type OrganizationInfoResponse, type OrganizationProfile, type OwnAgentGroupListQuery, type OwnAgentListQuery, type PaginationQuery, type PluginCommentAuthor, type PluginCommentCreateItem, type PluginCommentCreateResponse, type PluginCommentDeleteResponse, type PluginCommentItem, type PluginCommentListQuery, type PluginCommentListResponse, type PluginCommentRating, type PluginCommentReactionResponse, type PluginI18nImportParams, type PluginI18nImportResponse, type PluginItem, type PluginLatestOwnComment, type PluginListResponse, type PluginLocalization, type PluginQueryParams, type PluginRatingDistribution, type PluginUpdateParams, type PluginVersionCreateParams, type PluginVersionUpdateParams, type ProgrammingLanguage, type ReadLocalFileParams, type RefreshConnectionResponse, type RefreshTokenRequest, type RegisterUserRequest, type RegisterUserResponse, type RegisteredUserProfile, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RevokeConnectionResponse, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, SDK_USER_AGENT, SDK_VERSION, type SearchLocalFilesParams, type SharedTokenState, type SkillCallParams, type SkillCommentAuthor, type SkillCommentCreateItem, type SkillCommentCreateResponse, type SkillCommentDeleteResponse, type SkillCommentItem, type SkillCommentListItem, type SkillCommentListQuery, type SkillCommentListResponse, type SkillCommentRating, type SkillErrorResponse, type SkillLatestOwnComment, type SkillProviderInfo, type SkillProviderStatus, type SkillRatingDistribution, type SkillTool, type SkillToolsSource, StatusEnumSchema, type SubmitFeedbackRequest, type SubmitFeedbackResponse, type SuccessResponse, type ToggleLikeResponse, type TrustedClientPayload, type UnclaimedPluginItem, type UpdateAgentProfileRequest, type UpdateAgentProfileResponse, type UpdateCredRequest, type UpdateMemberAgent, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentGroupItem, type UserAgentItem, type UserInfoQuery, type UserInfoResponse, type UserPluginItem, type UserProfile, type UserSkillItem, VisibilityEnumSchema, type WriteLocalFileParams, buildTrustedClientPayload, createTrustedClientToken, generateNonce };
+export { type AccountMeta, type AdminListQueryParams, type AdminListResponse, type AdminPluginParams, type AgentCreateRequest, type AgentCreateResponse, type AgentDetailQuery, type AgentExtension, type AgentForkItem, type AgentForkRequest, type AgentForkResponse, type AgentForkSourceResponse, type AgentForksResponse, type AgentGroupCreateRequest, type AgentGroupCreateResponse, type AgentGroupDetail, type AgentGroupDetailQuery, type AgentGroupForkItem, type AgentGroupForkRequest, type AgentGroupForkResponse, type AgentGroupForkSourceResponse, type AgentGroupForksResponse, type AgentGroupItem, type AgentGroupListQuery, type AgentGroupListResponse, type AgentGroupModifyRequest, type AgentGroupModifyResponse, type AgentGroupStatus, type AgentGroupStatusChangeResponse, type AgentGroupVersionCreateRequest, type AgentGroupVersionCreateResponse, type AgentInstallCountRequest, type AgentInstallCountResponse, type AgentInterface, type AgentItemDetail, type AgentListQuery, type AgentListResponse, type AgentModifyRequest, type AgentModifyResponse, type AgentProfileEntity, type AgentProfileResponse, type AgentSecurityRequirement, type AgentSecurityScheme, type AgentSkill, type AgentStatus, type AgentStatusChangeResponse, type AgentUploadRequest, type AgentUploadResponse, type AgentUploadVersion, type AgentVersionCreateRequest, type AgentVersionCreateResponse, type AgentVersionLocalization, type AgentVersionModifyRequest, type AgentVersionModifyResponse, type AuthorizationCodeTokenRequest, type AuthorizeParams, type AuthorizeResponse, type CallSkillToolResponse, type CheckFavoriteQuery, type CheckFavoriteResponse, type CheckFollowQuery, type CheckFollowResponse, type CheckLikeQuery, type CheckLikeResponse, type CimdClientMetadata, type ClientRegistrationError, type ClientRegistrationRequest, type ClientRegistrationResponse, type CodeInterpreterToolName, type CodeInterpreterToolParams, type ConnectProvider, type ConnectProviderDetail, type ConnectProviderScopes, type ConnectionHealth, type ConnectionStats, type CreateFileCredRequest, type CreateKVCredRequest, type CreateMemberAgent, type CreateOAuthCredRequest, type CredWithPlaintext, type DeleteCredResponse, type DiscoveryDocument, type EditLocalFileParams, type ExecuteCodeParams, type ExportFileParams, type FavoriteListResponse, type FavoriteQuery, type FavoriteRequest, type FeedbackClientInfo, type FollowListItem, type FollowListResponse, type FollowRequest, type GetAllConnectionsHealthResponse, type GetAuthorizeUrlParams, type GetCommandOutputParams, type GetConnectProviderResponse, type GetConnectionHealthResponse, type GetConnectionStatsResponse, type GetConnectionStatusResponse, type GetCredOptions, type GetSkillStatusResponse, type GetSkillToolResponse, type GlobLocalFilesParams, type GrepContentParams, type InteractionTargetType, type KillCommandParams, type LikeListResponse, type LikeQuery, type LikeRequest, type ListConnectProvidersResponse, type ListConnectionsResponse, type ListCredsResponse, type ListLocalFilesParams, type ListSkillProvidersResponse, type ListSkillToolsResponse, MarketAPIError, MarketAdmin, type MarketReportGitHubSkillParams, type MarketReportGitHubSkillResponse, type MarketReportSkillInstallParams, type MarketReportSkillInstallResponse, MarketSDK, type MarketSDKOptions, type MarketSkillAuthor, type MarketSkillCategory, type MarketSkillCategoryQuery, type MarketSkillCollectionDetail, type MarketSkillCollectionDetailQuery, type MarketSkillCollectionItemSort, type MarketSkillCollectionListItem, type MarketSkillCollectionListQuery, type MarketSkillCollectionListResponse, type MarketSkillDetail, type MarketSkillDetailQuery, type MarketSkillGitHubMeta, type MarketSkillListItem, type MarketSkillListQuery, type MarketSkillListResponse, type MarketSkillManifest, type MarketSkillResource, type MarketSkillVersionSummary, type MarketSkillVersionsResponse, type MemberAgent, type MoveLocalFilesParams, type MoveOperation, type OAuthConnection, type OAuthTokenResponse, type OrgRef, type OrganizationInfoQuery, type OrganizationInfoResponse, type OrganizationProfile, type OwnAgentGroupListQuery, type OwnAgentListQuery, type PaginationQuery, type PluginCommentAuthor, type PluginCommentCreateItem, type PluginCommentCreateResponse, type PluginCommentDeleteResponse, type PluginCommentItem, type PluginCommentListQuery, type PluginCommentListResponse, type PluginCommentRating, type PluginCommentReactionResponse, type PluginI18nImportParams, type PluginI18nImportResponse, type PluginItem, type PluginLatestOwnComment, type PluginListResponse, type PluginLocalization, type PluginQueryParams, type PluginRatingDistribution, type PluginUpdateParams, type PluginVersionCreateParams, type PluginVersionUpdateParams, type ProgrammingLanguage, type ReadLocalFileParams, type RefreshConnectionResponse, type RefreshTokenRequest, type RegisterUserRequest, type RegisterUserResponse, type RegisteredUserProfile, type RenameLocalFileParams, type ReviewStatus, ReviewStatusEnumSchema, type RevokeConnectionResponse, type RunBuildInToolsError, type RunBuildInToolsRequest, type RunBuildInToolsResponse, type RunBuildInToolsSuccessData, type RunCommandParams, SDK_USER_AGENT, SDK_VERSION, type SearchLocalFilesParams, type SharedTokenState, type SkillCallParams, type SkillCommentAuthor, type SkillCommentCreateItem, type SkillCommentCreateResponse, type SkillCommentDeleteResponse, type SkillCommentItem, type SkillCommentListItem, type SkillCommentListQuery, type SkillCommentListResponse, type SkillCommentRating, type SkillErrorResponse, type SkillLatestOwnComment, type SkillProviderInfo, type SkillProviderStatus, type SkillRatingDistribution, type SkillTool, type SkillToolsSource, StatusEnumSchema, type SubmitFeedbackRequest, type SubmitFeedbackResponse, type SuccessResponse, type ToggleLikeResponse, type TrustedClientPayload, type UnclaimedPluginItem, type UpdateAgentProfileRequest, type UpdateAgentProfileResponse, type UpdateCredRequest, type UpdateMemberAgent, type UpdateUserInfoRequest, type UpdateUserInfoResponse, type UserAgentGroupItem, type UserAgentItem, type UserInfoQuery, type UserInfoResponse, type UserPluginItem, type UserProfile, type UserSkillItem, VisibilityEnumSchema, type WriteLocalFileParams, buildTrustedClientPayload, createTrustedClientToken, generateNonce, orgRefToPathSegment };

package/dist/index.mjs

@@ -4939,30 +4939,43 @@ var MarketSkillService = class extends BaseSDK {
 
 // src/market/services/OrganizationCredsService.ts
 import debug24 from "debug";
+
+// src/utils/orgRef.ts
+var orgRefToPathSegment = (ref) => typeof ref === "number" ? String(ref) : `workspace:${encodeURIComponent(ref.workspaceId)}`;
+
+// src/market/services/OrganizationCredsService.ts
 var log24 = debug24("lobe-market-sdk:org-creds");
 var OrganizationCredsService = class extends BaseSDK {
   constructor(orgId, options = {}, sharedHeaders, sharedTokenState) {
     super(options, sharedHeaders, sharedTokenState);
-    if (!Number.isInteger(orgId) || orgId <= 0) {
-      throw new Error(`OrganizationCredsService requires a positive integer orgId, got: ${orgId}`);
+    if (typeof orgId === "number") {
+      if (!Number.isInteger(orgId) || orgId <= 0) {
+        throw new Error(
+          `OrganizationCredsService requires a positive integer orgId, got: ${orgId}`
+        );
+      }
+    } else if (!(orgId == null ? void 0 : orgId.workspaceId)) {
+      throw new Error(
+        "OrganizationCredsService requires a positive integer orgId or { workspaceId }"
+      );
     }
-    this.orgId = orgId;
+    this.orgSegment = orgRefToPathSegment(orgId);
   }
   base() {
-    return `/v1/organizations/${this.orgId}/creds`;
+    return `/v1/organizations/${this.orgSegment}/creds`;
   }
   // ===========================================================================
   // Read
   // ===========================================================================
   async list(options) {
     var _a;
-    log24("Listing org %d credentials", this.orgId);
+    log24("Listing org %s credentials", this.orgSegment);
     const result = await this.request(this.base(), options);
-    log24("Found %d credentials for org %d", ((_a = result.data) == null ? void 0 : _a.length) || 0, this.orgId);
+    log24("Found %d credentials for org %s", ((_a = result.data) == null ? void 0 : _a.length) || 0, this.orgSegment);
     return result;
   }
   async get(id, getOptions, options) {
-    log24("Getting org %d credential %d (decrypt=%s)", this.orgId, id, getOptions == null ? void 0 : getOptions.decrypt);
+    log24("Getting org %s credential %d (decrypt=%s)", this.orgSegment, id, getOptions == null ? void 0 : getOptions.decrypt);
     const queryString = this.buildQueryString((getOptions == null ? void 0 : getOptions.decrypt) ? { decrypt: "true" } : {});
     const result = await this.request(
       `${this.base()}/${id}${queryString}`,
@@ -4975,7 +4988,7 @@ var OrganizationCredsService = class extends BaseSDK {
   // Create
   // ===========================================================================
   async createKV(data, options) {
-    log24("Creating org %d KV credential: %s (type=%s)", this.orgId, data.key, data.type);
+    log24("Creating org %s KV credential: %s (type=%s)", this.orgSegment, data.key, data.type);
     return this.request(`${this.base()}/kv`, {
       body: JSON.stringify(data),
       headers: { "Content-Type": "application/json" },
@@ -4984,7 +4997,7 @@ var OrganizationCredsService = class extends BaseSDK {
     });
   }
   async createOAuth(data, options) {
-    log24("Creating org %d OAuth credential: %s", this.orgId, data.key);
+    log24("Creating org %s OAuth credential: %s", this.orgSegment, data.key);
     return this.request(`${this.base()}/oauth`, {
       body: JSON.stringify(data),
       headers: { "Content-Type": "application/json" },
@@ -4993,7 +5006,7 @@ var OrganizationCredsService = class extends BaseSDK {
     });
   }
   async createFile(data, options) {
-    log24("Creating org %d file credential: %s", this.orgId, data.key);
+    log24("Creating org %s file credential: %s", this.orgSegment, data.key);
     return this.request(`${this.base()}/file`, {
       body: JSON.stringify(data),
       headers: { "Content-Type": "application/json" },
@@ -5005,7 +5018,7 @@ var OrganizationCredsService = class extends BaseSDK {
   // Update
   // ===========================================================================
   async update(id, data, options) {
-    log24("Updating org %d credential %d", this.orgId, id);
+    log24("Updating org %s credential %d", this.orgSegment, id);
     return this.request(`${this.base()}/${id}`, {
       body: JSON.stringify(data),
       headers: { "Content-Type": "application/json" },
@@ -5017,14 +5030,14 @@ var OrganizationCredsService = class extends BaseSDK {
   // Delete
   // ===========================================================================
   async delete(id, options) {
-    log24("Deleting org %d credential %d", this.orgId, id);
+    log24("Deleting org %s credential %d", this.orgSegment, id);
     return this.request(`${this.base()}/${id}`, {
       method: "DELETE",
       ...options
     });
   }
   async deleteByKey(key, options) {
-    log24("Deleting org %d credential by key: %s", this.orgId, key);
+    log24("Deleting org %s credential by key: %s", this.orgSegment, key);
     return this.request(`${this.base()}/key/${encodeURIComponent(key)}`, {
       method: "DELETE",
       ...options
@@ -5038,8 +5051,8 @@ var OrganizationCredsService = class extends BaseSDK {
    * the org has bound vs. is missing. Reads only; any org member may call.
    */
   async getSkillCredStatus(skillIdentifier, options) {
-    log24("Getting org %d skill cred status: %s", this.orgId, skillIdentifier);
-    const path = `/v1/organizations/${this.orgId}/skills/${encodeURIComponent(skillIdentifier)}/creds/status`;
+    log24("Getting org %s skill cred status: %s", this.orgSegment, skillIdentifier);
+    const path = `/v1/organizations/${this.orgSegment}/skills/${encodeURIComponent(skillIdentifier)}/creds/status`;
     const result = await this.request(
       path,
       options
@@ -5068,9 +5081,13 @@ var OrganizationService2 = class extends BaseSDK {
    * Returns a fresh instance per call; suitable for short-lived UIs where the
    * orgId varies. For long-lived use, cache the returned service.
    *
+   * Accepts either a numeric account id or a `{ workspaceId }` ref; the latter
+   * is addressed server-side as `workspace:<workspaceId>`.
+   *
    * @example
    * ```typescript
    * const orgCreds = market.organizations.creds(42);
+   * const byWs = market.organizations.creds({ workspaceId: 'wks_abc' });
    * await orgCreds.list();
    * ```
    */
@@ -5143,11 +5160,14 @@ var OrganizationService2 = class extends BaseSDK {
    */
   async updateOrganization(orgId, data, options) {
     log25("Updating organization %d: %O", orgId, data);
-    const result = await this.request(`/v1/organizations/${orgId}`, {
-      ...options,
-      body: JSON.stringify(data),
-      method: "PATCH"
-    });
+    const result = await this.request(
+      `/v1/organizations/${orgRefToPathSegment(orgId)}`,
+      {
+        ...options,
+        body: JSON.stringify(data),
+        method: "PATCH"
+      }
+    );
     return result.data;
   }
   /**
@@ -5160,7 +5180,7 @@ var OrganizationService2 = class extends BaseSDK {
   async archiveOrganization(orgId, options) {
     log25("Archiving organization %d", orgId);
     const result = await this.request(
-      `/v1/organizations/${orgId}/archive`,
+      `/v1/organizations/${orgRefToPathSegment(orgId)}/archive`,
       { ...options, method: "POST" }
     );
     return result.data;
@@ -5174,7 +5194,7 @@ var OrganizationService2 = class extends BaseSDK {
   async unarchiveOrganization(orgId, options) {
     log25("Unarchiving organization %d", orgId);
     const result = await this.request(
-      `/v1/organizations/${orgId}/unarchive`,
+      `/v1/organizations/${orgRefToPathSegment(orgId)}/unarchive`,
       { ...options, method: "POST" }
     );
     return result.data;
@@ -5188,7 +5208,7 @@ var OrganizationService2 = class extends BaseSDK {
   async listMembers(orgId, options) {
     log25("Listing members of organization %d", orgId);
     const result = await this.request(
-      `/v1/organizations/${orgId}/members`,
+      `/v1/organizations/${orgRefToPathSegment(orgId)}/members`,
       options
     );
     return result.data;
@@ -5204,11 +5224,14 @@ var OrganizationService2 = class extends BaseSDK {
    */
   async addMember(orgId, userAccountId, role, options) {
     log25("Adding member %d to organization %d (role=%s)", userAccountId, orgId, role);
-    return this.request(`/v1/organizations/${orgId}/members`, {
-      ...options,
-      body: JSON.stringify({ role, userAccountId }),
-      method: "POST"
-    });
+    return this.request(
+      `/v1/organizations/${orgRefToPathSegment(orgId)}/members`,
+      {
+        ...options,
+        body: JSON.stringify({ role, userAccountId }),
+        method: "POST"
+      }
+    );
   }
   /**
    * Removes a member from an organization. Trusted-client only. Refuses to
@@ -5221,7 +5244,7 @@ var OrganizationService2 = class extends BaseSDK {
   async removeMember(orgId, userAccountId, options) {
     log25("Removing member %d from organization %d", userAccountId, orgId);
     return this.request(
-      `/v1/organizations/${orgId}/members/${userAccountId}`,
+      `/v1/organizations/${orgRefToPathSegment(orgId)}/members/${userAccountId}`,
       { ...options, method: "DELETE" }
     );
   }
@@ -5237,7 +5260,7 @@ var OrganizationService2 = class extends BaseSDK {
   async updateMemberRole(orgId, userAccountId, role, options) {
     log25("Updating member %d role to %s in organization %d", userAccountId, role, orgId);
     return this.request(
-      `/v1/organizations/${orgId}/members/${userAccountId}`,
+      `/v1/organizations/${orgRefToPathSegment(orgId)}/members/${userAccountId}`,
       { ...options, body: JSON.stringify({ role }), method: "PATCH" }
     );
   }
@@ -5254,11 +5277,14 @@ var OrganizationService2 = class extends BaseSDK {
    */
   async reconcileMembers(orgId, members, options) {
     log25("Reconciling %d members for organization %d", members.length, orgId);
-    return this.request(`/v1/organizations/${orgId}/members`, {
-      ...options,
-      body: JSON.stringify({ members }),
-      method: "PUT"
-    });
+    return this.request(
+      `/v1/organizations/${orgRefToPathSegment(orgId)}/members`,
+      {
+        ...options,
+        body: JSON.stringify({ members }),
+        method: "PUT"
+      }
+    );
   }
 };
 
@@ -6182,6 +6208,7 @@ export {
   VisibilityEnumSchema,
   buildTrustedClientPayload,
   createTrustedClientToken,
-  generateNonce
+  generateNonce,
+  orgRefToPathSegment
 };
 //# sourceMappingURL=index.mjs.map