@topolo/sdk 0.6.0 → 0.7.0

package/dist/node/credential-store.cjs

@@ -22,8 +22,10 @@ var credential_store_exports = {};
 __export(credential_store_exports, {
   ENVIRONMENT_DEFAULT_SERVICE_URLS: () => ENVIRONMENT_DEFAULT_SERVICE_URLS,
   TOPOLO_ENVIRONMENTS: () => TOPOLO_ENVIRONMENTS,
+  activateContext: () => activateContext,
   clearProfileCredential: () => clearProfileCredential,
   configPath: () => configPath,
+  contextKey: () => contextKey,
   credentialSourceFromConfig: () => credentialSourceFromConfig,
   envVarPrefix: () => envVarPrefix,
   normalizeEnvironment: () => normalizeEnvironment,
@@ -36,6 +38,7 @@ __export(credential_store_exports, {
   resolvedProfileConfig: () => resolvedProfileConfig,
   selectedEnvironment: () => selectedEnvironment,
   writeConfig: () => writeConfig,
+  writeContextCredential: () => writeContextCredential,
   writeProfileConfig: () => writeProfileConfig
 });
 module.exports = __toCommonJS(credential_store_exports);
@@ -230,6 +233,9 @@ var TopoloOAuth = class {
 
 // src/node/credential-store.ts
 var TOPOLO_ENVIRONMENTS = ["production", "staging", "development", "local"];
+function contextKey(contextType, organizationId) {
+  return contextType === "organization" && organizationId ? `org:${organizationId}` : "personal";
+}
 var ENVIRONMENT_DEFAULT_SERVICE_URLS = {
   production: {
     developers: "https://developers.topolo.app"
@@ -323,6 +329,28 @@ function writeProfileConfig(config, environment, profile) {
   };
   return { ...config, profiles };
 }
+function writeContextCredential(config, environment, ctx, makeActive = true) {
+  const key = contextKey(ctx.contextType, ctx.organizationId);
+  const profile = profileForEnvironment(config, environment);
+  const contexts = { ...profile.contexts ?? {}, [key]: ctx };
+  const next = { contexts };
+  if (makeActive) {
+    next.activeContext = key;
+    next.credential = ctx.credential;
+    next.oauthClientId = ctx.oauthClientId ?? profile.oauthClientId;
+  }
+  return writeProfileConfig(config, environment, next);
+}
+function activateContext(config, environment, key) {
+  const profile = profileForEnvironment(config, environment);
+  const ctx = profile.contexts?.[key];
+  if (!ctx) return config;
+  return writeProfileConfig(config, environment, {
+    activeContext: key,
+    credential: ctx.credential,
+    oauthClientId: ctx.oauthClientId ?? profile.oauthClientId
+  });
+}
 function clearProfileCredential(config, environment) {
   const next = { ...config };
   if (environment === "production") {
@@ -422,8 +450,10 @@ function resolvedProfileConfig(config, environment = selectedEnvironment()) {
 0 && (module.exports = {
   ENVIRONMENT_DEFAULT_SERVICE_URLS,
   TOPOLO_ENVIRONMENTS,
+  activateContext,
   clearProfileCredential,
   configPath,
+  contextKey,
   credentialSourceFromConfig,
   envVarPrefix,
   normalizeEnvironment,
@@ -436,5 +466,6 @@ function resolvedProfileConfig(config, environment = selectedEnvironment()) {
   resolvedProfileConfig,
   selectedEnvironment,
   writeConfig,
+  writeContextCredential,
   writeProfileConfig
 });

package/dist/node/credential-store.d.cts

@@ -50,7 +50,26 @@ interface TopoloEnvironmentProfile {
     oauthClientId?: string;
     serviceUrls?: Record<string, string>;
     agentName?: string;
+    /**
+     * The context (`personal` or `org:<orgId>`) whose credential is currently
+     * active. `credential` above always mirrors `contexts[activeContext]`, so
+     * credential resolution + the MCP keep working unchanged while `contexts`
+     * lets the CLI hold and switch between multiple org/personal contexts.
+     */
+    activeContext?: string;
+    contexts?: Record<string, TopoloContextCredential>;
 }
+/** A signed-in context — personal, or a specific organization. */
+interface TopoloContextCredential {
+    contextType: 'personal' | 'organization';
+    organizationId?: string;
+    organizationSlug?: string;
+    organizationName?: string;
+    credential?: TopoloCredential;
+    oauthClientId?: string;
+}
+/** Stable key for a context within a profile's `contexts` map. */
+declare function contextKey(contextType: 'personal' | 'organization', organizationId?: string | null): string;
 /**
  * Default service URLs per environment. `local` has no baked defaults — a
  * local dev loop points services at ad-hoc ports, so it is driven entirely by
@@ -65,6 +84,14 @@ declare function selectedEnvironment(): TopoloEnvironment;
 declare function envVarPrefix(environment: TopoloEnvironment): string;
 declare function profileForEnvironment(config: TopoloConfig, environment?: TopoloEnvironment): TopoloEnvironmentProfile;
 declare function writeProfileConfig(config: TopoloConfig, environment: TopoloEnvironment, profile: TopoloEnvironmentProfile): TopoloConfig;
+/**
+ * Store a context's credential in the profile's `contexts` map. When
+ * `makeActive` (default), also point the profile's active credential at it so
+ * credential resolution + the MCP use this context.
+ */
+declare function writeContextCredential(config: TopoloConfig, environment: TopoloEnvironment, ctx: TopoloContextCredential, makeActive?: boolean): TopoloConfig;
+/** Point the profile's active credential at an already-stored context. */
+declare function activateContext(config: TopoloConfig, environment: TopoloEnvironment, key: string): TopoloConfig;
 declare function clearProfileCredential(config: TopoloConfig, environment: TopoloEnvironment): TopoloConfig;
 declare function credentialSourceFromConfig(config: TopoloConfig, environment?: TopoloEnvironment): string;
 /**
@@ -78,4 +105,4 @@ declare function resolveAgentName(configAgentName?: string): string | undefined;
 declare function resolveServiceUrls(configUrls?: Record<string, string>, environment?: TopoloEnvironment): Record<string, string> | undefined;
 declare function resolvedProfileConfig(config: TopoloConfig, environment?: TopoloEnvironment): TopoloEnvironmentProfile;
 
-export { ENVIRONMENT_DEFAULT_SERVICE_URLS, TOPOLO_ENVIRONMENTS, type TopoloConfig, type TopoloEnvironment, type TopoloEnvironmentProfile, clearProfileCredential, configPath, credentialSourceFromConfig, envVarPrefix, normalizeEnvironment, profileForEnvironment, readConfig, refreshCredentialIfNeeded, resolveAgentName, resolveCredential, resolveServiceUrls, resolvedProfileConfig, selectedEnvironment, writeConfig, writeProfileConfig };
+export { ENVIRONMENT_DEFAULT_SERVICE_URLS, TOPOLO_ENVIRONMENTS, type TopoloConfig, type TopoloContextCredential, type TopoloEnvironment, type TopoloEnvironmentProfile, activateContext, clearProfileCredential, configPath, contextKey, credentialSourceFromConfig, envVarPrefix, normalizeEnvironment, profileForEnvironment, readConfig, refreshCredentialIfNeeded, resolveAgentName, resolveCredential, resolveServiceUrls, resolvedProfileConfig, selectedEnvironment, writeConfig, writeContextCredential, writeProfileConfig };

package/dist/node/credential-store.d.ts

@@ -50,7 +50,26 @@ interface TopoloEnvironmentProfile {
     oauthClientId?: string;
     serviceUrls?: Record<string, string>;
     agentName?: string;
+    /**
+     * The context (`personal` or `org:<orgId>`) whose credential is currently
+     * active. `credential` above always mirrors `contexts[activeContext]`, so
+     * credential resolution + the MCP keep working unchanged while `contexts`
+     * lets the CLI hold and switch between multiple org/personal contexts.
+     */
+    activeContext?: string;
+    contexts?: Record<string, TopoloContextCredential>;
 }
+/** A signed-in context — personal, or a specific organization. */
+interface TopoloContextCredential {
+    contextType: 'personal' | 'organization';
+    organizationId?: string;
+    organizationSlug?: string;
+    organizationName?: string;
+    credential?: TopoloCredential;
+    oauthClientId?: string;
+}
+/** Stable key for a context within a profile's `contexts` map. */
+declare function contextKey(contextType: 'personal' | 'organization', organizationId?: string | null): string;
 /**
  * Default service URLs per environment. `local` has no baked defaults — a
  * local dev loop points services at ad-hoc ports, so it is driven entirely by
@@ -65,6 +84,14 @@ declare function selectedEnvironment(): TopoloEnvironment;
 declare function envVarPrefix(environment: TopoloEnvironment): string;
 declare function profileForEnvironment(config: TopoloConfig, environment?: TopoloEnvironment): TopoloEnvironmentProfile;
 declare function writeProfileConfig(config: TopoloConfig, environment: TopoloEnvironment, profile: TopoloEnvironmentProfile): TopoloConfig;
+/**
+ * Store a context's credential in the profile's `contexts` map. When
+ * `makeActive` (default), also point the profile's active credential at it so
+ * credential resolution + the MCP use this context.
+ */
+declare function writeContextCredential(config: TopoloConfig, environment: TopoloEnvironment, ctx: TopoloContextCredential, makeActive?: boolean): TopoloConfig;
+/** Point the profile's active credential at an already-stored context. */
+declare function activateContext(config: TopoloConfig, environment: TopoloEnvironment, key: string): TopoloConfig;
 declare function clearProfileCredential(config: TopoloConfig, environment: TopoloEnvironment): TopoloConfig;
 declare function credentialSourceFromConfig(config: TopoloConfig, environment?: TopoloEnvironment): string;
 /**
@@ -78,4 +105,4 @@ declare function resolveAgentName(configAgentName?: string): string | undefined;
 declare function resolveServiceUrls(configUrls?: Record<string, string>, environment?: TopoloEnvironment): Record<string, string> | undefined;
 declare function resolvedProfileConfig(config: TopoloConfig, environment?: TopoloEnvironment): TopoloEnvironmentProfile;
 
-export { ENVIRONMENT_DEFAULT_SERVICE_URLS, TOPOLO_ENVIRONMENTS, type TopoloConfig, type TopoloEnvironment, type TopoloEnvironmentProfile, clearProfileCredential, configPath, credentialSourceFromConfig, envVarPrefix, normalizeEnvironment, profileForEnvironment, readConfig, refreshCredentialIfNeeded, resolveAgentName, resolveCredential, resolveServiceUrls, resolvedProfileConfig, selectedEnvironment, writeConfig, writeProfileConfig };
+export { ENVIRONMENT_DEFAULT_SERVICE_URLS, TOPOLO_ENVIRONMENTS, type TopoloConfig, type TopoloContextCredential, type TopoloEnvironment, type TopoloEnvironmentProfile, activateContext, clearProfileCredential, configPath, contextKey, credentialSourceFromConfig, envVarPrefix, normalizeEnvironment, profileForEnvironment, readConfig, refreshCredentialIfNeeded, resolveAgentName, resolveCredential, resolveServiceUrls, resolvedProfileConfig, selectedEnvironment, writeConfig, writeContextCredential, writeProfileConfig };

package/dist/node/credential-store.js

@@ -190,6 +190,9 @@ var TopoloOAuth = class {
 
 // src/node/credential-store.ts
 var TOPOLO_ENVIRONMENTS = ["production", "staging", "development", "local"];
+function contextKey(contextType, organizationId) {
+  return contextType === "organization" && organizationId ? `org:${organizationId}` : "personal";
+}
 var ENVIRONMENT_DEFAULT_SERVICE_URLS = {
   production: {
     developers: "https://developers.topolo.app"
@@ -283,6 +286,28 @@ function writeProfileConfig(config, environment, profile) {
   };
   return { ...config, profiles };
 }
+function writeContextCredential(config, environment, ctx, makeActive = true) {
+  const key = contextKey(ctx.contextType, ctx.organizationId);
+  const profile = profileForEnvironment(config, environment);
+  const contexts = { ...profile.contexts ?? {}, [key]: ctx };
+  const next = { contexts };
+  if (makeActive) {
+    next.activeContext = key;
+    next.credential = ctx.credential;
+    next.oauthClientId = ctx.oauthClientId ?? profile.oauthClientId;
+  }
+  return writeProfileConfig(config, environment, next);
+}
+function activateContext(config, environment, key) {
+  const profile = profileForEnvironment(config, environment);
+  const ctx = profile.contexts?.[key];
+  if (!ctx) return config;
+  return writeProfileConfig(config, environment, {
+    activeContext: key,
+    credential: ctx.credential,
+    oauthClientId: ctx.oauthClientId ?? profile.oauthClientId
+  });
+}
 function clearProfileCredential(config, environment) {
   const next = { ...config };
   if (environment === "production") {
@@ -381,8 +406,10 @@ function resolvedProfileConfig(config, environment = selectedEnvironment()) {
 export {
   ENVIRONMENT_DEFAULT_SERVICE_URLS,
   TOPOLO_ENVIRONMENTS,
+  activateContext,
   clearProfileCredential,
   configPath,
+  contextKey,
   credentialSourceFromConfig,
   envVarPrefix,
   normalizeEnvironment,
@@ -395,5 +422,6 @@ export {
   resolvedProfileConfig,
   selectedEnvironment,
   writeConfig,
+  writeContextCredential,
   writeProfileConfig
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topolo/sdk",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Typed client SDK for the Topolo platform. Used by TopoloCli, TopoloMCP, and third-party agents.",
   "type": "module",
   "main": "./dist/index.js",

package/src/node/credential-store.ts

@@ -38,6 +38,34 @@ export interface TopoloEnvironmentProfile {
   oauthClientId?: string;
   serviceUrls?: Record<string, string>;
   agentName?: string;
+  /**
+   * The context (`personal` or `org:<orgId>`) whose credential is currently
+   * active. `credential` above always mirrors `contexts[activeContext]`, so
+   * credential resolution + the MCP keep working unchanged while `contexts`
+   * lets the CLI hold and switch between multiple org/personal contexts.
+   */
+  activeContext?: string;
+  contexts?: Record<string, TopoloContextCredential>;
+}
+
+/** A signed-in context — personal, or a specific organization. */
+export interface TopoloContextCredential {
+  contextType: 'personal' | 'organization';
+  organizationId?: string;
+  organizationSlug?: string;
+  organizationName?: string;
+  credential?: TopoloCredential;
+  oauthClientId?: string;
+}
+
+/** Stable key for a context within a profile's `contexts` map. */
+export function contextKey(
+  contextType: 'personal' | 'organization',
+  organizationId?: string | null,
+): string {
+  return contextType === 'organization' && organizationId
+    ? `org:${organizationId}`
+    : 'personal';
 }
 
 /**
@@ -161,6 +189,45 @@ export function writeProfileConfig(
   return { ...config, profiles };
 }
 
+/**
+ * Store a context's credential in the profile's `contexts` map. When
+ * `makeActive` (default), also point the profile's active credential at it so
+ * credential resolution + the MCP use this context.
+ */
+export function writeContextCredential(
+  config: TopoloConfig,
+  environment: TopoloEnvironment,
+  ctx: TopoloContextCredential,
+  makeActive = true,
+): TopoloConfig {
+  const key = contextKey(ctx.contextType, ctx.organizationId);
+  const profile = profileForEnvironment(config, environment);
+  const contexts = { ...(profile.contexts ?? {}), [key]: ctx };
+  const next: TopoloEnvironmentProfile = { contexts };
+  if (makeActive) {
+    next.activeContext = key;
+    next.credential = ctx.credential;
+    next.oauthClientId = ctx.oauthClientId ?? profile.oauthClientId;
+  }
+  return writeProfileConfig(config, environment, next);
+}
+
+/** Point the profile's active credential at an already-stored context. */
+export function activateContext(
+  config: TopoloConfig,
+  environment: TopoloEnvironment,
+  key: string,
+): TopoloConfig {
+  const profile = profileForEnvironment(config, environment);
+  const ctx = profile.contexts?.[key];
+  if (!ctx) return config;
+  return writeProfileConfig(config, environment, {
+    activeContext: key,
+    credential: ctx.credential,
+    oauthClientId: ctx.oauthClientId ?? profile.oauthClientId,
+  });
+}
+
 export function clearProfileCredential(
   config: TopoloConfig,
   environment: TopoloEnvironment,