@agoric/governance 0.10.4-upgrade-14-dev-c8f9e7b.0 → 0.10.4-upgrade-16-fi-dev-8879538.0

package/exported.d.ts

@@ -0,0 +1,32 @@
+/** @file Ambient exports until https://github.com/Agoric/agoric-sdk/issues/6512 */
+/** @see {@link /docs/typescript.md} */
+/* eslint-disable -- doesn't understand .d.ts */
+
+import {
+  GovernanceFacetKit as _GovernanceFacetKit,
+  GovernanceTerms as _GovernanceTerms,
+  GovernorCreatorFacet as _GovernorCreatorFacet,
+  GovernanceSubscriptionState as _GovernanceSubscriptionState,
+  GovernorStartedInstallationKit as _GovernorStartedInstallationKit,
+  GovernedCreatorFacet as _GovernedCreatorFacet,
+  ParamStateRecord as _ParamStateRecord,
+  GovernedPublicFacet as _GovernedPublicFacet,
+  CommitteeElectoratePublic as _CommitteeElectoratePublic,
+  GovernedApis as _GovernedApis,
+  GovernableStartFn as _GovernableStartFn,
+} from './src/types.js';
+declare global {
+  export {
+    _CommitteeElectoratePublic as CommitteeElectoratePublic,
+    _GovernableStartFn as GovernableStartFn,
+    _GovernanceFacetKit as GovernanceFacetKit,
+    _GovernanceSubscriptionState as GovernanceSubscriptionState,
+    _GovernanceTerms as GovernanceTerms,
+    _GovernedApis as GovernedApis,
+    _GovernedCreatorFacet as GovernedCreatorFacet,
+    _GovernedPublicFacet as GovernedPublicFacet,
+    _GovernorCreatorFacet as GovernorCreatorFacet,
+    _GovernorStartedInstallationKit as GovernorStartedInstallationKit,
+    _ParamStateRecord as ParamStateRecord,
+  };
+}

package/exported.js

@@ -1 +1 @@
-import './src/types-ambient.js';
+// Dummy file for .d.ts twin to declare ambients

package/package.json

@@ -1,24 +1,24 @@
 {
   "name": "@agoric/governance",
-  "version": "0.10.4-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
+  "version": "0.10.4-upgrade-16-fi-dev-8879538.0+8879538",
   "description": "Core governance support",
   "type": "module",
   "main": "src/index.js",
   "engines": {
-    "node": ">=14.15.0"
+    "node": "^18.12 || ^20.9"
   },
   "scripts": {
     "build": "yarn build:bundles",
     "build:bundles": "node ./scripts/build-bundles.js",
-    "prepack": "echo \"export {}; \" | cat - src/types-ambient.js > src/types.js && tsc --build jsconfig.build.json",
-    "postpack": "git clean -f '*.d.ts*' src/types.js",
+    "prepack": "tsc --build tsconfig.build.json",
+    "postpack": "git clean -f '*.d.ts*'",
     "test": "ava",
     "test:c8": "c8 $C8_OPTIONS ava --config=ava-nesm.config.js",
     "test:xs": "exit 0",
     "lint-fix": "yarn lint:eslint --fix",
     "lint": "run-s --continue-on-error lint:*",
     "lint:eslint": "eslint .",
-    "lint:types": "tsc -p jsconfig.json"
+    "lint:types": "tsc"
   },
   "repository": {
     "type": "git",
@@ -31,46 +31,52 @@
   },
   "homepage": "https://github.com/Agoric/agoric-sdk#readme",
   "dependencies": {
-    "@agoric/assert": "0.6.1-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@agoric/ertp": "0.16.3-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@agoric/internal": "0.4.0-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@agoric/notifier": "0.6.3-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@agoric/store": "0.9.3-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@agoric/swingset-vat": "0.32.3-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@agoric/time": "0.3.3-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@agoric/vat-data": "0.5.3-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@agoric/vats": "0.15.2-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@agoric/zoe": "0.26.3-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@endo/captp": "3.1.1",
-    "@endo/eventual-send": "0.17.2",
-    "@endo/far": "0.2.18",
-    "@endo/marshal": "0.8.5",
-    "@endo/nat": "4.1.27",
-    "@endo/promise-kit": "0.2.56"
+    "@agoric/assert": "0.6.1-upgrade-16-fi-dev-8879538.0+8879538",
+    "@agoric/ertp": "0.16.3-upgrade-16-fi-dev-8879538.0+8879538",
+    "@agoric/internal": "0.3.3-upgrade-16-fi-dev-8879538.0+8879538",
+    "@agoric/notifier": "0.6.3-upgrade-16-fi-dev-8879538.0+8879538",
+    "@agoric/store": "0.9.3-upgrade-16-fi-dev-8879538.0+8879538",
+    "@agoric/time": "0.3.3-upgrade-16-fi-dev-8879538.0+8879538",
+    "@agoric/vat-data": "0.5.3-upgrade-16-fi-dev-8879538.0+8879538",
+    "@agoric/zoe": "0.26.3-upgrade-16-fi-dev-8879538.0+8879538",
+    "@endo/bundle-source": "^3.2.3",
+    "@endo/captp": "^4.2.0",
+    "@endo/eventual-send": "^1.2.2",
+    "@endo/far": "^1.1.2",
+    "@endo/marshal": "^1.5.0",
+    "@endo/nat": "^5.0.7",
+    "@endo/promise-kit": "^1.1.2",
+    "import-meta-resolve": "^2.2.1"
   },
   "devDependencies": {
-    "@agoric/deploy-script-support": "0.10.4-upgrade-14-dev-c8f9e7b.0+c8f9e7b",
-    "@endo/bundle-source": "2.5.2-upstream-rollup",
-    "@endo/init": "0.5.56",
-    "ava": "^5.2.0",
-    "c8": "^7.13.0",
-    "import-meta-resolve": "^2.2.1"
+    "@agoric/swingset-vat": "0.32.3-upgrade-16-fi-dev-8879538.0+8879538",
+    "@endo/bundle-source": "^3.2.3",
+    "@endo/init": "^1.1.2",
+    "ava": "^5.3.0",
+    "c8": "^9.1.0"
   },
   "files": [
     "README.md",
     "src/",
     "tools/",
     "exported.js",
+    "exported.d.ts",
     "NEWS.md"
   ],
   "ava": {
     "files": [
-      "test/**/test-*.js"
+      "test/**/*.test.*"
+    ],
+    "require": [
+      "@endo/init/debug.js"
     ],
     "timeout": "10m"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "c8f9e7be1645e0be23f47de197409a7d4874add5"
+  "typeCoverage": {
+    "atLeast": 89.31
+  },
+  "gitHead": "8879538cd1d125a08346f02dd5701d0d70c90bb8"
 }

package/src/binaryVoteCounter.d.ts

@@ -8,9 +8,12 @@ export function start(zcf: ZCF<{
     questionSpec: QuestionSpec;
     quorumThreshold: bigint;
 }>, { outcomePublisher }: {
-    outcomePublisher: Publisher<OutcomeRecord>;
+    outcomePublisher: globalThis.Publisher<OutcomeRecord>;
 }): {
-    publicFacet: VoteCounterPublicFacet;
-    creatorFacet: VoteCounterCreatorFacet;
+    publicFacet: import("./types.js").VoteCounterPublicFacet;
+    creatorFacet: import("./types.js").VoteCounterCreatorFacet;
 };
+import type { BuildVoteCounter } from './types.js';
+import type { QuestionSpec } from './types.js';
+import type { OutcomeRecord } from './types.js';
 //# sourceMappingURL=binaryVoteCounter.d.ts.map

package/src/binaryVoteCounter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binaryVoteCounter.d.ts","sourceRoot":"","sources":["binaryVoteCounter.js"],"names":[],"mappings":"AAuCA,+BAA+B;AAC/B,oCADW,gBAAgB,CA8JzB;AAMF;;;GAGG;AACH;kBAH8B,YAAY;qBAAmB,MAAM;0BACxD;IAAC,gBAAgB,EAAE,UAAU,aAAa,CAAC,CAAA;CAAC;;;EAoBtD"}
+{"version":3,"file":"binaryVoteCounter.d.ts","sourceRoot":"","sources":["binaryVoteCounter.js"],"names":[],"mappings":"AA2CA,+BAA+B;AAC/B,qDA6JE;AAMF;;;GAGG;AACH;;qBAH6D,MAAM;;;;;;EAqBlE;sCAlNyF,YAAY;kCAAZ,YAAY;mCAAZ,YAAY"}

package/src/binaryVoteCounter.js

@@ -16,6 +16,10 @@ import {
 } from './typeGuards.js';
 import { makeQuorumCounter } from './quorumCounter.js';
 
+/**
+ * @import {BuildVoteCounter, OutcomeRecord, Position, QuestionSpec, VoteStatistics} from './types.js';
+ */
+
 const { Fail } = assert;
 
 const validateBinaryQuestionSpec = questionSpec => {
@@ -109,7 +113,7 @@ const makeBinaryVoteCounter = (
         outcome: 'fail',
         reason: 'No quorum',
       };
-      E(publisher).publish(voteOutcome);
+      void E(publisher).publish(voteOutcome);
       return;
     }
 
@@ -122,7 +126,7 @@ const makeBinaryVoteCounter = (
     }
 
     // XXX if we should distinguish ties, publish should be called in if above
-    E.when(outcomePromise.promise, position => {
+    void E.when(outcomePromise.promise, position => {
       /** @type {OutcomeRecord} */
       const voteOutcome = {
         question: details.questionHandle,

package/src/breakTie.d.ts

@@ -1,2 +1,3 @@
 export function breakTie(positions: Position[], n: number): Position[];
+import type { Position } from './types.js';
 //# sourceMappingURL=breakTie.d.ts.map

package/src/breakTie.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"breakTie.d.ts","sourceRoot":"","sources":["breakTie.js"],"names":[],"mappings":"AAwBO,oCAJI,QAAQ,EAAE,KACV,MAAM,GACJ,QAAQ,EAAE,CAItB"}
+{"version":3,"file":"breakTie.d.ts","sourceRoot":"","sources":["breakTie.js"],"names":[],"mappings":"AA4BO,mDAHI,MAAM,cAKhB;8BA7B0B,YAAY"}

package/src/breakTie.js

@@ -1,3 +1,7 @@
+/**
+ * @import {Position} from './types.js';
+ */
+
 /**
  * Randomly shuffle an array
  * https://stackoverflow.com/a/12646864

package/src/closingRule.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @import {CloseVoting} from './types.js';
+ */
 /** @type {CloseVoting} */
 export const scheduleClose: CloseVoting;
+import type { CloseVoting } from './types.js';
 //# sourceMappingURL=closingRule.d.ts.map

package/src/closingRule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"closingRule.d.ts","sourceRoot":"","sources":["closingRule.js"],"names":[],"mappings":"AAOA,0BAA0B;AAC1B,4BADW,WAAW,CASpB"}
+{"version":3,"file":"closingRule.d.ts","sourceRoot":"","sources":["closingRule.js"],"names":[],"mappings":"AAOA;;GAEG;AAEH,0BAA0B;AAC1B,wCAQE;iCAZ4B,YAAY"}

package/src/closingRule.js

@@ -5,6 +5,10 @@
 import { E } from '@endo/eventual-send';
 import { Far } from '@endo/marshal';
 
+/**
+ * @import {CloseVoting} from './types.js';
+ */
+
 /** @type {CloseVoting} */
 export const scheduleClose = (closingRule, closeVoting) => {
   const { timer, deadline } = closingRule;

package/src/committee.d.ts

@@ -1,14 +1,17 @@
-export namespace privateArgsShape {
-    export { StorageNodeShape as storageNode };
-    export const marshaller: import("@endo/patterns").Matcher;
-}
-export function prepare(zcf: ZCF<{
+/**
+ * @typedef { ElectorateCreatorFacet & {
+ *   getVoterInvitations: () => Promise<Invitation<{ voter: { castBallotFor(handle: any, choice?: any, ): void}}>>[]
+ * }} CommitteeElectorateCreatorFacet
+ */
+/** @type {ContractMeta} */
+export const meta: ContractMeta;
+export function start(zcf: ZCF<{
     committeeName: string;
     committeeSize: number;
 }>, privateArgs: {
     storageNode: ERef<StorageNode>;
     marshaller: ERef<Marshaller>;
-}, baggage: MapStore<string, unknown>): {
+}, baggage: import("@agoric/vat-data").Baggage): {
     creatorFacet: CommitteeElectorateCreatorFacet;
     publicFacet: CommitteeElectoratePublic;
 };
@@ -17,7 +20,8 @@ export type CommitteeElectorateCreatorFacet = ElectorateCreatorFacet & {
         voter: {
             castBallotFor(handle: any, choice?: any): void;
         };
-    }, never>>[];
+    }>>[];
 };
-import { StorageNodeShape } from "@agoric/internal/src/typeGuards.js";
+import type { CommitteeElectoratePublic } from './types.js';
+import type { ElectorateCreatorFacet } from './types.js';
 //# sourceMappingURL=committee.d.ts.map

package/src/committee.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"committee.d.ts","sourceRoot":"","sources":["committee.js"],"names":[],"mappings":";;;;AAgDO;mBAPa,MAAM;mBACN,MAAM;iBAEf;IAAE,WAAW,EAAE,KAAK,WAAW,CAAC,CAAC;IAAC,UAAU,EAAE,KAAK,UAAU,CAAC,CAAA;CAAC;kBAE9C,+BAA+B;iBAAe,yBAAyB;EA6HlG;;;;kCAtJmF,GAAG,WAAW,GAAG,GAAK,IAAI"}
+{"version":3,"file":"committee.d.ts","sourceRoot":"","sources":["committee.js"],"names":[],"mappings":"AAwBA;;;;GAIG;AAEH,2BAA2B;AAC3B,mBADW,YAAY,CAOrB;AAoBK,2BARI,GAAG,CAAC;IACd,aAAiB,EAAE,MAAM,CAAC;IAC1B,aAAiB,EAAE,MAAM,CAAC;CACvB,CAAC,eACM;IAAE,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;CAAC,WAC/D,OAAO,kBAAkB,EAAE,OAAO;kBACjB,+BAA+B;;EAkI1D;;yBA/JyB,MAAM,OAAO,CAAC,UAAU,CAAC;QAAE,KAAK,EAAE;YAAE,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,GAAG,GAAK,IAAI,CAAA;SAAC,CAAA;KAAC,CAAC,CAAC,EAAE;;+CAPH,YAAY;4CAAZ,YAAY"}

package/src/committee.js

@@ -5,6 +5,7 @@ import { E } from '@endo/eventual-send';
 
 import { StorageNodeShape } from '@agoric/internal';
 import { prepareExo, provideDurableMapStore } from '@agoric/vat-data';
+import { EmptyProposalShape } from '@agoric/zoe/src/typeGuards.js';
 import {
   getOpenQuestions,
   getPoserInvitation,
@@ -15,6 +16,10 @@ import { QuorumRule } from './question.js';
 import { ElectorateCreatorI, ElectoratePublicI } from './typeGuards.js';
 import { prepareVoterKit } from './voterKit.js';
 
+/**
+ * @import {ElectorateCreatorFacet, CommitteeElectoratePublic, QuestionDetails, OutcomeRecord, AddQuestion} from './types.js';
+ */
+
 const { ceilDivide } = natSafeMath;
 
 /**
@@ -23,11 +28,15 @@ const { ceilDivide } = natSafeMath;
  * }} CommitteeElectorateCreatorFacet
  */
 
-export const privateArgsShape = {
-  storageNode: StorageNodeShape,
-  marshaller: M.remotable('Marshaller'),
+/** @type {ContractMeta} */
+export const meta = {
+  privateArgsShape: {
+    storageNode: StorageNodeShape,
+    marshaller: M.remotable('Marshaller'),
+  },
+  upgradability: 'canUpgrade',
 };
-harden(privateArgsShape);
+harden(meta);
 
 /**
  * Each Committee (an Electorate) represents a particular set of voters. The
@@ -46,7 +55,7 @@ harden(privateArgsShape);
  * @param {import('@agoric/vat-data').Baggage} baggage
  * @returns {{creatorFacet: CommitteeElectorateCreatorFacet, publicFacet: CommitteeElectoratePublic}}
  */
-export const prepare = (zcf, privateArgs, baggage) => {
+export const start = (zcf, privateArgs, baggage) => {
   /** @type {MapStore<Handle<'Question'>, import('./electorateTools.js').QuestionRecord>} */
   const allQuestions = provideDurableMapStore(baggage, 'Question');
 
@@ -75,10 +84,15 @@ export const prepare = (zcf, privateArgs, baggage) => {
     // This will produce unique descriptions because
     // makeCommitteeVoterInvitation() is only called within the following loop,
     // which is only called once per Electorate.
-    return zcf.makeInvitation(seat => {
-      seat.exit();
-      return makeVoterKit(index);
-    }, `Voter${index}`);
+    return zcf.makeInvitation(
+      seat => {
+        seat.exit();
+        return makeVoterKit(index);
+      },
+      `Voter${index}`,
+      undefined,
+      EmptyProposalShape,
+    );
   };
 
   const { committeeName, committeeSize } = zcf.getTerms();
@@ -170,5 +184,4 @@ export const prepare = (zcf, privateArgs, baggage) => {
 
   return { publicFacet, creatorFacet };
 };
-
-harden(prepare);
+harden(start);

package/src/constants.d.ts

@@ -1,16 +1,16 @@
 export namespace ParamTypes {
-    const AMOUNT: "amount";
-    const BRAND: "brand";
-    const INSTALLATION: "installation";
-    const INSTANCE: "instance";
-    const INVITATION: "invitation";
-    const NAT: "nat";
-    const RATIO: "ratio";
-    const STRING: "string";
-    const PASSABLE_RECORD: "record";
-    const TIMESTAMP: "timestamp";
-    const RELATIVE_TIME: "relativeTime";
-    const UNKNOWN: "unknown";
+    let AMOUNT: "amount";
+    let BRAND: "brand";
+    let INSTALLATION: "installation";
+    let INSTANCE: "instance";
+    let INVITATION: "invitation";
+    let NAT: "nat";
+    let RATIO: "ratio";
+    let STRING: "string";
+    let PASSABLE_RECORD: "record";
+    let TIMESTAMP: "timestamp";
+    let RELATIVE_TIME: "relativeTime";
+    let UNKNOWN: "unknown";
 }
 export type ParamType = (typeof ParamTypes)[keyof typeof ParamTypes];
 //# sourceMappingURL=constants.d.ts.map

package/src/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["constants.js"],"names":[],"mappings":";;;;;;;;;;;;;;wBAuBc,CAAA,iBAAiB,EAAC,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["constants.js"],"names":[],"mappings":";;;;;;;;;;;;;;wBAuBc,CAAA,OAAO,UAAU,EAAC,MAAM,OAAO,UAAU,CAAC"}

package/src/contractGovernance/governApi.d.ts

@@ -1,30 +1,33 @@
 /**
  * manage contracts that allow governance to invoke functions.
  *
- * @param {ERef<{ [methodName: string]: (...args: any) => unknown }>} governedApis
+ * @param {ERef<{ [methodName: string]: (...args: any) => Passable }>} governedApis
  * @param {Array<string | symbol>} governedNames names of the governed API methods
- * @param {ERef<import('@agoric/time/src/types').TimerService>} timer
+ * @param {ERef<import('@agoric/time').TimerService>} timer
  * @param {() => Promise<PoserFacet>} getUpdatedPoserFacet
  * @returns {ApiGovernor}
  */
-export function setupApiGovernance(governedApis: ERef<{
-    [methodName: string]: (...args: any) => unknown;
-}>, governedNames: Array<string | symbol>, timer: ERef<import('@agoric/time/src/types').TimerService>, getUpdatedPoserFacet: () => Promise<PoserFacet>): ApiGovernor;
+export function setupApiGovernance(governedApis: globalThis.ERef<{
+    [methodName: string]: (...args: any) => Passable;
+}>, governedNames: Array<string | symbol>, timer: ERef<import("@agoric/time").TimerService>, getUpdatedPoserFacet: () => Promise<PoserFacet>): ApiGovernor;
 /**
  * Make a pair of positions for a question about whether to invoke an API. If
  * the vote passes, the method will be called on the governedApis facet with the
  * arguments that were provided.
  *
  * @param {string} apiMethodName
- * @param {unknown[]} methodArgs
+ * @param {Passable[]} methodArgs
  */
-export function makeApiInvocationPositions(apiMethodName: string, methodArgs: unknown[]): {
+export function makeApiInvocationPositions(apiMethodName: string, methodArgs: Passable[]): {
     positive: {
         apiMethodName: string;
-        methodArgs: unknown[];
+        methodArgs: Passable[];
     };
     negative: {
         dontInvoke: string;
     };
 };
+import type { Passable } from '@endo/pass-style';
+import type { PoserFacet } from '../types.js';
+import type { ApiGovernor } from '../types.js';
 //# sourceMappingURL=governApi.d.ts.map

package/src/contractGovernance/governApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"governApi.d.ts","sourceRoot":"","sources":["governApi.js"],"names":[],"mappings":"AA2BA;;;;;;;;GAQG;AACH;oCANkD,GAAG,KAAK,OAAO;mBACtD,MAAM,MAAM,GAAG,MAAM,CAAC,SACtB,KAAK,OAAO,wBAAwB,EAAE,YAAY,CAAC,wBACnD,MAAM,QAAQ,UAAU,CAAC,GACvB,WAAW,CAwFvB;AA7GD;;;;;;;GAOG;AACH,0DAHW,MAAM,cACN,OAAO,EAAE;;;;;;;;EAMnB"}
+{"version":3,"file":"governApi.d.ts","sourceRoot":"","sources":["governApi.js"],"names":[],"mappings":"AAgCA;;;;;;;;GAQG;AACH;oCANkD,GAAG;mBAC1C,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,SACtB,IAAI,CAAC,OAAO,cAAc,EAAE,YAAY,CAAC,gEA0FnD;AA7GD;;;;;;;GAOG;AACH,0DAHW,MAAM;;;;;;;;EAOhB;8BAlB2C,kBAAkB;gCAC+B,aAAa;iCAAb,aAAa"}

package/src/contractGovernance/governApi.js

@@ -9,6 +9,11 @@ import {
   coerceQuestionSpec,
 } from '../question.js';
 
+/**
+ * @import {Passable, RemotableObject} from '@endo/pass-style';
+ * @import {Position, ApiGovernor, ApiInvocationIssue, PoserFacet, VoteOnApiInvocation} from '../types.js';
+ */
+
 const { Fail, quote: q } = assert;
 
 /**
@@ -17,7 +22,7 @@ const { Fail, quote: q } = assert;
  * arguments that were provided.
  *
  * @param {string} apiMethodName
- * @param {unknown[]} methodArgs
+ * @param {Passable[]} methodArgs
  */
 const makeApiInvocationPositions = (apiMethodName, methodArgs) => {
   const positive = harden({ apiMethodName, methodArgs });
@@ -28,9 +33,9 @@ const makeApiInvocationPositions = (apiMethodName, methodArgs) => {
 /**
  * manage contracts that allow governance to invoke functions.
  *
- * @param {ERef<{ [methodName: string]: (...args: any) => unknown }>} governedApis
+ * @param {ERef<{ [methodName: string]: (...args: any) => Passable }>} governedApis
  * @param {Array<string | symbol>} governedNames names of the governed API methods
- * @param {ERef<import('@agoric/time/src/types').TimerService>} timer
+ * @param {ERef<import('@agoric/time').TimerService>} timer
  * @param {() => Promise<PoserFacet>} getUpdatedPoserFacet
  * @returns {ApiGovernor}
  */

package/src/contractGovernance/governFilter.d.ts

@@ -1,12 +1,15 @@
 /**
  * Setup to allow governance to block some invitations.
  *
- * @param {ERef<import('@agoric/time/src/types').TimerService>} timer
+ * @param {ERef<import('@agoric/time').TimerService>} timer
  * @param {() => Promise<PoserFacet>} getUpdatedPoserFacet
  * @param {GovernedCreatorFacet<{}>} governedCF
  * @returns {FilterGovernor}
  */
-export function setupFilterGovernance(timer: ERef<import('@agoric/time/src/types').TimerService>, getUpdatedPoserFacet: () => Promise<PoserFacet>, governedCF: GovernedCreatorFacet<{}>): FilterGovernor;
+export function setupFilterGovernance(timer: ERef<import("@agoric/time").TimerService>, getUpdatedPoserFacet: () => Promise<PoserFacet>, governedCF: GovernedCreatorFacet<{}>): FilterGovernor;
+/**
+ * @import {Position, ApiGovernor, ApiInvocationIssue, PoserFacet, VoteOnApiInvocation, FilterGovernor, GovernedCreatorFacet, OfferFilterIssue, VoteOnOfferFilter} from '../types.js';
+ */
 /**
  * Make a pair of positions for a question about whether to update the offer
  * filter. If the vote passes, the list of blocked invitation strings will be
@@ -22,4 +25,7 @@ export function makeOfferFilterPositions(strings: string[]): {
         dontUpdate: string[];
     };
 };
+import type { PoserFacet } from '../types.js';
+import type { GovernedCreatorFacet } from '../types.js';
+import type { FilterGovernor } from '../types.js';
 //# sourceMappingURL=governFilter.d.ts.map

package/src/contractGovernance/governFilter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"governFilter.d.ts","sourceRoot":"","sources":["governFilter.js"],"names":[],"mappings":"AAyBA;;;;;;;GAOG;AACH,6CALW,KAAK,OAAO,wBAAwB,EAAE,YAAY,CAAC,wBACnD,MAAM,QAAQ,UAAU,CAAC,cACzB,qBAAqB,EAAE,CAAC,GACtB,cAAc,CAqE1B;AAxFD;;;;;;GAMG;AACH,kDAFW,MAAM,EAAE;;;;;;;EAMlB"}
+{"version":3,"file":"governFilter.d.ts","sourceRoot":"","sources":["governFilter.js"],"names":[],"mappings":"AA6BA;;;;;;;GAOG;AACH,6CALW,IAAI,CAAC,OAAO,cAAc,EAAE,YAAY,CAAC,yGAwEnD;AA5FD;;GAEG;AAEH;;;;;;GAMG;AACH,kDAFW,MAAM,EAAE;;;;;;;EAMlB;gCAduK,aAAa;0CAAb,aAAa;oCAAb,aAAa"}

package/src/contractGovernance/governFilter.js

@@ -10,6 +10,10 @@ import {
   coerceQuestionSpec,
 } from '../question.js';
 
+/**
+ * @import {Position, ApiGovernor, ApiInvocationIssue, PoserFacet, VoteOnApiInvocation, FilterGovernor, GovernedCreatorFacet, OfferFilterIssue, VoteOnOfferFilter} from '../types.js';
+ */
+
 /**
  * Make a pair of positions for a question about whether to update the offer
  * filter. If the vote passes, the list of blocked invitation strings will be
@@ -26,7 +30,7 @@ const makeOfferFilterPositions = strings => {
 /**
  * Setup to allow governance to block some invitations.
  *
- * @param {ERef<import('@agoric/time/src/types').TimerService>} timer
+ * @param {ERef<import('@agoric/time').TimerService>} timer
  * @param {() => Promise<PoserFacet>} getUpdatedPoserFacet
  * @param {GovernedCreatorFacet<{}>} governedCF
  * @returns {FilterGovernor}

package/src/contractGovernance/governParam.d.ts

@@ -1,11 +1,11 @@
 /**
  * @param {ERef<ParamManagerRetriever>} paramManagerRetriever
  * @param {Instance} contractInstance
- * @param {import('@agoric/time/src/types').TimerService} timer
+ * @param {import('@agoric/time').TimerService} timer
  * @param {() => Promise<PoserFacet>} getUpdatedPoserFacet
  * @returns {ParamGovernor}
  */
-export function setupParamGovernance(paramManagerRetriever: ERef<ParamManagerRetriever>, contractInstance: Instance, timer: import('@agoric/time/src/types').TimerService, getUpdatedPoserFacet: () => Promise<PoserFacet>): ParamGovernor;
+export function setupParamGovernance(paramManagerRetriever: globalThis.ERef<ParamManagerRetriever>, contractInstance: Instance, timer: import("@agoric/time").TimerService, getUpdatedPoserFacet: () => Promise<PoserFacet>): ParamGovernor;
 /**
  * Return a record containing the positive and negative positions for a
  * question on changing the param to the proposedValue.
@@ -30,4 +30,11 @@ export function assertBallotConcernsParam(paramSpec: {
  * declared in the governed contract.
  */
 export const CONTRACT_ELECTORATE: "Electorate";
+import type { ParamManagerRetriever } from '../types.js';
+import type { PoserFacet } from '../types.js';
+import type { ParamGovernor } from '../types.js';
+import type { ParamValue } from '../types.js';
+import type { ParamChangePositions } from '../types.js';
+import type { ParamChangeIssue } from '../types.js';
+import type { QuestionSpec } from '../types.js';
 //# sourceMappingURL=governParam.d.ts.map

package/src/contractGovernance/governParam.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"governParam.d.ts","sourceRoot":"","sources":["governParam.js"],"names":[],"mappings":"AAqDA;;;;;;GAMG;AACH,4DANW,KAAK,qBAAqB,CAAC,oBAC3B,QAAQ,SACR,OAAO,wBAAwB,EAAE,YAAY,wBAC7C,MAAM,QAAQ,UAAU,CAAC,GACvB,aAAa,CAwFzB;AA9HD;;;;;;GAMG;AACH,kDAHW,OAAO,MAAM,EAAE,UAAU,CAAC,GACxB,oBAAoB,CAQhC;AAED;;;;;;GAMG;AACH;mBAH4B,MAAM;eAAa,OAAO;iBAC3C,aAAa,iBAAiB,OAAO,CAAC,CAAC,QAWjD;AArCD;;;GAGG;AACH,+CAAyC"}
+{"version":3,"file":"governParam.d.ts","sourceRoot":"","sources":["governParam.js"],"names":[],"mappings":"AAyDA;;;;;;GAMG;AACH,sHALW,QAAQ,SACR,OAAO,cAAc,EAAE,YAAY,kEA2F7C;AA/HD;;;;;;GAMG;AACH,oGAMC;AAED;;;;;;GAMG;AACH,qDAHW;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAC,+DAYtD;AArCD;;;GAGG;AACH,+CAAyC;2CATsI,aAAa;gCAAb,aAAa;mCAAb,aAAa;gCAAb,aAAa;0CAAb,aAAa;sCAAb,aAAa;kCAAb,aAAa"}

package/src/contractGovernance/governParam.js

@@ -10,6 +10,10 @@ import {
 } from '../question.js';
 import { ParamChangesQuestionDetailsShape } from '../typeGuards.js';
 
+/**
+ * @import {ParamValue, ParamChangePositions, QuestionSpec, ChangeParamsPosition, ParamChangeIssue, ParamGovernor, ParamManagerRetriever, PoserFacet, VoteOnParamChanges} from '../types.js';
+ */
+
 const { Fail } = assert;
 
 /**
@@ -54,7 +58,7 @@ const assertBallotConcernsParam = (paramSpec, questionSpec) => {
 /**
  * @param {ERef<ParamManagerRetriever>} paramManagerRetriever
  * @param {Instance} contractInstance
- * @param {import('@agoric/time/src/types').TimerService} timer
+ * @param {import('@agoric/time').TimerService} timer
  * @param {() => Promise<PoserFacet>} getUpdatedPoserFacet
  * @returns {ParamGovernor}
  */
@@ -74,6 +78,7 @@ const setupParamGovernance = (
     paramSpec,
   ) => {
     const paramMgr = await E(paramManagerRetriever).get(paramSpec.paramPath);
+    /** @type {import('@endo/marshal').Passable} */
     const changePs = {};
     for (const name of Object.keys(paramSpec.changes)) {
       const proposedValue = E(paramMgr).getVisibleValue(